sync: d8d-prototype 文档验证缺陷链修复 — step-05/06/07 #11

d8dfun · 2026-04-09T08:44:08+08:00

d8dfun commented

2026-04-09 08:44:08 +08:00

变更内容

修复 d8d-prototype 技能 3 个步骤的缺陷链，防止文档 404 问题再次发生。

Step 5 (step-05-generate-docs.md)

引入 doc-registry.js 单一数据源，docs-index.html 和 view-doc.html 共享同一份文档注册表
消除双写不一致风险

Step 6 (step-06-generate-server.md)

server.js 路由白名单动态覆盖所有文档路径前缀
不再硬编码只有 /_bmad-output/

Step 7 (step-07-validate.md)

新增文档内容深度验证（7.4 节）
强制遍历每个 view-doc.html?doc=xxx 页面确认内容加载成功
检查浏览器控制台 404 错误

测试

19 个文档全部验证加载成功
修复前 4 个文档 404，修复后全部正常

## 变更内容修复 d8d-prototype 技能 3 个步骤的缺陷链，防止文档 404 问题再次发生。 ### Step 5 (step-05-generate-docs.md) - 引入 doc-registry.js 单一数据源，docs-index.html 和 view-doc.html 共享同一份文档注册表 - 消除双写不一致风险 ### Step 6 (step-06-generate-server.md) - server.js 路由白名单动态覆盖所有文档路径前缀 - 不再硬编码只有 /_bmad-output/ ### Step 7 (step-07-validate.md) - 新增文档内容深度验证（7.4 节） - 强制遍历每个 view-doc.html?doc=xxx 页面确认内容加载成功 - 检查浏览器控制台 404 错误 ## 测试 - [x] 19 个文档全部验证加载成功 - [x] 修复前 4 个文档 404，修复后全部正常

d8dfun added 1 commit 2026-04-09 08:44:08 +08:00

sync: d8d-prototype 文档验证缺陷链修复 — step-05/06/07 6c3c676ca5

Step 5: 引入 doc-registry.js 单一数据源，消除双写不一致
Step 6: server.js 路由白名单动态覆盖所有文档路径前缀
Step 7: 新增文档内容深度验证，强制遍历每个 view-doc 页面

根因: 旧版 Step 5 双写 DOC_MAP、Step 6 硬编码路由、
Step 7 只截图列表页不深入文档内容，导致文档 404 未被发现

d8dfun merged commit b583d577c7 into master

2026-04-09 08:47:20 +08:00

d8dfun deleted branch sync/d8d-prototype-validation-fixes-20260409-004202

2026-04-09 08:47:21 +08:00

d8dfun referenced this issue from a commit

2026-04-09 08:47:23 +08:00

Merge pull request 'sync: d8d-prototype 文档验证缺陷链修复 — step-05/06/07' (#11) from sync/d8d-prototype-validation-fixes-20260409-004202 into master

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: d8dfun/bmad-method-template#11