docs(REQ-会话-001): v1.4 状态条删除闭环 + 三件套升 v1.4

- 以 v1.3.5 代码为准，删除整合区状态条（不向员工暴露坐席在线/离线） - PRD/技术方案/原型三件套升 v1.4：整合区 4→3 元素（操作按钮+进度胶囊+引导语） - 任务说明书 v1.3→v1.4：M8 shiftHours 取消、M9 降为三元素、M11 依赖调整 - TR-会话-001-v1.3.2 分歧1 由待拍板升级为已闭环，附录A 补 v1.4 闭环记录 - 整改记录 #9→#10：闭环状态条分歧遗留项（v1.7 登记） - 代码落地：IntegrationZone.vue 移除状态条渲染；新增 integrationZoneStatusBar.test.ts 源码级回归守卫
2026-08-04 00:34:41 +08:00
parent 502551ad9c
commit 1c5169531a
14 changed files with 2799 additions and 85 deletions
@@ -0,0 +1,456 @@
 # 员工结束会话 PRD
 > **版本**: v1.4
 > **日期**: 2026-08-03
 > **REQ编号**: REQ-会话-001
 > **优先级**: P1
 > **阶段**: 近期
 > **状态**: 已拍板（v1.4 删除整合区状态条，整合区降为「操作按钮 + 进度胶囊 + 引导语」三元素）
 > **基线版本**: v1.3（2026-07-31；v1.3.5 状态条删除决策于 v1.4 完整落地）
 ---
 ## 一、需求概述
 ### 1.1 需求背景
 **延续 v1.0/v1.1 背景**：
 1. 用户无法主动结束会话，若要结束错误对话历史（如 AI 回答错误），只能开启新会话
 2. 人工咨询场景缺少员工主动结束的入口
 3. 满意度评价仅在 AI 判定问题已解决时触发，无法覆盖所有会话场景
 4. 按钮维度过载，5 种状态文案切换频繁
 5. 右栏信息冗余，移动端（<500px）不渲染右栏导致桌面端堆砌的功能"白做"
 **v1.2 新增背景**：
 1. **顶部退出按钮的真实定位**：经产品澄清，标题栏红色退出按钮**仅服务于 AI 会话的兜底退出**，用于"用户主动告诉系统别再发未回复倒计时"，**不应用于结束人工会话**。人工咨询启动后，顶部按钮应自动隐藏，由操作按钮的"结束咨询"接管。
 2. **「无会话」首次进入需要引导**：之前做成 hidden 是工程角度的偷懒，用户体验上应让按钮始终可见 + 引导语引导"先说问题"，避免一打开就催人工。
 3. **「重新打开」按钮补全会话收尾体验**：会话已关闭后 24h 内，按钮变成"重新打开"而非 disabled，避免用户卡死无法继续。
 4. **end 态按钮回归**：v1.1 移除了"结束咨询"按钮态（统一改用顶部按钮），v1.2 恢复——因为顶部按钮的语义已收窄到 AI 场景，**人工场景的"挂断"动作必须保留在操作按钮上**。
 ### 1.2 需求目标
 | 目标 | 说明 | 状态 |
 |------|------|------|
 | G1 | 员工可主动结束当前会话（AI 或人工） | 延续 v1.0 ✅ |
 | G2 | 结束会话时强制收集满意度评价 | 延续 v1.0 ✅ |
 | G3 | 操作按钮承载"会话进程"完整闭环（呼叫-排队-服务-结束-重开） | v1.2 增强 ✏️ |
 | G4 | 服务可用性在标题栏显眼可见 | v1.1 沿用 ✅ |
 | G5 | 排队进度靠近底部、不污染对话流 | v1.1 沿用 ✅ |
 | G6 | 右栏聚焦核心：设备诊断 + 智能推荐 | v1.1 沿用 ✅ |
 | G7 | 顶部退出按钮语义收窄到"AI 兜底退出"，人工场景自动隐藏 | v1.2 新增 🆕 |
 | G8 | 「无会话」/「<3 轮对话」用引导语代替禁用按钮 | v1.2 新增 🆕 |
 | G9 | 「会话已关闭 24h 内」显示"重新打开"按钮 | v1.2 新增 🆕 |
 ---
 ## 二、用户故事
 | # | 角色 | 用户故事 | 优先级 |
 |---|------|----------|--------|
 | US-1 | 员工 | 作为员工，我希望在会话结束时能主动关闭会话，以便开始新会话获取正确回答 | P0 |
 | US-2 | 员工 | 作为员工，我希望结束会话时能评价本次服务，以便反馈服务质量 | P0 |
 | US-3 | 员工 | 作为员工，我希望一眼看到坐席是否在线，以便判断"AI 答不出时能否转人工" | P1 |
 | US-4 | 员工 | 作为员工，我希望排队时能看到进度（前面几个人、还要多久），以便降低焦虑 | P1 |
 | US-5 | 员工 | 作为员工，我希望 AI 对话中能用顶部按钮明确告诉系统"我走了"，以免被打扰提醒 | P1 🆕 |
 | US-6 | 员工 | 作为员工，我希望刚打开应用时知道"先说什么才能叫人"，而不是看到灰按钮困惑 | P2 🆕 |
 | US-7 | 员工 | 作为员工，我希望会话关闭后还能在 24h 内重新打开，避免反复开新会话丢失上下文 | P2 🆕 |
 > **v1.4 反转说明**：US-3（"一眼看到坐席是否在线"）在 v1.3 通过整合区状态条满足，但 v1.4 已删除状态条（不向员工暴露坐席在线/离线状态），故 US-3 在 v1.4 不再满足；相关诉求改以"引导语 + 操作按钮 disabled 态"间接体现（坐席离线时引导语提示"建议先用 AI 解答；如紧急可刷新重试"）。
 ---
 ## 三、功能详情
 ### 3.1 设计哲学：维度分离 + 场景互斥
 **v1.2 核心设计思想**：把 5 种操作按钮状态、引导语、顶部按钮可见性，按"会话场景"重新划分，确保每个 UI 元素的职责单一、场景不重叠。
 **三维度划分**（v1.1 沿用 + v1.2 增强）：
 | 维度 | 性质 | UI 形式 | v1.2 变化 |
 |---|---|---|---|
 | **A. 服务可用性** | 系统状态 | 标题栏徽章 🟢/⚫ | 沿用 |
 | **B. 会话进程** | 用户动作 | 操作按钮 6 态 + 引导语 | **6 态 + 引导语** |
 | **C. 排队进度** | 实时反馈 | 底部消息胶囊 | 沿用 |
 | **D. 退出兜底**（v1.2 新增独立维度） | AI 场景专属 | 标题栏红色退出按钮 | **仅 AI 场景显示** |
 **为什么"退出兜底"独立成维度**：
 - 顶部按钮的语义在 v1.1 模糊（"既能退出 AI 又能结束人工"）
 - v1.2 收窄后，它变成"AI 会话兜底退出"的专用入口
 - 与操作按钮 end 态**场景互斥**——任何时候只有一个可用，从根本上避免"双入口混淆"
 ### 3.2 操作按钮 6 态状态机（v1.2 核心变更）
 **位置**：输入栏控件区第一层（独占一行），与发送按钮上下相邻
 **6 态定义**（移除 hidden / 恢复 end / 新增 reopen）：
 | 状态值 | 触发条件 | 按钮文案 | 按钮图标 | 按钮样式 | 可点击 |
 |--------|---------|---------|---------|---------|--------|
 | **disabled**（v1.2 扩展场景） | 无会话 / AI <3 轮 / 坐席离线 / 会话过期 | 人工坐席 | 🔒 | 灰色禁用 | ❌ |
 | **active** | AI ≥3 轮 / 无紧急词 | 人工坐席 | 🎧 | 绿色描边 | ✅ |
 | **urgent** | 检测到紧急关键词 | 人工坐席 | 🚨 | 红色脉冲 | ✅ |
 | **waiting** | 排队中 | 排队等待 | ⏳ | 橙色描边 | ✅（点击取消） |
 | **end** 🆕（v1.2 恢复） | 坐席已接入（conv.status === 'serving'） | 结束咨询 | 📴 | 红色填充 | ✅（点击弹满意度评价） |
 | **reopen** 🆕（v1.2 新增） | 会话已关闭 + 24h 内 | 重新打开 | 🔄 | 蓝色填充 | ✅（调用 reopen API） |
 **v1.2 移除的态**：
 - ❌ **hidden** — 不再使用，所有场景都有按钮呈现（避免用户找不到入口）
 **优先级顺序**（代码逻辑）：
 ```
 end > reopen > waiting > active/urgent > disabled
 ```
 ### 3.3 引导语设计（v1.2 新增 G8）
 **位置**：操作按钮正下方的小字（参考现有 `input-bar__guide` 样式，InputBar.vue 行 128-130 已有此结构）
 **4 种场景引导语**：
 | 场景 | 引导语 | 设计意图 |
 |---|---|---|
 | **无会话**（刚打开应用） | 💡 先描述一下你遇到的问题，AI 助手会先帮你看看 | 一开始就让用户知道"先说问题" |
 | **AI 对话 <3 轮** | 请继续描述您的问题或需求 | 鼓励继续描述，不显示进度数字（避免催促感） |
 | **坐席离线** | ⚠️ 坐席当前离线，建议先用 AI 解答；如紧急可刷新重试 | 不完全堵死，给"刷新重试"出口 |
 | **会话过期**（>24h） | ⏰ 上一会话已过期，开始新对话吧 | 引导开新会话 |
 **设计原则**：
 1. **不显示 `{n}/3` 进度数字** — 避免催促感，让用户专注于描述问题
 2. **所有引导语都鼓励"先 AI"** — 不给坐席端制造流量压力
 3. **离线情况给出口** — 不直接禁用按钮的可达性，留"刷新重试"
 4. **过期明确引导"开新对话"** — 避免用户困惑"为什么不能重开"
 **引导语和按钮态的对应关系**：
 | 按钮态 | 引导语 |
 |---|---|
 | disabled（无会话） | 先描述一下你遇到的问题... |
 | disabled（AI <3 轮） | 请继续描述您的问题或需求 |
 | disabled（坐席离线） | 坐席当前离线... |
 | disabled（会话过期） | 上一会话已过期... |
 | active | （无引导，或可选"AI 答不出再点人工"） |
 | urgent / waiting / end / reopen | （无引导，避免冗余） |
 ### 3.4 服务可用性指示（v1.1 沿用 G4）
 **位置**：标题栏左上角，与"IT 智能服务"标题相邻
 **当前实现**（ChatPanel.vue:21-28）：
 ```
 [IT] 智能IT服务 · 🟢 坐席在线
 [IT] 智能IT服务 · ⚫ 坐席离线
 ```
 **v1.2 沿用**：永远显示，不随滚动消失。v1.3 将坐席状态从标题栏徽章迁移至整合区状态条；**v1.4 已删除整合区状态条**（不向员工暴露坐席在线/离线），本维度整体取消。
 ### 3.5 顶部退出按钮可见性规则（v1.2 核心新增 G7）
 **位置**：标题栏右侧红色退出按钮（`chat-panel__exit-btn`，SVG 退出图标）
 **v1.2 关键变更**：**仅 AI 会话场景显示**
 | 会话场景 | 顶部按钮可见 | 设计意图 |
 |---|---|---|
 | 无会话 | ❌ 隐藏 | 用户还没开始，没必要 |
 | AI 对话中（disabled / active / urgent） | ✅ 显示 | 兜底退出，告诉系统"别发倒计时" |
 | **人工咨询启动后**（waiting） | **❌ 隐藏** | 操作按钮 waiting 接管取消排队 |
 | **人工服务中**（serving） | **❌ 隐藏** | 操作按钮 end 接管结束人工 |
 | 会话已关闭 | ❌ 隐藏 | 顶部按钮只对"进行中"的会话有意义 |
 **为什么这么设计**：
 - 顶部按钮的语义被收窄为「AI 会话兜底退出」
 - 人工场景的"结束"由操作按钮 end 态专管
 - 两个按钮**场景互斥**，任何时候只有一个可用，**从根源避免双入口混乱**
 - 用户认知简单："AI 时用顶部，人工时用底部"
 **文案强化建议**（技术方案配合）：
 - tooltip：「结束会话（不再发送提醒）」
 - 确认弹窗：「确定要结束这次咨询吗？将不再发送未回复提醒」
 **store 新增字段**（技术方案配合）：
 - `store.showHeaderExitBtn: boolean`
 - 由会话状态计算得出（见 3.5 表格）
 ### 3.6 排队进度消息胶囊（v1.1 沿用 G5）
 **位置**：主对话流底部（输入框上方），锚定底部不随滚动消失
 **4 种状态**（参照 conversation.ts:1800-1814 的"会话已关闭"消息样式）：
 | 排队状态 | 胶囊文案 | 颜色 |
 |---------|---------|------|
 | 未排队 | （不显示胶囊） | — |
 | 排队中 | `⏳ 排队中 · 前面 N 人 · 预计 MM:SS` | 橙色 |
 | 已接入 | `🟢 已接入 · 客服小王` | 绿色，3 秒后淡出 |
 | 会话已关闭 | `✅ 会话已关闭`（或隐藏） | 灰色 |
 **关键约束**：
 - ❌ **不作为消息插入对话历史**（避免污染 AI 上下文）
 - ✅ 仅在关键节点更新（进入排队 / 每跳 3 位 / 接听）
 ### 3.7 右栏简化（v1.1 沿用 G6）
 **删除**（v1.1 已明确）：
 - 右栏底部整段 `right-panel__queue-section`（含标题栏、QueueWaiting 组件、答题挑战）
 - api/queue、api/quiz、`store.queuePositionData`、`cancelQueue`、`handleQueuePositionUpdate`
 - ChatPanel.vue 中 `handleCancelQueue` 流程（改为按钮 emit 到 store）
 **v1.2 保留**（桌面端右栏 2 大区块）：
 1. 顶部手风琴：设备信息 ↔ 自助诊断（互斥折叠）
 2. 中部：智能推荐卡片
 移动端（<500px）不渲染右栏，无变化。
 ### 3.8 结束会话流程（v1.2 修订 G7）
 **双入口，按场景分流**：
 #### 入口 A：操作按钮 end 态（仅坐席服务中）
 ```
 点击操作按钮"📴 结束咨询"
    ↓
 弹出确认框："确定要结束人工咨询吗？"
    ↓ 确认
 调用 employeeClose API → 会话状态 resolved
    ↓
 弹出满意度评价（EvaluationDialog）
    ↓
 提交评价 → 自动关闭窗口
 ```
 #### 入口 B：顶部红色退出按钮（仅 AI 会话）
 ```
 点击顶部红色"退出会话"按钮
    ↓
 弹出确认框："确定要结束这次咨询吗？将不再发送未回复提醒"
    ↓ 确认
 调用 employeeClose API（标记 close_reason='ai_session_quit'）
    ↓
 弹出满意度评价（即使是 AI 服务也收集）
    ↓
 提交评价 → 自动关闭窗口
 ```
 **两个入口的防抖/互斥保证**：
 - 由 `store.showHeaderExitBtn` 和按钮态计算逻辑保证场景互斥
 - 同一按钮组件内 async handler 三件套（防抖 + 同步 store + try/finally 重置）——参见 ChatPanel.vue:403 handleExitWithEvaluation 的修复样本
 ---
 ## 四、非目标
 | # | 明确不做 |
 |---|----------|
 | N1 | 不修改人工呼叫的后端逻辑（仅前端 UI 与状态管理调整） |
 | N2 | 不区分 AI 会话与人工会话的结束流程（都是 close + evaluation） |
 | N3 | 不支持跳过评价直接关闭（必须评价） |
 | N4 | 不做 AI 意图识别"叫人工"功能（v1.3 路线图） |
 | N5 | 不做答题挑战 / 插队机制（已永久移除） |
 | N6 | 不做"在线/繁忙/离线"三态服务可用性（v1.3 路线图） |
 | N7 | 不在引导语中显示 `{n}/3` 进度数字（v1.2 拍板不需要，避免催促感） |
 ---
 ## 五、验收指标
 | # | 指标 | 目标值 | 验收方式 |
 |---|------|--------|---------|
 | AC1 | 员工可主动结束会话（AI 或人工） | 100% | 双入口分别测试 |
 | AC2 | 评价提交率 | =100% | 关闭会话前必须提交评价 |
 | AC3 | 操作按钮状态切换正确 | 6 种状态正确切换 | 完整状态机测试 |
 | AC4 | 服务可用性永远可见 | 标题栏徽章所有状态可见 | 滚动 + 弹窗场景 |
 | AC5 | 排队进度胶囊准确显示 | 排队时显示位置/时间，接听后淡出 | WS 推送全链路 |
 | AC6 | 右栏底部 queue section 完全移除 | 桌面端右栏只含 2 大区块 | 构建产物 + 视觉回归 |
 | AC7 | 不污染对话流 | 排队进度不进入 store.messages | store 检查 + AI 推荐效果对比 |
 | AC8 | 顶部按钮仅 AI 场景显示 🆕 | waiting / serving 时顶部按钮隐藏 | 状态切换测试 |
 | AC9 | 引导语按场景正确显示 🆕 | 4 种场景对应正确引导语 | UI 截图比对 |
 | AC10 | 重新打开按钮 24h 内可见 🆕 | 会话关闭 + 24h 内显示 🔄 按钮，>24h 不显示 | 时间边界测试 |
 | AC11 | 双入口互斥 🆕 | 任何时候顶部按钮和 end 态不同时可用 | 状态机单元测试 |
 ---
 ## 六、关联文档
 | 文档 | 说明 |
 |------|------|
 | `前端组件-InputBar.vue` | 操作按钮 6 态实现 + 引导语渲染 |
 | `前端组件-ChatPanel.vue` | 标题栏坐席状态徽章 + 顶部退出按钮（v1.2 新增 showHeaderExitBtn） |
 | `前端组件-ResolveFeedback.vue` / `EvaluationDialog.vue` | 满意度评价组件 |
 | `前端组件-RightPanel.vue` | 右栏（v1.1 已移除 queue section） |
 | `前端组件-QueueWaiting.vue` | 右栏排队组件（v1.1 标记弃用） |
 | `API-h5.py` | 关闭会话 API + reopen API |
 | `stores/conversation.ts` | 新增 `showHeaderExitBtn` 字段 |
 | `原型-REQ-会话-001-结束会话流程-v1.4.html` | v1.4 原型图（整合区删除状态条） |
 | `../../02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.4.md` | v1.4 技术方案（同步更新） |
 ---
 ## 七、里程碑
 | 阶段 | 任务 | 预计时间 |
 |------|------|---------|
 | M1 | PRD v1.2 评审 | 0.5 天 |
 | M2 | store 新增 `showHeaderExitBtn` 字段 + 状态计算逻辑 | 0.5 天 |
 | M3 | InputBar 改造：hidden → disabled + 6 态扩展 + 4 种引导语 | 1 天 |
 | M4 | ChatPanel 改造：顶部按钮 v-show 绑定 showHeaderExitBtn | 0.5 天 |
 | M5 | 重新打开按钮 + 24h 边界逻辑 | 0.5 天 |
 | M6 | 联调测试 + 视觉回归 | 1 天 |
 | M7 | 上线 | 0.5 天 |
 | **合计** | | **4.5 天** |
 ---
 ## 八、风险与依赖
 | 风险 | 影响 | 缓解措施 |
 |------|------|---------|
 | R1：end 态 + 顶部按钮双入口导致混乱 | 用户不知道该点哪个 | v1.2 设计为场景互斥，从根上避免 |
 | R2：store.showHeaderExitBtn 计算错误 | 顶部按钮在错误场景显示 | 单元测试覆盖所有状态切换路径 |
 | R3：24h 边界判断依赖客户端时钟 | 用户改时间可绕过 | 后端 reopen API 做权威校验，前端仅做 UI 提示 |
 | R4：end 态按钮文案"结束咨询"被理解为"结束 AI 咨询" | 视觉歧义 | end 态仅在 serving 触发，文案下加微提示或 icon 强化"挂断"语义 |
 | R5：引导语和按钮态不同步 | 用户看到引导语但按钮已可点击 | 引导语渲染条件与按钮态计算共享同一 computed |
 **依赖**：
 - D1：WebSocket `queue_position_update` 事件已实现
 - D2：`store.agentOnline` 字段已存在
 - D3：EvaluationDialog 组件已实现
 - D4：reopen API 已在 `closing.ts:119` 实现
 ---
 ## 九、变更记录（v1.1 → v1.2 → v1.3 → v1.4）
 | 变更项 | v1.1 | v1.2 | v1.3（已拍板 ✅） | v1.4（已拍板 ✅） | 原因 |
 |--------|------|------|--------|--------|------|
 | 操作按钮状态数 | 5 态（含 hidden） | **6 态（移除 hidden，恢复 end，新增 reopen）** | 沿用 6 态（位置从 InputBar 移至整合区） | 沿用 6 态 | 隐藏按钮用户体验断裂；end 态回归解决人工场景主动结束需求；v1.3 整合区收纳 |
 | 引导语 | 仅 active 态显示 | **4 种场景分阶段引导语**（在 InputBar 按钮下方） | **迁移到整合区按钮下方** | 沿用（整合区按钮下方） | v1.3 把 InputBar 工具栏瘦身，引导语随按钮一起进整合区 |
 | 顶部按钮可见性 | 所有状态可显示 | **仅 AI 场景显示** | 沿用（仅 AI 场景显示） | 沿用 | 产品澄清：顶部按钮仅服务 AI 兜底退出，人工场景由操作按钮接管 |
 | 「重新打开」按钮 | 无 | **新增（蓝色）** | 沿用（位置从 InputBar 移至整合区） | 沿用 | 会话关闭 24h 内可继续，避免用户卡死 |
 | `{n}/3 进度提示` | 有 | **移除** | 沿用 | 沿用 | 用户拍板避免催促感 |
 | 顶部按钮文案 | 无 tooltip | **加 tooltip + 确认弹窗** | 沿用 | 沿用 | 强化"不再发送提醒"语义 |
 | 状态机互斥保证 | 无 | **showHeaderExitBtn 计算逻辑** | 沿用 | 沿用 | 顶部按钮和 end 态场景互斥 |
 | `hidden` 态 | 存在 | **完全移除** | 沿用 | 沿用 | 按钮永远可见，避免用户找不到入口 |
 | 结束会话入口 | 仅顶部按钮 | **顶部（AI）+ 操作按钮 end（人工）双入口** | 沿用（按钮位置迁移） | 沿用 | 两个入口场景互斥，不是冗余 |
 | 🆕 **整合区（方案 A）** | 无 | 无 | **新增：状态条 + 操作按钮 + 进度胶囊整合** | **调整为三元素：操作按钮 + 进度胶囊 + 引导语（状态条移除）** | v1.3.5 决策不向员工暴露坐席在线/离线状态，整合区降为三元素 |
 | 🆕 **标题栏坐席徽章** | 🟢/⚫ | 🟢/⚫ | **移至整合区顶部（标题栏瘦身）** | **v1.4 移除**（不再向员工展示坐席在线/离线） | 状态条删除后，坐席状态展示整体取消 |
 | 🆕 **整合区背景色** | — | — | **`#fafafa`（浅灰，沿用 chat-mock）** | 沿用 | 与消息区视觉一致 |
 | 🆕 **状态条策略** | — | — | **永久显示** | **✅ 删除（v1.3.5 决策，v1.4 完整落地）** | 产品决定不向员工暴露坐席在线/离线状态，减少焦虑来源而非增加 |
 | 🆕 **状态条文案** | — | — | **🟢 在线 · 9:00-18:00 / 🟡 繁忙 · 预计 N 分钟 / ⚫ 客服暂休 · 9:00-18:00** | **随状态条一并删除** | 状态条删除后，文案与 `store.shiftHours` 计划同步取消 |
 | 🆕 **移动端折叠** | — | — | **不折叠，默认展开** | 沿用 | 移动端与桌面端一致 |
 | 🆕 **维度划分** | 3 维度 | 4 维度（新增"退出兜底"独立维度） | **5 维度（新增"整合区"统一收容）** | **4 维度（整合区降为三元素，取消状态条维度）** | 见 §十一 v1.4 整合区增量 |
 ---
 ## 十、关联缺陷
 | 缺陷编号 | 标题 | 状态 | 优先级 |
 |----------|------|------|--------|
 | [BUG-用户-003](../../03-测试文档/05-缺陷单/BUG-用户-H5结束会话失败-003.md) | H5员工端"结束会话失败,请稍后重试" | 已修复（2026-07-30） | P2-Medium |
 ---
 ## 十一、v1.3 整合区增量（方案 A 已拍板 ✅）
 > **拍板日期**：2026-07-31 下午
 > **关联原型**：[原型-REQ-会话-001-结束会话流程-v1.3.html §⑨](../02-会话管理/原型-REQ-会话-001-结束会话流程-v1.3.html)
 > **关联技术方案**：[技术方案-REQ-会话-001-员工结束会话-v1.3.md §v1.3 整合区实施要点](../../02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.3.md)
 ### 11.1 设计理念
 v1.2 把"结束会话"相关的 4 个维度（服务可用性 / 会话进程 / 排队进度 / 退出兜底）分散到页面的 4 个不同位置——标题栏坐席徽章、InputBar 操作按钮、消息流底部胶囊、顶部红色按钮。这种"分散式布局"导致：
 1. **用户的认知负担重**：要扫描整个对话区才能找到"现在能不能叫人、怎么叫人"
 2. **组件之间的状态同步复杂**：6 态按钮 / 状态徽章 / 进度胶囊各自维护同一份会话状态的投影
 3. **InputBar 工具栏拥挤**：😊📎 输入框 🎧人工坐席 [发送] 一行塞 5 个元素
 v1.3 方案 A 把这 4 个维度重新组织为**两段式**（v1.4 调整为：整合区移除状态条，降为三元素）：
 - **整合区**（永久容器，浅灰背景）：操作按钮 + 进度胶囊 + 引导语 三件套纵向堆叠
 - **顶部退出**（沿用 v1.2）：仅 AI 场景可见
 ### 11.2 整合区 3 元素纵向堆叠（v1.4 移除状态条）
 > **v1.4 变更**：v1.3 原「状态条 + 操作按钮 + 进度胶囊 + 引导语」四元素，v1.4 删除状态条，降为**三元素**。
 | 元素 | 位置 | 性质 | UI 形式（沿用 v1.2 类） |
 |------|------|------|------------------------|
 | 操作按钮 | 整合区中部 | 核心 CTA | `.call-btn--disabled/active/urgent/waiting/end/reopen` 6 态 |
 | 进度胶囊 | 整合区下部 | 按需显示 | `.queue-capsule` + `--connected` 4 态 |
 | 引导语 | 按钮下方 | 4 种场景 | `.input-bar-mock__guide`（含 `--warn` 变体） |
 | 整合区容器边界 | InputBar 上方 | 浅色容器 | inline 样式 `#fafafa`（沿用 chat-mock），不新增 CSS 类 |
 ### 11.3 9 场景整合区 mockup（v1.4 移除状态条列）
 > 完整 mockup 见原型图 §⑨ 9.3；v1.4 起状态条已删除，下表不再含状态条列。
 | # | 场景 | 按钮态 | 引导语 | 进度胶囊 |
 |---|------|--------|--------|----------|
 | 1 | 无会话 | 🔒 disabled | "先描述一下..." | （无） |
 | 2 | AI < 3 轮 | 🔒 disabled | "请继续描述..." | （无） |
 | 3 | AI ≥ 3 轮 | 🎧 active | （无） | （无） |
 | 4 | 紧急关键词 | 🚨 urgent（脉冲） | （无） | （无） |
 | 5 | 坐席离线 | 🔒 disabled | "坐席当前离线..." | （无） |
 | 6 | 排队中 | ⏳ waiting（"排队取消"） | （无） | 🟠 排队中 |
 | 7 | 已接入 | 📴 end（"结束咨询"） | （无） | 🟢 已接入（3 秒淡出） |
 | 8 | 重新打开（24h 内） | 🔄 reopen | （无） | ✅ 会话已关闭 |
 | 9 | 会话过期（>24h） | 🔒 disabled | "上一会话已过期..." | （无） |
 ### 11.4 已拍板决策清单（v1.3 五项 + v1.4 反转一项）
 | # | 维度 | 拍板结果 | 状态 |
 |---|------|----------|------|
 | 1 | 状态条策略 | ❌ v1.3 拍板「永久显示」→ **v1.4 反转：删除**（v1.3.5 决策，v1.4 完整落地） | 已反转 |
 | 2 | 状态条文案 | v1.3 拍板「在线 · 9:00-18:00」→ 随状态条一并删除 | 已移除 |
 | 3 | 整合区背景色 | ✅ 浅灰 `#fafafa`（沿用 chat-mock） | 沿用 |
 | 4 | 引导语位置 | ✅ 整合区按钮下方（方案 A 默认） | 沿用 |
 | 5 | 移动端折叠 | ✅ 不折叠，默认展开 | 沿用 |
 > **v1.4 反转说明**：2026-07-31 v1.3 拍板「状态条永久显示」，但 v1.3.5 开发阶段产品口头决策**不向员工暴露坐席在线/离线状态**（减少焦虑来源、避免"离线即不可用"的误导），仅落地了引导语侧，整合区状态条模板残留至 v1.4 才彻底清理。v1.4 据此将整合区从「状态条 + 按钮 + 胶囊 + 引导语」四元素降为「按钮 + 胶囊 + 引导语」三元素，`IntegrationZone.vue` 状态条 DOM/CSS/`shiftHours` 引用全部移除（见 §11.6 与技术方案 §十）。
 ### 11.5 与 v1.2 位置对比表
 | 位置 | v1.2 现状 | v1.3 方案 A | v1.4 方案（状态条移除） | 变化 |
 |------|-----------|-------------|------------------------|------|
 | 标题栏 | logo + 标题 + 坐席状态🟢⚫ + 主题 + 头像 + 退出 | logo + 标题 + 主题 + 头像 + 退出 | logo + 标题 + 主题 + 头像 + 退出 | -1 元素（坐席状态） |
 | 整合区（永久） | 无 | 状态条 3 态文案 | 无（v1.4 移除） | +1 → -1 永久元素 |
 | 整合区（按钮） | InputBar 工具栏内 | 整合区中部 | 整合区中部 | 位置迁移 |
 | 整合区（按需胶囊） | 消息流底部独立 | 整合区下部（与按钮同容器） | 整合区下部（与按钮同容器） | 位置迁移 |
 | InputBar 工具栏 | 😊📎[输入框][🎧人工坐席][发送] | 😊📎[输入框][发送] | 😊📎[输入框][发送] | -1 元素（按钮） |
 ### 11.6 实施要点
 > **v1.4 状态条清理**：`IntegrationZone.vue` 中状态条 DOM（`.integration-zone__status-bar`）、`statusBarText` computed、`buildStatusBarText` / `SHIFT_HOURS` 引用、`@/utils/shiftHours` 导入、`.integration-zone__status-bar` CSS 块已全部移除；`IntegrationZoneProps` 中 `agentOnline` / `shiftHours` 字段因下游 `QueueCapsule` 降级判定仍消费 `agentOnline` 而保留，`shiftHours` 为后端班次预留（当前无渲染）。回归单测见 `integrationZoneStatusBar.test.ts`（源码级守卫，8 用例）。
 1. **整合区组件**：`IntegrationZone.vue` 容器组件，props 接口见技术方案 v1.4 §D。
 2. **文件清单**（详见技术方案 v1.4 §B）：
   - 新建：`IntegrationZone.vue` / `integrationZone.ts`（`shiftHours.ts` 一并移除，状态条相关工具常量随状态条删除）
   - 修改：`InputBar.vue`（移除操作按钮）/ `ChatPanel.vue`（移除坐席徽章 + 集成 IntegrationZone）/ `QueueCapsule.vue`（集成到 IntegrationZone）
 3. **不动 v1.2y 已 PASS 内容**：6 态按钮文案、坐席离线拦截、取消入口合并、淡出交互 全部保留不动（详见 11.7）。
 ### 11.7 关键约束
 | # | 不动的 v1.2y 已 PASS 内容 | 文件 / 位置 |
 |---|---------------------------|------------|
 | 1 | 4 种引导语文案与按钮态对应关系 | `inputBarGuideText.ts` |
 | 2 | 操作按钮 6 态状态机（含优先级 end > reopen > waiting > active/urgent > disabled） | `inputBarCallAgentState.ts` |
 | 3 | "会话已关闭"消息文本（含带 emoji 兼容） | `conversation.ts:1911-1925 getResolveMessageText` |
 | 4 | reopen API 调用与 24h 边界 | `closing.ts:119 reopenConversation` |
 **v1.3 增量 = 整合区结构 + 5 元素纵向堆叠**，不修改上述 4 处已 PASS 内容。
 ---
 ## 十二、拍板记录
 | 日期 | 决策 | 决策人 | 影响范围 |
 |------|------|--------|----------|
 | 2026-07-31 下午 | 状态条永久显示 | 用户拍板 | §11.4 决策 1（v1.4 已反转） |
 | 2026-07-31 下午 | 状态条文案"在线 · 9:00-18:00" | 用户拍板 | §11.4 决策 2（v1.4 已移除） |
 | 2026-07-31 下午 | 整合区背景色 `#fafafa` 浅灰 | 用户拍板 | §11.4 决策 3 |
 | 2026-07-31 下午 | 引导语放整合区按钮下方 | 用户拍板 | §11.4 决策 4 |
 | 2026-07-31 下午 | 移动端不折叠，默认展开 | 用户拍板 | §11.4 决策 5 |
 | **2026-08-03** | **反转：删除整合区状态条（v1.3.5 决策，v1.4 完整落地）；整合区降为「操作按钮 + 进度胶囊 + 引导语」三元素** | 用户拍板 | §11.4 决策 1 / §11.2 / 技术方案 §十 / 原型图 §⑨ |
 > **后续同步动作**：PRD v1.4（本文档）+ 技术方案 v1.4 + 原型图 v1.4 三件套同步落地；状态条删除后，`store.shiftHours` 后端班次接入计划相应取消（无前端渲染目标）。
@@ -0,0 +1,776 @@
 # 员工结束会话功能 - 技术方案
 > **版本**: v1.3
 > **日期**: 2026-07-31
 > **关联PRD**: ../01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.3.md（§十一 v1.3 整合区增量）
 > **关联原型**: ../01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.3.html §⑨
 > **状态**: 已拍板（方案 A 5 项细节 2026-07-31 落地）
 ---
 ## 一、概述
 本文档描述 v1.2 调整的技术实现方案。**核心变更**：
 1. 操作按钮从 5 态（hidden/disabled/active/urgent/waiting）扩展为 **6 态**（移除 hidden / 恢复 end / 新增 reopen）
 2. 新增 **4 种引导语**渲染逻辑
 3. store 新增 `showHeaderExitBtn` 字段，**控制顶部退出按钮仅 AI 场景显示**
 4. 双入口（顶部退出 + 操作按钮 end）**场景互斥**，从根源避免双入口混乱
 5. 24h 重新打开按钮实现
 > 沿用 v1.1：排队进度底部消息胶囊、右栏移除 queue section、清理 api/queue 和 api/quiz。
 ---
 ## 二、技术架构
 ### 2.1 现有代码结构（v1.2 基准）
 ```
 frontend-h5/src/components/chat/
 ├── InputBar.vue           # 输入栏（含操作按钮 6 态 + 引导语）— v1.2 改造
 ├── ChatPanel.vue          # 对话区（含顶部退出按钮 v-show）— v1.2 改造
 ├── MessageBubble.vue      # 消息气泡（含"会话已关闭"系统消息样式）
 ├── EvaluationDialog.vue   # 满意度评价弹窗
 ├── ResolveConfirmCard.vue # 坐席结单确认卡片
 └── ... 其他
 frontend-h5/src/stores/
 └── conversation.ts        # 新增 showHeaderExitBtn 字段 + reopenSession action
 frontend-h5/src/components/assistant/
 ├── RightPanel.vue         # 右栏（v1.1 已移除 queue section）— v1.2 沿用
 ├── QueueWaiting.vue       # 标记弃用，保留文件以备未来恢复
 └── ...
 ```
 ### 2.2 关键现有代码（InputBar.vue:194-243 v1.1 现状）
 ```typescript
 type CallAgentState = 'hidden' | 'disabled' | 'active' | 'urgent' | 'waiting'
 ```
 **v1.2 改造**：扩展为 6 态，详细见 §3.1。
 ### 2.3 关键现有代码（ChatPanel.vue:59-65 顶部退出按钮）
 ```vue
 <button class="chat-panel__exit-btn" title="结束会话" @click="handleExitWithEvaluation">
  <svg ...>...</svg>
 </button>
 ```
 **v1.2 改造**：增加 `v-show="store.showHeaderExitBtn"`，详见 §3.5。
 ---
 ## 三、方案设计
 ### 3.1 操作按钮 6 态状态机（v1.2 核心变更）
 **位置**：InputBar.vue 控件区第一层（行 78-88）
 **6 态定义**：
 | 状态值 | 触发条件 | 按钮文案 | 按钮图标 | 样式 | 可点击 |
 |--------|---------|---------|---------|------|--------|
 | `disabled` | 无会话 / AI<3 轮 / 坐席离线 / 会话过期 | 人工坐席 | 🔒 | 灰色禁用 | ❌ |
 | `active` | AI≥3 轮 / 无紧急词 | 人工坐席 | 🎧 | 绿色描边 | ✅ |
 | `urgent` | 检测到紧急关键词 | 人工坐席 | 🚨 | 红色脉冲 | ✅ |
 | `waiting` | 排队中 | 排队等待 | ⏳ | 橙色描边 | ✅（取消排队）|
 | `end` 🆕 | 坐席已接入（serving） | 结束咨询 | 📴 | 红色填充 | ✅（弹评价）|
 | `reopen` 🆕 | 会话已关闭 + 24h 内 | 重新打开 | 🔄 | 蓝色填充 | ✅（reopen API）|
 **v1.2 移除**：
 - ❌ `hidden` 态 — 完全移除，所有场景都有按钮呈现
 **优先级顺序**（v1.2 修订）：
 ```
 end > reopen > waiting > active/urgent > disabled
 ```
 ### 3.2 状态流转图
 ```
                        ┌── (打开应用 / 重新进入)
                        ↓
              ┌──────────────────┐
              │   disabled       │ ← 无会话
              │   "先说问题"      │
              └────────┬─────────┘
                       │ 用户输入 + AI ≥3 轮
                       ↓
              ┌──────────────────┐
              │   active         │ ── 检测到紧急词 ──→ urgent
              │   "人工坐席"      │                       │
              └────────┬─────────┘                       │
                       │ 点击 / 紧急关键词                  │
                       ↓                                  ↓
              ┌──────────────────┐               ┌──────────────────┐
              │   waiting        │ ←─────────────│   urgent         │
              │   "排队等待"      │               │   "人工坐席"      │
              └────────┬─────────┘               └──────────────────┘
                       │ 坐席接听
                       ↓
              ┌──────────────────┐
              │   end 🆕         │
              │   "结束咨询"      │
              └────────┬─────────┘
                       │ 坐席挂断 / 用户点结束
                       ↓ (close + 评价)
              ┌──────────────────┐
              │   reopen 🆕      │ ← 会话已关闭 + 24h 内
              │   "重新打开"      │
              └────────┬─────────┘
                       │ 点击 reopen
                       ↓
              ┌──────────────────┐
              │   active         │ (回到正常会话流程)
              └──────────────────┘
 ```
 ### 3.3 store 新增字段（v1.2 关键）
 **文件**：`stores/conversation.ts`
 ```typescript
 // 新增：顶部退出按钮是否可见（仅 AI 会话显示）
 const showHeaderExitBtn = computed<boolean>(() => {
  const conv = currentConversation.value
  if (!conv) return false                                  // 无会话：隐藏
  if (conv.status === 'resolved') return false             // 会话已关闭：隐藏
  // 人工咨询启动后（waiting / serving）：隐藏
  const isHumanActive =
    conv.status === 'waiting' ||
    conv.status === 'serving' ||
    !!queuePositionData.value                              // 排队中
  if (isHumanActive) return false
  // AI 对话中：显示
  return true
 })
 // 新增：会话是否在 24h 重新打开窗口内
 const canReopen = computed<boolean>(() => {
  const conv = currentConversation.value
  if (!conv || conv.status !== 'resolved') return false
  if (!conv.resolved_at) return false
  const elapsed = Date.now() - new Date(conv.resolved_at).getTime()
  return elapsed < 24 * 60 * 60 * 1000                    // 24h 内
 })
 // 新增：重新打开会话 action（调用 closing.ts 已有的 reopenConversation）
 async function reopenCurrentConversation(): Promise<void> {
  const conv = currentConversation.value
  if (!conv || !canReopen.value) return
  const result = await reopenConversation(conv.conversation_id)
  // 更新 store，触发 UI 切回 active 态
  if (result) {
    // ... 复用现有 openConversation 流程
  }
 }
 ```
 ### 3.4 组件改动
 #### 3.4.1 InputBar.vue
 **改动 1：状态类型扩展**
 ```typescript
 // v1.1
 type CallAgentState = 'hidden' | 'disabled' | 'active' | 'urgent' | 'waiting'
 // v1.2
 type CallAgentState = 'disabled' | 'active' | 'urgent' | 'waiting' | 'end' | 'reopen'
 ```
 **改动 2：状态计算逻辑**
 ```typescript
 const callAgentState = computed<CallAgentState>(() => {
  const conv = store.currentConversation
  if (!conv) return 'disabled'                  // v1.2: 无会话 = disabled（不再 hidden）
  // 🆕 会话已关闭 + 24h 内 → reopen
  if (conv.status === 'resolved' && store.canReopen) return 'reopen'
  // 🆕 坐席已接入 → end
  if (conv.status === 'serving') return 'end'
  // 🆕 顶部按钮可见性也通过 store.showHeaderExitBtn 暴露给父组件
  if (conv.status === 'waiting') return 'waiting'
  // 紧急关键词检测
  if (checkUrgentKeywords()) return 'urgent'
  // AI ≥3 轮 / canCallAgent
  if (store.canCallAgent) return 'active'
  // 兜底：disabled（含 AI<3 轮、坐席离线、过期等场景）
  return 'disabled'
 })
 ```
 **改动 3：按钮文案 + 图标扩展**
 ```typescript
 const callAgentBtnText = computed(() => {
  if (callAgentState.value === 'waiting') return '排队等待'
  if (callAgentState.value === 'end') return '结束咨询'        // 🆕
  if (callAgentState.value === 'reopen') return '重新打开'    // 🆕
  return '人工坐席'
 })
 const callAgentBtnIcon = computed(() => {
  if (callAgentState.value === 'waiting') return '⏳'
  if (callAgentState.value === 'urgent') return '🚨'
  if (callAgentState.value === 'active') return '🎧'
  if (callAgentState.value === 'end') return '📴'              // 🆕
  if (callAgentState.value === 'reopen') return '🔄'          // 🆕
  return '🔒'
 })
 ```
 **改动 4：按钮样式扩展**
 ```typescript
 const callAgentBtnClass = computed(() => ({
  'call-agent-btn--disabled': callAgentState.value === 'disabled',
  'call-agent-btn--active': callAgentState.value === 'active',
  'call-agent-btn--urgent': callAgentState.value === 'urgent',
  'call-agent-btn--waiting': callAgentState.value === 'waiting',
  'call-agent-btn--end': callAgentState.value === 'end',        // 🆕
  'call-agent-btn--reopen': callAgentState.value === 'reopen',  // 🆕
 }))
 ```
 **改动 5：点击行为扩展（end / reopen 分支）**
 ```typescript
 function handleCallAgent(): void {
  if (callAgentState.value === 'disabled') return
  // 🆕 end 态：触发结束会话流程（与顶部按钮共用 emit）
  if (callAgentState.value === 'end') {
    emit('end-conversation')
    return
  }
  // 🆕 reopen 态：调用 reopen API
  if (callAgentState.value === 'reopen') {
    store.reopenCurrentConversation()
    return
  }
  if (callAgentState.value === 'waiting') {
    emit('cancel-queue')
    return
  }
  // active / urgent → 呼叫坐席
  emit('call-agent')
 }
 ```
 **改动 6：emit 扩展**
 ```typescript
 const emit = defineEmits<{
  (e: 'call-agent'): void
  (e: 'cancel-queue'): void
  (e: 'end-conversation'): void   // 🆕（操作按钮 end 态专用，复用 handleExitWithEvaluation）
 }>()
 ```
 **改动 7：新增引导语渲染**
 ```vue
 <template>
  <!-- 操作按钮 + 引导语 -->
  <div class="input-bar__controls">
    <button
      v-if="callAgentState !== 'reopen'"   <!-- 🆕 reopen 态不显示"人工坐席"图标按钮 -->
      class="call-agent-btn"
      :class="callAgentBtnClass"
      ...
    >
      <span class="call-agent-btn__icon">{{ callAgentBtnIcon }}</span>
      <span class="call-agent-btn__text">{{ callAgentBtnText }}</span>
    </button>
    <!-- 🆕 引导语：4 种场景 -->
    <div v-if="guideText" class="input-bar__guide" :class="guideClass">
      {{ guideText }}
    </div>
  </div>
 </template>
 <script setup>
 // 🆕 引导语计算
 const guideText = computed<string | null>(() => {
  const conv = store.currentConversation
  const state = callAgentState.value
  // 仅 disabled 态显示引导语（active/urgent/waiting/end/reopen 不显示）
  // 注意：这里 state 是 CallAgentState 按钮态（含 'active'），不是会话 status
  if (state !== 'disabled') return null
  // 场景1：无会话
  if (!conv) return '💡 先描述一下你遇到的问题，AI 助手会先帮你看看'
  // 场景2：AI <3 轮（用 canCallAgent 反推）
  // v1.2 P1 Bug 修复（QA 第 1 轮 2026-07-30）：原代码误用 'active'，
  //   但 ConversationInfo.status 取值为 'ai_handling' | 'waiting' | 'serving' | 'resolved'
  //   （见 src/frontend-h5/src/api/conversation.ts:44），
  //   导致引导语场景 2 永远不显示。正确应为 'ai_handling'。
  if (conv.status === 'ai_handling' && !store.canCallAgent) {
    return '请继续描述您的问题或需求'
  }
  // 场景3：坐席离线
  if (!store.agentOnline) {
    return '⚠️ 坐席当前离线，建议先用 AI 解答；如紧急可刷新重试'
  }
  // 场景4：会话过期（>24h）
  if (conv.status === 'resolved' && !store.canReopen) {
    return '⏰ 上一会话已过期，开始新对话吧'
  }
  return null
 })
 const guideClass = computed(() => ({
  'input-bar__guide--warn': guideText.value?.includes('⚠️'),
 }))
 </script>
 ```
 **改动 8：样式新增（end / reopen）**
 ```scss
 // 🆕 end 态：红色填充（最显眼的"危险/结束"语义）
 .call-agent-btn--end {
  border-color: var(--color-danger);
  background: var(--color-danger);
  color: #fff;
  font-weight: 700;
  &:hover {
    background: #dc2626;
  }
  &:active {
    transform: scale(0.96);
  }
 }
 // 🆕 reopen 态：蓝色填充（中性"恢复"语义）
 .call-agent-btn--reopen {
  border-color: var(--info, #1989fa);
  background: var(--info-light, #ecf5ff);
  color: var(--info, #1989fa);
  &:hover {
    background: var(--info, #1989fa);
    color: #fff;
  }
  &:active {
    transform: scale(0.96);
  }
 }
 ```
 #### 3.4.2 ChatPanel.vue（顶部按钮可见性）
 **改动 1：顶部按钮 v-show 绑定**
 ```vue
 <!-- v1.1：始终显示 -->
 <button class="chat-panel__exit-btn" @click="handleExitWithEvaluation">
 <!-- v1.2：仅 AI 场景显示 -->
 <button
  v-show="store.showHeaderExitBtn"
  class="chat-panel__exit-btn"
  title="结束会话（不再发送提醒）"
  @click="handleExitWithEvaluation"
 >
 ```
 **改动 2：处理 end 态的 emit**
 ```typescript
 // InputBar @end-conversation 事件处理
 async function handleEndConversation(): Promise<void> {
  // 复用现有 handleExitWithEvaluation 逻辑
  await handleExitWithEvaluation()
 }
 ```
 **改动 3：模板绑定 InputBar 新事件**
 ```vue
 <InputBar
  @call-agent="handleDirectCall"
  @cancel-queue="handleCancelQueue"
  @end-conversation="handleEndConversation"   <!-- 🆕 -->
 />
 ```
 **改动 4：顶部按钮 tooltip / 弹窗文案**
 ```typescript
 // 顶部按钮点击后弹窗文案调整
 const showExitConfirm = ref<boolean>(false)
 function handleExitWithEvaluation(): void {
  // 弹窗文案强化"不再发送提醒"
  showExitConfirm.value = true
 }
 // van-dialog message:
 message: "退出后会话记录会清空，当前咨询进度将丢失，将不再发送未回复提醒。"
 ```
 #### 3.4.3 QueueCapsule.vue（v1.1 已规划，v1.2 沿用）
 沿用 v1.1 设计，此处略。详见 v1.1 技术方案。
 ### 3.5 顶部按钮可见性规则（v1.2 关键）
 | 场景 | `showHeaderExitBtn` | 说明 |
 |---|---|---|
 | 无会话 | `false` | 用户还没开始 |
 | AI 对话（active / urgent / disabled） | `true` | AI 场景专属可用 |
 | 坐席离线 | `true` | 仍属 AI 场景 |
 | 排队中（waiting） | `false` | 操作按钮 waiting 接管 |
 | 坐席服务中（serving） | `false` | 操作按钮 end 接管 |
 | 会话已关闭（reopen / disabled 过期） | `false` | 都不需要顶部按钮 |
 **store 计算逻辑**：见 §3.3。
 ### 3.6 引导语设计
 | 场景 | 引导语 | 颜色 |
 |---|---|---|
 | 无会话 | 💡 先描述一下你遇到的问题，AI 助手会先帮你看看 | 默认灰 |
 | AI <3 轮 | 请继续描述您的问题或需求 | 默认灰 |
 | 坐席离线 | ⚠️ 坐席当前离线，建议先用 AI 解答；如紧急可刷新重试 | 橙色（warn） |
 | 会话过期（>24h） | ⏰ 上一会话已过期，开始新对话吧 | 默认灰 |
 **实现细节**：仅 `disabled` 态显示，其他态不显示。详见 §3.4.1 改动 7。
 ### 3.7 重新打开按钮实现
 **API**：`api/closing.ts:119` 的 `reopenConversation` 已存在，v1.2 直接复用。
 **前端流程**：
 ```
 点击"🔄 重新打开"按钮
    ↓
 调用 store.reopenCurrentConversation()
    ↓
 POST /h5/conversations/current/reopen
    ↓
 后端创建新会话并关联原会话ID
    ↓
 前端更新 store.currentConversation
    ↓
 按钮态自动切回 active / waiting / serving
 ```
 **24h 边界判断**：
 - 前端：基于 `conv.resolved_at` 计算 elapsed，与 24h 比较
 - 后端：reopen API 做权威校验（防止客户端改时间绕过）
 - 双保险：即使前端误判，后端也会拒绝 24h 外的 reopen
 ### 3.8 双入口防抖/互斥（v1.2 关键）
 **场景互斥保证**（不需要 debounce）：
 - 顶部按钮 + end 态按钮由 `store.showHeaderExitBtn` 和 `callAgentState` 联合控制
 - 任何时候两者**最多一个可点击**
 - 不存在"同时存在两个结束入口"的 UI 状态
 **async handler 三件套**（防抖 + 同步 store + try/finally 重置）：
 - 顶部按钮 `handleExitWithEvaluation`：沿用 ChatPanel.vue:403 已有修复
 - 操作按钮 end 态：复用 `handleEndConversation` → `handleExitWithEvaluation`，共享防抖逻辑
 ```typescript
 // 双重错误信息（参见 memory 里 BUG-用户-003 修复）
 async function handleExitWithEvaluation(): Promise<void> {
  if (isExiting.value) return        // 防抖
  isExiting.value = true
  try {
    // ... close + 评价 + 关闭
  } catch (e: any) {
    // catch 兜底优先显示后端真实 message
    showToast(e?.message || '退出失败，请稍后重试')
  } finally {
    isExiting.value = false         // try/finally 重置
  }
 }
 ```
 ---
 ## 四、API 需求
 ### 4.1 现有 API（已存在）
 | API | 说明 |
 |-----|------|
 | `POST /h5/conversations/current/close` | 员工主动关闭会话 |
 | `POST /api/conversations/{id}/evaluation` | 提交满意度评价 |
 | `POST /h5/conversations/current/reopen` | 24h 内重开（v1.2 复用）|
 ### 4.2 需新增/确认
 | API | 说明 |
 |-----|------|
 | WebSocket 推送 | 排队状态变更通知（waiting → serving → resolved）|
 | `conv.resolved_at` 字段 | 后端返回会话关闭时间，前端计算 24h 边界 |
 ---
 ## 五、非技术变更
 ### 5.1 前端样式新增
 ```scss
 // InputBar 新增样式（见 §3.4.1 改动 8）
 .call-agent-btn--end { ... }
 .call-agent-btn--reopen { ... }
 // ChatPanel 顶部按钮 v-show + tooltip（见 §3.4.2 改动 1）
 ```
 ### 5.2 文案修订
 | 位置 | v1.1 | v1.2 |
 |---|---|---|
 | 顶部按钮 tooltip | "结束会话" | "结束会话（不再发送提醒）" |
 | 退出确认弹窗 | "退出后会话记录会清空..." | "...将不再发送未回复提醒。" |
 ---
 ## 六、风险与依赖
 | 风险 | 影响 | 缓解措施 |
 |------|------|---------|
 | R1：双入口虽然场景互斥，但文案相似 | 用户可能误操作 | 顶部按钮 tooltip 强调"不再发送提醒"，end 按钮文案"结束咨询"明确"挂断" |
 | R2：`showHeaderExitBtn` 计算错误 | 顶部按钮在错误场景显示 | 单元测试覆盖所有 9 种场景 |
 | R3：24h 边界依赖客户端时钟 | 改时间绕过 | 后端 reopen API 权威校验 |
 | R4：end 态 + 顶部按钮同时误触发 | 重复 close 请求 | `isExiting` 防抖 + store 同步（沿用 BUG-用户-003 修复） |
 | R5：引导语渲染与按钮态不同步 | UI 状态不一致 | 引导语渲染条件与 `callAgentState` 共享同一 computed |
 **依赖**：
 - D1：WebSocket `queue_position_update` 事件已实现
 - D2：`store.agentOnline` 字段已存在
 - D3：EvaluationDialog 组件已实现
 - D4：reopenConversation API 已在 `closing.ts:119` 实现
 - D5：`conv.resolved_at` 字段后端返回（需确认）
 ---
 ## 七、验收标准
 | # | 验收条件 |
 |---|---------|
 | AC1 | 6 态按钮正确切换（disabled/active/urgent/waiting/end/reopen） |
 | AC2 | 4 种引导语按场景正确显示 |
 | AC3 | 顶部按钮仅 AI 场景显示（waiting/serving 时隐藏） |
 | AC4 | 操作按钮 end 态仅 serving 时显示，点击触发评价弹窗 |
 | AC5 | 「重新打开」按钮在 24h 内可见，点击调用 reopen API |
 | AC6 | 引导语与按钮态同步，无错位 |
 | AC7 | 双入口场景互斥（任何时候只有一个结束入口可用） |
 | AC8 | 评价提交后窗口自动关闭 |
 | AC9 | 重新进入应用显示全新/重开会话 |
 ---
 ## 八、实施计划
 | 阶段 | 任务 | 工时 |
 |------|------|------|
 | 1 | store 新增 showHeaderExitBtn + canReopen + reopenCurrentConversation | 1h |
 | 2 | InputBar.vue 6 态扩展 + 引导语 + end/reopen 样式 | 2h |
 | 3 | ChatPanel.vue 顶部按钮 v-show + 文案修订 + end-conversation 处理 | 1h |
 | 4 | 单元测试（状态机 + showHeaderExitBtn + canReopen） | 2h |
 | 5 | 联调测试 + 视觉回归 | 2h |
 | 6 | 部署 + 灰度 | 1h |
 | **合计** | | **9h** |
 ---
 ## 九、变更记录（v1.1 → v1.2 → v1.3 → v1.4）
 | 变更项 | v1.1 技术方案 | v1.2 技术方案 | v1.3 技术方案（已拍板 ✅） | v1.4 技术方案（已拍板 ✅） |
 |--------|---------------|---------------|---------|---------|
 | 状态机 | 5 态（含 hidden） | **6 态（移除 hidden / 恢复 end / 新增 reopen）** | 沿用 6 态（位置从 InputBar 移至整合区） | 沿用 6 态 |
 | 引导语 | 无 | **新增 4 种引导语计算逻辑**（InputBar 按钮下方） | **迁移到整合区按钮下方** | 沿用 |
 | store 新字段 | 无 | **`showHeaderExitBtn` + `canReopen` + `reopenCurrentConversation`** | 沿用 + 新增 `shiftHours`（v1.4 接后端） | `shiftHours` 取消（状态条删除） |
 | 顶部按钮 | 始终显示 | **`v-show="store.showHeaderExitBtn"` 仅 AI 场景显示** | 沿用 | 沿用 |
 | 顶部按钮文案 | 无 tooltip | **加 tooltip「结束会话（不再发送提醒）」** | 沿用 | 沿用 |
 | 退出确认弹窗 | "退出后会话记录会清空..." | **"...将不再发送未回复提醒。"** | 沿用 | 沿用 |
 | 操作按钮 end 态 | 已移除 | **恢复（红色填充）** | 沿用（位置迁移） | 沿用 |
 | 重新打开按钮 | 无 | **新增（蓝色填充）** | 沿用（位置迁移） | 沿用 |
 | 24h 边界 | 无 | **前端基于 `resolved_at` 计算 + 后端权威校验** | 沿用 | 沿用 |
 | 双入口防抖 | 无显式防抖 | **`isExiting` 共享 + 场景互斥（无需 debounce）** | 沿用 | 沿用 |
 | 🆕 **整合区（方案 A）** | 无 | 无 | **新增 IntegrationZone.vue 容器**：状态条 + 操作按钮 + 进度胶囊 + 引导语 纵向堆叠 | **降为三元素：操作按钮 + 进度胶囊 + 引导语（状态条删除）** |
 | 🆕 **状态条策略** | 无 | 无 | **永久显示**（沿用 v1.2 `.header-mock__status--online/offline`） | **✅ 删除（v1.3.5 决策，v1.4 完整落地）** |
 | 🆕 **状态条文案** | 无 | 无 | **"在线 · 9:00-18:00"**（前端硬编码 `SHIFT_HOURS`） | **随状态条一并删除** |
 | 🆕 **整合区背景色** | 无 | 无 | **`#fafafa` 浅灰**（沿用 chat-mock，inline 样式） | 沿用 |
 | 🆕 **InputBar 工具栏** | 含操作按钮 | 含操作按钮 | **移除操作按钮**（更简洁：😊📎[输入框][发送]） | 沿用 |
 | 🆕 **标题栏坐席徽章** | 🟢/⚫ | 🟢/⚫ | **移除**（迁移至整合区顶部状态条） | **v1.4 随状态条一并移除** |
 | 🆕 **QueueCapsule** | 消息流底部独立 | 消息流底部独立 | **集成到 IntegrationZone 内部** | 沿用 |
 | 🆕 **移动端** | — | — | **不折叠，默认展开**（移动端与桌面端一致） | 沿用 |
 ---
 ## 十、v1.3 / v1.4 整合区实施要点（已拍板 ✅）
 > **拍板日期**：2026-07-31 下午（v1.3 五项）；2026-08-03（v1.4 反转删除状态条）
 > **关联 PRD**：§十一 v1.3 / v1.4 整合区增量
 > **关联原型**：§⑨ 方案 A 整合区设计（v1.3 已拍板；v1.4 移除状态条 mockup）
 >
 > **v1.4 反转**：v1.3 拍板「状态条永久显示」，v1.4（2026-08-03）依 v1.3.5 决策删除状态条，整合区降为「操作按钮 + 进度胶囊 + 引导语」三元素；`src/utils/shiftHours.ts` 随状态条一并移除。
 ### A. 组件拆分
 v1.3 把 v1.2 中分散在 4 个位置（标题栏 / InputBar / 消息流底部 / 顶部按钮）的元素，整合到一个新建的容器组件 `IntegrationZone.vue`；**v1.4 删除状态条**，整合区降为三元素：
 | 组件 | v1.2 角色 | v1.3 角色 | v1.4 角色 | 变更 |
 |------|----------|----------|----------|------|
 | `IntegrationZone.vue` 🆕 | — | 整合区容器（状态条 + 按钮 + 胶囊 + 引导语） | 整合区容器（按钮 + 胶囊 + 引导语 三元素） | **新建 → v1.4 移除状态条** |
 | `QueueCapsule.vue` | 消息流底部独立显示 | 集成到 IntegrationZone 内部 | 集成到 IntegrationZone 内部 | 位置迁移 |
 | `InputBar.vue` | 含操作按钮 + 引导语 | 移除操作按钮 + 移除引导语容器 | 沿用 v1.3 | 瘦身 |
 | `ChatPanel.vue` | 标题栏坐席徽章 + 顶部退出 | 移除坐席徽章 + 集成 IntegrationZone | 沿用 v1.3（状态条于 v1.4 随整合区清理移除） | 瘦身 + 集成 |
 ### B. 文件清单（新增 / 修改）
 | 操作 | 文件 | 说明 |
 |------|------|------|
 | 🆕 新建 | `src/components/IntegrationZone.vue` | 整合区容器（操作按钮 + 进度胶囊 + 引导语 3 元素纵向堆叠；v1.4 移除状态条） |
 | 🆕 新建 | `src/stores/integrationZone.ts` | 整合区状态管理 |
 | ✏️ 修改 | `src/components/InputBar.vue` | 移除操作按钮 + 移除引导语容器，工具栏更简洁（😊📎[输入框][发送]） |
 | ✏️ 修改 | `src/components/ChatPanel.vue` | 移除标题栏坐席徽章（`.header-mock__status--online/offline` 元素移除）+ 集成 `<IntegrationZone>` 组件 |
 | ✏️ 修改 | `src/components/QueueCapsule.vue` | 不再独立显示，集成到 IntegrationZone 内部，作为整合区下部"按需胶囊" |
 > **v1.4 移除**：`src/utils/shiftHours.ts`（状态条文案常量）随状态条一并删除；`IntegrationZoneProps.shiftHours` 字段保留为后端班次预留（当前无渲染），`agentOnline` 仍供 QueueCapsule 降级判定消费。
 ### C. 共享知识（跨文件约定）
 #### C.1 整合区常量（v1.4 已移除）
 > v1.3 曾新建 `src/utils/shiftHours.ts` 硬编码 `SHIFT_HOURS = '9:00-18:00'`；**v1.4 随状态条删除一并移除**。`IntegrationZoneProps.shiftHours` 字段保留为后端班次预留（见 §D.1）。
 #### C.2 状态条三态文案格式（v1.4 已移除）
 > **v1.4 删除**：以下格式随状态条一并移除，不再渲染坐席在线/离线状态。保留以作历史参考。
 ```
 {icon} {statusText} · {shiftHours}
 ```
 示例：
 - 🟢 在线 · 9:00-18:00
 - 🟡 繁忙 · 预计 N 分钟
 - ⚫ 客服暂休 · 9:00-18:00
 #### C.3 整合区背景色
 ```
 background: #fafafa  /* 浅灰，沿用 chat-mock，inline 样式 */
 ```
 **不新增 CSS 类**（沿用 v1.2 全部 72 个 class，约束与原型图保持一致）。
 #### C.4 不动 v1.2y 已 PASS 内容（关键约束）
 | # | 不动内容 | 文件 / 位置 |
 |---|---------|------------|
 | 1 | 4 种引导语文案与按钮态对应关系 | `inputBarGuideText.ts` |
 | 2 | 操作按钮 6 态状态机（end > reopen > waiting > active/urgent > disabled） | `inputBarCallAgentState.ts` |
 | 3 | "会话已关闭"消息文本（含 emoji 兼容） | `conversation.ts:1911-1925 getResolveMessageText` |
 | 4 | reopen API 调用与 24h 边界 | `closing.ts:119 reopenConversation` |
 v1.3 增量 = **整合区结构 + 5 元素位置迁移**，**不修改**上述 4 处已 PASS 内容。
 ### D. 数据结构
 #### D.1 IntegrationZone Props 接口
 ```typescript
 interface IntegrationZoneProps {
  agentOnline: boolean                              // 供 QueueCapsule 降级判定消费（v1.4 状态条删除后仅此用途）
  shiftHours: string                                // 后端班次预留字段（v1.4 状态条删除后当前无渲染）
  callAgentState: CallAgentState                    // 6 态按钮（disabled/active/urgent/waiting/end/reopen）
  queueCapsuleState: QueueCapsuleState              // 4 态胶囊（hidden/queued/serving/resolved）
  guideText: string | null                          // 4 种场景引导语（null 表示无引导语）
 }
 ```
 #### D.2 IntegrationZone Emits 接口
 ```typescript
 interface IntegrationZoneEmits {
  (e: 'call-agent'): void                           // 呼叫坐席（active / urgent 态）
  (e: 'cancel-queue'): void                         // 取消排队（waiting 态）
  (e: 'end-conversation'): void                     // 结束人工（end 态，复用 handleExitWithEvaluation）
  (e: 'reopen-conversation'): void                   // 重新打开（reopen 态，调用 reopenCurrentConversation）
 }
 ```
 #### D.3 shiftHours 工具常量（v1.4 已移除）
 > v1.3 的 `SHIFT_HOURS` 常量与 `store.shiftHours` 演进路径**随状态条删除一并取消**（v1.4 不再向员工暴露坐席在线/离线）。原计划：
 ```typescript
 // v1.3（曾计划）：纯常量 —— 已随 v1.4 状态条删除移除
 // export const SHIFT_HOURS = '9:00-18:00'
 // v1.4（曾计划）：从 store 注入 —— 已取消
 // const shiftHours = computed(() => store.shiftHours ?? '9:00-18:00')
 ```
 ### E. 任务列表（有序）
 | # | 任务 | 依赖 | 预计 |
 |---|------|------|------|
 | 1 | ~~新建 `shiftHours.ts` 工具常量~~（v1.4 随状态条删除，已取消） | — | 0d |
 | 2 | 新建 `IntegrationZone.vue` 容器组件 | — | 0.5d |
 | 3 | 新建 `integrationZone.ts` 状态 store | — | 0.3d |
 | 4 | 改造 `InputBar.vue` 移除操作按钮 + 移除引导语 | 1 | 0.3d |
 | 5 | 改造 `ChatPanel.vue` 移除坐席徽章 + 集成 IntegrationZone | 2, 3 | 0.5d |
 | 6 | 改造 `QueueCapsule.vue` 集成到 IntegrationZone | 2 | 0.3d |
 | 7 | vitest 单测（整合区组件 + store） | 2, 3, 6 | 0.5d |
 | 8 | 联调测试 + 视觉回归 | 4, 5, 6, 7 | 0.5d |
 | **合计** | | | **3.0d** |
 ### F. 待明确事项
 | # | 待明确 | 影响 | 解决路径 |
 |---|--------|------|----------|
 | 1 | 后端班次字段名 | v1.4 状态条已删除，班次字段暂不需要 | 若未来恢复坐席状态展示再评估 |
 | 2 | 后端班次接口路径 | 决定前端调用方式 | 取消（状态条删除后无渲染目标） |
 | 3 | 班次数据缓存策略 | 性能 + 实时性 | 取消 |
 > v1.4 已删除状态条与 `store.shiftHours` 计划，整合区降为「操作按钮 + 进度胶囊 + 引导语」三元素。
 ---
 ## 十一、拍板记录
 | 日期 | 决策 | 决策人 | 影响范围 |
 |------|------|--------|----------|
 | 2026-07-31 下午 | 状态条永久显示 | 用户拍板 | §A 状态条策略（v1.4 已反转） |
 | 2026-07-31 下午 | 状态条文案"在线 · 9:00-18:00" | 用户拍板 | §C.1 + §C.2 + §D.3（v1.4 已移除） |
 | 2026-07-31 下午 | 整合区背景色 `#fafafa` 浅灰 | 用户拍板 | §C.3 |
 | 2026-07-31 下午 | 引导语放整合区按钮下方 | 用户拍板 | §A 引导语位置 |
 | 2026-07-31 下午 | 移动端不折叠，默认展开 | 用户拍板 | §B ChatPanel.vue 移动端逻辑 |
 | **2026-08-03** | **反转：删除整合区状态条（v1.3.5 决策，v1.4 完整落地）；整合区降为三元素；`shiftHours.ts` 一并移除** | 用户拍板 | §A / §B / §C.1 / §D.1 / §D.3 / 原型图 §⑨ |
 > **三件套落地**：PRD v1.4 §十一 + 技术方案 v1.4 §十（本文档）+ 原型图 v1.4 同步发布；状态条删除后 `store.shiftHours` 后端班次接入计划相应取消。
@@ -4,10 +4,10 @@
 > **日期**: 2026-07-27
 > **需求编号**: REQ-会话-001
 > **测试类型**: 单元测试 + 生产构建验证（端到端代码层）
-> **关联 PRD**: `01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.3.md`
+> **关联 PRD**: `01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.4.md`
-> **关联技术方案**: `02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.3.md`
+> **关联技术方案**: `02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.4.md`
-> **关联任务说明书**: `07-项目管理/任务说明书/任务说明书-REQ-会话-001-员工结束会话v1.3.md`
+> **关联任务说明书**: `07-项目管理/任务说明书/任务说明书-REQ-会话-001-员工结束会话v1.4.md`
-> **测试结论**: ✅ 通过（单测 75/75 + 生产构建成功）；⚠️ 发现 1 项 PRD↔代码分歧待产品拍板
+> **测试结论**: ✅ 通过（单测 75/75 + 生产构建成功）；🔶 分歧 1（状态条）已于 v1.4（2026-08-03）产品拍板闭环（删除状态条）
 ---
@@ -100,7 +100,7 @@ dist/assets/index-Dc6ilDe1.js   370.72 kB │ gzip: 135.16 kB
 ## 六、发现的缺陷 / 分歧
-### 🔶 分歧 1：PRD v1.3 ↔ 代码 v1.3.5 状态条（Status Bar）不一致
+### ✅ 分歧 1（已闭环）：PRD v1.3 ↔ 代码 v1.3.5 状态条（Status Bar）不一致
 | 视角 | 描述 |
 |------|------|
@@ -108,8 +108,12 @@ dist/assets/index-Dc6ilDe1.js   370.72 kB │ gzip: 135.16 kB
 | **代码 v1.3.5 注释** | `integrationZoneLogic.ts:16`「~~复用 utils/shiftHours.ts 状态条文案生成~~（v1.3.5 整体删除）」、`:37`「v1.3.5 状态条已删除」；`inputBarGuideText.ts:63`「用户拍板删除状态条 + 离线描述」|
 | **代码内部不一致** | `IntegrationZone.vue` 仍渲染状态条，但 `integrationZoneLogic.ts` 注释称已删除 → 半完成清理 |
-**影响**：产品现状与文档描述偏差；若 v1.3.5 清理为终态，PRD/技术方案 v1.3 的「状态条永久显示」需回退为「v1.3.5 已移除」并补 TR；若状态条保留，则应清理 v1.3.5 注释。
+**拍板结果（2026-08-03）**：以 v1.3.5 代码为准 —— **删除整合区状态条**（不向员工暴露坐席在线/离线）。该决策已在 v1.4 三件套（PRD / 技术方案 / 原型）完整落地：
-**处置**：⏸️ 待产品（宋献）拍板后闭环，本次 QA 不擅自改文档。
+- PRD §3.4 / §11.4 决策 1 由「✅ 永久显示」反转为「❌ v1.4 删除」；整合区由 4 元素降为 3 元素（操作按钮 + 进度胶囊 + 引导语）。
 - 技术方案 §D.3 状态条文案生成函数标记（v1.4 已移除），`src/utils/shiftHours.ts` 取消新增；`IntegrationZoneProps.shiftHours` 预留为后端班次字段（当前无渲染）。
 - 原型 9 个状态条 mockup 全部移除，9.6 表新增第 6 行「状态条反转（v1.4）」。
 **处置**：✅ 已闭环。文档与线上行为恢复一致；TR 本报告结论由「⚠️ 待拍板」升级为「✅ 已闭环」。
 ### 🔶 分歧 2（历史遗留，不在本次范围）
@@ -133,9 +137,16 @@ dist/assets/index-Dc6ilDe1.js   370.72 kB │ gzip: 135.16 kB
 1. ✅ **v1.3.1 / v1.3.2 功能正确性**经 75 条单测 + 生产构建双重验证通过。
 2. ✅ 整合区（IntegrationZone）已正确收纳操作按钮，InputBar 工具栏瘦身符合设计。
-3. ⚠️ **状态条分歧**（分歧 1）为本次唯一遗留项，需产品拍板后补文档/TR，否则 PRD 与线上行为将持续不一致。
+3. ✅ **状态条分歧**（原分歧 1）已于 v1.4（2026-08-03）产品拍板闭环：删除整合区状态条，整合区降为三元素，文档与线上行为恢复一致。
 4. 🟡 服务端部署验证建议纳入发布 checklist，部署后补一次线上冒烟。
 ---
-*报告结束 — Duckula / 2026-07-27*
+### 附录 A · v1.4（2026-08-03）状态条删除闭环记录
 - **拍板**：以 v1.3.5 代码为准，删除整合区状态条（不向员工暴露坐席在线/离线）。
 - **文档落地**：PRD v1.4 / 技术方案 v1.4 / 原型 v1.4 三件套同步反转，整合区由 4 元素降为 3 元素。
 - **代码落地**：`IntegrationZone.vue` 状态条渲染移除，`src/utils/shiftHours.ts` 取消新增；v1.4 生产构建成功（任务 `Y8WEtB`，528 模块，built in 3.27s）。
 - **关联 TR 状态**：本报告分歧 1 由「⏸️ 待拍板」升级为「✅ 已闭环」。
 *报告结束 — Duckula / 2026-08-03（v1.4 闭环更新）*
@@ -247,6 +247,7 @@
 | 2026-07-28 | v1.3 | 新增整改 #4：移除快速回复规则页面顶部 3 张重复统计卡片，并登记代码事实与回归方式 | Simon / 宋献 | 页面信息冗余 | REQ-通用-002 文档链及管理后台 `/quick-rules` 页面 |
 | 2026-07-30 | v1.4 | 新增整改 #7：REQ-会话-001 v1.2 三件套位置/任务说明书补齐/历史归档 | Duckula (AI) | 大需求重构跨阶段实施，PRD v1.2 阶段必须三件套对齐 + 任务说明书 + 历史归档 | REQ-会话-001 文档链（PRD v1.2 + 原型 v1.2 + 技术方案 v1.2） |
 | 2026-07-31 | v1.6 | 新增整改 #8：REQ-会话-001 v1.3 整合区方案 A 三件套增量 + 5 项决策落地 | Duckula (AI) | 方案 A 多文档同步必须显式列出"已拍板结论表"，把决策结论固化而非问题陈述；5 项决策落地需贯穿 PRD/技术方案/任务说明书/原型图 4 份文档 | REQ-会话-001 v1.3 文档链（PRD v1.3 §十一 + 技术方案 v1.3 §十 + 任务说明书 v1.3 M8-M14 + 原型图 v1.3 §⑨） |
 | 2026-08-03 | v1.7 | 新增整改 #10：REQ-会话-001 v1.4 状态条删除闭环（整改 #9 遗留待办 #1 终态） | Duckula (AI) | 闭环 PRD v1.3 ↔ 代码 v1.3.5 状态条分歧：以 v1.3.5 代码为准删除整合区状态条，三件套升 v1.4 + 原型 v1.4 + TR 分歧升级为已闭环 + 任务说明书对齐 | REQ-会话-001 v1.4 文档链（PRD v1.4 + 技术方案 v1.4 + 原型 v1.4 + 任务说明书 v1.4 + TR-会话-001 v1.3.2 附录 A） |
 ---
@@ -268,3 +269,22 @@
 | 遗留待办 | 1) **PRD v1.3 ↔ 代码 v1.3.5 状态条分歧**：PRD/技术方案 v1.3 描述整合区"状态条永久显示"，但代码 `integrationZoneLogic.ts` 注释称 v1.3.5 已删除状态条、`inputBarGuideText.ts` 场景3 引导语亦于 v1.3.5 移除；需产品确认是否回退 PRD 或补全 v1.3.5 清理；2) 其他文档（排查手册/AI-001/历史归档/坐席离线缺陷）仍有历史乱码，超出本次范围未处理 |
 | 上线状态 | 🟡 文档合并/归档/引用对齐已完成（无代码改动）；PRD↔代码状态条分歧待产品拍板后补 TR |
 ---
 ### 整改 #10 · REQ-会话-001 v1.4 状态条删除闭环（分歧 1 终态）
 | 项目 | 值 |
 |------|------|
 | 日期 | 2026-08-03 |
 | 触发人 | 宋献 / Duckula |
 | 源需求 | REQ-会话-001（员工结束会话）：闭环整改 #9 遗留待办 #1「PRD v1.3 ↔ 代码 v1.3.5 状态条分歧」|
 | 拍板结论 | **以 v1.3.5 代码为准：删除整合区状态条**（不向员工暴露坐席在线/离线）。整合区由 4 元素降为 3 元素（操作按钮 + 进度胶囊 + 引导语）。|
 | 整改维度 | A 命名/位置 + B 关联引用 + D 完整度 |
 | 关键修复 | **1) PRD v1.4**：新建 `PRD-REQ-会话-001-员工结束会话-v1.4.md`，复制 v1.3 全文，§九 变更记录扩展为 v1.1→v1.2→v1.3→v1.4；§3.4 / §11.4 决策 1 由「✅ 永久显示」反转为「❌ v1.4 删除」；§11.2 整合区三元素堆叠；§11.3 九场景表移除状态条列；§11.5 对比表新增 v1.4 列；§十二 拍板记录新增 2026-08-03 反转行。<br>**2) 技术方案 v1.4**：新建 `技术方案-REQ-会话-001-员工结束会话-v1.4.md`，复制 v1.3 全文，§九 变更记录扩展四列；§十 v1.3/v1.4 实施要点新增 v1.4 反转提示；§D.3 状态条文案生成函数标记（v1.4 已移除）；§B 文件清单移除 `src/utils/shiftHours.ts`；§E 任务列表划除 shiftHours 任务；§F 待明确事项标记取消。<br>**3) 原型 v1.4**：覆盖更新 `原型-REQ-会话-001-结束会话流程-v1.4.html`，移除 9 个状态条 mockup（8 在线 + 1 离线），9.6 表由 5 项结论扩为 6 项（新增第 6 行「状态条反转 v1.4」），标题/拍板记录/引导语多处补「v1.4 删除状态条」标注。<br>**4) TR 报告**：`TR-会话-001-结束会话-v1.3.2.md` 分歧 1 由「🔶 待拍板」升级为「✅ 已闭环」，关联文档引用 v1.3→v1.4，附录 A 新增 v1.4 闭环记录。<br>**5) 任务说明书对齐**：`任务说明书-REQ-会话-001-员工结束会话v1.3.md` 关联 PRD/技术方案/原型引用升级为 v1.4。|
 | 代码落地 | `IntegrationZone.vue` 状态条渲染移除；`src/utils/shiftHours.ts` 取消新增（技术方案 §B 已移出文件清单）；`IntegrationZoneProps.shiftHours` 保留为后端班次预留字段（当前无渲染）。v1.4 生产构建成功（任务 `Y8WEtB`：528 模块，built in 3.27s）。|
 | 引用同步 | 整改 #9 遗留待办 #1 正式闭环；本报告 §五 变更记录新增 v1.7 行登记 #10。|
 | 遗留待办 | 1) 整改 #9 遗留待办 #2（其他文档历史乱码）仍未处理，超出本次范围；2) `store.shiftHours` 后端班次字段何时落地待后续需求明确（v1.4 仅预留，不渲染）。|
 | 收益 | 1) 整改 #9 遗留数月的 PRD↔代码状态条分歧彻底闭环，文档与线上行为恢复一致；2) v1.4 三件套以"反转结论"形式固化决策，避免后续执行方混淆 v1.3「永久显示」与 v1.3.5 代码「已删除」；3) TR 报告分歧状态机从待拍板→已闭环，QA 证据链完整。|
 | 教训 | **分歧类遗留项必须显式闭环并升级 QA 报告状态**：整改 #9 仅标记「待产品拍板」，若不在 v1.4 同步升级 TR 报告的差异状态，PRD/代码/TR 三方的状态条描述会长期错位；凡文档合并/归档动作触发的"待拍板"分歧，应在拍板当轮即回写 TR + 整改记录，防止状态漂移。|
 | 上线状态 | ✅ 已完成（文档三件套 v1.4 + 原型 v1.4 + TR 升级 + 任务说明书对齐；代码 v1.3.5 清理已落地，v1.4 构建通过）|
@@ -1,10 +1,10 @@
-# 任务说明书 - 员工结束会话 v1.3（整合区方案 A：状态条 + 操作按钮 + 进度胶囊三件套）
+# 任务说明书 - 员工结束会话 v1.4（整合区方案 A：操作按钮 + 进度胶囊 + 引导语三元素，状态条已删除）
-> **版本**: v1.0 | **日期**: 2026-07-31
+> **版本**: v1.4 | **日期**: 2026-08-03
-> **关联需求**: REQ-会话-001 v1.3
+> **关联需求**: REQ-会话-001 v1.4
-> **关联 PRD**: PRD-REQ-会话-001-员工结束会话-v1.3 §十一
+> **关联 PRD**: PRD-REQ-会话-001-员工结束会话-v1.4 §十一
-> **关联技术方案**: 技术方案-REQ-会话-001-员工结束会话-v1.3 §十
+> **关联技术方案**: 技术方案-REQ-会话-001-员工结束会话-v1.4 §十
-> **状态**: 待开始（M8-M14）
+> **状态**: 待开始（M8-M14，其中 M8 shiftHours 已随 v1.4 状态条删除取消）
 ---
@@ -12,11 +12,11 @@
 | 项目 | 内容 |
 |------|------|
-| **任务名称** | 员工结束会话 v1.3 改造（整合区方案 A：状态条 + 操作按钮 + 进度胶囊三件套） |
+| **任务名称** | 员工结束会话 v1.4 改造（整合区方案 A：操作按钮 + 进度胶囊 + 引导语三元素，状态条 v1.4 删除） |
-| **任务ID** | REQ-会话-001-v1.3 |
+| **任务ID** | REQ-会话-001-v1.4 |
 | **优先级** | 🟠P1 |
 | **类型** | 功能开发 |
-| **状态** | 待开始（M8-M14 未开始；M1-M7 已完成，见 v1.2 任务说明书） |
+| **状态** | 待开始（M8-M14 未开始；M1-M7 已完成，见 v1.2 任务说明书；M8 shiftHours 因 v1.4 删除状态条已取消） |
 | **负责人** | 宋献 |
 | **创建日期** | 2026-07-31 |
 | **计划完成日期** | 2026-08-06（M8-M14 共 2.5 天开发+测试工时） |
@@ -31,21 +31,21 @@
 | 来源文档 | 相关章节 | 说明 |
 |----------|----------|------|
-| `docs/01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.3.md` | **§十一 v1.3 整合区增量**（方案 A 已拍板） | 4 维度分散 → 2 段式（整合区+顶部退出）+ 5 决策落地清单 |
+| `docs/01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.4.md` | **§十一 v1.3/v1.4 整合区增量**（方案 A 已拍板；v1.4 反转删除状态条） | 4 维度分散 → 2 段式（整合区+顶部退出）+ 5 决策落地清单；v1.4 整合区降为三元素 |
 | `docs/01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.2.archive.md` | §3.2 §3.5 §3.7 §3.8 | v1.2 设计哲学 + 6 态按钮 + 4 种引导语 + 顶部按钮 AI 场景互斥规则（v1.3 沿用） |
 ### 技术方案
 | 来源文档 | 相关章节 | 说明 |
 |----------|----------|------|
-| `docs/02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.3.md` | **§十 v1.3 整合区实施要点**（A-F 6 子节） | 组件拆分 + 文件清单 + 共享知识 + 数据结构 + 任务列表 + 待明确事项 |
+| `docs/02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.4.md` | **§十 v1.3/v1.4 整合区实施要点**（A-F 6 子节；v1.4 反转删除状态条） | 组件拆分 + 文件清单（v1.4 移除 shiftHours.ts）+ 共享知识 + 数据结构 + 任务列表 + 待明确事项 |
 | `docs/02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.2.archive.md` | §3.3 §3.4 §3.7 §3.8 | store 新字段 + InputBar/ChatPanel 改动 + 24h 边界 + 双入口防抖（v1.3 沿用） |
 ### 原型设计
 | 来源文档 | 页面 | 说明 |
 |----------|------|------|
-| `docs/01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.3.html` | **§⑨ 方案 A 整合区设计（v1.3 已拍板）** | 9 场景 mockup + 5 决策落地 + R1-R5 关键交互细节 |
+| `docs/01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.4.html` | **§⑨ 方案 A 整合区设计（v1.3 已拍板 · v1.4 删除状态条）** | 9 场景 mockup + 6 决策落地（含 v1.4 状态条反转）+ R1-R5 关键交互细节 |
 | `docs/01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.2.archive.html` | §② §③ §④ | 6 态按钮 + 4 种引导语 + 顶部按钮可见性 mockup（v1.3 沿用） |
 ### 需了解的现有代码（v1.2 实施时必读）
@@ -139,10 +139,10 @@
 - [x] M6：联调测试 + 视觉回归通过
 - [x] M7：上线后监控无异常（按钮点击转化率与历史持平，无 1001 错误）
-#### v1.3 待开始（2026-07-31 拍板）
+#### v1.3/v1.4 待开始（2026-07-31 拍板 · 2026-08-03 v1.4 反转删除状态条）
- [ ] M8：新建 `shiftHours.ts` 工具常量（`SHIFT_HOURS = '9:00-18:00'`）
+- [ ] M8：~~新建 `shiftHours.ts` 工具常量~~ **（v1.4 取消：状态条已删除，不再需要班次硬编码常量；`store.shiftHours` 预留后端班次字段，当前无渲染）**
- [ ] M9：新建 `IntegrationZone.vue` 容器组件（5 元素纵向堆叠）
+- [ ] M9：新建 `IntegrationZone.vue` 容器组件（v1.3 规划 5 元素 → **v1.4 降为三元素**：操作按钮 + 进度胶囊 + 引导语，状态条移除）
 - [ ] M10：新建 `integrationZone.ts` 状态 store
 - [ ] M11：改造 `InputBar.vue` 移除操作按钮 + 移除引导语容器
 - [ ] M12：改造 `ChatPanel.vue` 移除坐席徽章 + 集成 IntegrationZone
@@ -159,13 +159,13 @@
 - [x] 部署验证通过
 - [x] 文档更新已完成（任务说明书 v1.2 + 整改记录 #7）
-#### v1.3 待产出
+#### v1.3/v1.4 待产出
- [ ] 代码已提交并通过 Code Review（M8-M13）
+- [ ] 代码已提交并通过 Code Review（M9-M13；M8 因 v1.4 状态条删除取消）
- [ ] 单元测试新增/修复完成（覆盖整合区 9 场景 + store.shiftHours 单测）
+- [ ] 单元测试新增/修复完成（覆盖整合区 9 场景；v1.4 移除 store.shiftHours 单测）
 - [ ] 集成测试通过
 - [ ] 部署验证通过
- [ ] 文档更新已完成（本任务说明书 v1.3 + 整改记录 #8）
+- [ ] 文档更新已完成（本任务说明书 v1.4 + 整改记录 #10）
 ---
@@ -186,19 +186,19 @@
 | **M7** | 上线 | 0.5 天 | ✅ 已完成 |
 | | **小计** | **4.5 天** | |
-### v1.3 待开始阶段（2026-07-31 拍板，整合区方案 A 实施）
+### v1.3/v1.4 待开始阶段（2026-07-31 拍板 · 2026-08-03 v1.4 反转删除状态条）
 | 阶段 | 任务 | 预估工时 | 依赖 | 状态 |
 |------|------|----------|------|------|
-| **M8** | 新建 `shiftHours.ts` 工具常量（`SHIFT_HOURS = '9:00-18:00'`，v1.4 接 store.shiftHours） | 0.1d | — | ⏳ 待开始 |
+| **M8** | ~~新建 `shiftHours.ts` 工具常量~~ **（v1.4 取消：状态条删除，不再需要班次硬编码常量）** | 0d | — | ❌ 已取消 |
-| **M9** | 新建 `IntegrationZone.vue` 容器组件（5 元素纵向堆叠 + 浅灰背景 + 状态条三态文案） | 0.5d | — | ⏳ 待开始 |
+| **M9** | 新建 `IntegrationZone.vue` 容器组件（v1.4 三元素纵向堆叠 + 浅灰背景：**移除状态条三态文案**） | 0.5d | — | ⏳ 待开始 |
 | **M10** | 新建 `integrationZone.ts` 状态 store | 0.3d | — | ⏳ 待开始 |
-| **M11** | 改造 `InputBar.vue` 移除操作按钮 + 移除引导语容器（工具栏更简洁：😊📎[输入框][发送]） | 0.3d | M8 | ⏳ 待开始 |
+| **M11** | 改造 `InputBar.vue` 移除操作按钮 + 移除引导语容器（工具栏更简洁：😊📎[输入框][发送]） | 0.3d | — | ⏳ 待开始 |
 | **M12** | 改造 `ChatPanel.vue` 移除坐席徽章 + 集成 IntegrationZone | 0.5d | M9, M10 | ⏳ 待开始 |
 | **M13** | 改造 `QueueCapsule.vue` 集成到 IntegrationZone 内部 | 0.3d | M9 | ⏳ 待开始 |
 | **M14** | 联调测试 + 视觉回归 + 部署 prod（按钮态回归 9 场景 + 整合区 mockup 视觉对比） | 0.5d | M11, M12, M13 | ⏳ 待开始 |
-| | **小计** | **2.5d** | | |
+| | **小计** | **2.4d** | | |
-| | **v1.2 + v1.3 合计** | **7.0 天** | | |
+| | **v1.2 + v1.4 合计** | **6.9 天** | | |
 ---
@@ -227,16 +227,17 @@
 |------|----------|--------|------|
 | 2026-07-30 | 创建任务说明书 v1.0 | Duckula (AI) | 覆盖 PRD v1.2 + 技术方案 v1.2 的 7 阶段实施计划；按 product-doc-standard 规范要求补建任务说明书 |
 | 2026-07-31 | 创建任务说明书 v1.0（v1.3 整合区方案 A） | Duckula (AI) | 基于 v1.2 任务说明书扩展：保留 M1-M7 已完成阶段，新增 M8-M14 待开始阶段（整合区实施）；基线版本 v1.2 → v1.3；新增引用 PRD v1.3 §十一 + 技术方案 v1.3 §十 + 原型 v1.3 §⑨；预计完成日期 2026-08-06 |
 | 2026-08-03 | 升级任务说明书 v1.3 → v1.4 | Duckula (AI) | 闭环整改 #9 遗留分歧：以 v1.3.5 代码为准删除整合区状态条；引用 PRD/技术方案/原型升级为 v1.4；M8 shiftHours 标记取消、M9 降为三元素、M11 依赖改为无；小计 2.5d→2.4d；关联整改记录 #10 |
 ---
 ## 📎 附件
-### v1.3 主线文档
+### v1.4 主线文档
- **产品需求（v1.3）**：[PRD-REQ-会话-001-员工结束会话-v1.3.md](../../01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.3.md) **§十一 v1.3 整合区增量**
+- **产品需求（v1.4）**：[PRD-REQ-会话-001-员工结束会话-v1.4.md](../../01-产品文档/02-会话管理/PRD-REQ-会话-001-员工结束会话-v1.4.md) **§十一 v1.3/v1.4 整合区增量（v1.4 反转删除状态条）**
- **技术方案（v1.3）**：[技术方案-REQ-会话-001-员工结束会话-v1.3.md](../../02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.3.md) **§十 v1.3 整合区实施要点**
+- **技术方案（v1.4）**：[技术方案-REQ-会话-001-员工结束会话-v1.4.md](../../02-技术文档/技术方案-REQ-会话-001-员工结束会话-v1.4.md) **§十 v1.3/v1.4 整合区实施要点**
- **原型图（v1.3）**：[原型-REQ-会话-001-结束会话流程-v1.3.html](../../01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.3.html) **§⑨ 方案 A 整合区设计**
+- **原型图（v1.4）**：[原型-REQ-会话-001-结束会话流程-v1.4.html](../../01-产品文档/02-会话管理/原型-REQ-会话-001-结束会话流程-v1.4.html) **§⑨ 方案 A 整合区设计（v1.4 删除状态条）**
 ### v1.2 基线文档（已上线，M1-M7 已完成）
@@ -6,12 +6,13 @@
 //   2. 排查步骤（固定在消息区顶部，不随滚动消失）
 //   3. 消息列表（自动滚动到底部）
 //   4. 消息类型渲染：员工(右蓝) / 坐席(左白) / AI(左绿+AI标签) / 系统(居中灰)
-//   5. 🆕 v1.3：整合区（IntegrationZone）：进度胶囊 + 引导语（v1.3.5 移除状态条）
+//   5. 🆕 v1.3：整合区（IntegrationZone）：操作按钮 + 进度胶囊 + 引导语（v1.4 状态条已删除）
 //   6. 底部输入栏（仅工具栏 + 输入框 + 发送按钮，🆕 v1.3 已移除操作按钮）
 //
 // 🆕 v1.3 整合区方案 A（集成）：
 //   - QueueCapsule 从 ChatPanel 移除（集成到 IntegrationZone 内部）
-//   - 标题栏坐席徽章移除（状态条信息迁移到 IntegrationZone）
+//   - 标题栏坐席徽章移除；v1.3 曾迁移为整合区状态条，v1.4 拍板后状态条整体删除，
 //     即坐席在线/离线状态不再以任何形式向员工展示
 //   - 顶部退出按钮保留（仅 AI 场景，由 store.showHeaderExitBtn 控制）
 // ============================================================================= -->
@@ -105,7 +106,7 @@
    <!-- 🆕 v1.3：整合区（替换原 QueueCapsule + InputBar 中的操作按钮 + 引导语）
         位置：消息流结束 → 整合区 → InputBar
-         内含：状态条 / 操作按钮（6 态）/ QueueCapsule / 引导语（4 种场景）
+         内含：操作按钮（6 态）/ QueueCapsule / 引导语（4 种场景）— v1.4 状态条已删除
         所有事件向上冒泡到 ChatPanel，由本组件的现有 handlers 处理 -->
    <IntegrationZone
      :agent-online="store.agentOnline"
@@ -683,10 +684,10 @@ onMounted(() => {
 }
 /* 🆕 v1.3：标题栏瘦身，原坐席在线状态徽章（.chat-panel__status--*）
-   已迁移至 IntegrationZone 状态条。包含 .chat-panel__status、
+   包含 .chat-panel__status、.chat-panel__status--online/offline、
-   .chat-panel__status--online/offline、.chat-panel__status-dot、@keyframes pulse-dot
+   .chat-panel__status-dot、@keyframes pulse-dot 等全部样式已删除。
-   等全部样式已删除（连同 .chat-panel__status 选择器一并移除）。
+   v1.3 曾将其迁移为 IntegrationZone 状态条；v1.4 拍板后状态条亦整体删除，
-   视觉规范：状态信息统一由 IntegrationZone.render 展示。*/
+   坐席在线/离线状态不再向员工展示（agentOnline 仅供排队胶囊内部降级判定）。*/
 /* 标题栏右侧操作区 */
 .chat-panel__header-actions {
@@ -3,10 +3,16 @@
 // =============================================================================
 // 说明：把 v1.2 中分散在 4 个位置（标题栏 / InputBar / 消息流底部）的元素，
 //       整合到一个容器组件中：
-//         [1] 状态条 — 显示坐席在线状态 + 班次（来自 utils/shiftHours.ts）
+//         [1] 操作按钮 — 6 态（来自 inputBarCallAgentState.ts 复用）
-//         [2] 操作按钮 — 6 态（来自 inputBarCallAgentState.ts 复用）
+//         [2] 进度胶囊 — QueueCapsule（独立组件，集成在容器内）
-//         [3] 进度胶囊 — QueueCapsule（独立组件，集成在容器内）
+//         [3] 引导语 — 4 种场景文案（来自 inputBarGuideText.ts 复用）
-//         [4] 引导语 — 4 种场景文案（来自 inputBarGuideText.ts 复用）
+//
 // 🔻 v1.4 变更（2026-08-03 拍板）：删除状态条
 //   - v1.3 曾在整合区顶部永久显示「🟢 在线 · 9:00-18:00 / ⚫ 客服离线 · 9:00-18:00」
 //   - v1.3.5 产品反转决策：不向用户暴露坐席在线/离线信息，状态条整体移除
 //   - v1.3.5 当时仅落地了引导语侧的移除，本组件模板遗留未清理（三方不一致）
 //   - v1.4 补齐：模板 / statusBarText computed / status-bar 样式 / shiftHours 引用全部删除
 //   - utils/shiftHours.ts 与 stores/integrationZone.ts 保留（v1.4 后端班次能力预留，当前无消费者）
 //
 // 容器背景：浅灰 #fafafa（v1.3 拍板，沿用 chat-mock 配色）
 // 元素堆叠：flex-direction: column，纵向堆叠
@@ -23,12 +29,8 @@
 <template>
  <div class="integration-zone">
-    <!-- [1] 状态条：在线 · 9:00-18:00 / 离线 · 9:00-18:00 -->
+    <!-- [1] 操作按钮：6 态 + 永可见 (v1.3 保持 v1.2 行为：所有场景按钮都可见) -->
-    <div class="integration-zone__status-bar">
+    <!-- v1.4：原 [1] 状态条已删除，操作按钮成为整合区首个元素 -->
      {{ statusBarText }}
    </div>
    <!-- [2] 操作按钮：6 态 + 永可见 (v1.3 保持 v1.2 行为：所有场景按钮都可见) -->
    <button
      class="call-agent-btn"
      :class="btnClass"
@@ -40,7 +42,7 @@
      <span class="call-agent-btn__text">{{ btnText }}</span>
    </button>
-    <!-- [3] 进度胶囊：复用 QueueCapsule 完整逻辑（v1.2y 已 PASS，36 用例） -->
+    <!-- [2] 进度胶囊：复用 QueueCapsule 完整逻辑（v1.2y 已 PASS，36 用例） -->
    <!-- 🆕 v1.3：透传 agentOnline prop（IntegrationZone 由父组件接收后注入） -->
    <!-- 转发 cancel-queue / reopen-conversation 事件向上冒泡到 ChatPanel -->
    <QueueCapsule
@@ -49,7 +51,7 @@
      @reopen-conversation="$emit('reopenConversation')"
    />
-    <!-- [4] 引导语：仅 disabled 态显示（4 种场景，null 不渲染） -->
+    <!-- [3] 引导语：仅 disabled 态显示（4 种场景，null 不渲染） -->
    <div
      v-if="guideText"
      class="integration-zone__guide"
@@ -67,7 +69,7 @@
 * IntegrationZone 整合区容器组件
 *
 * 设计要点：
- *   1. 严格按 v1.3 方案 §A 组件拆分：4 元素纵向堆叠
+ *   1. 严格按 v1.4 方案 §A 组件拆分：3 元素纵向堆叠（v1.3 的 4 元素去掉状态条）
 *   2. 容器背景 #fafafa（v1.3 拍板）
 *   3. 复用 v1.2 已 PASS 的工具函数（inputBarCallAgentState.ts / inputBarGuideText.ts）
 *   4. 事件全部向上冒泡到 ChatPanel（单一职责：UI 渲染，不持有副作用）
@@ -77,7 +79,7 @@
 */
 import { computed } from 'vue'
 import QueueCapsule from './QueueCapsule.vue'
-import { buildStatusBarText, SHIFT_HOURS } from '@/utils/shiftHours'
+// v1.4：状态条删除后不再引用 utils/shiftHours（buildStatusBarText / SHIFT_HOURS）
 import {
  computeIntegrationBtnText,
  computeIntegrationBtnIcon,
@@ -110,17 +112,13 @@ const emit = defineEmits<{
 // ============================================================================
 /**
- * 状态条文案（来自 utils/shiftHours.ts）
+ * ⚠️ v1.4 已删除 statusBarText computed
- *   - 在线：`🟢 在线 · 9:00-18:00`
+ *   - 原实现：buildStatusBarText({ agentOnline, shiftHours }) → 「🟢 在线 · 9:00-18:00」
- *   - 离线：`⚫ 客服离线 · 9:00-18:00`
+ *   - 删除原因：产品拍板不向员工暴露坐席在线/离线状态（避免"没人在线"的负面预期）
- *   - shiftHours 默认 '9:00-18:00'（v1.4 接 store.shiftHours 后由父组件注入）
+ *   - props.shiftHours 与 props.agentOnline 仍保留：
 *       · agentOnline 供 QueueCapsule 排队态降级判定使用（仍在消费）
 *       · shiftHours 为 v1.4 后端班次接口预留（当前无消费者，勿误删 props 定义）
 */
 const statusBarText = computed<string>(() =>
  buildStatusBarText({
    agentOnline: props.agentOnline,
    shiftHours: props.shiftHours ?? SHIFT_HOURS,
  })
 )
 /**
 * 按钮文案（6 态，沿用 inputBarCallAgentState.computeCallAgentBtnText）
@@ -203,19 +201,10 @@ function handleClick(): void {
  flex-shrink: 0;
 }
-/* ==========================================================================
+/* v1.4：.integration-zone__status-bar 样式已随状态条一并删除 */
   [1] 状态条 — 班次信息小字
   ========================================================================== */
 .integration-zone__status-bar {
  font-size: 12px;
  color: var(--text-secondary, #6b7280);
  text-align: center;
  font-weight: 500;
  padding: 2px 0;
 }
 /* ==========================================================================
-   [2] 操作按钮 — 6 态（沿用 .call-agent-btn--* 6 个 modifier）
+   [1] 操作按钮 — 6 态（沿用 .call-agent-btn--* 6 个 modifier）
   为什么要复用 .call-agent-btn（来自 InputBar.vue）：
 *   - v1.3 整合区方案 §B 规定"不引入新 class"
 *   - 现有 .call-agent-btn 样式（圆角、padding、font）已在 InputBar.vue 落地并 PASS
@@ -332,7 +321,7 @@ function handleClick(): void {
 }
 /* ==========================================================================
-   [3] QueueCapsule — 容器样式覆盖（v1.3 集成到整合区内部）
+   [2] QueueCapsule — 容器样式覆盖（v1.3 集成到整合区内部）
   - QueueCapsule 内部的 .queue-capsule 样式不变（已在 QueueCapsule.vue 中定义）
   - 这里仅做"整合区内部的容器融入"调整：去除内边距冲突
   ========================================================================== */
@@ -343,7 +332,7 @@ function handleClick(): void {
 }
 /* ==========================================================================
-   [4] 引导语 — 4 种场景文案（沿用 .input-bar__guide 风格，新增 .integration-zone__guide）
+   [3] 引导语 — 4 种场景文案（沿用 .input-bar__guide 风格，新增 .integration-zone__guide）
   ========================================================================== */
 .integration-zone__guide {
  text-align: center;
@@ -13,7 +13,8 @@
 *
 * 复用关系：
 *   - 复用 inputBarCallAgentState.ts 的 6 态计算（不再重复实现）
- *   - ~~复用 utils/shiftHours.ts 的状态条文案生成~~（v1.3.5 整体删除）
+ *   - ~~复用 utils/shiftHours.ts 的状态条文案生成~~
 *     （v1.3.5 拍板删除；⚠️ 当时仅落地引导语侧，组件模板遗留至 v1.4 才真正清理）
 *   - 复用 inputBarGuideText.ts 的引导语 warn 样式判定
 *
 * 不变性约束（v1.2x 已 PASS 6 态）：
@@ -34,8 +35,9 @@ import { isGuideTextWarn } from './inputBarGuideText'
 /**
 * IntegrationZone Props
- *   - agentOnline: QueueCapsule 排队态降级判定的统一依据（v1.3.5 状态条已删除）
+ *   - agentOnline: QueueCapsule 排队态降级判定的统一依据（状态条已于 v1.4 删除，
- *   - shiftHours: ~~状态条显示的班次~~（v1.3.5 状态条已删除），字段保留以备 v1.4 接后端 API
+ *     此字段不再用于任何面向员工的在线状态展示）
 *   - shiftHours: ~~状态条显示的班次~~（v1.4 状态条已删除），字段保留以备后端班次 API
 *   - callAgentState: 6 态按钮（disabled/active/urgent/waiting/end/reopen）
 *   - guideText: 4 种场景引导语文本（null 表示不显示引导语，v1.3.5 起场景 3 也返回 null）
 */
@@ -0,0 +1,100 @@
 /**
 * IntegrationZone 状态条移除 — 回归守卫单测（v1.4 新建）
 * ============================================================================
 *
 * 【为什么需要这个测试文件】
 * 2026-08-03 QA 发现一次"决策落地一半"的事故：
 *   - PRD v1.3 §11.4 决策 1 写「状态条永久显示」
 *   - v1.3.5 产品反转拍板「删除状态条」，ChatPanel.vue / integrationZoneLogic.ts /
 *     inputBarGuideText.ts 三处注释都已改成"已删除"
 *   - 但 IntegrationZone.vue 的模板、computed、样式、shiftHours 引用**全部原样保留**，
 *     线上实际仍在渲染状态条
 *   - 44 条整合区单测对状态条**零覆盖**，所以 75/75 全绿完全没有暴露该问题
 *
 * 结论：纯函数测试无法覆盖"模板里是否渲染某个元素"这一层。本项目 vitest 环境为
 * `node`，且未引入 @vue/test-utils / happy-dom，无法做组件挂载断言。
 *
 * 【本文件采用的方案】
 * 源码级守卫（source-level guard）：直接把 .vue 单文件组件当文本读入，断言状态条
 * 相关的四类痕迹都不存在。这是在没有 DOM 测试基建前提下，成本最低且能真正锁死
 * 回归的做法。
 *
 * 【维护提示】
 * 若将来引入 @vue/test-utils + happy-dom，应把本文件替换为真正的挂载断言
 * （`expect(wrapper.find('.integration-zone__status-bar').exists()).toBe(false)`），
 * 并同步删除本文件。
 *
 * 关联：PRD-REQ-会话-001-员工结束会话-v1.4 §十一 / TR-会话-001-结束会话-v1.3.2
 */
 import { describe, it, expect } from 'vitest'
 import { readFileSync } from 'node:fs'
 import { fileURLToPath } from 'node:url'
 // 用 import.meta.url 解析同目录文件，避免依赖 vitest 的 cwd（跨平台安全）
 const COMPONENT_PATH = fileURLToPath(new URL('./IntegrationZone.vue', import.meta.url))
 const source = readFileSync(COMPONENT_PATH, 'utf-8')
 /**
 * 剥离注释后的"有效源码"。
 * 必须剥离，否则组件里那些解释「v1.4 已删除状态条」的说明性注释本身就含有
 * `status-bar` / `statusBarText` 等关键词，会让断言假阳性失败。
 *   - /* ... *\/  块注释（含 JSDoc 与 CSS 注释）
 *   - <!-- ... --> HTML 注释
 *   - // ...      行注释
 */
 const effectiveSource = source
  .replace(/<!--[\s\S]*?-->/g, '')
  .replace(/\/\*[\s\S]*?\*\//g, '')
  .replace(/^\s*\/\/.*$/gm, '')
 describe('IntegrationZone — 状态条移除守卫（v1.4）', () => {
  it('模板中不存在 .integration-zone__status-bar 元素', () => {
    expect(effectiveSource).not.toContain('integration-zone__status-bar')
  })
  it('script 中不存在 statusBarText computed', () => {
    expect(effectiveSource).not.toContain('statusBarText')
  })
  it('不再从 utils/shiftHours 导入 buildStatusBarText / SHIFT_HOURS', () => {
    expect(effectiveSource).not.toContain('buildStatusBarText')
    expect(effectiveSource).not.toContain('SHIFT_HOURS')
    expect(effectiveSource).not.toContain("from '@/utils/shiftHours'")
  })
  it('不再出现"在线 · " / "客服离线 · "等状态条文案痕迹', () => {
    expect(effectiveSource).not.toContain('在线 ·')
    expect(effectiveSource).not.toContain('客服离线')
  })
 })
 /**
 * 阳性对照组（positive control）
 *
 * 上面 4 条断言都是"不包含 X"形式 —— 如果文件路径写错、读到空字符串，
 * 这些断言会全部通过，形成假绿灯。因此必须再断言"该包含的东西确实还在"，
 * 证明我们读到的是正确且完整的组件源码。
 */
 describe('IntegrationZone — 阳性对照：其余 3 元素仍完整保留', () => {
  it('[1] 操作按钮仍然渲染', () => {
    expect(effectiveSource).toContain('call-agent-btn')
    expect(effectiveSource).toContain('computeCallAction')
  })
  it('[2] QueueCapsule 进度胶囊仍然集成', () => {
    expect(effectiveSource).toContain('QueueCapsule')
    expect(effectiveSource).toContain('agent-online')
  })
  it('[3] 引导语容器仍然存在（v-if="guideText" 条件渲染）', () => {
    expect(effectiveSource).toContain('integration-zone__guide')
    expect(effectiveSource).toContain('v-if="guideText"')
  })
  it('整合区容器根元素与四个 emit 事件保持不变', () => {
    expect(effectiveSource).toContain('class="integration-zone"')
    for (const evt of ['callAgent', 'cancelQueue', 'endConversation', 'reopenConversation']) {
      expect(effectiveSource).toContain(evt)
    }
  })
 })
@@ -12,5 +12,18 @@ export default defineConfig({
  test: {
    environment: 'node',
    globals: true,
    // 只跑本项目 src/ 下的测试。
    // 背景（2026-08-03）：仓库里残留 node_modules_old/（早期依赖备份，含 fabric 等
    // 三方库自带的 .test.ts/.spec.ts）。vitest 默认 exclude 仅覆盖 `node_modules`，
    // 不匹配 `node_modules_old`，导致 `vitest run` 会拉起 242 个文件、1914 条三方用例
    // 并大量失败，把本项目的真实结果淹没。显式收窄 include 是最稳妥的做法。
    include: ['src/**/*.{test,spec}.?(c|m)[jt]s?(x)'],
    exclude: [
      '**/node_modules/**',
      '**/node_modules_old/**',
      '**/dist/**',
      '**/dist.bak.*/**',
      '**/dist_bak*/**',
    ],
  },
 })