更名 mdpolish 并补充清洗流水线设计与调研记录

- 仓库由 govdoc-md-cleaner 更名为 mdpolish,更新 README、AGENTS、CLAUDE
  及 reference 中的仓库名;冻结的 design 与带日期 scratch 保留旧名
- 冻结 0002:可组合清洗组件与流水线(check/transform、单轮修改加最终复查)
- 新增 0003 草稿:第一版可执行核心架构,待评审
- 新增 HTML 表格清洗专题调研(2026-08-21)
This commit is contained in:
2026-08-21 22:49:03 +08:00
parent b6e310f0a9
commit 8ac4f1dd12
8 changed files with 848 additions and 46 deletions
+14 -11
View File
@@ -12,21 +12,23 @@
发生冲突时,以对应的唯一权威为准,不把不同版本拼成新的说法。
| 事实类型 | 唯一权威 |
|---|---|
| 当前阶段与已经完成的工作 | 根目录 `README.md` |
| Wiki 分类、冻结规则与更新机制 | `research-wiki/README.md` |
| 已批准的选择、权衡与否决方案 | `research-wiki/design/` 中对应编号记录 |
| 当前有效的清洗机制与原因 | `research-wiki/explanation/`;没有文档时就是尚未确定 |
| 参数、输入输出和运行行为 | 未来的代码与测试;代码无法表达的事实才进入 `reference/` |
| 可复现的操作与排障步骤 | `research-wiki/guides/` |
| Agent 协作与执行规范 | 本文件及其同步镜像 |
| 事实类型 | 唯一权威 |
| ----------------- | ---------------------------------------- |
| 当前阶段与已经完成的工作 | 根目录 `README.md` |
| Wiki 分类、冻结规则与更新机制 | `research-wiki/README.md` |
| 已批准的选择、权衡与否决方案 | `research-wiki/design/` 中对应编号记录 |
| 当前有效的清洗机制与原因 | `research-wiki/explanation/`;没有文档时就是尚未确定 |
| 参数、输入输出和运行行为 | 未来的代码与测试;代码无法表达的事实才进入 `reference/` |
| 可复现的操作与排障步骤 | `research-wiki/guides/` |
| Agent 协作与执行规范 | 本文件及其同步镜像 |
路径、参数、命令、指标口径和当前进度不得维护多个权威版本。发现冲突时,先确认权威,再修复过期内容。
## 1. 项目定位与当前阶段
`govdoc-md-cleaner` 是独立的清洗算法研究与治理仓库。它用于理解 PDF→Markdown 噪音、定义清洗边界、
`mdpolish` 是独立的清洗算法研究与治理仓库。它用于理解 PDF→Markdown 噪音、定义清洗边界、
比较候选方案并积累可复核证据。
当前只建立文档治理基础。源码目录、测试目录、依赖配置、命令行接口、规则格式和评估体系均未获批准、
@@ -120,8 +122,9 @@ design 草稿可以在评审中修改;批准后冻结。决策发生变化时
## 9. 沟通与协作
- 像同事协作一样,用直接、可读的中文说明判断、变化和风险
- 像同事协作一样,用直接、可读的中文说明判断、变化和风险。要用人话讲解!别创造黑话,别堆积信息密度极大的长难句!
- 问什么答什么,一次聚焦当前问题,不把未经请求的后续工作一起推进;
- 能在授权范围内安全判断的事项直接完成;会改变范围或契约的选择交给用户;
- 进度和最终报告必须对应真实工具输出,不把计划描述成结果;
- 不输出内部思维链,只提供可复核的依据、实际变更和验证结果。