1

docs/experience/PLAYABLE_ROLE_APPEARANCE_TEMPLATE_FIELD_REMOVAL_2026-04-25.md

@@ -0,0 +1,20 @@
+# 可扮演角色外观模板字段删除经验
+
+## 背景
+
+可扮演角色曾通过 `templateCharacterId` 保存“外观模板”选择。当前角色主形象已经由 `visualDescription`、`imageSrc` 与生成资产链路承接，外观模板不应继续作为可扮演角色档案字段暴露给用户编辑或持久化。
+
+## 落地边界
+
+- 可扮演角色数据结构不再声明 `templateCharacterId`。
+- 可扮演角色编辑面板删除“外观模板”下拉项，保存时不再补默认模板。
+- 草稿规范化与资料库读取时丢弃旧数据中的 `templateCharacterId`，避免旧快照把字段带回新数据。
+- 运行时如需要基础动作、默认立绘或战斗标签，只能通过角色文本、参考 profile 或固定 fallback 规则临时推导模板，不再写回角色字段。
+- 资产工坊可以继续接收运行时临时模板提示，但该提示不得成为可扮演角色的持久字段。
+
+## 验收要点
+
+- 新建或编辑可扮演角色时界面不出现“外观模板”。
+- 保存后的 `playableNpcs` 条目不包含 `templateCharacterId`。
+- 旧存档带有 `templateCharacterId` 时，进入当前规范化链路后会被丢弃。
+- 自定义世界运行角色仍能通过推导模板获得基础动作与默认占位图，不因字段删除而中断。