3

Task-14-任务归档按需导出

ila edited this page 2026-08-16 19:46:37 +08:00

Table of Contents

• 14 任务归档按需导出
• 背景与目标
• 最终方案
• 修改文件
• 验收结果
• 测试
• 相关提交

14 任务归档按需导出

• 类型：需求
• 所属 Epic：无
• 所属 MVP / 版本：无
• 状态：已完成
• 日期：2026-08-16
• 验收日期：2026-08-16
• 验收结果：用户明确验收通过
• Gitea 工单：#14
• Wiki 页面：Task-14-任务归档按需导出
• Wiki revision：以线上页面当前 revision 为准

背景与目标

此前每个任务完成时都会把 Wiki 任务归档登记到 wiki-docs.json 并导出 docs/task/，导致任务越多，普通同步越慢、配置和仓库持续增长。本任务保留核心长期文档自动镜像，把任务归档改为用户明确提出后再增量或全量导出。

最终方案

• wiki-docs.json 只登记核心长期页面，普通同步不处理任务归档。
• new_task_archive.py 只创建线上 Wiki 归档，不修改映射、不写入 docs/task/。
• export_task_archives.py 默认按 revision 增量导出，--all 全量读取。
• 已有镜像按元数据头匹配，兼容历史自定义文件名；目标有未提交改动时停止。
• 不自动删除或重命名本地文件；已有任务快照原样保留。
• Harness 检查核心映射和已存在任务快照格式，不要求任务历史全部导出。

修改文件

• 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 镜像：更新流程边界。

验收结果

验收标准	结果
创建任务归档不修改映射或写入本地	通过
普通同步只同步核心长期文档	通过
增量和全量导出行为明确	通过
不自动删除或重命名本地文件	通过
已有任务快照保留且不要求完整导出	通过
用户验收	通过

测试

• 严格检查：通过。
• 单元测试：31 项全部通过。
• 核心镜像检查：13 个页面全部一致。
• 真实增量导出：13 份已有快照因 revision 相同全部跳过。
• 真实创建 #14 归档：只创建 Wiki，未修改本地。
• 未验证部分：未真实执行 --all；全量行为由自动化测试覆盖。

相关提交

• d1f55f9 feat: export task archives on demand (#14)