@mrrisega/dsh-remote 0.6.10-beta.1 → 0.6.10-beta.11

package/clients/dsh-remote/dsh-bridge.mjs

@@ -135,11 +135,17 @@ const TOKEN = process.env.DSH_BRIDGE_TOKEN || "";
 function machineUniqueId() {
   if (process.env.DSH_BRIDGE_MACHINE_FP) return String(process.env.DSH_BRIDGE_MACHINE_FP).slice(0, 64);
   if (process.platform === "darwin") {
-    try {
-      const out = execSync("ioreg -rd1 -c IOPlatformExpertDevice", { encoding: "utf8", timeout: 5000 });
-      const m = /"IOPlatformUUID"\s*=\s*"([^"]+)"/.exec(out);
-      if (m && m[1]) return m[1];
-    } catch { /* 兜底 */ }
+    // ⚠️ 必须用**绝对路径**：由 launchd 拉起时 PATH 来自 plist（实测 /usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin），
+    // **不含 /usr/sbin** —— 而 ioreg 恰好就在那里。用裸名会得到
+    // "/bin/sh: ioreg: command not found"（真机日志实测），于是这里静默返回 ""，
+    // 指纹退化成 hostname 哈希：用户改一次主机名就被服务端当成新设备 —— 与 Windows 那条是同一个 bug。
+    for (const ioreg of ["/usr/sbin/ioreg", "ioreg"]) {
+      try {
+        const out = execSync(`${ioreg} -rd1 -c IOPlatformExpertDevice`, { encoding: "utf8", timeout: 5000 });
+        const m = /"IOPlatformUUID"\s*=\s*"([^"]+)"/.exec(out);
+        if (m && m[1]) return m[1];
+      } catch { /* 换下一个候选 */ }
+    }
   } else if (process.platform === "linux") {
     for (const f of ["/etc/machine-id", "/var/lib/dbus/machine-id"]) {
       try {
@@ -157,14 +163,20 @@ function machineUniqueId() {
     //   · PowerShell 在受限语言模式 / AppLocker 的企业机器上可能被策略直接禁掉，
     //     而拿不到指纹时只能退回 hostname（用户一改主机名就被当成新设备）—— 正是要修的问题；
     //   · 走 spawnSync 传数组参数，不经过 cmd.exe，因而没有引号/空格/中文路径的转义坑。
-    try {
-      const r = spawnSync("reg", ["query", "HKLM\\SOFTWARE\\Microsoft\\Cryptography", "/v", "MachineGuid"],
-        { encoding: "utf8", timeout: 5000, windowsHide: true });
-      const m = r && r.status === 0
-        ? /MachineGuid\s+REG_SZ\s+([0-9a-fA-F-]{16,})/.exec(String(r.stdout || ""))
-        : null;
-      if (m && m[1]) return m[1];
-    } catch { /* 兜底 */ }
+    // 同样不赌 PATH：优先 System32 下的绝对路径，取不到再退回裸名（macOS 那条就是这么栽的）。
+    const regCandidates = [];
+    if (process.env.SystemRoot) regCandidates.push(`${process.env.SystemRoot}\\System32\\reg.exe`);
+    regCandidates.push("reg");
+    for (const reg of regCandidates) {
+      try {
+        const r = spawnSync(reg, ["query", "HKLM\\SOFTWARE\\Microsoft\\Cryptography", "/v", "MachineGuid"],
+          { encoding: "utf8", timeout: 5000, windowsHide: true });
+        const m = r && r.status === 0
+          ? /MachineGuid\s+REG_SZ\s+([0-9a-fA-F-]{16,})/.exec(String(r.stdout || ""))
+          : null;
+        if (m && m[1]) return m[1];
+      } catch { /* 换下一个候选 */ }
+    }
   }
   return ""; // 读不到(如容器/受限环境) → 回退宿主名指纹
 }
@@ -1212,6 +1224,119 @@ function tagWeChat(m) {
   return s.startsWith("[") ? s : `[wechat] ${s}`;
 }
 
+/**
+ * 微信通道的档位来源(免费/付费分层)。
+ *
+ * 取值 = 账号的**生效套餐**,服务端只有三种:free / pro / pro_max
+ * (见企业端 auth.js 的 PLAN_PRIORITY;试用期服务端已折算成 pro,这里不必自己判断)。
+ *
+ * ★ 返回**两种契约**(见 docs/entitlements-contract.md §5/§6.1):
+ *   · 服务端 `/api/me` 带了 `entitlements`(后台可配置的权益包)→ 返回**对象**
+ *     `{plan, caps, limits, rev}`,runtime 以它为准判定能力 —— 这样「后台改配置 = 用户侧实时生效」
+ *     才成立(无需发版)。caps/limits **原样透传**:权限判定以服务端为唯一真相源,
+ *     客户端任何"二次加工/本地过滤"都会让展示与判定分叉,也会让后台配置失效(红线 §8.1/§8.2)。
+ *   · 服务端**没带** `entitlements`(灰度期的旧服务端)→ 保持今天的行为、返回**字符串**档位:
+ *     runtime 有上次的包就继续用它,一份包都没有才按内置表解析。新旧服务端都要能跑,
+ *     所以这里不能只认新契约。
+ *
+ * ⚠️ 取不到时返回**空串**,而不是 "free":空串让 runtime 沿用上次成功取到的档位。
+ *    一次网络抖动就把付过钱的用户降级成免费、还提示他去升级,比多给几分钟权限糟糕得多。
+ * ⚠️ 自建部署直接给最高档:用户跑的是自己的服务器,不存在"会员"这回事,
+ *    不能拿 SaaS 的分层去卡自建用户。
+ */
+/**
+ * 档位查询专用的 token 缓存(理由见 resolveWechatTier 里的注释)。
+ * TTL 取 5 分钟:远小于 JWT 有效期,又足以把「每 10 分钟一次定时校准 + 被拒即重查」
+ * 全部挡在网络之外 —— 不缓存的话,免费用户连着发几条消息就会触发一串 device-login。
+ */
+const WECHAT_TIER_TOKEN_TTL_MS = 5 * 60_000;
+let WECHAT_TIER_TOKEN = { value: "", at: 0 };
+/**
+ * 最近一次 `/api/me` 的账号快照(查档位时顺手记下来)。
+ *
+ * 为什么需要:微信通道要做"会员临近到期"提醒,而它**不该再单独打一次** `/api/me` ——
+ * 档位每 10 分钟本来就会查一次,顺手记住即可。查失败时**保持上次的值**(与档位同一策略:
+ * 一次网络抖动不该让提醒凭空消失或变成乱猜)。
+ */
+let WECHAT_ACCOUNT_SNAPSHOT = null;
+/** 供微信通道取账号快照(到期提醒用)。没查过就返回 null → 上层什么都不发。 */
+async function wechatAccountInfo() {
+  return WECHAT_ACCOUNT_SNAPSHOT;
+}
+
+async function resolveWechatTier() {
+  if (process.env.DSH_BRIDGE_LOCAL_KEY) return "pro_max";
+  try {
+    // ⚠️ `resolveToken()` **不带缓存**:账号模式下每调一次就重新 device-login 一次
+    //    (见它的第一行,只有 DSH_BRIDGE_TOKEN / 自建模式才短路)。
+    //    而档位会被反复查询:每 10 分钟一次定时校准 + 免费用户**每次被拒**都重查(最快 5 秒一次)。
+    //    拿它直接查 = 用户连着发几条消息就把自己打到登录限流里 —— 而 /api/device-login
+    //    是**按出口 IP 限流**的(15 分钟 5 次),连累的不只是他自己。
+    //    所以这里自己缓存 token。
+    const now = Date.now();
+    if (!WECHAT_TIER_TOKEN.value || now - WECHAT_TIER_TOKEN.at > WECHAT_TIER_TOKEN_TTL_MS) {
+      const t = await resolveToken();
+      if (!t) return "";
+      WECHAT_TIER_TOKEN = { value: t, at: now };
+    }
+    const r = await fetch(`${API_BASE}/api/me`, {
+      headers: { authorization: `Bearer ${WECHAT_TIER_TOKEN.value}` },
+      signal: AbortSignal.timeout(6000)
+    });
+    // token 过期/被吊销 → 丢掉缓存,下一次查询重新登录(而不是一直拿坏 token 打)
+    if (r.status === 401 || r.status === 403) {
+      WECHAT_TIER_TOKEN = { value: "", at: 0 };
+      return "";
+    }
+    if (!r.ok) return "";
+    const j = await r.json().catch(() => null);
+    const u = (j && j.user) || null;
+    // 顺手记账号快照(到期提醒用)。⚠️ 只在**真拿到了 user** 时覆盖 —— 否则保持上次。
+    if (u) {
+      WECHAT_ACCOUNT_SNAPSHOT = {
+        plan: String(u.plan || ""),
+        plan_ends_at: u.plan_ends_at ?? null,
+        trial_expires_at: u.trial_expires_at ?? null
+      };
+    }
+    // ★ 服务端权益包(契约 §5):有它就返回对象,runtime 以服务端 caps/limits 为准。
+    //
+    // 🔴 判据是「`caps` 是**数组**」,**空数组也算给了**(2026-09-23 修):
+    //   后台「明确清空」某档(契约 §4.1 的 `EMPTY_CAPS_VALUE`,下发即 `caps: []`)表达的是
+    //   **这个档位什么能力都没有**。如果这里把空数组当成"没给",runtime 就会沿用上次那份包
+    //   (一份都没有时回退**内置表**)—— 于是"我清空了 pro"变成"pro 拿回内置的一整套付费能力",
+    //   比后台意图**更多**权限。那是 fail-open,方向正好反了(契约 §8 红线 2)。
+    //   所以:数组(含空) = 权威;不是数组/字段缺失 = 这次没拿到 → 退回字符串契约沿用上次。
+    const ent = j && j.entitlements;
+    if (ent && typeof ent === "object" && Array.isArray(ent.caps)) {
+      return {
+        // plan 也原样取服务端的值;只有权益包里缺 plan 时才退回 user.plan(同一份真相的旧字段)。
+        plan: String(ent.plan || (u && u.plan) || ""),
+        caps: ent.caps,
+        // ⚠️ limits 缺失时必须给 null,**不能补 `{}`**:runtime 里 `{}` 是"有效的一张限制表",
+        //    于是 messages_per_month 读成 0 = 不限 → 免费用户当场变成无限额度(等于放权)。
+        //    null 才会让 runtime 沿用上次的值 / 回退内置表 —— 缺字段绝不等于放开(契约 §8.2 fail-closed)。
+        limits: ent.limits && typeof ent.limits === "object" ? ent.limits : null,
+        rev: String(ent.rev || "")
+      };
+    }
+    // 没有权益包(旧服务端 / 灰度期)→ 保持旧契约:只给档位字符串。
+    // runtime 收到字符串后:有上次的包就继续用它,一份包都没有才按内置表解析(冷启动兜底)。
+    return String((u && u.plan) || "");
+  } catch {
+    return "";
+  }
+}
+
+/**
+ * App 入口(免费用户越界时给的转化链接)。
+ * 由账号 API 地址推导:去掉 `/relay-api` 再加 `/app/` —— 与插件半的 DEFAULT_APP_URL 同一口径
+ * (https://host:port/relay-api → https://host:port/app/)。
+ */
+function wechatAppUrl() {
+  return `${API_BASE.replace(/\/relay-api\/?$/, "")}/app/`;
+}
+
 let wechatRuntime = null;
 function startWeChat() {
   if (WECHAT_DISABLED) {
@@ -1226,6 +1351,11 @@ function startWeChat() {
       upstream: UPSTREAM,
       cookieOf: harnessCookieOf,
       secret: process.env.DSH_BRIDGE_SECRET || (typeof cfg.bridge_secret === "string" ? cfg.bridge_secret : ""),
+      // 免费/付费分层:档位来自账号的生效套餐,App 链接是免费用户越界时的转化入口。
+      tierProvider: resolveWechatTier,
+      // 到期提醒的数据来源(复用上面那次 /api/me,不额外打网络)
+      accountInfo: wechatAccountInfo,
+      appUrl: wechatAppUrl(),
       // 模块自己的消息已带 `[wechat]` / `[wechat/events]` 前缀,这里**不能再加一次**
       // (真机日志里出现过 `[wechat] [wechat] 控制面已就绪`)。没前缀的兜底补一个。
       logger: {
@@ -1268,6 +1398,10 @@ async function runTunnel() {
     console.error("[bridge] 隧道模式需要账号认证:请设 DSH_BRIDGE_TOKEN,或 DSH_BRIDGE_PHONE+DSH_BRIDGE_PASSWORD");
     process.exit(1);
   }
+  // 把刚拿到的 JWT 喂给档位查询的缓存:否则 startWeChat 里的档位校准会**再登录一次**
+  // (真机日志实测:同一个桥接启动里出现两条并发的 device-login)。
+  // 而 /api/device-login 是按出口 IP 限流的 —— 每次启动都多花一份登录额度没有道理。
+  WECHAT_TIER_TOKEN = { value: token, at: Date.now() };
   // 新进程开始:重置状态文件(上一轮的成功记录不能代表这一轮,面板据此判定 online)
   persistBridgeState({ device_id: DEVICE_ID, started_at: Date.now(), phase: "connecting", last_error: null }, { reset: true });
   await initE2ee(token);

package/clients/dsh-remote/test/machine-fingerprint.test.mjs

@@ -42,11 +42,13 @@ function loadMachineUniqueId({
   assert.ok(!/稳定指纹/.test(src), "切片不应越过 machineUniqueId 的边界");
 
   const calls = [];
+  const execCalls = [];
   const fakeSpawnSync = (cmd, args, opts) => {
     calls.push({ cmd, args, opts });
     if (regThrows) throw new Error("spawn EPERM");
     return reg;
   };
+  const fakeExecSync = (cmd) => { execCalls.push(String(cmd)); return ioreg; };
   const fakeFs = {
     readFileSync: (f) => {
       if (f in machineIdFiles) return machineIdFiles[f];
@@ -55,8 +57,8 @@ function loadMachineUniqueId({
   };
   const make = new Function("process", "execSync", "spawnSync", "fs", "os",
     `${src}\nreturn machineUniqueId;`);
-  const fn = make({ platform, env }, () => ioreg, fakeSpawnSync, fakeFs, {});
-  return { fn, calls };
+  const fn = make({ platform, env }, fakeExecSync, fakeSpawnSync, fakeFs, {});
+  return { fn, calls, execCalls };
 }
 
 test("win32：机器指纹取注册表 MachineGuid（改主机名不再被当成新设备）", () => {
@@ -100,6 +102,9 @@ test("机器指纹：darwin/linux 两条老分支没有被改坏", () => {
     ioreg: '    "IOPlatformUUID" = "AAAA-BBBB-CCCC"\n',
   });
   assert.equal(darwin.fn(), "AAAA-BBBB-CCCC", "darwin 仍读 ioreg 的 IOPlatformUUID");
+  assert.match(darwin.execCalls[0], /^\/usr\/sbin\/ioreg /,
+    "★必须用绝对路径调 ioreg：launchd 的 plist PATH 不含 /usr/sbin，用裸名会 command not found,",
+  );
 
   const linux = loadMachineUniqueId({
     platform: "linux",
@@ -108,6 +113,29 @@ test("机器指纹：darwin/linux 两条老分支没有被改坏", () => {
   assert.equal(linux.fn(), "0123456789abcdef", "linux 仍读 /etc/machine-id（并去掉换行）");
 });
 
+test("★回归：子进程一律用绝对路径优先，不赌 PATH（launchd 的 PATH 不含 /usr/sbin 的真实事故）", () => {
+  // 事故（2026-09-22 真机日志）：bridge 由 launchd 拉起，plist 给的 PATH 是
+  // /usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin —— 没有 /usr/sbin，而 ioreg 在那里。
+  // 日志里出现 `/bin/sh: ioreg: command not found`，指纹**静默**退化成 hostname 哈希：
+  // 用户改一次主机名就被服务端当成新设备。这类"PATH 假设"必须用绝对路径堵死。
+  const mac = loadMachineUniqueId({ platform: "darwin", ioreg: 'x "IOPlatformUUID" = "U1"\n' });
+  mac.fn();
+  assert.match(mac.execCalls[0], /^\/usr\/sbin\/ioreg /, "darwin：首个候选必须是 /usr/sbin/ioreg");
+
+  // 绝对路径取不到时仍要退回裸名（别把别的机型的 macOS 弄死）
+  const macFallback = loadMachineUniqueId({ platform: "darwin", ioreg: "" });
+  assert.equal(macFallback.fn(), "", "两次都拿不到 → 空串（不是抛）");
+  assert.equal(macFallback.execCalls.length, 2, "应依次尝试绝对路径与裸名");
+  assert.match(macFallback.execCalls[1], /^ioreg /, "第二个候选是裸名");
+
+  // Windows 同理：SystemRoot 可用时优先 System32 的绝对路径
+  const win = loadMachineUniqueId({ platform: "win32", env: { SystemRoot: "C:\\Windows" } });
+  win.fn();
+  assert.equal(win.calls[0].cmd, "C:\\Windows\\System32\\reg.exe", "win32：应优先 System32 下的绝对路径");
+  assert.deepEqual(win.calls[0].args, ["query", "HKLM\\SOFTWARE\\Microsoft\\Cryptography", "/v", "MachineGuid"]);
+  assert.equal(win.calls[0].opts.windowsHide, true, "绝对路径候选同样必须 windowsHide");
+});
+
 test("机器指纹：拿不到机器唯一值时才退回宿主名哈希（这正是要修的退化路径）", () => {
   // 断言 machineFingerprint 的兜底表达式仍然存在 —— 它是"改主机名 = 新设备"的直接来源，
   // 修好 win32 分支后这条兜底只应在容器等极端环境生效。

package/clients/dsh-remote/test/wechat-channel.test.mjs

@@ -29,6 +29,10 @@ import test from "node:test";
 import {
   BindSession,
   COMMANDS,
+  COMPLETION_SUMMARY_MAX,
+  markdownToWechatText,
+  COMPLETION_TEXT_MAX,
+  SESSION_SUMMARY_MAX,
   DEFAULT_ILINK_BASE_URL,
   EventRegistry,
   HELP_TEXT,
@@ -1763,9 +1767,68 @@ test("完成模板:头一行按 reason 区分,completed 不许读成失败", ()
   assert.match(headers.get("error"), /出错/);
 });
 
+test("★ 微信不渲染 Markdown:模型产出的表格/加粗/链接必须先转成纯文本", () => {
+  // 业主原话:「现在的表格形式看起来很奇怪,整个格式在微信上没有做过任何兼容,体验很差很差」。
+  // 根因:微信**不渲染** Markdown(腾讯自己的插件在出站路径主动剥离),所以模型的表格会以
+  // 字面竖线、加粗会以字面星号出现在气泡里。这儿锁住"发送前必须已转换"。
+  const md = [
+    "## 修复结果",
+    "",
+    "| 项目 | 状态 |",
+    "|---|---|",
+    "| 黑窗 | 已修 |",
+    "| 指纹 | 已修 |",
+    "",
+    "**关键**:见 [提交](https://example.com/c/1)。",
+    "",
+    "- 测试通过",
+    "- `kill -9` 后自愈"
+  ].join("\n");
+  const out = markdownToWechatText(md);
+
+  assert.doesNotMatch(out, /\*\*/u, "加粗标记必须剥掉(留着就是星号噪声)");
+  assert.doesNotMatch(out, /\|/u, "★表格必须转成列表 —— 字面竖线在微信里就是一团乱码");
+  assert.match(out, /· 项目：黑窗 ｜ 状态：已修/u, "表格行要变成「列名:值 ｜ 列名:值」");
+  assert.match(out, /【修复结果】/u, "标题要变成【】独占一行");
+  assert.ok(out.includes("https://example.com/c/1"), "★链接必须留下**裸 URL**,否则微信不会变成可点链接");
+  assert.doesNotMatch(out, /\]\(/u, "不得残留 markdown 链接语法");
+  assert.match(out, /^· 测试通过$/mu, "无序列表统一成 ·");
+  assert.match(out, /kill -9 后自愈/u, "行内代码只去反引号,内容保留");
+  assert.doesNotMatch(out, /`/u, "反引号必须剥掉");
+
+  // 不能把乘号吃掉:`2 * 3 * 4` 里的单星号不是强调
+  assert.match(markdownToWechatText("结果 2 * 3 * 4 正确"), /2 \* 3 \* 4/,
+    "单个 * 只在看起来像强调时才剥,不能误伤乘号");
+
+  // 代码围栏:去掉围栏行,内容原样保留
+  const fenced = markdownToWechatText("```js\nconst a = 1;\n```");
+  assert.doesNotMatch(fenced, /```/u, "围栏行要去掉");
+  assert.match(fenced, /const a = 1;/u, "围栏内的内容要保留");
+
+  // 空输入/纯空白不炸
+  assert.equal(markdownToWechatText(""), "");
+  assert.equal(markdownToWechatText(null), "");
+  assert.equal(markdownToWechatText("   \n\n  "), "");
+});
+
+test("★★ 截断只压正文:头部与「下一步」必须活着(旧实现会把用户唯一能照做的那句话切掉)", () => {
+  // 旧实现:整条 join 后盲切尾部。而「回复 N … / 下一步」恰好拼在最后 →
+  // 一条超长消息会把**用户唯一能照做的指引**切掉(真机投诉过的形态)。
+  const huge = "长".repeat(COMPLETION_SUMMARY_MAX * 5);
+  const out = formatCompletion({ title: "超长任务", reason: "completed", summary: huge });
+  assert.match(out.text, /【任务正常完成】/u, "头部必须活着");
+  assert.match(out.text, /会话：超长任务/u, "会话名必须活着");
+  assert.match(out.text, /—— 下一步 ——/u, "★「下一步」分区必须活着");
+  assert.match(out.text, /直接回复一句话/u, "★那句可照做的指引必须活着");
+  assert.ok(out.text.length <= COMPLETION_TEXT_MAX, `整条要限长,实际 ${out.text.length}`);
+
+  // 正文自身超长仍要**显式**标注(不静默丢)
+  assert.match(out.text, /已截断/u, "正文被压时要显式标注");
+});
+
 test("完成模板:会话名在/不在都不能打印 undefined", () => {
   const named = formatCompletion({ title: "修登录跳转", reason: "completed", summary: "修好了。" });
-  assert.match(named.text, /会话:修登录跳转/, "会话名是用户最想看到的一行");
+  assert.match(named.text, /会话：修登录跳转/, "会话名是用户最想看到的一行");
   assert.equal(named.title, `任务${stopReasonText("completed")}`, "title 是展示标题(和 formatNotification 同义)");
 
   for (const t of ["", "   ", undefined, null]) {
@@ -1779,15 +1842,31 @@ test("完成模板:会话名在/不在都不能打印 undefined", () => {
   assert.doesNotMatch(byId.text, /session-abcdef1234567890/, "别把整个 id 印给用户看");
 });
 
-test("完成模板:结论在/不在/超长截断;hanging 说的是'取不到'", () => {
+test("完成模板:结论要**尽量完整**(未超上限不截断),超长才显式标注;hanging 说的是'取不到'", () => {
   const withSummary = formatCompletion({ title: "T", reason: "completed", summary: "结论正文" });
-  assert.match(withSummary.text, /结论:结论正文/);
-
-  const long = "长".repeat(1200);
-  const truncated = formatCompletion({ title: "T", reason: "completed", summary: long });
+  // 结论**独立成段**(不再挤在 "结论:" 前缀后面) —— 压成一行正是"密密麻麻"的来源
+  assert.match(withSummary.text, /—— 结论 ——\n结论正文/, "结论要单独成段、原样展示");
+
+  // ★ 业主口径(2026-09-22):「结论被大量截断了,加长一些,更完整地展示 —— 这可能是用户关注的内容」
+  //    旧上限 400 连一条正常的修复总结(实测 190+ 字)都快保不住。
+  const fits = "长".repeat(1200);
+  const kept = formatCompletion({ title: "T", reason: "completed", summary: fits });
+  assert.ok(kept.text.includes(fits),
+    `★未超上限的结论必须**整段**展示(旧上限 400 会砍掉它),实际整条长度 ${kept.text.length}`);
+  assert.doesNotMatch(kept.text, /已截断/, "没超上限就不该出现截断标注");
+
+  // 远超上限时仍必须**显式**标注截断(不静默丢)
+  const huge = "长".repeat(COMPLETION_SUMMARY_MAX * 3);
+  const truncated = formatCompletion({ title: "T", reason: "completed", summary: huge });
   assert.match(truncated.text, /已截断/, "超长必须有**显式**截断标注");
-  assert.ok(truncated.text.length <= 900, `整条要限在微信可读长度内,实际 ${truncated.text.length}`);
-  assert.equal(truncated.text.includes(long), false, "超长结论不得整段带出");
+  assert.ok(truncated.text.length <= COMPLETION_TEXT_MAX,
+    `整条要限在微信可读长度内,实际 ${truncated.text.length}`);
+  assert.equal(truncated.text.includes(huge), false, "超长结论不得整段带出");
+
+  // ★ 两道闸的关系:取值侧(会话历史)不能比展示侧(通知模板)更小,
+  //   否则结论会在拼接**之前**就被砍掉 —— 只盯 formatter 会找不到真正的截断点(历史踩过)
+  assert.ok(SESSION_SUMMARY_MAX >= COMPLETION_SUMMARY_MAX,
+    `取值上限(${SESSION_SUMMARY_MAX})必须 ≥ 展示上限(${COMPLETION_SUMMARY_MAX}),否则在更早处就被砍掉`);
 
   const noSummary = formatCompletion({ title: "T", reason: "completed" });
   assert.match(noSummary.text, /没有产出结论/);