9e6f1c4481
- src/muse 新版全模块（装配/共享/上下文/任务运行/作品规划/故事世界/正文写作/审校修订/知识方法/作者经验/效果评测/交付连载/资料研究/正式变更/元数据/接入/基础设施/编排）+ 测试树（单元/契约/集成/架构/迁移/端到端/夹具） - 129 项功能全部实现与自动验证（功能覆盖.json/矩阵），含 W31 补齐的规则与代价/节奏安排/伏笔与承诺 - 旧实现按处置清单退出（702 条中 324 删，保护合同与未迁移条目留存有据）；web/app.py 旧工作台退役，新工作台为唯一写入口 - 数据库/旧库迁移：真实旧库内容批次迁移链（端点守卫/PG作品正文映射/质量资产缺省投影） - 运行手册 docs/运行手册.md；W30 本机服务阶段一已运行（infra PG 为正式内容权威） - R2 执行证据与私有运行材料在 .agents.local/改造/R2-20260909/（不入库）
18 KiB
P4 研究与知识资产
本页从工作包清单投影。各包状态引用工作包清单；目标、文件或用例已列入不表示已验证。先读总计划与执行规则。
| 工作包 | 责任角色 | 前置包 | 交付结果 |
|---|---|---|---|
| W17 资料导入、榜单与来源管理 | 研究资料负责人 | W04、W07、W08、W10、W11 | 原文、资料与榜单快照可追溯、可筛选并交接研究 |
| W18 拆书、归并、互斥与补偿 | 研究抽取负责人 | W17、W05、W12 | 长资料可以分窗分析、归并实体并从失败处安全恢复 |
| W19 世界设定、人物弧线与全书连续性 | 故事世界负责人 | W12、W13、W16 | 设定、人物、伏笔和关系可在创作中长期维护并追踪影响 |
| W20 方法版本、混合检索与跨书复用 | 知识与上下文负责人 | W18、W14 | 研究结论可以成为有证据的方法并按固定版本实际消费 |
| W21 旧库身份分流与转换框架 | 迁移负责人 | W07、W08、W16、W18、W20 | 旧 PG、SQLite 与文件资产有可重放的映射和差异清单 |
W17 资料导入、榜单与来源管理
交付目标： 原文、资料与榜单快照可追溯、可筛选并交接研究。
责任角色：研究资料负责人。前置：W04、W07、W08、W10、W11。
工作内容
- 实现资料导入、原文版本、定位、清理候选和来源用途。
- 实现具名网页/榜单读取、时间快照、样本比较与选题交接。
- 区分作者稿、参考书和公共素材，不把外部资料当指令或事实授权。
- 建立来源和原文对照页面、工作台资料入口与导入错误恢复。
文件、功能与用例
维护 16 个目标条目；精确范围见分配索引，后续关联包及处理方式以 JSON 为准。代码入口包括：
- src/muse/资料研究/接口.py。
- src/muse/资料研究/模型.py。
- src/muse/资料研究/存储.py。
- src/muse/资料研究/来源导入.py。
- src/muse/资料研究/原文版本.py。
- src/muse/资料研究/文本清理.py。
- src/muse/资料研究/榜单快照.py。
- src/muse/基础设施/资料来源/网页读取.py。
- src/muse/基础设施/资料来源/榜单读取.py。
- 数据库/迁移/V0007__资料研究.sql。
牵头功能：F02.01 灵感收集、F02.02 资料导入、F02.03 素材整理、F02.06 榜单数据获取、F02.07 榜单观察快照、F02.08 样本比较与选题、F02.09 选书交接。
分配 0 个目标用例与 0 个退役裁决。数量只用于定位，新增功能仍按本包合同补独立用例。本包的新增能力先在 W01/本包入口形成用例与观察清单，不以没有旧用例解释为无需验证。
接受条件
- 抓取失败不伪造数据，榜单快照不推断最近 run 的效果因果。
- 导入与清理保留原文，重复来源和不同版本可辨认，未授权内容不扩散。
失败与回退
回退导入状态而保留原始文件与版本；取消清理候选不改原稿。
依据
W18 拆书、归并、互斥与补偿
交付目标： 长资料可以分窗分析、归并实体并从失败处安全恢复。
工作内容
- 拆开 upgrade 的输入切窗、模型提取、别名/关系归并、存储和恢复责任。
- 保留原文定位、Schema 合同、输入漂移、同作品互斥与有效补偿。
- 实体/关系/向量写入锁内复检；外部确认、版本漂移和 owner 冲突不被 undo 覆盖。
- 实现分析版本、窗口失败、检查维护、备份与恢复接缝。
- 在研究工作台对照原文和分析，错误与缺证据可逐项处理。
文件、功能与用例
维护 24 个目标条目；精确范围见分配索引，后续关联包及处理方式以 JSON 为准。代码入口包括：
- src/muse/接入/http/路由/资料研究.py。
- src/muse/接入/cli/研究命令.py。
- src/muse/编排/研究拆书.py。
- src/muse/资料研究/分章切窗.py。
- src/muse/资料研究/样本选题.py。
- src/muse/资料研究/拆书分析.py。
- src/muse/资料研究/实体归并.py。
- src/muse/资料研究/分析版本.py。
- src/muse/资料研究/提示词/分析参考作品.md。
- src/muse/资料研究/提示词/核对实体歧义.md。
牵头功能：F02.04 资料研究、F02.05 作品拆解、F02.10 拆书任务控制、F02.11 原文与分析对照、F02.12 分析版本管理。
分配 141 个目标用例与 0 个退役裁决。数量只用于定位，新增功能仍按本包合同补独立用例。代表用例：TC-9e0ca0f4940f、TC-76d81d99c50c、TC-2b2aac8cb71b、TC-402583fca1e6、TC-d7490016fa3b。
接受条件
- 真实隔离 PG 验证批量原子性、外部漂移、补偿失败断点及互斥接管。
- 别名歧义不误并；失败不伪称窗口完成，重试不遗留错 owner 向量。
失败与回退
停在可解释断点；仅撤销本次仍可证明归属的变更，不能全表 reset 或抹掉外部确认。
依据
W19 世界设定、人物弧线与全书连续性
交付目标： 设定、人物、伏笔和关系可在创作中长期维护并追踪影响。
工作内容
- 完成世界规则、代价、人物关系、弧线、声音与视角的结构化编辑。
- 完成事件、知情状态、伏笔与承诺、设定修订和来源对照。
- 实现章节重排与设定变化的依赖影响，避免等后台标记才阻止过期读取。
- 建立故事世界页面与从实体/事件到正文的导航。
文件、功能与用例
维护 12 个目标条目；精确范围见分配索引，后续关联包及处理方式以 JSON 为准。代码入口包括：
- src/muse/接入/http/路由/故事世界.py。
- src/muse/故事世界/世界设定.py。
- src/muse/故事世界/人物关系.py。
- src/muse/故事世界/设定修订.py。
- src/muse/故事世界/提示词/抽取章节事实.md。
- web/src/功能/故事世界/index.ts。
- web/src/功能/故事世界/数据.ts。
- web/src/功能/故事世界/世界资料页.tsx。
- web/src/功能/故事世界/人物关系页.tsx。
- web/src/功能/故事世界/时间与伏笔页.tsx。
牵头功能：F04.01 世界资料、F04.02 规则与代价、F04.03 实体关联、F04.04 设定修订、F04.05 设定使用追踪、F05.01 人物建构、F05.02 关系发展、F05.03 人物弧线、F05.04 人物声音、F05.05 视角设计、F07.04 伏笔与承诺、F07.06 连续性纠错、F14.06 修改影响追踪。
分配 0 个目标用例与 0 个退役裁决。数量只用于定位，新增功能仍按本包合同补独立用例。本包的新增能力先在 W01/本包入口形成用例与观察清单，不以没有旧用例解释为无需验证。
接受条件
- 新题材字段与新类型不改生产代码；历史与未来成长计划不混用。
- 修改设定或章序后，相关规划、事实和候选被准确复核；独立确认不误撤回。
失败与回退
用新版本撤回/修订，保留来源和作者决定；不物理删除被其他事实引用的对象。
依据
W20 方法版本、混合检索与跨书复用
交付目标： 研究结论可以成为有证据的方法并按固定版本实际消费。
工作内容
- 实现六类范式、方法候选、版本、反例、去重、确认、停用及绑定。
- 将已承接的静态方法资源接入方法版本、来源证据和跨书复用；吸收外部机制前复核当前快照及许可，不重复维护一份 Skill 正文。
- 完善关键词/向量检索、索引版本、来源回读和与本书事实独立的引用。
- 接入写前准备、规划和审阅的实际方法消费，记录使用结果。
- 完成方法库、检索导航与绑定页面，升级方法不静默改旧任务。
文件、功能与用例
维护 35 个目标条目；精确范围见分配索引，后续关联包及处理方式以 JSON 为准。代码入口包括：
- src/muse/接入/http/路由/知识方法.py。
- src/muse/知识方法/接口.py。
- src/muse/知识方法/模型.py。
- src/muse/知识方法/存储.py。
- src/muse/知识方法/方法卡.py。
- src/muse/知识方法/证据反例.py。
- src/muse/知识方法/方法版本.py。
- src/muse/知识方法/方法绑定.py。
- src/muse/知识方法/消费记录.py。
- src/muse/知识方法/提示词/提炼写作方法.md。
牵头功能：F08.03 写法与样例选取、F08.07 混合检索、F15.04 内容追源、F17.01 分类沉淀、F17.02 证据化知识卡、F17.03 双向采集、F17.04 确认与整理、F17.05 实际消费、F17.06 作用域与淘汰、F20.02 检索与导航。
分配 104 个目标用例与 0 个退役裁决。数量只用于定位，新增功能仍按本包合同补独立用例。代表用例：TC-ede3db68788f、TC-ccc13847b5fd、TC-629c7435c971、TC-76bc175ad3b2、TC-08dfd19e141d。
接受条件
- 资料→分析→方法确认→固定绑定→生成消费可沿来源回查。
- 同哈希不同 owner、陈旧向量和不允许来源拒绝；参数上限来自版本策略。
失败与回退
停用新方法或索引版本并保留旧绑定；重建索引不能改正式方法和事实。
依据
W21 旧库身份分流与转换框架
交付目标： 旧 PG、SQLite 与文件资产有可重放的映射和差异清单。
责任角色：迁移负责人。前置：W07、W08、W16、W18、W20。
工作内容
- 实现旧源只读加载、命名空间与工作用途映射、K01—K08 分流和明确隔离。
- 实现混合 type/型、entity 形状关系、已确认目标与向量指针的转换。
- 承接运行/审阅/经验等旧账本共有骨架；后续对象在所属模块完成后扩展转换。
- 建立逐项对账、幂等导入、版本漂移与未知值保留，不静默丢弃。
- 将旧 DDL 留作解释来源，不能直接混入新迁移序列。
文件、功能与用例
维护 61 个目标条目；精确范围见分配索引，后续关联包及处理方式以 JSON 为准。代码入口包括：
- 数据库/旧库迁移/入口.py。
- 数据库/旧库迁移/读取旧PG.py。
- 数据库/旧库迁移/读取旧SQLite.py。
- 数据库/旧库迁移/建立映射.py。
- 数据库/旧库迁移/转换正文.py。
- 数据库/旧库迁移/转换结构.py。
- 数据库/旧库迁移/转换业务对象.py。
- 数据库/旧库迁移/导入新库.py。
- 数据库/旧库迁移/核对结果.py。
- 数据库/旧库迁移/切换检查.py。
牵头功能：共享底座、基线或切换职责，支撑所依赖的功能包。
分配 105 个目标用例与 0 个退役裁决。数量只用于定位，新增功能仍按本包合同补独立用例。代表用例：NC-w21-210001、NC-w21-210002、NC-w21-210003、NC-w21-210004、NC-w21-210005。
接受条件
- 合成旧快照覆盖所有分流规则与冲突；隔离 PG 证明重复导入、引用和状态正确。
- 每条旧数据都为已映射、历史保留或明确隔离，未确认数据不转正。
失败与回退
丢弃隔离导入目标并按源快照重跑；不修写旧源，不把隔离记录当迁移成功。