OPC/cmautobuy
2
0
Fork 0
Code Issues 114 Pull Requests Actions Packages Projects Releases Wiki Activity

接入 Wiki 镜像工具与项目映射骨架 #312

New Issue
Open
opened 2026-08-26 16:26:21 +08:00 by ila · 2 comments
ila commented 2026-08-26 16:26:21 +08:00
Owner
Copy Link
Copy Source

基本信息

  • 类型：需求
  • 父级大工单：#310
  • 所属 MVP / 版本：#311
  • 阶段：阶段 1：Wiki 基础设施
  • 原始需求来源：用户在 2026-08-26 要求参考更新后的 D:\OPC\dev_harness 更新本项目文档和工作流
  • 前置工单：无
  • 是否允许并行：否。必须先形成可验证的同步工具和目标项目映射，后续页面迁移才有稳定落点。
  • 状态：待验收

要解决什么

当前仓库没有 wiki-docs.json、Wiki 同步工具、结构检查和 Harness 测试，Gitea Wiki 为空，不能直接宣称 docs/ 是 Wiki 镜像。

做什么 / 不做什么

  • 做：增量接入并适配 dev_scripts/harness.py、dev_scripts/wiki_docs.py、wiki-docs.json、Harness 测试和最小目录规则；固定来源基线 0b6ec7675dfc2d930a30527eddac83f4302d0879。
  • 不做：不创建或迁移业务 Wiki 正文；不改变 Agent 流程；不复制 DevHarness 项目事实和历史归档。

怎么做

以参考实现为基线，按 cmautobuy 的多子项目、现有 docs 路径和 Gitea 仓库改写。结构检查区分“工具可用”和“线上 Wiki 已初始化”；页面缺失时给出明确错误，不能把本地文件当线上证据。

预计修改：dev_scripts/、wiki-docs.json、tests/test_harness_docs.py、tests/test_wiki_docs.py、必要的 .gitignore/目录文件

设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。
长期文档影响：有，具体页面和镜像见预计修改。

验收标准

  • 同步工具和结构检查可从仓库根目录运行
  • 映射只指向 docs/ Markdown，不包含 docs/task 动态历史
  • 目标仓库、owner 和基线记录为 cmautobuy 的真实值
  • 未配置凭据时错误不泄露秘密
  • Wiki/Harness 工具单元测试通过
  • 严格检查在迁移未完成时明确失败，不把本地旧文档误当成线上 Wiki 证据

怎么验证

python -m unittest discover -s tests -p 'test_wiki_docs.py' -v；python -m py_compile dev_scripts/wiki_docs.py dev_scripts/harness.py；运行 python dev_scripts/harness.py check --strict 并确认它明确列出尚待 #313～#316 完成的缺页/规则门禁，且不泄露凭据。全量严格通过由 #317 验收。

风险和回退

同步工具具有覆盖镜像能力；本任务只做结构和测试，不运行会写 Wiki 或覆盖现有 docs 的同步。

## 基本信息 - 类型：需求 - 父级大工单：#310 - 所属 MVP / 版本：#311 - 阶段：阶段 1：Wiki 基础设施 - 原始需求来源：用户在 2026-08-26 要求参考更新后的 `D:\OPC\dev_harness` 更新本项目文档和工作流 - 前置工单：无 - 是否允许并行：否。必须先形成可验证的同步工具和目标项目映射，后续页面迁移才有稳定落点。 - 状态：待验收 ## 要解决什么 当前仓库没有 `wiki-docs.json`、Wiki 同步工具、结构检查和 Harness 测试，Gitea Wiki 为空，不能直接宣称 `docs/` 是 Wiki 镜像。 ## 做什么 / 不做什么 - 做：增量接入并适配 `dev_scripts/harness.py`、`dev_scripts/wiki_docs.py`、`wiki-docs.json`、Harness 测试和最小目录规则；固定来源基线 `0b6ec7675dfc2d930a30527eddac83f4302d0879`。 - 不做：不创建或迁移业务 Wiki 正文；不改变 Agent 流程；不复制 DevHarness 项目事实和历史归档。 ## 怎么做 以参考实现为基线，按 cmautobuy 的多子项目、现有 docs 路径和 Gitea 仓库改写。结构检查区分“工具可用”和“线上 Wiki 已初始化”；页面缺失时给出明确错误，不能把本地文件当线上证据。 预计修改：`dev_scripts/`、`wiki-docs.json`、`tests/test_harness_docs.py`、`tests/test_wiki_docs.py`、必要的 `.gitignore`/目录文件 设计证据：非 UI 工作；以 DevHarness 目标提交、事实来源迁移顺序和本工单技术方案作为设计证据。 长期文档影响：有，具体页面和镜像见预计修改。 ## 验收标准 - [ ] 同步工具和结构检查可从仓库根目录运行 - [ ] 映射只指向 `docs/` Markdown，不包含 `docs/task` 动态历史 - [ ] 目标仓库、owner 和基线记录为 cmautobuy 的真实值 - [ ] 未配置凭据时错误不泄露秘密 - [ ] Wiki/Harness 工具单元测试通过 - [ ] 严格检查在迁移未完成时明确失败，不把本地旧文档误当成线上 Wiki 证据 ## 怎么验证 `python -m unittest discover -s tests -p 'test_wiki_docs.py' -v`；`python -m py_compile dev_scripts/wiki_docs.py dev_scripts/harness.py`；运行 `python dev_scripts/harness.py check --strict` 并确认它明确列出尚待 #313～#316 完成的缺页/规则门禁，且不泄露凭据。全量严格通过由 #317 验收。 ## 风险和回退 同步工具具有覆盖镜像能力；本任务只做结构和测试，不运行会写 Wiki 或覆盖现有 docs 的同步。
ila referenced this issue from a commit 2026-08-26 16:37:07 +08:00
docs: 归档任务 #312
ila commented 2026-08-26 16:37:16 +08:00
Author
Owner
Copy Link
Copy Source

实施结果

  • 工具实现提交：a326532
  • 格式修正提交：248f499
  • 本地归档提交：5d651cd
  • 归档：docs/task/312-接入Wiki镜像工具与项目映射骨架.md
  • 验证：Wiki/Harness 工具单测 17 项通过，Python 编译通过。
  • 严格检查：按预期列出 #313～#316 未完成的页面与规则门禁，没有把本地旧文档误当成线上 Wiki。
  • 未验证：真实 Wiki 同步将在 #313 初始化页面后执行。

状态：待验收。

## 实施结果 - 工具实现提交：`a326532` - 格式修正提交：`248f499` - 本地归档提交：`5d651cd` - 归档：`docs/task/312-接入Wiki镜像工具与项目映射骨架.md` - 验证：Wiki/Harness 工具单测 17 项通过，Python 编译通过。 - 严格检查：按预期列出 #313～#316 未完成的页面与规则门禁，没有把本地旧文档误当成线上 Wiki。 - 未验证：真实 Wiki 同步将在 #313 初始化页面后执行。 状态：待验收。
ila commented 2026-08-26 16:46:52 +08:00
Author
Owner
Copy Link
Copy Source

补充验证提交：cad1908；归档记录同步提交：7dab013。

补充验证提交：`cad1908`；归档记录同步提交：`7dab013`。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
admin ila
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: OPC/cmautobuy#312