Simplify custom world result editing controls

2026-04-08 19:07:46 +08:00
parent bd9fdcbe31
commit a02f7b6414
125 changed files with 8804 additions and 1462 deletions
--- a/docs/design/CUSTOM_WORLD_SELF_OWNED_SETTING_LAYER_OPTIMIZATION_2026-04-08.md
+++ b/docs/design/CUSTOM_WORLD_SELF_OWNED_SETTING_LAYER_OPTIMIZATION_2026-04-08.md
@@ -0,0 +1,660 @@
+# 自定义世界自有设定层优化方案
+
+更新时间：`2026-04-08`
+
+## 0. 目标
+
+这份文档要解决的问题是：
+
+**当前自定义世界虽然已经是唯一正式可玩的世界入口，但它底层仍依赖武侠 / 仙侠模板设定。**
+
+本次优化目标不是直接删除这些依赖，而是把它们逐步改造成：
+
+**属于自定义世界自身的设定层，并且这套设定层必须能通用于任何题材。**
+
+同时必须满足一条底线：
+
+**不能破坏当前自定义世界生成流程的任何可用功能。**
+
+一句话定义：
+
+**让自定义世界从“借模板世界运行”，升级成“拥有自有设定层、可跨题材运行”的架构。**
+
+---
+
+## 1. 设计原则
+
+这次优化必须同时遵守 4 条原则：
+
+1. 设定归自定义世界自身所有
+   - 运行时、生成期、表现层真正依赖的世界设定，应该落回 `CustomWorldProfile` 或由它直接编译出的配置。
+
+2. 设定必须跨题材
+   - 新设定不能只是把“武侠 / 仙侠”换一个更抽象的名字。
+   - 它必须能支撑奇幻、科幻、悬疑、校园、末世、神话、现代、海洋、裂界等任何题材。
+
+3. 优化优先做兼容迁移
+   - 不能先删旧字段，再补新结构。
+   - 必须先补新设定层，再逐步迁读，最后再让旧模板字段退化成兼容层。
+
+4. 不能增加创作者负担
+   - 这次不是让创作者多填一堆底层 schema。
+   - 这些设定仍然应由 AI / 系统编译出来，只是所有权从模板世界转移到自定义世界自己。
+
+---
+
+## 2. 当前自定义世界实际依赖了什么
+
+根据 [CUSTOM_WORLD_TEMPLATE_DEPENDENCY_INVENTORY_2026-04-08.md](../reference/CUSTOM_WORLD_TEMPLATE_DEPENDENCY_INVENTORY_2026-04-08.md)，当前依赖可以归纳成 6 组：
+
+1. 模板锚点字段
+   - `templateWorldType`
+   - `WorldTemplateType`
+
+2. 规则桥接
+   - `resolveRuleWorldType(...)`
+
+3. 主题与词汇底板
+   - `detectCustomWorldThemeMode(...)`
+   - `buildThemePackFromWorldProfile(...)`
+
+4. 属性、资源词与经济 fallback
+   - 预设属性 schema
+   - 资源命名
+   - 初始货币规则
+
+5. 内容骨架
+   - 角色模板骨架
+   - 怪物模板池
+   - 场景视觉参考池
+
+6. prompt 兼容字段
+   - `framework` 生成仍要求输出 `templateWorldType`
+
+这些东西现在还不能直接删，因为：
+
+**它们不是单纯的预设世界残留，而是当前自定义世界生成与运行时的真实支撑层。**
+
+---
+
+## 3. 本次优化的核心思路
+
+这次不建议新增很多彼此平行的新系统，而是把现有模板依赖统一收束成：
+
+**自定义世界自己的 5 层设定层。**
+
+这 5 层分别是：
+
+1. 语义锚层
+2. 规则层
+3. 表现层
+4. 原型参考层
+5. 兼容迁移层
+
+这样可以让现在分散在：
+
+- 模板世界枚举
+- 预设 schema
+- 视觉参考池
+- 怪物池
+- ThemePack 底板
+
+这些地方的依赖，被重新编译回 `CustomWorldProfile` 自己的配置。
+
+---
+
+## 4. 目标结构
+
+## 4.1 语义锚层：替代 `templateWorldType`
+
+当前 `templateWorldType` 实际在回答的不是“你是不是武侠”，而是：
+
+1. 这个世界更接近哪类冲突结构
+2. 这个世界更接近哪类制度和禁忌
+3. 这个世界更接近哪类叙事载体与力量来源
+
+所以应把它升级成一套真正属于自定义世界自己的语义锚：
+
+```ts
+interface CustomWorldSemanticAnchor {
+  genreSignals: string[];
+  conflictForms: string[];
+  institutionTypes: string[];
+  tabooTypes: string[];
+  carrierTypes: string[];
+  forceSystemTypes: string[];
+  atmosphereTags: string[];
+}
+```
+
+这层应该回答：
+
+1. 这个世界的主要矛盾像什么
+2. 这个世界的秩序结构像什么
+3. 这个世界的危险和禁忌像什么
+4. 这个世界的线索、遗物、文书、证物、技术、仪式像什么
+
+关键点：
+
+- 这里不再出现“武侠 / 仙侠”的模板世界名
+- 只保留通用语义
+
+例如：
+
+- `institutionTypes`
+  - 宗门
+  - 公司
+  - 学园
+  - 教团
+  - 调查局
+  - 舰队
+  - 部族
+
+- `forceSystemTypes`
+  - 灵脉
+  - 科技
+  - 仪式
+  - 契约
+  - 血统
+  - 神谕
+  - 污染
+
+这就天然跨题材了。
+
+---
+
+## 4.2 规则层：把 fallback 变成自定义世界自己的规则设定
+
+当前很多规则仍然会回落到武侠 / 仙侠：
+
+- 属性 schema
+- 资源命名
+- 经济命名
+- 初始货币
+
+优化后应由自定义世界自己持有：
+
+```ts
+interface CustomWorldRuleProfile {
+  attributeSchema: WorldAttributeSchema;
+  resourceLabels: {
+    hp: string;
+    mp: string;
+    maxHp: string;
+    maxMp: string;
+    damage: string;
+    guard: string;
+    range: string;
+    cooldown: string;
+    manaCost: string;
+    currency: string;
+  };
+  economyProfile: {
+    initialCurrency: number;
+  };
+}
+```
+
+这意味着以后运行时读取逻辑应优先变成：
+
+1. 先读 `profile.ruleProfile`
+2. 再读 `profile.attributeSchema`
+3. 最后才允许读兼容 fallback
+
+而不是：
+
+1. 先判断 `WUXIA / XIANXIA`
+2. 再猜自定义世界应该像哪边
+
+这层的原则是：
+
+**规则是这个自定义世界自己的，不再借模板世界托管。**
+
+---
+
+## 4.3 表现层：把 ThemePack 变成自定义世界自身的派生物
+
+当前 `ThemePack` 仍然是“预设底板 + 自定义词汇补丁”。
+
+优化后应改成：
+
+```ts
+interface CustomWorldExpressionProfile {
+  themePack: ThemePack;
+  presentationTone: string[];
+  namingDirectives: string[];
+  clueDirectives: string[];
+  revealDirectives: string[];
+}
+```
+
+也就是说：
+
+- `ThemePack` 仍然可以保留
+- 但它不再被理解为“武侠底板 / 仙侠底板的延伸”
+- 它应当是：
+  - `semanticAnchor`
+  - `creatorIntent`
+  - `majorFactions`
+  - `coreConflicts`
+  - `world text`
+ 共同编译出来的结果
+
+这一步非常关键，因为它会决定：
+
+1. 物件命名
+2. 势力命名
+3. 线索形式
+4. 提示词词汇风格
+5. reveal 风格
+
+只有把这层做成自定义世界自己的派生物，后面跨题材才会真的稳。
+
+---
+
+## 4.4 原型参考层：把模板骨架改成通用原型库
+
+当前自定义世界借用模板的最深部分是：
+
+1. 角色模板骨架
+2. 场景视觉参考池
+3. 怪物模板池
+
+这三类不能粗暴删除，但可以改造成：
+
+**通用原型参考层。**
+
+建议统一成：
+
+```ts
+interface CustomWorldReferenceProfile {
+  roleArchetypes: RoleArchetypeProfile[];
+  sceneBuckets: SceneArchetypeBucket[];
+  creatureArchetypes: CreatureArchetypeProfile[];
+}
+```
+
+### 4.4.1 角色原型
+
+角色原型应描述的是：
+
+- 正面推进型
+- 远程压制型
+- 控场解构型
+- 续航承压型
+- 潜行爆发型
+
+而不是：
+
+- 剑之公主
+- 神箭游侠
+- 双刃旅者
+
+也就是说：
+
+**保留战斗骨架和技能骨架，不保留模板角色人格设定。**
+
+### 4.4.2 场景原型
+
+场景原型应描述的是：
+
+- 高压入口区
+- 雨湿街巷区
+- 临水渡口区
+- 仪式神殿区
+- 高空通路区
+- 工业热区
+- 地底遗迹区
+- 群落聚居区
+
+而不是：
+
+- 竹林古道
+- 云海仙门
+
+也就是说：
+
+**保留“空间语义 -> 视觉参考”的逻辑，不保留模板世界场景名作为中心。**
+
+### 4.4.3 生物原型
+
+生物原型应描述的是：
+
+- 潜伏袭击者
+- 重甲承压者
+- 群居骚扰者
+- 远程威胁者
+- 异化污染体
+- 灵体回响体
+- 机关守卫体
+
+而不是：
+
+- 某个武侠怪
+- 某个仙侠怪
+
+这样之后：
+
+- 自定义世界依赖的是“通用原型”
+- 原型再映射到底层素材与 preset
+
+---
+
+## 4.5 兼容迁移层：旧字段继续保留一段时间
+
+为了不破坏当前流程，短期内不能直接删除：
+
+- `templateWorldType`
+- `WorldTemplateType`
+- 以及相关 normalize / save / read 逻辑
+
+这层应被降级成：
+
+```ts
+interface CustomWorldCompatibilityProfile {
+  legacyTemplateWorldType?: 'WUXIA' | 'XIANXIA' | null;
+  migrationVersion: string;
+}
+```
+
+作用：
+
+1. 旧存档兼容
+2. 旧 prompt 兼容
+3. 旧测试兼容
+4. 旧工具链兼容
+
+但它不再应是新生成世界的第一真相来源。
+
+---
+
+## 5. 现有每类依赖如何改造成自定义世界自己的设定
+
+下面把现有依赖逐项映射成未来目标。
+
+## 5.1 `templateWorldType`
+
+当前作用：
+
+- 世界锚点
+- 规则 fallback
+- 视觉和怪物参考入口
+
+目标改造：
+
+- 拆成：
+  - `semanticAnchor`
+  - `ruleProfile`
+  - `referenceProfile`
+  - `compatibilityProfile`
+
+迁移方式：
+
+1. 旧字段保留
+2. 新字段生成后优先读新字段
+3. 旧字段只做迁移 fallback
+
+## 5.2 `resolveRuleWorldType(...)`
+
+当前作用：
+
+- 把 `CUSTOM` 解析回 `WUXIA / XIANXIA`
+
+目标改造：
+
+- 改成：
+
+```ts
+resolveCustomWorldRuleProfile(profile)
+```
+
+运行时不再需要知道“它更像武侠还是仙侠”，而只需要知道：
+
+- 这个世界的规则 profile 是什么
+
+## 5.3 `getPresetWorldAttributeSchema(...)`
+
+当前作用：
+
+- 自定义世界 schema 的参考底板
+
+目标改造：
+
+- 把预设 schema 底板重构成：
+  - 通用 schema seeds
+
+例如按功能分：
+
+1. 承压轴
+2. 机动轴
+3. 洞察轴
+4. 决断轴
+5. 共鸣轴
+6. 续航轴
+
+然后由自定义世界的 `semanticAnchor + creatorIntent` 生成最终命名与说明。
+
+## 5.4 `PRESET_CHARACTERS`
+
+当前作用：
+
+- 自定义世界角色的战斗模板和技能骨架
+
+目标改造：
+
+- 抽出：
+  - `RoleArchetypeProfile`
+  - `SkillArchetypeProfile`
+
+也就是说：
+
+- 还可以继续复用当前角色的战斗结构
+- 但不应再让自定义世界依赖那些模板角色的人设文本
+
+## 5.5 场景图片参考池
+
+当前作用：
+
+- 自定义世界默认场景图匹配
+
+目标改造：
+
+- 改成：
+  - `SceneArchetypeBucket`
+
+每个 bucket 只表达通用空间语义，不表达模板世界名。
+
+## 5.6 怪物池
+
+当前作用：
+
+- 自定义世界敌对单位匹配 preset
+
+目标改造：
+
+- 改成：
+  - `CreatureArchetypeProfile`
+
+由 archetype 再映射到底层怪物素材与 preset。
+
+## 5.7 `buildThemePackFromWorldProfile(...)`
+
+当前作用：
+
+- 以模板题材包为底生成自定义世界 ThemePack
+
+目标改造：
+
+- 变成：
+  - `buildThemePackFromCustomWorldSemanticAnchor(...)`
+
+即 ThemePack 以自定义世界自己的语义锚和词汇锚为底。
+
+---
+
+## 6. 不破坏当前流程的迁移顺序
+
+这是最关键的落地顺序。
+
+## 阶段 A：先给 `CustomWorldProfile` 补新设定层
+
+先补：
+
+1. `semanticAnchor`
+2. `ruleProfile`
+3. `expressionProfile`
+4. `referenceProfile`
+5. `compatibilityProfile`
+
+这一步只做新增，不删旧字段。
+
+## 阶段 B：旧字段自动编译新字段
+
+当前已有 profile、旧存档、旧生成结果，先统一经过：
+
+```ts
+compileOwnedSettingLayersFromLegacyTemplate(profile)
+```
+
+让：
+
+- 旧世界也拥有新设定层
+- 新运行时可优先消费新字段
+
+## 阶段 C：生成链开始直接产出新设定层
+
+修改：
+
+- `framework prompt`
+- `normalizeCustomWorldGenerationFramework(...)`
+- `customWorld.ts`
+
+使新生成世界优先产出：
+
+- `semanticAnchor`
+- `ruleProfile hints`
+- `referenceProfile hints`
+
+而不是只产出 `templateWorldType`
+
+## 阶段 D：运行时逐步改读新设定层
+
+优先改：
+
+1. 资源词与货币
+2. attribute schema
+3. ThemePack
+4. 视觉参考
+5. 怪物映射
+6. 角色原型引用
+
+要求：
+
+- 每次只切一层
+- 每层都保留 fallback
+
+## 阶段 E：把旧模板字段降级为兼容层
+
+当上面的读取已经都切走后：
+
+- `templateWorldType` 就不再是主链依赖
+- 只作为：
+  - migration
+  - 老存档兼容
+  - 老工具兼容
+
+---
+
+## 7. 推荐新增的最小字段
+
+为了避免系统膨胀，建议只先补最小集合。
+
+## 7.1 `CustomWorldOwnedSettingLayers`
+
+```ts
+interface CustomWorldOwnedSettingLayers {
+  semanticAnchor: CustomWorldSemanticAnchor;
+  ruleProfile: CustomWorldRuleProfile;
+  expressionProfile: CustomWorldExpressionProfile;
+  referenceProfile: CustomWorldReferenceProfile;
+  compatibilityProfile?: CustomWorldCompatibilityProfile | null;
+}
+```
+
+然后挂到：
+
+```ts
+interface CustomWorldProfile {
+  ownedSettingLayers?: CustomWorldOwnedSettingLayers | null;
+}
+```
+
+这样好处是：
+
+1. 不用在 `CustomWorldProfile` 顶层堆太多字段
+2. 迁移更集中
+3. 后续删除兼容层更容易
+
+---
+
+## 8. 对当前功能链的保护要求
+
+这次优化过程中，下面这些能力不能坏：
+
+1. 自定义世界创建
+2. 自定义世界保存 / 读取
+3. 自定义世界角色生成
+4. 自定义世界场景生成
+5. 自定义世界开局
+6. 自定义世界运行时的：
+   - 属性
+   - 资源词
+   - 经济
+   - 场景图
+   - 敌对实体
+   - ThemePack
+   - prompt 组织
+
+也就是说：
+
+**任何一次迭代都必须是“新层可用 + 旧层仍可兜底”。**
+
+---
+
+## 9. 验收标准
+
+当下面这些标准成立时，说明这套优化开始有效：
+
+1. 新生成的自定义世界不再必须依赖 `templateWorldType` 才能表达自身设定。
+2. 运行时优先读取 `ownedSettingLayers`，而不是先问武侠 / 仙侠。
+3. 自定义世界的属性、资源词、经济、视觉参考、怪物映射、ThemePack 都能从自身设定层派生出来。
+4. 新设定层描述的是通用语义，不是模板世界换皮。
+5. 当前自定义世界生成流程、旧存档、旧结果页工作台仍然可用。
+
+---
+
+## 10. 最后结论
+
+如果目标是：
+
+**让这些依赖都变成属于自定义世界的设定，而且这些设定要通用于任何题材。**
+
+那么最正确的方向不是“继续弱化武侠 / 仙侠字样”，而是：
+
+**把模板支撑层整体迁移成自定义世界自己的设定层。**
+
+更具体地说，就是把当前依赖重组为：
+
+1. 自定义世界自己的语义锚
+2. 自定义世界自己的规则 profile
+3. 自定义世界自己的表达 profile
+4. 自定义世界自己的原型参考 profile
+5. 只负责兼容的旧模板字段
+
+这样之后，自定义世界才会真正从：
+
+**模板依赖型生成架构**
+
+迁移成：
+
+**跨题材、自有设定层、且兼容当前流程的生成架构。**
--- a/docs/design/CUSTOM_WORLD_TEMPLATE_DECOUPLING_AND_CROSS_GENRE_GENERALIZATION_DESIGN_2026-04-08.md
+++ b/docs/design/CUSTOM_WORLD_TEMPLATE_DECOUPLING_AND_CROSS_GENRE_GENERALIZATION_DESIGN_2026-04-08.md
@@ -0,0 +1,656 @@
+# 自定义世界去模板依赖与跨题材通用化优化设计
+
+更新时间：`2026-04-08`
+
+## 0. 目标
+
+这份文档解决的是一个已经明确暴露出来的问题：
+
+**当前玩家主流程虽然已经移除了武侠 / 仙侠两个预设世界，但自定义世界底层仍然依赖武侠 / 仙侠模板设定。**
+
+本次优化的目标不是简单“删掉模板字段”，而是要在不破坏当前自定义世界生成流程的前提下，把这些依赖逐步改造成：
+
+**属于自定义世界自身、且能通用于任何题材的设定层。**
+
+一句话定义：
+
+**让自定义世界从“挂靠武侠 / 仙侠模板运行”，升级成“基于通用世界设定层独立运行”。**
+
+---
+
+## 1. 优化原则
+
+这次优化必须同时满足 3 条硬原则：
+
+1. 设定归自定义世界自身所有
+   - 任何运行时、生成期、表现层真正依赖的设定，都应尽量落回 `CustomWorldProfile` 或由它直接编译出的通用配置，不再默认挂在 `WUXIA / XIANXIA` 两个模板世界上。
+
+2. 设定必须跨题材通用
+   - 不能把“自定义世界去模板化”理解成“再做一套更抽象的武侠 / 仙侠替代字段”。
+   - 新结构必须能容纳奇幻、科幻、悬疑、末世、现代、神话、校园等任何题材。
+
+3. 不能破坏当前自定义世界生成流程
+   - 现有 `framework -> themePack -> storyGraph -> role / landmark -> runtime` 主链必须继续能跑。
+   - 优化应以兼容迁移为主，而不是大爆破式重写。
+
+---
+
+## 2. 当前问题归纳
+
+根据 [CUSTOM_WORLD_TEMPLATE_DEPENDENCY_INVENTORY_2026-04-08.md](../reference/CUSTOM_WORLD_TEMPLATE_DEPENDENCY_INVENTORY_2026-04-08.md)，当前自定义世界仍依赖模板层的地方主要有：
+
+1. 模板锚点类型
+   - `templateWorldType`
+   - `WorldTemplateType`
+   - `resolveRuleWorldType(...)`
+
+2. 主题与规则回退
+   - `detectCustomWorldThemeMode(...)`
+   - `resolveCustomWorldAnchorWorldType(...)`
+   - `buildThemePackFromWorldProfile(...)` 底板
+
+3. 属性与表现
+   - 预设世界属性 schema
+   - 资源词、数值命名、货币命名
+
+4. 角色骨架
+   - `PRESET_CHARACTERS`
+   - 模板技能定义
+   - 模板 opening 接口
+
+5. 场景与视觉参考
+   - 武侠 / 仙侠场景图片参考池
+   - 模板 camp 场景映射
+
+6. 怪物模板池
+   - 武侠 / 仙侠怪物 preset 池
+
+这些依赖本质上说明：
+
+**当前自定义世界不是完全自足，而是“先生成自定义内容，再把它映射回两套模板世界骨架”。**
+
+---
+
+## 3. 这次优化不应该怎么做
+
+先明确几个错误方向：
+
+## 3.1 不能直接删掉 `templateWorldType`
+
+如果直接删除：
+
+- `templateWorldType`
+- `WorldTemplateType`
+- `WUXIA / XIANXIA` 相关回退
+
+而不先补新的通用设定层，那么当前自定义世界会立刻失去：
+
+1. 规则桥接
+2. 主题底板
+3. 场景图参考
+4. 怪物池匹配
+5. 属性 schema fallback
+
+这会直接打断现有生成和运行链路。
+
+## 3.2 不能把新设定继续写成“武侠 / 仙侠的抽象别名”
+
+例如下面这种思路是不够的：
+
+- 把 `templateWorldType` 改名成 `worldFamily`
+- 但值仍然只有两类近似武侠 / 仙侠的内部枚举
+
+这不是真正跨题材，只是换了名字。
+
+## 3.3 不能让创作者承担更多底层配置工作
+
+这次优化不是让创作者额外填写：
+
+- 怪物模板表
+- 场景参考池
+- 属性 schema 槽位
+- 规则 profile
+
+正确方向应该是：
+
+**这些通用设定仍由系统生成 / 编译，但所有权回到自定义世界自身。**
+
+---
+
+## 4. 目标结构：把模板依赖改造成自定义世界自己的 4 层通用设定
+
+为了避免系统越改越散，这次建议不要新增很多彼此平行的新系统，而是把现有模板依赖统一收束成 4 层通用设定。
+
+## 4.1 第一层：世界语义锚层
+
+这是替代 `templateWorldType` 的核心层。
+
+它不再回答“你更像武侠还是仙侠”，而回答：
+
+1. 这个世界的主要冲突形式是什么
+2. 这个世界的制度、禁忌、叙事载体、力量来源是什么
+3. 这个世界更接近哪类表现模式
+
+建议由自定义世界自己持有一个通用结构，例如：
+
+```ts
+interface CustomWorldSemanticAnchor {
+  genreSignals: string[];
+  conflictModel: string[];
+  institutionHints: string[];
+  tabooHints: string[];
+  carrierHints: string[];
+  forceSystemHints: string[];
+}
+```
+
+说明：
+
+- 它是自定义世界自己的语义锚。
+- 它可以表示：
+  - 宗门与灵脉
+  - 财团与实验体
+  - 学园与旧规
+  - 边境与裂界
+  - 海潮与失落群岛
+  - 神话与誓约
+- 不再强制回落到武侠 / 仙侠二选一。
+
+## 4.2 第二层：规则与表现配置层
+
+这是替代：
+
+- `resolveRuleWorldType(...)`
+- 预设属性 schema fallback
+- 资源命名 fallback
+- 经济 fallback
+
+建议改成由自定义世界持有一份通用 `WorldRuleProfile`：
+
+```ts
+interface WorldRuleProfile {
+  attributeSchema: WorldAttributeSchema;
+  resourceLabels: {
+    hp: string;
+    mp: string;
+    maxHp: string;
+    maxMp: string;
+    damage: string;
+    guard: string;
+    range: string;
+    cooldown: string;
+    manaCost: string;
+    currency: string;
+  };
+  economyProfile: {
+    initialCurrency: number;
+    rarityValueScale: Record<string, number>;
+  };
+}
+```
+
+关键点：
+
+1. 以后运行时不要再优先问“这是武侠还是仙侠”。
+2. 应该直接问：
+   - `profile.ruleProfile.attributeSchema`
+   - `profile.ruleProfile.resourceLabels`
+   - `profile.ruleProfile.economyProfile`
+
+这样：
+
+- 奇幻世界可以叫“体魄 / 法力”
+- 末世世界可以叫“生命 / 电量”
+- 校园悬疑世界甚至可以弱化“mana”概念，改成“专注 / 压力”
+
+## 4.3 第三层：内容骨架与参考层
+
+这是替代：
+
+- 预设角色模板骨架
+- 武侠 / 仙侠场景图参考池
+- 武侠 / 仙侠怪物 preset 池
+
+这里不建议让自定义世界自己保存大批素材，而是建议让自定义世界持有：
+
+**对内容骨架的“编译后引用配置”。**
+
+建议统一成一个 `ContentReferenceProfile`：
+
+```ts
+interface ContentReferenceProfile {
+  roleArchetypes: RoleArchetypeProfile[];
+  sceneReferenceBuckets: SceneReferenceBucket[];
+  creatureArchetypes: CreatureArchetypeProfile[];
+}
+```
+
+其中每个子项都应是通用语义，而不是模板世界名：
+
+1. `RoleArchetypeProfile`
+   - 例如：
+     - 正面压制型
+     - 远程游击型
+     - 灵术控制型
+     - 重装承压型
+     - 潜行刺击型
+
+2. `SceneReferenceBucket`
+   - 例如：
+     - 高压门禁区
+     - 雨夜街巷区
+     - 高空通道区
+     - 神殿 / 仪式区
+     - 工业热区
+     - 潮湿临水区
+
+3. `CreatureArchetypeProfile`
+   - 例如：
+     - 潜伏掠食者
+     - 重甲承压者
+     - 群居灵体
+     - 远程骚扰者
+     - 寄生污染体
+
+关键点：
+
+- 这些 archetype 可以继续映射到底层素材和 preset。
+- 但对自定义世界来说，它依赖的是“通用原型”，不是“武侠怪物池 / 仙侠怪物池”。
+
+## 4.4 第四层：叙事与词汇编译层
+
+这是替代：
+
+- 以模板世界为底的 `ThemePack` fallback
+- prompt 中的模板世界兼容字段
+
+建议做法：
+
+1. `ThemePack` 继续保留，但它的来源变成：
+   - `semanticAnchor + creatorIntent + world text + content reference profile`
+
+2. 生成框架 prompt 不再要求输出：
+   - `templateWorldType: WUXIA|XIANXIA`
+
+3. 改为要求输出：
+   - 世界语义锚
+   - 规则表现关键词
+   - 冲突和制度线索
+
+例如：
+
+```ts
+interface CustomWorldGenerationFramework {
+  name: string;
+  subtitle: string;
+  summary: string;
+  tone: string;
+  playerGoal: string;
+  semanticAnchor: CustomWorldSemanticAnchor;
+  majorFactions: string[];
+  coreConflicts: string[];
+  camp: CampOutline;
+}
+```
+
+这样：
+
+- 生成流程仍然是 `framework -> themePack -> storyGraph -> role / landmark`
+- 只是 framework 的核心锚不再依赖预设世界枚举
+
+---
+
+## 5. 现有依赖如何一一改造
+
+## 5.1 `templateWorldType` -> `semanticAnchor + ruleProfile`
+
+当前用途：
+
+- 表示自定义世界挂靠武侠还是仙侠
+
+目标改造：
+
+- 运行时不再直接读取 `templateWorldType`
+- 改为读取：
+  - `semanticAnchor`
+  - `ruleProfile`
+
+迁移策略：
+
+1. 先保留 `templateWorldType` 作为兼容字段
+2. 新增 `semanticAnchor / ruleProfile`
+3. 由旧字段自动编译出新字段
+4. 所有读取逻辑逐步切到新字段
+5. 最后把 `templateWorldType` 降级为 migration-only 字段
+
+## 5.2 `resolveRuleWorldType(...)` -> `resolveWorldRuleProfile(...)`
+
+当前用途：
+
+- 把 `CUSTOM` 解析回 `WUXIA / XIANXIA`
+
+目标改造：
+
+- 不再返回模板 world type
+- 直接返回自定义世界自己的 `ruleProfile`
+
+即：
+
+```ts
+resolveWorldRuleProfile(worldType, customWorldProfile)
+```
+
+返回：
+
+- `attributeSchema`
+- `resourceLabels`
+- `economyProfile`
+- 其它规则信息
+
+## 5.3 预设属性 schema -> 通用 attribute schema seed
+
+当前用途：
+
+- 用武侠 / 仙侠 schema 作为自定义世界 schema 参考底板
+
+目标改造：
+
+- 不再直接引用“武侠六脉 / 仙侠六轴”作为唯一底板
+- 改为维护一组通用 `attribute schema seeds`
+
+例如可按世界体验而不是题材命名：
+
+1. 正面对抗型
+2. 机动博弈型
+3. 灵知洞察型
+4. 共鸣契约型
+5. 生存续航型
+6. 高危推进型
+
+然后由自定义世界的 `semanticAnchor` 决定如何组合或命名这些槽位。
+
+## 5.4 预设角色模板 -> 通用角色原型骨架
+
+当前用途：
+
+- 从 `PRESET_CHARACTERS` 选模板角色，再覆写自定义世界内容
+
+目标改造：
+
+- 把当前模板角色骨架抽成“通用战斗原型角色”
+
+例如保留的是：
+
+- 技能骨架
+- 动作风格
+- build 倾向
+- 动画资源挂载方式
+
+而不是保留“剑之公主 / 神箭游侠”这样的预设世界人格设定。
+
+关键点：
+
+- 动画素材和技能骨架可以保留
+- 但运行时不应再依赖具体模板角色的人设文本
+
+## 5.5 武侠 / 仙侠场景图参考池 -> 通用场景参考桶
+
+当前用途：
+
+- 用武侠 / 仙侠场景关键词为自定义世界匹配默认背景图
+
+目标改造：
+
+- 改成通用 `SceneReferenceBucket`
+- 每个 bucket 对应一类空间语义
+
+例如：
+
+1. 落脚处 / 归舍
+2. 高压入口
+3. 雨湿街巷
+4. 高空通路
+5. 仪式空间
+6. 工业热区
+7. 临水空间
+8. 地底遗迹
+
+这样就能让：
+
+- 科幻世界
+- 校园世界
+- 神话世界
+- 末世世界
+
+都共享同一套“空间语义 -> 视觉参考”的逻辑。
+
+## 5.6 武侠 / 仙侠怪物池 -> 通用生物原型库
+
+当前用途：
+
+- 从武侠 / 仙侠怪物池里为自定义世界匹配怪物
+
+目标改造：
+
+- 改成通用 `CreatureArchetypeProfile`
+- 再由 archetype 去映射底层 preset / 数值 / 动画素材
+
+这样做的好处：
+
+1. 自定义世界依赖的是“潜伏者 / 重压者 / 群居体 / 异化体”
+2. 而不是“这更像武侠怪还是仙侠怪”
+
+## 5.7 `ThemePack` 底板 -> 通用语义底板
+
+当前用途：
+
+- 自定义世界的 ThemePack 还是从预设题材包底板开始
+
+目标改造：
+
+- 让 ThemePack 直接从：
+  - `semanticAnchor`
+  - `creatorIntent`
+  - `majorFactions`
+  - `coreConflicts`
+  - `contentReferenceProfile`
+  编译出来
+
+也就是说：
+
+**ThemePack 应变成自定义世界自己的派生物，而不是模板世界的扩写版。**
+
+---
+
+## 6. 不破坏现有生成流程的迁移方案
+
+这是这份文档最重要的部分。
+
+正确做法不是一口气替换，而是兼容迁移。
+
+## 阶段 A：新增通用设定字段，但不删旧字段
+
+先做：
+
+1. 在 `CustomWorldProfile` 上新增：
+   - `semanticAnchor`
+   - `ruleProfile`
+   - `contentReferenceProfile`
+
+2. 保留：
+   - `templateWorldType`
+
+3. 由当前旧字段自动编译出新字段
+
+目标：
+
+- 先让新结构出现
+- 但现有流程完全不受影响
+
+## 阶段 B：生成流程改为优先产出新字段
+
+先改：
+
+- `framework prompt`
+- `customWorld.ts`
+
+让 AI 先输出：
+
+- 通用语义锚
+- 规则提示
+- 通用 archetype 线索
+
+同时在 normalize 层继续兼容旧的 `templateWorldType`
+
+目标：
+
+- 新生成的自定义世界开始“原生带通用设定”
+- 旧存档仍可继续读取
+
+## 阶段 C：运行时读取切到新设定
+
+依次改：
+
+1. 规则层
+   - 从 `resolveRuleWorldType` 切到 `resolveWorldRuleProfile`
+
+2. 属性层
+   - 优先读 `profile.ruleProfile.attributeSchema`
+
+3. 资源词与经济层
+   - 优先读 `profile.ruleProfile.resourceLabels / economyProfile`
+
+4. 场景图与怪物映射
+   - 优先读 `contentReferenceProfile`
+
+目标：
+
+- 让模板世界字段不再是运行时第一来源
+
+## 阶段 D：模板世界字段退化为兼容层
+
+这一步完成后：
+
+1. `templateWorldType` 只用于：
+   - 旧存档迁移
+   - 老测试兼容
+   - 数据修复 fallback
+
+2. 不再用于：
+   - 正式生成主链
+   - 正式运行时主链
+
+## 阶段 E：再做深清理
+
+只有当上面几步都完成后，才适合继续清理：
+
+1. 非必要的模板回退逻辑
+2. 非必要的主流程模板枚举消费点
+3. 非必要的审计 / 工具硬编码
+
+---
+
+## 7. 对当前主链的兼容要求
+
+这次优化过程中，下面这些链路必须始终可用：
+
+1. `PreGameSelectionFlow -> generateCustomWorldProfile(...)`
+2. `framework -> themePack -> storyGraph -> role / landmark`
+3. 保存 / 读取自定义世界 profile
+4. 自定义世界开局
+5. 自定义世界角色与场景生成
+6. 自定义世界运行时怪物 / 物品 / 场景图 /词汇表现
+
+也就是说：
+
+**任何迁移都必须先补新字段，再迁读，再退旧字段，不能先删旧字段。**
+
+---
+
+## 8. 建议新增或改造的最小数据结构
+
+为了避免系统膨胀，这次不建议引入很多彼此割裂的新系统，建议只在 `CustomWorldProfile` 周边增量补三块。
+
+## 8.1 `semanticAnchor`
+
+```ts
+interface CustomWorldSemanticAnchor {
+  genreSignals: string[];
+  conflictModel: string[];
+  institutionHints: string[];
+  tabooHints: string[];
+  carrierHints: string[];
+  forceSystemHints: string[];
+}
+```
+
+## 8.2 `ruleProfile`
+
+```ts
+interface WorldRuleProfile {
+  attributeSchema: WorldAttributeSchema;
+  resourceLabels: {
+    hp: string;
+    mp: string;
+    maxHp: string;
+    maxMp: string;
+    damage: string;
+    guard: string;
+    range: string;
+    cooldown: string;
+    manaCost: string;
+    currency: string;
+  };
+  economyProfile: {
+    initialCurrency: number;
+  };
+}
+```
+
+## 8.3 `contentReferenceProfile`
+
+```ts
+interface ContentReferenceProfile {
+  roleArchetypes: string[];
+  sceneReferenceBuckets: string[];
+  creatureArchetypes: string[];
+}
+```
+
+这三块足够作为第一轮去模板化的最小自定义世界设定层。
+
+---
+
+## 9. 验收标准
+
+做到以下几点，才能说明自定义世界真正开始脱离模板依赖：
+
+1. 新生成的自定义世界框架不再需要直接输出 `WUXIA|XIANXIA` 才能工作。
+2. 运行时核心逻辑优先读取 `semanticAnchor / ruleProfile / contentReferenceProfile`。
+3. 自定义世界的属性 schema、资源词、经济词不再默认直接回退到武侠 / 仙侠文案。
+4. 自定义世界的角色骨架、场景视觉、怪物映射能通过通用 archetype 表达。
+5. 现有生成流程、存档读取、运行时体验不受破坏。
+6. 旧存档仍能通过兼容层运行。
+
+---
+
+## 10. 最后结论
+
+当前自定义世界真正缺的，不是“再删一点武侠 / 仙侠字样”，而是：
+
+**把模板世界支撑层改写成自定义世界自己的通用设定层。**
+
+更准确地说，这次优化要完成的是：
+
+1. 把模板锚点改成自定义世界自己的语义锚
+2. 把模板回退改成自定义世界自己的规则配置
+3. 把模板角色 / 场景 / 怪物参考改成通用原型引用
+4. 把 ThemePack 和生成 prompt 从“依附模板世界”改成“直接从自定义世界自身编译”
+
+同时整个过程必须遵守一条底线：
+
+**任何优化都不能破坏当前自定义世界生成与运行主链。**
+
+所以这不是“删模板”的问题，而是一次：
+
+**在兼容现有流程前提下，把自定义世界从模板依赖型架构，迁移成真正跨题材、自足型架构。**
--- a/docs/design/README.md
+++ b/docs/design/README.md
@@ -5,6 +5,8 @@
 ## 文档列表

 - [CUSTOM_WORLD_CREATOR_INPUT_AND_AI_BOUNDARY_DESIGN_2026-04-06.md](./CUSTOM_WORLD_CREATOR_INPUT_AND_AI_BOUNDARY_DESIGN_2026-04-06.md)：自定义世界里创作者输入与 AI 分工边界设计。
+- [CUSTOM_WORLD_TEMPLATE_DECOUPLING_AND_CROSS_GENRE_GENERALIZATION_DESIGN_2026-04-08.md](./CUSTOM_WORLD_TEMPLATE_DECOUPLING_AND_CROSS_GENRE_GENERALIZATION_DESIGN_2026-04-08.md)：把自定义世界从武侠/仙侠模板依赖迁到跨题材通用设定层的优化设计。
+- [CUSTOM_WORLD_SELF_OWNED_SETTING_LAYER_OPTIMIZATION_2026-04-08.md](./CUSTOM_WORLD_SELF_OWNED_SETTING_LAYER_OPTIMIZATION_2026-04-08.md)：把模板依赖逐步迁成自定义世界自有设定层，并保证不破坏当前生成流程的优化方案。
 - [AI_NATIVE_RUNTIME_ITEM_SYSTEM_REDESIGN_2026-04-02.md](./AI_NATIVE_RUNTIME_ITEM_SYSTEM_REDESIGN_2026-04-02.md)：运行时物品生成系统重设计。
 - [EQUIPMENT_BUILD_AND_FORGE_LOOP_SYSTEM_DESIGN.md](./EQUIPMENT_BUILD_AND_FORGE_LOOP_SYSTEM_DESIGN.md)：配装构筑与合成/锻造闭环设计。
 - [COMPANION_FIRST_CONTACT_RELATIONSHIP_AND_PRIVATE_CHAT_DESIGN_2026-04-04.md](./COMPANION_FIRST_CONTACT_RELATIONSHIP_AND_PRIVATE_CHAT_DESIGN_2026-04-04.md)：角色首遇感、关系分层解锁、私聊系统设计。
@@ -15,6 +17,8 @@

 - 做物品、Build、锻造相关需求时，先看前两份。
 - 做自定义世界创作工作台、创作者输入边界、AI 分工设计时，先看第一份。
+- 做自定义世界去模板依赖、跨题材泛化、兼容迁移设计时，优先看新增的去模板化优化设计稿。
+- 做“模板依赖如何真正变成自定义世界自有设定层”的具体迁移方案时，优先看新增的自有设定层优化方案。
 - 做角色关系、同伴互动、对话表现时，先看后两份。
 - 做剧情引擎章节化、场景闭环、章节任务接入时，优先看新增的场景章节设计稿。
 - 如果要判断是否符合目标，再和 `docs/prd/` 中对应 PRD 对照阅读。