docs: 记录任务 #14 验收通过

2026-08-16 19:46:37 +08:00
parent db07f88c64
commit 958a2d49bb
1 changed files with 26 additions and 34 deletions
@@ -3,8 +3,10 @@
 - 类型：需求
 - 所属 Epic：无
 - 所属 MVP / 版本：无
- 状态：待验收
+- 状态：已完成
 - 日期：2026-08-16
+- 验收日期：2026-08-16
+- 验收结果：用户明确验收通过
 - Gitea 工单：http://ilaer.eicp.net:8418/opc/dev_harness/issues/14
 - Wiki 页面：Task-14-任务归档按需导出
 - Wiki revision：以线上页面当前 revision 为准
@@ -15,51 +17,41 @@

 ## 最终方案

- `wiki-docs.json` 只登记 13 个核心长期页面，普通同步不处理任务归档。
+- `wiki-docs.json` 只登记核心长期页面，普通同步不处理任务归档。
 - `new_task_archive.py` 只创建线上 Wiki 归档，不修改映射、不写入 `docs/task/`。
- 新增 `export_task_archives.py`：
-  - 默认按 Wiki revision 增量导出新增或变化的任务归档；
-  - `--all` 全量读取线上任务归档；
-  - 已有镜像通过元数据头匹配，兼容历史自定义文件名；
-  - 目标目录有未提交改动时停止；
-  - 不自动删除或重命名本地文件。
- Harness 只要求核心页面具有显式映射，同时检查已经存在的任务快照格式；不要求线上任务历史全部导出。
- AGENTS、README、项目档案、开发工作流、Home 和新项目初始化均明确任务快照可能不完整，导出必须由用户提出。
- 当前已有 13 份 `docs/task/` 快照原样保留。
+- `export_task_archives.py` 默认按 revision 增量导出，`--all` 全量读取。
+- 已有镜像按元数据头匹配，兼容历史自定义文件名；目标有未提交改动时停止。
+- 不自动删除或重命名本地文件；已有任务快照原样保留。
+- Harness 检查核心映射和已存在任务快照格式，不要求任务历史全部导出。

 ## 修改文件

- `dev_scripts/export_task_archives.py`：新增增量与全量任务归档导出入口。
- `dev_scripts/new_task_archive.py`：改为只创建线上 Wiki 归档。
- `dev_scripts/wiki_docs.py`：支持复用页面列表元数据读取和安全写入单份镜像。
- `dev_scripts/sync_wiki_docs.py`：明确只同步核心映射。
- `dev_scripts/check_harness.py`：分离核心映射检查和已导出任务快照检查。
- `wiki-docs.json`：移除任务逐页映射，只保留核心页面。
- `AGENTS.md`、`README.md`：更新快捷指令和事实来源边界。
- `tests/test_harness_docs.py`、`tests/test_wiki_docs.py`：覆盖核心映射、增量、全量、历史文件名、不删除和脏文件停止。
- `docs/README.md`、`docs/00-project-profile.md`、`docs/01-workflow.md`、`docs/07-new-project-documentation-setup.md`：对应 Wiki 核心镜像。
+- `dev_scripts/export_task_archives.py`：新增增量与全量导出。
+- `dev_scripts/new_task_archive.py`：只创建线上归档。
+- `dev_scripts/wiki_docs.py`、`dev_scripts/sync_wiki_docs.py`：支持核心同步和安全写入。
+- `dev_scripts/check_harness.py`、测试：分离核心映射和任务快照检查。
+- `wiki-docs.json`：只保留核心页面映射。
+- `AGENTS.md`、`README.md`、核心 Wiki 镜像：更新流程边界。

 ## 验收结果

 | 验收标准 | 结果 |
 |---|---|
-| 创建任务归档不再修改映射或写入本地 | 通过；创建本页后工作区保持干净 |
-| 普通同步只同步核心长期文档 | 通过；只检查 13 个核心页面 |
-| 增量导出按 revision 处理新增或变化 | 通过；真实执行时 13 份相同 revision 全部跳过 |
-| 全量导出读取全部线上任务归档 | 通过；自动化测试覆盖 |
-| 不自动删除或重命名本地文件 | 通过；自动化测试覆盖 |
-| 保留已有任务快照且不要求完整导出 | 通过 |
-| Wiki 与核心镜像一致 | 通过 |
-| Harness 与单元测试通过 | 通过 |
+| 创建任务归档不修改映射或写入本地 | 通过 |
+| 普通同步只同步核心长期文档 | 通过 |
+| 增量和全量导出行为明确 | 通过 |
+| 不自动删除或重命名本地文件 | 通过 |
+| 已有任务快照保留且不要求完整导出 | 通过 |
+| 用户验收 | 通过 |

 ## 测试

- `python dev_scripts/check_harness.py --strict`：通过。
- `python -m unittest discover -s tests -v`：31 项全部通过。
- `python dev_scripts/sync_wiki_docs.py --check`：13 个核心镜像全部一致。
- `python dev_scripts/export_task_archives.py`：13 份已有任务快照全部因 revision 相同而跳过，工作区无新增变化。
- `python dev_scripts/new_task_archive.py 14 "任务归档按需导出"`：只创建本 Wiki 页面，未修改映射或 `docs/task/`，工作区保持干净。
- **未验证部分**：未真实执行 `--all`，因为全量导出必须由用户明确提出；全量行为由自动化测试覆盖。
+- 严格检查：通过。
+- 单元测试：31 项全部通过。
+- 核心镜像检查：13 个页面全部一致。
+- 真实增量导出：13 份已有快照因 revision 相同全部跳过。
+- 真实创建 #14 归档：只创建 Wiki，未修改本地。
+- **未验证部分**：未真实执行 `--all`；全量行为由自动化测试覆盖。

 ## 相关提交