跳转至

DLG-69 公开文档同步一级分类调整 + DIP1 工作日志恢复公开

日期:2026-08-11 参与人:曾总(SPO)、听写助手(DT) 主题:站点一级分类名称修正、恢复 DIP1 工作日志公开、重新全链路同步部署 关联文档DLG-68PJM §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 新建(本工作日志)

五、执行步骤

  1. ✅ 修正 3 个脚本(url_map.py / sync-docs-helper.py / build-site.py)
  2. ✅ 创建 DLG-69 工作日志
  3. ⏳ 提交变更到 dev 分支并推送
  4. ⏳ 执行 sync-docs-repo.ps1(dip1/docs/worklog/ 现在会同步到公开仓)
  5. ⏳ 执行 build-site.py(DIP1-WLG 导航项现在会出现)
  6. ⏳ 执行 deploy-site.ps1 部署至 https://hk2026-docs.pages.dev

本日志记录公开文档同步一级分类调整与 DIP1 工作日志恢复公开的完整过程。