实现本地 Markdown 清洗评审器

research-wiki/explanation/local-experiment-artifacts.md

@@ -12,21 +12,30 @@
 - 只有 `success` 文档才产生正式的清洗后 Markdown。
 
 已经实现的范围来自已批准的
-[`0005-local-experiment-runner-and-artifacts.md`](../design/0005-local-experiment-runner-and-artifacts.md)。
+[`0005-local-experiment-runner-and-artifacts.md`](../design/0005-local-experiment-runner-and-artifacts.md) 和
+[`0007-local-markdown-reviewer.md`](../design/0007-local-markdown-reviewer.md)。
 精确字段、校验和函数签名以 `src/mdpolish/` 中的代码与测试为准。
 
-## 2. 三层怎样解耦
+## 2. 保存与评审怎样解耦
 
 ```text
 experiment.py
 ├── pipeline.py          只负责内存清洗
 ├── reporting.py         只负责 JSON、行列和 unified diff
 └── artifact_store.py    只负责日期目录、权限和原子发布
+            │
+            ▼
+      已发布运行目录
+            │
+            ▼
+reviewer/                 只通过发布后的文件做本地只读评审
 ```
 
 - `experiment.py` 严格读取调用方显式列出的 UTF-8 Markdown，逐份调用同一个 `Pipeline`；
 - `reporting.py` 重放并校验 `Change` 的快照链，再生成机器可读审计和人可读 diff；
 - `artifact_store.py` 不理解清洗规则，只把已经生成的字节写入私有临时目录，校验后一次性发布。
+- 同仓库 `reviewer/server/` 只共用无文件 I/O 的 Python 快照重放模块，不导入组件或流水线；它读取 manifest、result、
+  成功输出和本机定位文件。
 
 因此，新增组件不会改变文件层；调整目录布局不会影响清洗和报告；修改 JSON 或 diff 时也不需要碰流水线。
 ClinDB 的 5 份论文、历史 arXiv 单组件组合和当前 first-batch 组合只存在于两个仓库内实验脚本，通用模块没有硬编码
@@ -71,6 +80,7 @@ artifacts/
     └── runs/
         └── <run_id>/
             ├── manifest.json
+            ├── review-locator.json
             └── documents/
                 └── <document_id>/
                     ├── result.json
@@ -95,6 +105,9 @@ artifacts/
 `changes.diff` 是原始输入到最终成功输出的 unified diff，只用于人工查看。它不包含绝对路径或时间戳，
 也不是修改重放的权威；机器审计仍以 `result.json` 为准。
 
+`review-locator.json` 只记录本次运行目录、每份输入的绝对解析路径和输入哈希，供本地评审器重新找到完整原文。它不复制
+原文，不替代 manifest 或 result，也不作为可移植运行身份。绝对路径可能泄露本机目录结构，因此该文件同样是本地敏感数据。
+
 ## 6. 为什么 reporter 要重放修改
 
 第二个组件看到的是第一个组件修改后的快照，因此后续 `Change.span` 不一定对应最初输入。为了生成准确行列，
@@ -137,6 +150,9 @@ artifact store 先在同一日期的 `runs/` 下建立本次专用临时目录
 
 当前只批准对 `data/md/` 中 5 份论文副本保存产物。仓库外 GovDoc 和其他真实数据没有因此获得输出授权。
 
+同仓库只读页面的路径验证、组件快照重放和使用边界见
+[`local-markdown-reviewer.md`](local-markdown-reviewer.md)。
+
 ## 9. 已完成的真实验证
 
 2026-08-22 使用 `paper.arxiv_submission_stamp` `1.0.0` 对 5 份本地论文副本完成一次保存型实验：
@@ -173,3 +189,7 @@ artifact store 先在同一日期的 `runs/` 下建立本次专用临时目录
 当前完整运行方法见
 [`run-local-clindb-first-batch-experiment.md`](../guides/run-local-clindb-first-batch-experiment.md)。实验层的文件、
 JSON、diff 和权限契约没有因组件增多而改变。
+
+2026-08-23 又产生运行 `clindb-first-batch-reviewer-v1`，用于验证新定位文件和本地页面：5/5 文档为 `success`，合计
+155 条修改，输入运行前后哈希不变。评审器 API 校验了 5 份原文、成功输出以及 8 个组件形成的 40 个阶段，所有文本哈希
+均与审计一致。实际页面启动步骤见 [`review-local-cleaning-run.md`](../guides/review-local-cleaning-run.md)。