chore: docs 结构整改 + compose 双目录对齐（合并重建提交）

本提交为 .git 对象库损坏后的重建提交，内容等价于原先三个本地提交
（5e2fd4c2 / 57a53c98 / 5d7e1873）的累积结果，未做任何额外改动。

一、docs 结构整改（整改 #14）
根因：重构时新结构为 untracked 文件，执行 git stash（未带 -u）未纳入，
随后 git reset 拉回 HEAD 旧 tracked 树，导致旧树复活、新旧两棵目录
树并存于 docs/，共 791 文件、双分类体系冲突。

修复动作：
- b2 同名异主题文件改名迁移保全 9 个
- C 类 39 个孤立文件按主题正确归类
- A/B1 类 222 个重复文件删除（新结构已有内容副本）
- 9 个旧独有空目录删除
- 270 处内部引用按 verified 映射改写
- 整改记录 #14 登记于 04-运维文档/部署运维

结果：docs 791 → 569 文件，顶层仅规范 8 类 + 治理文件，单树恢复。
残留：约 20 处指向从未存在文件的陈旧死链，归入独立文档卫生任务。

二、compose 双目录对齐（消除踩坑 A）
- docker-compose.yml：nginx 前端挂载全部由根目录 frontend-*/dist
  改为 src/frontend-*/dist（h5 / agent / admin / terminal）
- docker-compose.dev.yml：dev 服务 build context 与卷同步改 src/
- 效果：本地 docker compose up 不再把根目录 stale dist 挂回，
  与线上一致，分叉隐患消除（已 docker compose config 校验通过）

防复发铁律：
- 重构须提交；仓库修复须 git stash -u 或先 commit
- 新结构须 git add 并提交，避免再次 untracked 复活
- H5 改动只动 src/frontend-h5/，禁改根目录遗留 frontend-*/

docs/01-产品文档/IT智能服务台-全套改造建议与推广方案.md

@@ -0,0 +1,482 @@
+# IT智能服务台 — 全套改造建议与推广方案
+
+> **版本**: v1.0
+> **日期**: 2026-07-10
+> **作者**: 宋献（Duckula辅助分析）
+> **基于文档**: PRD-v2 + 群聊参与者展开缩略双模式-PRD
+
+---
+
+## 一、Slogan 分析与优化
+
+### 1.1 原始 Slogan 评价
+
+> "在这个星球上，通过7个人就能找到你想找的那个人；在这里，7个选择就能找到答案"
+
+**优点**：
+- 借用"六度分隔理论"概念，有文化锚点，容易引发联想
+- 前半句制造好奇，后半句给出承诺，结构清晰
+- "7个选择"形成数字记忆点，有传播潜力
+
+**需优化的点**：
+- "在这里"过于模糊，缺少品牌识别度——读者不知道"这里"是哪
+- 整体偏长（34字），口头传播困难，适合做海报主文案但不适合口语传播
+- "7个人"vs"7个选择"的对仗略有瑕疵——人是链式传递，选择是并列路径，逻辑对应不够严密
+
+### 1.2 优化建议（三层 slogan 体系）
+
+| 层级 | Slogan | 字数 | 使用场景 |
+|------|--------|------|---------|
+| **品牌口号** | **七选达解** | 4字 | LOGO旁、系统标题栏、所有物料统一标识 |
+| **传播副标** | **7个选择，找到答案** | 8字 | 海报副标题、视频结尾字幕、企微群发首行 |
+| **完整版** | 在这个星球上，7个人能找到你想找的人；在IT服务台，7个选择能找到答案 | 32字 | 推广长文开头、CG视频旁白、培训PPT首页 |
+
+### 1.3 "7个选择"定义
+
+基于 PRD 功能矩阵，提炼7条从"遇到问题"到"获得解答"的路径：
+
+| # | 选择 | 对应功能 | 一句话描述 | PRD映射 |
+|---|------|---------|-----------|---------|
+| 1 | **问AI** | AI智能问答 | 70%的问题AI秒答，不用等人 | AI层/RAGFlow+Dify |
+| 2 | **找坐席** | 一键转人工 | AI搞不定？30秒接通真人坐席 | 转人工/排队系统 |
+| 3 | **摇人** | 群聊协作 | 坐席拉同行会诊，多人攻坚 | 摇人/collaborating_agent_ids |
+| 4 | **邀专家** | 专家邀请 | 定向邀请对口专家加入会话 | 邀请/participants |
+| 5 | **查知识** | 知识库直搜 | 主动搜索已有IT知识，自助解决 | 知识库/RAGFlow |
+| 6 | **提审批** | 审批流程 | 12类18流程在线办，不用跑腿 | 审批系统/ApprovalCardModal |
+| 7 | **追进度** | 历史会话+满意度 | 查进度、看记录、评满意度，闭环追踪 | 满意度评价/会话审计 |
+
+**记忆口诀**：问AI → 找坐席 → 摇人 → 邀专家 → 查知识 → 提审批 → 追进度
+
+前4个选择解决"当前问题"（实时），后3个选择保障"持续进化"（长效）。
+
+---
+
+## 二、全套改造建议
+
+### 2.1 产品功能层面
+
+#### A. 近期必补短板（1-2个月）
+
+| 优先级 | 改造项 | 现状 | 目标 | 关键动作 |
+|--------|--------|------|------|---------|
+| P0 | **知识库真可用** | P2-01标注"已完成"实为桩实现，API未挂载 | 知识建议→训练师审批→入库→AI引用，全闭环 | 1. 取消注释 `knowledge_iteration_router` 2. 挂载API 3. Neo4j图存储写入 4. 审批流打通 |
+| P0 | **群聊双模式** | PRD已完整定义，代码未实现 | H5底部弹出 + 坐席就地展开，参与者缩略/展开切换 | 按 `群聊参与者展开缩略双模式-PRD` 执行 P0 需求 |
+| P0 | **文件上传** | P1-23 待开发，员工无法发截图 | 支持图片/文档/日志上传，为多模态铺路 | H5端 `van-uploader` + 坐席端 `el-upload` + 后端文件存储 |
+| P1 | **置信门控** | P2-02 待开发，AI不分难易硬答 | 低置信度问题自动转人工，减少"AI答非所问"的负面体验 | Dify 返回 confidence score → 阈值判断 → 自动转人工 |
+
+**改造逻辑**：这4项是"让现有系统真正可用"的基础。知识库假完成是最严重的信任危机——员工用过几次发现AI答不准，就不信任了，再推广就难了。文件上传是多模态的前置条件，没有文件上传，多模态理解就是空中楼阁。
+
+#### B. 中期体验跃迁（3-4个月）
+
+| 改造项 | 价值 | 关键动作 |
+|--------|------|---------|
+| **前端全套优化** | 三端视觉统一，体验跃升 | 见 2.2 前端改造建议 |
+| **多模态视觉理解** | 员工发截图→AI自动识别错误码/蓝屏/弹窗 | P2-04，接入视觉大模型，截图→诊断建议 |
+| **坐席代答** | AI推荐答案→坐席一键发送，效率翻倍 | P2-03，AI推荐区增加"采用并发送"按钮 |
+| **内推广** | 让全员知道、会用、爱用 | 宣传文案 + CG视频 + 培训（见第三、四章） |
+
+#### C. 远期智能闭环（5-8个月）
+
+| 改造项 | 价值 | 关键动作 |
+|--------|------|---------|
+| **训练师审批** | 知识质量可控，避免脏数据入库 | P2-05，内联审批流，训练师在坐席端直接审 |
+| **自助服务门户** | 员工不用找坐席也能查进度/搜知识/看审批 | 独立页面，整合知识库搜索+会话历史+审批状态 |
+| **SLA仪表盘** | 管理层实时看到SLA达成率、超时预警 | 管理后台新增，实时刷新+趋势图+告警 |
+| **自动化闭环** | 自动分诊→自动升级→自动回访 | 规则引擎+定时任务，减少人工干预 |
+
+### 2.2 前端改造建议
+
+#### 当前问题诊断
+
+| 端 | 技术栈 | 主要问题 |
+|----|--------|---------|
+| H5端 | Vue3 + Vant4 | 功能完善但视觉老旧，参与者列表占空间大，缺少引导动画 |
+| 坐席端 | Vue3 + Element Plus | 三栏工作台信息密度高但层次不清，组件风格不统一 |
+| 管理后台 | Vue3 + Element + Tailwind | 功能齐全但数据可视化弱，仪表盘缺乏设计感 |
+
+#### 改造方案：统一设计系统
+
+**核心原则**：一套设计令牌，三端共享，各自适配。
+
+```
+设计令牌层（Design Tokens）
+├── 色彩系统
+│   ├── 主色 #07C160（企微绿，已在用）
+│   ├── 辅助色 #3b82f6（坐席蓝）/ #FF9800（发起人橙）
+│   ├── 语义色 success/warning/danger/info
+│   └── 中性色 9级灰阶
+├── 排版系统
+│   ├── 字体：PingFang SC / Microsoft YaHei
+│   ├── 字号：12/13/14/15/16/20/24/30
+│   └── 行高：1.4/1.5/1.6
+├── 间距系统
+│   ├── 基准 4px，刻度 4/8/12/16/20/24/32/48
+│   └── 组件内 padding：12/16，卡片 padding：16/20
+├── 圆角系统
+│   ├── sm 6px / md 8px / lg 12px / xl 16px / full 999px
+│   └── 按钮用 md，卡片用 lg，弹窗用 xl
+├── 阴影系统（克制使用）
+│   ├── sm 0 1px 2px rgba(0,0,0,0.04)
+│   ├── md 0 2px 8px rgba(0,0,0,0.06)
+│   └── lg 0 4px 16px rgba(0,0,0,0.08)
+└── 动效系统
+    ├── 快速 150ms（hover/press）
+    ├── 标准 200ms（展开/收起）
+    └── 慢速 300ms（弹窗/页面过渡）
+```
+
+**三端改造重点**：
+
+| 端 | 改造重点 | 预期效果 |
+|----|---------|---------|
+| H5端 | 1. 群聊双模式落地 2. 首屏加载骨架屏 3. 消息发送动画 4. 空状态插画 5. 下拉刷新体验 | 聊天区域空间释放40%，视觉年轻化 |
+| 坐席端 | 1. 三栏布局优化（可拖拽分栏） 2. 会话列表卡片重设计 3. 排查流程图可视化 4. 快捷键体系 5. 暗色模式 | 信息层次清晰，坐席效率提升 |
+| 管理后台 | 1. 仪表盘数据可视化升级 2. 图表组件统一 3. 表格密度可调 4. 筛选器重设计 | 管理层数据一目了然 |
+
+#### 改造执行路径
+
+```
+Phase 1: 设计系统建立（2周）
+  → 产出 design-tokens.css + 组件规范文档
+  → 由设计原型专家团执行（design-system-expert + prototype-builder）
+
+Phase 2: H5端改造（3周）
+  → 群聊双模式 + 视觉升级 + 动效
+  → 逐页面替换旧样式
+
+Phase 3: 坐席端改造（3周）
+  → 布局优化 + 组件升级 + 排查流程图
+  → 与H5端并行，互不阻塞
+
+Phase 4: 管理后台改造（2周）
+  → 仪表盘 + 图表 + 表格
+  → 最后做，依赖前两端的组件沉淀
+
+Phase 5: 联调与验收（1周）
+  → 三端视觉一致性检查
+  → 性能回归测试
+```
+
+### 2.3 技术架构层面
+
+| 改造项 | 现状 | 建议 |
+|--------|------|------|
+| **WS断连体验** | 断连后3秒轮询降级，但用户无感知 | 增加"网络重连中"toast提示，重连成功后自动恢复 |
+| **消息缓存策略** | `h5_messages_cache` 7天/100条 | 增加缓存命中率监控，按会话热度动态调整上限 |
+| **头像代理** | `/api/avatar/proxy` 解决COEP/CSP | 增加缓存层，避免每次请求都代理 |
+| **审批意图识别** | Dify API Key已配置 | 增加fallback策略，Dify不可用时降级为关键词匹配 |
+| **历史消息共享** | P1-20 待开发 | 邀请时支持选择共享范围（全部/最近N条/从某条开始） |
+
+### 2.4 数据与运营层面
+
+| 改造项 | 价值 | 建议 |
+|--------|------|------|
+| **AI解决率看板** | 量化AI价值 | 按周/月展示AI自助解决率趋势，目标70%→75% |
+| **坐席绩效日报** | 激励坐席 | 每日推送坐席处理量、平均响应时间、满意度 |
+| **知识库健康度** | 发现知识盲区 | 统计"AI无法回答"的问题分类，定向补充知识 |
+| **会话热力图** | 发现高峰时段 | 按小时统计会话量，优化排班 |
+
+---
+
+## 三、宣传文案
+
+### 3.1 企微群发文案（短推版）
+
+```
+【IT智能服务台】七选达解，你的IT问题我们包了
+
+电脑蓝屏？VPN连不上？审批找不到入口？
+别到处问了，IT智能服务台7条路径帮你搞定：
+
+1️⃣ 问AI — 70%的问题秒答
+2️⃣ 找坐席 — 30秒接通真人
+3️⃣ 摇人 — 多坐席会诊
+4️⃣ 邀专家 — 定向邀请对口
+5️⃣ 查知识 — 自助搜索
+6️⃣ 提审批 — 12类在线办
+7️⃣ 追进度 — 全程可追踪
+
+👉 入口：企微工作台 → IT智能服务台
+👉 或直接扫码进入
+
+7个选择，找到答案。
+```
+
+### 3.2 海报文案（主视觉）
+
+**主标题**：七选达解
+
+**副标题**：7个选择，找到答案
+
+**正文**：
+> 在这个星球上，7个人能找到你想找的人
+> 在IT服务台，7个选择能找到答案
+
+**底部**：企微工作台 → IT智能服务台 | itsupport.servyou.com.cn
+
+### 3.3 产品介绍长文（内部Wiki/邮件）
+
+```
+标题：告别"IT问题到处问"——IT智能服务台2.0全面升级
+
+你有没有过这样的经历？
+- 电脑突然蓝屏，不知道找谁
+- VPN连不上，群里问了一圈没人理
+- 审批卡在某个节点，不知道找谁催
+- 同样的问题问了三遍，每次答案都不一样
+
+如果有，IT智能服务台就是为你设计的。
+
+【什么是IT智能服务台】
+一个AI+人工协作的IT支持平台，7条路径覆盖你所有的IT需求。
+不用到处找人，不用反复描述问题，一个入口搞定。
+
+【7个选择，找到答案】
+
+选择1：问AI
+把你遇到的问题打字发给AI，70%的常见问题秒回。
+蓝屏代码、VPN配置、打印机离线……AI都会答。
+背后的知识库接入了RAGFlow和Dify，越用越聪明。
+
+选择2：找坐席
+AI搞不定？点一下"转人工"，30秒内坐席接通。
+不用排队等电话，不用跑IT办公室，直接在企微里聊。
+
+选择3：摇人
+一个问题多个坐席会诊？坐席可以"摇人"——拉同行进群，
+多方协作，疑难杂症一起搞。
+
+选择4：邀专家
+知道这个问题找谁？直接邀请对口专家加入会话。
+专家不用到现场，线上就能解决。
+
+选择5：查知识
+不想等人？直接搜知识库，已有IT知识自主查询。
+密码重置、软件安装、网络配置……操作指南都有。
+
+选择6：提审批
+账号申请、权限开通、设备申领……12类审批在线提交，
+不用填纸质表，不用跑签字，企微里直接办。
+
+选择7：追进度
+提交了问题不知道处理到哪了？会话记录全程可查。
+处理完了还能评分，你的反馈让服务越来越好。
+
+【怎么用】
+- 企微工作台 → 搜索"IT智能服务台" → 点击进入
+- 或直接访问 itsupport.servyou.com.cn
+
+【一句话】
+7个选择，找到答案。IT的事，交给IT智能服务台。
+```
+
+### 3.4 培训PPT文案（首页/尾页）
+
+**首页**：
+> 七选达解
+> IT智能服务台2.0全员培训
+> 7个选择，找到答案
+
+**尾页**：
+> 记住7个选择：
+> 问AI → 找坐席 → 摇人 → 邀专家 → 查知识 → 提审批 → 追进度
+>
+> 入口：企微工作台 → IT智能服务台
+> 有问题？先问AI，搞不定再找人。
+
+---
+
+## 四、CG宣传视频脚本
+
+### 4.1 视频概述
+
+| 项目 | 说明 |
+|------|------|
+| **时长** | 2分30秒（150秒） |
+| **风格** | 扁平MG动画 + 实景截图，轻松幽默 |
+| **分辨率** | 1920×1080，适配企微播放 |
+| **旁白** | 男声，语速中等偏快，带一点幽默感 |
+| **BGM** | 轻快电子，节奏明快 |
+| **核心信息** | 7个选择，找到答案 |
+
+### 4.2 分镜脚本
+
+#### Scene 1：痛点开场（0:00-0:20，20秒）
+
+**画面**：分屏展示4个员工的窘境
+- 左上：员工A对着蓝屏电脑抓头发
+- 右上：员工B举着手机到处找IT同事
+- 左下：员工C翻纸质申请表找签字栏
+- 右下：员工D在企微群里发"有人吗？"等了10分钟没人理
+
+**旁白**：
+> "电脑蓝屏找谁？VPN断了找谁？审批卡了找谁？
+> 在公司里找个IT，有时候比找个人还难。"
+
+**画面**：四个分屏汇聚到中间，出现文字"有没有一个入口，搞定所有IT问题？"
+
+---
+
+#### Scene 2：概念引入（0:20-0:35，15秒）
+
+**画面**：地球转动，出现7个发光的点连成一条链
+- 文字弹出："在这个星球上，7个人能找到你想找的人"
+
+**画面切换**：地球变成IT智能服务台LOGO，7个点变成7个图标
+- 文字弹出："在IT服务台，7个选择能找到答案"
+
+**旁白**：
+> "在这个星球上，7个人能找到你想找的人。
+> 在IT服务台，7个选择，找到答案。
+> 七选达解。"
+
+**音效**：叮——品牌音效
+
+---
+
+#### Scene 3：七选展示（0:35-1:50，75秒）
+
+每个选择约10秒，统一结构：**图标动画 → 一句话 → 真实界面截图**
+
+**选择1：问AI（0:35-0:45）**
+- 画面：聊天界面，员工输入"VPN连不上"
+- AI秒回，弹出解答步骤
+- 右上角弹出"70%问题AI秒答"
+- 旁白："选择1，问AI。70%的问题，AI秒答，不用等人。"
+
+**选择2：找坐席（0:45-0:55）**
+- 画面：员工点"转人工"按钮
+- 坐席头像亮起，30秒倒计时
+- 右上角弹出"30秒接通"
+- 旁白："选择2，找坐席。AI搞不定？30秒接通真人。"
+
+**选择3：摇人（0:55-1:05）**
+- 画面：坐席工作台，点击"摇人"
+- 第二个坐席头像加入群聊，消息开始流动
+- 右上角弹出"多方会诊"
+- 旁白："选择3，摇人。坐席拉同行会诊，疑难杂症一起搞。"
+
+**选择4：邀专家（1:05-1:15）**
+- 画面：坐席点击"邀请"，选择专家
+- 专家收到企微卡片通知，点击加入
+- 右上角弹出"定向邀请"
+- 旁白："选择4，邀专家。对口专家直接拉进群，线上解决。"
+
+**选择5：查知识（1:15-1:25）**
+- 画面：知识库搜索界面，输入"密码重置"
+- 搜索结果弹出操作指南，带图文步骤
+- 右上角弹出"自助搜索"
+- 旁白："选择5，查知识。不想等人？知识库直接搜，操作指南都有。"
+
+**选择6：提审批（1:25-1:35）**
+- 画面：审批列表，12个图标排列
+- 点击"账号申请"，填写表单，提交
+- 审批流程可视化，节点亮起
+- 右上角弹出"12类在线办"
+- 旁白："选择6，提审批。12类审批在线办，不用跑腿填表。"
+
+**选择7：追进度（1:35-1:50）**
+- 画面：会话列表，每个会话有状态标签（处理中/已完成）
+- 点击已完成会话，弹出满意度评分（5星）
+- 右上角弹出"闭环追踪"
+- 旁白："选择7，追进度。全程可追踪，处理完还能评分，越用越好。"
+
+---
+
+#### Scene 4：数据收尾（1:50-2:15，25秒）
+
+**画面**：数字滚动动画
+- "70.2%" — AI自助解决率
+- "30秒" — 平均坐席响应时间
+- "12类" — 审批流程覆盖
+- "7个" — 选择路径
+
+**旁白**：
+> "70%的问题AI自助解决，
+> 30秒接通真人坐席，
+> 12类审批在线办理，
+> 7个选择，覆盖你所有的IT需求。"
+
+**画面**：7个数字汇聚成LOGO
+
+---
+
+#### Scene 5：品牌收尾（2:15-2:30，15秒）
+
+**画面**：白底，LOGO居中
+- 主文字："七选达解"
+- 副文字："7个选择，找到答案"
+- 底部："企微工作台 → IT智能服务台"
+- 完整slogan小字："在这个星球上，7个人能找到你想找的人；在IT服务台，7个选择能找到答案"
+
+**旁白**：
+> "七选达解。7个选择，找到答案。
+> IT智能服务台，企微工作台见。"
+
+**音效**：品牌音效收尾
+
+---
+
+### 4.3 制作建议
+
+| 项目 | 建议 |
+|------|------|
+| **动画风格** | 扁平MG（Motion Graphics），线条简洁，色彩明快 |
+| **配色** | 主色#07C160（企微绿），辅助#3b82f6/#FF9800，背景白色/浅灰 |
+| **字体** | 思源黑体 / PingFang SC，标题加粗，正文常规 |
+| **节奏** | 痛点段稍快制造紧迫感，展示段匀速清晰，收尾段放慢留余韵 |
+| **字幕** | 全程配字幕，关键数字加大加粗 |
+| **音效** | 每个选择切换时有"叮"音效，数据滚动时有数字递增音效 |
+| **工具推荐** | After Effects / Premiere Pro，或用万彩动画大师/来画（低成本方案） |
+
+---
+
+## 五、其他建议
+
+### 5.1 产品层面
+
+| 建议 | 理由 | 优先级 |
+|------|------|--------|
+| **新用户引导** | 首次进入H5时展示3步引导（问AI→转人工→评分），降低学习成本 | P1 |
+| **快捷入口卡片** | 企微工作台增加"IT智能服务台"快捷卡片，展示AI解决率+在线坐席数 | P1 |
+| **IT公告栏** | H5首页增加IT公告区（网络维护通知、系统升级预告），减少重复咨询 | P2 |
+| **坐席技能标签** | 坐席profile增加技能标签（网络/软件/硬件/审批），智能分配更精准 | P2 |
+| **知识库贡献榜** | 每月公布知识贡献TOP坐席，激励知识沉淀 | P2 |
+
+### 5.2 运营层面
+
+| 建议 | 理由 |
+|------|------|
+| **分批次推广** | 先IT部门内部试用2周→再推广到技术密集部门→最后全员，逐步打磨 |
+| **种子用户计划** | 每个部门选1-2个"IT联络员"作为种子用户，负责本部门推广答疑 |
+| **满意度竞赛** | 月度坐席满意度排名，TOP坐席获"服务之星"称号 |
+| **问题归因报告** | 每月输出TOP10高频IT问题报告，推动根因解决（而非只治标） |
+| **周年数据报告** | 上线1周年时输出数据报告（解决量/解决率/满意度/节约工时），向上汇报价值 |
+
+### 5.3 技术层面
+
+| 建议 | 理由 |
+|------|------|
+| **A/B测试框架** | AI回复策略、置信度阈值等可A/B测试，数据驱动调优 |
+| **灰度发布机制** | 前端改造分批灰度，降低全量发布风险 |
+| **性能监控** | 接入前端性能监控（首屏时间、WS连接稳定性），量化体验提升 |
+| **日志结构化** | 后端日志增加结构化字段（会话ID/坐席ID/操作类型），便于审计分析 |
+
+---
+
+## 六、执行优先级总览
+
+```
+本周          → 群聊双模式开发启动（PRD已就绪）
+2周内         → 知识库真可用修复（取消注释+API挂载）
+1个月内       → 文件上传 + 置信门控
+1-2个月       → 近期4项全部完成
+2-3个月       → 前端全套优化（设计系统→H5→坐席→管理后台）
+3个月         → CG视频制作 + 宣传文案定稿
+3-4个月       → 多模态 + 坐席代答 + 内推广上线
+5-8个月       → 远期智能闭环
+```
+
+---
+
+> **核心信息**：7个选择，找到答案。先把基础打牢（知识库真可用+群聊双模式+文件上传），再做体验跃迁（前端全套优化），最后推广上线。顺序不能反——推广一个半成品只会透支信任。