DLG-71 公开文档同步 V3.0 — 业务知识库 + 客服手册 V2.0 + 管理员手册完善¶
日志编号：DLG-71 日期：2026-08-14 触发人：用户指令「公开文档同步」 执行人：听写助手（DT） 前置条件：OWLG-10 已完成业务知识库板块创建 + 客服手册 V2.0 升级重构 + 管理员 5 大手册完善 + DIP1 生产部署方案变更（Cloudflare→阿里云 ECS）
一、同步背景¶
1.1 本次同步新增/变更内容¶
| 板块 | 变更类型 | 主要内容 |
|---|---|---|
| ops/knowledge-base/ | 新增 6 文档 | 业务知识库体系：README 索引 / 公司背景与商业模式 / 业务知识（QSV/CPT/MDS/OPS）/ 实时业务服务状态接口 / AI 客服人设 / 扩展场景（仓储/搬屋/装修对接） |
| ops/service-manual/ | 升级 V2.0 | 6 份重构 + 2 份新增：README 整体设计 / 工单流程 / FAQ / 升级路径 / SLA / 沟通话术 / AI 服务架构 / AI 训练语料库 |
| ops/admin-manual/ | 完善 5 手册 | 部署指南 / 监控告警 / 备份恢复 / 安全审计 / 事件响应（含日常运维 SOP） |
| ops/public/dip1/ | 更新 V1.1 | DIP1-OPS 生产环境管理员操作手册 + DIP1-EXT 外部服务集成指南 |
| ops/private/ | 更新私有文档 | DIP1 生产部署报告 / 配置清单 / 三端联通验证 / 本地预生产交付包 / Cloudflare→阿里云 ECS 迁移方案 / 凭据管理体系 |
| ops/worklog/ | 新增日志 | OWLG-10 知识库 + 客服 V2.0 / Cloudflare→阿里云 ECS 方案变更 |
| ops/deploy/ | 新增脚本 | append-hosts.ps1 / restore-hosts.ps1（生产 hosts 管理，V2.9 排除公开同步） |
1.2 同步流程依据¶
严格按 PJM §4.3.6（公开文档镜像仓同步）+ §4.3.7（MkDocs 站点构建部署）执行。
二、执行步骤 6 阶段¶
阶段 1：查阅 PJM 流程 + 脚本核验 ✅¶
- PJM §4.3.6：同步范围 docs/ + 发布/ + ops/（排除 private/worklog/deploy）+ dip1/docs/
- 脚本版本核验：
sync-docs-repo.ps1（编排层 V2.9）+sync-docs-helper.py（文件处理层，排除前缀含ops/deploy/V2.9 新增）build-site.py（构建层 V2.9，排除前缀同步 V2.9）deploy-site.ps1（部署层，含 wrangler + DryRun 模式）
阶段 2：私有主仓变更提交 ✅¶
Commit: 8f2bb4e (dev)
Parents: 9aecd78
Type: feat
Message: feat: 新增业务知识库板块+客服手册V2.0升级+管理员手册完善+部署方案变更
Files: 48 files changed, 6596 insertions(+), 1636 deletions(-)
Push: origin/dev (9aecd78 → 8f2bb4e)
阶段 3：公开文档镜像仓同步 ✅¶
| 项 | 结果 |
|---|---|
| 扫描文件 | 237 个（git ls-tree） |
| 敏感目录排除 | ops/private/ ✅ / ops/worklog/ ✅ / ops/deploy/ ✅ |
| 复制文件数 | 221 个（跳过 16 个敏感目录文件） |
| 提交信息 | docs: sync from main 8f2bb4e (docs/ + 发布/ + ops/ + dip1/docs/ excl private/worklog) |
| 公开仓 commit | 409eae4（master） |
| 公开仓推送 | origin/master：e466fe8 → 409eae4 |
| 落地页 README | 已存在，无需重建 |
敏感目录校验：
ops/private/ correctly excluded
ops/worklog/ correctly excluded
ops/deploy/ correctly excluded (V2.9 新增排除)
dip1/docs/worklog/ OK (用户确认可公开，V2.8 恢复)
关键文件校验： - docs/项目管理.md ✅ - ops/README.md ✅ - ops/WCL-听云工作手册.md ✅ - ops/public/dip1/DIP1-OPS-生产环境管理员操作手册.md (21773 bytes) ✅ - dip1/docs/README.md (16502 bytes) ✅ - dip1/docs/DIP1-ARC-架构设计.md (17662 bytes) ✅ - dip1/docs/DIP1-IMP-Code-Agent实施指南.md (63162 bytes) ✅
阶段 4：MkDocs 站点构建 ✅¶
| 项 | 数值 |
|---|---|
| 跟踪文件 | 160 md + 29 非 md（排除 ops/private + ops/worklog + ops/deploy） |
| URL 映射 | 若干 slug（含 pmg / pjm / cptd / opsd / wcl / dip1imp 等主文档） |
| Markdown 复制 | 169 个文件（slug 扁平化 + 全量链接重写） |
| 非 MD 复制 | 29 个文件（保留目录结构） |
| 桩页面 | ref 参考资料 / arc 归档 |
| 品牌样式 | assets/css/brand.css（深墨绿 #004046 + 浅沙金 #D4AF78 + 米白 #F2F0EB） |
| 站点产物 | 251 个文件（site/） |
| 根跳转 | index.html → /pmg/（meta refresh + JS + _redirects 301） |
构建警告（属正常，非 strict 模式不阻断）：
- 历史工作日志中 scripts/*.ps1 / scripts/*.py 链接债务 → 未解析（不在 docs 范围内）
- DIP1 文档中 DIP1-API-OpenAPI规格.yaml / ../backend/openapi.yaml 引用 → 未解析（非 .md）
- AGENTS.md 中 ops/private/ 私有文档引用 → 未解析（正常排除）
阶段 5：Cloudflare Pages 部署 ⏸（待 TL 配置凭据）¶
DryRun 验证通过：
wrangler pages deploy D:\AC\TF\hk2026\site --project-name=hk2026-docs --branch=main
当前状态： - wrangler CLI：已安装（v4.119.0）✅ - CLOUDFLARE_ACCOUNT_ID：未配置 ❌ - CLOUDFLARE_API_TOKEN：未配置 ❌
原因：按 PJM §3 RACI，生产凭据（Cloudflare/R2/App Store/Google Play）由 TL 唯一持有，Agent 不得持有或缓存。
TL 手动执行命令（配置环境变量后执行）：
$env:CLOUDFLARE_ACCOUNT_ID = "<TL 保管的 Account ID>"
$env:CLOUDFLARE_API_TOKEN = "<TL 保管的 API Token>"
powershell -ExecutionPolicy Bypass -File D:\AC\TF\hk2026\scripts\deploy-site.ps1 -SkipBuild
生产 URL：https://hk2026-docs.pages.dev
阶段 6：工作日志记录（本文件）✅¶
同步创建 OWLG-11 听云工作日志对齐。
三、本次同步新增公开内容一览¶
3.1 新增公开文档（镜像仓 + 站点）¶
| 路径 | 说明 | 版本 |
|---|---|---|
ops/knowledge-base/README.md |
业务知识库目录索引 · 四层知识架构 | V1.0 |
ops/knowledge-base/business-context.md |
公司背景与商业模式 · WLYT 主体 · 核心服务矩阵 | V1.0 |
ops/knowledge-base/business-knowledge.md |
业务知识详解 · QSV/CPT/MDS/OPS 四域核心概念 | V1.0 |
ops/knowledge-base/realtime-status.md |
实时业务服务状态接口规范 · CPT 订单/师傅状态查询 API | V1.0 |
ops/knowledge-base/ai-persona.md |
AI 客服人设定义 · 专业度/共情/边界感/沟通风格四维画像 | V1.0 |
ops/knowledge-base/business-extension.md |
扩展业务场景知识库 · 仓储/搬屋/装修/推荐激励对接 | V1.0 |
ops/service-manual/ai-service-architecture.md |
AI 客服服务架构设计 · RAG + 意图识别 + 多轮对话 | V1.0 新增 |
ops/service-manual/ai-training-corpus.md |
AI 客服训练语料库 · 20 类意图 · 50+ 问答对模板 | V1.0 新增 |
3.2 更新公开文档（镜像仓 + 站点）¶
| 路径 | 变更说明 | 版本 |
|---|---|---|
ops/README.md |
新增 §2.3 业务知识库板块 + §2.4 客服服务手册 V2.0，章节重排 | V1.4 → V1.5 |
ops/WCL-听云工作手册.md |
新增 §3.6 业务知识库维护职责 + §3.7 AI 客服训练语料维护 | V1.3 → V1.4 |
ops/service-manual/README.md |
整体重构：AI 拟人化客服模式总览 · 8 文档关系图 | V1.0 → V2.0 |
ops/service-manual/ticket-workflow.md |
重构为 AI 优先工单流：L1 AI 自动化 → L2 人工介入 | V1.0 → V2.0 |
ops/service-manual/faq.md |
重构为语料化 FAQ：分类标签 + 标准答案 + 触发关键词 | V1.0 → V2.0 |
ops/service-manual/escalation-path.md |
重构升级矩阵：5 类异常 × 4 级升级路径（AI-OL-TL-BO） | V1.0 → V2.0 |
ops/service-manual/sla-standard.md |
重构 AI 时代 SLA：首响 ≤3s · AI 解决率 ≥70% · 7×24 覆盖 | V1.0 → V2.0 |
ops/service-manual/communication-script.md |
重构 AI 话术：8 场景拟人化脚本 + 共情表达 + 边界话术 | V1.0 → V2.0 |
ops/admin-manual/*.md |
5 大手册全面完善：部署指南 / 监控告警 / 备份恢复 / 安全审计 / 事件响应 | V1.0 → V1.1 |
ops/public/dip1/DIP1-OPS-*.md |
管理员手册与外部集成指南更新（含 DIP1 用户手册导航） | V1.0 → V1.1 |
四、版本追溯矩阵¶
| 环节 | 仓库 | 分支 | 哈希 | 时间 |
|---|---|---|---|---|
| 私有主仓（提交前） | hk2026 | dev | 9aecd78 | 同步前基准 |
| 私有主仓（提交后） | hk2026 | dev | 8f2bb4e | 2026-08-14 |
| 公开镜像仓（同步前） | hk2026-docs | master | e466fe8 | 同步前基准 |
| 公开镜像仓（同步后） | hk2026-docs | master | 409eae4 | 2026-08-14 |
| MkDocs 本地构建 | - | site/ | - | 251 文件就绪 |
| Cloudflare Pages | - | - | ⏸ Pending | 待 TL 配置凭据执行 |
五、安全合规校验¶
| 校验项 | 结果 |
|---|---|
| ops/private/ 是否进入公开仓 | ❌ 正确排除（含密钥/账号/部署细节） |
| ops/worklog/ 是否进入公开仓 | ❌ 正确排除（OWLG 听云日志仅私有） |
| ops/deploy/ 是否进入公开仓 | ❌ 正确排除 V2.9（hosts 脚本/Caddyfile 含内网配置） |
| docs/归档/ 是否进入公开仓 | ❌ gitignored 已排除 |
| ref/ 是否进入公开仓 | ❌ 正确排除（外部参考不公开） |
| dip1/ 代码（非 docs）是否进入公开仓 | ❌ 正确排除（仅 dip1/docs/ 同步） |
| Cloudflare 凭据是否在日志中泄露 | ❌ 未出现任何具体凭据值（符合 TL 唯一持有要求） |
六、后续待办¶
| # | 事项 | 负责人 | 依赖条件 |
|---|---|---|---|
| 1 | Cloudflare Pages 部署 wrangler pages deploy | TL | CLOUDFLARE_ACCOUNT_ID + CLOUDFLARE_API_TOKEN 配置 |
| 2 | 确认 https://hk2026-docs.pages.dev 新增知识库内容可访问 | TL / SPO | 部署完成后 |
| 3 | 验证 AI 客服相关文档（service-manual V2.0 + knowledge-base）在站点侧栏正确分类 | DT / WCL | 部署完成后 |
DLG-71 对齐 OWLG-11。公开镜像仓同步完成，Cloudflare Pages 部署待 TL 手动执行。