zhaoshang_client_ui/harness/tools/verify-empty-content-agreement.mjs

/**
 * 验证「内容是否为空」的判空口径在两处保持一致。
 *
 * 验证什么：
 *   这个 bug 的本质是**两处判空口径不一致**，所以这里断言的不变量就是"两处必须一致"：
 *   `hasVisibleMessageContent(c)` 为 false 时，
 *     - `isInterruptedEmptyScopeMessage`（渲染层）必须判为"空的、要显示请求已取消"
 *     - `normalizeSessionHistory`（归一化）必须把内容替换成 CANCELLED_SESSION_TEXT
 *   反之必须都不成立。
 *
 *   触发场景：新协议的正文要等到 done 才写入，处理期间内容**只有 `<scope>` 进度块**；
 *   此时切会话，归一化曾认为"有内容"（不替换文案）却把状态翻成 Finish，
 *   渲染层则认为"没内容"→ 误报「请求已取消」。
 *
 * 怎么跑（在项目根目录）：
 *   npx esbuild harness/tools/_entry-empty-content.ts --bundle --format=esm \
 *     --alias:@=./src --outfile=harness/tools/_empty-content.mjs
 *   node harness/tools/verify-empty-content-agreement.mjs
 */

import {
  hasVisibleMessageContent,
  isInterruptedEmptyScopeMessage,
  normalizeSessionHistory,
  CANCELLED_SESSION_TEXT,
} from './_empty-content.mjs';

let pass = 0;
let fail = 0;
const check = (name, cond, extra = '') => {
  if (cond) {
    pass++;
    console.log('  ok   ' + name);
  } else {
    fail++;
    console.log('  FAIL ' + name + '  ' + extra);
  }
};

const SCOPE = '<scope title="正在检索相关政策和配套服务……">\n</scope>\n';
const SCOPE2 = '<scope title="问题仍在处理中，请稍候……">\n</scope>\n';

const CASES = [
  { name: '空字符串', content: '', empty: true },
  { name: '只有空白', content: '   \n  ', empty: true },
  { name: '只有 1 个进度块', content: SCOPE, empty: true },
  { name: '只有多个进度块（= 处理中的真实状态）', content: SCOPE + SCOPE2, empty: true },
  { name: '只有 silence 标签', content: '<silence></silence>', empty: true },
  { name: '进度块 + 正文', content: SCOPE + '这是回答正文。', empty: false },
  { name: '纯正文', content: '这是回答正文。', empty: false },
  { name: '正文 + 进度块', content: '这是回答正文。\n\n' + SCOPE, empty: false },
  { name: '只有标记（POLICY_TABLE）', content: '<!-- POLICY_TABLE {"data":[]} POLICY_TABLE -->', empty: false },
];

console.log('=== 1. hasVisibleMessageContent 的基准判定 ===');
CASES.forEach((c) => {
  check(`「${c.name}」判为空=${c.empty}`, hasVisibleMessageContent(c.content) === !c.empty);
});

console.log('\n=== 2. 不变量：两处判空必须一致 ===');
CASES.forEach((c) => {
  // 渲染层：history 消息、已结束状态
  const renderSaysEmpty = isInterruptedEmptyScopeMessage({
    role: 'ai',
    state: 3,
    history: true,
    content: c.content,
  });

  // 归一化：pending 状态的消息，看它是否把内容替换成"会话已经取消"
  const session = {
    id: 's1',
    title: 't',
    messages: [{ id: 'm1', role: 'ai', content: c.content, state: 1, history: false }],
  };
  normalizeSessionHistory(session);
  const normalizeSaysEmpty = session.messages[0].content === CANCELLED_SESSION_TEXT;

  check(
    `「${c.name}」两处一致（渲染=${renderSaysEmpty} 归一化=${normalizeSaysEmpty}）`,
    renderSaysEmpty === normalizeSaysEmpty,
    `期望两处都为 ${c.empty}`
  );
  check(`「${c.name}」都判为 ${c.empty ? '空' : '非空'}`, renderSaysEmpty === c.empty);
});

console.log('\n=== 3. 回归：正文不会被误替换 ===');
{
  const session = {
    id: 's1',
    title: 't',
    messages: [{ id: 'm1', role: 'ai', content: SCOPE + '真实回答', state: 1, history: false }],
  };
  normalizeSessionHistory(session);
  check('有正文时不替换成"会话已经取消"', session.messages[0].content !== CANCELLED_SESSION_TEXT);
  check('但状态仍归一到 Finish', session.messages[0].state === 3);
}
{
  const session = {
    id: 's1',
    title: 't',
    messages: [{ id: 'm1', role: 'ai', content: SCOPE, state: 1, history: false }],
  };
  normalizeSessionHistory(session);
  check('只有进度块时替换成"会话已经取消"（不再让渲染层误报"请求已取消"）',
    session.messages[0].content === CANCELLED_SESSION_TEXT);
}

console.log(`\n通过 ${pass} 项，失败 ${fail} 项`);
process.exit(fail ? 1 : 0);