muse-agent-example/docs/系统架构/新版设计/数据模型/内置类型承接表.md

内置类型与原字段承接

原设计列出 23 个基础类型，当前代码树另有 fine_outline 章级细纲合同，共 24 份 YAML、216 条逐型字段定义。此计数来自本次文件读取，不代表数据库已装入或这些字段已在新版实现。原定义全文保存在原结构快照。

类型、语义域与实例归属

结构类型与实例归属分别表达。同一模具可以用于代码登记的不同实例族；每个实例只有一个维护者，由具名业务命令及用途确定，模型不能自报 owner 改变落点。

原类型身份	中文名	原 domain / scope	新版实例维护者	原逐型字段数	字段快照
chapter	章节容器	content / chapter	B01	10	chapter.yaml
character	角色	world / entity	B02 本书、B03 参考分析、B04 公共写法	13	character.yaml
character_relation	角色关系	world / relation	B02；参考分析在 B03	8	character_relation.yaml
combat	打斗桥段	narrative / entity	B04	8	combat.yaml
craft	叙事技法	narrative / entity	B04	16	craft.yaml
emotion	情感桥段	narrative / entity	B04	7	emotion.yaml
event	事件	world / event	B02	11	event.yaml
faction	组织阵营	world / entity	B02；参考分析在 B03	12	faction.yaml
fine_outline	章级细纲	content / chapter	B01	16	fine_outline.yaml
generation_context	生成上下文	ai_context / agent	B09	0	generation_context.yaml
item	物品	world / entity	B02；参考分析在 B03	11	item.yaml
location	地点	world / entity	B02；参考分析在 B03	10	location.yaml
narrative_state	叙事状态	content / work	B02	7	narrative_state.yaml
novel_work	作品容器	content / work	B01	7	novel_work.yaml
outline	大纲	content / work	B01	7	outline.yaml
pacing	节奏画像	narrative / work	B01 规划、B04 方法	8	pacing.yaml
power_system	力量体系	world / entity	B02；参考分析在 B03	11	power_system.yaml
reference_work	参考作品档案	knowledge / entity	B03	8	reference_work.yaml
scene	场景卡	content / block	B01 场景计划；B05 正文引用	7	scene.yaml
scene_pattern	通用桥段	narrative / entity	B04	8	scene_pattern.yaml
style	文风画像	narrative / work	B06 本书声音、B04 可复用写法	8	style.yaml
trope	套路	narrative / entity	B04	7	trope.yaml
work_core	作品核心	content / work	B01	9	work_core.yaml
world	世界观总纲	world / work	B02	7	world.yaml

逐型字段语义清单

此清单记录要承接的原字段身份，不要求为每个字段增加物理列。原来的说明、别名、AI 用途和必填规则以快照为证据。目标发布将描述型定义转换为有明确字段类型及约束的结构版本；不能把自然语言字段说明直接当作完成运行时校验。

chapter · 章节容器

• 章号
• 标题
• 本章目标
• 前情衔接
• 出场角色
• 场景列表
• 伏笔动作
• 章末钩子
• 字数
• 依据

character · 角色

• 身份定位
• 阵营
• 境界与能力
• 外貌特征
• 性格底色
• 核心渴望与心魔
• 行事逻辑
• 说话方式
• 秘密与底牌
• 成长弧线
• 演变历程
• 演变概括
• 创作备忘

character_relation · 角色关系

• 甲方
• 乙方
• 关系类型
• 当前状态
• 演变轨迹
• 张力来源
• 双方认知差
• 计划走向

combat · 打斗桥段

• 对抗类型
• 开局态势
• 节拍结构
• 反转机制
• 代价结构
• 败者处理
• 读者收益
• 例证出处

craft · 叙事技法

• 装置形态
• 装置类型
• 原理
• 触发条件
• 读者收益
• 埋设手法
• 回收点
• 记忆维持
• 间隔纪律
• 复用节奏
• 异质化要求
• 单章上限
• 滥用反例
• 失败模式
• 迁移用例
• 例证出处

emotion · 情感桥段

• 情绪弧类型
• 铺垫结构
• 爆发点设计
• 克制手法
• 关系后果
• 目标情绪
• 例证出处

event · 事件

• 时间锚
• 地点
• 参与者
• 起因经过结果
• 因果后续
• 知情范围
• 事实状态
• 演变历程
• 演变概括
• 前身
• 后继

faction · 组织阵营

• 性质
• 宗旨与立场
• 层级结构
• 核心成员
• 实力概览
• 地盘
• 利益诉求
• 与主角线的关系
• 演变历程
• 演变概括
• 前身
• 后继

fine_outline · 章级细纲

• targetChapter
• sourceRef
• chapterGoal
• hardConstraints
• keyEvents
• adjustableBeats
• declaredNewFacts
• mustAppearEntities
• chapterEndHook
• foreshadowing
• entities
• stateChanges
• unknowns
• assumptions
• sourceRefs
• targetChars

原合同必填字段：targetChapter、sourceRef、chapterGoal、hardConstraints、keyEvents、adjustableBeats、declaredNewFacts、mustAppearEntities、chapterEndHook。

generation_context · 生成上下文

item · 物品

• 类别
• 品阶
• 来历
• 能力与限制
• 当前持有者
• 知情范围
• 流转计划
• 演变历程
• 演变概括
• 前身
• 后继

location · 地点

• 层级
• 地理与环境
• 归属势力
• 戏剧功能
• 规则特例
• 与主线关联
• 演变历程
• 演变概括
• 前身
• 后继

narrative_state · 叙事状态

• 当前进度
• 上章末即时局面
• 未决冲突清单
• 未回收伏笔台账
• 角色状态速览
• 近期张力曲线
• 下章衔接要点

novel_work · 作品容器

• 书名
• 品类
• 一句话简介
• 篇幅目标
• 连载状态
• 已确认章数
• 总字数

outline · 大纲

• 主线一句话
• 分卷粗纲
• 当前卷细纲
• 近三章细纲：指向本书已确认细纲的稳定身份，关系用途为关联，不作为大纲反向依据；由B01解析。
• 目标字数
• 未来卷粗纲
• 弃案记录

pacing · 节奏画像

• 黄金三章画像
• 开局策略
• 上架节奏切换
• 张力曲线
• 爽点间隔
• 文戏武戏配比
• 钩子密度画像
• 例证出处

power_system · 力量体系

• 力量来源
• 境界阶梯
• 修行方式
• 代价与限制
• 资源依赖
• 跨体系换算
• 戏剧作用
• 演变历程
• 演变概括
• 前身
• 后继

reference_work · 参考作品档案

• 作者
• 时代与品类
• 来源
• 版权授权状态
• 已收录章节
• 拆书处理状态
• 拆书目标
• 产出范式清单

scene · 场景卡

• 序号
• 地点
• POV
• 出场
• 时间锚
• 情绪基调
• 目标推进收束

scene_pattern · 通用桥段

• 场景类型
• 目标结构
• 推进机制
• 收束方式
• 信息功能
• 角色功能位
• 读者收益
• 例证出处

style · 文风画像

• 叙事人称与视角纪律
• 句式画像
• 叙述配比
• 用词质感
• AI味黑名单
• 对话风格
• 章末钩子风格
• 达标样张

trope · 套路

• 适用品类
• 公式
• 启动条件
• 张力来源
• 常见变体
• 失效风险
• 例证出处

work_core · 作品核心

• 题材定位
• 核心概念与卖点
• 主题立意
• 基调与体温
• 禁区
• 核心悬念
• 谜底与真相
• 结局方向
• 目标读者

world · 世界观总纲

• 世界一句话
• 纪元与时代背景
• 世界格局
• 核心法则
• 常识与禁忌
• 超凡入口
• 历史大事粗线

承接约束

• 名称、别名、一句话摘要、标签等公共内容字段与逐型特有字段合成。来源和确认状态属于受保护骨架，可元描述但不能由模型直接改值。

• 公共内容字段由 公共字段.yaml 唯一维护，使用 common.name/aliases/summary/tags 稳定身份，在发布种子时合成并进入结构哈希；名称与摘要推荐填写，草稿阶段允许未填。业务确认所需的完整性由对应具名命令校验。

• fine_outline 和 generation_context 保留专属协议外壳，不注入公共内容字段。新版种子共 216 个逐型字段与 88 个公共内容字段位置；旧库中每型重复的来源、状态仍归业务骨架，不能按同名动态值回填。

• 旧库生效版本和文件种子分别核对。别名、旧字段类型到新类型的转换及重复字段由迁移记录显式处理；发布新种子不等于迁移旧实例，不直接覆盖旧库 active 版本。

• 成长弧线中的未来计划与演变历程中的已发生事实分开；字段级 planning、generation、detection、extraction 用途不能在迁移中丢失。

• novel_work 与 work_core 分别承接作品容器和创作承诺；不得因都属于作品而合并保存、确认语义。

• fine_outline 保留独立章级合同。旧 targetChapter 和来源章号显式映射到稳定章节身份；篇幅和字面要求来自任务合同，不变成所有作品共用的样本门锚。

• scene 的旧 block 粒度不等于新版段落。新场景计划与正文位置通过引用连接，迁移保留对应关系。

• generation_context 是系统用途结构；作品字段扩展不能更改执行外壳、工具权限或受保护输出协议。

• 题材特有属性可以在结构模板或作品扩展表达；未使用类型和空可选字段不要求作者全部填写。新类型进入已登记实例族和同一消费机制。

• 旧 YAML 的文件式实例落点和启用时间属于历史描述，不能据此写文件替代 PostgreSQL 或宣称当前库已验收。

• 消费细纲须包含mustAppearEntities对象分支的引用声明，字符串和id/type/name形式均生成相同本书引用需求；id/type必须由B02核实，name只是原输入的展示标签。该修正发生在新版预发布种子，原结构快照与原哈希保留；验证使用新隔离库，不覆盖既有已发布结构。