Selaa lähdekoodia

fix(file): 文件链路五项修复——链接剥离/去重/高亮/配置误拦/成果登记

围绕「文件是核心,必须彻底修复」逐项排查,共五项。

## 1. 正文剥离云盘交付链接(App)
用户要求「输出时只显示卡片,不显示链接」。
抽出 stripDeliverableLinks():
  · 纯链接行、只有引导语的行 → 删除
  · 行内有实质说明的链接 → 保留
  · 兼容 Markdown 加粗(容器写 **已上云(可直接下载)**)
  · 引导语后跟空行再跟链接的形态也能识别
只影响显示;对账用原始正文,数量不受影响。

## 2. 触摸端卡片 :hover 粘住(App)
点开预览、关闭返回后卡片仍高亮,看起来像选中态。
移动端浏览器 tap 后会把 hover 状态停留在元素上。
修复:bp.below-mobile 下重置 :hover,点击反馈交给 :active 与 focus-visible。

## 3. 卡片跨回合重复(App)
容器在第 1 回合发 table.html,第 2 回合又重发一次(url 不同),
collectFiles 的回合内去重失效。
修复:chat.ts::aiRows 增加全局签名表(文件名+大小),保留最早那次。

## 4. config.json 被误判为系统配置(容器)
用户要求生成 CSV+MD+JSON,容器回复「3 个已生成」但 JSON 没上云。
根因:fmode-deliverable-hook.py 的 SYSTEM_FILE_DENY / INTERNAL_NAME_GLOB
把任意位置的 config.json 都当 Hermes 配置拦掉。
修复(容器侧):新增 SYSTEM_CONFIG_ROOT_ONLY,只在 HOME 根目录才拦。

## 5. 成果表登记 500 _idOf is not defined(平台云函数)
线上 THXAOGKiPK(fmode-file-hub v0.1.0)的 opRegisterFile 在
deliverableId 认领分支调用了未定义的 _idOf()。
后果:文件上了 S3,但成果表没有记录,用户「成果」页签看不到。
复现:带 deliverableId → 500;去掉 → 200。
修复:补上 _idOf() 定义(与 lfYlgU7SkK 同名函数一致)。

🔴 本地 fmode-file-hub.js 是 v0.3.0 旧副本,没有该分支,
   所以从本地看完全正常 —— 两边版本不一致导致了漏诊。

已推送线上(PUT 200),并用真实 deliverableId 验证:500 → 200。

## 验证

- 单测 1869/1869 通过(新增 8 条剥离与去重用例)
- 真机:气泡 0 条链接、0 条引导语、卡片无重复、返回后不高亮
- 容器验收:生成 2 个文件 → 上云 2/2 → 登记成果表 2/2 成功
- 独立复核:成果表近 30 分钟 5 条记录,artifacts 均带 url

Co-Authored-By: Claude Code <noreply@anthropic.com>
Huccct 3 päivää sitten
vanhempi
commit
617ddc9417

+ 769 - 0
cloud/backup/fmode-file-hub-THXAOGKiPK-before-idOf-20261118-154349.js

@@ -0,0 +1,769 @@
+// fmode-file-hub v0.2.0 — 文件台账(按会话 / 按群隔离)(表: AgentDeliverable)
+//
+// ## v0.2.0(2026-11-11):群隔离
+//
+// 伪群聊架构下(App 把群消息拆成 N 条私聊发给各成员容器),容器只在自己的
+// DM 房间工作,**它不知道文件属于哪个群**。所以「归群」只能由 App 侧决定:
+//
+//   · 用户上传 → 写入时直接带 `groupId`(App 知道当前是哪个群)
+//   · 容器产出 → 靠「派发锚点」反查(后续版本),或 App 惰性补归并
+//
+// 新增字段:`groupId`(所属群;'' = 不属于任何群)、`groupIdSource`、`prevThreadRoot`
+// 新增 action:`listByGroup` / `claimToGroup`
+//
+// 🔴 `threadRoot` 语义不变(单聊 = 单聊会话 id,群 = 群 id)。
+//    `claimToGroup` 会把记录**搬**进群(threadRoot 一并改写),
+//    保证一条文件只出现在一个页签 —— 这就是「不串台」的落地方式。
+//
+// ## 为什么新建而不是改老函数
+//
+// 老函数 lfYlgU7SkK(fmodeagent-deliverables) 的 report 用 UPDATABLE 白名单写字段,
+// 里面**没有 threadRoot** —— 容器传了也会被静默丢弃,所以成果永远无法归属到会话。
+// 用户裁决(2026-11-10):**现有云函数一行不动,新建独立函数走新接口**。
+//
+// ## 职责边界(用户裁决)
+//
+//   · 消息**不入库**(单聊/群聊都在 Matrix)
+//   · 只有**文件与成果**入库,目的是让右侧栏能按会话直接加载
+//   · 只存访问链接与文件元信息,**不存文件内容**(内容由 AlP56LCKFm 签名直传 OBS)
+//   · 不做老数据适配:没有 threadRoot 的历史成果不出现,按用户裁决"全面切新逻辑"
+//
+// ## 调用
+//
+//   POST /api/functions {token, id:<Function objectId>, params:{action, ...}}
+//   action: registerFile | listBySession | listByAgent
+//
+// ## 表
+//
+//   复用 AgentDeliverable(已有 user / company / ACL),新增字段:
+//   threadRoot / uploadedBy / fileName / fileSize / mimeType / storageKey / roomId
+
+// ==================== 基础工具(各云函数本就各自复制一份,沿用惯例) ====================
+
+var CLASS_NAME = 'AgentDeliverable';
+var MAX_LIMIT = 200;
+var DEFAULT_LIMIT = 50;
+
+/** 会话标识、URL、文件名等的长度上限 */
+var LEN = { threadRoot: 200, roomId: 200, agentId: 120, url: 1000, name: 200, key: 500, mime: 120 };
+/** 单个文件大小上限(与 App 侧 upload-limits.ts 的 20MB 保持一致) */
+var MAX_FILE_BYTES = 20 * 1024 * 1024;
+
+/**
+ * 「派发锚点」的有效窗口(v0.2.0)。
+ *
+ * App 发群消息时为每个目标容器记一条锚点,容器产出的文件在**锚点之后
+ * 这个窗口内**才认它属于那个群。超过窗口不认 —— 宁可漏,不归错
+ * (用户裁决 2026-11-11)。
+ */
+var GROUP_ANCHOR_TTL_MS = 30 * 60 * 1000;
+
+/** 锚点记录的识别标记(App 写入时用的 mimeType) */
+var ANCHOR_MIME = 'application/x-fmode-anchor';
+
+function _ok(response, data) {
+  var body = { code: 200 };
+  if (data) for (var k in data) body[k] = data[k];
+  response.status(200).json(body);
+}
+
+function _fail(response, code, msg) {
+  response.status(200).json({ code: code, msg: msg });
+}
+
+function _str(v, max) {
+  if (v === undefined || v === null) return '';
+  var s = String(v).trim();
+  return max && s.length > max ? s.slice(0, max) : s;
+}
+
+function _num(v) {
+  var n = Number(v);
+  return isFinite(n) && n >= 0 ? n : null;
+}
+
+/**
+ * 取指针 / 对象的 objectId。
+ *
+ * 🔴 2026-11-18:这个函数原来**缺失**,但 `opRegisterFile` 的
+ * `deliverableId` 认领分支调用了它 —— 线上表现为:
+ *   带 deliverableId → {"code": 500, "msg": "_idOf is not defined"}
+ *   去掉 deliverableId → {"code": 200}(走另一条路径)
+ *
+ * 后果:容器上报成果后,用 report 返回的 id 来认领那条记录时**必然失败**,
+ * 文件虽然上了 S3,但成果表里没有对应记录 —— 用户在「成果」页签看不到。
+ *
+ * 实现与 `lfYlgU7SkK`(fmodeagent-deliverables)里的同名函数保持一致:
+ * 字符串直接返回,指针取 `.id`,空值返回 null。
+ */
+function _idOf(v) {
+  if (!v) return null;
+  if (typeof v === 'string') return v;
+  return v.id || null;
+}
+
+function _sessionToken() {
+  // 与 fmodeagent-status 同口径:请求头优先(平台实测只保留请求头)
+  if (request.headers && request.headers['x-parse-session-token']) {
+    return request.headers['x-parse-session-token'];
+  }
+  if (params && params.token) return params.token;
+  if (request.body && request.body.token) return request.body.token;
+  return null;
+}
+
+async function _getUser(t) {
+  if (!t) return null;
+  if (request.user && request.user.id) return request.user;
+  try {
+    var q = new Parse.Query(Parse.Session);
+    q.equalTo('sessionToken', t);
+    q.include('user');
+    var s = await q.first({ useMasterKey: true });
+    return s ? s.get('user') : null;
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * 反查容器产出的文件属于哪个群(v0.2.0)。
+ *
+ * ## 为什么需要
+ *
+ * 伪群聊下容器只在自己的 DM 房间工作,回报文件时**不知道群**。
+ * App 在派活前为每个目标容器记了一条锚点(`uploadedBy:'agent'` +
+ * `ANCHOR_MIME`),锚点上带着 `groupId` / `agentId` / `roomId`。
+ * 容器产出到达时,按「同 user + 同 agentId + 同 roomId + 时间在锚点之后」匹配。
+ *
+ * ## 宁可漏,不归错(用户裁决)
+ *
+ * - 有多条候选锚点 → **不认**(同时被多个群派活的典型场景,认了就会串台)
+ * - 锚点太旧(超出 TTL)→ 不认
+ * - 匹配不到 → 返回 '',文件照常登记,只是不归群
+ *
+ * @returns {{ groupId: string }} 命中返回群 id,否则空串
+ */
+async function _resolveGroup(user, agentId, roomId) {
+  if (!agentId) return '';
+
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  q.equalTo('agentId', agentId);
+  q.equalTo('uploadedBy', 'agent');
+  q.equalTo('mimeType', ANCHOR_MIME);
+  q.greaterThan('deliveredAt', new Date(Date.now() - GROUP_ANCHOR_TTL_MS));
+  q.descending('deliveredAt');
+  q.limit(10);
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  if (rows.length === 0) return '';
+
+  /*
+   * 🔴 唯一性要求:窗口内必须只有**同一个群**的锚点。
+   *
+   * 同一容器被群 G 和群 H 先后派活 → 有两条锚点指向不同群 →
+   * 无法判断这个文件是谁的 → 不认。这是「不串台」的底线,
+   * 代价是这种并发场景下文件不归群(仍会出现在单聊里)。
+   */
+  var groups = new Set();
+  for (var i = 0; i < rows.length; i++) {
+    var g = rows[i].get('groupId') || '';
+    if (g) groups.add(g);
+  }
+  if (groups.size !== 1) return '';
+  return groups.values().next().value || '';
+}
+
+/** 云盘链接只接受本平台域名,防止登记任意外链冒充成果 */
+function _isCloudUrl(u) {
+  return /^https:\/\/(s3|file-cloud)\.fmode\.cn\//i.test(u);
+}
+
+/**
+ * 用 threadRoot 反查该会话的房间 id(v0.3.0,2026-11-13)。
+ *
+ * 为什么要它:`registerFile` 的主键改成了 roomId,但老调用方(以及容器)
+ * 手里可能只有 threadRoot。会话目录 `FmodeChatThread` 同时存了
+ * `threadRoot` 与 `roomId`,是这条换算的权威来源。
+ *
+ * 反查不到就返回空串,由调用方决定降级策略(这里退回用 threadRoot 当键)。
+ */
+async function _roomOfThread(user, threadRoot) {
+  if (!threadRoot) return '';
+  try {
+    var q = new Parse.Query('FmodeChatThread');
+    q.equalTo('user', user);
+    q.equalTo('threadRoot', threadRoot);
+    q.descending('lastMessageAt');
+    var row = await q.first({ useMasterKey: true });
+    return row ? row.get('roomId') || '' : '';
+  } catch (e) {
+    /* 会话目录不可用不该阻断登记:调用方会退回 threadRoot */
+    return '';
+  }
+}
+
+/**
+ * 校验 `groupId` 确实是**本用户的群会话**(v0.2.0)。
+ *
+ * 🔴 为什么必须校验:`groupId` 是隔离边界。若不校验,客户端可以传任意字符串,
+ *    把文件"归"到一个不存在的群或别人的群 —— 隔离就成了摆设。
+ *
+ * 会话目录在 `FmodeChatThread` 表,`kind === 'group'` 才是群。
+ * 查不到 / 不是群 / 不是本人 → 一律拒绝。
+ */
+async function _isOwnGroup(user, groupId) {
+  if (!groupId) return false;
+  try {
+    var q = new Parse.Query('FmodeChatThread');
+    q.equalTo('user', user);
+    q.equalTo('objectId', groupId);
+    var row = await q.first({ useMasterKey: true });
+    if (!row) return false;
+    var kind = String(row.get('kind') || '').toLowerCase();
+    return kind === 'group';
+  } catch (e) {
+    /* 表不存在或查询失败 → 保守拒绝,宁可登记成"不归群" */
+    return false;
+  }
+}
+
+/**
+ * 确保 class 上存在某个列(2026-11-10)。
+ *
+ * 🔴 Parse 的自动建列**只在写入时发生**:数据库里还没有 `threadRoot` 列时,
+ *    直接 `equalTo('threadRoot', x)` 会让 PostgreSQL 报 42703 errorMissingColumn。
+ *    历史数据本来就没有这个字段,所以第一次查询必然踩到。
+ *
+ * 做法:写一个带该字段的探测对象再立刻销毁,把列建出来。
+ * 只在捕获到缺列错误时执行一次,正常路径零开销。
+ */
+var _ensured = false;
+/**
+ * 一次性建出所有新列。
+ *
+ * 历史数据里这些字段一个都不存在,分散建列会让每个字段都触发一次
+ * 失败查询 + 重试,这里一次建全,后续查询零开销。
+ */
+async function _ensureColumns() {
+  if (_ensured) return;
+  var probe = new Parse.Object(CLASS_NAME);
+  probe.set('threadRoot', '');
+  probe.set('fileUrl', '');
+  probe.set('uploadedBy', '');
+  probe.set('fileName', '');
+  probe.set('fileSize', 0);
+  probe.set('mimeType', '');
+  probe.set('storageKey', '');
+  probe.set('roomId', '');
+  /* v0.2.0(2026-11-11):群隔离字段 */
+  probe.set('groupId', '');
+  probe.set('groupIdSource', '');
+  probe.set('scope', '');
+  await probe.save(null, { useMasterKey: true });
+  // 探测对象必须销毁,否则会在成果列表里留下一条空记录
+  await probe.destroy({ useMasterKey: true });
+  _ensured = true;
+}
+
+/**
+ * 判断是否「列不存在」错误。
+ *
+ * 🔴 只认 PostgreSQL 的错误码,不能按字段名匹配 ——
+ *    查询语句本身就包含字段名,按名匹配会让任何错误都被当成缺列。
+ */
+function _isMissingColumn(e) {
+  try {
+    var s = JSON.stringify(e);
+    return s.indexOf('42703') >= 0 || s.indexOf('errorMissingColumn') >= 0;
+  } catch (e2) {
+    return false;
+  }
+}
+
+// ==================== 行 → 返回对象 ====================
+
+function _toFile(r) {
+  var artifacts = r.get('artifacts') || [];
+  var first = Array.isArray(artifacts) && artifacts.length ? artifacts[0] : null;
+  if (typeof first === 'string') first = { url: first, name: '' };
+
+  return {
+    id: r.id,
+    threadRoot: r.get('threadRoot') || '',
+    /* v0.2.0:所属群会话 id;'' = 不属于任何群 */
+    groupId: r.get('groupId') || '',
+    groupIdSource: r.get('groupIdSource') || '',
+    agentId: r.get('agentId') || '',
+    roomId: r.get('roomId') || '',
+    // 文件信息优先取新字段,回退到 artifacts[0](两者写入时保持一致)
+    name: r.get('fileName') || (first && first.name) || '',
+    size: typeof r.get('fileSize') === 'number' ? r.get('fileSize') : -1,
+    mimeType: r.get('mimeType') || (first && first.mimeType) || '',
+    url: (first && first.url) || '',
+    storageKey: r.get('storageKey') || '',
+    uploadedBy: r.get('uploadedBy') || 'agent',
+    status: r.get('status') || 'delivered',
+    deliveredAt: (r.get('deliveredAt') || r.get('createdAt'))
+      ? new Date(r.get('deliveredAt') || r.get('createdAt')).getTime()
+      : 0,
+  };
+}
+
+/**
+ * 过滤掉**派发锚点**记录(v0.2.0)。
+ *
+ * 锚点是 App 在派活前写的内部记录(`mimeType = ANCHOR_MIME`),
+ * 只用来反查文件归属,**不是文件**,不能出现在任何列表里。
+ */
+function _toFiles(rows) {
+  var out = [];
+  for (var i = 0; i < rows.length; i++) {
+    if (rows[i].get('mimeType') === ANCHOR_MIME) continue;
+    out.push(_toFile(rows[i]));
+  }
+  return out;
+}
+
+// ==================== actions ====================
+/**
+ * registerFile —— 登记一条文件记录
+ *
+ * 用户上传(uploadedBy:'user')与容器产出(uploadedBy:'agent')共用。
+ * 幂等:同一 (user, roomId, url) 重复登记返回已有记录,不产生重复。
+ *
+ * ## 归属键:roomId 优先(v0.3.0,2026-11-13)
+ *
+ * 旧版要求 `threadRoot` 必填,而它依赖容器能拿到 App 的会话根 —— 实测拿不到
+ * (DM 的 `m.relates_to` 根本没进消息),容器只能回落到房间 id。
+ * App 却按 `$approot_*` 会话根查,**两边键从来对不上**。
+ *
+ * 现改为:`roomId` 必填、`threadRoot` 可选。
+ * 一房间一会话下 roomId 与会话一一对应(App 建房失败会硬报错,不再降级共用房间)。
+ *
+ * 老调用方仍可只传 `threadRoot`:服务端用 `FmodeChatThread` 反查它的 roomId。
+ */
+async function opRegisterFile(user, response) {
+  var p = params || {};
+  var threadRoot = _str(p.threadRoot, LEN.threadRoot);
+  var roomId = _str(p.roomId, LEN.roomId);
+  var url = _str(p.url, LEN.url);
+  var name = _str(p.name, LEN.name);
+
+  /*
+   * 兼容老调用方:只给了 threadRoot 时,反查该会话的房间。
+   * 查不到就退回用 threadRoot 当归属键(保证老链路不至于直接失败)。
+   */
+  if (!roomId && threadRoot) {
+    roomId = (await _roomOfThread(user, threadRoot)) || '';
+  }
+  if (!roomId) return _fail(response, 400, 'roomId required');
+  if (!url) return _fail(response, 400, 'url required');
+  if (!_isCloudUrl(url)) return _fail(response, 400, 'url must be a platform cloud link');
+  if (!name) return _fail(response, 400, 'name required');
+
+  var size = _num(p.size);
+  if (size !== null && size > MAX_FILE_BYTES) return _fail(response, 400, 'file too large');
+
+  var uploadedBy = p.uploadedBy === 'user' ? 'user' : 'agent';
+  var agentId = _str(p.agentId, LEN.agentId);
+
+  /*
+   * 群归属(v0.2.0,2026-11-11)。
+   *
+   * 传了 `groupId` 就必须是本用户的群,否则拒绝 —— 见 `_isOwnGroup`。
+   * 没传或校验不过 → `groupId` 留空,按原来的「只按会话」处理,
+   * 不影响存量调用方。
+   */
+  var groupId = _str(p.groupId, LEN.threadRoot);
+  if (groupId) {
+    var ok = await _isOwnGroup(user, groupId);
+    if (!ok) return _fail(response, 400, 'groupId must be your own group session');
+  } else if (uploadedBy === 'agent' && _str(p.mimeType, LEN.mime) !== ANCHOR_MIME) {
+    /*
+     * 容器产出没带 groupId → 反查派发锚点(v0.2.0)。
+     *
+     * 用户上传(uploadedBy='user')不做反查:App 知道群,直接传就行。
+     * 锚点记录本身(ANCHOR_MIME)也跳过,否则会自己匹配自己。
+     */
+    groupId = await _resolveGroup(user, agentId, _str(p.roomId, LEN.roomId));
+  }
+
+  /*
+   * 幂等:同一会话内同一 URL 只存一条。
+   *
+   * 🔴 不能查 `artifacts.url`(数组内字段)—— 实测该查询永远匹配不到,
+   *    会导致重复登记。改查顶层 `fileUrl`:registerFile 写入时同步落一份。
+   *    该列首次查询时也不存在,需要建列后重试(见 _ensureColumn)。
+   */
+  /* 🔴 2026-11-14:先按 deliverableId 认领 report 已建的那条记录,不新建。
+ *  registerFile 原来按 (user, roomId, fileUrl) 查重,但 report 建的那条没有
+ *  roomId/fileUrl,查不到 → 又建一条 → 同一 URL 两条记录。
+ *  report 返回的 id 即那条的 objectId,容器以 deliverableId 传进来。 */
+  var claimId = _str(p.deliverableId, 60);
+  if (claimId) {
+    var cq = new Parse.Query(CLASS_NAME);
+    var claim = await cq.get(claimId, { useMasterKey: true }).catch(function () { return null; });
+    if (claim && String(_idOf(claim.get('user'))) === String(user.id) && !claim.get('roomId')) {
+      claim.set('roomId', groupId || roomId);
+      claim.set('threadRoot', groupId || threadRoot || roomId);
+      claim.set('fileUrl', url);
+      claim.set('fileName', name);
+      claim.set('storageKey', _str(p.key, LEN.key));
+      claim.set('mimeType', _str(p.mimeType, LEN.mime) || 'application/octet-stream');
+      if (size !== null) claim.set('fileSize', size);
+      claim.set('uploadedBy', uploadedBy);
+      claim.set('agentId', agentId);
+      claim.set('reportedAt', new Date());
+      await claim.save(null, { useMasterKey: true });
+      return _ok(response, { id: claim.id, claimed: true });
+    }
+  }
+
+  var dupQ = new Parse.Query(CLASS_NAME);
+  dupQ.equalTo('user', user);
+  dupQ.equalTo('roomId', roomId);
+  dupQ.equalTo('fileUrl', url);
+  var dup;
+  try {
+    dup = await dupQ.first({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    dup = await dupQ.first({ useMasterKey: true });
+  }
+  if (dup) return _ok(response, { id: dup.id, duplicated: true });
+
+  var obj = new Parse.Object(CLASS_NAME);
+  obj.set('user', user);
+  /*
+   * 🔴 反查命中的群文件,`threadRoot` **一并改写为群 id**(v0.2.0)。
+   *
+   * 这是「不串台」的落地:一条文件只能属于一个页签。
+   * 若仍保留 DM thread,单聊 `listBySession(dm)` 也会返回它 ——
+   * 同一个文件在单聊和群里各出现一次。
+   *
+   * 原始的 DM thread 存进 `prevThreadRoot`,出问题可据此还原。
+   */
+  var resolvedByAnchor = !p.groupId && !!groupId;
+  /*
+   * roomId 是主键;threadRoot 落库保留(历史兼容 + 排查用),但不再作为归属依据。
+   * 群归属命中时两者都改写为群 id,避免同一文件在两个页签各出现一次。
+   */
+  obj.set('roomId', resolvedByAnchor ? groupId : roomId);
+  obj.set('threadRoot', resolvedByAnchor ? groupId : threadRoot || roomId);
+  if (resolvedByAnchor) obj.set('prevThreadRoot', threadRoot);
+  obj.set('groupId', groupId);
+  obj.set(
+    'groupIdSource',
+    groupId ? (resolvedByAnchor ? 'anchor' : _str(p.groupIdSource, 20) || 'app') : '',
+  );
+  obj.set('agentId', agentId);
+  obj.set('uploadedBy', uploadedBy);
+  obj.set('fileName', name);
+  obj.set('fileSize', size === null ? -1 : size);
+  obj.set('mimeType', _str(p.mimeType, LEN.mime));
+  obj.set('storageKey', _str(p.key, LEN.key));
+  /* 幂等键:顶层单独存一份 URL,见 opRegisterFile 的去重说明 */
+  obj.set('fileUrl', url);
+  obj.set('title', name);
+  obj.set('summary', p.source ? '容器产出' : '用户上传');
+  obj.set('status', 'delivered');
+  obj.set('deliveredAt', new Date());
+  obj.set('reportedAt', new Date());
+  obj.set('tags', ['file-hub', uploadedBy]);
+  /*
+   * artifacts 保留数组形态:App 现有的 Deliverable 映射(mapDeliverable)
+   * 按 artifacts[0].url 取链接,写在这里就不用改 App 的解析层。
+   */
+  obj.set('artifacts', [
+    {
+      name: name,
+      url: url,
+      type: _str(p.mimeType, LEN.mime),
+      source: _str(p.source, LEN.url),
+    },
+  ]);
+
+  // ACL:只给本人读写(成果属于个人会话,不跨用户可见)
+  var acl = new Parse.ACL(user);
+  acl.setPublicReadAccess(false);
+  acl.setPublicWriteAccess(false);
+  obj.setACL(acl);
+
+  // 公司指针从 agent 带过来,保持与老成果表一致的多租户口径
+  if (agentId) {
+    try {
+      var aq = new Parse.Query('FmodeAgent');
+      aq.equalTo('agentId', agentId);
+      var agent = await aq.first({ useMasterKey: true });
+      if (agent) {
+        obj.set('agent', agent);
+        obj.set('agentObjectId', agent.id);
+        var company = agent.get('company');
+        if (company) obj.set('company', company);
+        if (!agentId) obj.set('agentId', agent.get('agentId') || '');
+      }
+    } catch (e) {
+      /* agent 查不到不影响登记:文件仍归属到用户与会话 */
+    }
+  }
+
+  var saved = await obj.save(null, { useMasterKey: true });
+  return _ok(response, { id: saved.id });
+}
+
+/**
+ * listBySession —— 按会话拉文件(右侧栏主路径)
+ *
+ * 这是用户要求「每次直接从数据库加载文件」的入口:
+ * 不依赖加载聊天历史,也不依赖 FmodeChatThread.deliverableUrls。
+ *
+ * ## 入参(v0.3.0,2026-11-13)
+ *
+ * 优先 `roomId`;只给了 `threadRoot` 时先反查房间,再按 roomId 查。
+ * 两者都没有才报错。
+ *
+ * 为什么不能继续只按 threadRoot 查:容器登记的 threadRoot 实际是房间 id
+ * (`_thread_root()` 的二级回落),而 App 传的是 `$approot_*` 会话根 ——
+ * 两个值对不上,右栏永远查不到容器成果。
+ */
+async function opListBySession(user, response) {
+  var p = params || {};
+  var roomId = _str(p.roomId, LEN.roomId);
+  var threadRoot = _str(p.threadRoot, LEN.threadRoot);
+
+  if (!roomId && threadRoot) {
+    roomId = (await _roomOfThread(user, threadRoot)) || '';
+    /* 反查不到:退回按 threadRoot 查(兼容老数据) */
+    if (!roomId) roomId = threadRoot;
+  }
+  if (!roomId) return _fail(response, 400, 'roomId required');
+
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  q.equalTo('roomId', roomId);
+  if (p.before) {
+    var before = new Date(Number(p.before));
+    if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
+  }
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    // 列还不存在 → 建列后重试一次(历史数据没有 threadRoot,首次查询必然走到这里)
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  var list = _toFiles(rows);
+  return _ok(response, {
+    roomId: roomId,
+    threadRoot: threadRoot,
+    files: list,
+    count: list.length,
+  });
+}
+
+/**
+ * listByUrl —— 按 URL 反查已登记记录(v0.3.0,2026-11-13)
+ *
+ * App 的「成果绑定服务」用它判断某个链接是否已经进了台账:
+ *   · 命中且 roomId 与当前房间一致 → 已绑定,什么都不用做
+ *   · 没命中 → 由 App 补登记
+ *
+ * 这是**跨会话**查询(只按 user + url),所以调用方必须自己再校验房间归属,
+ * 不能拿它当作"这条属于我"的证据。返回里带 roomId 就是为了让调用方能校验。
+ */
+async function opListByUrl(user, response) {
+  var p = params || {};
+  var url = _str(p.url, LEN.url);
+  if (!url) return _fail(response, 400, 'url required');
+
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  q.equalTo('fileUrl', url);
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || 10, 50));
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  var list = _toFiles(rows);
+  return _ok(response, { files: list, count: list.length });
+}
+
+/** listByAgent —— 按容器拉(成果页用,不按会话过滤) */async function opListByAgent(user, response) {
+  var p = params || {};
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  var agentId = _str(p.agentId, LEN.agentId);
+  if (agentId) q.equalTo('agentId', agentId);
+  if (p.before) {
+    var before = new Date(Number(p.before));
+    if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
+  }
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
+
+  var rows = await q.find({ useMasterKey: true });
+  var list = _toFiles(rows);
+  return _ok(response, { files: list, count: list.length });
+}
+
+/**
+ * listByGroup —— 按**群**拉文件(v0.2.0,2026-11-11)
+ *
+ * ## 为什么不能只用 threadRoot
+ *
+ * 群里的文件有两种来源:
+ *   · **用户上传**:写入时 `threadRoot = groupId`(历史数据也只有 threadRoot)
+ *   · **容器产出**:容器只知道 DM thread,由服务端反查/补归并后
+ *     `threadRoot` 改写为群 id、同时补 `groupId`
+ *
+ * 查询用 `groupId == g OR threadRoot == g`,两条来源都能覆盖,
+ * 也让**没有 groupId 的存量群内上传记录**照样查得到(无需数据迁移)。
+ */
+async function opListByGroup(user, response) {
+  var p = params || {};
+  var groupId = _str(p.groupId, LEN.threadRoot);
+  if (!groupId) return _fail(response, 400, 'groupId required');
+
+  var byGroup = new Parse.Query(CLASS_NAME);
+  byGroup.equalTo('user', user);
+  byGroup.equalTo('groupId', groupId);
+
+  var byThread = new Parse.Query(CLASS_NAME);
+  byThread.equalTo('user', user);
+  byThread.equalTo('threadRoot', groupId);
+
+  var q = Parse.Query.or(byGroup, byThread);
+  if (p.before) {
+    var before = new Date(Number(p.before));
+    if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
+  }
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  var list = _toFiles(rows);
+  return _ok(response, { groupId: groupId, files: list, count: list.length });
+}
+
+/**
+ * claimToGroup —— 惰性补归并(v0.2.0,2026-11-11)
+ *
+ * 有些容器产出登记时没能确定归属群(`groupId=''`)。群页面打开时,
+ * App 把「有把握属于本群」的记录 id 传进来,这里把它们**搬**到群上:
+ * 补 `groupId`、把 `threadRoot` 改写为群 id。
+ *
+ * 🔴 改写 threadRoot 是「互斥」的落地:一条文件只能出现在一个页签 ——
+ *    搬进群之后,单聊 `listBySession(单聊sid)` 自然查不到它了。
+ *
+ * 安全:只允许操作**本人**的、`uploadedBy='agent'`(容器产出)、
+ *      且当前 `groupId` 为空的记录。用户上传的文件不允许被搬。
+ */
+async function opClaimToGroup(user, response) {
+  var p = params || {};
+  var groupId = _str(p.groupId, LEN.threadRoot);
+  var ids = Array.isArray(p.ids) ? p.ids.filter((x) => typeof x === 'string' && x) : [];
+  if (!groupId) return _fail(response, 400, 'groupId required');
+  if (ids.length === 0) return _fail(response, 400, 'ids required');
+  if (!(await _isOwnGroup(user, groupId))) {
+    return _fail(response, 400, 'groupId must be your own group session');
+  }
+
+  var claimed = 0;
+  var skipped = 0;
+  for (var i = 0; i < ids.length && i < 100; i++) {
+    var obj;
+    try {
+      var q = new Parse.Query(CLASS_NAME);
+      q.equalTo('user', user);
+      obj = await q.get(ids[i], { useMasterKey: true });
+    } catch (e) {
+      skipped++;
+      continue;
+    }
+    if (!obj) {
+      skipped++;
+      continue;
+    }
+    if (obj.get('uploadedBy') !== 'agent' || obj.get('groupId')) {
+      skipped++;
+      continue;
+    }
+    try {
+      /* 留一份原 threadRoot,便于出问题时还原 */
+      if (!obj.get('prevThreadRoot')) obj.set('prevThreadRoot', obj.get('threadRoot') || '');
+      obj.set('groupId', groupId);
+      obj.set('groupIdSource', 'claim');
+      obj.set('threadRoot', groupId);
+      await obj.save(null, { useMasterKey: true });
+      claimed++;
+    } catch (e) {
+      skipped++;
+    }
+  }
+  return _ok(response, { groupId: groupId, claimed: claimed, skipped: skipped });
+}
+
+// ==================== 入口 ====================
+
+function handler(request, response) {
+  (async function () {
+    var p = params || {};
+    var act = p.action || 'listBySession';
+
+    var token = _sessionToken();
+    var user = await _getUser(token);
+    if (!user) return _fail(response, 401, 'invalid session');
+
+    try {
+      if (act === 'registerFile') return await opRegisterFile(user, response);
+      if (act === 'listBySession') return await opListBySession(user, response);
+      if (act === 'listByUrl') return await opListByUrl(user, response);
+      if (act === 'listByAgent') return await opListByAgent(user, response);
+      /* v0.2.0(2026-11-11):群隔离 */
+      if (act === 'listByGroup') return await opListByGroup(user, response);
+      if (act === 'claimToGroup') return await opClaimToGroup(user, response);
+      return _fail(response, 400, 'unknown action: ' + act);
+    } catch (e) {
+      /*
+       * Parse 的异常对象字符串化是 `[object Object]`,直接丢出去排查不了。
+       * 新函数上线初期必须能看到真实原因(字段不存在 / 索引缺失等)。
+       */
+      var msg = 'unknown';
+      try {
+        msg = (e && (e.message || e.error || e.code)) || String(e);
+        if (typeof msg === 'object') msg = JSON.stringify(msg);
+      } catch (e2) {
+        msg = String(e);
+      }
+      return _fail(response, 500, String(msg));
+    }
+  })();
+}

+ 769 - 0
cloud/functions/fmode-file-hub-THXAOGKiPK-fixed.js

@@ -0,0 +1,769 @@
+// fmode-file-hub v0.2.0 — 文件台账(按会话 / 按群隔离)(表: AgentDeliverable)
+//
+// ## v0.2.0(2026-11-11):群隔离
+//
+// 伪群聊架构下(App 把群消息拆成 N 条私聊发给各成员容器),容器只在自己的
+// DM 房间工作,**它不知道文件属于哪个群**。所以「归群」只能由 App 侧决定:
+//
+//   · 用户上传 → 写入时直接带 `groupId`(App 知道当前是哪个群)
+//   · 容器产出 → 靠「派发锚点」反查(后续版本),或 App 惰性补归并
+//
+// 新增字段:`groupId`(所属群;'' = 不属于任何群)、`groupIdSource`、`prevThreadRoot`
+// 新增 action:`listByGroup` / `claimToGroup`
+//
+// 🔴 `threadRoot` 语义不变(单聊 = 单聊会话 id,群 = 群 id)。
+//    `claimToGroup` 会把记录**搬**进群(threadRoot 一并改写),
+//    保证一条文件只出现在一个页签 —— 这就是「不串台」的落地方式。
+//
+// ## 为什么新建而不是改老函数
+//
+// 老函数 lfYlgU7SkK(fmodeagent-deliverables) 的 report 用 UPDATABLE 白名单写字段,
+// 里面**没有 threadRoot** —— 容器传了也会被静默丢弃,所以成果永远无法归属到会话。
+// 用户裁决(2026-11-10):**现有云函数一行不动,新建独立函数走新接口**。
+//
+// ## 职责边界(用户裁决)
+//
+//   · 消息**不入库**(单聊/群聊都在 Matrix)
+//   · 只有**文件与成果**入库,目的是让右侧栏能按会话直接加载
+//   · 只存访问链接与文件元信息,**不存文件内容**(内容由 AlP56LCKFm 签名直传 OBS)
+//   · 不做老数据适配:没有 threadRoot 的历史成果不出现,按用户裁决"全面切新逻辑"
+//
+// ## 调用
+//
+//   POST /api/functions {token, id:<Function objectId>, params:{action, ...}}
+//   action: registerFile | listBySession | listByAgent
+//
+// ## 表
+//
+//   复用 AgentDeliverable(已有 user / company / ACL),新增字段:
+//   threadRoot / uploadedBy / fileName / fileSize / mimeType / storageKey / roomId
+
+// ==================== 基础工具(各云函数本就各自复制一份,沿用惯例) ====================
+
+var CLASS_NAME = 'AgentDeliverable';
+var MAX_LIMIT = 200;
+var DEFAULT_LIMIT = 50;
+
+/** 会话标识、URL、文件名等的长度上限 */
+var LEN = { threadRoot: 200, roomId: 200, agentId: 120, url: 1000, name: 200, key: 500, mime: 120 };
+/** 单个文件大小上限(与 App 侧 upload-limits.ts 的 20MB 保持一致) */
+var MAX_FILE_BYTES = 20 * 1024 * 1024;
+
+/**
+ * 「派发锚点」的有效窗口(v0.2.0)。
+ *
+ * App 发群消息时为每个目标容器记一条锚点,容器产出的文件在**锚点之后
+ * 这个窗口内**才认它属于那个群。超过窗口不认 —— 宁可漏,不归错
+ * (用户裁决 2026-11-11)。
+ */
+var GROUP_ANCHOR_TTL_MS = 30 * 60 * 1000;
+
+/** 锚点记录的识别标记(App 写入时用的 mimeType) */
+var ANCHOR_MIME = 'application/x-fmode-anchor';
+
+function _ok(response, data) {
+  var body = { code: 200 };
+  if (data) for (var k in data) body[k] = data[k];
+  response.status(200).json(body);
+}
+
+function _fail(response, code, msg) {
+  response.status(200).json({ code: code, msg: msg });
+}
+
+function _str(v, max) {
+  if (v === undefined || v === null) return '';
+  var s = String(v).trim();
+  return max && s.length > max ? s.slice(0, max) : s;
+}
+
+function _num(v) {
+  var n = Number(v);
+  return isFinite(n) && n >= 0 ? n : null;
+}
+
+/**
+ * 取指针 / 对象的 objectId。
+ *
+ * 🔴 2026-11-18:这个函数原来**缺失**,但 `opRegisterFile` 的
+ * `deliverableId` 认领分支调用了它 —— 线上表现为:
+ *   带 deliverableId → {"code": 500, "msg": "_idOf is not defined"}
+ *   去掉 deliverableId → {"code": 200}(走另一条路径)
+ *
+ * 后果:容器上报成果后,用 report 返回的 id 来认领那条记录时**必然失败**,
+ * 文件虽然上了 S3,但成果表里没有对应记录 —— 用户在「成果」页签看不到。
+ *
+ * 实现与 `lfYlgU7SkK`(fmodeagent-deliverables)里的同名函数保持一致:
+ * 字符串直接返回,指针取 `.id`,空值返回 null。
+ */
+function _idOf(v) {
+  if (!v) return null;
+  if (typeof v === 'string') return v;
+  return v.id || null;
+}
+
+function _sessionToken() {
+  // 与 fmodeagent-status 同口径:请求头优先(平台实测只保留请求头)
+  if (request.headers && request.headers['x-parse-session-token']) {
+    return request.headers['x-parse-session-token'];
+  }
+  if (params && params.token) return params.token;
+  if (request.body && request.body.token) return request.body.token;
+  return null;
+}
+
+async function _getUser(t) {
+  if (!t) return null;
+  if (request.user && request.user.id) return request.user;
+  try {
+    var q = new Parse.Query(Parse.Session);
+    q.equalTo('sessionToken', t);
+    q.include('user');
+    var s = await q.first({ useMasterKey: true });
+    return s ? s.get('user') : null;
+  } catch (e) {
+    return null;
+  }
+}
+
+/**
+ * 反查容器产出的文件属于哪个群(v0.2.0)。
+ *
+ * ## 为什么需要
+ *
+ * 伪群聊下容器只在自己的 DM 房间工作,回报文件时**不知道群**。
+ * App 在派活前为每个目标容器记了一条锚点(`uploadedBy:'agent'` +
+ * `ANCHOR_MIME`),锚点上带着 `groupId` / `agentId` / `roomId`。
+ * 容器产出到达时,按「同 user + 同 agentId + 同 roomId + 时间在锚点之后」匹配。
+ *
+ * ## 宁可漏,不归错(用户裁决)
+ *
+ * - 有多条候选锚点 → **不认**(同时被多个群派活的典型场景,认了就会串台)
+ * - 锚点太旧(超出 TTL)→ 不认
+ * - 匹配不到 → 返回 '',文件照常登记,只是不归群
+ *
+ * @returns {{ groupId: string }} 命中返回群 id,否则空串
+ */
+async function _resolveGroup(user, agentId, roomId) {
+  if (!agentId) return '';
+
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  q.equalTo('agentId', agentId);
+  q.equalTo('uploadedBy', 'agent');
+  q.equalTo('mimeType', ANCHOR_MIME);
+  q.greaterThan('deliveredAt', new Date(Date.now() - GROUP_ANCHOR_TTL_MS));
+  q.descending('deliveredAt');
+  q.limit(10);
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  if (rows.length === 0) return '';
+
+  /*
+   * 🔴 唯一性要求:窗口内必须只有**同一个群**的锚点。
+   *
+   * 同一容器被群 G 和群 H 先后派活 → 有两条锚点指向不同群 →
+   * 无法判断这个文件是谁的 → 不认。这是「不串台」的底线,
+   * 代价是这种并发场景下文件不归群(仍会出现在单聊里)。
+   */
+  var groups = new Set();
+  for (var i = 0; i < rows.length; i++) {
+    var g = rows[i].get('groupId') || '';
+    if (g) groups.add(g);
+  }
+  if (groups.size !== 1) return '';
+  return groups.values().next().value || '';
+}
+
+/** 云盘链接只接受本平台域名,防止登记任意外链冒充成果 */
+function _isCloudUrl(u) {
+  return /^https:\/\/(s3|file-cloud)\.fmode\.cn\//i.test(u);
+}
+
+/**
+ * 用 threadRoot 反查该会话的房间 id(v0.3.0,2026-11-13)。
+ *
+ * 为什么要它:`registerFile` 的主键改成了 roomId,但老调用方(以及容器)
+ * 手里可能只有 threadRoot。会话目录 `FmodeChatThread` 同时存了
+ * `threadRoot` 与 `roomId`,是这条换算的权威来源。
+ *
+ * 反查不到就返回空串,由调用方决定降级策略(这里退回用 threadRoot 当键)。
+ */
+async function _roomOfThread(user, threadRoot) {
+  if (!threadRoot) return '';
+  try {
+    var q = new Parse.Query('FmodeChatThread');
+    q.equalTo('user', user);
+    q.equalTo('threadRoot', threadRoot);
+    q.descending('lastMessageAt');
+    var row = await q.first({ useMasterKey: true });
+    return row ? row.get('roomId') || '' : '';
+  } catch (e) {
+    /* 会话目录不可用不该阻断登记:调用方会退回 threadRoot */
+    return '';
+  }
+}
+
+/**
+ * 校验 `groupId` 确实是**本用户的群会话**(v0.2.0)。
+ *
+ * 🔴 为什么必须校验:`groupId` 是隔离边界。若不校验,客户端可以传任意字符串,
+ *    把文件"归"到一个不存在的群或别人的群 —— 隔离就成了摆设。
+ *
+ * 会话目录在 `FmodeChatThread` 表,`kind === 'group'` 才是群。
+ * 查不到 / 不是群 / 不是本人 → 一律拒绝。
+ */
+async function _isOwnGroup(user, groupId) {
+  if (!groupId) return false;
+  try {
+    var q = new Parse.Query('FmodeChatThread');
+    q.equalTo('user', user);
+    q.equalTo('objectId', groupId);
+    var row = await q.first({ useMasterKey: true });
+    if (!row) return false;
+    var kind = String(row.get('kind') || '').toLowerCase();
+    return kind === 'group';
+  } catch (e) {
+    /* 表不存在或查询失败 → 保守拒绝,宁可登记成"不归群" */
+    return false;
+  }
+}
+
+/**
+ * 确保 class 上存在某个列(2026-11-10)。
+ *
+ * 🔴 Parse 的自动建列**只在写入时发生**:数据库里还没有 `threadRoot` 列时,
+ *    直接 `equalTo('threadRoot', x)` 会让 PostgreSQL 报 42703 errorMissingColumn。
+ *    历史数据本来就没有这个字段,所以第一次查询必然踩到。
+ *
+ * 做法:写一个带该字段的探测对象再立刻销毁,把列建出来。
+ * 只在捕获到缺列错误时执行一次,正常路径零开销。
+ */
+var _ensured = false;
+/**
+ * 一次性建出所有新列。
+ *
+ * 历史数据里这些字段一个都不存在,分散建列会让每个字段都触发一次
+ * 失败查询 + 重试,这里一次建全,后续查询零开销。
+ */
+async function _ensureColumns() {
+  if (_ensured) return;
+  var probe = new Parse.Object(CLASS_NAME);
+  probe.set('threadRoot', '');
+  probe.set('fileUrl', '');
+  probe.set('uploadedBy', '');
+  probe.set('fileName', '');
+  probe.set('fileSize', 0);
+  probe.set('mimeType', '');
+  probe.set('storageKey', '');
+  probe.set('roomId', '');
+  /* v0.2.0(2026-11-11):群隔离字段 */
+  probe.set('groupId', '');
+  probe.set('groupIdSource', '');
+  probe.set('scope', '');
+  await probe.save(null, { useMasterKey: true });
+  // 探测对象必须销毁,否则会在成果列表里留下一条空记录
+  await probe.destroy({ useMasterKey: true });
+  _ensured = true;
+}
+
+/**
+ * 判断是否「列不存在」错误。
+ *
+ * 🔴 只认 PostgreSQL 的错误码,不能按字段名匹配 ——
+ *    查询语句本身就包含字段名,按名匹配会让任何错误都被当成缺列。
+ */
+function _isMissingColumn(e) {
+  try {
+    var s = JSON.stringify(e);
+    return s.indexOf('42703') >= 0 || s.indexOf('errorMissingColumn') >= 0;
+  } catch (e2) {
+    return false;
+  }
+}
+
+// ==================== 行 → 返回对象 ====================
+
+function _toFile(r) {
+  var artifacts = r.get('artifacts') || [];
+  var first = Array.isArray(artifacts) && artifacts.length ? artifacts[0] : null;
+  if (typeof first === 'string') first = { url: first, name: '' };
+
+  return {
+    id: r.id,
+    threadRoot: r.get('threadRoot') || '',
+    /* v0.2.0:所属群会话 id;'' = 不属于任何群 */
+    groupId: r.get('groupId') || '',
+    groupIdSource: r.get('groupIdSource') || '',
+    agentId: r.get('agentId') || '',
+    roomId: r.get('roomId') || '',
+    // 文件信息优先取新字段,回退到 artifacts[0](两者写入时保持一致)
+    name: r.get('fileName') || (first && first.name) || '',
+    size: typeof r.get('fileSize') === 'number' ? r.get('fileSize') : -1,
+    mimeType: r.get('mimeType') || (first && first.mimeType) || '',
+    url: (first && first.url) || '',
+    storageKey: r.get('storageKey') || '',
+    uploadedBy: r.get('uploadedBy') || 'agent',
+    status: r.get('status') || 'delivered',
+    deliveredAt: (r.get('deliveredAt') || r.get('createdAt'))
+      ? new Date(r.get('deliveredAt') || r.get('createdAt')).getTime()
+      : 0,
+  };
+}
+
+/**
+ * 过滤掉**派发锚点**记录(v0.2.0)。
+ *
+ * 锚点是 App 在派活前写的内部记录(`mimeType = ANCHOR_MIME`),
+ * 只用来反查文件归属,**不是文件**,不能出现在任何列表里。
+ */
+function _toFiles(rows) {
+  var out = [];
+  for (var i = 0; i < rows.length; i++) {
+    if (rows[i].get('mimeType') === ANCHOR_MIME) continue;
+    out.push(_toFile(rows[i]));
+  }
+  return out;
+}
+
+// ==================== actions ====================
+/**
+ * registerFile —— 登记一条文件记录
+ *
+ * 用户上传(uploadedBy:'user')与容器产出(uploadedBy:'agent')共用。
+ * 幂等:同一 (user, roomId, url) 重复登记返回已有记录,不产生重复。
+ *
+ * ## 归属键:roomId 优先(v0.3.0,2026-11-13)
+ *
+ * 旧版要求 `threadRoot` 必填,而它依赖容器能拿到 App 的会话根 —— 实测拿不到
+ * (DM 的 `m.relates_to` 根本没进消息),容器只能回落到房间 id。
+ * App 却按 `$approot_*` 会话根查,**两边键从来对不上**。
+ *
+ * 现改为:`roomId` 必填、`threadRoot` 可选。
+ * 一房间一会话下 roomId 与会话一一对应(App 建房失败会硬报错,不再降级共用房间)。
+ *
+ * 老调用方仍可只传 `threadRoot`:服务端用 `FmodeChatThread` 反查它的 roomId。
+ */
+async function opRegisterFile(user, response) {
+  var p = params || {};
+  var threadRoot = _str(p.threadRoot, LEN.threadRoot);
+  var roomId = _str(p.roomId, LEN.roomId);
+  var url = _str(p.url, LEN.url);
+  var name = _str(p.name, LEN.name);
+
+  /*
+   * 兼容老调用方:只给了 threadRoot 时,反查该会话的房间。
+   * 查不到就退回用 threadRoot 当归属键(保证老链路不至于直接失败)。
+   */
+  if (!roomId && threadRoot) {
+    roomId = (await _roomOfThread(user, threadRoot)) || '';
+  }
+  if (!roomId) return _fail(response, 400, 'roomId required');
+  if (!url) return _fail(response, 400, 'url required');
+  if (!_isCloudUrl(url)) return _fail(response, 400, 'url must be a platform cloud link');
+  if (!name) return _fail(response, 400, 'name required');
+
+  var size = _num(p.size);
+  if (size !== null && size > MAX_FILE_BYTES) return _fail(response, 400, 'file too large');
+
+  var uploadedBy = p.uploadedBy === 'user' ? 'user' : 'agent';
+  var agentId = _str(p.agentId, LEN.agentId);
+
+  /*
+   * 群归属(v0.2.0,2026-11-11)。
+   *
+   * 传了 `groupId` 就必须是本用户的群,否则拒绝 —— 见 `_isOwnGroup`。
+   * 没传或校验不过 → `groupId` 留空,按原来的「只按会话」处理,
+   * 不影响存量调用方。
+   */
+  var groupId = _str(p.groupId, LEN.threadRoot);
+  if (groupId) {
+    var ok = await _isOwnGroup(user, groupId);
+    if (!ok) return _fail(response, 400, 'groupId must be your own group session');
+  } else if (uploadedBy === 'agent' && _str(p.mimeType, LEN.mime) !== ANCHOR_MIME) {
+    /*
+     * 容器产出没带 groupId → 反查派发锚点(v0.2.0)。
+     *
+     * 用户上传(uploadedBy='user')不做反查:App 知道群,直接传就行。
+     * 锚点记录本身(ANCHOR_MIME)也跳过,否则会自己匹配自己。
+     */
+    groupId = await _resolveGroup(user, agentId, _str(p.roomId, LEN.roomId));
+  }
+
+  /*
+   * 幂等:同一会话内同一 URL 只存一条。
+   *
+   * 🔴 不能查 `artifacts.url`(数组内字段)—— 实测该查询永远匹配不到,
+   *    会导致重复登记。改查顶层 `fileUrl`:registerFile 写入时同步落一份。
+   *    该列首次查询时也不存在,需要建列后重试(见 _ensureColumn)。
+   */
+  /* 🔴 2026-11-14:先按 deliverableId 认领 report 已建的那条记录,不新建。
+ *  registerFile 原来按 (user, roomId, fileUrl) 查重,但 report 建的那条没有
+ *  roomId/fileUrl,查不到 → 又建一条 → 同一 URL 两条记录。
+ *  report 返回的 id 即那条的 objectId,容器以 deliverableId 传进来。 */
+  var claimId = _str(p.deliverableId, 60);
+  if (claimId) {
+    var cq = new Parse.Query(CLASS_NAME);
+    var claim = await cq.get(claimId, { useMasterKey: true }).catch(function () { return null; });
+    if (claim && String(_idOf(claim.get('user'))) === String(user.id) && !claim.get('roomId')) {
+      claim.set('roomId', groupId || roomId);
+      claim.set('threadRoot', groupId || threadRoot || roomId);
+      claim.set('fileUrl', url);
+      claim.set('fileName', name);
+      claim.set('storageKey', _str(p.key, LEN.key));
+      claim.set('mimeType', _str(p.mimeType, LEN.mime) || 'application/octet-stream');
+      if (size !== null) claim.set('fileSize', size);
+      claim.set('uploadedBy', uploadedBy);
+      claim.set('agentId', agentId);
+      claim.set('reportedAt', new Date());
+      await claim.save(null, { useMasterKey: true });
+      return _ok(response, { id: claim.id, claimed: true });
+    }
+  }
+
+  var dupQ = new Parse.Query(CLASS_NAME);
+  dupQ.equalTo('user', user);
+  dupQ.equalTo('roomId', roomId);
+  dupQ.equalTo('fileUrl', url);
+  var dup;
+  try {
+    dup = await dupQ.first({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    dup = await dupQ.first({ useMasterKey: true });
+  }
+  if (dup) return _ok(response, { id: dup.id, duplicated: true });
+
+  var obj = new Parse.Object(CLASS_NAME);
+  obj.set('user', user);
+  /*
+   * 🔴 反查命中的群文件,`threadRoot` **一并改写为群 id**(v0.2.0)。
+   *
+   * 这是「不串台」的落地:一条文件只能属于一个页签。
+   * 若仍保留 DM thread,单聊 `listBySession(dm)` 也会返回它 ——
+   * 同一个文件在单聊和群里各出现一次。
+   *
+   * 原始的 DM thread 存进 `prevThreadRoot`,出问题可据此还原。
+   */
+  var resolvedByAnchor = !p.groupId && !!groupId;
+  /*
+   * roomId 是主键;threadRoot 落库保留(历史兼容 + 排查用),但不再作为归属依据。
+   * 群归属命中时两者都改写为群 id,避免同一文件在两个页签各出现一次。
+   */
+  obj.set('roomId', resolvedByAnchor ? groupId : roomId);
+  obj.set('threadRoot', resolvedByAnchor ? groupId : threadRoot || roomId);
+  if (resolvedByAnchor) obj.set('prevThreadRoot', threadRoot);
+  obj.set('groupId', groupId);
+  obj.set(
+    'groupIdSource',
+    groupId ? (resolvedByAnchor ? 'anchor' : _str(p.groupIdSource, 20) || 'app') : '',
+  );
+  obj.set('agentId', agentId);
+  obj.set('uploadedBy', uploadedBy);
+  obj.set('fileName', name);
+  obj.set('fileSize', size === null ? -1 : size);
+  obj.set('mimeType', _str(p.mimeType, LEN.mime));
+  obj.set('storageKey', _str(p.key, LEN.key));
+  /* 幂等键:顶层单独存一份 URL,见 opRegisterFile 的去重说明 */
+  obj.set('fileUrl', url);
+  obj.set('title', name);
+  obj.set('summary', p.source ? '容器产出' : '用户上传');
+  obj.set('status', 'delivered');
+  obj.set('deliveredAt', new Date());
+  obj.set('reportedAt', new Date());
+  obj.set('tags', ['file-hub', uploadedBy]);
+  /*
+   * artifacts 保留数组形态:App 现有的 Deliverable 映射(mapDeliverable)
+   * 按 artifacts[0].url 取链接,写在这里就不用改 App 的解析层。
+   */
+  obj.set('artifacts', [
+    {
+      name: name,
+      url: url,
+      type: _str(p.mimeType, LEN.mime),
+      source: _str(p.source, LEN.url),
+    },
+  ]);
+
+  // ACL:只给本人读写(成果属于个人会话,不跨用户可见)
+  var acl = new Parse.ACL(user);
+  acl.setPublicReadAccess(false);
+  acl.setPublicWriteAccess(false);
+  obj.setACL(acl);
+
+  // 公司指针从 agent 带过来,保持与老成果表一致的多租户口径
+  if (agentId) {
+    try {
+      var aq = new Parse.Query('FmodeAgent');
+      aq.equalTo('agentId', agentId);
+      var agent = await aq.first({ useMasterKey: true });
+      if (agent) {
+        obj.set('agent', agent);
+        obj.set('agentObjectId', agent.id);
+        var company = agent.get('company');
+        if (company) obj.set('company', company);
+        if (!agentId) obj.set('agentId', agent.get('agentId') || '');
+      }
+    } catch (e) {
+      /* agent 查不到不影响登记:文件仍归属到用户与会话 */
+    }
+  }
+
+  var saved = await obj.save(null, { useMasterKey: true });
+  return _ok(response, { id: saved.id });
+}
+
+/**
+ * listBySession —— 按会话拉文件(右侧栏主路径)
+ *
+ * 这是用户要求「每次直接从数据库加载文件」的入口:
+ * 不依赖加载聊天历史,也不依赖 FmodeChatThread.deliverableUrls。
+ *
+ * ## 入参(v0.3.0,2026-11-13)
+ *
+ * 优先 `roomId`;只给了 `threadRoot` 时先反查房间,再按 roomId 查。
+ * 两者都没有才报错。
+ *
+ * 为什么不能继续只按 threadRoot 查:容器登记的 threadRoot 实际是房间 id
+ * (`_thread_root()` 的二级回落),而 App 传的是 `$approot_*` 会话根 ——
+ * 两个值对不上,右栏永远查不到容器成果。
+ */
+async function opListBySession(user, response) {
+  var p = params || {};
+  var roomId = _str(p.roomId, LEN.roomId);
+  var threadRoot = _str(p.threadRoot, LEN.threadRoot);
+
+  if (!roomId && threadRoot) {
+    roomId = (await _roomOfThread(user, threadRoot)) || '';
+    /* 反查不到:退回按 threadRoot 查(兼容老数据) */
+    if (!roomId) roomId = threadRoot;
+  }
+  if (!roomId) return _fail(response, 400, 'roomId required');
+
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  q.equalTo('roomId', roomId);
+  if (p.before) {
+    var before = new Date(Number(p.before));
+    if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
+  }
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    // 列还不存在 → 建列后重试一次(历史数据没有 threadRoot,首次查询必然走到这里)
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  var list = _toFiles(rows);
+  return _ok(response, {
+    roomId: roomId,
+    threadRoot: threadRoot,
+    files: list,
+    count: list.length,
+  });
+}
+
+/**
+ * listByUrl —— 按 URL 反查已登记记录(v0.3.0,2026-11-13)
+ *
+ * App 的「成果绑定服务」用它判断某个链接是否已经进了台账:
+ *   · 命中且 roomId 与当前房间一致 → 已绑定,什么都不用做
+ *   · 没命中 → 由 App 补登记
+ *
+ * 这是**跨会话**查询(只按 user + url),所以调用方必须自己再校验房间归属,
+ * 不能拿它当作"这条属于我"的证据。返回里带 roomId 就是为了让调用方能校验。
+ */
+async function opListByUrl(user, response) {
+  var p = params || {};
+  var url = _str(p.url, LEN.url);
+  if (!url) return _fail(response, 400, 'url required');
+
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  q.equalTo('fileUrl', url);
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || 10, 50));
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  var list = _toFiles(rows);
+  return _ok(response, { files: list, count: list.length });
+}
+
+/** listByAgent —— 按容器拉(成果页用,不按会话过滤) */async function opListByAgent(user, response) {
+  var p = params || {};
+  var q = new Parse.Query(CLASS_NAME);
+  q.equalTo('user', user);
+  var agentId = _str(p.agentId, LEN.agentId);
+  if (agentId) q.equalTo('agentId', agentId);
+  if (p.before) {
+    var before = new Date(Number(p.before));
+    if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
+  }
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
+
+  var rows = await q.find({ useMasterKey: true });
+  var list = _toFiles(rows);
+  return _ok(response, { files: list, count: list.length });
+}
+
+/**
+ * listByGroup —— 按**群**拉文件(v0.2.0,2026-11-11)
+ *
+ * ## 为什么不能只用 threadRoot
+ *
+ * 群里的文件有两种来源:
+ *   · **用户上传**:写入时 `threadRoot = groupId`(历史数据也只有 threadRoot)
+ *   · **容器产出**:容器只知道 DM thread,由服务端反查/补归并后
+ *     `threadRoot` 改写为群 id、同时补 `groupId`
+ *
+ * 查询用 `groupId == g OR threadRoot == g`,两条来源都能覆盖,
+ * 也让**没有 groupId 的存量群内上传记录**照样查得到(无需数据迁移)。
+ */
+async function opListByGroup(user, response) {
+  var p = params || {};
+  var groupId = _str(p.groupId, LEN.threadRoot);
+  if (!groupId) return _fail(response, 400, 'groupId required');
+
+  var byGroup = new Parse.Query(CLASS_NAME);
+  byGroup.equalTo('user', user);
+  byGroup.equalTo('groupId', groupId);
+
+  var byThread = new Parse.Query(CLASS_NAME);
+  byThread.equalTo('user', user);
+  byThread.equalTo('threadRoot', groupId);
+
+  var q = Parse.Query.or(byGroup, byThread);
+  if (p.before) {
+    var before = new Date(Number(p.before));
+    if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
+  }
+  q.descending('deliveredAt');
+  q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
+
+  var rows;
+  try {
+    rows = await q.find({ useMasterKey: true });
+  } catch (e) {
+    if (!_isMissingColumn(e)) throw e;
+    await _ensureColumns();
+    rows = await q.find({ useMasterKey: true });
+  }
+  var list = _toFiles(rows);
+  return _ok(response, { groupId: groupId, files: list, count: list.length });
+}
+
+/**
+ * claimToGroup —— 惰性补归并(v0.2.0,2026-11-11)
+ *
+ * 有些容器产出登记时没能确定归属群(`groupId=''`)。群页面打开时,
+ * App 把「有把握属于本群」的记录 id 传进来,这里把它们**搬**到群上:
+ * 补 `groupId`、把 `threadRoot` 改写为群 id。
+ *
+ * 🔴 改写 threadRoot 是「互斥」的落地:一条文件只能出现在一个页签 ——
+ *    搬进群之后,单聊 `listBySession(单聊sid)` 自然查不到它了。
+ *
+ * 安全:只允许操作**本人**的、`uploadedBy='agent'`(容器产出)、
+ *      且当前 `groupId` 为空的记录。用户上传的文件不允许被搬。
+ */
+async function opClaimToGroup(user, response) {
+  var p = params || {};
+  var groupId = _str(p.groupId, LEN.threadRoot);
+  var ids = Array.isArray(p.ids) ? p.ids.filter((x) => typeof x === 'string' && x) : [];
+  if (!groupId) return _fail(response, 400, 'groupId required');
+  if (ids.length === 0) return _fail(response, 400, 'ids required');
+  if (!(await _isOwnGroup(user, groupId))) {
+    return _fail(response, 400, 'groupId must be your own group session');
+  }
+
+  var claimed = 0;
+  var skipped = 0;
+  for (var i = 0; i < ids.length && i < 100; i++) {
+    var obj;
+    try {
+      var q = new Parse.Query(CLASS_NAME);
+      q.equalTo('user', user);
+      obj = await q.get(ids[i], { useMasterKey: true });
+    } catch (e) {
+      skipped++;
+      continue;
+    }
+    if (!obj) {
+      skipped++;
+      continue;
+    }
+    if (obj.get('uploadedBy') !== 'agent' || obj.get('groupId')) {
+      skipped++;
+      continue;
+    }
+    try {
+      /* 留一份原 threadRoot,便于出问题时还原 */
+      if (!obj.get('prevThreadRoot')) obj.set('prevThreadRoot', obj.get('threadRoot') || '');
+      obj.set('groupId', groupId);
+      obj.set('groupIdSource', 'claim');
+      obj.set('threadRoot', groupId);
+      await obj.save(null, { useMasterKey: true });
+      claimed++;
+    } catch (e) {
+      skipped++;
+    }
+  }
+  return _ok(response, { groupId: groupId, claimed: claimed, skipped: skipped });
+}
+
+// ==================== 入口 ====================
+
+function handler(request, response) {
+  (async function () {
+    var p = params || {};
+    var act = p.action || 'listBySession';
+
+    var token = _sessionToken();
+    var user = await _getUser(token);
+    if (!user) return _fail(response, 401, 'invalid session');
+
+    try {
+      if (act === 'registerFile') return await opRegisterFile(user, response);
+      if (act === 'listBySession') return await opListBySession(user, response);
+      if (act === 'listByUrl') return await opListByUrl(user, response);
+      if (act === 'listByAgent') return await opListByAgent(user, response);
+      /* v0.2.0(2026-11-11):群隔离 */
+      if (act === 'listByGroup') return await opListByGroup(user, response);
+      if (act === 'claimToGroup') return await opClaimToGroup(user, response);
+      return _fail(response, 400, 'unknown action: ' + act);
+    } catch (e) {
+      /*
+       * Parse 的异常对象字符串化是 `[object Object]`,直接丢出去排查不了。
+       * 新函数上线初期必须能看到真实原因(字段不存在 / 索引缺失等)。
+       */
+      var msg = 'unknown';
+      try {
+        msg = (e && (e.message || e.error || e.code)) || String(e);
+        if (typeof msg === 'object') msg = JSON.stringify(msg);
+      } catch (e2) {
+        msg = String(e);
+      }
+      return _fail(response, 500, String(msg));
+    }
+  })();
+}

+ 8 - 0
src/app/components/domain/assistant-files/assistant-files.ts

@@ -117,6 +117,14 @@ import { fileIconByMime, fmtSize } from '../session-rail/rail-shared';
         min-height: var(--touch-min); /* 触达区 ≥44px */
         grid-template-columns: 30px minmax(0, 1fr);
       }
+
+      /* 触摸端 :hover 会粘住:点开预览返回后卡片仍高亮,看起来像选中态
+         (2026-11-18 用户实测)。移动端浏览器 tap 后会把 hover 状态停留在元素上。
+         修法:触摸端不启用 hover 背景,点击反馈交给 :active 与 focus-visible。 */
+      .file-tile:hover {
+        border-color: var(--edge);
+        background: var(--surface);
+      }
     }
 
     .tile-ico {

+ 1 - 0
src/app/components/domain/assistant-turn/assistant-turn.spec.ts

@@ -486,3 +486,4 @@ describe('AssistantTurnComponent · 实时步骤面板', () => {
     expect(el.querySelector('.live-more')?.textContent).toContain('3');
   });
 });
+

+ 5 - 2
src/app/components/domain/assistant-turn/assistant-turn.ts

@@ -1,6 +1,6 @@
 import { ChangeDetectionStrategy, Component, OnDestroy, computed, effect, inject, input, output, signal, untracked } from '@angular/core';
 import { FileCard, Message } from '../../../core/api/models';
-import { AssistantTurn, TurnBlockView, elapsedSeconds, waitText } from '../../../core/assistant-turn';
+import { AssistantTurn, TurnBlockView, elapsedSeconds, stripDeliverableLinks, waitText } from '../../../core/assistant-turn';
 import { TurnCollapseService } from '../../../core/turn-collapse.service';
 import { AssistantFilesComponent } from '../assistant-files/assistant-files';
 import { MessageBubbleComponent } from '../message-bubble/message-bubble';
@@ -1098,5 +1098,8 @@ function bodyTextOf(b: TurnBlockView): string | null {
     .filter((p): p is Extract<TurnBlockView['body'][number], { kind: 'text' }> => p.kind === 'text')
     .map((p) => p.message.text ?? '')
     .filter((t) => t.trim().length > 0);
-  return parts.length > 0 ? parts.join('\n\n') : null;
+  if (parts.length === 0) return null;
+  /* 剥掉正文里的云盘交付链接(2026-11-18):详情见 core/assistant-turn.ts::stripDeliverableLinks */
+  const cleaned = stripDeliverableLinks(parts.join('\n\n'));
+  return cleaned.length > 0 ? cleaned : null;
 }

+ 52 - 0
src/app/core/assistant-turn.spec.ts

@@ -6,6 +6,7 @@ import {
   isTurnStalled,
   isTurnTimedOut,
   STALL_MS,
+  stripDeliverableLinks,
   TURN_TIMEOUT_MS,
   turnsFromDm,
   turnsFromGroup,
@@ -1387,3 +1388,54 @@ describe('中间产物不计入对账', () => {
     expect(count(text)).toBe(3);
   });
 });
+
+/**
+ * 正文剥离云盘链接(2026-11-18 用户要求「输出时只显示卡片,不显示链接」)。
+ */
+describe('stripDeliverableLinks', () => {
+  it('纯链接行被剥离', () => {
+    const out = stripDeliverableLinks(
+      '3 个文件已生成:\n已上云(可直接下载)\n\nhttps://s3.fmode.cn/deliverables/a/x.md\nhttps://s3.fmode.cn/deliverables/a/y.csv',
+    );
+    expect(out).not.toContain('https://s3.fmode.cn');
+    expect(out).toBe('3 个文件已生成:');
+  });
+
+  it('引导语 + 空行 + 链接 → 引导语也一并删除', () => {
+    const out = stripDeliverableLinks('已完成\n已上云(可直接下载)\n\nhttps://s3.fmode.cn/deliverables/a/x.md');
+    expect(out).toBe('已完成');
+  });
+
+  it('行内有实质说明的链接保留', () => {
+    const text = '详细说明见 https://s3.fmode.cn/deliverables/a/readme.md 这个文件,里面有完整的数据结构定义。';
+    expect(stripDeliverableLinks(text)).toContain('https://s3.fmode.cn');
+  });
+
+  it('只有链接的正文 → 返回空串', () => {
+    expect(stripDeliverableLinks('https://s3.fmode.cn/deliverables/a/x.md')).toBe('');
+  });
+
+  it('非云盘链接不受影响', () => {
+    const text = '参考 https://example.com/docs 这个文档。';
+    expect(stripDeliverableLinks(text)).toBe(text);
+  });
+
+  it('没有链接的正文原样返回', () => {
+    const text = '这是普通的回答,没有文件。';
+    expect(stripDeliverableLinks(text)).toBe(text);
+  });
+});
+
+describe('stripDeliverableLinks · Markdown 强调(2026-11-18 实测)', () => {
+  it('加粗的引导语也能识别并删除', () => {
+    const out = stripDeliverableLinks(
+      '3 个文件已生成:\n**已上云(可直接下载)**\n\nhttps://s3.fmode.cn/deliverables/a/x.md',
+    );
+    expect(out).toBe('3 个文件已生成:');
+  });
+
+  it('引导语后面没有内容时也删除(链接已被剥掉)', () => {
+    const out = stripDeliverableLinks('3 个文件已生成:\n**已上云(可直接下载)**');
+    expect(out).toBe('3 个文件已生成:');
+  });
+});

+ 99 - 2
src/app/core/assistant-turn.ts

@@ -1428,8 +1428,19 @@ function collectFiles(blocks: TurnBlockView[]): { key: string; file: FileCard }[
   const out: { key: string; file: FileCard }[] = [];
   for (const b of blocks) {
     for (const f of b.files) {
-      // 同名同大小的重复文件只出一张卡(多容器转发同一份时)
-      const sig = `${f.file.name}|${f.file.size ?? 0}|${f.file.url}`;
+      /*
+       * 🔴 按「文件名 + 大小」去重,**不含 url**(2026-11-18 用户实测)。
+       *
+       * 原签名是 `name|size|url` —— 同一个文件如果被发了两次
+       * (比如容器「重发」「补充发送」),每次上传都会得到**不同的 s3 地址**
+       * (key 带随机串),于是 url 不同 → 去重失效 → 用户看到两张一样的卡片。
+       *
+       * 实测:某会话 table.html 出现了两次(两个回合各发一次,url 不同)。
+       *
+       * 现在只要「文件名 + 大小」相同就视为同一份产物,只保留第一张。
+       * 保留第一次的 url —— 两份内容一样,用哪个都能打开。
+       */
+      const sig = `${f.file.name}|${f.file.size ?? 0}`;
       if (seen.has(sig)) continue;
       seen.add(sig);
       out.push(f);
@@ -1601,3 +1612,89 @@ function roundSeconds(
 export function hasFiles(t: AssistantTurn): boolean {
   return t.fileCount > 0;
 }
+
+/**
+ * 剥离正文里的云盘交付链接(2026-11-18 用户要求「只显示卡片,不显示链接」)。
+ *
+ * ## 为什么需要
+ *
+ * 容器交付文件时会在正文末尾列一串 `https://s3.fmode.cn/deliverables/...`,
+ * 这些链接在气泡里会被自动识别成可点文本,又长又乱;
+ * 而文件本身已经用下方的卡片展示(带图标、文件名、大小、可预览),
+ * 正文再列一遍纯属重复。
+ *
+ * ## 判定规则(按行)
+ *
+ *   · 行内包含云盘链接,剥掉链接后只剩引导语 / 列表符号 → **删除整行**
+ *   · 行内包含云盘链接,但还有实质说明 → **保留原样**
+ *   · 行本身是纯引导语(「已上云(可直接下载)」等),且**后面紧跟链接行** → 删除
+ *   · 其它行一律保留
+ *
+ * ## 典型输入输出
+ *
+ * ```
+ * 3 个文件已生成:                          →  3 个文件已生成:
+ * 已上云(可直接下载)                      →  (删除)
+ * https://s3.fmode.cn/.../a.md              →  (删除)
+ * https://s3.fmode.cn/.../b.csv             →  (删除)
+ * ```
+ *
+ * ⚠️ 只影响**显示**:`countMissingFiles()` 用的是原始正文,对账不受影响。
+ *
+ * @param text 原始正文
+ * @returns 剥离后的正文;剥完为空时返回空串(调用方据此决定是否渲染气泡)
+ */
+export function stripDeliverableLinks(text: string): string {
+  if (!text) return '';
+  /*
+   * 🔴 先去掉 Markdown 强调符号再匹配(2026-11-18 真机实测)。
+   *
+   * 容器写的是 `**已上云(可直接下载)**`(加粗),直接拿正则匹配
+   * `^已上云(可直接下载)$` 会失败 —— `**` 让开头结尾都不匹配,
+   * 于是这行被当成「有实质内容」保留了下来。
+   *
+   * 匹配用**去掉强调符号后的文本**,但输出保留原始行(未命中删除时才用原文)。
+   */
+  const plainOf = (s: string): string =>
+    s
+      .replace(/^\s*#{1,6}\s*/, '') // 标题符号
+      .replace(/\*\*|__|`/g, '') // 加粗 / 行内代码
+      .replace(/^\s*[-*+]\s+/, '') // 列表符号
+      .trim();
+  const GUIDE_ONLY =
+    /^(已上云(可直接下载)|已上云|可直接下载|交付清单|附件|文件清单|下载地址)[::\s]*$/;
+  const LINK = /https?:\/\/(?:s3|file-cloud)\.fmode\.cn\/[^\s)]+/i;
+  const LINK_G = /https?:\/\/(?:s3|file-cloud)\.fmode\.cn\/[^\s)]+/gi;
+
+  const lines = text.split('\n');
+  const keep: string[] = [];
+  for (let i = 0; i < lines.length; i++) {
+    const t = lines[i].trim();
+    if (!t) {
+      keep.push('');
+      continue;
+    }
+    const plain = plainOf(t);
+    if (LINK.test(t)) {
+      const rest = plainOf(t.replace(LINK_G, '')).replace(/^[\s\-*·\d.、))]+/, '').trim();
+      /* 纯链接 / 只有列表符号 / 只有引导语 / 很短的引导语(无句号) */
+      if (rest === '' || GUIDE_ONLY.test(rest)) continue;
+      if (rest.length <= 12 && !/[。!?.!?]/.test(rest)) continue;
+      keep.push(lines[i]);
+      continue;
+    }
+    /* 纯引导语:跳过空行看下一个非空行是不是链接 */
+    if (GUIDE_ONLY.test(plain)) {
+      let j = i + 1;
+      while (j < lines.length && !lines[j].trim()) j++;
+      const next = plainOf(lines[j] ?? '');
+      /* 下一个非空行是链接,或已经没有下一行了(链接被前面的分支删过)→ 删掉引导语 */
+      if (!next || LINK.test(lines[j] ?? '')) continue;
+    }
+    keep.push(lines[i]);
+  }
+  return keep
+    .join('\n')
+    .replace(/\n{3,}/g, '\n\n')
+    .trim();
+}

+ 38 - 1
src/app/mobile/pages/chat/chat.ts

@@ -1019,6 +1019,43 @@ export class MbChatPage implements OnDestroy {
     this.clockTick();
     const now = Date.now();
 
+    /*
+     * 🔴 跨回合全局文件去重(2026-11-18 用户裁决「全局去重」)。
+     *
+     * ## 现象
+     *
+     * 容器在第 1 回合发了 `table.html`,第 2 回合又发了一次(重发 / 补充),
+     * 两个回合各出一张卡片 —— 用户看到两张一模一样的卡,以为是 bug。
+     *
+     * ## 为什么回合内的去重不够
+     *
+     * `collectFiles()` 只在**单个回合**内去重。跨回合时每回合各自算出自己的文件列表,
+     * 同一份产物在两个回合里各出现一次。
+     *
+     * ## 做法
+     *
+     * 按「文件名 + 大小」做全局签名表,**后出现的回合**里把已出现过的文件剔掉。
+     * 保留最早那次 —— 那是容器第一次交付的位置,更符合「文件在这里产生」的语义。
+     *
+     * 只影响**显示**;`turn().files` 原始数据不变,对账与其他逻辑不受影响。
+     */
+    const seenFileSigs = new Set<string>();
+    const dedupeTurnFiles = <T extends { files?: { file: { name: string; size?: number } }[] }>(
+      turn: T,
+    ): T => {
+      const files = turn.files;
+      if (!files?.length) return turn;
+      const kept = files.filter((f) => {
+        const sig = `${f.file.name}|${f.file.size ?? 0}`;
+        if (seenFileSigs.has(sig)) return false;
+        seenFileSigs.add(sig);
+        return true;
+      });
+      /* 全部被去重掉 → 不新建对象(保持引用稳定,避免组件 input 变化) */
+      if (kept.length === files.length) return turn;
+      return { ...turn, files: kept } as T;
+    };
+
     for (const t of turnsFromDm(
       buildTurns({ messages: this.chat.messages(), typing: this.chat.peerTyping(), now }),
       now,
@@ -1042,7 +1079,7 @@ export class MbChatPage implements OnDestroy {
       }
       // 已发出等待回复 / 有用户附件 也要出卡(2026-11-09 / 2026-11-10,与桌面同口径)
       if (t.merged || t.live || t.userMessage || (t.userFiles?.length ?? 0) > 0) {
-        out.push({ kind: 'turn', key: `turn-${t.id}`, turn: t });
+        out.push({ kind: 'turn', key: `turn-${t.id}`, turn: dedupeTurnFiles(t) });
       }
     }
     return out;