jbc-dssi 1.0.1 → 1.1.0

package/index.js

@@ -54,23 +54,43 @@ import { ensurePairing } from './pairing/ensure.js';
  *
  * 依赖方向：桥接 → bots/bridge（允许）；bots/bridge 不反向依赖桥接。
  */
+/**
+ * 加载可选子模块（bots / dssAgent / groups）。
+ *
+ * 两条路径都要能跑：
+ *   · 发布态（npm 包装进 node_modules）：模块被 prepack 复制到 ./vendor/<name>/
+ *   · 开发态（在仓库里直接 link）：模块是插件目录的同级目录 ../<name>/
+ * 两种找不到才算"模块缺失"，此时能力自动关闭（不影响桥接主链路）。
+ */
+async function loadOptionalModule(name) {
+  let lastErr = null;
+  for (const spec of [`./vendor/${name}/bridge/index.js`, `../${name}/bridge/index.js`]) {
+    try {
+      return await import(spec);
+    } catch (err) {
+      lastErr = err;
+    }
+  }
+  throw lastErr ?? new Error(`模块 ${name} 未找到`);
+}
+
 let botsModule = null;
 try {
-  botsModule = await import('../bots/bridge/index.js');
+  botsModule = await loadOptionalModule('bots');
 } catch (err) {
   console.log(`[mob-bridge] bots 模块未加载（团队能力关闭）：${err?.message ?? err}`);
 }
 
 let dssAgentModule = null;
 try {
-  dssAgentModule = await import('../dssAgent/bridge/index.js');
+  dssAgentModule = await loadOptionalModule('dssAgent');
 } catch (err) {
   console.log(`[mob-bridge] dssAgent 模块未加载（智能体能力关闭）：${err?.message ?? err}`);
 }
 
 let groupsModule = null;
 try {
-  groupsModule = await import('../groups/bridge/index.js');
+  groupsModule = await loadOptionalModule('groups');
 } catch (err) {
   console.log(`[mob-bridge] groups 模块未加载（群聊能力关闭）：${err?.message ?? err}`);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jbc-dssi",
-  "version": "1.0.1",
+  "version": "1.1.0",
   "type": "module",
   "description": "鲸编程 - 不只是手机遥控操作电脑,而是将电脑级的Agent能力装进手机",
   "keywords": [
@@ -28,6 +28,7 @@
     "index.js",
     "lib/",
     "pairing/",
+    "vendor/",
     "cordis.patch.yml"
   ],
   "exports": {
@@ -41,5 +42,8 @@
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "prepack": "node scripts/build-vendor.mjs"
   }
 }

package/vendor/bots/bridge/index.js

@@ -0,0 +1,16 @@
+/**
+ * bots/bridge/index.js —— 桥接侧唯一公开入口（被 jbc-dssi 动态加载）。
+ *
+ * 契约：纯函数 + 一个本地小文件存储工厂；不依赖 DSH、不引用桥接内部实现。
+ * 状态（seq / 去重签名 / 防抖定时器）属于桥接连接自己 —— 这样本模块可单测、
+ * 可删除（目录没了 → 动态 import 失败 → 桥接自动关闭团队能力，照常工作）。
+ */
+export {
+  PAYLOAD_VERSION,
+  LIMITS,
+  isTeamEvent,
+  teamFromItem,
+  buildSnapshot,
+  snapshotSignature,
+} from './view.js';
+export { createTeamMetaStore } from './meta.js';

package/vendor/bots/bridge/meta.js

@@ -0,0 +1,112 @@
+/**
+ * bots/bridge/meta.js —— 团队显示信息（团队名 + 成员中文显示名）的持久化。
+ *
+ * 为什么需要它：DSH 的 Team 投影里只有成员内部名（小写英文、永久不可改）
+ * 和会话标题，没有"团队名"和"中文显示名"这两个产品字段。
+ * 这张别名表存在**电脑侧**（不是手机本地），这样手机和浏览器看到同一份。
+ *
+ * 数据极小（团队数 × 成员数），读写都在事件循环外的一次小文件里；
+ * 写入用 tmp+rename，避免半截 JSON。
+ */
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+
+export const DEFAULT_META_FILE = path.join(os.homedir(), '.dsh', 'jbc-dssi', 'bots-teams.json');
+
+const LIMITS = {
+  teams: 100,
+  nameChars: 80,
+  aliases: 16,
+  idChars: 32,
+  labelChars: 40,
+};
+const ID_RE = /^[a-z0-9_-]{1,32}$/;
+
+function cleanName(value) {
+  if (typeof value !== 'string') return '';
+  return value.trim().slice(0, LIMITS.nameChars);
+}
+
+function cleanAliases(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) return {};
+  const out = {};
+  let n = 0;
+  for (const [id, label] of Object.entries(value)) {
+    if (n >= LIMITS.aliases) break;
+    const key = String(id).trim().toLowerCase();
+    const text = cleanName(label).slice(0, LIMITS.labelChars);
+    if (!ID_RE.test(key) || !text) continue;
+    out[key] = text;
+    n += 1;
+  }
+  return out;
+}
+
+/** @returns {{get:(sessionId:string)=>{name:string,aliases:Object}|undefined, all:()=>Object, set:Function, file:string}} */
+export function createTeamMetaStore({ file, log = () => {} } = {}) {
+  const target = typeof file === 'string' && file.trim() ? file.trim() : DEFAULT_META_FILE;
+  /** @type {Record<string,{name:string,aliases:Record<string,string>}>} */
+  let cache = {};
+  let loaded = false;
+
+  function load() {
+    if (loaded) return;
+    loaded = true;
+    try {
+      const raw = fs.readFileSync(target, 'utf8');
+      const parsed = JSON.parse(raw);
+      if (!parsed || typeof parsed !== 'object' || Array.isArray(parsed)) return;
+      for (const [sessionId, value] of Object.entries(parsed)) {
+        if (typeof sessionId !== 'string' || !sessionId) continue;
+        if (!value || typeof value !== 'object') continue;
+        const name = cleanName(value.name);
+        const aliases = cleanAliases(value.aliases);
+        if (!name && Object.keys(aliases).length === 0) continue;
+        cache[sessionId] = { name, aliases };
+      }
+    } catch (err) {
+      // 文件不存在是常态（第一次用）；损坏则忽略并记录，绝不影响团队功能
+      if (err?.code !== 'ENOENT') log(`[bots-meta] 读取失败，按空表处理：${err?.message ?? err}`);
+      cache = {};
+    }
+  }
+
+  function persist() {
+    try {
+      fs.mkdirSync(path.dirname(target), { recursive: true });
+      const tmp = `${target}.tmp`;
+      fs.writeFileSync(tmp, JSON.stringify(cache, null, 2), 'utf8');
+      fs.renameSync(tmp, target);
+    } catch (err) {
+      log(`[bots-meta] 写入失败：${err?.message ?? err}`);
+    }
+  }
+
+  return {
+    file: target,
+    get(sessionId) {
+      load();
+      return cache[sessionId];
+    },
+    all() {
+      load();
+      return cache;
+    },
+    set(sessionId, value) {
+      load();
+      const id = typeof sessionId === 'string' ? sessionId.trim() : '';
+      if (!id) return false;
+      const name = cleanName(value?.name);
+      const aliases = cleanAliases(value?.aliases);
+      if (!name && Object.keys(aliases).length === 0) return false;
+      // 团队数上限：满了就只允许更新已有团队（绝不因为一条脏消息丢掉整张表）
+      if (!cache[id] && Object.keys(cache).length >= LIMITS.teams) return false;
+      cache[id] = { name, aliases };
+      persist();
+      return true;
+    },
+  };
+}
+
+export { LIMITS as TEAM_META_LIMITS };

package/vendor/bots/bridge/view.js

@@ -0,0 +1,207 @@
+/**
+ * bots/bridge/view.js —— 纯函数层：把 DSH 的会话投影变成手机要的团队快照。
+ *
+ * 为什么这一层必须是纯函数：
+ *   1. 可单测：不需要起 DSH、不需要真团队，fixture 就能覆盖全部边界；
+ *   2. 上游（agent-team 是实验性包）改字段时，**只改这一层**，桥接与手机不动；
+ *   3. 大小可控：截断/上限集中在一处，避免某天一个 5000 字任务描述把帧撑爆。
+ *
+ * 数据来源（DSH v1）：
+ *   sessionController.list() 的每一项 item：
+ *     { sessionId, running, cwd, updatedAt, origin?, parentSessionId?,
+ *       projections: { values: { title?, agentTeam?: { members, tasks, failure? } } } }
+ *   成员的 running 状态不在 agentTeam 里 —— 要拿成员的会话 id 去 item 列表里 join。
+ */
+
+/** 载荷版本。字段语义有破坏性变化时 +1，手机侧按 v 决定能不能解析。 */
+export const PAYLOAD_VERSION = 1;
+
+/**
+ * 上限。与 bots/contract/teams.schema.json 的 limits **必须一致**（测试会断言）。
+ * 取值依据：DSH agent-team 的硬上限是 16 成员 / 256 任务；这里再留一点余量，
+ * 保证最坏情况单帧远小于 MAX_FRAME_BYTES（8 MB），4G 上也不会卡首屏。
+ */
+export const LIMITS = Object.freeze({
+  teams: 20,
+  membersPerTeam: 16,
+  tasksPerTeam: 200,
+  subjectChars: 120,
+  descriptionChars: 300,
+  failureChars: 500,
+  errorChars: 300,
+  writeScopes: 20,
+  writeScopeChars: 100,
+  blockedBy: 20,
+  warnings: 20,
+  warningChars: 120,
+  nameChars: 80,
+  cwdChars: 300,
+  labelChars: 40,
+});
+
+/** 团队事件：roster/任务板变了。历史 team/message/* 事件刻意不算。 */
+const TEAM_EVENT_RE = /^team\/(?:member|task)$/;
+
+export function isTeamEvent(type) {
+  return typeof type === 'string' && TEAM_EVENT_RE.test(type);
+}
+
+function str(value, max) {
+  if (typeof value !== 'string') return '';
+  const text = value.trim();
+  return text.length > max ? `${text.slice(0, max)}…` : text;
+}
+
+function intOr(value, fallback = 0) {
+  return Number.isSafeInteger(value) ? value : fallback;
+}
+
+function basename(p) {
+  if (typeof p !== 'string') return '';
+  const trimmed = p.replace(/\/+$/, '');
+  const tail = trimmed.slice(trimmed.lastIndexOf('/') + 1);
+  return tail.trim();
+}
+
+function teamName({ title, cwd }) {
+  const fromTitle = str(title, LIMITS.nameChars);
+  if (fromTitle) return fromTitle;
+  const fromCwd = basename(cwd).slice(0, LIMITS.nameChars);
+  return fromCwd || '未命名小队';
+}
+
+/** 成员 id → 该会话是否在跑。注意：子会话也在 list() 里，不能被过滤掉。 */
+function runningBySessionId(items) {
+  const map = new Map();
+  for (const item of items) {
+    if (item && typeof item.sessionId === 'string') map.set(item.sessionId, item.running === true);
+  }
+  return map;
+}
+
+function normalizeMember(member, runningById, aliases = {}) {
+  if (!member || typeof member !== 'object') return null;
+  const name = str(member.name, LIMITS.nameChars);
+  if (!name) return null;
+  const role = member.role === 'lead' ? 'lead' : 'teammate';
+  const phase = ['failed', 'provisioning', 'active'].includes(member.phase) ? member.phase : 'active';
+  const out = {
+    name,
+    sessionId: str(member.id, 64),
+    role,
+    phase,
+    running: runningById.get(member.id) === true,
+  };
+  // 中文显示名来自电脑侧别名表（meta.js）；没有就回退到内部名，UI 自己兜底
+  if (aliases && typeof aliases === 'object') {
+    const label = str(aliases[name], LIMITS.labelChars);
+    if (label) out.displayName = label;
+  }
+  const error = str(member.error, LIMITS.errorChars);
+  if (error) out.error = error;
+  return out;
+}
+
+function normalizeTask(task, aliases = {}) {
+  if (!task || typeof task !== 'object') return null;
+  const subject = str(task.subject, LIMITS.subjectChars);
+  if (!subject) return null;
+  const status = ['completed', 'pending', 'in_progress', 'deleted'].includes(task.status)
+    ? task.status
+    : 'pending';
+  if (status === 'deleted') return null;
+  const out = {
+    id: str(task.id, 32),
+    revision: intOr(task.revision, 0),
+    subject,
+    status,
+    ready: task.ready === true,
+    blockedBy: Array.isArray(task.blockedBy)
+      ? task.blockedBy.slice(0, LIMITS.blockedBy).map((id) => str(id, 32))
+      : [],
+    writeScopes: Array.isArray(task.writeScopes)
+      ? task.writeScopes.slice(0, LIMITS.writeScopes).map((p) => str(p, LIMITS.writeScopeChars))
+      : [],
+    writeScopeWarnings: Array.isArray(task.writeScopeWarnings)
+      ? task.writeScopeWarnings.slice(0, LIMITS.warnings).map((w) => str(w, LIMITS.warningChars))
+      : [],
+  };
+  const description = str(task.description, LIMITS.descriptionChars);
+  if (description) out.description = description;
+  const owner = str(task.ownerName, LIMITS.nameChars);
+  if (owner) out.ownerName = str(aliases[owner], LIMITS.labelChars) || owner;
+  return out;
+}
+
+/**
+ * 一个会话 item → 一支小队；不是小队就返回 null。
+ *
+ * "是不是小队"的判据：至少 1 个 teammate，或任务板非空。
+ * 只有 Lead 自己、也没有任务的全话不显示 —— 否则团队 tab 会把所有聊天会话都列出来。
+ */
+export function teamFromItem(item, runningById = new Map(), meta = null) {
+  const at = item?.projections?.values?.agentTeam;
+  if (!at || typeof at !== 'object' || !Array.isArray(at.members)) return null;
+
+  const labels = meta && typeof meta === 'object' && meta.aliases ? meta.aliases : {};
+  const members = at.members
+    .map((m) => normalizeMember(m, runningById, labels))
+    .filter(Boolean)
+    .slice(0, LIMITS.membersPerTeam);
+  const tasks = (Array.isArray(at.tasks) ? at.tasks : [])
+    .map((task) => normalizeTask(task, labels))
+    .filter(Boolean)
+    .slice(0, LIMITS.tasksPerTeam);
+
+  const hasTeammate = members.some((m) => m.role === 'teammate');
+  if (!hasTeammate && tasks.length === 0) return null;
+
+  const team = {
+    sessionId: str(item.sessionId, 64),
+    name: (meta && str(meta.name, LIMITS.nameChars)) || teamName({
+      title: item?.projections?.values?.title,
+      cwd: item.cwd,
+    }),
+    cwd: str(item.cwd, LIMITS.cwdChars),
+    running: item.running === true,
+    updatedAt: intOr(item.updatedAt, 0),
+    members,
+    tasks,
+  };
+  const failure = str(at.failure, LIMITS.failureChars);
+  if (failure) team.failure = failure;
+  return team;
+}
+
+/** 全量快照。teams 按最近活动倒序，稳定排序（同时间按 sessionId）。 */
+export function buildSnapshot(items, { seq, now = Date.now(), meta = null } = {}) {
+  const list = Array.isArray(items) ? items : [];
+  const runningById = runningBySessionId(list);
+  const metaBySession = meta && typeof meta === 'object' ? meta : {};
+  const teams = [];
+  for (const item of list) {
+    // 小队只能长在普通会话上：子智能体会话不能当 Lead，也不该出现在团队列表
+    if (!item || item.origin === 'subagent') continue;
+    try {
+      const team = teamFromItem(item, runningById, metaBySession[item.sessionId] ?? null);
+      if (team) teams.push(team);
+    } catch {
+      // 单条坏数据只跳过这一条，绝不让整份快照失败（失败必须可见，但不能连累别人）
+    }
+  }
+  teams.sort((a, b) => b.updatedAt - a.updatedAt || a.sessionId.localeCompare(b.sessionId));
+  return {
+    v: PAYLOAD_VERSION,
+    seq: intOr(seq, 0),
+    asOf: intOr(now, 0),
+    teams: teams.slice(0, LIMITS.teams),
+  };
+}
+
+/**
+ * 快照指纹：只对 teams 做签名（忽略 seq/asOf）。
+ * 用途：实时事件触发的重发去重 —— 团队没变就不发，省流量也省手机重绘。
+ */
+export function snapshotSignature(snapshot) {
+  return JSON.stringify(snapshot?.teams ?? []);
+}

package/vendor/bots/contract/fixtures/team-list.json

@@ -0,0 +1,165 @@
+{
+  "_note": "合成样本：字段形状抄自 DSH SessionProjectionMap.agentTeam（v1）+ sessionController.list() 的 Session 摘要。S2 联调后把真实抓到的样本替换/补充到这里（含真实 team/member、team/task 事件）。",
+  "items": [
+    {
+      "sessionId": "session-lead-a",
+      "running": false,
+      "agentAvailable": true,
+      "blank": false,
+      "cwd": "/tmp/example-project",
+      "updatedAt": 1791700000000,
+      "origin": null,
+      "parentSessionId": null,
+      "projections": {
+        "kind": "sequenced",
+        "asOfSeq": 120,
+        "values": {
+          "title": "给鲸编程加团队功能",
+          "agentTeam": {
+            "members": [
+              { "id": "session-lead-a", "name": "lead", "role": "lead", "phase": "active" },
+              { "id": "session-member-a1", "name": "reviewer", "role": "teammate", "phase": "active" },
+              { "id": "session-member-a2", "name": "tester", "role": "teammate", "phase": "provisioning" }
+            ],
+            "tasks": [
+              {
+                "id": "task-1",
+                "revision": 3,
+                "subject": "审阅 bots/bridge/view.js 的截断逻辑",
+                "description": "重点看成员 running join 与任务截断；写一份不超过 10 条的结论。",
+                "status": "in_progress",
+                "blockedBy": [],
+                "writeScopes": ["bots/bridge/"],
+                "ownerName": "reviewer",
+                "ready": true,
+                "writeScopeWarnings": []
+              },
+              {
+                "id": "task-2",
+                "revision": 1,
+                "subject": "补 payload 契约测试",
+                "description": "覆盖 v/seq/teams 形状与上限。",
+                "status": "pending",
+                "blockedBy": ["task-1"],
+                "writeScopes": ["bots/test/"],
+                "ownerName": "tester",
+                "ready": false,
+                "writeScopeWarnings": []
+              },
+              {
+                "id": "task-3",
+                "revision": 4,
+                "subject": "跑基线 115 条回归",
+                "description": "node test/run.mjs 必须全绿。",
+                "status": "completed",
+                "blockedBy": [],
+                "writeScopes": [],
+                "ownerName": "lead",
+                "ready": true,
+                "writeScopeWarnings": []
+              },
+              {
+                "id": "task-4",
+                "revision": 2,
+                "subject": "已删除的任务不应下发",
+                "status": "deleted",
+                "blockedBy": [],
+                "writeScopes": [],
+                "ready": false,
+                "writeScopeWarnings": []
+              }
+            ]
+          }
+        }
+      }
+    },
+    {
+      "sessionId": "session-member-a1",
+      "running": true,
+      "agentAvailable": true,
+      "blank": false,
+      "cwd": "/tmp/example-project",
+      "updatedAt": 1791700001000,
+      "origin": "subagent",
+      "parentSessionId": "session-lead-a",
+      "projections": { "values": {} }
+    },
+    {
+      "sessionId": "session-member-a2",
+      "running": false,
+      "agentAvailable": false,
+      "blank": false,
+      "cwd": "/tmp/example-project",
+      "updatedAt": 1791700001500,
+      "origin": "subagent",
+      "parentSessionId": "session-lead-a",
+      "projections": { "values": {} }
+    },
+    {
+      "sessionId": "session-lead-b",
+      "running": true,
+      "agentAvailable": true,
+      "blank": false,
+      "cwd": "/Users/example/project",
+      "updatedAt": 1791700002000,
+      "origin": null,
+      "parentSessionId": null,
+      "projections": {
+        "kind": "sequenced",
+        "asOfSeq": 40,
+        "values": {
+          "title": "示例项目 · 检查更新浮层",
+          "agentTeam": {
+            "members": [
+              { "id": "session-lead-b", "name": "lead", "role": "lead", "phase": "active" },
+              { "id": "session-member-b1", "name": "coder", "role": "teammate", "phase": "failed", "error": "spawn 超时：provider 未在 30s 内返回 child" }
+            ],
+            "tasks": [],
+            "failure": "持久 Team 记录被拒绝：TEAM_TASK_STALE_REVISION"
+          }
+        }
+      }
+    },
+    {
+      "sessionId": "session-member-b1",
+      "running": false,
+      "agentAvailable": false,
+      "blank": false,
+      "cwd": "/Users/example/project",
+      "updatedAt": 1791700003000,
+      "origin": "subagent",
+      "parentSessionId": "session-lead-b",
+      "projections": { "values": {} }
+    },
+    {
+      "sessionId": "session-plain",
+      "running": false,
+      "agentAvailable": true,
+      "blank": false,
+      "cwd": "/tmp/example-project",
+      "updatedAt": 1791700004000,
+      "origin": null,
+      "parentSessionId": null,
+      "projections": { "values": { "title": "普通聊天：没有小队" } }
+    },
+    {
+      "sessionId": "session-lead-c",
+      "running": false,
+      "agentAvailable": true,
+      "blank": false,
+      "cwd": "/tmp",
+      "updatedAt": 1791700005000,
+      "origin": null,
+      "parentSessionId": null,
+      "projections": {
+        "values": {
+          "title": "只有 Lead、没有任务",
+          "agentTeam": {
+            "members": [{ "id": "session-lead-c", "name": "lead", "role": "lead", "phase": "active" }],
+            "tasks": []
+          }
+        }
+      }
+    }
+  ]
+}

package/vendor/bots/contract/teams.schema.json

@@ -0,0 +1,78 @@
+{
+  "name": "bots-teams",
+  "version": 1,
+  "description": "BOTS 帧（0x2B）载荷契约。字段语义与上限的事实来源；与 bots/bridge/view.js 的 LIMITS 由测试断言一致。",
+  "frames": {
+    "BOTS": "0x2B",
+    "BOTS_REFRESH": "0x2C",
+    "BOTS_META": "0x2D"
+  },
+  "limits": {
+    "teams": 20,
+    "membersPerTeam": 16,
+    "tasksPerTeam": 200,
+    "subjectChars": 120,
+    "descriptionChars": 300,
+    "failureChars": 500,
+    "errorChars": 300,
+    "writeScopes": 20,
+    "writeScopeChars": 100,
+    "blockedBy": 20,
+    "warnings": 20,
+    "warningChars": 120,
+    "nameChars": 80,
+    "cwdChars": 300,
+    "labelChars": 40
+  },
+  "payload": {
+    "v": "integer，载荷版本（当前 1）",
+    "seq": "integer，每条连接内单调递增；手机按 seq 丢弃过期快照",
+    "asOf": "epoch 毫秒，快照生成时刻",
+    "teams": [
+      {
+        "sessionId": "string，Lead 会话 id（TeamId === SessionId）",
+        "name": "string，Lead 会话标题，缺失退 cwd 末段，再退「未命名小队」",
+        "cwd": "string，共享工作目录",
+        "running": "boolean，Lead 会话是否有轮次在跑",
+        "updatedAt": "integer，epoch 毫秒",
+        "members": [
+          {
+            "name": "string，团队内唯一名字（DSH 保证不复用）",
+            "role": "lead | teammate",
+            "phase": "active | provisioning | failed",
+            "running": "boolean，该成员自己的会话当前是否有轮次在跑",
+            "error": "string?，phase=failed 时的原因",
+            "sessionId": "string?，成员会话 id（用于和子 Agent 会话对齐）",
+            "displayName": "string?，中文显示名（电脑侧别名表，BOTS_META 上传）；缺失时 UI 用 name"
+          }
+        ],
+        "tasks": [
+          {
+            "id": "string，形如 task-1",
+            "revision": "integer，CAS 版本；手机按 revision 丢弃旧编辑结果",
+            "subject": "string",
+            "description": "string?",
+            "status": "pending | in_progress | completed（deleted 不下发）",
+            "ownerName": "string?，成员 target 名（与 members[].name 对齐）",
+            "ready": "boolean，依赖是否全部完成（可 claim）",
+            "blockedBy": [
+              "string，task id"
+            ],
+            "writeScopes": [
+              "string，workspace 相对路径前缀（仅提示，不强制）"
+            ],
+            "writeScopeWarnings": [
+              "string，与进行中任务写作用域重叠的警告"
+            ]
+          }
+        ],
+        "failure": "string?，投影报告的最后一条持久 Team 记录失败原因"
+      }
+    ]
+  },
+  "compatibility": {
+    "oldApp": "不认识 0x2B 的客户端会忽略；插件只在 bots 模块启用时发送",
+    "oldBridge": "HELLO 不带 caps:[bots]；新 App 显示「电脑侧插件需更新」",
+    "unknownFields": "两端解析都必须忽略未知字段（只做加法）"
+  }
+}