` —— 索引 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: "未决定"`（候选审阅）vs `undecided: "待决定"`（规划工作区）；`adopt: "已采纳"`（候选审阅、决策面板）vs `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 | `` —— 直接渲染作者填写并落库的地址；来源表单 `:433` 是 `type="url"`，而 `javascript:`／`data:` 同样能通过 url 类型校验，React 不拦截 `href` 协议 | 渲染前校验 `new URL(x).protocol` ∈ {http:, https:}，否则降级为纯文本 | 需用户授权 | | **JF-07** | 后端-交付连载上下文资料 | src/muse/上下文/材料装配.py:4、src/muse/上下文/材料装配.py:26；src/muse/上下文/任务范围.py:494-503；src/muse/编排/生成规划.py:272、生成正文.py:608、审校修订.py:131、审校修订.py:190、完整审校.py:137 | D1 | 预算单位（UTF-8 字节、明确不是 tokenizer）与来源（任务冻结 `budget.context_bytes`）只写在代码注释；默认值 `65536` 在编排侧重复 5 处，其中 审校修订.py:190 直接以常量传 `字节上限=65536` 绕过任务预算。 | 把"字节单位 + 预算取自任务冻结输入"写进 B09 模块设计与文件设计；`65536` 收敛到单一常量并禁止绕过任务预算的调用。 | 无需授权 | | **JF-09** | 后端-交付连载上下文资料 | src/muse/资料研究/榜单快照.py:17-20、src/muse/资料研究/榜单快照.py:23；src/muse/基础设施/资料来源/榜单读取.py:10-13、网页读取.py:10-13 | D6 | 外部抓取只有 Protocol：无实现、无超时/重试/退避口径，"真实网络实现必须显式标记"没有判定机制；基础设施两个同形 Protocol 全仓零消费者；`登记榜单` 与 HTTP 路由（接入/http/路由/资料研究.py:147-151）不校验 URL scheme/主机，而 交付连载/发布登记.py:21-22 校验 http/https，口径不一致。HTTP 层 fail-closed（路由:159-161 无读取器返回 503），无静默降级。 | 在 B03 写死外部抓取合同（超时、重试次数、退避、编码、礼貌策略、失败保留失败态），实现落地时复用同一 Protocol，并给 `登记榜单` 加 scheme 白名单。 | 需用户授权 | | **JF-06** | 后端-交付连载上下文资料 | src/muse/上下文/任务范围.py（835 行）；src/muse/上下文/依赖校验.py:34；src/muse/上下文/回放材料.py:56 | D1 | `任务范围.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"]))`：实测写入中途失败留下残件（104 字节），重试因排他创建抛未捕获 `FileExistsError`；无"临时文件 + rename"原子落盘。排他创建已能阻止覆盖既有文件，路径由本地作者给出。 | 同目录临时文件写完再 `os.replace`；捕获 `FileExistsError` 给作者中文提示。 | 无需授权 | | **JF-11** | 后端-交付连载上下文资料 | src/muse/上下文/回放材料.py:140（`def choose`）、该文件 47 个非中文本地变量；src/muse/交付连载/导出格式/EPUB.py 55、Word.py 53、导出格式/__init__.py 31 | D1 | `.agent/规范/命名.md:5` 要求自有业务目录/文件/模块/类/函数/测试名中文优先；同包 `任务范围.py`（9）、`资料研究/分章切窗.py`（0）已是中文风格，两种风格并存。 | 统一改为中文局部名与中文私有函数名；请求/载荷里已是稳定身份的英文字段（work_id、branch_id 等）不动。 | 无需授权 | | **JF-08** | 后端-交付连载上下文资料 | src/muse/交付连载/接口.py:158（与同文件 :14 重复）；src/muse/资料研究/存储.py:31；src/muse/上下文/依赖校验.py:245-247；src/muse/资料研究/接口.py:98；src/muse/资料研究/文本清理.py:100 | D1 | 三域函数体内延迟导入 45 处，其中至少 5 处没有循环依赖理由：同包 上下文/冻结快照.py:17、资料研究/分析保存.py:16 已在模块顶层导入同一符号。 | 无循环依赖的提到模块顶层；确因 知识方法↔上下文 循环必须延迟的，补一行原因注释（见 JF-13）。 | 无需授权 | | **JT-09** | 后端-任务运行编排 | `src/muse/任务运行/原文生命周期.py`（905 行）、`接口.py`（682）、`预算管理.py`（661）、`存储.py`（632）；`src/muse/编排/生成正文.py`（639） | D1 | `find src/muse -name "*.py" -exec wc -l {} +` 显示本组 5 个文件超 500 行。圈复杂度热点（ast 脚本，含推导式/布尔运算计 1）：`生成正文.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）把热点固定下来；随后按"旅程壳 + 处理器工厂"拆 `登记生成正文`（46 个闭包同处一函数）与 `运行证据.保存`（字段校验矩阵） | 需用户授权（改 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（data/muse.db，gitignore）是默认派发与单机工作面的运行态账本…运行留痕（runs/events）…落在其中`。实现：`grep -rn "sqlite" src 工具 Makefile pyproject.toml` 命中 0；运行留痕实际全在 PG（`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 租约执行 → 固定正文版本 → 摘要／B02 事实提案／B09 索引 → 完成前来源复检。` 实现：`来源复检`（post.verify）是**第一步**，之后 4 步只按冻结 revision 读历史正文（`读取正文依据(..., 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"（S02 文档 `: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–24:00 只有 4 小时；且边界小时数是硬编码常量，`额度策略.时区` 可配但边界不可配 | 文档写明"四段 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 常量传进来（schema 仍走 `sql.Identifier` + 参数化，无注入风险，但边界声明失真） | ① 抽到一个公共模块（如 `编排/步骤上下文.py`）。② 角色集合从 `角色策略目录.从发布包()` 取，删除两份 frozenset。③ 或把 `存储.查询` 的自述改为"供任务运行所属模块共用，schema 由调用方指定不得来自外部输入"，或把这两处 SQL 下回收进 `存储` | 无需授权 | | **JT-15** | 后端-任务运行编排 | `src/muse/编排/研究拆书.py:300-304` 对照 `src/muse/任务运行/接口.py:548-557` | D7/D1 | `任务ID = 装配.任务运行.创建任务(请求, 流程身份, 流程版本)` 之后才 `if 配置ID: 配置版本管理(...).冻结到任务(...)`。而 `接入/http/路由/资料研究.py:45` 的 `config_id: str ｜ None = None` 是可选字段，因此不传配置时**会创建一个注定在"绑定分析配置"步骤失败的任务**。同一仓的 `任务登记参与者` 明确避免这种任务：`# 部署未声明抽取配置时不登记注定失败的任务`（`接口.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`）。同理 `事件类型.等待作者`（"task.waiting"）在 `事件记录.py` 白名单内，但无任何生产者，`web/src/功能/任务运行/数据.ts` 的事件名表也没有它 | 删除这六处代码内流程定义（流程模板是唯一来源），或反过来让模板缺失时回退到它们；删除 `等待作者` 枚举与白名单项 | 无需授权 | | **JW-18** | 后端-写手规划经验 | src/muse/作品规划/提示词/细化章节计划.md:1；src/muse/作品规划/近期细化.py:29；docs/系统架构/新版设计/模块设计/B01-作品规划.md:41 | D1 | 一个概念两个名：提示词文件名"细化章节计划"，而同模块代码与模块设计一律称"细纲"（`查章规划(..., "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；src/muse/正文写作/接口.py:382 | D3 | `写作粒度集()` 的 `expand_scene`/`edit_selection` 无生产消费者：唯一调用点 `编排/生成正文.py:557` 先拒绝非 `new_chapter`（HTTP/CLI schema 亦为 `Literal["new_chapter"]`）；且 `创建写作任务` 只在基线为 0 时约束粒度，实测 `写作任务合同(粒度="expand_scene", 基线=3, 选区=())` 通过（仅 `edit_selection` 强制选区） | 明确保留为 API 能力并在文件合同注明无生产调用，或收窄 `其他粒度` 的接受条件 | 需用户授权 | | **JW-13** | 后端-写手规划经验 | src/muse/作品规划/进度查询.py:21；src/muse/作品规划/探索交接.py:109 | D1 | 生产代码用 `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`），500 章即约 1000 次连接获取 | 增加批量读取入口或由调用方传入连接 | 需用户授权 | | **JW-17** | 后端-写手规划经验 | src/muse/正文写作/候选版本.py:38；src/muse/作品规划/模型规划.py:1；配置/流程模板/生成规划.yaml:1 | D2 | 术语偏差：代码 docstring 与流程模板注释出现 `Shadow`（"任务事务内保存 Shadow 与模型来源"、"受控规划的动态输出合同与 Shadow 候选出口"、"规划只产出 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；src/muse/作者经验/运行观察.py:20-145；src/muse/作品规划/探索交接.py:28-73 | D1 | 复杂度热点（AST 计圈复杂度）：`核验规划` 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；src/muse/作者经验/存储.py:22-45；src/muse/正文写作/写作任务.py:67-69 | D1 | 同一文件内中英混用：`存储.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/编排/` 全无引用（grep "节奏" 在接入目录零命中） | 明确登记为"已实现未接线"并注明接线路标，或接入规划表单/进度查询 | 需用户授权 | | **JW-05** | 后端-写手规划经验 | src/muse/作品规划/分层规划.py:275-283；src/muse/作品规划/接口.py:290 | D1 | `节奏分布` 进入 `接口.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`（1018 行）、`数据归档.py`（547 行） | D1 复杂度 | 两个文件超 500 行；`创建备份` 102 行、`恢复备份` 99 行、`_数据库摘要` 93 行、`直接调用.准备` 96 行、`Pi.运行` 83 行（AST 实测） | 按职责拆分（备份的"清单校验/数据库摘要/客户端调用"三段可独立成模块），拆前先补该文件的单元覆盖 | 择机修 | | **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 写"余弦相似与倒数排名"，本文件只有 `余弦相似`/`向量得分`；RRF 融合实现在消费者 `src/muse/上下文/混合检索.py:19` | 改述为"余弦相似打分；倒数排名融合由上下文层承担" | 择机修 | | **JC-20** | 后端-基础设施共享 | `src/muse/基础设施/资料来源/网页读取.py:1,11` | D2 自相矛盾 | 模块 docstring"失败如实上抛"，协议 docstring"失败返回失败结果"（同一文件两种失败语义） | 与该模块的最终处置（JC-06）一并定稿，只留一种失败语义 | 择机修 | | **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 …` 全仓零命中（18 个再导出名无消费者，消费方一律直接导入子模块）；`配置.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`） | 新改的代码统一中文命名；不做全仓批量重命名（收益低于 diff 风险） | 择机修 | | **JS-18** | 后端-审校效果评测 | `src/muse/审校修订/接口.py`（函数内 import 21 处）、`src/muse/效果评测/接口.py`（25 处） | D1 | 两个公开面模块大量在方法体内做 import（多为规避循环依赖），读公开面时无法一次看到该用例的真实依赖与落点 | 把不参与循环的 import 上提；确实循环的用模块级 `TYPE_CHECKING` + 运行时延迟导入并加一行原因注释 | 无需授权 | | **JS-14** | 后端-审校效果评测 | `src/muse/效果评测/逐例执行.py`（991 行）、`效果评测/接口.py`（946）、`审校修订/存储.py`（901）、`审校修订/持久返修.py`（812）、`效果评测/规则诊断.py`（717）、`审校修订/接口.py`（588）、`效果评测/文学评分.py`（503）；复杂度：`指标汇总.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%）；497 个函数中 67 个圈复杂度 ≥15，5 个 ≥70，均在"应保持确定性可复核"的报告组装与判据路径上 | 按职能拆文件（如 `逐例执行` 拆计划/交付/核验、`指标汇总` 把五类指标拆成子函数），或抽出具名私有步骤函数 | 无需授权 | | **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`） | D1 | 同一阈值在多处重复字面量：返修轮数上限 5 出现 ≥4 次、评分 0-10/0.5 出现 ≥4 次；语境窗口同时存在 12 与 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`（546 行）、`src/muse/接入/cli/入口.py`（527 行） | D1 | 全域仅这两个文件超 500 行（`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 个动作项在权威文档（README/`.agent`/`docs`/`配置`/Makefile）从未出现**；18 个 CLI 适配函数中 **10 个无任何测试引用**（`运行交付命令`/`运行作品命令`/`运行探索命令`/`运行规划命令`/`运行创作命令`/`运行审阅命令`/`运行维护任务命令`/`运行角色行为命令`/`运行行为评测`/`运行评测命令`） | 对无文档无测试的动作做一次清点：保留的补进 README 或对应 SKILL（至少写用途与前置配置），确无产品用途的删掉；不必逐条补测试，但每个动作要有明确使用方 | 需用户授权（删减 CLI 面） | | **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 | 圈复杂度（ast 自算，含 if/for/try/with/布尔/推导/断言）：`运行审校命令` **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`（:52）后叫 `装配`（:87），`知识方法.py` 同样混用；② 调用身份在 CLI 四个模块里分别叫 `identity`/`actor`/`作者`/`身份`；③ 服务对象叫 `svc`（`作者经验.py:67`）又叫 `service`（:164）；④ 只读工具 docstring 写"历史文稿"（:5,:42），同文件代码写"历史正文"（:13,:33）。违反 `.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/CLI 都调它；④ 合并为 `接入/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；补一条"白名单 ⊆ choices 且每个写动作都过门禁"的用例 | 无需授权 | | **JK-11** | 后端-知识方法故事世界 | `src/muse/知识方法/方法卡.py:1,172` + `docs/系统架构/新版设计/模块设计/B04-知识方法.md:31,42` | D7 | 「六类范式／六类内置」；内置结构里 `实例族` 含 `method` 的实为 8 型：character/combat/craft/emotion/pacing/scene_pattern/style/trope | 改为"内置范式类型以 S04 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` 在参与者内部完成 | 删死映射；S01 文档改写为"结构/投影由 S04 参与者保护" | 无需授权（文档改动需授权） | | **JK-10** | 后端-知识方法故事世界 | `src/muse/元数据/内置结构/公共字段.yaml:25-97` vs `src/muse/元数据/扩展合成.py:23-36` | D2 | 「受保护骨架」8 项（无 `created_at`/`updated_at`），代码 `保护属性` 10 项；yaml 自述"仅用于描述"，两份清单已漂移 | 由代码清单派生成文档，或补齐两行 | 无需授权 | | **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，二者同为 method 族），且 `作品范围: same_work` 用于系统侧档案对象 | 补齐 method 族目标类型，并核对系统侧档案的作品范围语义 | 需用户授权（涉及结构发布） | | **JK-18** | 后端-知识方法故事世界 | `src/muse/知识方法/方法版本.py`（536 行）；`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「启用需指向实际消费回执」与实现（必须 B10 启用凭据，`状态参与者` 亦然）冲突 | 删预留分支；docstring 改「启用必须提供 B10 凭据」 | 无需授权 | | **JK-19** | 后端-知识方法故事世界 | `src/muse/知识方法/方法版本.py:515-536`、`方法卡.py:190-200`、`故事世界/人物关系.py:122-128` | D1 | `__all__` 导出 13 个本包外零引用的名字（8 个参与者类、`读取方法结构`、`列出人物`/`列出关系` 等），公开面宽于真实消费者 | 收窄 `__all__` 到对外合同 | 无需授权 | | **TL-07** | 工具 | 工具/构建发布.py:25-39；Makefile:70-74 | D1 | 生成序列（生成接口.py → openapi-typescript → pnpm build → 构建资源包.py）在工具与 Makefile 各写一份，当前逐条一致，任一侧改序或加步都会静默漂移 | 序列只留一处（Makefile 目标或共享函数），另一处调用它 | 需用户授权 | | **TL-09** | 工具 | 工具/生成接口.py:29 | D1 | `argparse.ArgumentParser(description="生成 Schema、OpenAPI 和 TypeScript")` 与实际不符：只写 OpenAPI 与固定 客户端.ts；类型.ts 由 Makefile:71 与 构建发布.py:26-37 的 openapi-typescript 产出，「Schema」从不产出 | 描述改成实际产物 | 需用户授权 | | **TL-08** | 工具 | 工具/维护索引.py:48（同族 :169） | D6 | `根.rglob("目录.md")` 无法剪枝忽略目录，`_在忽略目录` 只在命中文件上判定（:49-50）；实测仍下钻 .venv（1140 个目录）与 web/node_modules（2381 个目录），整轮 1.5s。实测 Python 3.12.6 的 `rglob` 与 `glob("**")` 均不跟随符号链接，无软链风险 | 改 `os.walk` 剪枝，或把忽略目录收进显式候选根 | 需用户授权 | | **TL-11** | 工具 | 工具/环境预检.py:91-97；工具/生成接口.py:39 | D1 | 前者把 `OSError/ValueError/KeyError/SubprocessError` 归并为一条通用 JSON，丢掉实际原因（退出码仍为 1，未伪成功）；后者 `条目["工厂"].split(":", 1)` 在缺冒号时抛裸 ValueError 回溯 | 通用分支保留原始异常文本；工厂格式先校验再报错 | 需用户授权 | | **TL-10** | 工具 | 工具/构建资源包.py:146 | D6 | `shutil.copytree(web_dist, 工作台目录)` 默认 `symlinks=False`：web/dist 内符号链接会被解引用，把链接目标内容复制进发行包（本组唯一跟随软链处） | 用 `symlinks=True`，或逐文件复制并按清单校验 | 需用户授权 | | **TL-12** | 工具 | 工具/资源登记.json:237-263；工具/构建资源包.py:67 | D1/D2 | 22 个已登记操作技能身份两套命名：16 个带 `operation.` 前缀（operation.polish-text 等），6 个不带（expand-scene、inspect-task 等）；包内路径 `能力/operation/operation.polish-text.md` 与 `能力/operation/expand-scene.md` 并存 | 统一身份命名口径后重建资源包 | 需用户授权 | | **TL-06** | 工具 | 工具/维护索引.py:269-274；Makefile:74 | D1 | `--检查` 解析后从未被引用（死参数）；`--写入` 仅 `print("索引写入：当前无可写生成物，执行幂等检查")`，随后执行与默认完全相同的只读检查。实测默认态与 `--检查` 态退出码均 0 且输出一致，Makefile「生成索引」为虚设语义 | 删除两个空开关，或在 `生成` 目标改调 `--检查` 并在注释写明无索引生成物 | 需用户授权 | | **MG-01** | 数据库迁移 | `src/muse/基础设施/数据库/迁移.py:52-54` | D3 | `if 版本 in 已见: raise 迁移错误(f"迁移版本重复：V{版本:04d}")` —— 执行器只拦重号，从不校验编号连续性，空洞无法被机械发现 | 在 `列出迁移` 末尾加一条连续性或白名单校验；同步在 `数据库/迁移/` 加 README 或 `迁移登记.json`，逐个写明 10 个空缺的成因（当前仅 V0011 有） | 无需授权（新增校验与登记文件） | | **MG-02** | 数据库迁移 | `docs/系统架构/新版设计/文件设计/数据库与迁移.md:76-77`（另 `:242`、`:264`） | D3 | 文件树把 `V0013__上下文与检索索引.sql`、`V0015__运行配置版本.sql` 与既有迁移并列列出，`docs/系统架构/新版设计/项目目录与文件职责.md:1603-1604` 同；两文件实际不存在 | 在这两处就地标注「目标编号，实现落于 V0022/V0004」；或在目标清单里改挂实际编号 | 无需授权（文档标注；与 docs 模块检查方向 D4/D7 重合，建议由 docs 报告统一处置） | | **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 张（PostgreSQL 58 + SQLite 8），分流规则显式承接 26 张，其余 40 张无任何规则（PG 39 张 + SQLite `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「测试名使用中文」：批量改中文名（case_id 身份不变） | 需用户授权 | | **TS-56** | 测试与资源 | `tests/用例清单.json`（45 条 environment、249 条缺 then） | D2 | `"隔离PG/合成HTTP及浏览器"`、`"隔离PG与合成资料；含实际CLI子进程和HTTP"` 等表述挂在无对应依赖的符号上 | 环境字段区分「本用例执行」与「同文件另有旅程/子进程」；与 TS-04、TS-06、TS-12 一并收口 | 无需授权 | | **TS-58** | 测试与资源 | `tests/夹具/`（25 文件） | D3 | 计划 §3 D3 写「`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；段注释自称「不引用旧 SQL」而 `: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`；docstring「独立成对选择由原观察集成测试另行核验」 | 守卫在 `--离线` 路径不可达（`入口.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–0.97）；跨文件逐字断言块 | 参数化合并，保留参数分支 | 无需授权 | | **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(评测错误):`；5 个字段同由 `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(归档错误):`（8 处同类裸断言） | `数据归档.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与合成资料；含实际CLI子进程和HTTP"`，实测仅 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（500/401 也算「候选未启用」）；`: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）+ 公共字段只采样 2 个结构：补逐结构清单核对 | 无需授权 | | **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)` | 两个「原」类名全仓不存在；SQL 替身未命中静默 `None`；docstring 的「在进库前/可保存」无对应动作；多例违约只断同一异常类型 | 无需授权 | | **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 从不产生（半句恒真）；注释「7项盲评原观察」「旧"错误适配器角色拒绝"」全仓唯一且无对应；四处逐字同构执行序列 | 无需授权 | | **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`） | Pi 行与 direct 行在 `: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="作品｜四类"` | 三类非法输入接受任一异常族不核错误码；5 处用全局基类异常；或分支匹配无法区分规则；`:654-668` 与 `:689-703` 15 行块逐字相同 | 无需授权 | | **TS-55** | 测试与资源 | `tests/夹具/`（20 文件）、`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)…`；docstring「--case 与标记取交集」 | 三条架构门禁弱化/恒真 + 两处近似逐字用例（`: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")`） | 合成载荷的 model/usage/`structured_output_hash` 零断言；期望值由被测 `组装角色请求` 产出；三种故障共用基类异常无 `match`；合成提供方不校验 `Authorization`/`model`（tests 全目录无凭据外发正向断言）；步骤入口为恒真空壳 | 无需授权 | | **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（原始 34 条 → 去重后 34 条） | 编号 | 模块 | 位置 | 方向 | 现状摘录 | 建议 | 所需授权 | |---|---|---|---|---|---|---| | **AG-26** | agent层 | `.agent/skills/操作/` 18 个技能（压缩正文、备份与恢复数据、导入资料、建立作品声音档案、拆解书稿、提出并验证改进、整理写作方法、整理定稿与导出、查看与恢复任务、检查与维护拆书结果、登记连载与反馈、确认事实增量、确认作者偏好、维护元数据结构、维护故事世界、记录机器味案例、运行效果评测、采集资料与榜单） | D3 | 除 `操作/目录.md` 的索引行外，无任何作者场景、角色、规则或其他技能引用它们。索引行本身构成合法入口（AGENTS.md → 目录 → SKILL.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` 的锚点约定是 ``，该文档零处使用。 | 统一锚点约定（或在该标题加 ``） | 无需授权 | | **DR-24** | docs与根文件 | docs/实现回顾/（既有 4 文件） | D4 | 仅机械计数，不复查表述、不提修改建议。既有留痕（`专项检查-计划.md`、`技能身份中文化迁移实现回顾.md`、`目录.md`、`R2改造历史留痕.md`）：Markdown 仓内链接 6 条、死链 0 条；反引号仓内路径引用 30 条、死引用 4 条（`专项检查-计划.md:44` ×2 指向 `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 | `我的作品01` … `系统管理07` —— 序号是硬编码装饰，与路由、顺序无数据关系，增删导航需手改两处 | 记录不改；若接受改造则由数组 `.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 目标文件（17 源码 + 7 测试，如 `web/src/界面/分栏.tsx`、`web/src/功能/元数据/结构管理页.tsx`、`web/tests/交互/报告失效.test.tsx`）在设计文档有条目但磁盘不存在。该文档首行已声明「本页从目标文件清单投影…文件和目标合同不代表实现或验收已完成」，且这些条目**未携带** `现行用例身份`（与已落地条目写法一致区分） | 保留为设计目标；若某目标已废弃，从 `目标文件清单.json` 撤下 | 需用户授权 | | **JF-13** | 后端-交付连载上下文资料 | src/muse/交付连载/接口.py:44-158；src/muse/上下文/任务范围.py:104-310 | D1 D3 | `接口.py` 的单层转发与多数函数体内导入并非无证据抽象：tests/架构/test_模块依赖.py:203-234 强制跨模块只经 `接口.py`，且 知识方法/接口.py:257-271 反向 import 上下文，构成真实循环。 | 有意保留；只清 JF-08 列出的无理由延迟导入。 | 无需授权 | | **JF-12** | 后端-交付连载上下文资料 | src/muse/资料研究/实体归并.py:73、src/muse/资料研究/实体归并.py:84、src/muse/资料研究/实体归并.py:92；src/muse/资料研究/分析保存.py:183 | D2 D1 | 载荷键 `canonical` 与 `canonical_written` 是英文键，与 `docs/系统架构/新版设计/领域模型/术语表.md:37`"避免使用：自动正典"的口径不合；但两键已被 tests/单元/test_分章切窗与实体归并.py:59 与 tests/迁移/test_隔离目标台账.py:1966 断言。 | 记录不改：随下次契约版本一并改名为"规范名/已写正式"，本次只登记。 | 需用户授权 | | **JT-16** | 后端-任务运行编排 | `配置/流程模板/*.yaml`（11 个）与 `src/muse/资源/运行资源.zip` 内 `流程/*.yaml` | D3 | 机械核对：11/11 文件名对应且**逐字节相同**（`配置/角色策略.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"` —— 进程内回调提供方的占位值，紧邻注释已写明"这是进程内回调提供方，不发HTTP"，不是可用凭据 | 保持现状；如需零扫描噪音可改名为 `apiKey: "in-process-callback-no-secret"` 之类自证非凭据的常量 | 记录不改 | | **JC-25** | 后端-基础设施共享 | `src/muse/基础设施/系统运行.py:65-67` | D1 吞错判定 | `读取系统状态` 捕获 `(Muse错误, psycopg.Error, OSError)` 后只回 `error` 错误码、不抛；这是健康/系统状态接口的既有合同（docstring 声明"不暴露凭据值"），且不含凭据与异常正文 | 保留；若后续要求诊断可追溯，改为同时落一条 `可观测性.记录运行`（仍不带正文） | 记录不改 | | **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"`） | D3 | 仓内没有调用点使用安装后的 `muse` 控制台脚本：Makefile（`:66`）、README、`.agent/skills`、测试全部用 `python -m muse`；`muse.__main__.main` 本身有 55 处测试引用。属安装面有意保留 | 保留不改。理由：安装后 `muse <子命令>` 与 `python -m muse` 等价，删除会破坏已发布安装方式 | 无需授权 | | **JK-20** | 后端-知识方法故事世界 | `docs/write-chapter/artifacts/`（125 文件） | D2 D3 | 历史运行产物引用 `writer-context-v1` 等合同，仓库内已无生产者（JK-03 的对照面） | 按计划第 1 节历史留痕豁免，不改 | 无需授权（记录不改） | | **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` 未列 `迁移`（:65 定义该目标）；实测仓库根无名为 `迁移` 的文件或目录，当前不会触发「目标被跳过」 | 把 `迁移` 补进 .PHONY | 无需授权（仅记录） | | **TL-14** | 工具 | 工具/环境预检.py、工具/构建发布.py；README.md:55、279 | D7 | 5 个工具中 3 个由 Makefile 目标承载（:43、:70、:73、:74），环境预检与构建发布只在 README 给出 `uv run python 工具/…` / `.venv/bin/python 工具/…` 命令 | 记录为有意保留（发布与预检属人工步骤） | 无需授权（仅记录） | | **MG-04** | 数据库迁移 | `数据库/迁移/`（45 文件全量） | D3 | 全量 `IF NOT EXISTS` 出现 **0** 次、`DROP ... IF EXISTS` **0** 次；128 `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，无存在性前置校验 | 对齐 V0021/V0023 的写法：先 `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`（V0043–V0055 已用该风格）；或写明整 schema 授予的理由 | 无需授权（但改动涉及已应用迁移，须以新迁移追加，不可回改） | | **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`（含口令，0600、目录 0700）。属有意设计（同文件 237 行注释与 `旧知识记录分流.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 运行审校命令(…) == 服务读回`（CLI 分支即同一次实现调用） | 只证实现内部一致、无独立期望的冗余断言：低优先清理 | 无需授权 | | **TS-61** | 测试与资源 | `tests/迁移/test_隔离目标台账.py:2275` | D2 | `"""真实PG用例；…需要父代理显式外部环境运行。"""` | 上游派发流程套话（实际由 `pytestmark`/Makefile 决定）：保留或改写 | 无需授权 | ## 各模块一句话结论（14 份报告；检查时规模，`数据库/旧库迁移` 域已退场，见收口节） | 模块 | P0 | P1 | P2 | P3 | 一句话结论 | |---|---|---|---|---|---| | 后端·接入（48 文件） | 0 | 6 | 13 | 1 | 骨架干净：211 条路由零重复零缺 id、合同与实现 211/211 一致、零凭据零拼接零穿越；问题是一处异常伪装 404、两处身份/状态核对断裂、一个只有测试在用的「后台入口」。 | | 后端·基础设施+共享（37） | 2 | 9 | 11 | 3 | 错误合同、路径约束与凭据纪律扎实（零硬编码、零拼接、零关闭 TLS、零裸 except）；塌陷在「生成物/外部版本」这条门禁边（`JC-01`/`JC-02`）与一批零消费者导出面。 | | 后端·审校修订+效果评测（48） | 1 | 9 | 9 | 2 | 确定性规则引擎无模型调用、两次运行字节一致；塌陷在规则数据与提示词资源的权威口径已与实现脱钩（16 条规则写「激活门豁免」而实现无此开口）。 | | 后端·任务运行+编排（35） | 0 | 4 | 11 | 1 | 派发主链留痕完整、白名单与 5 小时窗口真实落地；问题是恢复链断头（`JT-01`）、角色探针旁路预算与留痕（`JT-02`）。 | | 后端·交付连载+上下文+资料研究（47） | 0 | 5 | 6 | 2 | 定稿冻结、四格式导出与复读校验、来源漂移拒绝都失败关闭；问题是 4 个提示词孤儿、榜单快照采集时刻不是合法时间戳、导出落盘非原子。 | | 后端·作者经验+正文写作+作品规划（37） | 0 | 4 | 15 | 2 | 模型锁定与「先审后入」经调用点复核成立（正典写入仅 2 处、无绕过口）；问题是提示词承诺与实现不符、两条规划提示词直读源树、B05 直读 B06 私表。 | | 后端·知识方法+正式变更+故事世界+元数据（44） | 0 | 8 | 11 | 3 | 正典写入无旁路、结构字段与库内断言逐数字一致；问题是资产无消费者（2 提示词、1 结构合同、2 合同字段）与 AGENTS.md 结构契约路径。 | | tests + 资源（157 测试 + 资源） | 1 | 10 | 33 | 2 | 隔离纪律与登记骨架干净（446 个库夹具用例全部带标记、1219 个用例 ID 双向对齐、迁移双副本逐字节零漂移）；风险是门禁依赖生成物、一批断言弱于用例名、浏览器旅程无可执行入口。 | | web（114 + 53） | 0 | 2 | 15 | 2 | 全仓最干净的一块：零 `dangerouslySetInnerHTML`、零凭据、零 `any`、零幻路径注释；问题是同一件事多文件各写一遍、用例 id 与清单/文档三方不一致。 | | 数据库迁移（45 SQL + 初始化） | 0 | 0 | 2 | 5 | 双副本零漂移、账本与事务纪律由执行器承担、凭据为零、157 个定义对象对代码零悬空；只有编号空洞成因未成文与少量标注熵增。 | | 数据库/旧库迁移（21 + 旧结构，已退场） | 0 | 4 | 2 | 1 | 台账与隔离闭环扎实（零凭据、SQL 全参数化、目标库随机新建）；两条已声明的 K08 镜像路径在真实旧结构上不可达，切换检查缺回退条件。 | | 工具（7） | 0 | 5 | 7 | 2 | 无凭据、无 `shell=True`、无硬编码绝对路径，Makefile 工具命令参数一致且等价实跑绿；风险是登记驱动的写入路径缺包含性校验、能力登记与技能/生成物的差集无人看守。 | | .agent（252 文件） | 1 | 11 | 12 | 6 | 方法技能正文与作者层合同质量高、泔水零命中、338 条链接全可达；塌陷在元数据与绑定层——自称的 manifest/门禁不存在、角色合同指向无物、4 处规则点名的 3 个门禁文件不存在。 | | docs 权威区 + 根文件（147 md + workflows） | 1 | 16 | 11 | 1 | 权威区链接几乎全绿（1196 条仅 4 条死链，`新版设计/` 零死链）；但 `AGENTS.md` 本身是最大污染源（11 处链接文字失效、4 项陈述与物理事实不符、1 处权威引用落空）。 | ## 豁免与边界（本轮查了什么、没查什么、为什么） **已全量精读/全量机械核对** - 后端 `src/muse` **300 个 .py**（按 17 个业务子包分 8 组，无一抽样）；`src/muse/资源` 仅一致性（产物不读）。 - `tests` **157 个 .py**：架构 5、契约 19、迁移 10、端到端 3、真实调用 1 全读；单元抽 10、集成抽 15（抽样清单在各报告「豁免与边界」节）。 - `web/src` 114 + `web/tests` 53：门禁全量 + 精读抽样 37 个 TS/TSX + 16 项机械全量扫描。 - `数据库/迁移` 45 SQL 全量机械 + 基线 V0001 与最新 3 个精读；`数据库/旧库迁移` 21 .py 机械门禁 + 3 个关键文件精读（映射台账/切换检查/入口）。 - `工具` 7 文件全读；`.agent` 252 文件全读（46 个 SKILL.md 全文 + 117 个 references 存在性 + 9 规则 + 3 约束 + 3 规范 + 作者层 + 5 个目录索引）。 - `docs` 权威区 + 根文件 + 两个 workflow 全读；`docs/实现回顾` 既有留痕仅机械计数。 **免检与豁免（照计划第 1、4 节）** | 对象 | 处置 | 理由 | |---|---|---| | `docs/实现回顾/` 既有留痕（计划、R2 留痕、迁移回顾、本目录索引） | 只计数死链，不复查表述、不提修改建议 | 计划第 1 节「历史留痕：表述不复查、内容不修改」；本轮计数：md 链接 6/死 0，反引号路径引用 30/失效 4（含本计划自身引用的 `<模块>` 占位与 `skills.json`） | | `数据库/旧库迁移` 的命名/风格/注释 | D2 泔水与风格要求**豁免** | 计划第 4 节明示「有意 legacy 域」；仍查事实错误、链路、安全 | | `src/muse/资源/工作台`、`运行资源.zip`、`docs/接口契约/生成/openapi.generated.json`、`web/src/接口/生成/类型.ts` | 只验与权威同步，不评质量 | 生成物/构建产物；web 侧实测重新生成后逐字节一致 | | `docs/接口契约/生成/` 之外的 `.venv`、`node_modules`、`__pycache__`、`.zcode`、`data/`、`.agents.local/` | 不查 | 缓存、本地环境、个人配置、创作数据 | | 数据库内容、创作正文（含 `data/sources/`）、`data/muse.db` | 不读不改 | 硬边界：不动数据库、不读创作正文 | | `make 数据库测试`、`make 真实模型测试`、`make 宿主测试`、备份恢复演练 | 未跑 | 计划「本轮不跑数据库测试（CI 记录为证）」；无隔离库/真实模型/固定 Pi 路径 | | `make 生成`、`make 构建`、`make 格式写入`、`维护索引.py --写入` | 子代理一律未跑（只静态核对）；主代理经授权跑过一次 `make 生成` | 写模式会覆盖生成物；`make 生成` 的授权与证据见 §4 | | `tests/迁移` 对真实 PG 的行为、`数据库/迁移` 在真实 PG 上可跑通 | 无证据 | 未连库；10 个迁移用例只做清单级核对 | **未取得原始退出码的门禁**：`make 模块边界` 原样命令在本沙箱不可执行（`uv` 缓存 + macOS `sandbox_init` 双重被拒）；内容侧等价证据为 `--外部环境` 下 15 passed，主代理另在授权环境跑到 `make 测试` 1005 passed（含该文件）。 ## 处置声明与硬边界（2026-09-16 检查期；后续处置见收口节） - 本轮为**只读专项检查**。除下列三项外未改动任何文件：`docs/实现回顾/专项检查-报告-*.md`（14 份子代理报告）、本台账、`docs/实现回顾/目录.md` 的登记行。 - **唯一一次越出「只读」的动作**：经用户 2026-09-16 明确授权（问题「P0 门禁红 · 处置选择」→ 选项「授权我跑 make 生成 就地刷新生成物，再重跑 make 测试复绿」），于 20:42 执行 `make 生成`，重写了被 `.gitignore:36` 忽略的生成物（`src/muse/资源/`、`web/dist`、`docs/接口契约/生成/`、索引）。**受跟踪文件零改动**（`git status --untracked-files=no` 仅剩本批报告与 `目录.md`）。 - `git add` / `git commit` 全程未执行。**修复另立计划；未获授权不动手。** - 台账每条二值收口：`待授权`（需用户点头）/ `保留（理由）`（P3 与豁免项）/ `已处置（证据）`（仅 `JC-01` 的本地部分）；最终处置以收口节的裁决分布为准。 - 另一会话提交期间的时点声明：开工快照 2026-09-16T20:30:04+08:00，HEAD `f76c3cd04a8b4d461a5e004b36962900db943729`；`git status` 当时仅有 `docs/实现回顾/目录.md` 的未提交改动与未跟踪的计划文件，判定为「未收口」，故计划第 2 节的「.gitignore 与跟踪文件交集」原定延后；实际于 20:43:37 复检（跟踪 1320 / 命中 0）并记入 §2。 ## 证据指针（命令 + 退出码 / 校验结果） | 证据 | 位置 | |---|---| | 全部门禁首轮与刷新后原始输出 | `/tmp/qc/门禁结果.txt`、`/tmp/qc/门禁结果-uv.txt`、`/tmp/qc/门禁结果-复跑2.txt` | | P0 门禁红证据档（时间线 + 三步根因探针） | `/tmp/qc/P0-门禁红-证据.md` | | 代码哈希三向比对（清单/HEAD/工作树，301 文件逐一） | `/tmp/qc/probe4.py` | | 安装核对与资源一致性探针 | `/tmp/qc/probe5.py` | | Markdown 链接机械校验（393 文件 / 1680 链 / 4 死链） | `/tmp/qc/链接校验.py`、`/tmp/qc/死链结果.txt` | | 反引号路径引用校验（2722 / 1236） | `/tmp/qc/反引号校验.py`、`/tmp/qc/反引号死链.txt` | | docs 子代理链接校验（口径 A/B/C 与 R2 穷举） | `/tmp/lc2.py`、`/tmp/lc2.json`、`/tmp/lc2-summary.txt`（子代理落盘） | | 台账条目抽取与去重（305 条 → 293 条） | `/tmp/qc/台账/生成5.py`、`/tmp/qc/台账/抽取结果.txt` | | 各模块命令与退出码、逐条 file:line | 各报告「证据指针」节（14 份） | > 上述 `/tmp` 路径为一次性探针与日志，不入库；报告内已保留可复现命令与判定结果。逐条裁决处置与执行证据存于本地实施区 `.agents.local/优化-20260917/已裁决计划/`（不入库）；判断某条现状时以当前仓库与本地映射为准。