125 KiB
125 KiB
项目目录与文件职责
本文件是目标文件清单的可读投影。每个文件的意图、职责、边界和目标见逐文件设计目录，当前旧路径的替代和退出见现有文件处置。全部条目相对 agent-example 根目录，仅定义重写的目标位置；实际实现与验证状态以工作包清单和执行证据为准。
命名与职责
自有业务目录和文件使用中文；技术约定名称保留。Python 内部函数、类和协议字段遵循语言惯例，展示名与稳定身份分离。React 组件以 Ui 加中文业务名、Hook 以 useMuse 加中文业务名保留框架识别前缀。所有实际 Python 包的 init.py 已列入清单。生成目录及私人数据中的占位符表示运行期身份，其他手写文件逐个给出名称。
跨模块公开接口由接口.py 暴露，模块内部存储只维护本模块记录。元数据拥有模具，各业务拥有实例；前端结构表单、后端校验、模型合同和字段投影读取同一固定结构。完整设计说明见总体架构与元数据结构。
完整目标树
agent-example/
├── .agent/
│ ├── rules/
│ │ ├── 任务与证据.md # 任务与证据 的短规则与权威文档引用
│ │ ├── 元数据消费.md # 元数据消费 的短规则与权威文档引用
│ │ ├── 审校与修订.md # 审校、授权范围、保真和原文保留的短规则
│ │ ├── 文档与资源生成.md # 文档与资源生成 的短规则与权威文档引用
│ │ ├── 模块依赖.md # 模块依赖 的短规则与权威文档引用
│ │ ├── 正式变更.md # 正式变更 的短规则与权威文档引用
│ │ ├── 测试隔离.md # 测试隔离 的短规则与权威文档引用
│ │ └── 目录.md # rules 索引
│ ├── skills/
│ │ ├── 操作/
│ │ │ ├── 修正正文机器味/
│ │ │ │ ├── SKILL.md # 修正正文机器味 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 修正正文机器味 文件索引
│ │ │ ├── 写下一章/
│ │ │ │ ├── SKILL.md # 写下一章 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 写下一章 文件索引
│ │ │ ├── 决定正文候选去留/
│ │ │ │ ├── SKILL.md # 决定正文候选去留 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 决定正文候选去留 文件索引
│ │ │ ├── 制定作品规划/
│ │ │ │ ├── SKILL.md # 制定作品规划 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 制定作品规划 文件索引
│ │ │ ├── 压缩正文/
│ │ │ │ ├── SKILL.md # 压缩正文 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 压缩正文 文件索引
│ │ │ ├── 合并故事方案/
│ │ │ │ ├── SKILL.md # 合并故事方案 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 合并故事方案 文件索引
│ │ │ ├── 备份与恢复数据/
│ │ │ │ ├── SKILL.md # 备份与恢复数据 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 备份与恢复数据 文件索引
│ │ │ ├── 完善故事基础设定/
│ │ │ │ ├── SKILL.md # 完善故事基础设定 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 交付结构.json # 只用于最终交付格式的声明，不控制探索过程
│ │ │ │ │ ├── 发展联系.md # 发展联系 的探索提示
│ │ │ │ │ ├── 收集素材.md # 收集素材 的探索提示
│ │ │ │ │ ├── 整理交付.md # 整理交付 的探索提示
│ │ │ │ │ ├── 比较分歧.md # 比较分歧 的探索提示
│ │ │ │ │ ├── 目录.md # 探索子阶段索引
│ │ │ │ │ ├── 组织结构.md # 组织结构 的探索提示
│ │ │ │ │ └── 试探中心.md # 试探中心 的探索提示
│ │ │ │ └── 目录.md # 完善故事基础设定 文件索引
│ │ │ ├── 导入资料/
│ │ │ │ ├── SKILL.md # 导入资料 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 导入资料 文件索引
│ │ │ ├── 建立作品声音档案/
│ │ │ │ ├── SKILL.md # 建立作品声音档案 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 建立作品声音档案 文件索引
│ │ │ ├── 建立机器味规则/
│ │ │ │ ├── SKILL.md # 建立机器味规则 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 建立机器味规则 文件索引
│ │ │ ├── 扩写场景/
│ │ │ │ ├── SKILL.md # 扩写场景 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 扩写场景 文件索引
│ │ │ ├── 拆解书稿/
│ │ │ │ ├── SKILL.md # 拆解书稿 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 拆解书稿 文件索引
│ │ │ ├── 提出并验证改进/
│ │ │ │ ├── SKILL.md # 提出并验证改进 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 提出并验证改进 文件索引
│ │ │ ├── 整理写作方法/
│ │ │ │ ├── SKILL.md # 整理写作方法 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 整理写作方法 文件索引
│ │ │ ├── 整理定稿与导出/
│ │ │ │ ├── SKILL.md # 整理定稿与导出 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 整理定稿与导出 文件索引
│ │ │ ├── 查看与恢复任务/
│ │ │ │ ├── SKILL.md # 查看与恢复任务 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 查看与恢复任务 文件索引
│ │ │ ├── 核对内容一致性/
│ │ │ │ ├── SKILL.md # 核对内容一致性 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 核对内容一致性 文件索引
│ │ │ ├── 检查与维护拆书结果/
│ │ │ │ ├── SKILL.md # 检查与维护拆书结果 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 检查与维护拆书结果 文件索引
│ │ │ ├── 润色正文/
│ │ │ │ ├── SKILL.md # 润色正文 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 润色正文 文件索引
│ │ │ ├── 登记连载与反馈/
│ │ │ │ ├── SKILL.md # 登记连载与反馈 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 登记连载与反馈 文件索引
│ │ │ ├── 目录.md # 操作技能索引
│ │ │ ├── 确认事实增量/
│ │ │ │ ├── SKILL.md # 确认事实增量 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 确认事实增量 文件索引
│ │ │ ├── 确认作者偏好/
│ │ │ │ ├── SKILL.md # 确认作者偏好 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 确认作者偏好 文件索引
│ │ │ ├── 确认规划候选/
│ │ │ │ ├── SKILL.md # 确认规划候选 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 确认规划候选 文件索引
│ │ │ ├── 维护元数据结构/
│ │ │ │ ├── SKILL.md # 维护元数据结构 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 维护元数据结构 文件索引
│ │ │ ├── 维护故事世界/
│ │ │ │ ├── SKILL.md # 维护故事世界 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 维护故事世界 文件索引
│ │ │ ├── 规划下一章/
│ │ │ │ ├── SKILL.md # 规划下一章 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 规划下一章 文件索引
│ │ │ ├── 记录机器味案例/
│ │ │ │ ├── SKILL.md # 记录机器味案例 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 案例合同.md # 案例来源、裁决和证据的操作说明
│ │ │ │ │ └── 目录.md # 案例操作资料索引
│ │ │ │ └── 目录.md # 记录机器味案例 文件索引
│ │ │ ├── 评估内容质量/
│ │ │ │ ├── SKILL.md # 评估内容质量 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 评估内容质量 文件索引
│ │ │ ├── 诊断机器味/
│ │ │ │ ├── SKILL.md # 诊断机器味 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 诊断机器味 文件索引
│ │ │ ├── 运行效果评测/
│ │ │ │ ├── SKILL.md # 运行效果评测 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 运行效果评测 文件索引
│ │ │ ├── 采集资料与榜单/
│ │ │ │ ├── SKILL.md # 采集资料与榜单 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 采集资料与榜单 文件索引
│ │ │ ├── 重写选段/
│ │ │ │ ├── SKILL.md # 重写选段 的适用范围、方法或业务命令
│ │ │ │ └── 目录.md # 重写选段 文件索引
│ │ │ └── 预防机器味/
│ │ │ ├── SKILL.md # 预防机器味 的适用范围、方法或业务命令
│ │ │ └── 目录.md # 预防机器味 文件索引
│ │ ├── 方法/
│ │ │ ├── 呈现人物/
│ │ │ │ ├── SKILL.md # 呈现人物 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 人物呈现自查台账.md # 人物呈现自查台账
│ │ │ │ │ ├── 人物声音发现法从控制到记录.md # 人物声音发现法：从控制到记录
│ │ │ │ │ ├── 关系即人物通过关系网显性格.md # 关系即人物：通过关系网显性格
│ │ │ │ │ ├── 反常即戏找到不该这样但这样了的瞬间.md # 反常即戏：找到"不该这样但这样了"的瞬间
│ │ │ │ │ ├── 呈现人物-覆盖对照表.md # 呈现人物 覆盖对照表
│ │ │ │ │ ├── 性格即命运设计碰撞而非制造巧合.md # 性格即命运：设计碰撞而非制造巧合
│ │ │ │ │ ├── 目录.md # 呈现人物参考资料索引
│ │ │ │ │ ├── 细节马赛克用具体物装配人物.md # 细节马赛克：用具体物装配人物
│ │ │ │ │ └── 隐秘生活可见性人物的真实是作者对其了如指掌.md # 隐秘生活可见性：人物的"真实"是作者对其了如指掌
│ │ │ │ └── 目录.md # 呈现人物 文件索引
│ │ │ ├── 增强叙事动力/
│ │ │ │ ├── SKILL.md # 增强叙事动力 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 内悬念在断点挂上未解问题.md # 内悬念：在断点挂上未解问题
│ │ │ │ │ ├── 叙事动力自查清单.md # 叙事动力自查清单
│ │ │ │ │ ├── 增强叙事动力-覆盖对照表.md # 增强叙事动力 覆盖对照表
│ │ │ │ │ ├── 推拉交替与相邻方法区分.md # 推拉交替与相邻方法区分
│ │ │ │ │ ├── 沿途埋金让读者在中段不弃读.md # 沿途埋金：让读者在中段不弃读
│ │ │ │ │ ├── 目录.md # 增强叙事动力参考资料索引
│ │ │ │ │ └── 造势给小说内部装上发动机.md # 造势：给小说内部装上"发动机"
│ │ │ │ └── 目录.md # 增强叙事动力 文件索引
│ │ │ ├── 打磨人物对话/
│ │ │ │ ├── SKILL.md # 打磨人物对话 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 什么时候用对话定位、时机与形式判断.md # 什么时候用对话：定位、时机与形式判断
│ │ │ │ │ ├── 对话改写检查清单.md # 对话改写检查清单
│ │ │ │ │ ├── 打磨人物对话-覆盖对照表.md # 打磨人物对话 覆盖对照表
│ │ │ │ │ ├── 标签与归属删X-说-Y-说，让读者偷听.md # 标签与归属：删"X 说 Y 说"，让读者偷听
│ │ │ │ │ ├── 目录.md # 打磨人物对话参考资料索引
│ │ │ │ │ ├── 真话质感让对话像真人说话.md # 真话质感：让对话像真人说话
│ │ │ │ │ ├── 给每段对话派任务对话是事件，不是装饰.md # 给每段对话派任务：对话是事件，不是装饰
│ │ │ │ │ ├── 节奏与密度对话的时间感、短对话、通风口.md # 节奏与密度：对话的时间感、短对话、通风口
│ │ │ │ │ ├── 角色声音让每个人说的话像那个人.md # 角色声音：让每个人说的话像那个人
│ │ │ │ │ ├── 诊断与改写流程从我的对话哪里病了到逐段修完.md # 诊断与改写流程：从"我的对话哪里病了"到逐段修完
│ │ │ │ │ └── 边界、失败模式、盲点与相邻区分.md # 边界、失败模式、盲点与相邻区分
│ │ │ │ └── 目录.md # 打磨人物对话 文件索引
│ │ │ ├── 打磨小说场景/
│ │ │ │ ├── SKILL.md # 打磨小说场景 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 场景台账模板.md # 场景台账模板
│ │ │ │ │ ├── 场景改稿检查清单（五关）.md # 场景改稿检查清单（五关）
│ │ │ │ │ ├── 定使命一个场景只交付一件事.md # 定使命：一个场景只交付一件事
│ │ │ │ │ ├── 定详略该详写还是略写，给多少字.md # 定详略：该详写还是略写，给多少字
│ │ │ │ │ ├── 定进出晚进入，早退出.md # 定进出：晚进入，早退出
│ │ │ │ │ ├── 定镜头五档焦距随时切换.md # 定镜头：五档焦距随时切换
│ │ │ │ │ ├── 打磨小说场景-覆盖对照表.md # 打磨小说场景 覆盖对照表
│ │ │ │ │ ├── 排节奏详略相间，有快有慢.md # 排节奏：详略相间，有快有慢
│ │ │ │ │ ├── 目录.md # 打磨小说场景参考资料索引
│ │ │ │ │ ├── 藏拼装蒙蔽读者，唯一的罪是被看穿.md # 藏拼装：蒙蔽读者，唯一的罪是被看穿
│ │ │ │ │ └── 边界与误区什么时候不用，哪里容易摔.md # 边界与误区：什么时候不用，哪里容易摔
│ │ │ │ └── 目录.md # 打磨小说场景 文件索引
│ │ │ ├── 打磨小说语言/
│ │ │ │ ├── SKILL.md # 打磨小说语言 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 修辞密度校准退一步与进一步（back-off-show-off）.md # 修辞密度校准：退一步与进一步（back off / show off）
│ │ │ │ │ ├── 先建稳模式，再打破一处模式转折与克制中的破例.md # 先建稳模式，再打破一处：模式转折与克制中的破例
│ │ │ │ │ ├── 句法节奏三轴主谓先行、句长控速、模式转折.md # 句法节奏三轴：主谓先行、句长控速、模式转折
│ │ │ │ │ ├── 基础体温找到你（和笔下人物）的辨识度.md # 基础体温：找到你（和笔下人物）的辨识度
│ │ │ │ │ ├── 声音均衡器把风格从神秘变工程.md # 声音均衡器：把"风格"从神秘变工程
│ │ │ │ │ ├── 打磨小说语言-覆盖对照表.md # 打磨小说语言 覆盖对照表
│ │ │ │ │ ├── 抒情不抒发小说家只是懂得.md # 抒情不抒发：小说家只是"懂得"
│ │ │ │ │ ├── 抽象梯子在看见与理解之间上下爬.md # 抽象梯子：在"看见"与"理解"之间上下爬
│ │ │ │ │ ├── 白描用最少的字立住人物.md # 白描：用最少的字立住人物
│ │ │ │ │ ├── 目录.md # 打磨小说语言参考资料索引
│ │ │ │ │ └── 语言修辞改稿清单（打磨小说语言）.md # 语言修辞改稿清单（打磨小说语言）
│ │ │ │ └── 目录.md # 打磨小说语言 文件索引
│ │ │ ├── 提炼故事概念/
│ │ │ │ ├── SKILL.md # 提炼故事概念 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 原创性就是诚实你的视角本身就是原创.md # 原创性就是诚实：你的视角本身就是原创
│ │ │ │ │ ├── 把-idea-升级成-conceptconcept-必须是what-if疑问句.md # 把 idea 升级成 concept：concept 必须是"what if"疑问句
│ │ │ │ │ ├── 提炼故事概念-覆盖对照表.md # 提炼故事概念 覆盖对照表
│ │ │ │ │ ├── 故事引擎让核心问题驱动整本书.md # 故事引擎：让核心问题驱动整本书
│ │ │ │ │ ├── 概念合格性校验concept-四问.md # 概念合格性校验：concept 四问
│ │ │ │ │ ├── 概念自查台账.md # 概念自查台账
│ │ │ │ │ ├── 目录.md # 提炼故事概念参考资料索引
│ │ │ │ │ └── 真实素材也是-concept叙事交付策略.md # 真实素材也是 concept：叙事交付策略
│ │ │ │ └── 目录.md # 提炼故事概念 文件索引
│ │ │ ├── 搭建故事结构/
│ │ │ │ ├── SKILL.md # 搭建故事结构 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── Setup-段（0-25%）的五件事.md # Setup 段（0-25%）的五件事
│ │ │ │ │ ├── 中点（Midpoint）主角从被动转主动的那堵墙.md # 中点（Midpoint）：主角从被动转主动的那堵墙
│ │ │ │ │ ├── 六大里程碑在四箱之内定点.md # 六大里程碑：在四箱之内定点
│ │ │ │ │ ├── 四箱结构Setup-Response-Attack-Resolution.md # 四箱结构：Setup / Response / Attack / Resolution
│ │ │ │ │ ├── 搭建故事结构-覆盖对照表.md # 搭建故事结构 覆盖对照表
│ │ │ │ │ ├── 煽动事件-≠-第一情节点开篇大事件和故事启动是两回事.md # 煽动事件 ≠ 第一情节点：开篇大事件和故事启动是两回事
│ │ │ │ │ ├── 目录.md # 搭建故事结构参考资料索引
│ │ │ │ │ ├── 短中长篇是三种体制——动笔前先选对尺子.md # 短中长篇是三种体制——动笔前先选对尺子
│ │ │ │ │ ├── 第一情节点（First-Plot-Point）必须在-14-位置.md # 第一情节点（First Plot Point）必须在 1/4 位置
│ │ │ │ │ ├── 第二段（25-50%）主角必须是漫游者（wanderer）.md # 第二段（25-50%）：主角必须是漫游者（wanderer）
│ │ │ │ │ ├── 结构诊断清单（可执行工作表）.md # 结构诊断清单（可执行工作表）
│ │ │ │ │ ├── 落笔写开头不等完美第一句，用首尾两句当路标.md # 落笔写开头：不等完美第一句，用首尾两句当路标
│ │ │ │ │ └── 触发事件与赌注加码把故事启动并不断升级.md # 触发事件与赌注加码：把故事启动并不断升级
│ │ │ │ └── 目录.md # 搭建故事结构 文件索引
│ │ │ ├── 搭建故事蓝图/
│ │ │ │ ├── SKILL.md # 搭建故事蓝图 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 搭建故事蓝图-覆盖对照表.md # 搭建故事蓝图 覆盖对照表
│ │ │ │ │ ├── 灵感写作实际是用草稿做规划.md # 灵感写作实际是用草稿做规划
│ │ │ │ │ ├── 目录.md # 搭建故事蓝图参考资料索引
│ │ │ │ │ ├── 短篇完整流程从一个想法到完稿的-6-阶段.md # 短篇完整流程：从一个想法到完稿的 6 阶段
│ │ │ │ │ ├── 节拍表用一行一条把故事全局摊开.md # 节拍表：用一行一条把故事全局摊开
│ │ │ │ │ └── 规划工作流台账.md # 规划工作流台账
│ │ │ │ └── 目录.md # 搭建故事蓝图 文件索引
│ │ │ ├── 目录.md # 方法技能索引
│ │ │ ├── 表达主题与立场/
│ │ │ │ ├── SKILL.md # 表达主题与立场 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 主题与立场检查清单.md # 主题与立场检查清单
│ │ │ │ │ ├── 主题只能演示，不能说出.md # 主题只能演示，不能说出
│ │ │ │ │ ├── 幽默作为结构沉重题材的第三条路.md # 幽默作为结构：沉重题材的第三条路
│ │ │ │ │ ├── 心慈手狠（Merciful-Heart,-Ruthless-Hand）爱你的角色，但不要放过他.md # 心慈手狠（Merciful Heart, Ruthless Hand）：爱你的角色，但不要放过他
│ │ │ │ │ ├── 目录.md # 表达主题与立场参考资料索引
│ │ │ │ │ ├── 莎士比亚化（Shakespeare-ization）把主题翻译成环境，让人物自己走.md # 莎士比亚化（Shakespeare-ization）：把主题翻译成环境，让人物自己走
│ │ │ │ │ ├── 表达主题与立场-覆盖对照表.md # 表达主题与立场 覆盖对照表
│ │ │ │ │ └── 边界、常见误区与易混方法.md # 边界、常见误区与易混方法
│ │ │ │ └── 目录.md # 表达主题与立场 文件索引
│ │ │ ├── 设计人物/
│ │ │ │ ├── SKILL.md # 设计人物 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 定形扁平人物与圆形人物.md # 定形：扁平人物与圆形人物
│ │ │ │ │ ├── 建角色台账.md # 建角色台账
│ │ │ │ │ ├── 建角色角色-7-大变量.md # 建角色：角色 7 大变量
│ │ │ │ │ ├── 打底原型工具箱——站在叙事原型上做反转.md # 打底：原型工具箱——站在叙事原型上做反转
│ │ │ │ │ ├── 目录.md # 设计人物参考资料索引
│ │ │ │ │ ├── 立体化角色-3-维度（表层内层深层）.md # 立体化：角色 3 维度（表层/内层/深层）
│ │ │ │ │ ├── 角色诊断流程（角色已成型）.md # 角色诊断流程（角色已成型）
│ │ │ │ │ ├── 设计人物-覆盖对照表.md # 设计人物 覆盖对照表
│ │ │ │ │ └── 驱动角色冲突来自内在恶魔.md # 驱动：角色冲突来自内在恶魔
│ │ │ │ └── 目录.md # 设计人物 文件索引
│ │ │ ├── 设计故事结尾/
│ │ │ │ ├── SKILL.md # 设计故事结尾 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── Rachmaninoff-警告手盖法找自然止点，砍掉拖尾.md # Rachmaninoff 警告：手盖法找自然止点，砍掉拖尾
│ │ │ │ │ ├── 先定终局，再写路径.md # 先定终局，再写路径
│ │ │ │ │ ├── 十种收尾策略与选择标准.md # 十种收尾策略与选择标准
│ │ │ │ │ ├── 执行链结尾是嵌套结构，不是单点（Chain-of-Execution）.md # 执行链：结尾是嵌套结构，不是单点（Chain of Execution）
│ │ │ │ │ ├── 收尾姿态二选一完成-vs-扩展（Completion-vs-Expansion）.md # 收尾姿态二选一：完成 vs 扩展（Completion vs Expansion）
│ │ │ │ │ ├── 目录.md # 设计故事结尾参考资料索引
│ │ │ │ │ ├── 设计故事结尾-覆盖对照表.md # 设计故事结尾 覆盖对照表
│ │ │ │ │ └── 边界、误区、盲点与激活场景.md # 边界、误区、盲点与激活场景
│ │ │ │ └── 目录.md # 设计故事结尾 文件索引
│ │ │ ├── 诊断作品问题/
│ │ │ │ ├── SKILL.md # 诊断作品问题 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 伪学者自检扫描表.md # 伪学者自检扫描表
│ │ │ │ │ ├── 作品诊断三步体检台账.md # 作品诊断三步体检台账
│ │ │ │ │ ├── 张力层透镜情节和人物谁赢——情节与人物的拉锯战.md # 张力层透镜：情节和人物谁赢——情节与人物的拉锯战
│ │ │ │ │ ├── 形式层透镜看画还是听乐——模式-vs-节奏.md # 形式层透镜：看画还是听乐——模式 vs 节奏
│ │ │ │ │ ├── 意义层透镜有时间，有没有价值——时间生活-vs-价值生活.md # 意义层透镜：有时间，有没有价值——时间生活 vs 价值生活
│ │ │ │ │ ├── 比较诊断抹掉标签再并置——圆桌论.md # 比较诊断：抹掉标签再并置——圆桌论
│ │ │ │ │ ├── 清理诊断结论伪学者自检.md # 清理诊断结论：伪学者自检
│ │ │ │ │ ├── 目录.md # 诊断作品问题参考资料索引
│ │ │ │ │ ├── 神异层透镜戏耍还是歌唱——幻想与预言孪生光柱.md # 神异层透镜：戏耍还是歌唱——幻想与预言孪生光柱
│ │ │ │ │ ├── 结构层透镜是故事还是情节——问后来呢还是问为什么.md # 结构层透镜：是故事还是情节——问"后来呢"还是问"为什么"
│ │ │ │ │ ├── 维度框架先把问题落进维度，再谈别的.md # 维度框架：先把问题落进维度，再谈别的
│ │ │ │ │ └── 诊断作品问题-覆盖对照表.md # 诊断作品问题 覆盖对照表
│ │ │ │ └── 目录.md # 诊断作品问题 文件索引
│ │ │ ├── 运用展示与留白/
│ │ │ │ ├── SKILL.md # 运用展示与留白 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 冰山写作法用一个动作扛多层信息.md # 冰山写作法：用一个动作扛多层信息
│ │ │ │ │ ├── 反逻辑与飞白用不写来写.md # 反逻辑与飞白：用不写来写
│ │ │ │ │ ├── 展示与留白检查清单.md # 展示与留白检查清单
│ │ │ │ │ ├── 把抽象标签换成具体场景展示而非告知.md # 把抽象标签换成具体场景：展示而非告知
│ │ │ │ │ ├── 极端情绪不写心理，写身体无心理描写法.md # 极端情绪不写心理，写身体：无心理描写法
│ │ │ │ │ ├── 目录.md # 运用展示与留白参考资料索引
│ │ │ │ │ ├── 给超现实的东西一个现实锚点想象-事实转化法.md # 给超现实的东西一个现实锚点：想象-事实转化法
│ │ │ │ │ ├── 视角人物的知识边界与信息差.md # 视角人物的知识边界与信息差
│ │ │ │ │ ├── 读者为什么读不懂知识诅咒的诊断与三破解.md # 读者为什么读不懂：知识诅咒的诊断与三破解
│ │ │ │ │ └── 运用展示与留白-覆盖对照表.md # 运用展示与留白 覆盖对照表
│ │ │ │ └── 目录.md # 运用展示与留白 文件索引
│ │ │ ├── 选择叙述视角/
│ │ │ │ ├── SKILL.md # 选择叙述视角 的适用范围、方法或业务命令
│ │ │ │ ├── references/
│ │ │ │ │ ├── 叙述与视角检查清单.md # 叙述与视角检查清单
│ │ │ │ │ ├── 外来者切入法用一个外来者揭开封闭系统.md # 外来者切入法：用一个外来者揭开封闭系统
│ │ │ │ │ ├── 怀疑主义叙述法看法会陈旧，事实不会.md # 怀疑主义叙述法：看法会陈旧，事实不会
│ │ │ │ │ ├── 混合叙事模式主线与折线的调度.md # 混合叙事模式：主线与折线的调度
│ │ │ │ │ ├── 目录.md # 选择叙述视角参考资料索引
│ │ │ │ │ ├── 确定性-不确定性张力构造法.md # 确定性-不确定性张力构造法
│ │ │ │ │ ├── 视角是摄像头谁在看，决定一切.md # 视角是摄像头：谁在看，决定一切
│ │ │ │ │ ├── 视角限制的落地五步执行.md # 视角限制的落地：五步执行
│ │ │ │ │ └── 选择叙述视角-覆盖对照表.md # 选择叙述视角 覆盖对照表
│ │ │ │ └── 目录.md # 选择叙述视角 文件索引
│ │ │ └── 铺设并回收伏笔/
│ │ │ ├── SKILL.md # 铺设并回收伏笔 的适用范围、方法或业务命令
│ │ │ ├── references/
│ │ │ │ ├── 伏笔与回收检查清单.md # 伏笔与回收检查清单
│ │ │ │ ├── 伏笔台账与兑现时间表模板.md # 伏笔台账与兑现时间表模板
│ │ │ │ ├── 埋设决策与伏笔台账显著元素就是借款.md # 埋设决策与伏笔台账：显著元素就是借款
│ │ │ │ ├── 目录.md # 铺设并回收伏笔参考资料索引
│ │ │ │ ├── 细节驱动高潮高潮从不动声色的细节里长出来.md # 细节驱动高潮：高潮从不动声色的细节里长出来
│ │ │ │ ├── 适用边界、常见误区与盲点.md # 适用边界、常见误区与盲点
│ │ │ │ ├── 铺垫术给读者的接受度修楼梯.md # 铺垫术：给读者的接受度修楼梯
│ │ │ │ └── 铺设并回收伏笔-覆盖对照表.md # 铺设并回收伏笔 覆盖对照表
│ │ │ └── 目录.md # 铺设并回收伏笔 文件索引
│ │ └── 目录.md # 由 Skill frontmatter 生成的技能发现入口
│ ├── 作者/
│ │ ├── 写作与修改.md # 写作与修改 的作者场景路由
│ │ ├── 定稿与连载.md # 定稿与连载 的作者场景路由
│ │ ├── 审阅与确认.md # 审阅与确认 的作者场景路由
│ │ ├── 指令.md # 指令 的作者场景路由
│ │ ├── 构思与规划.md # 构思与规划 的作者场景路由
│ │ ├── 目录.md # 作者场景索引
│ │ ├── 系统与任务.md # 系统与任务 的作者场景路由
│ │ ├── 结构与扩展.md # 结构与扩展 的作者场景路由
│ │ └── 资料与拆书.md # 资料与拆书 的作者场景路由
│ ├── 目录.md # 执行知识总索引
│ ├── 约束/
│ │ ├── 作者主权.md # 作者主权 的短规则与权威文档引用
│ │ ├── 凭据与外部调用.md # 凭据与外部调用 的短规则与权威文档引用
│ │ ├── 数据与读取范围.md # 数据与读取范围 的短规则与权威文档引用
│ │ └── 目录.md # 约束 索引
│ ├── 规范/
│ │ ├── 中文正文与界面.md # 中文正文与界面 的短规则与权威文档引用
│ │ ├── 命名.md # 命名 的短规则与权威文档引用
│ │ ├── 术语.md # 术语 的短规则与权威文档引用
│ │ └── 目录.md # 规范 索引
│ └── 角色/
│ ├── 写手.md # 写手 固定职责和输入约束
│ ├── 检测员.md # 检测员 固定职责和输入约束
│ ├── 目录.md # 角色索引
│ ├── 知识抽取员.md # 知识抽取员 固定职责和输入约束
│ ├── 规划员.md # 规划员 固定职责和输入约束
│ └── 评委.md # 评委 固定职责和输入约束
├── .agents.local/
│ ├── AGENTS.md # 个人约定
│ ├── skills/
│ │ └── my-skills # 个人 CLI 管理技能
│ ├── 便签.md # 个人环境说明及凭据位置
│ ├── 备份 # 本地备份产物
│ ├── 改造/
│ │ └── <批次ID> # 改造批次的工作树快照、数据差异、切换包与实际验证证据
│ ├── 环境/
│ │ ├── 凭据.env # 凭据值，默认不提交
│ │ └── 连接.toml # 受控本机配置
│ ├── 草稿/
│ │ ├── <作品ID>/
│ │ │ └── 作品探索.md # 私人探索稿
│ │ └── 旧稿留存/
│ │ ├── 初步设定候选-统合.md # 原工作稿保留副本，不作为代码清理对象
│ │ └── 深渊机神-前期设计.md # 原工作稿保留副本，不作为代码清理对象
│ ├── 迁移留存/
│ │ └── 原参考资料/
│ │ ├── README.md # 原参考资料与导入证据保留
│ │ └── 参考书/
│ │ └── 封神演义/
│ │ ├── 档案.md # 原参考资料与导入证据保留
│ │ ├── 第12回.txt # 原参考资料与导入证据保留
│ │ ├── 第13回.txt # 原参考资料与导入证据保留
│ │ └── 第14回.txt # 原参考资料与导入证据保留
│ └── 运行/
│ ├── 上传暂存 # 上传暂存
│ ├── 导出暂存 # 导出中间文件
│ ├── 日志 # 本地日志
│ └── 证据暂存 # 证据补交
├── .editorconfig # 编辑格式
├── .gitattributes # 文本换行与差异属性
├── .github/
│ └── workflows/
│ ├── 构建.yml # 资源、前后端打包与安装产物验证
│ └── 检查.yml # 静态、契约、隔离测试和索引检查
├── .gitignore # 私人数据、缓存及构建产物排除
├── .python-version # Python 运行版本
├── AGENTS.md # 项目入口与设计、规则、验证导航
├── CLAUDE.md # 兼容入口，只引用 AGENTS.md
├── Makefile # 安装、生成、检查、测试和构建入口
├── README.md # 安装、启动与日常使用入口
├── docs/
│ ├── 2026-07-14-参考书作品面数据入库方案.md # 参考书作品面数据入库方案
│ ├── 2026-07-16-升格卡改造设计.md # 升格卡改造设计（P0 补骨架记里程碑 · P1 串链语义判重）
│ ├── 2026-07-30-落库与看板设计.md # 落库与看板设计 v2（八张待落库表 + 只读看板）
│ ├── 2026-08-01-评测harness改造设计.md # 评测 harness 改造设计（概念层）
│ ├── 2026-08-19-craft-distillation-trace.md # craft 蒸馏操作留痕（2026-08-19）
│ ├── 2026-08-20-skill-质量审查与复利改造清单.md # Skill 质量审查与复利改造清单（2026-08-20）
│ ├── 2026-08-20-质量收敛环运行手册.md # 质量收敛环运行手册（实验性）
│ ├── 2026-08-30-提交前四维审查报告.md # 2026-08-30 提交前四维形而上审查报告
│ ├── 2026-09-01-创作链路合同校准提交前四维审查报告.md # 2026-09-01 创作链路合同校准提交前四维审查报告
│ ├── acceptance/
│ │ ├── 2026-08-23-§11可见性对照验收-书12基线走查记录.md # §11 可见性对照验收：书 12（深渊机神）基线走查
│ │ └── 2026-08-24-dsh-pi-browser-e2e.md # DSH / PI 浏览器创作闭环验收
│ ├── plans/
│ │ ├── 2026-08-23-目录分层改造.md # 目录分层改造 plan
│ │ ├── 2026-08-24-双底座适配接缝.md # 双底座适配接缝 plan
│ │ └── 2026-08-28-能力原型间收敛方案.md # 能力原型间收敛方案（意图 / 问题 / 解决方案）
│ ├── research/
│ │ └── 2026-08-24-dsh-local-runtime-baseline.md # DSH 本机运行基线
│ ├── 功能规格/
│ │ ├── 技能身份中文化与作者创作入口.md # 技能身份中文化与作者创作入口
│ │ ├── 目录.md # 现行文档导航与历史材料状态说明
│ │ └── 阶段0交互式作品探索.md # 阶段 0 交互式作品探索
│ ├── 实现回顾/
│ │ ├── 技能身份中文化迁移实现回顾.md # 技能身份中文化迁移实现回顾
│ │ └── 目录.md # 现行文档导航与历史材料状态说明
│ ├── 接口契约/
│ │ ├── 生成/
│ │ │ ├── openapi.generated.json # 从稳定业务外壳生成的 OpenAPI
│ │ │ ├── 任务.schema.json # 任务、事件及两种用途机器合同
│ │ │ ├── 元数据投影.schema.json # 动态字段定义和投影外壳合同
│ │ │ ├── 模型输出.schema.json # 角色输出外壳合同
│ │ │ ├── 正文.schema.json # 正文和选区机器合同
│ │ │ └── 目录.md # 构建生成合同索引
│ │ └── 目录.md # 机器契约产物索引
│ ├── 目录.md # 现行文档导航与历史材料状态说明
│ └── 系统架构/
│ ├── 新版设计/
│ │ ├── 业务需求/
│ │ │ ├── 目录.md # 文档与材料索引
│ │ │ └── 目标系统完整功能清单.md # 目标系统完整功能清单
│ │ ├── 决策/
│ │ │ ├── 0001-模块化单体.md # 0001-模块化单体
│ │ │ ├── 0002-统一持久化.md # 0002-统一持久化
│ │ │ ├── 0003-Skill与业务实现分离.md # 0003-Skill与业务实现分离
│ │ │ ├── 0004-保留元数据驱动的内容结构.md # 0004-保留元数据驱动的内容结构
│ │ │ ├── 0005-正文段落与版本合同.md # 0005-正文段落与版本合同
│ │ │ ├── 0006-持久化流程与受控槽位.md # 0006-持久化流程与受控槽位
│ │ │ ├── 0007-评测与生产用途隔离.md # 0007-评测与生产用途隔离
│ │ │ └── 目录.md # 文档与材料索引
│ │ ├── 功能覆盖矩阵.md # 功能覆盖矩阵
│ │ ├── 功能规格/
│ │ │ ├── P01-作品创建与连续写作.md # P01-作品创建与连续写作
│ │ │ ├── P02-选段修订与回退.md # P02-选段修订与回退
│ │ │ ├── P03-资料研究与方法复用.md # P03-资料研究与方法复用
│ │ │ ├── P04-声音诊断与受控修订.md # P04-声音诊断与受控修订
│ │ │ ├── P05-章后处理与事实复核.md # P05-章后处理与事实复核
│ │ │ ├── P06-经验验证与启用.md # P06-经验验证与启用
│ │ │ ├── P07-定稿交付与恢复.md # P07-定稿交付与恢复
│ │ │ ├── P08-元数据扩展与结构升级.md # P08-元数据扩展与结构升级
│ │ │ └── 目录.md # 文档与材料索引
│ │ ├── 工作台设计.md # 工作台设计
│ │ ├── 总体架构.md # 总体架构
│ │ ├── 技能承接表.md # 技能承接表
│ │ ├── 接口契约/
│ │ │ ├── 任务工具与事件.md # 任务工具与事件
│ │ │ ├── 元数据投影与版本.md # 元数据投影与版本
│ │ │ ├── 原文证据生命周期.md # 原文证据生命周期的目标合同或可读投影
│ │ │ ├── 命令与作者决策.md # 命令与作者决策
│ │ │ ├── 正文结构与中文选区.md # 正文结构与中文选区
│ │ │ └── 目录.md # 文档与材料索引
│ │ ├── 改造计划/
│ │ │ ├── P0-基线与合同.md # P0-基线与合同的实施顺序、范围或分配索引
│ │ │ ├── P1-安装与运行底座.md # P1-安装与运行底座的实施顺序、范围或分配索引
│ │ │ ├── P2-人工编辑与正式提交.md # P2-人工编辑与正式提交的实施顺序、范围或分配索引
│ │ │ ├── P3-通用创作主链.md # P3-通用创作主链的实施顺序、范围或分配索引
│ │ │ ├── P4-研究与知识资产.md # P4-研究与知识资产的实施顺序、范围或分配索引
│ │ │ ├── P5-质量修订与经验评测.md # P5-质量修订与经验评测的实施顺序、范围或分配索引
│ │ │ ├── P6-交付与全量恢复.md # P6-交付与全量恢复的实施顺序、范围或分配索引
│ │ │ ├── P7-切换与旧实现退出.md # P7-切换与旧实现退出的实施顺序、范围或分配索引
│ │ │ ├── 分配索引.md # 分配索引的实施顺序、范围或分配索引
│ │ │ ├── 切换与回退.md # 切换与回退的实施顺序、范围或分配索引
│ │ │ ├── 工作包清单.json # 工作包清单的实施顺序、范围或分配索引
│ │ │ ├── 总计划.md # 总计划的实施顺序、范围或分配索引
│ │ │ ├── 执行与验收.md # 执行与验收的实施顺序、范围或分配索引
│ │ │ └── 目录.md # 目录的实施顺序、范围或分配索引
│ │ ├── 数据模型/
│ │ │ ├── 元数据与结构演进.md # 元数据与结构演进
│ │ │ ├── 内置类型承接表.md # 内置类型承接表
│ │ │ ├── 存储与对象关系.md # 存储与对象关系
│ │ │ ├── 旧知识记录分流.md # 旧知识记录分流的目标合同或可读投影
│ │ │ ├── 状态与来源有效性.md # 状态与来源有效性
│ │ │ └── 目录.md # 文档与材料索引
│ │ ├── 文件设计/
│ │ │ ├── 前端-功能工作台.md # 前端-功能工作台的逐文件职责、边界、意图和目标
│ │ │ ├── 前端-应用与通用界面.md # 前端-应用与通用界面的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B01-作品规划.md # 后端-B01-作品规划的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B02-故事世界.md # 后端-B02-故事世界的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B03-资料研究.md # 后端-B03-资料研究的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B04-知识方法.md # 后端-B04-知识方法的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B05-正文写作.md # 后端-B05-正文写作的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B06-审校修订.md # 后端-B06-审校修订的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B07-作者经验.md # 后端-B07-作者经验的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B08-交付连载.md # 后端-B08-交付连载的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B09-上下文.md # 后端-B09-上下文的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-B10-效果评测.md # 后端-B10-效果评测的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-S01-正式变更.md # 后端-S01-正式变更的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-S02-任务运行.md # 后端-S02-任务运行的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-S04-元数据.md # 后端-S04-元数据的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-发布资源.md # 后端-发布资源的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-基础设施.md # 后端-基础设施的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-流程编排.md # 后端-流程编排的逐文件职责、边界、意图和目标
│ │ │ ├── 后端-装配与接入.md # 后端-装配与接入的逐文件职责、边界、意图和目标
│ │ │ ├── 工程配置与部署.md # 工程配置与部署的逐文件职责、边界、意图和目标
│ │ │ ├── 执行知识-操作技能.md # 执行知识-操作技能的逐文件职责、边界、意图和目标
│ │ │ ├── 执行知识-方法技能.md # 执行知识-方法技能的逐文件职责、边界、意图和目标
│ │ │ ├── 执行知识-角色规则与作者入口.md # 执行知识-角色规则与作者入口的逐文件职责、边界、意图和目标
│ │ │ ├── 数据库与迁移.md # 数据库与迁移的逐文件职责、边界、意图和目标
│ │ │ ├── 文档与研究证据.md # 文档与研究证据的逐文件职责、边界、意图和目标
│ │ │ ├── 测试与夹具.md # 测试与夹具的逐文件职责、边界、意图和目标
│ │ │ ├── 目录.md # 逐文件合同导航
│ │ │ └── 私人资料.md # 私人资料的逐文件职责、边界、意图和目标
│ │ ├── 旧文件处置/
│ │ │ ├── 保留历史与溯源.md # 保留历史与溯源的具体文件、替代位置、保留内容与退出条件
│ │ │ ├── 原位重写.md # 原位重写的具体文件、替代位置、保留内容与退出条件
│ │ │ ├── 实现替换与合并.md # 实现替换与合并的具体文件、替代位置、保留内容与退出条件
│ │ │ ├── 已删除状态保留.md # 已删除状态保留的具体文件、替代位置、保留内容与退出条件
│ │ │ ├── 测试来源索引.md # 逐用例重写的旧测试来源索引
│ │ │ ├── 目录.md # 按处置类别定位旧文件
│ │ │ ├── 资料先保全再迁位.md # 资料先保全再迁位的具体文件、替代位置、保留内容与退出条件
│ │ │ ├── 资源与定义迁移.md # 资源与定义迁移的具体文件、替代位置、保留内容与退出条件
│ │ │ └── 退役旧实验实现.md # 退役旧实验实现的具体文件、替代位置、保留内容与退出条件
│ │ ├── 模块设计/
│ │ │ ├── B01-作品规划.md # B01-作品规划
│ │ │ ├── B02-故事世界.md # B02-故事世界
│ │ │ ├── B03-资料研究.md # B03-资料研究
│ │ │ ├── B04-知识方法.md # B04-知识方法
│ │ │ ├── B05-正文写作.md # B05-正文写作
│ │ │ ├── B06-审校修订.md # B06-审校修订
│ │ │ ├── B07-作者经验.md # B07-作者经验
│ │ │ ├── B08-交付连载.md # B08-交付连载
│ │ │ ├── B09-上下文.md # B09-上下文
│ │ │ ├── B10-效果评测.md # B10-效果评测
│ │ │ ├── S01-正式变更.md # S01-正式变更
│ │ │ ├── S02-任务运行.md # S02-任务运行
│ │ │ ├── S03-工作台与系统管理.md # S03-工作台与系统管理
│ │ │ ├── S04-元数据.md # S04-元数据
│ │ │ └── 目录.md # 文档与材料索引
│ │ ├── 现有文件处置.md # 旧文件树、处置类别、具体替代与退出条件
│ │ ├── 现有文件处置清单.json # 当前旧文件逐项处置、源哈希与验收目标
│ │ ├── 目录.md # 文档与材料索引
│ │ ├── 目标文件清单.json # 目标路径与职责的设计清单
│ │ ├── 研究依据/
│ │ │ ├── 主体与StoryForge评估汇总.md # 研究依据或历史证据
│ │ │ ├── 主体重写依据.md # 研究依据或历史证据
│ │ │ ├── 历史方案/
│ │ │ │ ├── StoryForge主体改造.md # 研究依据或历史证据
│ │ │ │ ├── 保留原主体接工作台.md # 研究依据或历史证据
│ │ │ │ └── 目录.md # 文档与材料索引
│ │ │ ├── 原结构快照/
│ │ │ │ ├── chapter.yaml # 研究依据或历史证据
│ │ │ │ ├── character.yaml # 研究依据或历史证据
│ │ │ │ ├── character_relation.yaml # 研究依据或历史证据
│ │ │ │ ├── combat.yaml # 研究依据或历史证据
│ │ │ │ ├── craft.yaml # 研究依据或历史证据
│ │ │ │ ├── emotion.yaml # 研究依据或历史证据
│ │ │ │ ├── event.yaml # 研究依据或历史证据
│ │ │ │ ├── faction.yaml # 研究依据或历史证据
│ │ │ │ ├── fine_outline.yaml # 研究依据或历史证据
│ │ │ │ ├── generation_context.yaml # 研究依据或历史证据
│ │ │ │ ├── item.yaml # 研究依据或历史证据
│ │ │ │ ├── location.yaml # 研究依据或历史证据
│ │ │ │ ├── narrative_state.yaml # 研究依据或历史证据
│ │ │ │ ├── novel_work.yaml # 研究依据或历史证据
│ │ │ │ ├── outline.yaml # 研究依据或历史证据
│ │ │ │ ├── pacing.yaml # 研究依据或历史证据
│ │ │ │ ├── power_system.yaml # 研究依据或历史证据
│ │ │ │ ├── reference_work.yaml # 研究依据或历史证据
│ │ │ │ ├── scene.yaml # 研究依据或历史证据
│ │ │ │ ├── scene_pattern.yaml # 研究依据或历史证据
│ │ │ │ ├── style.yaml # 研究依据或历史证据
│ │ │ │ ├── trope.yaml # 研究依据或历史证据
│ │ │ │ ├── work_core.yaml # 研究依据或历史证据
│ │ │ │ ├── world.yaml # 研究依据或历史证据
│ │ │ │ ├── 原README.md # 研究依据或历史证据
│ │ │ │ └── 目录.md # 文档与材料索引
│ │ │ ├── 去味与评测代码借鉴.md # 研究依据或历史证据
│ │ │ ├── 小说系统代码借鉴.md # 研究依据或历史证据
│ │ │ ├── 材料承接说明.md # 研究依据或历史证据
│ │ │ ├── 材料清单.json # 研究依据或历史证据
│ │ │ ├── 目录.md # 文档与材料索引
│ │ │ └── 选型比较/
│ │ │ ├── StoryForge核对测试.json # 研究依据或历史证据
│ │ │ ├── StoryForge资料与检索.md # 研究依据或历史证据
│ │ │ ├── character-arc-staging-test.log # 研究依据或历史证据
│ │ │ ├── neuro-harness-approval-test.log # 研究依据或历史证据
│ │ │ ├── 仓库快照与许可证入口.json # 研究依据或历史证据
│ │ │ ├── 分析-广度与完成度.json # 研究依据或历史证据
│ │ │ ├── 功能广度与完成度.md # 研究依据或历史证据
│ │ │ ├── 历史验证记录.md # 研究依据或历史证据
│ │ │ ├── 双轴综合结论.md # 研究依据或历史证据
│ │ │ ├── 比较约束.md # 研究依据或历史证据
│ │ │ ├── 版本与许可证复核.md # 研究依据或历史证据
│ │ │ ├── 理念接近前三.md # 研究依据或历史证据
│ │ │ ├── 界面图册.html # 研究依据或历史证据
│ │ │ ├── 界面截图/
│ │ │ │ ├── ai-novel-disassembly.png # 研究依据或历史证据
│ │ │ │ ├── ai-novel-planning.png # 研究依据或历史证据
│ │ │ │ ├── ai-novel-writing.png # 研究依据或历史证据
│ │ │ │ ├── character-arc-disassembly.png # 研究依据或历史证据
│ │ │ │ ├── character-arc-outline.png # 研究依据或历史证据
│ │ │ │ ├── character-arc-writing.png # 研究依据或历史证据
│ │ │ │ ├── inkos-studio.png # 研究依据或历史证据
│ │ │ │ ├── oh-story-desk.png # 研究依据或历史证据
│ │ │ │ ├── storyforge-live-inspiration.png # 研究依据或历史证据
│ │ │ │ ├── storyforge-live-library.png # 研究依据或历史证据
│ │ │ │ ├── storyforge-live-writing-ai.png # 研究依据或历史证据
│ │ │ │ ├── storyforge-writing.png # 研究依据或历史证据
│ │ │ │ ├── 来源.json # 研究依据或历史证据
│ │ │ │ └── 目录.md # 文档与材料索引
│ │ │ └── 目录.md # 文档与材料索引
│ │ ├── 编排与能力资源.md # 编排与能力资源
│ │ ├── 调用链路/
│ │ │ ├── 关键旅程.md # 关键旅程
│ │ │ └── 目录.md # 文档与材料索引
│ │ ├── 迁移与验收.md # 迁移与验收
│ │ ├── 阅读指南.md # 阅读指南
│ │ ├── 项目目录与文件职责.md # 项目目录与文件职责
│ │ ├── 领域模型/
│ │ │ ├── 术语表.md # 术语表
│ │ │ └── 目录.md # 文档与材料索引
│ │ └── 验证设计/
│ │ ├── 创作与正式变更用例.md # 创作与正式变更用例的目标合同或可读投影
│ │ ├── 审校与评测用例.md # 审校与评测用例的目标合同或可读投影
│ │ ├── 工作台与工程用例.md # 工作台与工程用例的目标合同或可读投影
│ │ ├── 测试用例清单.json # 测试用例清单的目标合同或可读投影
│ │ ├── 测试用例重写.md # 测试用例重写的目标合同或可读投影
│ │ ├── 目录.md # 目录的目标合同或可读投影
│ │ ├── 诊断行为场景.md # 诊断行为场景的目标合同或可读投影
│ │ ├── 诊断行为场景清单.json # 诊断行为场景清单的目标合同或可读投影
│ │ ├── 资料与结构用例.md # 资料与结构用例的目标合同或可读投影
│ │ └── 运行与原文保护用例.md # 运行与原文保护用例的目标合同或可读投影
│ └── 目录.md # 文档与材料索引
├── muse/
│ └── lifecycle/
│ └── quality/
│ └── humanization/
│ └── research/
│ ├── 20-project-humanization-rule-catalog.zh-CN.md # 20 个开源项目人感规则目录（中文轻量去重版）
│ └── 20-project-skill-coverage.yaml # 原人感研究覆盖依据
├── pyproject.toml # 应用包、命令、依赖与检查配置
├── src/
│ └── muse/
│ ├── __init__.py # 应用包身份
│ ├── __main__.py # Python 命令入口
│ ├── 上下文/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 任务范围.py # 作品、用途、时点和来源权限
│ │ ├── 依赖校验.py # 授权、撤回、结构与数据版本变化
│ │ ├── 冻结快照.py # 来源、结构、投影和消费片段
│ │ ├── 存储.py # 上下文所属记录的 SQL 与版本读写
│ │ ├── 探索回放.py # 按同一范围重放工具读取
│ │ ├── 接口.py # 上下文公开用例和可导入合同
│ │ ├── 材料装配.py # 必读、预算、取舍及字段投影
│ │ ├── 来源读取.py # 按业务公开接口读取固定来源
│ │ ├── 模型.py # 上下文稳定对象、外壳及内部状态
│ │ ├── 混合检索.py # 专名精确、关键词与向量合并
│ │ └── 索引维护.py # 切块、嵌入、重建与陈旧拒绝
│ ├── 交付连载/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 交付材料.py # 书名、简介、梗概和人物表
│ │ ├── 全书整理.py # 全书回看和跨章修订任务
│ │ ├── 发布登记.py # 真实发布版本及修订影响
│ │ ├── 存储.py # 交付连载所属记录的 SQL 与版本读写
│ │ ├── 定稿版本.py # 冻结章节与交付材料清单
│ │ ├── 导出格式/
│ │ │ ├── EPUB.py # EPUB 目录、内容与打包
│ │ │ ├── Markdown.py # Markdown 正文导出
│ │ │ ├── Word.py # DOCX 结构与排版导出
│ │ │ ├── __init__.py # Python 包身份
│ │ │ └── 纯文本.py # TXT 正文导出
│ │ ├── 接口.py # 交付连载公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ ├── 全书审阅.md # 跨章审阅任务模板
│ │ │ └── 整理交付材料.md # 固定正文版本的材料生成
│ │ ├── 文字校对.py # 专名、称谓、标点、格式与例外
│ │ ├── 文稿导出.py # 导出任务、目录及完整性核对
│ │ ├── 模型.py # 交付连载稳定对象、外壳及内部状态
│ │ ├── 读者反馈.py # 归集、辨析与调整任务
│ │ └── 连载计划.py # 存稿、时间和章节依赖
│ ├── 任务运行/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 事件记录.py # 有序事件持久化与订阅依据
│ │ ├── 任务领取.py # 领取、租约、心跳和尝试身份
│ │ ├── 作用域互斥.py # 对同来源抽取等需要排他的任务范围登记互斥与持有者
│ │ ├── 原文生命周期.py # 原文授权、24 小时临时租约、归档和恢复状态机
│ │ ├── 存储.py # 任务运行所属记录的 SQL 与版本读写
│ │ ├── 工具调用.py # 工具允许集、参数和读取回执
│ │ ├── 恢复控制.py # 暂停、取消、重试和未知结果
│ │ ├── 执行合同.py # 宿主请求、标准事件及完成结果
│ │ ├── 接口.py # 任务运行公开用例和可导入合同
│ │ ├── 模型.py # 任务运行稳定对象、外壳及内部状态
│ │ ├── 模型调用.py # 统一调用、明确终态及结构校验
│ │ ├── 步骤执行.py # 已登记步骤及检查点写入
│ │ ├── 角色会话.py # 固定角色对话、派生回合与只读工具证据
│ │ ├── 角色策略.py # 角色能力、工具范围和版本冻结
│ │ ├── 运行证据.py # 输入输出、脱敏、暂存补交和关联
│ │ ├── 配置版本.py # 运行配置验证、启用及固定副本
│ │ └── 预算管理.py # 额度窗口、预留、结算及未知用量
│ ├── 作品规划/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 作品档案.py # 作品、系列、定位、目标与计划
│ │ ├── 分层规划.py # 全书、卷、章、场景和节奏安排
│ │ ├── 存储.py # 作品规划所属记录的 SQL 与版本读写
│ │ ├── 探索交接.py # 最终格式检查与正式规划候选
│ │ ├── 探索草稿.py # 受控私人稿件身份、原子保存和内容哈希
│ │ ├── 接口.py # 作品规划公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ ├── 生成作品规划.md # 书级规划任务模板
│ │ │ └── 细化章节计划.md # 章级细纲任务模板
│ │ ├── 模型.py # 作品规划稳定对象、外壳及内部状态
│ │ ├── 目录调整.py # 稳定章节身份、重排、节点视图与影响
│ │ ├── 规划版本.py # 规划候选、确认、分支及合并
│ │ ├── 近期细化.py # 近期章节计划与可写条件
│ │ └── 进度查询.py # 正文、任务和决策的真实进度查询
│ ├── 作者经验/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 作者偏好.py # 捕获、确认、范围、冲突和撤回
│ │ ├── 反馈对.py # 原稿、改稿、作者原话及决策
│ │ ├── 启用回执.py # 目标模块启停请求、批准及回执
│ │ ├── 存储.py # 作者经验所属记录的 SQL 与版本读写
│ │ ├── 接口.py # 作者经验公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ └── 整理偏好与改进建议.md # 保留原话及区分推断的提案模板
│ │ ├── 改进提案.py # 具体目标变更、版本及内容哈希
│ │ ├── 模型.py # 作者经验稳定对象、外壳及内部状态
│ │ ├── 观察记录.py # 运行观察、重复问题及背景
│ │ ├── 长期观察.py # 人审时间、返工、误杀与退化
│ │ └── 验证申请.py # 实验请求与逐例结果关联
│ ├── 元数据/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 内置导入.py # 内置种子幂等登记，保护已存在绑定和扩展
│ │ ├── 内置结构/
│ │ │ ├── chapter.yaml # chapter 内置结构种子与用途声明
│ │ │ ├── character.yaml # character 内置结构种子与用途声明
│ │ │ ├── character_relation.yaml # character_relation 内置结构种子与用途声明
│ │ │ ├── combat.yaml # combat 内置结构种子与用途声明
│ │ │ ├── craft.yaml # craft 内置结构种子与用途声明
│ │ │ ├── emotion.yaml # emotion 内置结构种子与用途声明
│ │ │ ├── event.yaml # event 内置结构种子与用途声明
│ │ │ ├── faction.yaml # faction 内置结构种子与用途声明
│ │ │ ├── fine_outline.yaml # fine_outline 内置结构种子与用途声明
│ │ │ ├── generation_context.yaml # generation_context 内置结构种子与用途声明
│ │ │ ├── item.yaml # item 内置结构种子与用途声明
│ │ │ ├── location.yaml # location 内置结构种子与用途声明
│ │ │ ├── narrative_state.yaml # narrative_state 内置结构种子与用途声明
│ │ │ ├── novel_work.yaml # novel_work 内置结构种子与用途声明
│ │ │ ├── outline.yaml # outline 内置结构种子与用途声明
│ │ │ ├── pacing.yaml # pacing 内置结构种子与用途声明
│ │ │ ├── power_system.yaml # power_system 内置结构种子与用途声明
│ │ │ ├── reference_work.yaml # reference_work 内置结构种子与用途声明
│ │ │ ├── scene.yaml # scene 内置结构种子与用途声明
│ │ │ ├── scene_pattern.yaml # scene_pattern 内置结构种子与用途声明
│ │ │ ├── style.yaml # style 内置结构种子与用途声明
│ │ │ ├── trope.yaml # trope 内置结构种子与用途声明
│ │ │ ├── work_core.yaml # work_core 内置结构种子与用途声明
│ │ │ ├── world.yaml # world 内置结构种子与用途声明
│ │ │ └── 公共字段.yaml # 共享内容属性及受保护骨架的元描述
│ │ ├── 变更影响.py # 兼容分类、受影响实例及升级要求
│ │ ├── 字段投影.py # 展示、编辑、检索、导出和 AI 用途
│ │ ├── 字段校验.py # 类型、必填、枚举、嵌套和引用结构
│ │ ├── 存储.py # 元数据所属记录的 SQL 与版本读写
│ │ ├── 扩展合成.py # 基础结构和只增不改的作品扩展
│ │ ├── 接口.py # 元数据公开用例和可导入合同
│ │ ├── 模型.py # 元数据稳定对象、外壳及内部状态
│ │ ├── 类型登记.py # 类型、粒度、业务归属和生命周期族
│ │ └── 结构版本.py # 不可变结构发布、启用及固定读取
│ ├── 共享/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 时间.py # 时钟和期限类型
│ │ ├── 标识.py # 少量稳定身份与不可变引用
│ │ ├── 版本.py # revision、内容哈希与版本引用
│ │ ├── 调用身份.py # 作者、任务、用途和授权上下文
│ │ └── 错误.py # 共用错误结构
│ ├── 启动.py # 选择并注入数据库、宿主、模块和流程实现
│ ├── 基础设施/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 凭据读取.py # 读取受控凭据引用
│ │ ├── 受控文件.py # 草稿、暂存、原子写入与路径约束
│ │ ├── 可观测性.py # 日志、关联身份、指标和脱敏
│ │ ├── 备份恢复.py # PG 和草稿备份、隔离恢复及核对
│ │ ├── 宿主/
│ │ │ ├── Pi.py # Pi 适配
│ │ │ ├── Pi事件归一.py # 将 Pi 事件转为标准调用、工具、用量和错误，不裁决业务成功
│ │ │ ├── Pi工具桥.ts # 将宿主工具调用转给已安装只读工具入口，绑定任务身份
│ │ │ ├── __init__.py # Python 包身份
│ │ │ └── 直接调用.py # 无工具直接调用适配
│ │ ├── 数据库/
│ │ │ ├── __init__.py # Python 包身份
│ │ │ ├── 事务.py # 事务上下文、提交和回滚
│ │ │ ├── 用途隔离.py # 生产、评测、维护权限隔离
│ │ │ ├── 迁移.py # 顺序、校验和与迁移锁
│ │ │ └── 连接.py # 连接池和生命周期
│ │ ├── 数据归档.py # 完整数据、关系及内容哈希
│ │ ├── 文件保留.py # 暂存和产物保留与清理
│ │ ├── 检索/
│ │ │ ├── __init__.py # Python 包身份
│ │ │ ├── 关键词.py # 中文关键词及全文检索实现
│ │ │ └── 向量.py # pgvector 查询实现
│ │ ├── 模型/
│ │ │ ├── ChatCompletions.py # 协议事件和明确终态
│ │ │ ├── HTTP传输.py # 连接、超时、取消和读取
│ │ │ ├── Messages.py # 协议事件和明确终态
│ │ │ ├── Responses.py # 协议事件和明确终态
│ │ │ ├── __init__.py # Python 包身份
│ │ │ └── 嵌入.py # 批次、用量和嵌入模型身份
│ │ └── 资料来源/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 榜单读取.py # 已登记榜单来源获取和解析
│ │ └── 网页读取.py # 地址、抓取时间、状态和原文
│ ├── 审校修订/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 保真校验.py # 数字、引文、情态、事实和保护区
│ │ ├── 内置规则/
│ │ │ ├── 密度/
│ │ │ │ ├── d001.yaml # 规则 d001 的发布输入、范围与原证据
│ │ │ │ ├── d002.yaml # 规则 d002 的发布输入、范围与原证据
│ │ │ │ ├── d003.yaml # 规则 d003 的发布输入、范围与原证据
│ │ │ │ ├── d004.yaml # 规则 d004 的发布输入、范围与原证据
│ │ │ │ ├── d005.yaml # 规则 d005 的发布输入、范围与原证据
│ │ │ │ └── d006.yaml # 规则 d006 的发布输入、范围与原证据
│ │ │ ├── 机械/
│ │ │ │ ├── m001.yaml # 规则 m001 的发布输入、范围与原证据
│ │ │ │ ├── m002.yaml # 规则 m002 的发布输入、范围与原证据
│ │ │ │ ├── m003.yaml # 规则 m003 的发布输入、范围与原证据
│ │ │ │ └── m004.yaml # 规则 m004 的发布输入、范围与原证据
│ │ │ ├── 结构/
│ │ │ │ ├── s001.yaml # 规则 s001 的发布输入、范围与原证据
│ │ │ │ ├── s002.yaml # 规则 s002 的发布输入、范围与原证据
│ │ │ │ ├── s003.yaml # 规则 s003 的发布输入、范围与原证据
│ │ │ │ ├── s004.yaml # 规则 s004 的发布输入、范围与原证据
│ │ │ │ ├── s005.yaml # 规则 s005 的发布输入、范围与原证据
│ │ │ │ ├── s006.yaml # 规则 s006 的发布输入、范围与原证据
│ │ │ │ └── s007.yaml # 规则 s007 的发布输入、范围与原证据
│ │ │ ├── 词汇/
│ │ │ │ ├── l001.yaml # 规则 l001 的发布输入、范围与原证据
│ │ │ │ ├── l002.yaml # 规则 l002 的发布输入、范围与原证据
│ │ │ │ ├── l003.yaml # 规则 l003 的发布输入、范围与原证据
│ │ │ │ ├── l004.yaml # 规则 l004 的发布输入、范围与原证据
│ │ │ │ ├── l005.yaml # 规则 l005 的发布输入、范围与原证据
│ │ │ │ └── l006.yaml # 规则 l006 的发布输入、范围与原证据
│ │ │ └── 语义/
│ │ │ ├── sem001.yaml # 规则 sem001 的发布输入、范围与原证据
│ │ │ ├── sem002.yaml # 规则 sem002 的发布输入、范围与原证据
│ │ │ └── sem003.yaml # 规则 sem003 的发布输入、范围与原证据
│ │ ├── 创作质量.py # 人物、冲突、节奏、情绪和场景功能
│ │ ├── 受控修订.py # 诊断对应、授权范围及最小修改
│ │ ├── 基础检查.py # 空内容、截断、结构和输出有效性
│ │ ├── 声音基线.py # 样张、保护项及声音版本
│ │ ├── 存储.py # 审校修订所属记录的 SQL 与版本读写
│ │ ├── 审校报告.py # 问题单、覆盖、版本与处置
│ │ ├── 接口.py # 审校修订公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ ├── 创作质量审阅.md # 多维质量审阅
│ │ │ ├── 提取作品声音.md # 从认可样张建立声音候选
│ │ │ ├── 生成最小修订.md # 最小修改候选模板
│ │ │ ├── 诊断机器味.md # 结合语境诊断模板
│ │ │ └── 连续性审阅.md # 带证据的一致性审阅
│ │ ├── 机器味规则.py # 规则候选、适用范围和版本启停
│ │ ├── 机器味诊断.py # 定位并区分修、留、问
│ │ ├── 案例回流.py # 误杀、有效修改、拒绝与事故
│ │ ├── 模型.py # 审校修订稳定对象、外壳及内部状态
│ │ ├── 返修策略.py # 轮数、停止、原文胜出和回退选择
│ │ └── 连续性审校.py # 事实、视角、因果和引文证据
│ ├── 接入/
│ │ ├── __init__.py # Python 包身份
│ │ ├── cli/
│ │ │ ├── __init__.py # Python 包身份
│ │ │ ├── 任务命令.py # 查看、取消、暂停和恢复
│ │ │ ├── 作品命令.py # 作品和规划动作
│ │ │ ├── 入口.py # 命令登记与统一结果输出
│ │ │ ├── 创作命令.py # 写作与修订动作
│ │ │ ├── 审阅命令.py # 按目标类型执行作者决定
│ │ │ ├── 研究命令.py # 资料、拆书与方法动作
│ │ │ ├── 管理命令.py # 配置、归档、备份和恢复
│ │ │ ├── 结构命令.py # 结构版本、作品扩展和兼容检查
│ │ │ └── 评测命令.py # 隔离实验入口
│ │ ├── http/
│ │ │ ├── __init__.py # Python 包身份
│ │ │ ├── 事件订阅.py # 从持久化事件游标订阅和续接
│ │ │ ├── 作者会话.py # 单作者身份与写入请求来源
│ │ │ ├── 依赖.py # 注入作者身份、任务用途和业务接口
│ │ │ ├── 健康检查.py # 进程与依赖就绪状态
│ │ │ ├── 应用.py # HTTP 应用及生命周期
│ │ │ ├── 路由/
│ │ │ │ ├── __init__.py # Python 包身份
│ │ │ │ ├── 上下文.py # 上下文的类型化查询与动作
│ │ │ │ ├── 交付连载.py # 交付连载的类型化查询与动作
│ │ │ │ ├── 任务运行.py # 任务运行的类型化查询与动作
│ │ │ │ ├── 作品规划.py # 作品规划的类型化查询与动作
│ │ │ │ ├── 作者审阅.py # 作者审阅的类型化查询与动作
│ │ │ │ ├── 作者经验.py # 作者经验的类型化查询与动作
│ │ │ │ ├── 元数据.py # 元数据的类型化查询与动作
│ │ │ │ ├── 创作生成.py # 通用生成的类型化发起与审校报告查询
│ │ │ │ ├── 审校修订.py # 审校修订的类型化查询与动作
│ │ │ │ ├── 故事世界.py # 故事世界的类型化查询与动作
│ │ │ │ ├── 效果评测.py # 效果评测的类型化查询与动作
│ │ │ │ ├── 正文写作.py # 正文写作的类型化查询与动作
│ │ │ │ ├── 知识方法.py # 知识方法的类型化查询与动作
│ │ │ │ ├── 系统管理.py # 系统管理的类型化查询与动作
│ │ │ │ └── 资料研究.py # 资料研究的类型化查询与动作
│ │ │ ├── 错误响应.py # 错误码、中文说明、冲突与可重试性
│ │ │ └── 静态资源.py # 发布工作台与静态资源
│ │ ├── 主会话.py # 中文意图和已授权作者动作接入，关联对话及任务
│ │ ├── 创作操作.py # 人工创作具名请求外壳及作者身份构造
│ │ ├── 只读工具.py # 模型可见工具和任务范围绑定
│ │ ├── 执行器.py # 后台进程入口、用途装配和优雅停机
│ │ └── 结构操作.py # 结构候选、发布与兼容检查的跨接入类型合同
│ ├── 故事世界/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 世界设定.py # 地点、物品、组织、规则及代价
│ │ ├── 事实提案.py # 抽取增量、真实引用校验及确认参与者
│ │ ├── 人物关系.py # 人物、关系、弧线、视角与说话特征
│ │ ├── 存储.py # 故事世界所属记录的 SQL 与版本读写
│ │ ├── 接口.py # 故事世界公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ └── 抽取章节事实.md # 按有效结构抽取事实提案
│ │ ├── 时点查询.py # 叙事时点、读者和角色知情范围
│ │ ├── 来源有效性.py # 当前证据有效性与复核需求
│ │ ├── 模型.py # 故事世界稳定对象、外壳及内部状态
│ │ ├── 设定修订.py # 动态实例保存、版本与影响
│ │ └── 连续性.py # 事件、动态状态、因果、伏笔与承诺
│ ├── 效果评测/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 启用判据.py # 核对实际启用的是已测版本
│ │ ├── 存储.py # 效果评测所属记录的 SQL 与版本读写
│ │ ├── 实验条件.py # 冻结目标版本、模型、输入和预算
│ │ ├── 成对比较.py # 原文、候选、平局与分歧
│ │ ├── 指标汇总.py # 逐例结果、缺失项、覆盖及成本
│ │ ├── 接口.py # 效果评测公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ └── 独立评审.md # 固定条件的独立评审模板
│ │ ├── 数据集.py # 来源、样本、分割及保留集
│ │ ├── 模型.py # 效果评测稳定对象、外壳及内部状态
│ │ ├── 盲评.py # 匿名样本、评委身份及答案隔离
│ │ ├── 行为场景.py # 行为场景结构、输入版本、实际观察与裁决
│ │ └── 逐例执行.py # 逐例尝试和完整证据
│ ├── 正式变更/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 作者审阅.py # 审阅版本、差异哈希及批准范围
│ │ ├── 依赖锁.py # 来源、结构及当前有效指针的稳定锁序
│ │ ├── 修改影响.py # 变更影响与复核任务登记
│ │ ├── 存储.py # 正式变更所属记录的 SQL 与版本读写
│ │ ├── 幂等命令.py # 同请求回执重放、异请求拒绝
│ │ ├── 接口.py # 正式变更公开用例和可导入合同
│ │ ├── 提交事务.py # 原子执行具名类型化参与者
│ │ ├── 模型.py # 正式变更稳定对象、外壳及内部状态
│ │ ├── 版本检查.py # 目标、候选和被审版本
│ │ └── 状态迁移.py # 共用候选状态与合法迁移
│ ├── 正文写作/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 人工保存.py # 人工编辑、版本、历史和修改影响
│ │ ├── 候选版本.py # 候选保存、编辑、部分采纳和重检
│ │ ├── 写作任务.py # 不同粒度和修改目的的任务合同
│ │ ├── 存储.py # 正文写作所属记录的 SQL 与版本读写
│ │ ├── 接口.py # 正文写作公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ ├── 修改选段.md # 按授权范围修改模板
│ │ │ └── 生成正文.md # 无工具写作模板
│ │ ├── 模型.py # 正文写作稳定对象、外壳及内部状态
│ │ ├── 正式提交.py # 正文类型化确认与已批准关联变更
│ │ ├── 正文格式.py # 稳定段落、受限结构、可见文本与哈希
│ │ ├── 版本分支.py # 分支、快照、差异、合并及回退
│ │ └── 选段编辑.py # 字符位置、保护区及确定性修改应用
│ ├── 知识方法/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 存储.py # 知识方法所属记录的 SQL 与版本读写
│ │ ├── 接口.py # 知识方法公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ └── 提炼写作方法.md # 跨作品方法候选模板
│ │ ├── 方法卡.py # 六类范式、条件、去重与冲突
│ │ ├── 方法版本.py # 确认、修订、启用、停用和撤回
│ │ ├── 方法绑定.py # 作品与规划固定方法版本
│ │ ├── 模型.py # 知识方法稳定对象、外壳及内部状态
│ │ ├── 消费记录.py # 实际上下文使用与结果关联
│ │ └── 证据反例.py # 来源、样例、例外及反例
│ ├── 编排/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 作品准备.py # 探索交接、规划、设定及方法绑定衔接
│ │ ├── 定稿交付.py # 全书检查、版本清单、导出与核对
│ │ ├── 审校修订.py # 诊断、受控修改、有界返修及等待作者
│ │ ├── 执行评测.py # 按隔离用途逐例执行实验
│ │ ├── 接口.py # 公开流程发起与任务查询
│ │ ├── 数据维护.py # 归档、备份、隔离恢复及引用安全删除
│ │ ├── 槽位约束.py # 开放槽位兼容性与保护节点不可绕行检查
│ │ ├── 流程版本.py # 固定流程定义、步骤版本和配置
│ │ ├── 流程登记.py # 登记具名步骤与流程类型
│ │ ├── 生成正文.py # 预组装、受限探索、冻结回放、无工具写作和检查
│ │ ├── 研究拆书.py # 资料处理、分窗分析、恢复与成果交接
│ │ ├── 章后处理.py # 摘要、事实提案、索引及影响复核
│ │ ├── 经验改进.py # 具体变更评测、批准及目标模块启用
│ │ ├── 规划章节.py # 前置条件、近期细化与规划候选
│ │ └── 载入模板.py # 流程模板 YAML 的受控载入
│ ├── 资料研究/
│ │ ├── __init__.py # Python 包身份
│ │ ├── 分析版本.py # 分窗成果、修复、重算与版本选用
│ │ ├── 分章切窗.py # 分章、窗口划分及输入漂移
│ │ ├── 原文版本.py # 原文保留、来源位置及不可变版本
│ │ ├── 存储.py # 资料研究所属记录的 SQL 与版本读写
│ │ ├── 实体归并.py # 参考作品内专名、别名及歧义
│ │ ├── 拆书分析.py # 章节、阶段、实体与写法分析
│ │ ├── 接口.py # 资料研究公开用例和可导入合同
│ │ ├── 提示词/
│ │ │ ├── 分析参考作品.md # 参考作品分析任务模板
│ │ │ └── 核对实体歧义.md # 疑似同名和别名核对模板
│ │ ├── 文本清理.py # 噪声清理候选和原文保护
│ │ ├── 来源导入.py # 文件、网页、笔记和灵感导入
│ │ ├── 样本选题.py # 样本比较、选题依据及选书交接
│ │ ├── 榜单快照.py # 来源、时间、质量、排名及观察差异
│ │ └── 模型.py # 资料研究稳定对象、外壳及内部状态
│ ├── 资源/
│ │ ├── 工作台 # web/dist 的发布投影，哈希资源文件由构建生成
│ │ ├── 清单.json # 发布身份及各资源哈希
│ │ └── 运行资源.zip # 角色、Skill、配置与数据库迁移发布包
│ ├── 资源加载.py # 安装包资源、发布身份与哈希核对
│ └── 配置.py # 配置解析、校验与连接引用
├── tests/
│ ├── conftest.py # 默认隔离、测试用途和夹具装配
│ ├── 单元/
│ │ ├── test_上下文任务范围形状.py # 任务范围新节与用途绑定的离线形状验证
│ │ ├── test_上下文回放清单形状.py # 探索清单形状校验验证
│ │ ├── test_上下文快照哈希.py # 快照哈希确定性与敏感性验证
│ │ ├── test_上下文范围与预算.py # 上下文范围与预算行为验证
│ │ ├── test_事实时点与有效性.py # 事实时点与有效性行为验证
│ │ ├── test_修订保真与停止.py # 修订保真与停止行为验证
│ │ ├── test_偏好作用域与撤回.py # 偏好作用域与撤回行为验证
│ │ ├── test_分章切窗与实体归并.py # 分章切窗与实体归并行为验证
│ │ ├── test_原文授权与期限.py # 原文授权与期限的逐例行为验证
│ │ ├── test_受控文件CAS与恢复.py # 私人文件版本与恢复的逐例行为验证
│ │ ├── test_声音与规则合同.py # 声音与规则的逐例行为验证
│ │ ├── test_定稿清单与导出.py # 定稿清单与导出行为验证
│ │ ├── test_探索交接与规划.py # 探索交接与规划行为验证
│ │ ├── test_方法版本与绑定.py # 方法版本与绑定行为验证
│ │ ├── test_正文格式与选段.py # 正文格式与选段行为验证
│ │ ├── test_流程登记与保护.py # 流程登记与保护的独立行为验证
│ │ ├── test_结构合成与字段校验.py # 结构合成与字段校验行为验证
│ │ ├── test_证据内容校验.py # 凭据校验旧用例逐例重写
│ │ ├── test_评测比较与启用判据.py # 评测比较与启用判据行为验证
│ │ ├── test_调用预算.py # 调用额度与期限的逐例行为验证
│ │ └── test_预算与配置.py # 预算窗口、计划与配置引用的确定性合同
│ ├── 夹具/
│ │ ├── Pi合成事件.json # 真实Pi SDK的合成两回合工具事件
│ │ ├── 中文正文.json # 中文、空行、表情和组合字符
│ │ ├── 动态结构.json # 新增字段、类型、用途和不兼容升级
│ │ ├── 去味/
│ │ │ ├── 不应修改.yaml # 不应修改的合成或已获准样例
│ │ │ ├── 仅哈希回填.yaml # 从旧条件提取的合成或已授权回归输入；排除凭据与生产默认值
│ │ │ ├── 修坏反例.yaml # 修坏反例的合成或已获准样例
│ │ │ ├── 历史回填样例.yaml # 从旧条件提取的合成或已授权回归输入；排除凭据与生产默认值
│ │ │ ├── 应该修改.yaml # 应该修改的合成或已获准样例
│ │ │ ├── 确认样例.yaml # 从旧条件提取的合成或已授权回归输入；排除凭据与生产默认值
│ │ │ ├── 规则候选.yaml # 从旧条件提取的合成或已授权回归输入；排除凭据与生产默认值
│ │ │ └── 边界判断.yaml # 边界判断的合成或已获准样例
│ │ ├── 回放/
│ │ │ ├── 中文方法对照条件.json # 从旧条件提取的合成或已授权回归输入；排除凭据与生产默认值
│ │ │ ├── 基础对照条件.json # 从旧条件提取的合成或已授权回归输入；排除凭据与生产默认值
│ │ │ └── 方法选择对照条件.json # 从旧条件提取的合成或已授权回归输入；排除凭据与生产默认值
│ │ ├── 多作品.py # 合成作品和版本引用
│ │ ├── 宿主事件/
│ │ │ └── DSH历史事件.json # 由原 DSH 对照提取的脱敏事件与失败反例
│ │ ├── 方法审核/
│ │ │ └── 历史标定/
│ │ │ ├── scores-cal002-m3旧尺子对照.json # 原方法审核的标定与对照依据，不自动成为新版通过阈值
│ │ │ ├── scores-cal002.json # 原方法审核的标定与对照依据，不自动成为新版通过阈值
│ │ │ ├── scores.json # 原方法审核的标定与对照依据，不自动成为新版通过阈值
│ │ │ ├── 金标准-主编-2026-07-13.md # 原方法审核的标定与对照依据，不自动成为新版通过阈值
│ │ │ ├── 金标准-番茄作家-2026-07-13.md # 原方法审核的标定与对照依据，不自动成为新版通过阈值
│ │ │ └── 金标准-起点作家-2026-07-13.md # 原方法审核的标定与对照依据，不自动成为新版通过阈值
│ │ ├── 旧库样本.sql # 脱敏合成迁移输入
│ │ ├── 旧看板/
│ │ │ ├── README.md # 旧只读展示的合成或获准证据样例
│ │ │ ├── backfill-inventory-2026-08-13.json # 旧只读展示的合成或获准证据样例
│ │ │ └── revalidation-2026-08-14.json # 旧只读展示的合成或获准证据样例
│ │ ├── 模型事件.json # 完成、截断、错误和未知用量
│ │ └── 行为评测/
│ │ └── 诊断机器味场景.json # 六个诊断行为场景及语义动作、结果断言
│ ├── 契约/
│ │ ├── test_HTTP合同.py # HTTP合同行为验证
│ │ ├── test_Pi工具桥.py # 宿主桥登记、参数、失败及任务作用域贯通
│ │ ├── test_事件游标与重连.py # 事件游标与重连行为验证
│ │ ├── test_动态结构投影与版本.py # 动态结构投影与版本行为验证
│ │ ├── test_宿主执行合同.py # 宿主执行合同行为验证
│ │ ├── test_工具范围.py # 工具装配与来源回执范围
│ │ ├── test_探索回放合同.py # 探索与确定性回放的逐例行为验证
│ │ ├── test_机器味诊断合同.py # 诊断只读与报告的逐例行为验证
│ │ ├── test_正文与模型输出.py # 正文与模型输出行为验证
│ │ ├── test_流式终态.py # 流式终态行为验证
│ │ ├── test_盲评与引文合同.py # 匿名盲评与分歧的逐例行为验证
│ │ ├── test_行为场景执行.py # Skill 行为评测的逐例行为验证
│ │ ├── test_角色能力与配置.py # 模型能力配置的逐例行为验证
│ │ └── test_连续性审校合同.py # 连续性与证据判断的逐例行为验证
│ ├── 架构/
│ │ ├── test_元数据不能跨模块写值.py # 元数据不能跨模块写值行为验证
│ │ ├── test_安装包独立启动.py # 安装包独立启动行为验证
│ │ ├── test_技能与文档索引.py # 技能与文档索引行为验证
│ │ ├── test_模块依赖.py # 模块依赖行为验证
│ │ ├── test_模型工具权限.py # 模型工具权限行为验证
│ │ ├── test_正式写入入口.py # 正式写入入口行为验证
│ │ ├── test_流程保护节点.py # 流程保护节点行为验证
│ │ ├── test_测试依赖与执行证据.py # 测试依赖与执行证据的逐例行为验证
│ │ └── test_生产与评测配置隔离.py # 生产与评测配置隔离行为验证
│ ├── 真实调用/
│ │ ├── test_Pi执行.py # Pi执行行为验证
│ │ ├── test_真实写作与恢复.py # 真实写作与恢复行为验证
│ │ ├── test_角色模型能力.py # 角色模型能力行为验证
│ │ └── test_诊断技能行为.py # 真实宿主的诊断 Skill 行为场景
│ ├── 端到端/
│ │ ├── test_交付归档与恢复.py # 交付归档与恢复行为验证
│ │ ├── test_人工编辑与候选确认.py # 人工编辑与候选确认行为验证
│ │ ├── test_元数据扩展与版本升级.py # 元数据扩展与版本升级行为验证
│ │ ├── test_改进验证与版本启用.py # 改进验证与版本启用行为验证
│ │ ├── test_新作品连续写作.py # 新作品连续写作行为验证
│ │ ├── test_诊断入口与只读边界.py # 诊断服务入口与只读边界
│ │ └── test_资料拆书与方法复用.py # 资料拆书与方法复用行为验证
│ ├── 迁移/
│ │ ├── test_动态字段往返.py # 动态字段往返行为验证
│ │ ├── test_历史记录承接.py # 历史记录承接行为验证
│ │ ├── test_备份恢复与切换核对.py # 备份恢复与切换核对行为验证
│ │ ├── test_旧库身份映射.py # 旧库身份映射行为验证
│ │ ├── test_正文转换保真.py # 正文转换保真行为验证
│ │ ├── test_混合知识分流.py # 旧数据分流与恢复的逐例行为验证
│ │ └── test_结构升级.py # 结构升级行为验证
│ └── 集成/
│ ├── test_HTTP任务接入.py # HTTP 与 CLI 任务控制共用隔离库和具名回执
│ ├── test_上下文历史正文.py # 受限历史正文读取与材料预算的真实任务验证
│ ├── test_上下文回放与复检.py # 确定性回放与依赖复检的真实任务验证
│ ├── test_上下文工作台.py # 上下文工作台 HTTP 合同验证
│ ├── test_上下文快照与索引写入.py # 上下文快照与索引写入的逐例行为验证
│ ├── test_上下文快照消费.py # 上下文快照冻结、幂等与漂移失效的真实任务验证
│ ├── test_上下文投影读取.py # 目标章细纲与时点事实 aiContext 真投影的真实任务验证
│ ├── test_上游依赖并发变更.py # 上游依赖并发变更行为验证
│ ├── test_两阶段写手.py # 两阶段写手旅程的逐例行为验证
│ ├── test_事实来源变更.py # 事实来源变更行为验证
│ ├── test_人工创作HTTP.py # 人工创作HTTP与作者编辑独立用例
│ ├── test_任务租约与恢复.py # 任务租约与恢复的独立行为验证
│ ├── test_任务租约与迟到结果.py # 任务租约与迟到结果行为验证
│ ├── test_作品与人工正文.py # 作品档案、稳定目录和人工正文的真实接缝
│ ├── test_候选状态与并发.py # 候选状态与并发的逐例行为验证
│ ├── test_分支合并与回退.py # 分支合并与回退行为验证
│ ├── test_原文归档与恢复.py # 原文归档与恢复的逐例行为验证
│ ├── test_取消恢复与未知调用.py # 取消恢复与未知调用行为验证
│ ├── test_受控模型调用.py # 模型调用与任务预算证据的真实接线
│ ├── test_同作品抽取互斥.py # 同作品抽取排他、释放及旧持有者拒绝
│ ├── test_声音与规则持久化.py # 声音、规则、样例版本及生效状态的隔离 PG 往返
│ ├── test_字段投影收紧.py # 字段投影收紧行为验证
│ ├── test_审校报告与案例持久化.py # 审校报告与案例持久化的逐例行为验证
│ ├── test_幂等与审阅版本.py # 幂等与审阅版本行为验证
│ ├── test_抽取版本与补偿.py # 抽取版本与补偿事务的逐例行为验证
│ ├── test_探索选定与规划.py # 探索选定与后续规划的真实数据库接入
│ ├── test_故事事实确认与时点.py # 事实确认、动态类型、依据有效性和时间边界的PG验证
│ ├── test_数据库连接与迁移.py # 数据库连接、用途隔离与迁移行为验证
│ ├── test_新增类型完整消费.py # 新增类型完整消费行为验证
│ ├── test_榜单与清理.py # 榜单快照与清理验证
│ ├── test_正式变更事务.py # 正式变更共用机制的PG并发与原子性
│ ├── test_正式提交原子性.py # 正式提交原子性行为验证
│ ├── test_正文候选与作者决定.py # 人工候选版本、部分选择和真实作者事务
│ ├── test_生产评测权限隔离.py # 生产评测权限隔离行为验证
│ ├── test_章后失败与重建.py # 章后失败与重建行为验证
│ ├── test_结构切换与内容提交.py # 结构切换与内容提交行为验证
│ ├── test_结构接入.py # CLI 发布结构和 HTTP 固定版本读取
│ ├── test_结构版本与并发保护.py # 结构版本与并发保护的独立行为验证
│ ├── test_规划候选与确认.py # 规划候选、来源与确认事务
│ ├── test_证据暂存补交.py # 证据暂存补交行为验证
│ ├── test_评测执行与失败收敛.py # 评测执行与失败收敛的逐例行为验证
│ ├── test_资料导入与版本.py # 来源导入与版本链验证
│ └── test_预算预留与结算.py # 真实预算预留、结算与配置版本CAS
├── upstream/
│ └── 溯源.yaml # 继承来源及版本溯源
├── uv.lock # Python 依赖锁
├── web/
│ ├── eslint.config.js # 前端静态检查配置
│ ├── index.html # 工作台 HTML 入口
│ ├── package.json # 前端依赖与构建命令
│ ├── playwright.config.ts # 浏览器旅程配置
│ ├── pnpm-lock.yaml # 前端依赖锁
│ ├── src/
│ │ ├── main.tsx # React 挂载入口
│ │ ├── vite-env.d.ts # 构建环境类型
│ │ ├── 功能/
│ │ │ ├── 上下文/
│ │ │ │ ├── index.ts # 上下文功能公开入口
│ │ │ │ ├── 上下文清单.tsx # 实际入选、省略与字段投影
│ │ │ │ ├── 数据.ts # 上下文查询和业务命令
│ │ │ │ ├── 来源证据面板.tsx # 固定版本原文及依据
│ │ │ │ └── 检索页.tsx # 资料、方法与作品范围检索
│ │ │ ├── 交付连载/
│ │ │ │ ├── index.ts # 交付连载功能公开入口
│ │ │ │ ├── 全书整理页.tsx # 跨章问题与修改
│ │ │ │ ├── 定稿导出页.tsx # 冻结版本与交付
│ │ │ │ ├── 数据.ts # 交付连载查询和业务命令
│ │ │ │ ├── 读者反馈页.tsx # 实际发布版本反馈
│ │ │ │ └── 连载计划页.tsx # 存稿和日程
│ │ │ ├── 任务运行/
│ │ │ │ ├── index.ts # 任务运行功能公开入口
│ │ │ │ ├── 任务列表.tsx # 真实任务状态
│ │ │ │ ├── 任务详情.tsx # 步骤、尝试及证据
│ │ │ │ ├── 恢复控制.tsx # 暂停、取消和重试
│ │ │ │ └── 数据.ts # 任务运行查询和业务命令
│ │ │ ├── 作品规划/
│ │ │ │ ├── index.ts # 作品规划功能公开入口
│ │ │ │ ├── 作品档案.tsx # 作品、系列和目标
│ │ │ │ ├── 作品首页.tsx # 作品进度与当前动作
│ │ │ │ ├── 探索工作区.tsx # 私人草稿和逐步探索
│ │ │ │ ├── 数据.ts # 作品规划查询和业务命令
│ │ │ │ ├── 章节目录.tsx # 目录顺序与稳定章身份
│ │ │ │ ├── 节点规划.tsx # 同一规划的节点视图
│ │ │ │ └── 规划工作区.tsx # 多层规划及确认
│ │ │ ├── 作者经验/
│ │ │ │ ├── index.ts # 作者经验功能公开入口
│ │ │ │ ├── 偏好页.tsx # 确认、冲突和撤回
│ │ │ │ ├── 反馈对照.tsx # 原稿、改稿及作者原话
│ │ │ │ ├── 改进提案页.tsx # 目标版本、实验及启用回执
│ │ │ │ └── 数据.ts # 作者经验查询和业务命令
│ │ │ ├── 元数据/
│ │ │ │ ├── index.ts # 元数据功能公开入口
│ │ │ │ ├── 作品扩展.tsx # 继承基础与作品新增字段
│ │ │ │ ├── 字段配置.tsx # 字段、约束和用途
│ │ │ │ ├── 数据.ts # 元数据查询和业务命令
│ │ │ │ ├── 结构变更对照.tsx # 兼容性、影响和升级
│ │ │ │ └── 结构管理页.tsx # 类型登记与发布版本
│ │ │ ├── 创作对话/
│ │ │ │ ├── index.ts # 创作对话功能公开入口
│ │ │ │ ├── 会话面板.tsx # 作者对话与关联任务
│ │ │ │ ├── 作者动作.tsx # 将具体批准提交业务入口
│ │ │ │ ├── 数据.ts # 创作对话查询和业务命令
│ │ │ │ └── 消息流.tsx # 可观察消息和执行回执
│ │ │ ├── 审校修订/
│ │ │ │ ├── index.ts # 审校修订功能公开入口
│ │ │ │ ├── 修订对照.tsx # 原文、修改与保护结果
│ │ │ │ ├── 声音档案.tsx # 认可样张及声音版本
│ │ │ │ ├── 审校页.tsx # 检查范围与报告
│ │ │ │ ├── 数据.ts # 审校修订查询和业务命令
│ │ │ │ └── 问题清单.tsx # 问题、证据和处置
│ │ │ ├── 故事世界/
│ │ │ │ ├── index.ts # 故事世界功能公开入口
│ │ │ │ ├── 世界资料页.tsx # 类型和动态实例
│ │ │ │ ├── 事实审阅.tsx # 事实增量与来源复核
│ │ │ │ ├── 人物关系页.tsx # 人物、关系及弧线
│ │ │ │ ├── 数据.ts # 故事世界查询和业务命令
│ │ │ │ └── 时间与伏笔页.tsx # 事件、时点和承诺
│ │ │ ├── 效果评测/
│ │ │ │ ├── index.ts # 效果评测功能公开入口
│ │ │ │ ├── 实验页.tsx # 数据集、条件与任务
│ │ │ │ ├── 数据.ts # 效果评测查询和业务命令
│ │ │ │ ├── 盲评工作区.tsx # 隔离的匿名评审
│ │ │ │ └── 逐例比较.tsx # 结果、分歧、缺失和成本
│ │ │ ├── 正式变更/
│ │ │ │ ├── index.ts # 正式变更功能公开入口
│ │ │ │ ├── 修改影响.tsx # 来源和下游影响
│ │ │ │ ├── 决策面板.tsx # 按业务类型调用决定
│ │ │ │ ├── 审阅控制.ts # 审阅身份、版本和批准范围
│ │ │ │ └── 数据.ts # 正式变更查询和业务命令
│ │ │ ├── 正文写作/
│ │ │ │ ├── index.ts # 正文写作功能公开入口
│ │ │ │ ├── 保存控制.ts # 自动保存、冲突与失败恢复
│ │ │ │ ├── 候选审阅.tsx # 具体候选与作者决定
│ │ │ │ ├── 数据.ts # 正文写作查询和业务命令
│ │ │ │ ├── 正文页.tsx # 正文界面组合
│ │ │ │ ├── 版本分支.tsx # 分支、合并与回退
│ │ │ │ ├── 版本比较.tsx # 正文差异
│ │ │ │ ├── 生成控制.ts # 写作任务与候选接收
│ │ │ │ ├── 编辑会话.ts # 章、分支、基线与请求代次
│ │ │ │ ├── 编辑缓冲.ts # 带基线版本的未提交内容
│ │ │ │ └── 选段控制.ts # 选区、修改目的与保护范围
│ │ │ ├── 知识方法/
│ │ │ │ ├── index.ts # 知识方法功能公开入口
│ │ │ │ ├── 数据.ts # 知识方法查询和业务命令
│ │ │ │ ├── 方法库页.tsx # 方法检索与范围
│ │ │ │ ├── 方法详情.tsx # 证据、反例与版本
│ │ │ │ └── 版本绑定.tsx # 固定版本选用及换绑影响
│ │ │ ├── 系统管理/
│ │ │ │ ├── index.ts # 系统管理功能公开入口
│ │ │ │ ├── 备份恢复页.tsx # 完整备份与隔离恢复
│ │ │ │ ├── 数据.ts # 系统管理查询和业务命令
│ │ │ │ ├── 数据管理页.tsx # 归档与删除影响
│ │ │ │ └── 连接与模型页.tsx # 连接引用和模型策略
│ │ │ └── 资料研究/
│ │ │ ├── index.ts # 资料研究功能公开入口
│ │ │ ├── 原文分析对照.tsx # 结论到固定原文
│ │ │ ├── 拆书工作区.tsx # 分析进度与恢复
│ │ │ ├── 数据.ts # 资料研究查询和业务命令
│ │ │ ├── 榜单与选题页.tsx # 快照、比较和选书
│ │ │ ├── 资料对照页.tsx # 来源与原文对照页面
│ │ │ └── 资料页.tsx # 来源导入和版本
│ │ ├── 应用/
│ │ │ ├── 作品会话.ts # 切作品屏障、取消和迟到隔离
│ │ │ ├── 作者会话.ts # 作者登录与会话
│ │ │ ├── 依赖装配.tsx # 查询缓存、会话和全局依赖
│ │ │ ├── 工作台布局.tsx # 导航、分栏与全局面板
│ │ │ ├── 应用.tsx # 应用根
│ │ │ └── 路由.tsx # 页面路由
│ │ ├── 接口/
│ │ │ ├── 事件连接.ts # 事件游标、重连与去重
│ │ │ ├── 传输.ts # 身份、错误、取消及请求封装
│ │ │ ├── 查询键.ts # 作品、目标、分支、版本和用途缓存键
│ │ │ └── 生成/
│ │ │ ├── 客户端.ts # 从已审 OpenAPI 生成
│ │ │ └── 类型.ts # 稳定协议外壳和投影合同类型
│ │ └── 界面/
│ │ ├── 主题.css # 暖纸张配色、间距和样式变量
│ │ ├── 关系图.tsx # 数据与回调驱动的关系图
│ │ ├── 分栏.tsx # 可调整分栏
│ │ ├── 反馈状态.tsx # 加载、空结果、失败和重试
│ │ ├── 对话框.tsx # 确认与任务反馈容器
│ │ ├── 差异视图.tsx # 受控内容差异
│ │ ├── 排版.css # 中文阅读与编辑排版
│ │ ├── 结构表单/
│ │ │ ├── 字段渲染.tsx # 已支持字段类型的显示和输入
│ │ │ ├── 引用选择.tsx # 通过业务查询选择受限引用
│ │ │ ├── 投影会话.ts # 结构、投影和数据版本绑定
│ │ │ ├── 校验反馈.tsx # 字段错误、结构过期与未保存输入
│ │ │ └── 结构表单.tsx # 按后端投影组合字段
│ │ ├── 编辑器/
│ │ │ ├── 字符位置.ts # UTF-16 与码点位置集中转换
│ │ │ ├── 文档适配.ts # 编辑器和正式文档结构往返
│ │ │ ├── 正文编辑器.tsx # 受控正文编辑
│ │ │ └── 粘贴处理.ts # 允许结构与空白保真
│ │ └── 表单.tsx # 共用表单布局
│ ├── tests/
│ │ ├── 交互/
│ │ │ ├── 上下文材料.test.tsx # 任务材料组件渲染验证
│ │ │ ├── 任务重连.test.tsx # 持久化游标续接
│ │ │ ├── 候选审阅.test.tsx # 被审内容与批准范围
│ │ │ ├── 切作品隔离.test.tsx # 迟到响应不写错作品
│ │ │ ├── 创作对话.test.tsx # 创作对话组件渲染验证
│ │ │ ├── 动态字段与结构过期.test.tsx # 新字段可编辑，版本变化保留输入并复核
│ │ │ ├── 报告失效.test.tsx # 旧报告不显示当前通过
│ │ │ ├── 退出会话.test.tsx # 退出作者会话后的页面和订阅生命周期
│ │ │ └── 隐藏字段不泄露.test.tsx # 撤回投影后清除缓存和显示
│ │ ├── 单元/
│ │ │ └── 中文显示与动作.test.tsx # 作者界面语义的逐例行为验证
│ │ ├── 旅程/
│ │ │ ├── 人工创作.spec.ts # 人工创作HTTP与作者编辑独立用例
│ │ │ ├── 任务材料.spec.ts # 任务材料真实浏览器旅程验证
│ │ │ ├── 候选审阅.spec.ts # 作者候选审阅和正式采纳浏览器旅程
│ │ │ ├── 创建作品到确认正文.spec.ts # 真后端创作旅程
│ │ │ ├── 动态类型到事实确认.spec.ts # 新类型全链消费
│ │ │ ├── 定稿导出与反馈.spec.ts # 固定稿件交付
│ │ │ ├── 拆书到方法绑定.spec.ts # 来源到方法消费
│ │ │ ├── 探索草稿.spec.ts # 私人探索的实际作者浏览器旅程
│ │ │ ├── 生成对话.spec.ts # 创作对话真实浏览器旅程验证
│ │ │ ├── 编辑冲突与恢复.spec.ts # 编辑保存和任务恢复
│ │ │ └── 资料对照.spec.ts # 资料对照页真实浏览器旅程
│ │ ├── 编辑/
│ │ │ ├── 中文输入.test.tsx # 输入法组合时不破坏正文或提前保存
│ │ │ ├── 保存冲突.test.tsx # 并发编辑不覆盖
│ │ │ ├── 历史回退.test.tsx # 人工创作HTTP与作者编辑独立用例
│ │ │ ├── 断网缓冲.test.tsx # 未提交内容恢复
│ │ │ ├── 正文往返.test.ts # 段落与可见文本往返
│ │ │ └── 选区转换.test.ts # 码点和 UTF-16
│ │ └── 设置.ts # 前端测试环境
│ ├── tsconfig.json # TypeScript 配置
│ ├── vite.config.ts # 前端开发与构建配置
│ └── vitest.config.ts # 组件和行为测试配置
├── 工具/
│ ├── 构建资源包.py # 生成运行资源与发布清单
│ ├── 环境预检.py # 安装包、连接和宿主能力核查
│ ├── 生成接口.py # 生成 Schema、OpenAPI 和 TypeScript
│ ├── 生成输入.json # 接口生成的唯一登记输入
│ ├── 维护索引.py # 索引生成、查重及检查
│ └── 资源登记.json # 运行资源包的唯一登记输入
├── 数据库/
│ ├── 初始化/
│ │ └── 用途角色.sql # 初始化生产、评测、维护三个固定用途角色
│ ├── 旧库迁移/
│ │ ├── 入口.py # 独立维护命令
│ │ ├── 切换检查.py # 增量对账与回退条件
│ │ ├── 导入新库.py # 限定目标的类型化导入
│ │ ├── 建立映射.py # 旧系统、类型、ID 到新身份
│ │ ├── 旧结构/
│ │ │ ├── PostgreSQL/
│ │ │ │ ├── 100-example规划与冻结.sql # 100-example规划与冻结的旧库结构依据
│ │ │ │ ├── 101-example-raw.sql # 101-example-raw的旧库结构依据
│ │ │ │ ├── 102-example智能体技能登记.sql # 102-example智能体技能登记的旧库结构依据
│ │ │ │ ├── 103-example评测隔离引擎强制.sql # 103-example评测隔离引擎强制的旧库结构依据
│ │ │ │ ├── 104-example-ai-flavor-cases.sql # 104-example-ai-flavor-cases的旧库结构依据
│ │ │ │ ├── 105-example候选语义审查.sql # 105-example候选语义审查的旧库结构依据
│ │ │ │ ├── 106-example事实增量.sql # 106-example事实增量的旧库结构依据
│ │ │ │ ├── 107-example投影登记.sql # 107-example投影登记的旧库结构依据
│ │ │ │ ├── 108-example经验升格.sql # 108-example经验升格的旧库结构依据
│ │ │ │ ├── 109-example候选状态CAS.sql # 109-example候选状态CAS的旧库结构依据
│ │ │ │ ├── 110-example-voice-baseline.sql # 110-example-voice-baseline的旧库结构依据
│ │ │ │ ├── 111-example-humanization规则与样例.sql # 111-example-humanization规则与样例的旧库结构依据
│ │ │ │ ├── 112-example角色模型策略与登记路径.sql # 112-example角色模型策略与登记路径的旧库结构依据
│ │ │ │ ├── 113-example代理事件账本.sql # 113-example代理事件账本的旧库结构依据
│ │ │ │ ├── 114-example冻结幂等键-清单加上下文对.sql # 114-example冻结幂等键-清单加上下文对的旧库结构依据
│ │ │ │ ├── 90-主仓ALTER摘录-V9V10V14V30.sql # 90-主仓ALTER摘录-V9V10V14V30的旧库结构依据
│ │ │ │ ├── 91-example实验私货.sql # 91-example实验私货的旧库结构依据
│ │ │ │ ├── 92-example清洗日志.sql # 92-example清洗日志的旧库结构依据
│ │ │ │ ├── 93-example大纲聚合.sql # 93-example大纲聚合的旧库结构依据
│ │ │ │ ├── 94-example作品面升格.sql # 94-example作品面升格的旧库结构依据
│ │ │ │ ├── 95-example额度账本.sql # 95-example额度账本的旧库结构依据
│ │ │ │ ├── 96-example参考作品授权快照.sql # 96-example参考作品授权快照的旧库结构依据
│ │ │ │ ├── 97-example模型调用明细.sql # 97-example模型调用明细的旧库结构依据
│ │ │ │ ├── 98-example运行与回执与质量结果.sql # 98-example运行与回执与质量结果的旧库结构依据
│ │ │ │ ├── 99-example候选与决策.sql # 99-example候选与决策的旧库结构依据
│ │ │ │ ├── V1__init_content_schema.sql # V1__init_content_schema的旧库结构依据
│ │ │ │ ├── V26__fix_content_softdelete_order_uk_partial.sql # V26__fix_content_softdelete_order_uk_partial的旧库结构依据
│ │ │ │ ├── V3__init_meta_schema.sql # V3__init_meta_schema的旧库结构依据
│ │ │ │ └── V5__init_knowledge_schema.sql # V5__init_knowledge_schema的旧库结构依据
│ │ │ └── SQLite/
│ │ │ ├── 0001_init.sql # 0001_init的旧 SQLite 结构依据
│ │ │ ├── 0002_lessons.sql # 0002_lessons的旧 SQLite 结构依据
│ │ │ └── 0003_snapshots.sql # 0003_snapshots的旧 SQLite 结构依据
│ │ ├── 核对结果.py # 内容、关系、版本、动态字段和孤儿引用
│ │ ├── 知识记录分流.py # K01—K08 旧知识用途、类型、状态和引用分流
│ │ ├── 读取旧PG.py # 只读旧正式数据与元数据版本
│ │ ├── 读取旧SQLite.py # 独有审阅、运行、反馈和经验
│ │ ├── 转换业务对象.py # 按 K01—K08 分流结论转换业务对象、状态、来源与历史，不自动猜测用途
│ │ ├── 转换正文.py # 纯文本、场景和段落对应及旧哈希
│ │ └── 转换结构.py # 内置结构、字段别名、用途及版本承接
│ └── 迁移/
│ ├── V0001__共享标识与版本.sql # 共享标识与版本结构迁移
│ ├── V0002__元数据结构与策略.sql # 元数据结构与策略结构迁移
│ ├── V0003__正式变更.sql # 正式变更结构迁移
│ ├── V0004__任务运行与证据.sql # 任务、作用域租约、原文保留授权、完整归档、清理回执和证据迁移
│ ├── V0005__作品规划.sql # 作品规划结构迁移
│ ├── V0006__故事世界.sql # 故事世界结构迁移
│ ├── V0007__资料研究.sql # 资料研究结构迁移
│ ├── V0008__知识方法.sql # 知识方法结构迁移
│ ├── V0009__正文写作.sql # 正文写作结构迁移
│ ├── V0010__审校修订.sql # 审校修订结构迁移
│ ├── V0011__作者经验.sql # 作者经验结构迁移
│ ├── V0012__交付连载.sql # 交付连载结构迁移
│ ├── V0013__上下文与检索索引.sql # 上下文与检索索引结构迁移
│ ├── V0014__效果评测.sql # 效果评测结构迁移
│ ├── V0015__运行配置版本.sql # 运行配置版本结构迁移
│ ├── V0016__流程定义与版本.sql # 流程定义与版本结构迁移
│ ├── V0017__跨模块引用约束.sql # 跨模块引用约束结构迁移
│ ├── V0018__工作台查询视图.sql # 工作台查询视图结构迁移
│ ├── V0019__用途隔离与数据权限.sql # 用途隔离与数据权限结构迁移
│ ├── V0020__上下文快照与消费.sql # 上下文快照与消费记录结构迁移
│ └── V0021__模型候选与审校报告.sql # 模型候选来源与审校报告结构迁移
├── 部署/
│ ├── Dockerfile # 前端构建和后端发布镜像
│ ├── compose.test.yaml # 隔离 PostgreSQL 和测试环境
│ ├── compose.yaml # HTTP、任务与隔离评测执行配置
│ ├── 停止.sh # 优雅停止并保护正在执行的任务
│ └── 启动.sh # 启动已配置进程
└── 配置/
├── 工具策略.yaml # 允许工具和用途
├── 应用.example.toml # 服务地址和资源、连接引用模板
├── 提供方.example.toml # 提供方能力与凭据引用模板
├── 检索策略.yaml # 切块、召回与预算
├── 流程模板/
│ ├── 作品准备.yaml # 作品准备 的具名步骤与开放槽位模板
│ ├── 定稿交付.yaml # 定稿交付 的具名步骤与开放槽位模板
│ ├── 审校修订.yaml # 审校修订 的具名步骤与开放槽位模板
│ ├── 执行评测.yaml # 执行评测 的具名步骤与开放槽位模板
│ ├── 数据维护.yaml # 数据维护 的具名步骤与开放槽位模板
│ ├── 生成正文.yaml # 生成正文 的具名步骤与开放槽位模板
│ ├── 研究拆书.yaml # 研究拆书 的具名步骤与开放槽位模板
│ ├── 章后处理.yaml # 章后处理 的具名步骤与开放槽位模板
│ ├── 经验改进.yaml # 经验改进 的具名步骤与开放槽位模板
│ └── 规划章节.yaml # 规划章节 的具名步骤与开放槽位模板
├── 测试.example.toml # 隔离测试与真实调用显式配置
├── 角色策略.yaml # 角色模型能力与工具模式
└── 预算策略.yaml # 五小时额度窗口、并发和停止条件
实现阶段的机器契约统一输出到 docs/接口契约/生成；本次只声明路径，不预先伪造生成的 OpenAPI 或 Schema。
生成来源
| 生成物 | 唯一手写输入 | 约束 |
|---|---|---|
| 目录树 | 目标文件清单.json | 路径、文件职责和种类一致，不扫描未实施目录猜目标 |
| 运行资源及清单 | .agent 角色/Skill、配置模板、数据库迁移和业务资源 | 固定发布身份与哈希，不让运行时加载未审工作树 |
| 内置结构运行版本 | 内置结构种子加显式发布 | PG 保存不可变生效版本，启动不覆盖作者扩展 |
| JSON Schema、OpenAPI、TS 客户端 | 稳定业务合同和动态投影协议 | 动态实例按所绑定结构运行时校验，不重复手写字段定义 |
| Skill 索引与宿主展示 | SKILL.md frontmatter | 技能路径不成为 Python 导入依赖 |
| 工作台静态文件 | web 的源码及锁文件 | 安装产物能在没有 Git 工作树和 tests 时运行 |
设计包实际文件保留在 docs/系统架构/新版设计 内，作为新版各主题定义的统一集合。现有运行实现及旧文档不因这个目标树自动删除；退出条件见迁移与验收。