DLG-69 公开文档同步一级分类调整 + DIP1 工作日志恢复公开¶
日期：2026-08-11 参与人：曾总（SPO）、听写助手（DT） 主题：站点一级分类名称修正、恢复 DIP1 工作日志公开、重新全链路同步部署 关联文档：DLG-68、PJM §4.3.6/4.3.7
一、用户反馈与调整内容¶
1.1 一级分类名称修正（原 DLG-68 部署站点的导航问题）¶
用户访问 https://hk2026-docs.pages.dev 后反馈：
1. 听云 WCL 一级分类"看不到"——原名称"生产运维 OPS（听云 WCL）"过长且"OPS"与 docs/运营服务 OPS 目录名冲突导致认知混淆，正确名称应为 "听云WCL"（简短明确，对齐 GLY 英文简称 WCL）。
2. 子项目 DIP1 一级分类——原名称"DIP1 子项目 DIP1（听码 WDE）"冗余，正确名称应为 "子项目DIP1"。
1.2 DIP1 工作日志恢复公开¶
用户确认：DIP1 的工作日志（DWLG，dip1/docs/worklog/）可以公开，不要排除。
说明：DWLG 中不含敏感凭据（代码开发过程记录），与 ops/worklog（OWLG，生产部署过程，含敏感中间态）的敏感级别不同。
二、调整后排除规则（公开同步脚本的 EXCLUDE_PREFIXES）¶
仅保留听云的两条排除路径；DIP1 工作日志完全开放。
| 排除路径 | 排除原因 |
|---|---|
ops/private/ |
含密钥、账号、部署细节等敏感信息（安全红线） |
ops/worklog/ |
听云 OWLG 含生产部署中间态、配置参数路径等内部信息（与 DIP1 DWLG 性质不同） |
dip1/docs/worklog/：✅ 公开（V2.8 撤销排除）。
三、调整后站点导航一级分类（共 15 项）¶
人机协作指南 PMG
核心文档
需求分析 RQD
报价服务 QSV
客户跟踪 CPT
主数据 MDS
运营服务 OPS
技术文档 TND
子项目DIP1 ← V2.8 新增（更名，含 9 文档 + DIP1-WLG 工作日志索引）
听云WCL ← V2.8 新增（更名，原"看不到"→现在短名称清晰可见）
评审 REV
工作日志 WLG
发布文档
附录
其中新增/调整的两个一级分类： - 子项目DIP1（10 项）：DIP1-DOC 索引 / DIP1-ARC / DIP1-P1~P3 / DIP1-SPEC / DIP1-PROTO / DIP1-SCH / DIP1-IMP / DIP1-WLG（工作日志） - 听云WCL（5 项）：OPSDIR 目录索引 / WCL 听云工作手册 / 公开文档索引 / DIP1 管理员操作手册 / DIP1 外部服务集成指南
四、变更文件清单¶
| 文件 | 变更内容 |
|---|---|
scripts/url_map.py NAV_STRUCTURE |
① "DIP1 子项目 DIP1（听码 WDE）" → "子项目DIP1"；② "生产运维 OPS（听云 WCL）" → "听云WCL"；③ 子项目DIP1 中恢复 "工作日志 DIP1-WLG / dip1wlg" 导航项 |
scripts/sync-docs-helper.py |
EXCLUDE_PREFIXES 移除 "dip1/docs/worklog/"；验证清单改"dip1/docs/worklog/ OK (可公开)" |
scripts/build-site.py |
EXCLUDE_PREFIXES 移除 "dip1/docs/worklog/" |
docs/工作日志/对话记录/20260811_听写助手对话记录69_*.md |
新建（本工作日志） |
五、执行步骤¶
- ✅ 修正 3 个脚本（url_map.py / sync-docs-helper.py / build-site.py）
- ✅ 创建 DLG-69 工作日志
- ✅ 提交变更到 dev 分支并推送（commit 763704a）
- ✅ 执行
sync-docs-repo.ps1：178 扫描 / 174 复制 / 排除 4（仅 ops/private + ops/worklog），dip1/docs/worklog/ OK (用户确认可公开，V2.8 恢复) ✅ - ✅ 执行
build-site.py：146 md + 29 非 md 文件，8.38 秒，站点产物 228 个；"子项目DIP1"含 10 项（+DIP1-WLG），"听云WCL"含 5 项 - ✅ 执行
deploy-site.ps1：上传 157 新文件（70 缓存），部署 https://hk2026-docs.pages.dev ✅
六、本次调整执行结果汇总¶
| 阶段 | 结果 |
|---|---|
| 一级分类① | 子项目DIP1（含 DIP1-DOC / ARC / P1~P3 / SPEC / PROTO / SCH / IMP / WLG工作日志 共 10 项）✅ |
| 一级分类② | 听云WCL（含 OPSDIR / WCL / 公开文档索引 / DIP1 管理员操作手册 / 外部服务集成指南 共 5 项）✅ 短名称不再与"运营服务OPS"混淆 |
| DIP1 工作日志 | dip1/docs/worklog/ 公开同步 + 构建 + 部署全站可用 ✅（公开仓同步时验证为"OK"，构建产物 146 个 md） |
| 公开仓提交 | 0999669 → master 更新（hk2026-docs Gitee） |
| 站点部署 | 生产域名：https://hk2026-docs.pages.dev（部署哈希 fe94f194，228 产物文件） |
本日志记录公开文档同步一级分类调整与 DIP1 工作日志恢复公开的完整过程。