@ -0,0 +1,456 @@
# 全仓专项检查台账
> 日期： ｜ ｜ 专项检查-计划.md ](专项检查-计划.md ) 第 5 节严重度分级、第 6 节报告格式
> 范围：`src/muse` 、`tests` 、`web` 、`数据库` 、`工具` 、`.agent` 、`docs` 、根文件；不含缓存、构建产物、小说正文与数据库内容。
> **本台账保存2026-09-16原发现及复核更正， ； 优化执行 ](../系统架构/新版设计/优化执行合同.md )。下表是原级别分布，不能当作尚未修复数。**
## 复核更正（ ）
- **不能直接据原台账逐条实施** ： ， ， ； ，
- 13项源码抽样（ ） ；
- R2“846/889”缺原快照、脚本和口径， ； ， ；
- 合并更正： ， ； ，
- JS-01按P1处理： ， ； ； ； ； ； ； ；
- AG-01关于“无双向核对”的说法不完整： ，
- 2026-09-16复核原命令 `make 检查` 、`make 测试` 均exit 0， ； ，
逐条三值判定及原始日志：`/tmp/muse-qc-review-20260916-2112/` 。已裁决的全量编号处置、五要素与依赖计划已留存于实施区 `.agents.local/优化-20260917/已裁决计划/` ；新增全局设计问题一并承接，不能只按原严重度逐项打补丁。原模块报告保留检查时表述，本节纠偏优先于其冲突结论。
## 0. 汇总
| 严重度 | 原始条目 | 合并同事实后 | 说明 |
|---|---|---|---|
| **P0** 红线与风险 | 6 | **5** | 门禁红 2（
| **P1** 事实错误 | 95 | **84** | 悬空引用、死代码/零消费者资产、一致性断裂、标准缺失、门禁恒真 |
| **P2** 熵增 | 171 | **171** | 重复、泔水、孤儿、复杂度热点、依赖冗余 |
| **P3** 记录不改 | 34 | **34** | 历史留痕与有意保留项，已注明理由 |
| 合计 | 306 | **294** | 另有 6 条「未发现问题」覆核行（各报告零发现节），不计入条目 |
**原检查的覆盖边界**：离线绿测只证明实际选中行为，不能据此宣称全仓设计合理或全部链路健康。后续复核发现连接、资源核验、测试底座、索引、调用费用、授权撤回、上下文与工作面等全局问题，按优化执行合同处理。
**来源与去重**： ： `.agent` / docs+根文件——详见 `docs/实现回顾/专项检查-报告-*.md` ）
| 保留条目 | 并入 | 同一事实 |
|---|---|---|
| `JC-01` | `TS-01` | CI「离线测试」步无生成步骤 → 干净检出必红 |
| `JC-02` | `DR-11` | Pi 版本口径 CI 0.84.4 vs 代码/文档/部署 0.85.1 |
| `AG-01` | `DR-04` 、`DR-05` | `skills.json` 不存在 + 「59 个技能」实为 46 |
| `AG-07` | `DR-13` | 「审查标准」原文缺失（
| `JT-03` | `JS-03` 、`JW-02` 、`JF-02` | 提示词未登记资源、绕过发布包直读源树（跨 3 模块同模式） |
| `DR-10` | `JW-04` | B07 声明 `作者经验/提示词/整理偏好与改进建议.md` ，目录不存在 |
| `LM-02` | `TS-10` | 「混合知识分流」用例断言在真实旧结构上不成立 |
| `DR-02` | `JK-07` | `AGENTS.md:53` 结构契约指向已退出路径 + 「23 型」实为 24 |
| `TS-05` | `AG-11` | `tests/架构/test_模块依赖.py:353` 技能登记断言恒真 |
## 1. 门禁结论（ ， ）
| 门禁 | 首轮 20:30 | 生成物刷新后 20:42 | 证据 |
|---|---|---|---|
| `make 检查` | 绿 | 绿 | ruff `All checks passed!` ； `0 errors, 0 warnings` ；架构 `15 passed` ；索引通过 |
| `make 测试` | **红** ： `1 failed, 1004 passed` | 绿：`1005 passed, 927 deselected` | `/tmp/qc/门禁结果.txt` 、`/tmp/qc/门禁结果-复跑2.txt` |
| `make 资源核对` | 绿 | 绿 | 发布身份 `muse-foundation-r2` ，
| `make 前端检查` | 绿 | 绿 | exit 0 |
| `make 前端测试` | 绿 | 绿 | `28 passed` 文件 / `91 passed` 用例 |
| `uv run python 工具/维护索引.py --检查` | 绿 | 绿 | exit 0 |
首轮红的原因、处置与**残余的 CI 风险**见 `JC-01` ；本轮门禁只覆盖本机工作区，**干净检出/CI 的结论是红**（同一根因）。
**环境限制（非产品缺陷，但影响证据强度）**： `uv run` 在受限沙箱下拒绝写 `~/.cache/uv` （ ） ， `.venv/bin/*` 等价命令；`pytest` 不带 `--外部环境` 时因 `tests/conftest.py:110-121` 的 macOS `sandbox_init` 被拒而 exit 4（ `make 测试` 为准**（ ）
## 2. 原机械复核与更正边界
| 项 | 口径 | 结果 | 结论 |
|---|---|---|---|
| Markdown 相对链接 | 393 个 .md、1680 条链接（全 docs + .agent + .github + 根文件） | 死链 **4** 条 | 主代理与 docs 子代理两套独立脚本收敛到同一数字 |
| Markdown 链接（ **4** 条；`docs/系统架构/新版设计/` 单独 1076 条**零死链** | 权威区链接健康 |
| 反引号仓内路径引用 | 2722 条（ ） ／ （ ／
| **R2 旧结论「证据死链 846/889」** | 穷举「范围 × **无法复现** ： ，
| `.gitignore` 与跟踪文件交集 | `git ls-files` 1320 个 × `.gitignore` | **0 命中** | 计划第 2 节「零误跟踪」目标本轮成立（
| 全新检出模拟 | 临时移走 `src/muse/资源/清单.json` 与 `运行资源.zip` （ `tests/迁移/test_备份恢复与切换核对.py` **收集期**即报 `资源缺失错误` ， （ ） `JC-01` 的 CI 风险 |
| `AGENTS.md` 已知过期点 | 逐条 `ls` /`find` 验证 | ① `muse/content/meta/schemas/` 不存在；② `muse/lifecycle/flow/chains/` 不存在；③ 全仓无 `skills.json` ；④ `.venv-旧` 不存在；⑤ 父仓 `../AGENTS.md` 、`../design-docs` 存在 | 旧路径已标退出者仅缺现行导航； ，
| 链接文字≠目标 | `.agent` +`docs` +根文件 | 8 类（`AGENTS.md` 11 处、历史文档 2 处） | 与 `DR-07` 一致 |
| 技能物理计数 | `find .agent/skills -name SKILL.md` | **46** （诊断 1、规划 6、操作 31、写作 8） ； `能力/目录.json` 仅 22 operation + 5 role， `method` 恒 0 | 「59」既非物理数也非登记数 |
## 3. 问题清单
## P0（
| 编号 | 模块 | 位置 | 方向 | 现状摘录 | 建议 | 所需授权 |
|---|---|---|---|---|---|---|
| **AG-01** （并入 DR-04、DR-05） `.agent/skills/规划/目录.md:3` （同文 `写作/目录.md:3` 、`诊断/目录.md:3` ）、`AGENTS.md:55` | D4 | 「技能名和物理路径来自 manifest， ； ， `工具/维护索引.py --检查` 核对清单与技能目录一致」； `skills.json` 为准）」。全仓无 `skills.json` /manifest； ， `SKILL.md` 。 | 删除 manifest/skills.json 口径或回填该文件；在 `工具/维护索引.py` 增加一轮「`目录.md` 表行 ↔ 磁盘技能目录」双向核对， ；
| **DR-01** | docs与根文件 | AGENTS.md:60 | D4 | `｜ ｜ .agent/规范/审查标准.md`](.agent/rules/文档与资源生成.md) ｜ ｜ —— 链接文字所指 `.agent/规范/审查标准.md` **全仓不存在** （ `find . -name '审查标准*'` 零命中），目标 `.agent/rules/文档与资源生成.md` 是「文档与资源生成规则」6 条，内容不含 4 问/7 问/D8/严重度 | 二选一：①把该行改为指向真实存在的审查标准文件并把原文落盘；②若已无原文，改引 `专项检查-计划.md` 附录 A/B 并将附录转正。在此之前该行不得再作为权威引用 | 需用户授权（改 AGENTS.md）
| **JC-01** （并入 TS-01） `tests/单元/test_备份发布身份.py:18,31` ； `src/muse/基础设施/备份恢复.py:311` ； `.github/workflows/检查.yml:42-52` | D1 门禁 | 用例红：`AssertionError: Regex pattern did not match … Actual message: '当前程序、资源或配置不一致，须先核对安装产物'` ；探针实测 `运行代码哈希()=3b2f775f…` ≠ 清单 `代码哈希=11bc9044…` ， `src/muse/资源/清单.json` 构建于 18:46、HEAD 提交于 19:09 | 根因是本地资源包（ `.gitignore:36` ）早于当前 HEAD： `make 构建` 重建资源包复核；同时给 `检查.yml` 的"离线测试"步补构建步骤，否则全新检出下 `加载清单()` 直接抛 `资源缺失错误` （同一用例的登记环境为"离线/已知发布构建"，见 `tests/用例清单.json:13732-13741` ） `make 构建` 会重写 web/dist、接口生成物与索引）
| **JC-02** （并入 DR-11） `.github/workflows/检查.yml:59` ； `src/muse/基础设施/宿主/Pi.py:28` ； `tests/集成/test_受控模型调用.py:717` | D7 一致性 | CI 钉 `@earendil-works/pi-coding-agent@0.84.4` ，而代码按 `包["version"] != self.固定版本` 精确比对、测试构造 `Pi宿主(..., "0.85.1")` ； `README.md:28` 、`docs/系统架构/新版设计/模块设计/S02-任务运行.md:56` 均写 0.85.1 | 统一为 0.85.1（改 CI 钉版本或改代码/文档，只能二选一）；本轮未执行宿主测试，结论由三处静态证据推断 | 需用户授权（改 CI 或改版本口径） |
| **JS-01** | 后端-审校效果评测 | `src/muse/审校修订/内置规则/密度/d001.yaml:30` （另有 15 处同文：密度 d002-d006、词汇 l005/l006、结构 s002-s007、语义 sem002/sem003 各自 `evidence:` 行） | D2 | `2026-08-16 所有者决定跳过 holdout 直接激活（激活门豁免，留痕供审计）` 。仓内工作树零留痕（全仓 grep `2026-08-16` /`激活门豁免` 非规则文件命中 0） ； ： `机器味规则.py:133-134` 强制安装包规则必须 `candidate` 、`:145-147` 无条件抛"缺少B10逐例评测和正式批准"， `规则启用.py:163-170` 启用必须持 B10 规则诊断凭据。留痕只在**已退出工作树**的旧 `humanization/` v0 库（ `476bb71` ，其 README 写明这 16 条 holdout 是"欠账…必须补齐"），而新版规则文本把"欠账"限定删掉了 | 二选一：删掉"（激活门豁免，留痕供审计）"括注，或改写为可核路径并保留欠账限定（例：`依据 git 476bb71 旧 humanization v0 库豁免；新版 holdout 仍欠账` ）；同时把豁免是否延续写进 B06 文档 `规则候选与只读诊断合同` 节 | 需用户授权 |
## P1（
| 编号 | 模块 | 位置 | 方向 | 现状摘录 | 建议 | 所需授权 |
|---|---|---|---|---|---|---|
| **AG-07** （并入 DR-13） `.agent/规范/目录.md:1-5` ；计划 D4/D5 | D4 | 「审查标准（提示词 4 问、技能 7 问、D8 复利审查规程）」原文在 `.agent/规范/` 、`.agent/rules/` 与设计文档中均无对应文件；计划只能用附录 A/B 作替代口径。 | 把本计划附录 A/B 与 D8 规程转正为 `.agent/规范/审查标准.md` ，并在 `.agent/规范/目录.md` 登记 | 需用户授权 |
| **AG-10** | agent层 | `工具/资源登记.json` （ `能力文件` 22 条）；`.agent/skills/操作/写下一章/SKILL.md:2` 、`.agent/skills/操作/核对内容一致性/SKILL.md:2` | D4 | 资源登记含 22 个 `.agent/skills/操作/*/SKILL.md` ； `写下一章` 、`核对内容一致性` 声明了完整能力身份（`id: write-next-chapter` 、`id: check-consistency` ）却未登记；另 9 个操作技能（导入资料、拆解书稿、检查与维护拆书结果、采集资料与榜单、维护故事世界、确认事实增量、整理写作方法 等）无 `id/category/contract_version` ，按 `src/muse/资源加载.py:40-55` 无法通过能力声明校验。 | 明确"能力化技能"清单：要么补齐 9 个技能的能力 frontmatter， `id` 并成文"方法/工具技能不打包" | 需用户授权 |
| **AG-05** | agent层 | `.agent/rules/正式变更.md:3` 、`.agent/rules/任务与证据.md:3` 、`.agent/rules/审校与修订.md:3` 、`.agent/规范/中文正文与界面.md:3` | D4 | 四份规则各自点名机械门禁：`tests/架构/test_正式写入入口.py` （ `tests/集成/test_取消恢复与未知调用.py` 、`tests/单元/test_正文格式与选段.py` （两处引用）——三个文件均不存在。 | 改指真实门禁（如 `tests/集成/test_正式提交原子性.py` 、`tests/集成/test_任务租约与恢复.py` 、`tests/单元/test_审校覆盖.py` ），或回填被点名文件 | 需用户授权 |
| **AG-06** | agent层 | `.agent/目录.md:3,4,5` ； `AGENTS.md` §3 同源 | D4 | 索引描述列点名「执行流程」「红线」「审查标准」「指令集」「去 AI 味道」，五项在 `.agent/` 均无对应文件（`.agent/rules/` 9 个、`.agent/约束/` 3 个、`.agent/规范/` 3 个） `.agent/rules/模块依赖.md` 、`.agent/约束/作者主权.md` 、`.agent/rules/文档与资源生成.md` ）。 | 回填缺失文件，或改写索引与 AGENTS.md 的文字使其与物理文件同名 | 需用户授权 |
| **AG-02** | agent层 | `.agent/角色/角色合同.md:6,13,20,27,34` （ `promptFile` ）与 `:43` | D5/D2 | frontmatter 五个 `promptFile: .agent/agents/{writer,planner,extractor,detector,judge}.md` ；正文称「`.agent/agents/*.md` 保存 Agent-facing 的身份、Skill 路由与工作方法」。`.agent/agents/` 不存在；真实文件为 `.agent/角色/{写手,规划员,知识抽取员,检测员,评委}.md` （ `tests/架构/test_模块依赖.py:406` 亦按此路径断言），且五份提示词实测**不含任何 Skill 路由**。 | `promptFile` 改为 `.agent/角色/<中文名>.md` ；删去"Skill 路由"或把路由回填进提示词 | 需用户授权 |
| **AG-03** | agent层 | `.agent/角色/角色合同.md:7-8,14-15,21-22,28-29,35-36,45,103` | D5 | 合同：`modelPolicy: fixed-opus｜ ｜ 、`modelPolicyVersion: fixed-opus-v1｜ ｜ 、`toolPolicy: task-spec-allowlist` ；并自称「本文件是模型策略的事实源；执行侧的常量与校验是该事实的镜像，两者不一致即为缺陷」。执行侧 `配置/角色策略.yaml:1` 是 `version: role-policy-r2-v2` ，策略名为 `fixed｜ ｜ ，工具面为 `readonly_tools` ；上述 5 个策略名/版本串与 `task-spec-allowlist` 在 `src/` 、`配置/` 、`tests/` 全零命中。白名单成员（`deepseek-v4.1-flash` 、`muse-spark-1.3-contributor` ）与实现一致。 | 把契约改为显式引用 `配置/角色策略.yaml` 并同步策略名与版本号，或把 `modelPolicyVersion` /`toolPolicy` 登记进配置由校验读取 | 需用户授权 |
| **AG-09** | agent层 | `.agent/作者/场景/写下一章.md:10-11` 、`.agent/作者/场景/查作品.md:12` | D5/D2 | 「正式技能」章节把实现模块登记为技能：`[准备任务上下文](../../../src/muse/上下文/材料装配.py)` 、`[固定任务上下文](../../../src/muse/上下文/冻结快照.py)` 、`[分析质量短板](../../../src/muse/作者经验/改进提案.py)` ；三者不在任何技能目录，"分析质量短板"全仓无同名技能或入口。 | 该章改为"实现模块"表述并另给真实技能指针（核对内容一致性/评估内容质量），或补齐同名技能 | 需用户授权 |
| **AG-12** | agent层 | `.agent/rules/计划与提交.md:31,33` | D4 | 两处链接 `../../../.agents/rules/verification-principles.md` ：目标落在**仓外**父仓 `/oh-my-muse/.agents/rules/` （本机存在，`git ls-files` 零命中） ，
| **AG-04** | agent层 | `.agent/角色/角色合同.md:49` | D2 | 「两阶段…派发实现见 `写下一章/scripts/two_phase_writer.py` 」。该路径不存在，`.agent/skills/` 下无任何 `scripts/` 目录；`.agent/rules/模块依赖.md:8` 明令「技能不携带实现…禁止在技能目录放可执行脚本」。 | 改指真实实现（`src/muse/正文写作/` ， `tests/集成/test_两阶段写手.py` 为证）或删除该句 | 需用户授权 |
| **AG-08** | agent层 | `.agent/skills/规划/提炼故事概念/SKILL.md:92-93` 等 15 处（规划 6、写作 8、诊断 1） `## 复利合同` 逐字相同：「本 Skill 的选型判断指导后续 `制定作品规划` / `准备任务上下文` 的范式绑定」；`审核知识卡` → 用户确认（批次 3） `制定作品规划` 、`准备任务上下文` 、`审核知识卡` 均不在 46 个技能中；`准备任务上下文` 仅在 `.agent/作者/场景/写下一章.md:10` 作为指向 `src/muse/上下文/材料装配.py` 的链接文字出现。 | 改写为真实目标（如 `确认规划候选` 、`写下一章` 、`整理写作方法` ），或删除该段 | 需用户授权 |
| **DR-09** | docs与根文件 | 目标文件清单.json（ `.agent/skills/方法/` 171 条）、文件设计/执行知识-方法技能.md（ `docs/系统架构/新版设计/目标文件清单.json` 把 `.agent/skills/方法/` 写作技能分类；物理树只有 `诊断/规划/操作/写作` 四个分类目录。1432 条目标条目中 **279 条物理不存在，其中 171 条属 `.agent/skills/方法/`** ； `呈现人物` →写作、`增强叙事动力` →规划、`诊断作品问题` →诊断 …），`build` 后按图索骥必 404。该 JSON 是 `执行知识-方法技能.md` 等文件设计页的投影源（页首自述「本页从目标文件清单.json 投影」） | 分类目录改名对齐物理树（`方法` →按实际的 `写作` /`规划` /`诊断` 拆分），并重跑 `工具/维护索引.py` ；同时确认 `执行知识-操作技能.md` 中 4 个物理不存在的技能名（`制定作品规划` 、`合并故事方案` 、`规划下一章` 等）是待建还是废弃 | 需用户授权 |
| **DR-26** | docs与根文件 | docs/系统架构/新版设计/技能承接表.md:3； （ `skills.json` 幻路径不只在 AGENTS.md， ： `技能承接表.md:3` 「以当前 **skills.json** 登记的 **59 个技能**为输入，逐项定义新版位置」；`技能身份中文化与作者创作入口.md:20`「正式技能 ｜ ； `:85,:320,:321,:323` 另引 `muse/sot/domains/05-创作流程领域.md` 、`07-Agent与Skill领域.md` 、`muse/技能目录.md` ，均不存在 | 把 manifest 基准从 `skills.json` 改为 `.agent/skills/目录.md` （技能目录）+ `工具/维护索引.py --检查` （已能核索引与磁盘一一对应）；`:338` 的验收条款按新基准改写；`59` 统一改 `46` | 需用户授权 |
| **DR-20** | docs与根文件 | docs/目录.md:4,5,6,9,10,15-19、docs/根 8 个 `2026-*.md` | D4 | 索引与实体三处脱节：① `docs/目录.md:4,5,6,9,10` 把「领域模型 / 数据模型 / 模块设计 / 业务需求 / 调用链路」的相对地址标为 ** `暂无` **，但这 5 个主题在 `docs/系统架构/新版设计/` 下真实存在（分别 2 / 6 / 15 / 2 / 2 篇 .md） ； `2026-09-01-*` ，漏掉同目录另外 **7 篇** `2026-*` ；③ `acceptance` /`design` /`plans` /`research` /`write-chapter` 五行（:15-19） ， `内容描述` /`使用场景` /`使用要求` 三列**全空**。这 5 个目录 + 7 个文档既不在计划第 4 节「docs 权威区」，也不在「实现回顾 留痕」豁免面内，属口径缺口 | 五行「暂无」改为指向 `系统架构/新版设计/<主题>/目录.md` 的真实相对地址；补登 7 篇 `2026-*` 并统一标注「R2 期历史执行记录，表述不复查」；补全 5 行的三列描述。这样口径缺口一并闭合 | 需用户授权 |
| **DR-27** | docs与根文件 | docs/系统架构/新版设计/研究依据/选型比较/比较约束.md:7 | D4 | `- 功能比较基准：` docs/业务需求/小说创作共性功能清单.md`， —— `docs/业务需求/` 目录不存在，`docs/系统架构/新版设计/业务需求/` 下只有 `目标系统完整功能清单.md` 与 `目录.md` 。同行虽有「原本地草稿已移走」的弱标注，但**未给出替代路径**，而该行自称「功能比较基准」（下游比较的依据） | 把基准指到实际存在的 `docs/系统架构/新版设计/业务需求/目标系统完整功能清单.md` ，
| **DR-25** | docs与根文件 | AGENTS.md:13 vs docs/运行手册.md:10、配置/本机正式.toml:2 | D7 | 同一「正式内容库」两套库名： （ `muse-example` 库）是系统正式内容的唯一权威」；运行手册:10「infra（ `100.64.0.8:5433` ） `muse_migration_1fe755ea37684f9d926f3a0cb3e9c7f2` 」，`配置/本机正式.toml:2` （ `muse-example` 仅 AGENTS.md:13 一处命中 | 以实际部署为准统一：把 AGENTS.md:13 的库名改成 `muse_migration_1fe755ea37684f9d926f3a0cb3e9c7f2` （或改为不写死库名，指向运行手册与 `配置/本机正式.toml` ）。另注：运行手册:10 把内网地址 `100.64.0.8:5433` 写进 Git 跟踪文档，
| **DR-07** | docs与根文件 | AGENTS.md:14,50,51,54,55,57,58,60,61(× （ ： `muse/authority/db/表映射.md` →`数据模型/存储与对象关系.md` ； `muse/sot/domains/` →`阅读指南.md` ； `muse/sot/边界合同.md` →`总体架构.md` ； `muse/sot/创作周期与Skill导读.md` →`调用链路/关键旅程.md` ； `muse/技能目录.md` →`.agent/skills/目录.md` ； `.agent/约束/红线约束.md` →`.agent/约束/作者主权.md` ； `.agent/rules/执行流程.md` →`.agent/rules/模块依赖.md` ； `.agent/规范/审查标准.md` →`.agent/rules/文档与资源生成.md` ； `去AI味道工程规范.md` →`审校与修订.md` 、`指令集规范.md` →`命名.md` 、`术语规范.md` →`术语.md` ） （
| **DR-08** | docs与根文件 | docs/功能规格/阶段0交互式作品探索.md:31 | D4 | `[\u2026](../../muse/lifecycle/flow/skills/book/完善故事基础设定/references/candidate-contract.md)` —— `docs/功能规格/` 属计划第 4 节明列的 docs 权威区，该相对链接目标不存在（`muse/…` 旧实现路径） | 改指现行落点（`.agent/skills/操作/完善故事基础设定/` ），或标注为 R2 期历史方案并归入留痕 | 需用户授权 |
| **DR-10** （并入 JW-04） ` ｜ ｜ ｜ src/muse/作者经验/提示词/` 目录本身不存在（` ls` No such file or directory） ： ； （
| **DR-02** （并入 JK-07） `｜ ｜ muse/content/meta/schemas/`（原路径…已随旧实现退出，见固定基线） ｜ ｜ ； `ls muse/content/meta/schemas` 与 `src/muse/content/meta/schemas` 均 No such file or directory。同一路径在 `:15` （ `muse/content/meta/schemas/` 、文档和 DDL 的权威」）**裸引、无「已退出」标注**——同文件对同一路径两套写法 | 路径改指现行物理位置 `src/muse/元数据/内置结构/` ； （ `读取内置种子()` 返回 24 个 `builtin:<type>:1` ，目录内 25 个 yaml 含 `公共字段.yaml` ） ； `:15` 与 `:53` 的标注口径统一 | 需用户授权 |
| **DR-03** | docs与根文件 | AGENTS.md:56 | D4 | `｜ ｜ muse/lifecycle/flow/chains/`（原路径…已随旧实现退出，见固定基线） ｜ ｜ ；该目录及其 `src/` 同名路径均不存在 | 改指现行落点 `src/muse/编排/流程登记.py` 、`流程版本.py` 、`槽位约束.py` （ `流程登记.py:45` 登记「必需保护」） | 需用户授权 |
| **DR-12** | docs与根文件 | pyproject.toml:60-65 | D7 | `markers` 只声明 `数据库` /`网络` /`真实模型` /`浏览器` 4 个。实测：`网络` 在 `tests/**/*.py` 中 **0 个文件**使用（多余）；`宿主` 在 2 个文件使用（`tests/集成/test_受控模型调用.py:528-529` 等）却**未声明** （缺失），靠 `tests/conftest.py:27,50` 运行时 `addinivalue_line` 补登记；`Makefile:49,54,60-62` 也直接用 `-m 宿主` | `pyproject.toml` markers 删 `网络` 、补 `宿主` ；或明确「标记以 conftest 为权威」并把 pyproject 的 4 条改为注释。当前未红是因为 conftest 兜底 | 需用户授权 |
| **DR-06** | docs与根文件 | AGENTS.md:69、.gitignore:32-34 | D4 | AGENTS.md:69「新版工程统一使用仓内解释器 `.venv` （ `.venv-旧` ）」；`ls -d .venv-旧` → No such file or directory。.gitignore:33 同源注释「旧代码运行环境在 .venv-旧（旧入口保持可运行）」 | 两处一并删去 `.venv-旧` 表述（
| **WB-02** | web | `web/tests/旅程/资料对照.spec.ts:7` （登记见 `tests/用例清单.json` ）、`世界维护.spec.ts:7` 、`方法库.spec.ts:7` 、`单元/中文显示与动作.test.tsx:30` | D7 | 清单登记 `case_id: "NC-w17-browser"` ，文件内用例名却是 `test("NC-browser-source-workbench： ；设计文档 `前端-应用与通用界面.md:787` 引用的是清单 id `NC-w17-browser` 、`NC-w18-browser` | 以文件内 symbol 为准回填清单 `case_id` ，并同步 `前端-应用与通用界面.md:787,797,807` 的引用（同 `NC-w19` /`NC-w20` /`TC-00f820aca9ee-动作` 共 5 条） | 需用户授权（与 tests 模块共担） |
| **WB-01** | web | `web/src/功能/创作对话/数据.ts:16` | D1 | `export const 粒度标签: Record<string, string> = {` / `new_chapter: "新章", expand_scene: "扩写", edit_selection: "选段修改",` —— 在 `src` + `tests` 全量 grep 仅命中定义行本身，零消费者 | 删除该常量；若确为待接入位，改为在 `作者动作` 里实际渲染粒度 | 需用户授权 |
| **JF-01** | 后端-交付连载上下文资料 | src/muse/交付连载/提示词/全书审阅.md:1、src/muse/交付连载/提示词/整理交付材料.md:1 | D3 | 两模板已登记并打包（工具/资源登记.json:200,204； ） ， `src/` 、`tests/` 、`.agent/` 全仓零引用；`配置/流程模板/` 11 个流程中唯一交付流程是 `定稿交付.yaml` （ `model_calls: 0` ， ）
| **JF-03** | 后端-交付连载上下文资料 | src/muse/资料研究/提示词/核对实体歧义.md:4； ；
| **JF-04** | 后端-交付连载上下文资料 | src/muse/资料研究/榜单快照.py:62 | D6 D7 | `"captured_at": 时刻.isoformat() + f"+{sha256(...)[:8]}"` ；实测得 `2026-09-16T12:37:00.121045+00:00+ae27547f` ， `datetime.fromisoformat` 抛 ValueError。库内真实时刻是 V0007__资料研究.sql:58 的 `clock_timestamp()` ， `列出快照` （存储.py:262） ； `capture_ranking` 输出"带采集时刻及质量状态的快照"。 | 直接返回 `时刻.isoformat()` （或回读库内 `captured_at` ）；若哈希确有用途，另立字段名并写进接口契约。 | 无需授权 |
| **JF-05** | 后端-交付连载上下文资料 | src/muse/上下文/索引维护.py:96； ； `.agent` 文本检索）且未进各域 `接口.py` 的 `__all__` ： `文档关键词检索` 、`待重试窗口` 、`基准引用` 、`归并哈希` ；重跑窗逻辑实际由 编排/研究拆书.py:149-150 自行实现。 | 删除或接入真实消费者；删除时同步清各文件 `__all__` 。 | 无需授权 |
| **JT-02** | 后端-任务运行编排 | `src/muse/基础设施/模型/角色探针.py:92` （旁路点）；`src/muse/任务运行/配置版本.py:277` （生产强制 runtime 验证） | D6/D7 | `结果: 模型结果 = asyncio.run(self._宿主(提供方, 凭据).准备(请求).调用())` —— 逐角色真实外发，不走 `模型执行器` ：无 `预算管理.预留/标记已发送/结算` ，无 `muse_runtime_evidence` ，无 `调用发出` 事件；而 `if self.数据库.用途 is 用途.生产 and 证据.模式 != "runtime": raise` 强制生产配置必须持有 runtime 证据。等于每次启用生产配置都会产生一笔**不入 5 小时窗口账本、不留运行留痕**的真实费用 | 探针调用纳入预算账本与留痕（或为其登记独立的探针账户与窗口），并在 S02 文档写明探针费用的记账口径；本项主责在基础设施组，任务运行组需配合提供记账接口 | 需用户授权 |
| **JT-03** （并入 JS-03、JW-02、JF-02） `src/muse/编排/生成规划.py:147` | D1/D7 | `模板 = (Path(__file__).resolve().parents[1] / "作品规划/提示词" / 模板名).read_text()` —— 规划提示词从源树直读；该文件在 `运行资源.zip` 的 85 个条目中不存在（ `规划/` 只有 `探索交付结构.json` ）。同包其它旅程都走发布包：`生成正文.py:342` `生成正文模板()` → `打开资源("正文/生成正文.md")` 、`审校修订.py:216` `修订模板(auth)` → `打开资源(...)` 。结果是该提示词不受资源发布身份/清单哈希约束，只在检查点留运行时 `模板哈希` | 把两个规划提示词登记进 `工具/资源登记.json` → `运行资源.zip` ， `模型规划` 改用 `打开资源` ；与审校组 JS-03（ `审校修订/完整审校.py:20` 同类直读）一并处理 | 需用户授权 |
| **JT-04** | 后端-任务运行编排 | `src/muse/编排/章后处理.py:153-154` 、`src/muse/编排/研究拆书.py:136-137` | D1 | `except 预算状态冲突: pass # 恢复重试时包络已登记且哈希一致；不一致会被上一步骤拒绝。` —— 没有"上一步骤"做这件事：抛错的正是 `登记任务预算于` 自己（`预算管理.py:215-216` ，既有 `plan_hash` 不等即抛）。因此同一任务重算包络不一致（例如包络公式随部署变化）会被静默吞掉并继续用旧包络，注释断言与实现相反 | 改为只吞"哈希一致"的重复登记（先读既有哈希比对再决定忽略），不一致时照常抛；同步删掉不成立的注释 | 需用户授权 |
| **JT-01** | 后端-任务运行编排 | `src/muse/任务运行/接口.py:503` （对账入口）；`src/muse/任务运行/恢复控制.py:32-33` （前置条件） | D3/D7 | `def 对账调用(...)` 只在 `接口.py` 定义与 tests 中被调用；`src/muse/接入` 全目录 grep `对账` /`reconcil` 命中 0， `operation_id` 里没有对账端点， `if 存储.未知调用(任务ID): raise 状态冲突("调用结果未知，必须先对账再恢复")` 。后果：任何在"标记发送事务提交后、响应证据落库前"中断的调用会把任务锁进 `reconciling` ， （ ， ） ， `对账调用` 明确标注为"仅运维/测试可达、产品面暂不可达"并同步 Web 按钮可用状态 | 需用户授权 |
| **JW-01** | 后端-写手规划经验 | src/muse/正文写作/提示词/生成正文.md:25 | D2 | "每段是完整段落文本，不含换行符；段内换行由系统处理。" 实测：`写作输出合同` 不禁止段内换行（探针 1 通过 schema 校验），`模型.py:22-23` 的 `文本节点` 直接抛"段内换行必须使用显式换行节点"； `编排/生成正文.py:422-426` 无归一，`任务运行/模型调用.py:49-66` 只做 JSON Schema 校验 | 删除"段内换行由系统处理"，或在 `生成正文.py:422` 前按 `选段编辑._新文本` 同法拆成显式换行节点 | 需用户授权 |
| **JW-03** | 后端-写手规划经验 | src/muse/正文写作/正式提交.py:96-105 | D1 | B05 用裸 SQL `SELECT verdict FROM muse_review_report WHERE candidate_id=%s AND candidate_revision=%s` 直读 B06 私表，违反 `docs/系统架构/新版设计/总体架构.md:59` "跨业务调用只穿过接口.py 暴露的合同；存储、内部对象和私有函数不跨模块使用"； `审校服务.读取报告` ，同法见 `src/muse/作者经验/运行观察.py:80` ）
| **JC-11** | 后端-基础设施共享 | `配置/提供方.example.toml:4` | D7 模板过期 | 模板写 `"角色策略版本" = "role-policy-r2-v1"` ，权威 `配置/角色策略.yaml:1` 为 `role-policy-r2-v2` ； `角色探针.py:63` 会以"与当前发布包不一致"拒绝按模板生成的配置 | 模板升到 `role-policy-r2-v2` ；模板值应与发布的 `角色策略.yaml` 同步（或改为占位符并注明取值来源） | 本批修复候选 |
| **JC-06** | 后端-基础设施共享 | `src/muse/基础设施/资料来源/网页读取.py:10-13` 、`榜单读取.py:10-13` | D3 孤儿入口 | 两个 Protocol 在 `src` 、`tests` 、`工具` 、`数据库` 零引用；`src/muse/资料研究/榜单快照.py:17-20` 另有一个同形 `榜单读取器` Protocol 承接了真实消费 | 二选一：删 `资料来源/` 两个协议，或让 `资料研究` 改为依赖基础设施协议（避免两套同义抽象） | 本批修复候选 |
| **JC-08** | 后端-基础设施共享 | `src/muse/共享/标识.py:11-14` | D3 死代码 | `作品标识` 、`命令标识` 、`审阅版本标识` 除本文件与 `共享/__init__.py` 的再导出外零引用（仅 `任务标识` 有消费者） | 删除三个 NewType 与对应再导出；未来需要时再按真实调用点引入 | 本批修复候选 |
| **JC-04** | 后端-基础设施共享 | `src/muse/基础设施/模型/ChatCompletions.py:19-25` ； `src/muse/基础设施/模型/Messages.py:20-31` | D1 错误合同 | 探针：`usage={"prompt_tokens":1}` → 裸 `KeyError: 'completion_tokens'` ； `index` /缺 `delta.type` → 裸 `KeyError: 0` /`'type'` 。同族 `Responses.py:47-53` 统一转 `模型协议错误` | 三个协议解析器统一把缺字段/坏帧转成 `模型协议错误` （上层 `任务运行/模型调用.py:367` 只按该类型分流） | 本批修复候选 |
| **JC-09** | 后端-基础设施共享 | `docs/系统架构/新版设计/文件设计/后端-基础设施.md:36,214,215` ； `src/muse/基础设施/模型/嵌入.py:3` | D2/D7 口径对立 | 设计文档写 `向量.py # pgvector 查询实现` 、职责"pgvector 查询实现"，而 `嵌入.py:3` 写"裁决 A： ， `检索/向量.py` 实际是纯 Python 余弦；"裁决 A"在 `docs/` 内查无出处 | 统一口径：更新 `后端-基础设施.md` 的 向量.py 条目（改述为纯函数余弦/或标注裁决变更），并把"裁决 A"落到可检索的裁决记录 | 需用户授权（改设计文档） |
| **JC-07** | 后端-基础设施共享 | `src/muse/共享/时间.py:51,58` | D3 死代码 | `截止于` 、`单调秒` 全仓零消费者；实际调用方直接 `from time import monotonic` （ `任务运行/步骤执行.py:8,51` 、`接入/http/应用.py:5,80,89` ），期限也各自 `+ timedelta(...)` （如 `效果评测/逐例执行.py:136` ）
| **JC-05** | 后端-基础设施共享 | `src/muse/基础设施/数据库/连接.py:92-96` | D3 孤儿入口 | `连接范围()` 全仓零消费者（含测试），实现只是 `with 连接(...) as 连: yield 连` 的一层转发 | 删除，或改为在调用方直接使用 `数据库工厂.连接` ；保留则需给出消费者 | 本批修复候选 |
| **JC-03** | 后端-基础设施共享 | `src/muse/配置.py:167-175` | D1 校验断裂 | `原文暂存 = ""` 被静默解析为**配置文件所在目录**、`探索草稿 = " "` 被解析为带空格的目录；同一函数对 `备份目录` 有显式非空校验（`:171-173` 抛"文件.备份目录需要明确路径"） `strip()` 校验，空串直接 `配置错误` | 本批修复候选 |
| **JC-10** | 后端-基础设施共享 | `docs/系统架构/新版设计/目标文件清单.json:8856` ； `后端-基础设施.md:32,287` ； `工具/维护索引.py:246-264` | D3/D7 门禁盲区 | 清单与设计文档登记 `src/muse/基础设施/文件保留.py` ，仓内不存在该文件；`维护索引.py --检查` 只核对设计文档锚点存在，不核对目标文件是否存在，实测退出 0（ ） `检查文件定位` ，让门禁能发现同类悬空目标 | 需用户授权（改清单/门禁） |
| **JS-05** | 后端-审校效果评测 | `src/muse/审校修订/提示词/诊断机器味.md` 、`src/muse/审校修订/提示词/提取作品声音.md` | D3 | 两个提示词文件既无加载点（全仓无 `诊断机器味.md` /`提取作品声音.md` 的资源路径引用），也未登记发布资源（`工具/资源登记.json` 无条目、`运行资源.zip` 内不存在）。对应能力已由确定性代码实现：`诊断服务.生成诊断` →`机器味诊断.诊断文本` 纯规则、`声音基线.统计声音样本` 纯统计 | 删除两个孤儿提示词并同步 B06 文档:59-60，
| **JS-07** | 后端-审校效果评测 | `src/muse/审校修订/诊断服务.py:26-32` + `src/muse/审校修订/机器味诊断.py:436` | D1 | 无任何激活记录时 `读取诊断规则` 返回空库 `核对规则库([], [])` ；生产诊断（`预览候选=False` ）随即产出 `mode:"active"` 、`coverage.deterministic:[[0,全文长度]]` 、`executed_rules: []` 、`unreviewed_rules: []` 、`findings: []` 。下游无法区分"扫了全文、零命中"与"一条规则都没启用"（实测见证据指针 P3） `active_rule_count` /`empty_library` （或 `coverage.rules_executed` ）标记；或在空库时拒绝出具 `active` 报告 | 需用户授权 |
| **JS-02** | 后端-审校效果评测 | `src/muse/审校修订/内置规则/密度/d002.yaml:31` （另有 12 处： ） `129 条研究目录 D-01 机制候选` ／ `D-07` ／ `L-14` ／ `P-11` ／ `N-05` ／ `S-11` …。该目录真实存在过（旧 `humanization/research/20-project-humanization-rule-catalog.zh-CN.md` ，自述"目录规模： `git 476bb71:humanization/research/...` 或标注"依据已随旧实现退出"）；同批处理 d001/s002 的"20 项开源研究机制候选" | 需用户授权 |
| **JS-09** | 后端-审校效果评测 | `docs/系统架构/新版设计/模块设计/B06-审校修订.md:37-61` 、`B10-效果评测.md:32-47` | D7 | 内部职责表与物理文件不一致： ， `诊断服务.py` /`案例规则.py` /`模型修订.py` /`离线回放.py` ； ， `启用凭据.py` /`工作面.py` /`文学执行.py` /`文学评分.py` /`方法对照.py` /`条件第三.py` /`标定.py` /`标定消费.py` /`混淆项.py` /`角色行为.py` /`语义检测.py` ，也未列 `提示词/文学评分.md` | 补齐两表，或在表上显式标注"节选，完整清单见目标文件清单" | 需用户授权 |
| **JS-06** | 后端-审校效果评测 | `src/muse/审校修订/规则例证/regression.yaml:52` 、`:81` | D3 | `reg-004` 、`reg-006` 两条例证 `rules: []` ，不被任何规则 `samples` 引用。实测：规则库 107 条例证中仅 105 条被引用（`读取内置规则` 只对引用到的例证做合同核验，这两条既不校验也不消费，却计入 `fingerprint` ）
| **JS-10** | 后端-审校效果评测 | `src/muse/效果评测/混淆项.py:224` 、`:227` | D1 | 判定 `panel["status"] == "unstable"` 并把它列入可收尾状态，但生产者 `文学评分._仲裁文学评分` 只会返回 `stable_report` /`adjudicated_report` /`needs_third_reviewer` /`invalid_unstable` /`invalid_report` ，从不产出 `"unstable"` | 改为 `invalid_unstable` ，或删掉该分支并让 `invalid_report` /`invalid_unstable` 明确计入 `incomplete` | 需用户授权 |
| **JS-08** | 后端-审校效果评测 | `src/muse/审校修订/接口.py:374` （ `import _核验, _读提案` ）、`模型修订.py:13` （ `import _准备` ）、`持久返修.py:360` （ `存储._要求返修会话` ） ； `src/muse/效果评测/接口.py:587` （ `import _数据库身份` ）、`逐例执行.py:188` 与 `:540` （ `import _要求数据集` ） `:33` 、B10 文档 `:28` 的"外部不导入私有模型或 SQL"声明不符 | 把被跨模块使用的私有名提升为公开名（去下划线）或下沉到同模块；若是有意例外，在文档写清例外范围 | 需用户授权 |
| **JS-04** | 后端-审校效果评测 | `src/muse/审校修订/持久返修.py:757` （导出：`接口.py:542` ；文档：`B06-审校修订.md:30` ） `def 读取返修比较来源(...)` 是 B06 文档列明的公开用例，但全仓零调用方（精确匹配只命中定义行与 `接口.py` 的 import/`__all__` 两处） `读取返修比较来源于` （ `效果评测/返修比较.py:19,117` ） `读取返修比较来源于` ，或让 B10 改经它调用 | 需用户授权 |
| **JR-05** | 后端-接入 | `src/muse/接入/cli/入口.py:4` | D2/D7 | 模块 docstring： `已实现子命令：自检、迁移（显式维护命令，不在启动时自动执行）。` ；而 `_解析参数` （ `:25-277` ）实际注册 **19** 个子命令（数据维护/行为评测/评测/经验/自检/交付/迁移/服务/任务/创作/审校/研究/结构/作品/审阅/探索/规划/配置/管理） | 改为"子命令清单以 `--help` 为准（当前 19 个）"或直接列举；同文件 `:5` 的"不返回伪成功"实测成立，可保留 | 无需授权 |
| **JR-04** | 后端-接入 | `src/muse/接入/执行器.py:8-34` ；唯一调用点 `tests/集成/test_任务租约与恢复.py:426` ；对照 `后端-装配与接入.md:489-496` | D3/D7 | 设计文档把该文件写成"后台进程入口、用途装配和优雅停机"，实测生产代码零消费者：全仓 `接入.执行器` 只命中那条测试；`cli/入口.py:508-519` 的 `服务` 只起 uvicorn， `工具/` /`配置/` 无任何 worker 启动目标。仓内不存在文档声明的后台入口 | 二选一：补真实后台领取入口（发布目录脚本或 `python -m muse` 子命令）并接线；或把文档改为"预留的领取循环实现，当前仅测试可达"并把它定位为测试夹具 | 需用户授权（新增入口或改文档口径） |
| **JR-06** | 后端-接入 | `cli/创作命令.py:14-22,61-62` ； `http/路由/创作生成.py:22,109-110` ； `http/路由/作品规划.py:42-61` ； `http/路由/正文写作.py:127-149` ；对照 `后端-装配与接入.md:374,396` | D7/D1 | 设计文档要求"命令与 HTTP 用例保持相同结果与拒绝条件"。实测三处不一致：① 读候选审校报告缺报告时， `raise 配置错误(f"候选 {目标} 版本 {当前版本} 没有审校报告")` ， `raise HTTPException(404, "该候选版本没有审校报告")` ；② 发起生成正文（`发起生成正文` 同一用例） `budget` （ `创作生成.py:22` ） ， `生成发起请求` 没有（`创作命令.py:14-22` ）；③ HTTP 有 `POST /works/{id}/planning-tasks` 与 `POST /chapters/{id}/post-derivations` ， `入口.py:214-230,247-260` ）无对应动作 | 请求模型抽一份放 `接入/创作操作.py` （照 `审校操作.py` 的做法，两侧共用）；报告缺失统一走带 `NOT_FOUND` 的错误；
| **JR-03** | 后端-接入 | `src/muse/接入/http/路由/上下文.py:57-65` （对照 `src/muse/上下文/依赖校验.py:202,211-216,236-241,255-256` 、`src/muse/上下文/任务范围.py:292,296,315` ） `current_state` 只分三档：`状态.有效` →全"有效"；来源等于细纲或文稿→查 `锁定身份` ； `else: 当前 = "有效" if 事实锁定 else "SOURCE_STALE"` （注释写"事实对象没有逐对象锁定"）。但 `来源绑定` 还含 voice/preference/method 三类（偏好 id、声音 version_id、方法 binding_id） ， `f"{作品ID}:事实系统"` 用 `事实锁定` ，其余来源一律用 `绑定.来源ID in 锁定身份` ；补一条含 voice/method 绑定的断言用例 | 无需授权 |
| **JR-01** | 后端-接入 | `src/muse/接入/http/路由/资料研究.py:92-95` ；根因 `src/muse/资料研究/模型.py:14-15` | D1/D7 | `try: return 装配.要求资料().读取版本(连, source_id, revision)` / `except Exception: raise HTTPException(404, "来源版本不存在") from None` 。数据库连接失败、事务错误、代码缺陷都被报成"来源版本不存在"； `后端-装配与接入.md:175` 明写边界「转换已有错误；**不吞异常**、不伪造成功」。根因是 `资料错误` 只有 `错误码 = "SOURCE_INVALID"` （不以 `NOT_FOUND` 结尾），走统一错误壳会落 422， `*_NOT_FOUND` 错误码（该文件第二条同类错误亦同），删除这处 `except Exception` ，统一由 `错误响应.py` 映射 | 需用户授权（跨域改 B03 错误码） |
| **JR-02** | 后端-接入 | `src/muse/接入/http/路由/知识方法.py:247-249` （对照 `作品规划.py:51,78,118` 、`故事世界.py:82,101,112` ） `def 绑定方法(work_id: str, 请求: 方法绑定请求, ...)` 函数体没有 `核对路径(work_id, 请求.work_id)` ，直接 `...绑定方法(..., 请求.command_id, 请求.命令())` ；而 `请求.命令()` （ `:107-110` ）用的是请求体自己的 `self.work_id` 。全层 28 处 `核对路径` 调用 + 2 处等价内联检查（`任务运行.py:104` 、`知识方法.py:206` ），只有这一条写路由完全没有身份核对 | 补 `核对路径(work_id, 请求.work_id)` ，或删掉路径参数改成 `/api/v1/method-bindings` ；二选一但必须与其他写路由统一 | 无需授权 |
| **JK-02** | 后端-知识方法故事世界 | `src/muse/知识方法/提示词/提炼写作方法.md:1` | D3 | 17 个提示词文件中属"完全孤儿"（未登记 `工具/资源登记.json` ， `.py/.yaml/.json` 零引用），`B04-知识方法.md:36` 仍列为模块文件 | 与 JK-01 同一处置：删文件或补消费者 | 需用户授权 |
| **JK-01** | 后端-知识方法故事世界 | `src/muse/故事世界/提示词/抽取章节事实.md:3` | D2 D3 | 「章后派生按本模板语义组装系统提示」；实际抽取提示是 `src/muse/编排/章后处理.py:175-176` 的内联字符串，全仓无任何读取该模板的代码 | 删除该文件并同步 `B02-故事世界.md:36` 的职责表，或让章后抽取改读该模板 | 需用户授权 |
| **JK-05** | 后端-知识方法故事世界 | `src/muse/知识方法/模型.py:24-26` | D1 | `方法结构.effective_schema_hash` 属性恒返回 `""` ，全仓无消费者（`评测材料.py:59,82,120` 读的是元数据 `有效结构` 的同名属性） | 删除该 property | 无需授权 |
| **JK-03** | 后端-知识方法故事世界 | `src/muse/元数据/内置结构/generation_context.yaml:25-105` | D2 D3 | 「严格合同」WriterContext/WriterOutput（ `writer-context-v1` 等）在 `src/` 与 `tests/` 零读取（`内置导入.py:36-50` 只读 `类型/结构/种子身份/原定义哈希/合入公共内容` ）；该结构 `字段: []` ， `type_id` 仅 `tests/契约/test_动态结构投影与版本.py:147` 引用 | 或实现该合同并给出消费者，或删块并把空结构降级为显式说明 | 需用户授权 |
| **JK-04** | 后端-知识方法故事世界 | `src/muse/元数据/模型.py:30` + `src/muse/元数据/字段校验.py:84` | D1 | `引用规则.作品范围` 只被定义与枚举校验（`same_work` / `authorized_source` ），全仓无任何分支读取它；`authorized_source` 无实现，各 owner（ `故事世界/设定修订.py:59` 、`事实提案.py:64` ）一律按 `work_id` 相等判定 | 定为文档则删字段，定为合同则实现 `authorized_source` 判定 | 需用户授权 |
| **JK-06** | 后端-知识方法故事世界 | `src/muse/故事世界/人物关系.py:53-56` | D1 | `try: 结果 = 校验值(结构, 行["content"] or {})` / `except Exception: return 引用对象集` ——静默返回空集：`列出关系` 会输出 `端点: []` ， `设定修订.py:363` 的 `评估修订影响` 会漏报受影响对象 | 只捕获 `元数据错误` ，其余异常失败关闭；或把失败原因显式回传前端 | 无需授权 |
| **JK-08** | 后端-知识方法故事世界 | `src/muse/元数据/内置结构/power_system.yaml:124` | D2 | 「设计发现:2026-07-09《焚忆》立项……（ ） ： `专题-06` 已随 design-docs 退出，`docs/系统架构/新版设计/文件设计/` 下无「后端-04」文件 | 删除该待办，或改指现行文件并转台账 | 无需授权 |
| **TL-05** | 工具 | 工具/生成接口.py:20-21、43-45、46-48 | D6/D1 | `输出 = 仓库根 / 条目["输出"]` 由登记驱动且无越界校验，`输出.parent.mkdir(parents=True, exist_ok=True)` 后直接覆盖写；登记文件缺失时按空登记 `return 0` （ `构建资源包.py:34-35` 对缺 资源登记.json 是 SystemExit） `make 生成` 静默通过并沿用旧合同 | 登记输出路径加包含性校验；登记文件缺失统一改为非零退出 | 需用户授权 |
| **TL-04** | 工具 | 工具/构建资源包.py:108、112 | D6 | `源 = 仓库根 / str(条["源路径"])` 未做包含性校验（同文件 :53 对能力文件有 `文件.is_relative_to(根.resolve())` ） ； `zipfile.ZipInfo(打包路径, date_time=…)` 不校验 `../` 与绝对路径。登记可把仓外文件打进随包发行的 zip， `构建发布.py:73` 却对 wheel 显式排除 `.git/.env/tests` | 按 :53 同源加包含性校验，并规范化打包路径（拒绝绝对路径与 `..` ）
| **TL-03** | 工具 | 工具/资源登记.json:183-193、235； ； `打开资源` 对 `迁移/` 前缀只读目录投影，这 2 条 zip 条目永不可达；`已打包[打包路径]` 在 :116 与 :138 被静默覆盖（对比 :118-119 能力资源有显式查重） | 删除这 2 条直登，或对同名打包路径加「重复即失败」校验 | 需用户授权 |
| **TL-01** | 工具 | 工具/资源登记.json:236-263； ； ； `id: write-next-chapter` 、`commands: [start_writing_task,read_task,read_task_events]` ；另一条 `read_candidate_review_report` ），三条命令均在合同 211 个 operationId 内，却未进「能力文件」；实测 `能力/目录.json` 的 `operation` 仅 22 项、不含二者。唯一相关门禁 `登记能力 = {Path(条目).name ...}` 取到的是 "SKILL.md"， `assert Path(相对).name in 登记能力` 对 `.agent` 技能恒真，检不出漏登记 | 补登这两条能力文件；把 `test_模块依赖.py:332-337` 改为按技能身份/目录名比较，使漏登记可见 | 需用户授权 |
| **TL-02** | 工具 | 工具/资源登记.json:236-263； ； `SKILL.md` 中 22 个无 `id/category/contract_version` 声明： ， `name` +`description` ） `目录: dict = {"role": {}, "method": {}, "operation": {}}` 的 method 桶实测恒为 0 项 | 补声明并登记，或明确「方法技能不进能力目录」后删除 method 死桶 | 需用户授权（跨 .agent 与 工具，可能与 .agent 报告重叠） |
| **LM-05** | 旧库迁移 | docs/系统架构/新版设计/目标文件清单.json | D1/D7 | `PG作品映射.py` 、`PG台账接线.py` 、`转换PG作品.py` 、`转换PG正文.py` 四个文件不在清单内，也没有文件设计逐文件合同小节 | 其余 17 个模块 .py 全部登记（`src/muse` 为 300/300） ， `docs/系统架构/新版设计/文件设计/数据库与迁移.md` 的树与逐文件小节同样缺这 4 条。四者在代码中有真实消费者（如 导入新库.py:361-362、映射台账.py:90/268、核对结果.py:65） ， ，
| **LM-03** | 旧库迁移 | 数据库/旧库迁移/切换检查.py:24 | D1 | 全文件只返回 `核对` + `source_delta` + `data_checks_passed` + 两个恒 False； `docs/系统架构/新版设计/文件设计/数据库与迁移.md:421-422` 声明该文件「意图/职责：增量对账与回退条件」，实现里没有回退条件。补回退条件判定，或把合同文字改为「增量对账（不含回退条件）」 | 无需授权（改文档）／需用户授权（加判定） |
| **LM-01** | 旧库迁移 | 数据库/旧库迁移/知识记录分流.py:350 | D1/D3 | `work_id = 行.get("work_id")` / `if work_id is None: raise 迁移错误("unknown_use", …)` ；而 `旧结构/SQLite/0003_snapshots.sql:1` 的 `snapshots` 只有 id/kind/payload_json/created_at | `snapshots` 的 K08 镜像分支（同文件 489、505 行）与 `docs/系统架构/新版设计/数据模型/旧知识记录分流.md:92` 「K08 承接 snapshots」是死声明： ： ，
| **LM-02** （并入 TS-10） `if 行.get("source_status") not in {"active","authorized"} or 行.get("source_action_policy") != "allowed":` ； `旧结构/SQLite/0001_init.sql:56` 的 `cards` 无这两列 | 非 embedding 的 `cards` 行必在 373 行抛 `permission_conflict` ，到不了 489 行镜像分支。用例 `tests/迁移/test_混合知识分流.py:339-355` 用合成行（含 source_status/action_policy/draft_payload，
| **TS-06** | 测试与资源 | `tests/用例清单.json` （ `parameter_ids` （ ） ； `then` | 与《测试隔离》§3「与…参数行绑定」不一致（ `then` 者补预期结果 | 需用户授权 |
| **TS-02** | 测试与资源 | `tests/单元/test_备份发布身份.py:20-31` （ `with pytest.raises(备份恢复错误, match="构建身份"):` | **根因** ：门禁颜色取决于带外 `make 生成` （ `备份恢复.py:216` ）被 `:215 _核对安装` 抢先（`:311-312` 抛「当前程序、资源或配置不一致…」），用例未自建「代码哈希与安装清单一致」前置、`核对备份` 被 3 键替身整体替换：把生成物耦合写成明文纪律并加固前置 | 需用户授权 |
| **TS-11** | 测试与资源 | `tests/单元/test_受控文件CAS与恢复.py:21-22` | D1 | `with pytest.raises(受控文件错误): 管理器.写入(身份, 哈希, b"different")` | 命中的是「输入字节与授权哈希不符」前置校验，不是「内容哈希排他发布」冲突分支；该分支错误串「现有暂存内容不一致」（`src/muse/基础设施/受控文件.py:144` ）在全仓测试零出现 → CAS 保护零覆盖 | 无需授权 |
| **TS-04** | 测试与资源 | `tests/端到端/test_交付归档与恢复.py:87-88,218` 、`tests/集成/test_实际运行装配.py:217` 、`tests/集成/test_发布包独立运行.py:220` ，共 16 文件（ `浏览器` 标记） | D1 | `if os.environ.get("MUSE_RUN_BROWSER") != "1": pytest.skip("需显式启用浏览器")` ； `"MUSE_BROWSER_EXECUTABLE": "/Applications/Google Chrome.app/…"` | `MUSE_RUN_BROWSER` 只出现在 tests（ `make 前端测试` =`vitest run` ， `web/tests/旅程/*.spec.ts` 无门禁入口；`:220` 的分支还不报 skip → 真后端浏览器旅程与「备份带走」端到端验收没有执行入口 | 需用户授权 |
| **TS-08** | 测试与资源 | `tests/真实调用/test_诊断技能行为.py:162-166` ； `tests/夹具/行为评测/诊断机器味场景.json:52` | D1 | `if prepared["task_id"] is None: assert …["preflight_only"] …; return True` | `missing-work-ref` 场景 `"work_ref": null` 使其挂 `真实模型` 标记却零模型调用仍计通过：改标离线预检或补真实对照 | 无需授权 |
| **TS-13** | 测试与资源 | `tests/集成/test_上下文快照与索引写入.py:177-183` | D1 | 用例名「同哈希去重与owner冲突」， `assert 再` （首次回执 `:180` 被丢弃） | 未比对提案身份、未验第二张卡不存在：补身份比对与计数断言 | 无需授权 |
| **TS-03** | 测试与资源 | `tests/conftest.py:252-259` ； `tests/架构/test_测试依赖与执行证据.py:138-160` ； `tests/集成/test_数据库连接与迁移.py:74` | D1 | `pytest.skip(f"未设置 {数据库环境变量}…")` ；架构用例断言「全跳过 → 退出码 5」 | 与《测试隔离》§2「缺 `MUSE_TEST_DATABASE_URL` 时**直接失败**，不跳过」冲突。实测：环境变量未设置时 `pytest tests/集成/test_数据库连接与迁移.py --外部环境 -q` → **2 passed, 20 skipped, 退出码 0** ，绕过 §5 全跳过守卫：夹具改 `pytest.fail` 或改规则口径 | 需用户授权 |
| **TS-05** （并入 AG-11） `tests/架构/test_模块依赖.py:330-353` | D1 | `assert Path(相对).name in 登记能力` | `登记能力` 由 `Path(条目).name` 构成（实测 `{SKILL.md, 写手.md, …}` ），技能路径取 name 恒为 `SKILL.md` → 「场景只路由已登记技能」永不拒绝：改后缀匹配 | 无需授权 |
| **TS-07** | 测试与资源 | `tests/端到端/test_改进验证与版本启用.py:371-392` 、`:330-332` | D1 | docstring「此处以最小红例固定『运行观察不产生任何 skill/lesson 落盘』的合同」；用例体只断言 `saved["state"]` 与列表首元素 id | 从不检查 `.agent/skills` 或提示资源是否被改写：补文件字节/哈希断言；`:330` 同调用自比只证读取确定性 | 无需授权 |
| **TS-09** | 测试与资源 | `tests/架构/test_模块依赖.py:442-468` | D1 | `characters={"甲": ["嗯"], "乙": ["嗯"]}` → `pytest.raises(ValidationError)` | `characters` /`untouchable_verbal_tics` 都不是 `声音提案请求` 的字段（`src/muse/审校修订/声音确认.py:67-76` ， `extra="forbid"` ）：只能命中「未知 kwarg」，
| **TS-12** | 测试与资源 | `tests/集成/test_审校报告与案例持久化.py:1037-1049` ；登记条目 `TC-873f1d93b7df` | D1 | 用例名「CLI诊断默认持久化且**同一作者可读回**」，函数体只有 `assert 结果["report"]["persisted"] is True` ；登记 `environment="离线，固定样张、规则和四类反例"` | 该用例经 `诊断环境` →`章后环境` →`应用测试库` 依赖隔离 PostgreSQL，
## P2（
| 编号 | 模块 | 位置 | 方向 | 现状摘录 | 建议 | 所需授权 |
|---|---|---|---|---|---|---|
| **AG-13** | agent层 | `.agent/skills/操作/{扩写场景,润色正文,重写选段,压缩正文}/SKILL.md` ； （ `id` 、`description` 、`mode` 与一句动作描述），其余 20 行完全一致； ） `mode` 参数；方法技能保留各自特有的输入差异、删除复制的"当前不…"段 | 无需授权 |
| **AG-16** | agent层 | `.agent/skills/操作/建立作品声音档案/SKILL.md:2` 、`.agent/skills/操作/评估内容质量/SKILL.md:2` 等 24 处 | D4 | 24 个有 `id` 的技能中 16 个带 `operation.` 前缀、8 个不带（`write-next-chapter` 、`inspect-task` 、`check-consistency` 等）；`operation.build_voice` 、`operation.review_content` 用下划线，其余用连字符。 | 统一 `id` 命名口径并在规范中成文 | 无需授权 |
| **AG-15** | agent层 | `.agent/skills/操作/目录.md:3,4,8,10` | D5 | 四行使用场景="需要该项操作时"、使用要求="只使用已实现的具名入口"，无任何触发信息；其中 `:8` 是核心入口 `写下一章` ， `:10` 是 `核对内容一致性` 。 | 按 SKILL.md 的"何时使用/命令"补写具体触发场景 | 无需授权 |
| **AG-20** | agent层 | `.agent/作者/场景/定故事.md:16` | D4 | 「方法子阶段在方法技能迁移前可参考旧版 [完善故事基础设定 ](../../skills/操作/完善故事基础设定/SKILL.md ) 主文档」——链接文字称"旧版"，目标与 `:9` 是同一个新版路径；"主文档的「整理交付」"在 SKILL.md 中已变为 `references/整理交付.md` 。 | 删去"迁移前/旧版/主文档"表述，改指 `references/整理交付.md` | 无需授权 |
| **AG-23** | agent层 | `.agent/skills/操作/完善故事基础设定/SKILL.md:16` 、`.agent/skills/操作/记录机器味案例/SKILL.md:20` | D4 | `完善故事基础设定/references/` 有 8 个文件， `交付结构.json` ，未给 `references/目录.md` 索引指针（其余 6 个指令文件不可从 SKILL.md 发现）；`记录机器味案例/references/目录.md` 未被 SKILL.md 引用。 | 在 SKILL.md 补 `references/目录.md` 指针 | 无需授权 |
| **AG-14** | agent层 | `.agent/skills/操作/目录.md:31,32` | D2 | `整理定稿与导出` 与 `登记连载与反馈` 两行的内容描述（"作者定稿、实际文件与版本反馈"）、使用场景（"交付连载时"）、使用要求（"明确版本和作者动作"）三列**逐字相同**，派发者无法区分，且描述与导出技能实际职责（冻结/导出/下载）不符。 | 按各自 SKILL.md 重写两行 | 无需授权 |
| **AG-22** | agent层 | `.agent/skills/规划/铺设并回收伏笔/SKILL.md:49-56` 、`写作/打磨小说场景/SKILL.md:63-73` 、`写作/打磨小说语言/SKILL.md:41-52` 、`写作/表达主题与立场/SKILL.md:66-75` 、`写作/运用展示与留白/SKILL.md:53-63` | D4 | 这 5 个技能的 `references/_coverage.md` （自述"唯一追溯文件"）未出现在 SKILL.md 的引用索引；另外 10 个方法技能逐条登记。 | 统一：引用索引补 `_coverage.md` 行 | 无需授权 |
| **AG-24** | agent层 | `.agent/skills/诊断/诊断作品问题/SKILL.md:58-74` | D2 | 「症状→专精 Skill 路由」15 行表与 15 个方法技能 description 的"与 X 交接"段、`.agent/skills/诊断/目录.md:11` 的交接清单三处维护同一批关系，改一处必须同步三处。 | 保留一处为定义、其余改为指针 | 无需授权 |
| **AG-18** | agent层 | `.agent/skills/规划/搭建故事结构/SKILL.md:61` 、`.agent/skills/写作/设计人物/SKILL.md:81` 、`.agent/skills/诊断/诊断作品问题/SKILL.md:94` 等 14 处 | D2 | `## 脚本` 段列出的全部是 `references/*-checklist.md` 、`*-worksheet.md` 、`*-ledger-template.md` 之类 Markdown 台账，没有任何脚本；而 `.agent/rules/模块依赖.md:8` 禁止技能目录放脚本，两处叠加造成"声称有脚本、实际无脚本、也不允许有脚本"。 | 段名改为「台账/清单」，并在需要机械判定的台账上注明由谁校验 | 无需授权 |
| **AG-17** | agent层 | `.agent/skills/` 全目录；`工具/维护索引.py:64-75` 与 `src/muse/资源加载.py:40-55` | D5 | 同一目录两套 frontmatter 最低要求： `id/category/contract_version` ， `name/description` ；索引门禁只校验 `name` ， ， ： `## 输入` /`## 输出` 分段， `## 红线` 段。 | 成文最小技能合同（必填字段 + 必填段落），并按合同补齐或明确豁免 | 无需授权 |
| **AG-19** | agent层 | `.agent/skills/写作/打磨小说场景/SKILL.md:80` | D4 | 「来源」列写 `/scene-mission-driven； ； ——旧英文技能调用名，与技能身份中文化（`chinese_only` ）口径冲突；其余技能已改用中文源单元名。 | 换成中文源单元名或删除该列 | 无需授权 |
| **AG-21** | agent层 | `.agent/skills/规划/提炼故事概念/SKILL.md:93` 等 15 处 | D2 | 「当前不自动登记 `example_lesson` ，避免无效果信号的公共卡膨胀（批次 3） ； `example_lesson` 仅存在于旧库冻结域（`数据库/旧库迁移/旧结构/PostgreSQL/108-example经验升格.sql` ）。 | 删除批次号与阶段性状态，或迁到 `docs/` 计划留痕 | 无需授权 |
| **DR-15** | docs与根文件 | .github/workflows/检查.yml、构建.yml vs Makefile | D7 | **CI 有、本地无独立入口** ： `数据库/初始化/用途角色.sql` 初始化步（检查.yml:54） `宿主测试` （ ） `检查` 整体（ `格式` +`类型` +`维护索引 --检查` ，不走 `make 检查` ）。**本地有、CI 无**： `make 检查` 里的 `模块边界` 无显式步（仅被 `make 测试` 收集间接覆盖）、`make 资源核对` （ ） `node-version: "22"` vs 检查.yml:34 `"24.15.0"` ； `make 模块边界` 与 `make 资源核对` ；统一两个 workflow 的 Node 版本；`make 检查` 与 CI 步骤表对齐后同步到运行手册 | 需用户授权 |
| **DR-28** | docs与根文件 | docs/系统架构/新版设计/文件设计/*.md、各 `目录.md` | D2 | （ ） ： `文件设计/` 四字段去重率极低——**边界**字段 1331 行只有 301 条不同（ `执行知识-方法技能.md:566,588` 「仅辅助对应 Skill； ； `目录.md` 的「内容描述」列逐字复制「名称」列共 64 行（`新版设计/目录.md:16` 、`功能规格/目录.md:7` 8 行、`决策/目录.md:7` 7 行、`技能承接表.md:23` 的「承接要求」列 33 行同句）；`目录.md` 固定填充单元格合计 170 处（`设计、实现或评审对应主题` × `逐文件目标合同` × `后端-B09-上下文.md:3` 的页首页脚 × `文档与研究证据.md:237` 的「意图」句 × ） `目录.md` 的「内容描述」在等于名称时留空。属生成器问题，不逐页手改 | 需用户授权 |
| **DR-19** | docs与根文件 | .gitignore:2-3,5-6,13-14,32-34 | D4 | 残留旧实现条目：`works/*/评审/` （ `works/` 不存在）、`requirements.txt` （已由 `pyproject.toml` +`uv.lock` 取代，文件不存在）、`muse/content/entity/skills/review/审核知识卡/golden/calibrate-stamp.json` （路径不存在）、`.venv-旧/` （见 DR-06） `docs/write-chapter/artifacts/` （ ） ，
| **DR-14** | docs与根文件 | Makefile:4、Makefile:65 | D7 | `.PHONY` 列出 16 个目标（安装 格式 格式写入 类型 模块边界 检查 测试 数据库测试 宿主测试 真实模型测试 前端安装 前端检查 前端测试 生成 构建 资源核对），漏掉实际存在的 `迁移` （ ） `.PHONY` 补 `迁移` | 无需授权（一行） |
| **DR-17** | docs与根文件 | AGENTS.md:4、68、89-90； （ ） ： **3 遍** （ **2 遍** （
| **DR-16** | docs与根文件 | AGENTS.md:22-38 | D7 | §2「目录导航」物理树漏列 8 个顶层条目：`部署/` （含 Dockerfile/启动.sh/停止.sh/compose.yaml， `upstream/` （ `溯源.yaml` ）、`.github/` （两个 workflow） `data/` 、`uv.lock` 、`.editorconfig` 、`.gitattributes` 、`.gitignore` | 补 `部署/` 、`upstream/` 、`.github/` 、`data/` （
| **DR-21** | docs与根文件 | web/package.json:31,40 | D8 | `@testing-library/user-event` 在 `web/src` 、`web/tests` 、全部配置文件**零命中**（仅 package.json + pnpm-lock） ； `prettier` 无 `.prettierrc` 、无 npm script、Makefile 无入口，同样零命中 | 删除这两条 devDependency。**注意**： `itsdangerous` （ `pyproject.toml:17` ）虽三目录零 import， `src/muse/接入/http/应用.py:9,70` 的 starlette `SessionMiddleware` 在 `sessions.py:8` 无条件 `import itsdangerous` ，属隐式必需，**不得**列入未使用 | 需用户授权 |
| **DR-23** | docs与根文件 | AGENTS.md:80、AGENTS.md:100 | D2 | （ ） ： ： ， （ ， ） ； （ ） `make 检查` + `维护索引` 规则） | 需用户授权 |
| **DR-18** | docs与根文件 | README.md:126、208、212、236 | D2 | （ ） ：
| **DR-22** | docs与根文件 | README.md:146-148、279 vs 其余各处 | D2/D7 | 同一份 README 混用两套命令口径：`uv run muse 研究 …` （ ） `uv run python 工具/构建发布.py …` （ ） ， `.venv/bin/python -m muse …` | 统一为 `.venv/bin/python -m muse` （或全量改为 `uv run` 并在开头声明唯一口径） | 需用户授权 |
| **DR-29** | docs与根文件 | docs/系统架构/新版设计/文件设计/前端-功能工作台.md:309、docs/系统架构/新版设计/文件设计/前端-应用与通用界面.md:768 | D7 | 两个文件用了**同一个锚点 ID** `<a id="file-529b1c403b83b56f"></a>` （跨文件撞号）。`目标文件清单.json` 的 `design_location` 字段形如 `文件设计/<页>.md#file-<hash>` ，锚点是投影器的定位键 | 重跑投影器生成唯一哈希；或在校验里加一条「锚点 ID 全仓唯一」 | 需用户授权 |
| **WB-13** | web | `web/tsconfig.tsbuildinfo` | D3/D1 | `git ls-files web/tsconfig.tsbuildinfo` 命中（已被跟踪），`git check-ignore` 退出码 1（ ） ； `{"root":["./src/main.tsx",...]}` 全量文件清单＋增量构建缓存，每次增删文件都产生噪声 diff | `git rm --cached web/tsconfig.tsbuildinfo` 并在 `.gitignore` 加 `web/tsconfig.tsbuildinfo` | 需用户授权 |
| **WB-12** | web | `web/package.json:12,29` + `web/vitest.config.ts:7` + `Makefile:18-19` | D1/D7 | `"test": "vitest run"` ， `include: ["tests/**/*.test.{ts,tsx}", ...]` 排除 `*.spec.ts` ； `web/tests/旅程/` 有 24 个 `*.spec.ts` ； `package.json` 无 playwright 脚本，`Makefile` 的 `前端测试` 只调 `pnpm --dir web run test` 。24 个旅程用例**无任何声明入口**（设计文档 `前端-应用与通用界面.md:166` 只说配置文件，未给命令） | 加 `"test:journey": "playwright test"` ，并在 `Makefile` /运行手册登记为需真后端的独立入口（不入 `make 检查` ）
| **WB-11** | web | `web/package.json:13` | D1 | `"lint": "eslint src"` —— 53 个测试文件（`web/tests` ）不在任何 lint 范围；`tsconfig.json` 的 `"include": ["src", "tests"]` 使 typecheck 覆盖了它们，检查面不对齐 | 改 `"lint": "eslint src tests"` | 需用户授权 |
| **WB-17** | web | `web/src/功能/审校修订/问题清单.tsx:13` ； `web/src/功能/创作对话/消息流.tsx:7` | D1 | `export function Ui问题清单({ items }: { items: 发现[] })` 与 `export function 折叠消息(事件: 任务事件[]): {` —— 两者仅在本文件内被调用（`问题清单.tsx:61,85` 、`消息流.tsx:26` ）；同类「导出但无跨文件消费者」的符号共 34 个（其余 32 个是类型），均属多余 `export` | 去掉多余 `export` 关键字 | 需用户授权 |
| **WB-04** | web | `web/src/功能/资料研究/资料页.tsx:17` 与 `:22` | D1 | `const { data, error } = await (await import("../../接口/生成/客户端")).客户端.POST(` —— 连续两行对内联动态导入同一模块；该模块在其余 30+ 文件一律顶部静态导入 | 顶部 `import { 客户端 } from "../../接口/生成/客户端";` | 需用户授权 |
| **WB-07** | web | 12 文件 20 处：`界面/结构表单/字段渲染.tsx:39,79,136` ； `交付连载/全书整理页.tsx:229` ； `效果评测/逐例比较.tsx:139,175,185` ； `正文写作/版本分支.tsx:187,237` ； `正文写作/选段改写.tsx:175,183,242,259` ； `创作对话/消息流.tsx:43` ； `创作对话/作者动作.tsx:86` ； `审校修订/独立比较.tsx:138` ； `审校修订/审校页.tsx:219` ； `审校修订/声音档案.tsx:173` ； `审校修订/规则页.tsx:39` ； `审校修订/修订对照.tsx:290` ； `作品规划/探索工作区.tsx:297` | D1 | `<p key={序}>{段}</p>` / `<div className="array-item" key={i}>` / `<option key={i} value={i}>` —— 索引作 key | 列表项改稳定身份；纯静态 `enum` /`anyOf` 分支列表可保留索引 key 并加注释说明 | 需用户授权 |
| **WB-05** | web | `web/src/功能/资料研究/资料页.tsx:43` | D1 | `<a className="text-button" href="/research">研究工作区</a>与<a className="text-button" href="/rankings">榜单与选题</a>。` —— 全仓唯一两处裸 `href` 站内跳转，触发整页刷新 | 改 `<Link to="/research">` / `<Link to="/rankings">` | 需用户授权 |
| **WB-08** | web | 13 文件 36 处，最密 `web/src/功能/知识方法/数据.ts:76,84,95,109,123,132,146` （ `审校修订/数据.ts` （ ） `故事世界/数据.ts` （ ） `资料研究/数据.ts` （ ） `正文写作/版本分支.tsx:73` 、`任务运行/任务预算.tsx:49` 等 | D1/D7 | `(await 客户端.GET("/api/v1/methods/types", { signal })).data as unknown as 方法类型行[],` —— 断言绕过生成类型。根因在契约： **135 个（ （ `additionalProperties: true` 空对象 + 11 个无字段数组 + 41 个空 `schema` ），生成类型只能给出 `object` 。同仓 `web/src/功能/系统管理/数据.ts:78-233` （ `对象` /`文本` /`布尔` /`数字` /`读系统状态` ）走运行时逐字段校验，两种纪律并存 | 二选一并成文：补契约字段后删断言，或统一引入运行时校验层（照 `系统管理/数据.ts` 的写法） | 需用户授权 |
| **WB-03** | web | `web/src/应用/路由.tsx:77-116` | D1 | `const 值 = window.location.pathname.split("/").filter(Boolean);` / `const 索引 = 值.indexOf(name === "work_id" ? "works" : name);` —— 已在 `BrowserRouter` 内却绕过 `useParams` 自行拆路径，同文件出现 3 种取参写法（`:78` 、`:109` 、`:114` ） ， `Ui版本绑定壳` 用 `段[1]` 硬编码段位，且 `:109` /`:114` 未 `decodeURIComponent` | 五处壳组件统一改 `useParams()` ，删除 `取路径参数` | 需用户授权 |
| **WB-09** | web | `web/src/功能/正文写作/编辑会话.ts:78` ＋ `编辑缓冲.ts:52-57` ＋ `正文页.tsx:188` | D1 | `if (!alive ｜ ｜ （每次输入 1 次全文序列化）→ `persist()` → `storage.setItem(key, text)` （第 2 次）→ `keys().filter(...)` （ `:55-57` 遍历整份 localStorage 全部键）；渲染侧 `Array.from(正文文本(state.draft)).length` 每次按键按码点建数组。单次按键成本随正文长度线性上升 | 变更判定改脏标/浅比较； ；
| **WB-06** | web | `web/src/界面/结构表单/字段渲染.tsx:79` | D1 | `values.map((v, i) => (<div className="array-item" key={i}>` —— 索引 key 与下方 `:94` 的「移除第 {i + 1} 项」按钮、`:106` 的「添加」同时存在，构成可增删数组项配索引 key | 为数组项生成 client id 并以其为 key | 需用户授权 |
| **WB-10** | web | `web/src/功能/正文写作/候选审阅.tsx:93-98` ； `web/src/功能/作品规划/规划工作区.tsx:270-275` ； `web/src/功能/正式变更/决策面板.tsx:15` | D2/D7 | 同一 decision 枚举三份中文映射且互相矛盾：`undecided: "未决定"` （ ） `undecided: "待决定"` （规划工作区）；`adopt: "已采纳"` （ ） `adopt: "已确认"` （规划工作区） | 收敛为单一导出常量，三处共用 | 需用户授权 |
| **WB-15** | web | 模板 `to=` 链接共 50 处，未编码 30 处 vs 已编码 20 处。未编码示例：`web/src/功能/交付连载/全书整理页.tsx:200,304,434` 、`web/src/功能/交付连载/连载计划页.tsx:154-156,505,534` 、`web/src/功能/交付连载/跨章校对.tsx:115` 、`web/src/功能/作者经验/偏好页.tsx:217` 、`web/src/功能/作品规划/探索工作区.tsx:72` ；已编码示例：`web/src/应用/路由.tsx:81` 、`web/src/功能/正文写作/候选审阅.tsx:108` | D6/D1 | `to={\` /works/${workId}/write/${c.chapter_id}\`}` 与 ` to={\`/works/${encodeURIComponent(work)}/write/${encodeURIComponent(chapter)}?branch=…\`}` 并存 —— 同类服务端 id 拼路由，一半编码一半不编码 | 统一：集中一个路由构造函数（内部 ` encodeURIComponent`），或全部就地编码 | 需用户授权 |
| **WB-16** | web | `web/src/功能/作品规划/规划工作区.tsx:332` | D2 | `// 冲突提示立即可见，但最新基线可能仍在迹；重看必须等待新数据，不用渲染时序。` —— 「在迹」为错字，语义应为「在途」 | 改字为「可能仍在途」 | 需用户授权 |
| **WB-14** | web | `web/src/功能/交付连载/连载计划页.tsx:497` ； `web/src/功能/交付连载/读者反馈页.tsx:248` | D6 | `<a href={r.payload.evidence_url} target="_blank" rel="noreferrer">` —— 直接渲染作者填写并落库的地址；来源表单 `:433` 是 `type="url"` ，而 `javascript:` ／ `data:` 同样能通过 url 类型校验， `href` 协议 | 渲染前校验 `new URL(x).protocol` ∈ {http:, https:}，否则降级为纯文本 | 需用户授权 |
| **JF-07** | 后端-交付连载上下文资料 | src/muse/上下文/材料装配.py:4、src/muse/上下文/材料装配.py:26； ； （ ） （ `budget.context_bytes` ）只写在代码注释；默认值 `65536` 在编排侧重复 5 处，其中 审校修订.py:190 直接以常量传 `字节上限=65536` 绕过任务预算。 | 把"字节单位 + 预算取自任务冻结输入"写进 B09 模块设计与文件设计；`65536` 收敛到单一常量并禁止绕过任务预算的调用。 | 无需授权 |
| **JF-09** | 后端-交付连载上下文资料 | src/muse/资料研究/榜单快照.py:17-20、src/muse/资料研究/榜单快照.py:23； ： `登记榜单` 与 HTTP 路由（接入/http/路由/资料研究.py:147-151） ， （ ） ， ， `登记榜单` 加 scheme 白名单。 | 需用户授权 |
| **JF-06** | 后端-交付连载上下文资料 | src/muse/上下文/任务范围.py（ ） ； ； `任务范围.py` 835 行超 500 行阈值；单函数 `核对依赖` 225 行、`读取回放材料` 172 行、`上下文服务.授权任务范围` 123 行、导出格式/EPUB.py:137 `读取` 123 行，均为最深嵌套热点。 | 按来源类型拆 `核对依赖` （目录/文稿/细纲/事实/声音/方法/偏好各一支），`读取回放材料` 拆"选材"与"三臂组装"两段，`任务范围.py` 按"授权/恢复/校验"分文件。 | 无需授权 |
| **JF-10** | 后端-交付连载上下文资料 | src/muse/接入/cli/交付命令.py:39-41 | D6 | `with Path(output).open("xb") as stream: stream.write(bytes(row["data"]))` ： （ `FileExistsError` ；无"临时文件 + rename"原子落盘。排他创建已能阻止覆盖既有文件，路径由本地作者给出。 | 同目录临时文件写完再 `os.replace` ；捕获 `FileExistsError` 给作者中文提示。 | 无需授权 |
| **JF-11** | 后端-交付连载上下文资料 | src/muse/上下文/回放材料.py:140（ `def choose` ）、该文件 47 个非中文本地变量； `.agent/规范/命名.md:5` 要求自有业务目录/文件/模块/类/函数/测试名中文优先；同包 `任务范围.py` （ ） `资料研究/分章切窗.py` （ ） ， （
| **JF-08** | 后端-交付连载上下文资料 | src/muse/交付连载/接口.py:158（ ） ； ； ； ； ）
| **JT-09** | 后端-任务运行编排 | `src/muse/任务运行/原文生命周期.py` （ `接口.py` （ ） `预算管理.py` （ ） `存储.py` （ ） ； `src/muse/编排/生成正文.py` （ ） `find src/muse -name "*.py" -exec wc -l {} +` 显示本组 5 个文件超 500 行。圈复杂度热点（ ） ： `生成正文.py:168 登记生成正文` cc=46、`配置版本.py:86 __post_init__` cc=36、`运行证据.py:220 保存` cc=32、`模型调用.py:242 _执行回合` cc=31、`研究拆书.py:87 登记研究拆书` cc=24、`预算管理.py:351 预留` cc=23、`完整审校.py:158 登记完整审校` cc=21、`行为评测.py:132 准备` cc=20。两项都不在门禁内： `pyproject.toml` 的 `[tool.ruff.lint] select = ["E","F","W","I","B","UP"]` 不含 `C901` (mccabe) | 门禁加 `C901` （阈值先设 25） ； `登记生成正文` （ `运行证据.保存` （字段校验矩阵） | 需用户授权（改 pyproject 门禁配置） |
| **JT-08** | 后端-任务运行编排 | `src/muse/编排/接口.py:14-21` | D1/D3 | `流程服务` 三个方法中 `.发布` 有 6 个生产消费者，`.发起` （一层转发 `运行.创建任务` ）只有 tests 调用，`.查询` （转发 `运行.读取任务` ）生产与测试**均零调用**；生产发起实际都直连 `装配.任务运行.创建受控任务/创建任务` （ `生成正文.py:624` 、`研究拆书.py:300` ）。这是无消费者的转发面 | 删除 `.发起/.查询` ，只保留有消费者的 `.发布` ；或让业务入口统一经 `流程服务` 发起，避免两套发起口径 | 无需授权 |
| **JT-13** | 后端-任务运行编排 | `AGENTS.md:14` 对照 `src/muse/任务运行/存储.py` 全体 SQL | D7 | 文档：`本地 SQLite（ ， ） （ ） 。实现：`grep -rn "sqlite" src 工具 Makefile pyproject.toml` 命中 0； （ `muse_task` /`muse_step` /`muse_attempt` /`muse_task_event` ，见 `存储.py:571-599` 追加事件）。按 SQLite 口径去查 runs/events 会查空 | 更正 `AGENTS.md` 运行态账本一行（或如果 SQLite 账本确有独立实现，补路径）；本项主责在根文件组，本组只提供实现侧证据 | 需用户授权 |
| **JT-12** | 后端-任务运行编排 | `docs/系统架构/新版设计/调用链路/关键旅程.md:23` 对照 `src/muse/编排/章后处理.py:373-380` | D7 | 文档：`S01 事务登记派生任务 → S02 租约执行 → 固定正文版本 → 摘要／ ／ 实现：`来源复检` （ ） `读取正文依据(..., int(来源["revision"]))` ），最后一个"登记摘要与索引"不再核对当前版本；另有 `登记恢复检查` 在恢复时复检一次（`:120-123` ）。"完成前复检"在实现里不存在 | 二选一：把文档改为"入口来源复检 + 恢复时复检"，或在 `登记摘要与索引` 前补一次当前版本核对（不一致即拒绝登记） | 需用户授权（改文档口径或改流程步骤） |
| **JT-11** | 后端-任务运行编排 | `src/muse/编排/研究拆书.py:31` ； `src/muse/启动.py:288` | D1 | `from muse.编排.章后处理 import _工厂, 前步检查点` 与 `from muse.编排.运行装配 import _登记默认运行` —— 下划线私有符号被跨文件导入（`_工厂` 还是 3 个旅程共用的数据库工厂构造）。`AGENTS.md` 与本组对外口径均要求"外部不导入私有模型或 SQL"（ `:26` ： `所有接口在本模块的接口.py 暴露…外部不导入私有模型或 SQL` ） `_工厂` 提升为公开名（如 `编排.装配工厂()` ）或下沉到独立模块；`_登记默认运行` 去掉下划线并写进 `运行装配.__all__` | 无需授权 |
| **JT-05** | 后端-任务运行编排 | `src/muse/编排/载入模板.py:40-63` （解析）；`src/muse/任务运行/模型.py:134-143` （步骤计划无保护字段） | D3/D7 | 11 个流程模板里有 7 个写了 `protection: 冻结上下文` （如 `流程/生成正文.yaml` 冻结回放），但 `解析流程文本` 只取 `step_id/processor/processor_version/depends_on/tools/role` ， `protection` 无任何读取点（全仓 grep 该键命中 0） `登记类型(必需保护=...)` + `步骤处理器.保护职责` （ `槽位约束.py:42-46` ）。模板里这个字段是**登记了但没人读**的第二事实源：改它不会改变保护，删它也不会削弱保护 | 二选一：解析时读入并与处理器 `保护职责` 核对（不一致即拒绝），或从模板删除该字段并在模板注释写明"保护节点由处理器登记决定" | 无需授权 |
| **JT-14** | 后端-任务运行编排 | `src/muse/任务运行/预算管理.py:66-73` | D1/D7 | `归属窗口` docstring： `沿用每日 00/05/10/15/20 边界；末窗到午夜` ，而 `AGENTS.md` 口径是"严格遵守 5 小时额度窗口"。实现末窗 20:00– `额度策略.时区` 可配但边界不可配 | 文档写明"四段 5 小时 + 末段 4 小时"，或把边界提成 `额度策略` 字段（默认不变） | 无需授权 |
| **JT-10** | 后端-任务运行编排 | `src/muse/编排/生成正文.py:91-100` 与 `src/muse/编排/章后处理.py:357-364` ； `src/muse/任务运行/预算管理.py:27` 、`配置版本.py:26` 、`角色策略.py:29-35` ； `src/muse/任务运行/存储.py:37-38` 与 `接口.py:514-528` 、`预算管理.py:606-646` | D1/D2 | ① `前步检查点` 在 `生成正文` 与 `章后处理` 各实现一份，逻辑相同仅错误类型不同（`研究拆书.py:31` 又跨文件 import 了后者）。② 五角色集合硬编码三份：`预算管理._角色` 、`配置版本._角色` 逐字相同，`角色策略.py:29-35` 再校验一次；权威声明在 `策略/角色.yaml` （ `roles:` 五键）。③ `存储.查询` 的自述是 `仅本模块固定 SQL 使用 schema 占位，不接收外部 SQL 或表名` ，但 `接口.py:514-528` 与 `预算管理.py:606-646` 都把外模块 SQL 常量传进来（ `sql.Identifier` + 参数化，无注入风险，但边界声明失真） | ① 抽到一个公共模块（如 `编排/步骤上下文.py` ）。② 角色集合从 `角色策略目录.从发布包()` 取，删除两份 frozenset。③ 或把 `存储.查询` 的自述改为"供任务运行所属模块共用， `存储` | 无需授权 |
| **JT-15** | 后端-任务运行编排 | `src/muse/编排/研究拆书.py:300-304` 对照 `src/muse/任务运行/接口.py:548-557` | D7/D1 | `任务ID = 装配.任务运行.创建任务(请求, 流程身份, 流程版本)` 之后才 `if 配置ID: 配置版本管理(...).冻结到任务(...)` 。而 `接入/http/路由/资料研究.py:45` 的 `config_id: str ｜ 是可选字段，因此不传配置时**会创建一个注定在"绑定分析配置"步骤失败的任务**。同一仓的 `任务登记参与者` 明确避免这种任务：`# 部署未声明抽取配置时不登记注定失败的任务` （ `接口.py:555` ） ， `发起章后处理` 也先 `raise 配置错误` 再创建 | 对齐口径：`发起研究拆书` 在 `配置ID is None` 时直接 `raise 配置错误` （或与章后一致走 `创建受控任务` + 配置必填），并把 HTTP 的 `config_id` 改为必填 | 需用户授权（改接口契约字段） |
| **JT-06** | 后端-任务运行编排 | `src/muse/任务运行/接口.py:493-501` | D2/D3 | 公开方法 `登记外部调用` 的 docstring： `发送前持久化调用引用；模型治理与预算按策略接入。` ——"按策略接入"无判据；且它与 `对账调用` 一样只有 tests 调用（生产派发实际走 `预算管理.标记已发送(登记尝试=True)` → `存储.登记调用` ）。三个公开入口（`登记外部调用` /`对账调用` /`核对可登记任务` ）里前两个在生产面零消费者 | docstring 改为陈述实际语义（"供无 S02 派发能力的受控外部调用登记引用；当前仅测试与运维对账使用"），或按 JT-01 的结论决定去留 | 无需授权 |
| **JT-07** | 后端-任务运行编排 | `src/muse/编排/生成正文.py:527,537` 、`章后处理.py:373,383` 、`研究拆书.py:225,235` ； `src/muse/任务运行/模型.py:50` + `事件记录.py:5-7` | D3 | `流程定义_生成正文/生成正文步骤` 、`流程定义_章后处理/章后处理步骤` 、`流程定义_研究拆书/研究拆书步骤` 六处只自引用（定义行 + 本文件 `__all__` ），全仓 grep 零外部消费者；实际流程来自 `运行资源.zip` 的 `流程/*.yaml` （ `运行装配.py:44-59` ）。同理 `事件类型.等待作者` （ `事件记录.py` 白名单内，但无任何生产者，`web/src/功能/任务运行/数据.ts` 的事件名表也没有它 | 删除这六处代码内流程定义（流程模板是唯一来源），或反过来让模板缺失时回退到它们；删除 `等待作者` 枚举与白名单项 | 无需授权 |
| **JW-18** | 后端-写手规划经验 | src/muse/作品规划/提示词/细化章节计划.md:1； ； （ `查章规划(..., "fine_outline")` 、`读取已确认细纲` 、文件合同"章级细纲任务模板"），违反 `.agent/规范/命名.md` 第 6 条"一个概念一个名" | 统一为"细纲"（改名随 JW-02 的登记一并做） | 需用户授权 |
| **JW-08** | 后端-写手规划经验 | src/muse/正文写作/提示词/生成正文.md:3-4 | D2 | 面向维护者的装配元信息（"资源身份随发布包加载并记录哈希；角色身份、字段结构、权限和预算从各自权威装配…"）随模板进入模型系统提示（`编排/生成正文.py:342` → `:159` → `任务运行/角色会话.py:21-29` 拼接），对写手无写作指令价值；同文件 文件合同 :146-149 已声明"边界：仅定义本任务提示" | 移出模板（改放文件合同或代码注释） | 需用户授权 |
| **JW-09** | 后端-写手规划经验 | src/muse/正文写作/提示词/生成正文.md:18 | D2 | 单条要求堆叠五处否定："不把口癖强塞到每句；…不是必须新造或照抄的剧情。声音条目不取代…不把词表命中直接判为缺陷"，判据互相缠绕，模型难以机械对齐 | 拆成 2~3 条各带单一判据的正向要求 | 需用户授权 |
| **JW-16** | 后端-写手规划经验 | src/muse/正文写作/写作任务.py:20-23、61-64、115-118； `写作粒度集()` 的 `expand_scene` /`edit_selection` 无生产消费者：唯一调用点 `编排/生成正文.py:557` 先拒绝非 `new_chapter` （ `Literal["new_chapter"]` ）；且 `创建写作任务` 只在基线为 0 时约束粒度，实测 `写作任务合同(粒度="expand_scene", 基线=3, 选区=())` 通过（仅 `edit_selection` 强制选区） | 明确保留为 API 能力并在文件合同注明无生产调用，或收窄 `其他粒度` 的接受条件 | 需用户授权 |
| **JW-13** | 后端-写手规划经验 | src/muse/作品规划/进度查询.py:21； `assert 身份.作者 is not None` / `assert 作品 is not None` 做控制流；`python -O` 下断言被剥离，前置不变量静默消失 | 改为显式 `raise 作品错误(...)` | 需用户授权 |
| **JW-14** | 后端-写手规划经验 | src/muse/作品规划/进度查询.py:23-25 | D1 | 逐章调用 `正文.读取正文` 与 `正文.列出候选` ，二者各自 `with self.数据库.连接(只读=True)` （ `正文写作/接口.py:224-232` 、`:324` ） ，
| **JW-17** | 后端-写手规划经验 | src/muse/正文写作/候选版本.py:38； ； `Shadow` （ `.agent/规范/术语.md` 第 4 条"`Shadow/Canonical` 等内部词在界面与文档中用候选/正式"不一致 | 三处改称"候选" | 需用户授权 |
| **JW-07** | 后端-写手规划经验 | src/muse/作品规划/探索交接.py:48 | D2 | 错误文案硬编码"整理稿须按导航顺序包含根设定、九章和待决与取舍"；章数实际来自资源 `.agent/skills/操作/完善故事基础设定/references/交付结构.json` （实测 9 项），资源改章数后文案失真 | 由 `树["chapters"]` 长度生成文案 | 需用户授权 |
| **JW-15** | 后端-写手规划经验 | src/muse/作者经验/存储.py:49、119 | D1 | `INSERT INTO muse_preference VALUES (%s,%s,%s) ON CONFLICT(preference_id)…` 与 `INSERT INTO muse_improvement VALUES (%s,%s,%s)…` 不写列名，依赖物理列序；同文件其他语句均显式列名 | 补列名，避免后续迁移加列即错位 | 需用户授权 |
| **JW-19** | 后端-写手规划经验 | src/muse/作品规划/分层规划.py:85-184； ； （ `核验规划` CC≈36/100 行、`_业务依据` CC≈26/126 行、`校验交付格式` CC≈24/46 行；本组 37 文件无超 500 行（最大 `规划版本.py` 483 行） | 前两者按"结构/投影校验"与"来源/哈希校验"、"各类业务来源"拆分 | 需用户授权 |
| **JW-10** | 后端-写手规划经验 | src/muse/正文写作/接口.py:145 | D1 | 函数内 `from muse.正文写作.候选版本 import 段落差异` ，而模块顶部 `:18` 已导入同名符号，重复导入 | 删除函数内重复导入 | 需用户授权 |
| **JW-12** | 后端-写手规划经验 | src/muse/作品规划/存储.py:152、162； ； `存储.py:152 行 = …` 与 `:162 row = …` ； `作者经验/存储.py` 全用 `row/pid` ，同包 `作者偏好.py:50 行 = store.读偏好(pid)` 混搭；`写作任务.py:67-69` 用 `甲/乙` 作选区循环变量（语义弱），与 `.agent/规范/命名.md` 第 1 条"中文优先"取向不一致 | 统一为中文局部名（技术约定名如 `payload` 除外） | 需用户授权 |
| **JW-06** | 后端-写手规划经验 | src/muse/作品规划/分层规划.py:249-337 | D3 | F06.05 节奏簇（`内置题材档位` /`校验节奏标注` /`检查节奏分布` /`登记题材档位` ）消费者只有 `tests/单元/test_规则节奏与伏笔.py` ， `src/muse/接入/` 、`src/muse/编排/` 全无引用（
| **JW-05** | 后端-写手规划经验 | src/muse/作品规划/分层规划.py:275-283； `节奏分布` 进入 `接口.py` 的 `__all__` ，但全仓（含 tests、web、接入） ； `ZeroDivisionError: division by zero` （ `总数 = len(场景们)` 后直接相除，无空校验） | 空输入显式抛 `作品错误` ，并取消无人使用的 `__all__` 导出 | 需用户授权 |
| **JW-11** | 后端-写手规划经验 | src/muse/正文写作/接口.py:352-387 | D1 | `__all__` 分两段：`:352-384` 一块，`:387` 再 `__all__ += ["写作输出合同", "生成正文模板"]` ；同仓其他模块单块书写 | 合并为单块 `__all__` | 需用户授权 |
| **JC-12** | 后端-基础设施共享 | `src/muse/基础设施/备份恢复.py` （ `数据归档.py` （ `创建备份` 102 行、`恢复备份` 99 行、`_数据库摘要` 93 行、`直接调用.准备` 96 行、`Pi.运行` 83 行（
| **JC-16** | 后端-基础设施共享 | `配置/测试.example.toml:1-14` ； `tests/conftest.py:248` | D3/D7 孤儿配置面 | 该模板的 `连接环境变量` /`允许用途` /`真实调用` 三个键全仓无读取方（`grep 配置/测试` 零命中）；测试侧另行硬编码 `数据库环境变量 = "MUSE_TEST_DATABASE_URL"` | 要么让测试引导真的读该模板，要么把它降级为纯纪律说明并删键，避免"成文协议无实现" | 择机修 |
| **JC-19** | 后端-基础设施共享 | `src/muse/基础设施/检索/向量.py:1` | D2 描述失真 | 模块 docstring 写"余弦相似与倒数排名"，本文件只有 `余弦相似` /`向量得分` ； `src/muse/上下文/混合检索.py:19` | 改述为"余弦相似打分；倒数排名融合由上下文层承担" | 择机修 |
| **JC-20** | 后端-基础设施共享 | `src/muse/基础设施/资料来源/网页读取.py:1,11` | D2 自相矛盾 | 模块 docstring"失败如实上抛"，协议 docstring"失败返回失败结果"（同一文件两种失败语义） | 与该模块的最终处置（ ） ，
| **JC-22** | 后端-基础设施共享 | `配置/本机正式.toml:2,7,22,30` 、`本机维护.toml:5,14` 、`运行配置/章后抽取-本机.toml:21,26` | D6 环境信息入仓 | 三个"本机"配置入库（`git ls-files 配置/` 确认），含个人绝对路径（`/Users/qingse/.local/share/muse/正式环境/…` ）、内网地址与端口（`100.64.0.8:5433` 、`http://100.64.0.8:3000/v1/messages` ）、正式库名；文件内自述"非敏感配置由 Git 管理" | **无凭据值泄漏，不构成 P0** ；建议把"本机"配置移出跟踪（保留 `.example` 模板纪律），或明确仓库不外发并保持现状 | 需用户授权（改跟踪清单） |
| **JC-17** | 后端-基础设施共享 | `src/muse/共享/__init__.py:6-38` ； `src/muse/配置.py:187` | D3 导出面大于消费者 | `from muse.共享 import …` 全仓零命中（ `配置.py` 的 `解析配置` 、`运行装配配置` 也无外部消费者 | 共享包保留子模块导入路径即可，收窄 `__init__` 再导出面；`配置.py` 的两个名字从 `__all__` 移出或注明为装配入口保留 | 择机修 |
| **JC-18** | 后端-基础设施共享 | `后端-基础设施.md:17,30,61-62,302-303` | D7 文档-实现不符 | 文档声明 `连接.py` "连接池和生命周期/仅构造受控连接池"，实际 `连接.py` 每次调用新建连接、无池；声明 `可观测性.py` "日志、关联身份、指标和脱敏"，实际只有 `记录运行` /`配置日志` ，无指标 | 改为如实描述（受控连接与生命周期、日志与脱敏），或按目标补齐实现；两处均属"目标未落地"，须与 JC-10 同批处置 | 需用户授权（改设计文档） |
| **JC-21** | 后端-基础设施共享 | `src/muse/基础设施/检索/向量.py:19-24` | D1 重复计算 | `向量得分` 对每个语料项调用 `余弦相似` 两次（过滤一次、取值一次），语料大时重复全部点积 | 改为一次计算后判正（海量语料下同时省一半算术） | 择机修 |
| **JC-15** | 后端-基础设施共享 | `src/muse/基础设施/数据库/迁移.py:20` 、`备份恢复.py:41` 、`tests/集成/test_数据库连接与迁移.py:233` | D1 重复常量 | 三处各写一份 `0x6D757365` 迁移互斥锁键，无任何断言保证迁移与备份仍锁同一键 | 抽到单一位置（如 `数据库/迁移.py` 导出 `迁移锁键` ）并让备份引用；补一条"两模块取同一锁"的断言 | 择机修 |
| **JC-14** | 后端-基础设施共享 | `src/muse/基础设施/受控文件.py:83-93` | D1 错误质量 | `_根句柄` 的 `except OSError` 覆盖了 `yield` 之后的调用方代码：探针实测 `读取(不存在的对象ID)` 报"受控暂存不可访问"（真实原因是对象目录不存在） | 把 `except OSError` 收窄到 `os.open(self.根,…)` 一处，调用方 OSError 按各自语义转 `受控文件错误` | 择机修 |
| **JC-13** | 后端-基础设施共享 | `备份恢复.py:874-1006` 、`系统运行.py:18-34` 、`受控文件.py:191-213` | D1 命名规范 | 自有局部名纯英文：《命名》第 1 条要求中文优先；实测 `备份恢复.py` 15 个（`manifest/entry/created/seen/process/chunks/environment/candidates/directory/member/archive/root/child/expected_id/entry_id` ）、`系统运行.py` 10 个（`config/conn/database/manifest/status/files/directory/parts/actual/visit` ）、`受控文件.py` 5 个（`file/info/out/stream/root` ）
| **JS-18** | 后端-审校效果评测 | `src/muse/审校修订/接口.py` （函数内 import 21 处）、`src/muse/效果评测/接口.py` （ （ ） ， `TYPE_CHECKING` + 运行时延迟导入并加一行原因注释 | 无需授权 |
| **JS-14** | 后端-审校效果评测 | `src/muse/效果评测/逐例执行.py` （ `效果评测/接口.py` （ ） `审校修订/存储.py` （ ） `审校修订/持久返修.py` （ ） `效果评测/规则诊断.py` （ ） `审校修订/接口.py` （ ） `效果评测/文学评分.py` （ ） ； ： `指标汇总.py:13 汇总实验` C≈150/L272、`启用判据.py:107 判定效果` C≈115/L215、`文学评分.py:371 _仲裁文学评分` C≈114/L132、`逐例执行.py:152 固定执行计划` C≈80/L266、`持久返修.py:514 _读取返修比较来源于` C≈73/L241 | D1 | 7 个文件超 500 行（占本组 48 文件的 15%） ； ， ， `逐例执行` 拆计划/交付/核验、`指标汇总` 把五类指标拆成子函数），或抽出具名私有步骤函数 | 无需授权 |
| **JS-16** | 后端-审校效果评测 | `src/muse/审校修订/返修策略.py:15` 、`持久返修.py:39` （ `le=5` ）、`持久返修.py:125` （ `1 <= 最大轮数 <= 5` ）、`持久返修.py:273` （ `1..5` ） ； `src/muse/效果评测/文学评分.py:83` （ `ge=0, le=10, multiple_of=0.5` ）、`:236-239` 、`:420-425` （ `0.5` /`10` 再写一遍）；`src/muse/审校修订/机器味诊断.py:58` （ `width=12` ）与 `:411` （调用点硬编码 `32` ） `最大返修轮数` 、`评分上下限/步长` 、`语境窗口宽度` ）并只留一个定义 | 无需授权 |
| **JS-15** | 后端-审校效果评测 | `src/muse/审校修订/存储.py:19-20` | D1 | 查询助手命名为 `_声音查询` ，实际是全类通用查询入口（本文件 30+ 处调用，覆盖案例、规则、诊断、文学片、报告等无关领域） | 改名 `_查询` （或 `_行查询` ），声音专用语义留到调用点 | 无需授权 |
| **JS-19** | 后端-审校效果评测 | `src/muse/审校修订/机器味规则.py:23-40` | D1 | 单一 `规则触发` 模型用全部可选字段（`pattern` /`criteria` /`handler` /`max_chars` /`min_run` /`window_chars` /`min_hits` /`tolerance` ）同时承载 regex/handler/density/model_judgment 四类触发器，合法性只能靠 `核对规则:73-97` 的手写分支补 | 改判别联合（`type` 为判别字段），让非法组合在合同层就被拒 | 无需授权 |
| **JS-11** | 后端-审校效果评测 | `src/muse/效果评测/返修比较.py:34` | D3 | `数据集版本 = 诊断数据集版本` 为兼容别名，仓内零消费者（同文件只用 `诊断数据集版本` /`选段数据集版本` ）
| **JS-12** | 后端-审校效果评测 | `src/muse/审校修订/机器味规则.py:145-147` | D3 | `def 核对规则启用(规则, 样例, 评测依据=None): 核对规则(...); raise 规则启用不可用(...)` —— 无条件抛错、第三个参数从未使用；除 `tests/单元/test_机器味诊断合同.py:28` 、`test_声音与规则合同.py:109` 外零调用者，真实启用走 `规则启用.py:145-181` | 删除；若要保留拒答桩，去掉未用参数并在 docstring 写明真实入口 | 无需授权 |
| **JS-17** | 后端-审校效果评测 | `src/muse/效果评测/标定.py:310` | D1 | `agreement = sum(verdicts) / len(verdicts) if verdicts else None` —— 上一行 `:308-309` 已 `if not verdicts: return` ， `else None` 是永不执行的死分支 | 去掉条件表达式，直接相除 | 无需授权 |
| **JS-13** | 后端-审校效果评测 | `src/muse/审校修订/接口.py:516-587` 、`src/muse/效果评测/接口.py:127-199` | D3 | 15 个 `__all__` 名在仓内无任何跨模块调用方，只有 `接口.py` 自身的 import 与 `__all__` 字符串：`准备模型修订` 、`基础检查报告` 、`连续性报告` 、`返修比较来源类型` 、`返修比较选段授权` 、`返修比较选段来源` ； `读取规则诊断凭据` 、`样本分层` 、`标定引用` 、`标定报告` 、`文学评判依据` 、`核对评判依据` 、`写手审计声明` 、`混淆项报告` 、`裁决行为` （符号本身在同包内另有消费者，故非死代码，只是转发层冗余） | 从 `__all__` 收回未消费项，避免把内部合同误当公开面 | 无需授权 |
| **JR-08** | 后端-接入 | `src/muse/接入/创作操作.py` （ `src/muse/接入/cli/入口.py` （ `wc -l` 全量核对）。`创作操作.py:31-546` 全是 pydantic 请求/结果模型，作品、规划、探索、故事世界四域混住；`入口.py:25-277` 是 19 个子命令的 argparse 声明 | `创作操作.py` 按域拆成作品/规划/探索/事实四个模型模块；`入口.py` 的解析器按命令族下沉到各 `cli/*命令.py` （导出 `注册(子命令解析器)` ）
| **JR-17** | 后端-接入 | `http/路由/元数据.py:1` 对照 `:13-16` | D2/D7 | 模块 docstring 自称"读取固定的公共基础结构；作品扩展与启用由具名业务授权入口提供"，但同文件 `POST /api/v1/schemas/commands` 直接调 `执行结构操作` ，可完成 `登记候选` /`发布版本` /`兼容检查` 三类写动作 | docstring 改为"读取已发布结构 + 受控结构维护命令（登记候选/发布版本/兼容检查）"；若要保留"不提供实例启用"的边界，就在此文件显式写出 | 无需授权 |
| **JR-18** | 后端-接入 | `src/muse/接入/主会话.py:1,40-84` ；对照 `后端-装配与接入.md:471` | D7 | 设计文档把 `主会话.py` 职责写成"中文意图和已授权作者动作接入，关联对话及任务"，实际文件只有任务控制/额度 DTO、`参数合同错误` 、`呈现结构` 与两个转交函数（`执行任务控制` /`执行预算批准` ， `:55-84` ），没有任何中文意图或对话实现；文件名 `主会话` 与内容也不相符 | 二选一：把文档职责改为"HTTP/CLI 共用的任务控制与结构呈现合同"（并考虑改名 `任务控制.py` ）；或补齐对话/意图接入面（新功能，须另立计划） | 需用户授权（改文档或改名） |
| **JR-10** | 后端-接入 | `cli/研究命令.py:15,24-46` ； `http/路由/资料研究.py:51-52` | D1 | ① `拆解请求` 设了 `ConfigDict(populate_by_name=True)` 却没有任何 `alias` （该开关在此无作用），另加 6 个只读转发 property（ `命令ID` /`来源ID` /`配置ID` /`理由` /`重跑窗` /`窗口章数` ），一对一映射同名字段，无任何转换语义；② `_装配(request)` 是一行 `return request.app.state.装配` ，被同文件 11 处调用 | ① 删掉 6 个 property 与 `populate_by_name` （同层 `生成发起请求` 直接用英文字段名）；② 直接用 `request.app.state.装配` 或提升为 `依赖.py` 的 `Depends` | 无需授权 |
| **JR-13** | 后端-接入 | `cli/入口.py:31-276` 覆盖的 19 子命令 / 149 动作项 | D3 | 机械核对：文档里 72 处 `python -m muse` 用法中命令名 0 处不匹配、39 处动作名成对可校验且 0 处不匹配；但 **115 个动作项在权威文档（ ） ； **10 个无任何测试引用** （ `运行交付命令` /`运行作品命令` /`运行探索命令` /`运行规划命令` /`运行创作命令` /`运行审阅命令` /`运行维护任务命令` /`运行角色行为命令` /`运行行为评测` /`运行评测命令` ） （ ） ， ； ，
| **JR-11** | 后端-接入 | `审校操作.py:38-39,108,115` ； `cli/角色行为命令.py:23` ； `评测操作.py:14,20` ； `http/应用.py:74` ； `http/事件订阅.py:89` | D1 | ① 返修轮数上限 5 写三次（`max_rounds le=5` 、`expected_round le=5` 、域内 `审校修订/持久返修.py:273` 的 `1 <= 最大轮数 <= 5` ）；② 审校切分默认与边界 `4000 / ge=2,le=12000 / 240` 两处（`审校操作.py:38-39` 、`审校修订/审校报告.py:48,53` ），且接入另加域内不存在的 `context_size le=2000` ；③ `command_id max_length=200` 三处；④ 会话有效期 `max_age=12*3600` 硬编码；⑤ SSE 轮询 `asyncio.sleep(1)` 硬编码 | 每个上限给唯一定义处（域内常量或 `接入/契约常量.py` ）并被两侧引用；`context_size` 若确要收紧，在文档写明理由；会话有效期与轮询间隔提升为配置项 | 无需授权 |
| **JR-07** | 后端-接入 | `cli/审校命令.py:46` 、`cli/评测命令.py:60` 、`cli/入口.py:292` 、`cli/研究命令.py:49` 、`cli/交付命令.py:15` 、`cli/经验命令.py:43` | D1 | 圈复杂度（ `运行审校命令` **cc≈45** 、`运行评测命令` **cc≈45** 、`main` **cc≈36** 、`运行研究命令` **cc≈27** 、`运行交付命令` cc≈21、`运行经验命令` cc≈20。`审校命令.py:96-153` 是一张 18 项动作表 + 18 个 if 的线性派发。`pyproject.toml:64` 的 `select = ["E","F","W","I","B","UP"]` 不含 `C901` ，无机械门禁 | 改为 `{动作: (schema, 执行函数)}` 单表派发（多数分支只差一个调用）；门禁加 `C901` （阈值 25 起）——改 pyproject 属另一批授权 | 无需授权（本域重构）／需用户授权（改门禁配置） |
| **JR-19** | 后端-接入 | `http/应用.py:49,71` | D6 | `secret_key=hashlib.sha256(("muse-session:" + 口令).encode()).hexdigest()` ：会话签名密钥由作者口令确定性派生，同一口令同时承担登录校验与会话签名。口令（`读取凭据("受控存储", 服务.口令文件)` ）熵不足时，拿到一个会话 cookie 即可离线爆破口令并伪造会话。本项无凭据泄漏，属加固项 | 会话密钥改为独立随机值（受控存储第二个值或环境变量），与登录口令解耦；`itsdangerous` 已在依赖内 | 需用户授权（改部署配置与密钥来源） |
| **JR-16** | 后端-接入 | `cli/入口.py:51,99` | D2 | 作者可见的 CLI 帮助夹内部代号与英文：`help="固定场景裁决或显式S02角色行为执行"` 、`help="具体改进、真实评测关联与目标owner启停"` 。`.agent/规范/中文正文与界面.md` 第 4 条要求作者可见的界面与说明用简体中文白话 | 改为"S02"→"角色行为评测"、"owner"→"目标责任人（改进所在目标的作者）" | 无需授权 |
| **JR-15** | 后端-接入 | `http/路由/作品规划.py:52 vs :87` ； `http/路由/知识方法.py:116 vs :216` ； `cli/交付命令.py:18` vs `cli/作品命令.py:131` vs `cli/审阅命令.py:16` ； `http/路由/作者经验.py:67,164` ； `只读工具.py:5,42 vs :13,33` | D1 | 同一概念多名的实例：① 应用装配在 `作品规划.py` 内先叫 `app` （ ） `装配` （ ） ， `知识方法.py` 同样混用；② 调用身份在 CLI 四个模块里分别叫 `identity` /`actor` /`作者` /`身份` ；③ 服务对象叫 `svc` （ `作者经验.py:67` ）又叫 `service` （ ） ； （ ） ， （ ） `.agent/规范/命名.md` 第 6 条"一个概念一个名" | 全层统一：装配→`装配` 、调用身份→`身份` 、服务→`服务` 、历史正文为唯一术语；本次已列全清单，逐条机械替换即可 | 无需授权 |
| **JR-09** | 后端-接入 | `cli/研究命令.py:66,83` ↔ `http/路由/资料研究.py:181,201` ； `cli/创作命令.py:54-64` ↔ `http/路由/创作生成.py:101-110` ； `http/路由/交付连载.py:53-55` ↔ `http/路由/作者经验.py:60-62` | D1 | ① 拆书状态回退字典**逐字重复**： `return 状态 or {"台账": [], "对照": None, "说明": "该来源尚无拆书任务"}` ；② `样本 = {"理由": ...} if ... else None` 两处；③"取候选当前版本→读审校报告→无则报错"两处各写一遍（含 `数据库工厂(装配.配置.数据库, 装配.配置.运行用途)` 直连构造）；④ 同名 `_服务(request, 作者)` 在交付连载与作者经验各写一份，功能相同 | ①②③ 收到 `接入` 的单一转交函数（如 `接入/研究操作.py` 、`接入/创作操作.py` ） ， `接入/http/依赖.py` 的共享助手 | 无需授权 |
| **JR-14** | 后端-接入 | `http/路由/任务运行.py:250` ； `http/路由/审校修订.py:97,214,220` ；另 25 条见下 | D3 | 211 条路由中 4 条除生成合同（`web/src/接口/生成/类型.ts` 、`openapi.generated.json` ）外**全仓零引用**： `POST /tasks/{id}/raw-recovery` 、`GET /voice-proposals/{id}` 、`POST /quality-case-withdrawals` 、`POST /quality-case-rules` （对应服务方法仅在 `tests/集成/test_案例采集与复核.py` 、`tests/迁移/test_作品资产迁移.py` 以域层调用出现）。另有 25 条在 `web/src` （非生成物）无调用点，其中 raw-*/evidence 系列部分由 `tests/集成/test_原文归档与恢复.py:420-441` 以 `base + "/raw-leases"` 拼接覆盖 | 4 条零引用路由交主代理确认产品用途：工作台要用就接线，不用就删并重新生成 `openapi.generated.json` ；另外 25 条建议在文档标注"仅 CLI/测试可达" | 需用户授权（删路由） |
| **JR-12** | 后端-接入 | `cli/入口.py:296-324,523` | D1/D3 | `只读动作` 是跨命令的 27 项动作名白名单，用来在写入前跳过迁移兼容门禁；它与同文件 argparse 的 `choices` 重复声明、无机械校验（`grep 只读动作 tests` 命中 0） `main` 尾部 `return _退出码_用法错误` ：对"已注册但未接线"的子命令静默返回 2， `{命令: frozenset(动作)}` ，与 `choices` 同源生成；未接线子命令先 `print(..., file=sys.stderr)` 再返回 2；
| **JK-11** | 后端-知识方法故事世界 | `src/muse/知识方法/方法卡.py:1,172` + `docs/系统架构/新版设计/模块设计/B04-知识方法.md:31,42` | D7 | 「六类范式／六类内置」；内置结构里 `实例族` 含 `method` 的实为 8 型：
| **JK-14** | 后端-知识方法故事世界 | `src/muse/故事世界/接口.py:1` | D2 | 「当前提案依据校验，后续同表面接入确认和查询」已过期：`决定事实` 、`查询世界` 已在本文件实现 | 改为现状陈述 | 无需授权 |
| **JK-09** | 后端-知识方法故事世界 | `src/muse/正式变更/依赖锁.py:15-17` | D1 D7 | `{"schema": "SCHEMA_STALE", "projection": "PROJECTION_STALE"}` 不可达：全仓 22 个依赖维护者的 `种类` 无 `schema` /`projection` ； `S01-正式变更.md:41` 的「锁序覆盖结构、投影」实际由 `元数据/结构版本.py:257-291` 在参与者内部完成 | 删死映射；
| **JK-10** | 后端-知识方法故事世界 | `src/muse/元数据/内置结构/公共字段.yaml:25-97` vs `src/muse/元数据/扩展合成.py:23-36` | D2 | 「受保护骨架」8 项（无 `created_at` /`updated_at` ），代码 `保护属性` 10 项；
| **JK-15** | 后端-知识方法故事世界 | `src/muse/元数据/内置结构/narrative_state.yaml:34` | D2 | 字段说明内嵌「设计发现:2026-07-09——字段隐含"已有前章"假设……（待回填）」，无目标文件、无判据 | 移入台账或删除 | 无需授权 |
| **JK-17** | 后端-知识方法故事世界 | `src/muse/知识方法/存储.py:119,325` ； `存储.py:148,150` 、`方法版本.py:82,191` 、`故事世界/接口.py:204` | D1 D6 | 两处 f-string SQL 只拼接固定字面片段、值全部 `%s` 绑定（逐条核对无注入）；`__import__("json")` /`__import__("muse.…")` 反模式散落 5 处 | 统一 `psycopg.sql.SQL` 组合与顶部 import | 无需授权 |
| **JK-16** | 后端-知识方法故事世界 | `src/muse/元数据/内置结构/style.yaml:124-138` | D2 | 「达标样张……（余华/毕飞宇/经典网文实证片段），写手对照校准」：与全仓「严禁抄录原文」（`craft.yaml:267` 、`证据反例.py:37-39` 静态资源只登记路径与哈希）纪律冲突，字段无授权约束 | 改为只登记定位/哈希，或加版权授权前置 | 需用户授权 |
| **JK-12** | 后端-知识方法故事世界 | `src/muse/元数据/内置结构/reference_work.yaml:137-153` | D2 | 「产出范式清单」只引用 craft/combat/emotion/scene_pattern/trope 五型（漏 pacing/style， `作品范围: same_work` 用于系统侧档案对象 | 补齐 method 族目标类型，并核对系统侧档案的作品范围语义 | 需用户授权（涉及结构发布） |
| **JK-18** | 后端-知识方法故事世界 | `src/muse/知识方法/方法版本.py` （ `src/muse/元数据/字段校验.py:198-306` | D1 | 本组唯一超 500 行文件；`校验字段变更` 为 108 行嵌套闭包手工路径穿越，属复杂度热点（未装复杂度工具，按结构判断） | 拆出参与者类与路径解析辅助 | 无需授权 |
| **JK-13** | 后端-知识方法故事世界 | `src/muse/知识方法/方法版本.py:296-321` + `src/muse/知识方法/模型.py:75` | D2 | enable 无凭据分支读完消费回执后必然抛 `METHOD_ACTIVATION_UNAVAILABLE` （预留路径，无判据）；`状态命令` docstring「启用需指向实际消费回执」与实现（ `状态参与者` 亦然）冲突 | 删预留分支；
| **JK-19** | 后端-知识方法故事世界 | `src/muse/知识方法/方法版本.py:515-536` 、`方法卡.py:190-200` 、`故事世界/人物关系.py:122-128` | D1 | `__all__` 导出 13 个本包外零引用的名字（ `读取方法结构` 、`列出人物` /`列出关系` 等），公开面宽于真实消费者 | 收窄 `__all__` 到对外合同 | 无需授权 |
| **TL-07** | 工具 | 工具/构建发布.py:25-39； ） （
| **TL-09** | 工具 | 工具/生成接口.py:29 | D1 | `argparse.ArgumentParser(description="生成 Schema、OpenAPI 和 TypeScript")` 与实际不符：只写 OpenAPI 与固定 客户端.ts； ，
| **TL-08** | 工具 | 工具/维护索引.py:48（ ） `根.rglob("目录.md")` 无法剪枝忽略目录，`_在忽略目录` 只在命中文件上判定（:49-50） ； （ （ `rglob` 与 `glob("**")` 均不跟随符号链接，无软链风险 | 改 `os.walk` 剪枝，或把忽略目录收进显式候选根 | 需用户授权 |
| **TL-11** | 工具 | 工具/环境预检.py:91-97； `OSError/ValueError/KeyError/SubprocessError` 归并为一条通用 JSON， （ ， ） ； `条目["工厂"].split(":", 1)` 在缺冒号时抛裸 ValueError 回溯 | 通用分支保留原始异常文本；工厂格式先校验再报错 | 需用户授权 |
| **TL-10** | 工具 | 工具/构建资源包.py:146 | D6 | `shutil.copytree(web_dist, 工作台目录)` 默认 `symlinks=False` ： `symlinks=True` ，或逐文件复制并按清单校验 | 需用户授权 |
| **TL-12** | 工具 | 工具/资源登记.json:237-263； ： `operation.` 前缀（ ） ， （ `能力/operation/operation.polish-text.md` 与 `能力/operation/expand-scene.md` 并存 | 统一身份命名口径后重建资源包 | 需用户授权 |
| **TL-06** | 工具 | 工具/维护索引.py:269-274； `--检查` 解析后从未被引用（死参数）；`--写入` 仅 `print("索引写入：当前无可写生成物，执行幂等检查")` ，随后执行与默认完全相同的只读检查。实测默认态与 `--检查` 态退出码均 0 且输出一致， `生成` 目标改调 `--检查` 并在注释写明无索引生成物 | 需用户授权 |
| **MG-01** | 数据库迁移 | `src/muse/基础设施/数据库/迁移.py:52-54` | D3 | `if 版本 in 已见: raise 迁移错误(f"迁移版本重复： —— 执行器只拦重号，从不校验编号连续性，空洞无法被机械发现 | 在 `列出迁移` 末尾加一条连续性或白名单校验；同步在 `数据库/迁移/` 加 README 或 `迁移登记.json` ，逐个写明 10 个空缺的成因（当前仅 V0011 有） | 无需授权（新增校验与登记文件） |
| **MG-02** | 数据库迁移 | `docs/系统架构/新版设计/文件设计/数据库与迁移.md:76-77` （另 `:242` 、`:264` ） `V0013__上下文与检索索引.sql` 、`V0015__运行配置版本.sql` 与既有迁移并列列出，`docs/系统架构/新版设计/项目目录与文件职责.md:1603-1604` 同；两文件实际不存在 | 在这两处就地标注「目标编号，实现落于 V0022/V0004」；
| **LM-04** | 旧库迁移 | 数据库/旧库迁移/切换检查.py:30 | D1 | `"data_checks_passed": 核对["data_checks_passed"] and not any(增量.values())` | 空输入即放行：`--快照 '[]' --当前快照 '[]'` 时 核对结果.py:99 的 `data_checks_passed` 为 True、增量为空 → 入口.py:185 打印「本范围数据检查通过」并返回 0； `导入目标` 同理（入口.py:175 的 `all_accounted` 在 0==0 时成立）。全链路不接收表清单，也不校验快照是否覆盖旧表白名单。建议：快照为空直接报错，并增一条"声明覆盖表 ⊇ 本次分流触及表"的机械断言 | 需用户授权 |
| **LM-06** | 旧库迁移 | 数据库/旧库迁移/知识记录分流.py:348 | D1 | `return 结果("隔离", "unknown_table")` | 覆盖差集（机械核对）：旧结构 DDL 白名单共 66 张（ ） ， （ `schema_migrations` ），全部落 `unknown_table` 隔离。fail-closed 本身正确，但「白名单可读 ⊃ 规则可承接」这一差集在代码与文档里都没有成文清单，易被读成"全部旧表可迁"。建议在 `旧知识记录分流.md` 增一张「已登记但暂无承接的表」清单 | 无需授权 |
| **TS-54** | 测试与资源 | `tests/契约/test_盲评与引文合同.py` (31)、`tests/架构/test_技能与文档索引.py` (26)、`tests/单元/test_离线修订回放.py` (18) 等 12 文件 | D2 | `def test_unregistered_scenario_and_policy_drift_fail_before_model_call__c80022` 等纯英文用例名 132 个 | 违背《命名规范》§1「测试名使用中文」： （
| **TS-56** | 测试与资源 | `tests/用例清单.json` （ ） `"隔离PG/合成HTTP及浏览器"` 、`"隔离PG与合成资料； 等表述挂在无对应依赖的符号上 | 环境字段区分「本用例执行」与「同文件另有旅程/子进程」；与 TS-04、TS-06、TS-12 一并收口 | 无需授权 |
| **TS-58** | 测试与资源 | `tests/夹具/` （ `tests/夹具` 是空目录」，实测 25 个文件 | 更新计划口径；对 20 个无消费者文件标注「计划内/历史」 | 无需授权 |
| **TS-25** | 测试与资源 | `tests/单元/test_受控文件CAS与恢复.py:1` | D2 | `"""合成私人暂存的字节、权限与清理边界。"""` （文件名含「恢复」） | 全文无恢复/历史归档用例：改名或补用例 | 无需授权 |
| **TS-44** | 测试与资源 | `tests/集成/test_上下文快照与索引写入.py:4,121,462,573,578,603,619,644,657,736` | D1/D2 | `assert f"r{来源.revision}" in 文本` （两字符子串必中）；`assert all(m["method_id"] != method_id for m in 材料)` （空表恒真）；`from muse.共享.错误 import Muse错误 as _Mus` （与 `:640` 重复） | 模块 docstring「参数上限来自版本策略」全仓无该来源； `:462` docstring 声称「经服务读取确认存在」但只重算 uuid5； `:593-594` 用裸 SQL； ； `:121` 与 `:584-600` 是同套流程两份实现 | 无需授权 |
| **TS-29** | 测试与资源 | `tests/契约/test_语义检测合同.py:10,21` ≈ `test_盲评与引文合同.py:41,52` ； `test_盲评与引文合同.py:619` = `test_角色能力与配置.py:61` ； `test_文学评分与仲裁.py:124,204` ； `test_工具范围.py:1` vs `test_探索回放合同.py:151-173` | D1 | `def 材料():` / `def _语义材料():` 逐字同构；同一 `工具定义` /`只读工具集` 夹具各建一份 | 抽共享夹具模块或参数化 | 无需授权 |
| **TS-34** | 测试与资源 | `tests/契约/test_运行观察合同.py:13,22,31` | D1 | `_请求()` 单例夹具被 `:22` 与 `:31` 两处变异复用 | 新增字段会同时放宽两处断言：按用例构造 | 无需授权 |
| **TS-47** | 测试与资源 | `tests/集成/test_原文归档与恢复.py:27,140,152,251,258` | D1/D2 | `"""保留LC-d6e3f58513a1； ； `服务.清理(任务, 租约)` （裸调用当幂等证据） | 样本 ID 在用例清单与全仓均查不到；`:140` （临时授权）与 `:152` （哈希不符）两条拒绝理由都只断类型；`:258-267,:296-305,:320-329,:519-528` 四处 diff 完全相同 | 无需授权 |
| **TS-30** | 测试与资源 | `tests/契约/test_判据来源合同.py:31-32` 、`test_行为场景执行.py:37-46` | D1 | `del request["samples"][0]["candidateBody"]` ； `report.update(persisted=True, target=…)` | 用同一 pydantic 模型重解析自造 dict 当「公开输入」证据；观察对象就地改写成「已持久」再交裁决且无负例 | 无需授权 |
| **TS-32** | 测试与资源 | `tests/契约/test_流式终态.py:34-42` ； `tests/契约/test_混淆项合同.py:7` | D1 | 逐字节喂入只覆盖 ASCII 帧内 `\u0085` ； `import test_效果判据 as 判据测试` | 补多字节中文跨块用例；跨测试模块导入私有 `_输入()` 改共享夹具模块 | 无需授权 |
| **TS-14** | 测试与资源 | `tests/单元/test_声音与规则合同.py:44-45,62,294-297,337-338` | D1 | `assert 文本[候选["start"]:候选["end"]] == 候选["quote"]` （实现同式，`声音基线.py:82` ） ； `assert 统计声音样本(文本) == 统计声音样本(文本)` ； `assert 校验声音节(None) is None` | 断言与实现同源/恒真：引入独立期望 | 无需授权 |
| **TS-22** | 测试与资源 | `tests/单元/test_离线修订回放.py:46,60-66,127-129,186` | D1/D2 | `monkeypatch.setattr(cli, "构建", 禁止构建)` ； `assert 可见文本(doc) == text` ； `--离线` 路径不可达（`入口.py:480` 三元短路）；只断异常类型；恒真断言；承诺的集成核验不存在 | 无需授权 |
| **TS-23** | 测试与资源 | `tests/单元/test_事实时点与有效性.py:46,52,100,264,271` | D1/D2 | `# 保留原LC-e3eca2942895样本…` ； `assert escaped_body.endswith("\\n舱灯闪了一下")` ； `with pytest.raises(元数据错误):` | 样本 ID 全仓仅此一处（不可核实）；恒真断言；引文断言用 `in` 而非等值；两处违约只断类型 | 无需授权 |
| **TS-17** | 测试与资源 | `tests/单元/test_探索交接与规划.py:50-51,125,265,359-360,421-427` | D1 | `assert 校验交付格式(原探索稿)["valid"]` （用例名承诺「局部展开＋不设编号篇幅门」）；`assert "不进入 Canonical" in 入口` | 名实不符的单断言、10 组参数共用无 `match` 的 `raises` 、文档子串代替行为判据、配置两处逐字复制 | 无需授权 |
| **TS-27** | 测试与资源 | `tests/契约/test_工具范围.py:50` 、`test_运行观察合同.py:31` 、`test_动态结构投影与版本.py:93` 、`test_角色能力与配置.py:103` 、`test_文学评分与仲裁.py:242` | D1 | `with pytest.raises(模型协议错误):` 等只吃异常类型；四组变异共用一句 `assert … == "invalid_report"` | 补错误码/字段/`match` 判据 | 无需授权 |
| **TS-28** | 测试与资源 | `tests/契约/test_正文与模型输出.py:57` 、`test_探索回放合同.py:184,203` 、`test_效果判据.py:32+220` 、`test_诊断入口原观察.py:27-30,46-51` | D1 | `assert 可见文本(草稿) == 可见文本(另名)` ； `校验清单(清单, 范围) # 不抛异常即通过` ； `assert report["rule_library_version"] == first["fingerprint"]` | 期望值改为独立常量/夹具；裸调用处补返回值核对 | 无需授权 |
| **TS-57** | 测试与资源 | `tests/架构/test_技能与文档索引.py:61,79,87` ； `tests/端到端/test_改进验证与版本启用.py:141,162,181,199,219,237` ； `tests/集成/test_生产评测权限隔离.py:172` vs `test_回放资料封存.py:123-127` | D1 | 三连/六连同构用例（相似度 0.93–
| **TS-20** | 测试与资源 | `tests/单元/test_上下文快照哈希.py:68` 、`test_声音与规则合同.py:62` 、`test_端到端/test_改进验证与版本启用.py:330` 、`tests/迁移/test_PG作品正文迁移.py:231` | D1 | `assert PG目标ID(w, "a", "work") == PG目标ID(w, "a", "work")` | 全仓机械扫描出的 4 处「同参自比」，只证确定性不证行为 | 无需授权 |
| **TS-18** | 测试与资源 | `tests/单元/test_评测数据集.py:72,97-98` | D1 | 7 组参数命中 3 类守卫却共用 `with pytest.raises(评测错误):` ； `extra="forbid"` 拒绝 | 补 `match` /错误码，或删减无区分度参数行 | 无需授权 |
| **TS-19** | 测试与资源 | `tests/单元/test_角色探针.py:76,92` | D1 | 用例名「逐角色真实调用」，`_配置()` 只声明 extractor 一个角色；`:92` 的 `raises(Muse错误)` 无 `match` （同文件 `:98,:123` 有） | 扩到全部角色或改名；补拒绝原因判据 | 无需授权 |
| **TS-40** | 测试与资源 | `tests/集成/test_数据库连接与迁移.py:76,233,255,261` | D1/D2 | `"options", ["", "-c application_name=readonly-probe"]` ； `SELECT pg_advisory_lock(%s)", (0x6D757365,)` ； `assert main([...]) == 预期码` | options 行与 default 等价；锁键字面量硬编码；只核退出码不读 stderr； `:261` 名「受控文件」但未设 `0o600` 、实现不校验权限 | 无需授权 |
| **TS-51** | 测试与资源 | `tests/架构/test_模块依赖.py:76,88,121,205` | D2 | `"""src/mude 不以代码依赖 .agent 技能目录…"""` ； `getattr(节点.func, "attr", "") == "run"` ； `业务模块 = {p.parent.name for p in 源码根.glob("*/接口.py")}` | 拼写错误；子进程检查漏 `Popen` /`create_subprocess_exec` ；相对导入与基础设施域不受跨域限制 | 无需授权 |
| **TS-21** | 测试与资源 | `tests/单元/test_文件归档恢复.py:82,100,118,135,162,175,183,196,222` | D1 | `with pytest.raises(归档错误):` （ `数据归档.py:80/109/147` 把内部异常也包装成 `归档错误` ：篡改/逃逸/软链/未知根/中断清理无法与内部崩溃区分 | 无需授权 |
| **TS-41** | 测试与资源 | `tests/集成/test_生产评测权限隔离.py:98,155,172,188,194,237,258,264,348` | D1/D2 | `with pytest.raises(psycopg.Error), conn.transaction():` ； `assert result["conditions"]["generator"]["config_hash"]` （只断真值） | 13 条登记同一 `environment="隔离PG与合成资料； ，实测仅 2 条用 CLI/HTTP； （ `V0028…sql:28` 有固定消息可用）；`:172-176` 与 `test_回放资料封存.py:123-127` 逐字重复；`:194/:237/:264` 多参数共用无 `match` 断言 | 无需授权 |
| **TS-46** | 测试与资源 | `tests/集成/test_结构接入.py:105` ； `tests/集成/test_故事事实确认与时点.py:105,396,622` | D1 | `assert client.get("/api/v1/schemas/new-schema/versions/1").status_code != 200` ； `with pytest.raises(Muse错误):` | 只要求非 200（ `:396` 不查错误码（本域已有 `事实错误` ） ； `:622` 计划模式分支只断 `["results"]` 为真值；`:105` 与 `:183,:201` 是同一段替换正文的 7 行复制 | 无需授权 |
| **TS-15** | 测试与资源 | `tests/单元/test_声音与规则合同.py:108-109` | D1 | `核对规则启用(next(iter(规则库["rules"].values())), 规则库["samples"], {"pass": True})` | 该函数无条件抛错且第三参数从未被读取（`机器味规则.py:145-147` ）→「逐例评测与正式批准」门禁判据没进入被测逻辑 | 无需授权 |
| **TS-31** | 测试与资源 | `tests/契约/test_动态结构投影与版本.py:111-148` | D1 | `assert 总字段 == 216` | 文件哈希自比 + 总量抵消（删一加一仍 216）
| **TS-16** | 测试与资源 | `tests/单元/test_声音与规则合同.py:112-119` vs `:122-129` ； `:190-201` vs `:94-109` ； `:413-422` vs `:342-351` | D1 | 同读内置规则、同 `deepcopy l002` 、同改 `regression` 、同 `match="四类例证"` | 三组复制/真子集用例：参数化合并 | 无需授权 |
| **TS-24** | 测试与资源 | `tests/单元/test_结构合成与字段校验.py:118,216,269,274,285,344-345` | D1/D2 | `# 细纲读取与落库门禁（原 FineOutlineReader/FieldCoverage） ； `键 = next((k for k in self.行集 if k in sql), None)` | 两个「原」类名全仓不存在； `None` ；
| **TS-42** | 测试与资源 | `tests/集成/test_评测执行与失败收敛.py:118-119,235,246,608-610,911,934,1031-1033,996,1038,747-750/957-960` | D1/D2 | `assert all(u["output"] is None for u in result["units"])` （无数量前置）；`assert costs[0]["has_unknown"] or Decimal(...) > 0` ； `assert not request.get("previous_response_id")` | `all()` 可空集恒真；四变异共用基类异常无 `match` ； `读取任务绑定(...).内容哈希` 只判真值；`allow_failure=True` 静默吞 Muse错误； `previous_response_id` 在 src 从不产生（ ） ；
| **TS-45** | 测试与资源 | `tests/集成/test_任务租约与恢复.py:131,175,331,365` | D1/D2 | `assert [e.序号 for e in 续接.事件] == list(range(1, 续接.最后序号 + 1))` ； `with pytest.raises(任务错误, match="不存在｜用途")` | 期望值由被测对象的 `最后序号` 生成（空事件时恒真）；`:175` 只证结果非 None； `:365` 用基类异常＋或匹配、`:396` 连 `match` 都没有；`:131` 为全仓唯一孤儿助手 | 无需授权 |
| **TS-59** | 测试与资源 | `tests/单元/test_结构合成与字段校验.py:132-155` 、`tests/集成/test_审校报告与案例持久化.py:850` 、`tests/契约/test_动态结构投影与版本.py:124` | D2 | 参数表与 `ids` 表 9 个字符串逐字重复；`TypeAdapter(案例采集请求).validate_python({**asdict(请求), "carrier": "unknown"})` 与 `:443-453` 同构 | 低价值冗余与同构负例：合并参数、抽助手 | 无需授权 |
| **TS-36** | 测试与资源 | `tests/集成/test_受控模型调用.py:141,499,716,837/858` | D1 | SSE 载荷块 5 处近似复制（`:124-146,231-251,472-489,644-654,781-802` ）；宿主装配块 7 处（`:150,499,668,808,846,867,892` ） `:720-732` 观测完全相同，无观测区分真 Pi 与直接循环：抽公共夹具并补可区分证据 | 无需授权 |
| **TS-48** | 测试与资源 | `tests/集成/test_发布包独立运行.py:161` | D1 | `assert not (tmp_path / ".git").exists()` | 刚建的空目录本就无 `.git` ，该断言恒真，证不了「无 Git 安装包」 | 无需授权 |
| **TS-49** | 测试与资源 | `tests/迁移/test_备份恢复与切换核对.py:175,249,469,494,525,550,585,664,485,515,540,575,597,621` | D1 | `assert 连.execute("SELECT to_regclass('public.muse_migration')").fetchone() == (None,)` 逐字 7 次；`def 记录(命令, 参数, 引用, 动作名):` 逐字 6 份；`assert 敏感标记 not in str(捕获.value.呈现())` （该配置从未带口令） | 抽公共助手；删恒真断言 | 无需授权 |
| **TS-53** | 测试与资源 | `tests/真实调用/test_诊断技能行为.py:177` ； `tests/端到端/test_诊断入口与只读边界.py:39` ； `tests/契约/test_诊断入口原观察.py:81` | D1 | `assert report["runtime_verified"] and report["model_verified"]` ； `assert result["mode"] == "service" and not result["model_verified"]` | `model_verified` 由提供方名推导（`编排/行为评测.py:340-349` ）与 `执行行为场景` 写死 `False` （ `效果评测/行为场景.py:234-246` ）→ 断言不可能失败；诊断入口断言只回显输入长度 | 无需授权 |
| **TS-33** | 测试与资源 | `tests/契约/test_角色能力与配置.py:189` | D6 | `for 文件 in (仓库根 / "配置").glob("*.toml"):` | 凭据扫描漏 `配置/角色策略.yaml` （当前该文件无凭据形状内容，属覆盖缺口） | 无需授权 |
| **TS-43** | 测试与资源 | `tests/集成/test_案例采集与复核.py:201,239,551,654` | D1 | `with pytest.raises((Muse错误, ValidationError)):` ； `match="作品｜四类"` | 三类非法输入接受任一异常族不核错误码； `:654-668` 与 `:689-703` 15 行块逐字相同 | 无需授权 |
| **TS-55** | 测试与资源 | `tests/夹具/` （ `tests/conftest.py:263` 、`tests/集成/test_任务租约与恢复.py:131` 、`tests/迁移/test_作品资产迁移.py:15` | D3 | 25 个夹具文件中 20 个全仓无测试消费者（`去味/*.yaml` 8、`方法审核/历史标定/*` 6、`旧看板/*` 3、`模型事件.json` 、`旧库样本.sql` 、`宿主事件/DSH历史事件.json` ） ； `def 夹具根()` 无人请求；`def 完成所有(…)` 从未被调用 | 删除或登记用途；死代码一并清理 | 需用户授权 |
| **TS-52** | 测试与资源 | `tests/架构/test_技能与文档索引.py:272,281,383` ； `test_元数据不能跨模块写值.py:20` ； `test_测试依赖与执行证据.py:119,164,402,419,439` | D1/D2 | `assert 资源["name"] == 条目["name"]` （ `读取能力` 返回 `{**条目,…}` ，恒真）；`if isinstance(节点, ast.Constant)…` ； `:402` vs `:439` ）
| **TS-37** | 测试与资源 | `tests/集成/test_两阶段写手.py:275,622,756,825,802-832,834` | D1 | `except Exception: self.send_error(500)` ； `with pytest.raises((Muse错误, RuntimeError, OSError)):` ； `assert any(s["state"] == "failed" for s in 终态.步骤)` | 宿主吞异常＋宽泛 raises 使宿主自身故障可冒充被测失败；`:802-832` 与 `:733-763` 复制；`:834` 未核对登记 `then` 的「输出合同 additionalProperties=false 拒绝」 | 无需授权 |
| **TS-50** | 测试与资源 | `tests/迁移/test_隔离目标台账.py:788,1586-1587,1892,2275,2308` 、`test_质量资产迁移.py:355,499` 、`test_作品资产迁移.py:15,105` | D1/D2 | `必表 = ("runs","events","reviews","revisions","cards")` ； `"card_id": "case-legacy-9"` ； `assert records[1]["original"]["record"]["status"] == "confirmed"` （上一行已全等） | 用例名「旧账本五表」实为 8 张；`card_id` 不符合真实 CHECK `^case-[a-z0-9]{20}$` ； `:1892` 参数行只断言自建快照构造失败；`:15` 死夹具别名、`:105` 与 `:243-263` 近似复制；`:2275` 套话 docstring | 无需授权 |
| **TS-35** | 测试与资源 | `tests/集成/test_受控模型调用.py:832,834,621,893,55,375` | D1 | `assert 行 is not None and 行[0] == …` （终态证据）；全部费用断言等于自带替身常量（`:87 Decimal("0.125")` ） `structured_output_hash` 零断言；期望值由被测 `组装角色请求` 产出；三种故障共用基类异常无 `match` ；合成提供方不校验 `Authorization` /`model` （
| **TS-26** | 测试与资源 | `tests/契约/test_盲评与引文合同.py:854,931,939` | D1 | `calls = []` … `assert calls == []` | 三处 `calls` 从未被写入（无替身/spy 引用）→ 恒真 | 无需授权 |
| **TS-39** | 测试与资源 | `tests/集成/test_审校报告与案例持久化.py:1021/1037/962/1052` 、`:241/249/267` 、`:261` 、`:850` | D1 | 四例结构相似度 0.91（登记 `then` 为 `None` ） ； `replace(请求, verbal_tics=("样张中不存在",))` 三处复本；`for 假审阅 in ("missing", "", "00000000-…")` 与 `:100-102` 逐字 | 复制用例成组：合并/参数化并补齐 `then` 登记 | 无需授权 |
| **TS-38** | 测试与资源 | `tests/集成/test_审校报告与案例持久化.py:1105,744,688,710,959,501,414,533,237` | D1/D2 | `assert 运行审校命令(…) == 服务读回` ； `assert not list(tmp_path.glob("*.inventory.json"))` ； `match="connection refused"` （消息由测试 stub 自写） | 同实现自比 4 处；`*.inventory.json` 全仓无产出代码 → 恒真；`match` 只证异常透传；`:533` 引用全仓不存在的「旧烟雾开关」；`:237` 的 `verbal_tics` 到 `声音确认.py:176` 才校验、本用例走不到 | 无需授权 |
## P3（
| 编号 | 模块 | 位置 | 方向 | 现状摘录 | 建议 | 所需授权 |
|---|---|---|---|---|---|---|
| **AG-26** | agent层 | `.agent/skills/操作/` 18 个技能（压缩正文、备份与恢复数据、导入资料、建立作品声音档案、拆解书稿、提出并验证改进、整理写作方法、整理定稿与导出、查看与恢复任务、检查与维护拆书结果、登记连载与反馈、确认事实增量、确认作者偏好、维护元数据结构、维护故事世界、记录机器味案例、运行效果评测、采集资料与榜单） | D3 | 除 `操作/目录.md` 的索引行外， （ `.agent/作者/场景/` 增入口 | 无需授权 |
| **AG-28** | agent层 | 15 个方法技能 `## 输出` 段 | D5 | 方法技能产出为对话内 Markdown， `写下一章` /`决定正文候选去留` 写 Canonical"，因此没有持久留痕与查询入口。 | 有意保留：留痕由承接的操作技能负责；若要沉淀，应在复利链落库 | 无需授权 |
| **AG-29** | agent层 | `.agent/skills/操作/` 30 个技能 | D5 | 未写 lesson/范式卡升格接入；这些是 CLI/HTTP 确定性入口，不产生经验资产（`整理写作方法` 已接入方法卡升格链）。 | 有意保留 | 无需授权 |
| **AG-30** | agent层 | `.agent/约束/数据与读取范围.md:6` | — | 写入旧正式库地址 `100.64.0.8:5433/muse-example` 作为"禁止回退"的反面清单。这是内网地址而非凭据（无账号口令），且服务于明确禁令。 | 有意保留；若仓要外发，改为占位符 | 无需授权 |
| **AG-27** | agent层 | `.agent/skills/操作/查看与恢复任务/SKILL.md:22` 、`.agent/skills/操作/运行效果评测/SKILL.md:54` | D2 | 各有一处连续空行；`.agent/` 内无行尾空白。 | 随手清理 | 无需授权 |
| **AG-25** | agent层 | `.agent/skills/操作/备份与恢复数据/SKILL.md:25` | D4 | 链接 `迁移与验收.md#备份与恢复入口` 用的是标题锚点，目标文档 `docs/系统架构/新版设计/迁移与验收.md:69` 确有同名标题（可达）；但本仓 `工具/维护索引.py:261` 的锚点约定是 `<a id="…">` ，该文档零处使用。 | 统一锚点约定（或在该标题加 `<a id>` ）
| **DR-24** | docs与根文件 | docs/实现回顾/（既有 4 文件） | D4 | 仅机械计数，不复查表述、不提修改建议。既有留痕（`专项检查-计划.md` 、`技能身份中文化迁移实现回顾.md` 、`目录.md` 、`R2改造历史留痕.md` ） ： `专项检查-计划.md:44` × `muse/content/meta/schemas/` 、`muse/lifecycle/flow/chains/` ； `:97` 指向尚未创建的 `专项检查-台账.md` ； `技能身份中文化迁移实现回顾.md:59` 指向 `tests/architecture/test_author_instructions.py` ）
| **WB-18** | web | `web/src/应用/工作台布局.tsx:35-54` | D2 | `<NavLink to="/works">我的作品<span>01</span></NavLink>` … `<NavLink to="/system">系统管理<span>07</span></NavLink>` —— 序号是硬编码装饰，与路由、顺序无数据关系，增删导航需手改两处 | 记录不改；若接受改造则由数组 `.map` 生成 | 记录 |
| **WB-19** | web | `docs/系统架构/新版设计/文件设计/前端-应用与通用界面.md:298,309,320,342,430,441,613,624,647,658,669,680,703` ； `前端-功能工作台.md:475,486,739,805,871,992,1003,1014,1025,1036,1047` | D7 | 24 个 web 目标文件（ `web/src/界面/分栏.tsx` 、`web/src/功能/元数据/结构管理页.tsx` 、`web/tests/交互/报告失效.test.tsx` ）在设计文档有条目但磁盘不存在。该文档首行已声明「本页从目标文件清单投影…文件和目标合同不代表实现或验收已完成」，且这些条目**未携带** `现行用例身份` （与已落地条目写法一致区分） | 保留为设计目标；若某目标已废弃，从 `目标文件清单.json` 撤下 | 需用户授权 |
| **JF-13** | 后端-交付连载上下文资料 | src/muse/交付连载/接口.py:44-158； `接口.py` 的单层转发与多数函数体内导入并非无证据抽象： `接口.py` ，且 知识方法/接口.py:257-271 反向 import 上下文，构成真实循环。 | 有意保留；只清 JF-08 列出的无理由延迟导入。 | 无需授权 |
| **JF-12** | 后端-交付连载上下文资料 | src/muse/资料研究/实体归并.py:73、src/muse/资料研究/实体归并.py:84、src/muse/资料研究/实体归并.py:92； `canonical` 与 `canonical_written` 是英文键，与 `docs/系统架构/新版设计/领域模型/术语表.md:37` "避免使用：自动正典"的口径不合；但两键已被 tests/单元/test_分章切窗与实体归并.py:59 与 tests/迁移/test_隔离目标台账.py:1966 断言。 | 记录不改：随下次契约版本一并改名为"规范名/已写正式"，本次只登记。 | 需用户授权 |
| **JT-16** | 后端-任务运行编排 | `配置/流程模板/*.yaml` （ `src/muse/资源/运行资源.zip` 内 `流程/*.yaml` | D3 | 机械核对： （ `配置/角色策略.yaml` 与 zip 内 `策略/角色.yaml` 亦相同）。属有意保留的"可审副本 + 发布投影"双物理副本，当前零漂移，本次不动 | 保留，但需同步纪律成文（改模板必须重打资源包，`工具/资源登记.json` 是唯一变更入口），否则下次改一份就漂移 | 无需授权 |
| **JW-21** | 后端-写手规划经验 | src/muse/作者经验、src/muse/正文写作、src/muse/作品规划（全组） | D3 | 三模块内 grep `lesson` /`范式卡` /`升格` 零命中，无升格链入口；`docs/系统架构/新版设计/模块设计/B07-作者经验.md:65` 已声明"Skill及其他用途尚无完整owner链时明确保持未实现" | 保留并在此台账登记为"有意未接"，避免下一轮重复发现 | 无需授权（记录） |
| **JW-20** | 后端-写手规划经验 | src/muse/作者经验/存储.py:19 | D6 | `self.连.execute(f"SELECT {fn}(hashtextextended(%s,0))", …)` ， `fn` 取自 `"pg_advisory_xact_lock_shared" if 只读 else "pg_advisory_xact_lock"` 二选一字面量，无用户输入进入 SQL 文本，实测不可注入；按 D6"SQL 字符串拼接"口径记录 | 拆成两条静态 SQL 更干净；保留亦可，理由：不可注入 | 无需授权（记录） |
| **JC-24** | 后端-基础设施共享 | `src/muse/基础设施/受控文件.py:1` vs `:96-101` | D1 术语漂移 | 模块 docstring 称"不透明租约ID"，实现与错误信息一律称 `对象ID` /`对象身份` ； `租约` 在 `共享` 与 S02 另有既定义 | 保留（改 docstring 属可选清理，无行为影响） | 记录不改 |
| **JC-23** | 后端-基础设施共享 | `src/muse/基础设施/宿主/Pi工具桥.ts:47` | D6 占位字面量 | `apiKey: "local-callback", baseUrl: "http://127.0.0.1:1"` —— 进程内回调提供方的占位值，紧邻注释已写明"这是进程内回调提供方， `apiKey: "in-process-callback-no-secret"` 之类自证非凭据的常量 | 记录不改 |
| **JC-25** | 后端-基础设施共享 | `src/muse/基础设施/系统运行.py:65-67` | D1 吞错判定 | `读取系统状态` 捕获 `(Muse错误, psycopg.Error, OSError)` 后只回 `error` 错误码、不抛；这是健康/系统状态接口的既有合同（ `可观测性.记录运行` （仍不带正文） | 记录不改 |
| **JS-20** | 后端-审校效果评测 | `src/muse/审校修订/存储.py:680` 、`:688` ； `src/muse/效果评测/存储.py:129` | D6 | `f"SELECT {lock}(hashtextextended(%s,0))"` ：插值只取 `pg_advisory_xact_lock` / `pg_advisory_xact_lock_shared` 两个字面量，锁键仍走 `%s` 绑定；无用户输入进入 SQL 文本，无注入面。记录不改 | 保留；若要更严可改 `psycopg.sql.SQL` 常量组合 | 无需授权（仅记录） |
| **JS-21** | 后端-审校效果评测 | `src/muse/审校修订/存储.py:684-697` | D1 | `+ (" FOR SHARE" if 共享 and 锁行 else "" if 共享 else " FOR UPDATE")` 三元嵌套可读性差，但语义正确（共享且不锁行时不取行锁，与 `诊断服务.py:24` 只锁库级共享的调用一致）。记录不改 | 保留；后续若改动加注释说明三态 | 无需授权（仅记录） |
| **JR-20** | 后端-接入 | `pyproject.toml:27` （ `muse = "muse.__main__:main"` ） `muse` 控制台脚本： （ `:66` ） `.agent/skills` 、测试全部用 `python -m muse` ； `muse.__main__.main` 本身有 55 处测试引用。属安装面有意保留 | 保留不改。理由：安装后 `muse <子命令>` 与 `python -m muse` 等价，删除会破坏已发布安装方式 | 无需授权 |
| **JK-20** | 后端-知识方法故事世界 | `docs/write-chapter/artifacts/` （ `writer-context-v1` 等合同， （
| **JK-21** | 后端-知识方法故事世界 | `src/muse/知识方法/模型.py:33-39` 与 `事实提案请求` | D1 | `证据引用` 用英文 `kind` 而相邻字段中文；库内 payload 键混用（`work_id` /`known_to` /`reader_visible` ）属 DB 合同 | 保留；改动需迁移，不属本轮 | 无需授权（记录不改） |
| **JK-22** | 后端-知识方法故事世界 | `src/muse/知识方法/方法版本.py:470-476` | D6 | `B04.binding` 依赖用 `对象ID.split(":")[1]` /`rsplit` 解析 `work_id` 与 `target_ref` ，构造方唯一（`方法版本.py:416` ）故当前安全 | 改结构化依赖对象，去掉字符串反解析 | 无需授权 |
| **TL-13** | 工具 | Makefile:4、65 | D7 | `.PHONY` 未列 `迁移` （ `迁移` 的文件或目录，当前不会触发「目标被跳过」 | 把 `迁移` 补进 .PHONY | 无需授权（仅记录） |
| **TL-14** | 工具 | 工具/环境预检.py、工具/构建发布.py； ） ， `uv run python 工具/…` / `.venv/bin/python 工具/…` 命令 | 记录为有意保留（发布与预检属人工步骤） | 无需授权（仅记录） |
| **MG-04** | 数据库迁移 | `数据库/迁移/` （ `IF NOT EXISTS` 出现 **0** 次、`DROP ... IF EXISTS` **0** 次； `CREATE TABLE` + 18 `CREATE INDEX` + 5 `CREATE VIEW` + 4 `CREATE TYPE` + 22 `ADD CONSTRAINT` + 51 `CREATE TRIGGER` + 7 `CREATE FUNCTION` 全部无重跑保护，全仓无一条 `BEGIN;` /`COMMIT;` | 属有意设计（事务与幂等由执行器统一承担，见证据指针），但迁移文件自身无一句说明。建议在 `数据库/迁移/` README 写清「单文件不自幂等、不可单独执行、必须经 `python -m muse 迁移` 」 | 无需授权（补文档） |
| **MG-03** | 数据库迁移 | `数据库/迁移/V0024__模型派发授权依据.sql:9` ； `数据库/迁移/V0041__评测语义检测单元.sql:2` | D6 | `'ALTER TABLE %I.muse_runtime_evidence DROP CONSTRAINT muse_runtime_evidence_kind_check'` / `ALTER TABLE evaluation.muse_evaluation_unit DROP CONSTRAINT muse_evaluation_unit_kind_check;` —— 硬编码名直接 DROP， `SELECT conname INTO ... FROM pg_constraint` ， `IS NULL` 时 `RAISE EXCEPTION` 。风险有限：两处均在 `迁移.py:109-110` 的逐版本事务内，失败整体回滚不留半成品 | 无需授权 |
| **MG-06** | 数据库迁移 | `数据库/迁移/V0009__正文写作.sql:30` ； `数据库/迁移/V0004__任务运行与证据.sql:189` ； `数据库/迁移/V0035__评测逐例执行.sql:13` ； `数据库/迁移/V0030__模型修订结果.sql:7` | D3 | 基线定义已被后续迁移改写：`origin text NOT NULL CHECK(origin='author')` 被 `V0021:16-20` 扩为 `('author','model')` ； `kind IN (4 值)` 被 `V0024:8-16` 扩为 5 值；`kind IN ('generation','comparison')` 被 `V0041:2-4` 扩为 3 值；`diagnosis_id` 的 `NOT NULL` 被 `V0032:2` 解除 | **不改** （历史留痕）。已应用迁移受校验和冻结，回改会被 `迁移.py:98-102` 拦截并拒绝启动，改基线等于制造事故。可选：在基线文件加「本定义已被 V00xx 扩展」注释，纯可读性收益 | 无需授权（仅注释）；不改则保留理由已成立 |
| **MG-05** | 数据库迁移 | `数据库/迁移/V0002__元数据结构与策略.sql:83` | D6 | `GRANT SELECT, INSERT, UPDATE ON ALL TABLES IN SCHEMA metadata TO muse_app;` 整 schema 一次性授予；而 `数据库/迁移/V0001__共享标识与版本.sql:55-56` 的默认权限反而含 `DELETE` | 统一为逐表 `REVOKE ALL` + 最小 `GRANT` （ –
| **MG-07** | 数据库迁移 | `src/muse/元数据/存储.py:189-196` | D3 | `"INSERT INTO metadata.schema_binding (target_ref, work_id, ...) VALUES (%s,...)"` 的实参是 `tuple(asdict(绑定).values())` ，列序隐式绑定 dataclass 字段序 | 改为具名传参或显式列出取值顺序。当前三方一致（`元数据/模型.py:178-185` 字段序 ↔ `V0002:40-53` 列序），故仅记风险 | 无需授权 |
| **LM-07** | 旧库迁移 | 数据库/旧库迁移/导入新库.py:305 | D6 | `raise 迁移错误("target_denied", "本次新库身份缺失或改变，保留定位文件不清理")` | 目标库身份无法复核时保留 `维护连接.txt` ／ `应用连接.txt` （ ， ） （ `旧知识记录分流.md` 「先落私有连接引用」），记录不改 | 无需授权 |
| **TS-60** | 测试与资源 | `pyproject.toml:62` 、`tests/conftest.py:27,35` | D3 | `"网络: 需要真实网络访问；必须显式标记"` ； `--用例清单` 选项 | 全仓 0 用例使用 `网络` ； `--用例清单` 无任何入口传入：保留为防护阀/维护能力并注明理由 | 无需授权 |
| **TS-62** | 测试与资源 | `tests/集成/test_审校报告与案例持久化.py:1105` 、`tests/集成/test_任务租约与恢复.py:175` 、`tests/迁移/test_隔离目标台账.py:2308` | D2 | `assert 运行审校命令(…) == 服务读回` （
| **TS-61** | 测试与资源 | `tests/迁移/test_隔离目标台账.py:2275` | D2 | `"""真实PG用例； | 上游派发流程套话（实际由 `pytestmark` /Makefile 决定）：保留或改写 | 无需授权 |
## 各模块一句话结论（
| 模块 | P0 | P1 | P2 | P3 | 一句话结论 |
|---|---|---|---|---|---|
| 后端·接入（ ：
| 后端·基础设施+共享（ ） ） ； `JC-01` /`JC-02` ）与一批零消费者导出面。 |
| 后端·审校修订+效果评测（ ） ； （
| 后端·任务运行+编排（ ） `JT-01` ）、角色探针旁路预算与留痕（`JT-02` ）。 |
| 后端·交付连载+上下文+资料研究（ ）
| 后端·作者经验+正文写作+作品规划（ ） ） ；
| 后端·知识方法+正式变更+故事世界+元数据（ ） ； （
| tests + 资源（ （
| web（ ） `dangerouslySetInnerHTML` 、零凭据、零 `any` 、零幻路径注释；问题是同一件事多文件各写一遍、用例 id 与清单/文档三方不一致。 |
| 数据库迁移（
| 数据库/旧库迁移（ （
| 工具（ ） `shell=True` 、无硬编码绝对路径，
| .agent（
| docs 权威区 + 根文件（ ） （ `新版设计/` 零死链）；但 `AGENTS.md` 本身是最大污染源（
## 豁免与边界（本轮查了什么、没查什么、为什么）
**已全量精读/全量机械核对**
- 后端 `src/muse` **300 个 .py** （按 17 个业务子包分 8 组，无一抽样）；`src/muse/资源` 仅一致性（产物不读）。
- `tests` **157 个 .py** ：架构 5、契约 19、迁移 10、端到端 3、真实调用 1 全读；单元抽 10、集成抽 15（ ）
- `web/src` 114 + `web/tests` 53：
- `数据库/迁移` 45 SQL 全量机械 + 基线 V0001 与最新 3 个精读；`数据库/旧库迁移` 21 .py 机械门禁 + 3 个关键文件精读（映射台账/切换检查/入口）。
- `工具` 7 文件全读；`.agent` 252 文件全读（
- `docs` 权威区 + 根文件 + 两个 workflow 全读；`docs/实现回顾` 既有留痕仅机械计数。
**免检与豁免（照计划第 1、4 节）**
| 对象 | 处置 | 理由 |
|---|---|---|
| `docs/实现回顾/` 既有留痕（ ： ； ： ， （ `<模块>` 占位与 `skills.json` ）
| `数据库/旧库迁移` 的命名/风格/注释 | D2 泔水与风格要求**豁免** | 计划第 4 节明示「有意 legacy 域」；仍查事实错误、链路、安全 |
| `src/muse/资源/工作台` 、`运行资源.zip` 、`docs/接口契约/生成/openapi.generated.json` 、`web/src/接口/生成/类型.ts` | 只验与权威同步，不评质量 | 生成物/构建产物；
| `docs/接口契约/生成/` 之外的 `.venv` 、`node_modules` 、`__pycache__` 、`.zcode` 、`data/` 、`.agents.local/` | 不查 | 缓存、本地环境、个人配置、创作数据 |
| 数据库内容、创作正文（含 `data/sources/` ）、`data/muse.db` | 不读不改 | 硬边界：不动数据库、不读创作正文 |
| `make 数据库测试` 、`make 真实模型测试` 、`make 宿主测试` 、备份恢复演练 | 未跑 | 计划「本轮不跑数据库测试（
| `make 生成` 、`make 构建` 、`make 格式写入` 、`维护索引.py --写入` | 子代理一律未跑（只静态核对）；主代理经授权跑过一次 `make 生成` | 写模式会覆盖生成物；`make 生成` 的授权与证据见 §4 |
| `tests/迁移` 对真实 PG 的行为、`数据库/迁移` 在真实 PG 上可跑通 | 无证据 | 未连库；
**未取得原始退出码的门禁**： `make 模块边界` 原样命令在本沙箱不可执行（`uv` 缓存 + macOS `sandbox_init` 双重被拒）；内容侧等价证据为 `--外部环境` 下 15 passed， `make 测试` 1005 passed（ ）
## 处置声明与硬边界
- 本轮为**只读专项检查**。除下列三项外未改动任何文件：`docs/实现回顾/专项检查-报告-*.md` （ `docs/实现回顾/目录.md` 的登记行。
- **唯一一次越出「只读」的动作** ：经用户 2026-09-16 明确授权（ `make 生成` ，重写了被 `.gitignore:36` 忽略的生成物（`src/muse/资源/` 、`web/dist` 、`docs/接口契约/生成/` 、索引）。**受跟踪文件零改动**（ `git status --untracked-files=no` 仅剩本批报告与 `目录.md` ）。
- `git add` / `git commit` 全程未执行。**修复另立计划；未获授权不动手。**
- 台账每条二值收口：`待授权` （需用户点头）/ `保留（理由）` （ `已处置（证据）` （仅 `JC-01` 的本地部分）。
- 另一会话提交期间的时点声明：开工快照 2026-09-16T20:30:04+08:00， `f76c3cd04a8b4d461a5e004b36962900db943729` ； `git status` 当时仅有 `docs/实现回顾/目录.md` 的未提交改动与未跟踪的计划文件，判定为「未收口」，故计划第 2 节的「.gitignore 与跟踪文件交集」原定延后；实际于 20:43:37 复检（跟踪 1320 / 命中 0）
## 证据指针（命令 + 退出码 / 校验结果）
| 证据 | 位置 |
|---|---|
| 全部门禁首轮与刷新后原始输出 | `/tmp/qc/门禁结果.txt` 、`/tmp/qc/门禁结果-uv.txt` 、`/tmp/qc/门禁结果-复跑2.txt` |
| P0 门禁红证据档（时间线 + 三步根因探针） | `/tmp/qc/P0-门禁红-证据.md` |
| 代码哈希三向比对（清单/HEAD/工作树， `/tmp/qc/probe4.py` |
| 安装核对与资源一致性探针 | `/tmp/qc/probe5.py` |
| Markdown 链接机械校验（ `/tmp/qc/链接校验.py` 、`/tmp/qc/死链结果.txt` |
| 反引号路径引用校验（ ） `/tmp/qc/反引号校验.py` 、`/tmp/qc/反引号死链.txt` |
| docs 子代理链接校验（口径 A/B/C 与 R2 穷举） | `/tmp/lc2.py` 、`/tmp/lc2.json` 、`/tmp/lc2-summary.txt` （子代理落盘） |
| 台账条目抽取与去重（ `/tmp/qc/台账/生成5.py` 、`/tmp/qc/台账/抽取结果.txt` |
| 各模块命令与退出码、逐条 file:line | 各报告「证据指针」节（
> 上述 `/tmp` 路径为一次性探针与日志，不入库；报告内已保留可复现命令与判定结果。
zizi