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/05-运营文档/01-品牌与推广/CG宣传视频建议-v1.0.md

@@ -0,0 +1,58 @@
+# IT智能服务台 — CG 宣传视频建议
+
+> **版本**: v1.0
+> **日期**: 2026-07-10
+> **作者**: 宋献
+> **类型**: 运营 - 品牌与推广
+> **源自**: 方案-前端评价与推广-v1.0.md
+
+---
+
+## 一、视频定位
+
+- 时长：60-90 秒（适合企微内传播、会议室播放）
+- 风格：扁平 MG 动画 + 轻 3D 元素，科技感但不冰冷
+- 色调：品牌绿 + 知识蓝 + 浅灰
+- 音乐：轻快、有节奏感，结尾上扬
+
+---
+
+## 二、分镜脚本（90秒版）
+
+| 时间 | 画面 | 旁白/字幕 | 音效 |
+|------|------|-----------|------|
+| 0-5s | 黑色屏幕，一个绿色光点出现，逐渐扩散成网络节点 | 世界上，任何两个人之间，最多只隔 6 个人 | 轻电子音 |
+| 5-10s | 网络节点继续延伸，出现 IT 相关图标（电脑、VPN、锁、邮件） | 而在 IT 智能服务台，任何问题与答案之间，最多只隔 7 次选择 | 节点连接声 |
+| 10-20s | 一个员工头像发出问题气泡，气泡沿着知识图谱网络跳动，每跳到一个节点就高亮 | 第 1 次：描述问题<br>第 2 次：AI 识别<br>第 3 次：推荐知识节点<br>第 4 次：确认关键信息 | 轻快的"咚"声每步一次 |
+| 20-30s | 节点继续跳动，最终落到一个答案卡片上，卡片展开为解决方案 | 第 5 次：定位根因<br>第 6 次：给出方案<br>第 7 次：一键解决或转人工 | 渐强的电子乐 |
+| 30-40s | 画面切换到三端界面：H5 员工端、坐席端、管理后台，三个界面快速展示 | H5 员工随时问，坐席 AI 协同，管理后台实时掌控 | 界面切换音效 |
+| 40-50s | 展示数据：AI 解决率、平均响应时间、用户满意度 | 更快响应，更少等待，更多问题被一次解决 | 数字跳动声 |
+| 50-60s | 画面回到知识网络，所有节点汇聚成品牌 Logo | 7 次选择，找到答案 | 品牌音效 |
+| 60-65s | 黑屏，Slogan + 二维码/入口链接 | IT 智能服务台，你的 IT 问题，最多 7 步找到答案 | 结束音上扬 |
+
+---
+
+## 三、15 秒企微版脚本
+
+- 0-3s：一个员工遇到问题，屏幕弹出"VPN 连不上"
+- 3-8s：打开 IT 智能服务台，AI 沿着知识图谱 7 步定位答案
+- 8-12s：问题解决了，屏幕显示"已解决"动画
+- 12-15s：品牌 Logo + Slogan"7 次选择，找到答案"
+
+---
+
+## 四、制作建议
+
+| 项目 | 建议 |
+|------|------|
+| 工具 | After Effects / Premiere + Lottie 导出；或直接用 Sora / Pika / Runway 等 AI 视频工具生成初稿 |
+| 素材 | 可用 Dify 工作流生成 AI 配音；背景音乐用 AIVA / Uppbeat |
+| 版本 | 至少做 3 个版本：完整版 90s、企微版 30s、朋友圈竖版 15s |
+| 落地 | 视频结尾必须带二维码或直达链接，降低转化门槛 |
+| 数据埋点 | 统计视频播放完成率、扫码转化率，用于评估推广效果 |
+
+---
+
+> **关联文档**：
+> - 品牌Slogan与文案体系: `05-运营文档/01-品牌与推广/品牌Slogan与文案体系-v1.0.md`
+> - 前端视觉评价: `02-技术文档/前端改造/前端视觉评价-v1.0.md`

docs/05-运营文档/01-品牌与推广/CG宣传视频脚本-v1.0.md

@@ -0,0 +1,158 @@
+# IT智能服务台 — CG宣传视频脚本
+
+> **版本**: v1.0
+> **日期**: 2026-07-10
+> **作者**: 宋献
+> **类型**: 运营 - 品牌与推广
+> **源自**: 方案-全套改造建议与推广-v1.0.md
+
+---
+
+## 一、视频概述
+
+| 项目 | 说明 |
+|------|------|
+| **时长** | 2分30秒（150秒） |
+| **风格** | 扁平MG动画 + 实景截图，轻松幽默 |
+| **分辨率** | 1920×1080，适配企微播放 |
+| **旁白** | 男声，语速中等偏快，带一点幽默感 |
+| **BGM** | 轻快电子，节奏明快 |
+| **核心信息** | 7个选择，找到答案 |
+
+---
+
+## 二、分镜脚本
+
+### 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智能服务台，企微工作台见。"
+
+**音效**：品牌音效收尾
+
+---
+
+## 三、制作建议
+
+| 项目 | 建议 |
+|------|------|
+| **动画风格** | 扁平MG（Motion Graphics），线条简洁，色彩明快 |
+| **配色** | 主色#07C160（企微绿），辅助#3b82f6/#FF9800，背景白色/浅灰 |
+| **字体** | 思源黑体 / PingFang SC，标题加粗，正文常规 |
+| **节奏** | 痛点段稍快制造紧迫感，展示段匀速清晰，收尾段放慢留余韵 |
+| **字幕** | 全程配字幕，关键数字加大加粗 |
+| **音效** | 每个选择切换时有"叮"音效，数据滚动时有数字递增音效 |
+| **工具推荐** | After Effects / Premiere Pro，或用万彩动画大师/来画（低成本方案） |
+
+---
+
+> **关联文档**：
+> - Slogan分析: `05-运营文档/01-品牌与推广/Slogan分析与优化-v1.0.md`
+> - 宣传文案: `05-运营文档/01-品牌与推广/宣传文案-v1.0.md`

docs/05-运营文档/01-品牌与推广/Slogan分析与优化-v1.0.md

@@ -0,0 +1,95 @@
+# IT智能服务台 — Slogan 分析与优化
+
+> **版本**: v1.0
+> **日期**: 2026-07-10
+> **作者**: 宋献
+> **类型**: 运营 - 品牌与推广
+> **源自**: 方案-全套改造建议与推广-v1.0.md
+
+---
+
+## 一、原始 Slogan 评价
+
+> "在这个星球上，通过7个人就能找到你想找的那个人；在这里，7个选择就能找到答案"
+
+**优点**：
+- 借用"六度分隔理论"概念，有文化锚点，容易引发联想
+- 前半句制造好奇，后半句给出承诺，结构清晰
+- "7个选择"形成数字记忆点，有传播潜力
+
+**需优化的点**：
+- "在这里"过于模糊，缺少品牌识别度——读者不知道"这里"是哪
+- 整体偏长（34字），口头传播困难，适合做海报主文案但不适合口语传播
+- "7个人"vs"7个选择"的对仗略有瑕疵——人是链式传递，选择是并列路径，逻辑对应不够严密
+
+---
+
+## 二、优化建议（三层 slogan 体系）
+
+| 层级 | Slogan | 字数 | 使用场景 |
+|------|--------|------|---------|
+| **品牌口号** | **七选达解** | 4字 | LOGO旁、系统标题栏、所有物料统一标识 |
+| **传播副标** | **7个选择，找到答案** | 8字 | 海报副标题、视频结尾字幕、企微群发首行 |
+| **完整版** | 在这个星球上，7个人能找到你想找的人；在IT服务台，7个选择能找到答案 | 32字 | 推广长文开头、CG视频旁白、培训PPT首页 |
+
+---
+
+## 三、"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个选择保障"持续进化"（长效）。
+
+---
+
+## 四、其他运营建议
+
+### 4.1 产品层面建议
+
+| 建议 | 理由 | 优先级 |
+|------|------|--------|
+| **新用户引导** | 首次进入H5时展示3步引导（问AI→转人工→评分），降低学习成本 | P1 |
+| **快捷入口卡片** | 企微工作台增加"IT智能服务台"快捷卡片，展示AI解决率+在线坐席数 | P1 |
+| **IT公告栏** | H5首页增加IT公告区（网络维护通知、系统升级预告），减少重复咨询 | P2 |
+| **坐席技能标签** | 坐席profile增加技能标签（网络/软件/硬件/审批），智能分配更精准 | P2 |
+| **知识库贡献榜** | 每月公布知识贡献TOP坐席，激励知识沉淀 | P2 |
+
+### 4.2 运营层面建议
+
+| 建议 | 理由 |
+|------|------|
+| **分批次推广** | 先IT部门内部试用2周→再推广到技术密集部门→最后全员，逐步打磨 |
+| **种子用户计划** | 每个部门选1-2个"IT联络员"作为种子用户，负责本部门推广答疑 |
+| **满意度竞赛** | 月度坐席满意度排名，TOP坐席获"服务之星"称号 |
+| **问题归因报告** | 每月输出TOP10高频IT问题报告，推动根因解决（而非只治标） |
+| **周年数据报告** | 上线1周年时输出数据报告（解决量/解决率/满意度/节约工时），向上汇报价值 |
+
+### 4.3 数据与运营
+
+| 改造项 | 价值 | 建议 |
+|--------|------|------|
+| **AI解决率看板** | 量化AI价值 | 按周/月展示AI自助解决率趋势，目标70%→75% |
+| **坐席绩效日报** | 激励坐席 | 每日推送坐席处理量、平均响应时间、满意度 |
+| **知识库健康度** | 发现知识盲区 | 统计"AI无法回答"的问题分类，定向补充知识 |
+| **会话热力图** | 发现高峰时段 | 按小时统计会话量，优化排班 |
+
+---
+
+> **关联文档**：
+> - 宣传文案: `05-运营文档/01-品牌与推广/宣传文案-v1.0.md`
+> - CG视频脚本: `05-运营文档/01-品牌与推广/CG宣传视频脚本-v1.0.md`
+> - 产品功能层面: `01-产品文档/00-产品规划/全套改造建议-产品功能层面-v1.0.md`
+> - 前端改造建议: `02-技术文档/前端改造/前端改造建议-v1.0.md`
+> - 技术架构优化: `02-技术文档/技术架构/技术架构优化建议-v1.0.md`

docs/05-运营文档/01-品牌与推广/品牌Slogan与文案体系-v1.0.md

@@ -0,0 +1,129 @@
+# IT智能服务台 — 品牌 Slogan 与文案体系
+
+> **版本**: v1.0
+> **日期**: 2026-07-10
+> **作者**: 宋献
+> **类型**: 运营 - 品牌与推广
+> **源自**: 方案-前端评价与推广-v1.0.md
+
+---
+
+## 一、Slogan 核心概念
+
+> 在 IT 智能服务台，通过知识图谱，最多经过 7 次选择，找到答案或真相。
+
+---
+
+## 二、三层 Slogan 体系
+
+| 层级 | 文案 | 使用场景 |
+|------|------|----------|
+| 品牌口号 | **七选达解** | LOGO 旁、标题栏、视频结尾 |
+| 主传播语 | **7 次选择，找到答案** | 海报、企微群发、培训 PPT |
+| 完整版 | 世界上，7 个人能连接任何两个人；在 IT 智能服务台，7 次选择能连接你和答案 | 长文、视频旁白、官网 |
+| 悬念版 | 你的问题，离答案最多 7 步 | 预热海报、朋友圈 |
+
+---
+
+## 三、企微群发文案
+
+### 版本 A：简洁版
+
+> IT 智能服务台升级了。
+>
+> 现在，AI 不是给你一堆链接，而是沿着知识图谱，一步步定位问题根因。复杂问题，最多 7 次选择，就能找到答案。
+>
+> 遇到 IT 问题，先问服务台。👉 [打开 IT 智能服务台]
+
+### 版本 B：场景版
+
+> 周一早上，VPN 连不上，邮件发不了，系统登不进。
+>
+> 以前：翻 3 个文档，打 2 个电话，等 1 小时。
+> 现在：打开 IT 智能服务台，AI 沿着知识图谱排查，最多 7 次选择，定位根因。
+>
+> 有人工兜底，也有 AI 先跑。先试试 AI，省时省力。👉 [立即体验]
+
+---
+
+## 四、海报文案
+
+**主标题：7 次选择，找到答案**
+
+**副标题：**
+- AI 懂你的问题，更懂问题的关联
+- 知识图谱 + 人工坐席，双引擎 IT 服务
+- 复杂问题不再绕路，答案最多 7 步可达
+
+**行动按钮：**
+- 立即体验 / 打开 IT 智能服务台
+
+---
+
+## 五、产品长文标题备选
+
+1. 《7 次选择，找到答案：我们如何在 IT 服务台里建了一张知识图谱》
+2. 《从"搜文档"到"找答案"：IT 服务台的 7 步进化》
+3. 《你的 IT 问题，离答案最多 7 步》
+
+---
+
+## 六、培训 PPT 用文案
+
+**封面：** 7 次选择，找到答案
+
+**内容页：**
+- 第 1 步：描述你的问题
+- 第 2 步：AI 识别问题类型
+- 第 3 步：推荐最可能的知识节点
+- 第 4 步：追问或确认关键信息
+- 第 5 步：定位根因或关联场景
+- 第 6 步：给出可执行方案
+- 第 7 步：一键提交审批或转人工
+
+> 不是每次都需要 7 步，但最多只要 7 步。
+
+---
+
+## 七、品牌吉祥物与视觉符号
+
+建议设计一个简洁的视觉符号：一个由 7 个节点组成的知识网络图标，作为品牌辅助图形。可以：
+- 放在 H5 启动页
+- 作为 AI 思考时的 loading 动画
+- 作为管理后台「知识图谱」模块的入口图标
+
+---
+
+## 八、推广节奏
+
+| 阶段 | 动作 | 目标 |
+|------|------|------|
+| 第 1 周 | 设计系统统一、H5 体验优化 | 内部体验改善 |
+| 第 2 周 | 发布 15 秒预热视频 + 海报 | 建立"7 次选择"认知 |
+| 第 3 周 | 完整版视频 + 培训 PPT | 推动部门培训 |
+| 第 4 周 | 种子用户访谈、数据复盘 | 收集反馈，迭代文案 |
+
+---
+
+## 九、关键数据指标
+
+推广前建议先定基线：
+- H5 首次提问转化率
+- AI 首次解决率
+- 平均会话轮数（验证"7 次选择"是否成立）
+- 转人工率
+- 用户满意度
+
+---
+
+## 十、风险提醒
+
+- 如果知识图谱实际效果不支持"7 次选择达解"，推广时会透支信任
+- 建议先做数据验证：随机抽取 100 个真实问题，统计 AI 解决问题所需轮数分布
+- 如果多数问题在 3-5 轮内解决，可放心宣传；如果超过 7 轮，需先优化知识图谱
+
+---
+
+> **关联文档**：
+> - CG宣传视频脚本: `05-运营文档/01-品牌与推广/CG宣传视频脚本-v1.0.md`
+> - 前端视觉评价: `02-技术文档/前端改造/前端视觉评价-v1.0.md`

docs/05-运营文档/01-品牌与推广/宣传文案-v1.0.md

@@ -0,0 +1,125 @@
+# IT智能服务台 — 宣传文案
+
+> **版本**: v1.0
+> **日期**: 2026-07-10
+> **作者**: 宋献
+> **类型**: 运营 - 品牌与推广
+> **源自**: 方案-全套改造建议与推广-v1.0.md
+
+---
+
+## 一、企微群发文案（短推版）
+
+```
+【IT智能服务台】七选达解，你的IT问题我们包了
+
+电脑蓝屏？VPN连不上？审批找不到入口？
+别到处问了，IT智能服务台7条路径帮你搞定：
+
+1️⃣ 问AI — 70%的问题秒答
+2️⃣ 呼叫人工坐席 — 30秒接通真人
+3️⃣ 摇人（坐席）— 多坐席会诊
+4️⃣ 邀专家 — 定向邀请对口
+5️⃣ 查知识 — 自助搜索
+6️⃣ 提审批 — 12类在线办
+7️⃣ 追进度 — 全程可追踪
+
+👉 入口：企微工作台 → IT智能服务台
+👉 或直接扫码进入
+
+7个选择，找到答案。
+```
+
+---
+
+## 二、海报文案（主视觉）
+
+**主标题**：七选达解
+
+**副标题**：7个选择，找到答案
+
+**正文**：
+> 在这个星球上，7个人能找到你想找的人
+> 在IT服务台，7个选择能找到答案
+
+**底部**：企微工作台 → IT智能服务台 | itsupport.servyou.com.cn
+
+---
+
+## 三、产品介绍长文（内部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智能服务台。
+```
+
+---
+
+## 四、培训PPT文案（首页/尾页）
+
+**首页**：
+> 七选达解
+> IT智能服务台2.0全员培训
+> 7个选择，找到答案
+
+**尾页**：
+> 记住7个选择：
+> 问AI → 呼叫人工坐席 → 摇人(坐席) → 邀专家 → 查知识 → 提审批 → 追进度
+>
+> 入口：企微工作台 → IT智能服务台
+> 有问题？先问AI，搞不定再找人。
+
+---
+
+> **关联文档**：
+> - Slogan分析: `05-运营文档/01-品牌与推广/Slogan分析与优化-v1.0.md`
+> - CG视频脚本: `05-运营文档/01-品牌与推广/CG宣传视频脚本-v1.0.md`

docs/05-运营文档/02-用户手册/会话存档功能-操作手册.md

@@ -0,0 +1,159 @@
+# 会话存档功能 - 操作手册
+
+> **版本**: v1.0 | **日期**: 2026-07-15 | **状态**: 已完成
+
+---
+
+## 1. 功能概述
+
+会话存档功能用于管理 IT 智能服务台的会话历史数据，通过自动归档策略优化系统性能，同时满足合规审计需求。
+
+### 1.1 核心特性
+
+- **自动归档**：已结单会话超过 90 天自动标记为已归档
+- **分级存储**：热数据（90天内）/ 冷数据（90天外）
+- **审计支持**：管理后台可查看完整会话历史
+
+---
+
+## 2. 坐席端操作指南
+
+### 2.1 历史会话显示规则
+
+坐席端历史会话按以下规则显示：
+
+| 层级 | 显示内容 | 位置 |
+|------|----------|------|
+| 当前会话 | 活跃会话（排队/服务中/待关闭） | 顶部"我的会话" |
+| 历史会话 | ≤90天已结单会话 | "历史会话"标签 |
+| 更久历史 | 不显示 | — |
+
+### 2.2 查看更早会话
+
+**问题**：坐席端看不到 90 天前的历史会话
+
+**解决方案**：
+
+1. 访问管理后台
+2. 进入「会话审计」页面
+3. 使用筛选功能查找历史会话
+
+---
+
+## 3. 管理后台操作指南
+
+### 3.1 访问会话审计
+
+```
+URL: https://itsupport.servyou.com.cn/itadmin/
+路径: 会话管理 → 会话审计
+```
+
+### 3.2 按归档状态筛选
+
+1. 进入会话审计页面
+2. 找到「归档」筛选下拉框
+3. 选择筛选条件：
+   - 全部
+   - 未归档
+   - 已归档
+
+### 3.3 查看归档会话详情
+
+1. 在会话列表中找到已归档的会话（显示「已归档」标签）
+2. 点击会话行查看详情
+3. 可查看完整的会话消息历史
+
+### 3.4 筛选条件组合
+
+| 场景 | 状态 | 归档 | 日期范围 |
+|------|------|------|----------|
+| 查看所有历史会话 | resolved | 全部 | — |
+| 查看近期会话 | resolved | 未归档 | 近90天 |
+| 查看归档会话 | resolved | 已归档 | 90天前 |
+
+---
+
+## 4. 运维操作指南
+
+### 4.1 定时任务配置
+
+归档脚本通过 crontab 定时执行：
+
+```bash
+# 编辑 crontab
+crontab -e
+
+# 添加以下行（每天凌晨3点执行）
+0 3 * * * cd /opt/wecom-it-desk/backend && python scripts/archive_sessions.py >> /var/log/itdesk-archive.log 2>&1
+```
+
+### 4.2 手动执行归档
+
+```bash
+# SSH 到服务器
+ssh sxn@10.212.189.210
+
+# 进入后端目录
+cd /opt/wecom-it-desk/backend
+
+# 执行归档脚本
+python scripts/archive_sessions.py
+```
+
+### 4.3 查看归档日志
+
+```bash
+# 查看归档日志
+tail -f /var/log/itdesk-archive.log
+
+# 查看历史归档记录
+cat /var/log/itdesk-archive.log | grep归档
+```
+
+### 4.4 日志示例
+
+```
+[2026-07-15 03:00:00] 开始执行会话归档任务...
+[2026-07-15 03:00:00] 归档阈值: 90 天
+[2026-07-15 03:00:00] 找到 15 个需要归档的会话
+[2026-07-15 03:00:01] 成功归档 15 个会话
+[2026-07-15 03:00:01] 归档时间: 2026-07-15T03:00:01+00:00
+```
+
+---
+
+## 5. 常见问题
+
+### 5.1 坐席端看不到历史会话
+
+**原因**：会话已超过 90 天，已自动归档
+
+**解决**：到管理后台查看
+
+### 5.2 归档状态筛选不生效
+
+**检查**：
+
+1. 确认筛选条件填写正确
+2. 尝试清除筛选条件查看全部
+
+### 5.3 归档脚本执行失败
+
+**常见原因**：
+
+1. 数据库连接失败
+2. Python 依赖缺失
+
+**解决**：
+
+1. 检查数据库配置
+2. 确认已安装依赖：`pip install -r requirements.txt`
+
+---
+
+## 6. 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| v1.0 | 2026-07-15 | 初始版本 |

docs/05-运营文档/02-用户手册/手册-坐席端.md

@@ -0,0 +1,266 @@
+# 企微IT智能服务台 — 坐席端功能操作手册
+
+> **版本**: v1.1 | **日期**: 2026-08-03 | **维护人**: Duckula
+> **目标读者**: **坐席人员 / IT 支持工程师** — 掌握坐席工作台各功能的使用方法
+>
+> **变更记录**：
+> | 日期 | 版本 | 变更内容 | 变更人 | 变更原因 |
+> |------|------|----------|--------|----------|
+> | 2026-07-13 | v1.0 | 初版 | Duckula | — |
+> | 2026-08-03 | v1.1 | **修正 §5.4 错误描述**：原"PC 端（坐席）：百度 ASR" → 实际为"浏览器原生 Web Speech API（Chrome/Edge）"；补充 H5 PC/Mac 企微用户改用后端百度 ASR 的真实链路 | Duckula | voice_asr.py 加 auth 安全巡检时发现文档-代码不一致 |
+
+---
+
+## 目录
+
+1. [登录与认证](#一登录与认证)
+2. [会话管理](#二会话管理)
+3. [群聊与摇人](#三群聊与摇人)
+4. [AI 辅助功能](#四ai-辅助功能)
+5. [消息发送](#五消息发送)
+6. [审批处理](#六审批处理)
+7. [历史会话查询](#七历史会话查询)
+8. [其他功能](#八其他功能)
+
+---
+
+## 一、登录与认证
+
+### 1.1 登录方式
+
+**访问地址**: `https://itsupport.servyou.com.cn/itagent/`
+
+| 登录方式 | 说明 |
+|----------|------|
+| 企微扫码 | 首次登录使用，直接扫码授权 |
+| OTP 二次验证 | 首次登录后绑定，之后每次登录需输入 OTP 验证码 |
+
+### 1.2 首次登录流程
+
+1. 打开坐席工作台 URL
+2. 使用企业微信扫描二维码
+3. 首次登录需绑定 OTP：扫描页面显示的二维码到认证 APP（如腾讯会议、Microsoft Authenticator 等）
+4. 输入 OTP 验证码完成绑定
+5. 登录成功，进入工作台
+
+### 1.3 后续登录流程
+
+1. 打开坐席工作台 URL
+2. 企微扫码授权
+3. 输入 OTP 验证码
+4. 登录成功
+
+---
+
+## 二、会话管理
+
+### 2.1 会话列表
+
+- 左侧栏显示当前在线员工的会话列表
+- 按最新消息时间排序
+- 显示员工姓名、最后一条消息摘要、等待时间
+
+### 2.2 接单与会话
+
+- 员工发起咨询后，会话进入「待接单」队列
+- 坐席点击「📥 接单」按钮开始服务，按钮变为「已接单」并禁用
+- 接单后会话状态变为「进行中」
+
+### 2.3 会话转移
+
+- 支持将会话转移给其他坐席
+- 点击会话右上角「转移」按钮，选择目标坐席
+- 转移后原坐席自动退出会话
+
+### 2.4 结单
+
+- 服务完成后，点击「结单」按钮结束会话
+- 系统会弹出满意度评价卡片，邀请员工评价
+
+---
+
+## 三、群聊与摇人
+
+### 3.1 四种角色
+
+| 角色 | 说明 | 权限 |
+|------|------|------|
+| 发起人 | 创建会话的人 | 最高权限，可踢人、转让管理员 |
+| 管理员 | 被授予管理权限的人 | 可踢人、修改群信息 |
+| 普通成员 | 参与会话的人 | 正常发言、接收消息 |
+| 观察者 | 仅接收消息，不可见回复框 | 只读模式 |
+
+### 3.2 摇人（请求协助）
+
+- 当坐席遇到疑难问题时，可点击「摇人」按钮请求其他坐席协助
+- 被摇到的坐席会收到通知
+- 双方进入同一会话，共同处理
+
+### 3.3 邀请其他人
+
+- 点击会话右侧「+ 邀请」按钮
+- 可选择邀请其他坐席或外部人员
+- 邀请时需选择角色（普通成员 / 观察者）
+
+---
+
+## 四、AI 辅助功能
+
+### 4.1 智能推荐
+
+- AI 会根据员工问题自动推荐解决方案
+- 推荐内容显示在右侧栏「智能推荐」标签页
+- 点击推荐项可直接发送给员工
+
+### 4.2 上下文感知诊断
+
+- AI 自动分析对话上下文，识别问题类型
+- 三层诊断：症状 → 原因 → 解决方案
+- 排队过程中员工可答题加速诊断
+
+### 4.3 修复闭环
+
+- AI 提供修复步骤后，跟踪员工是否完成修复
+- 五种关闭场景：员工确认解决 / 员工超时未响应 / 坐席手动关闭 / 重复问题 / 转人工
+
+### 4.4 知识库检索
+
+- 点击右侧栏「知识库」标签页
+- 可手动搜索相关知识
+- 搜索结果可直接发送给员工
+
+---
+
+## 五、消息发送
+
+### 5.1 文字消息
+
+- 在底部输入框输入文字
+- 按 Enter 发送，Shift+Enter 换行
+
+### 5.2 图片消息
+
+- 点击输入框左侧「图片」图标
+- 选择本地图片发送
+
+### 5.3 截图消息
+
+- 点击输入框左侧「截图」图标（或使用快捷键）
+- 截取屏幕后自动插入输入框
+- 发送后员工可见
+
+### 5.4 语音转文字
+
+> **2026-08-03 修正**：本节原"PC 端（坐席）：百度 ASR"描述**与实际部署不符**，修正如下。
+> 详见 `docs/02-技术文档/技术架构/技术方案-REQ-AI-003-语音转文字-v1.1.md` §10 增量更新。
+
+| 终端 / 环境 | 方式 | 技术方案 | 浏览器/客户端要求 |
+|---|---|---|---|
+| **手机端 H5**（企微 WebView） | 长按语音按钮说话，自动转文字 | 企微 JS-SDK（`wx.startRecord`/`wx.translateVoice`） | 企微 iOS/Android 客户端 2.4+ |
+| **PC/Mac 端 H5**（企微 WebView） | 点击「语音」按钮 → 前端录音 → 上传后端识别 → 自动转文字 | **前端录音 + 后端 `POST /api/voice/asr`（百度 ASR）** | 企微 PC/Mac 客户端（JS-SDK 在桌面端不回调，必须用此方案）|
+| **PC 端坐席工作台**（浏览器直开） | 点击「语音」按钮说话，自动转文字 | **浏览器原生 Web Speech API**（`SpeechRecognition` + `interimResults=true` 实时转写） | Chrome 25+ / Edge 79+ |
+
+**为什么不统一用 Web Speech API**：
+- 企微 PC/Mac 客户端内置浏览器的 WebView **不支持** Web Speech API（policy 限制）
+- 企微 JS-SDK 的 `startRecord`/`translateVoice` 在企微 PC/Mac 客户端**永远挂起**（不回调 success/fail）
+- 因此 PC/Mac 端企微环境必须改用"前端录音 → 后端百度 ASR"路径
+
+**降级策略**：
+- 任一终端浏览器不支持语音识别 → 语音按钮**自动隐藏**（不显示禁用态）
+- 识别失败 → ElMessage/Toast 提示，**保留输入框已有内容**
+- 录音权限被拒绝 → 提示"请允许麦克风权限"
+
+### 5.5 文件消息
+
+- 点击输入框左侧「文件」图标
+- 选择本地文件发送
+
+---
+
+## 六、审批处理
+
+### 6.1 审批类型
+
+系统支持 12 种审批类型，共 18 个审批流程：
+
+| 类别 | 审批类型 |
+|------|----------|
+| IT 类 | 软件安装、权限申请、账号申请、设备领用 |
+| 行政类 | 加班申请、请假申请 |
+| 财务类 | 报销申请 |
+| 其他 | ... |
+
+### 6.2 审批操作
+
+- AI 识别员工意图后，自动转接对应审批流程
+- 坐席可查看审批详情、催促审批、驳回或通过
+
+### 6.3 三级意图识别
+
+- **一级意图**：判断员工要做什么（报修 / 咨询 / 审批）
+- **二级意图**：具体类型（软件安装 / 网络问题 / 加班审批）
+- **三级意图**：具体事项（安装 Photoshop / 无法连接 VPN）
+
+---
+
+## 七、历史会话查询
+
+### 7.1 功能位置
+
+- 打开员工会话窗口
+- 在 UserInfoBar（员工信息栏）的等级 chips 后方
+- 点击「历史会话」开关按钮
+
+### 7.2 功能说明
+
+- 开启后，会显示该员工所有历史会话的消息
+- 不同会话之间显示分隔条，包含首条消息摘要（前20字）
+- 当前会话的分隔条会高亮显示，并标注「当前会话」
+- 支持滚动懒加载更多历史消息
+
+### 7.3 使用场景
+
+- 员工再次咨询时，坐席可快速查看该员工的历史问题记录
+- 了解员工此前是否已解决相同问题
+- 避免重复解答，提升服务效率
+
+---
+
+## 八、其他功能
+
+### 8.1 IT 资产推送
+
+- 员工咨询涉及电脑、软件等问题时
+- AI 自动推送相关 IT 资产信息（电脑配置、软件清单等）
+- 显示在右侧栏「资产」标签页
+
+### 8.2 代办事项
+
+- 员工提交的待处理事项
+- 显示在左侧栏「待办」标签页
+- 支持查看详情、标记完成、设置提醒
+
+### 8.3 会议室预定
+
+- 员工可通过 H5 端预定会议室
+- 坐席可查看会议室预定情况
+- 支持小鱼易联终端联动
+
+---
+
+## 附录：快捷键
+
+| 快捷键 | 功能 |
+|--------|------|
+| Ctrl + Enter | 发送消息 |
+| Ctrl + S | 截图 |
+| Ctrl + K | 打开快捷搜索 |
+| Esc | 关闭弹窗 |
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| v1.0 | 2026-07-13 | 初始版本，包含所有已上线功能 |