-
-
- {{ statusBarText }}
-
-
-
+
+
-
+
-
+
(() =>
- buildStatusBarText({
- agentOnline: props.agentOnline,
- shiftHours: props.shiftHours ?? SHIFT_HOURS,
- })
-)
/**
* 按钮文案（6 态，沿用 inputBarCallAgentState.computeCallAgentBtnText）
@@ -203,19 +201,10 @@ function handleClick(): void {
flex-shrink: 0;
}
-/* ==========================================================================
- [1] 状态条 — 班次信息小字
- ========================================================================== */
-.integration-zone__status-bar {
- font-size: 12px;
- color: var(--text-secondary, #6b7280);
- text-align: center;
- font-weight: 500;
- padding: 2px 0;
-}
+/* v1.4：.integration-zone__status-bar 样式已随状态条一并删除 */
/* ==========================================================================
- [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;
diff --git a/src/frontend-h5/src/components/chat/integrationZoneLogic.ts b/src/frontend-h5/src/components/chat/integrationZoneLogic.ts
index 8a7374b..15f870d 100644
--- a/src/frontend-h5/src/components/chat/integrationZoneLogic.ts
+++ b/src/frontend-h5/src/components/chat/integrationZoneLogic.ts
@@ -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 状态条已删除）
- * - shiftHours: ~~状态条显示的班次~~（v1.3.5 状态条已删除），字段保留以备 v1.4 接后端 API
+ * - agentOnline: QueueCapsule 排队态降级判定的统一依据（状态条已于 v1.4 删除，
+ * 此字段不再用于任何面向员工的在线状态展示）
+ * - shiftHours: ~~状态条显示的班次~~（v1.4 状态条已删除），字段保留以备后端班次 API
* - callAgentState: 6 态按钮（disabled/active/urgent/waiting/end/reopen）
* - guideText: 4 种场景引导语文本（null 表示不显示引导语，v1.3.5 起场景 3 也返回 null）
*/
diff --git a/src/frontend-h5/src/components/chat/integrationZoneStatusBar.test.ts b/src/frontend-h5/src/components/chat/integrationZoneStatusBar.test.ts
new file mode 100644
index 0000000..72d94cb
--- /dev/null
+++ b/src/frontend-h5/src/components/chat/integrationZoneStatusBar.test.ts
@@ -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(//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)
+ }
+ })
+})
diff --git a/src/frontend-h5/vitest.config.ts b/src/frontend-h5/vitest.config.ts
index c948636..73479de 100644
--- a/src/frontend-h5/vitest.config.ts
+++ b/src/frontend-h5/vitest.config.ts
@@ -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*/**',
+ ],
},
})