fmode-file-hub.js 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628
  1. // fmode-file-hub v0.2.0 — 文件台账(按会话 / 按群隔离)(表: AgentDeliverable)
  2. //
  3. // ## v0.2.0(2026-11-11):群隔离
  4. //
  5. // 伪群聊架构下(App 把群消息拆成 N 条私聊发给各成员容器),容器只在自己的
  6. // DM 房间工作,**它不知道文件属于哪个群**。所以「归群」只能由 App 侧决定:
  7. //
  8. // · 用户上传 → 写入时直接带 `groupId`(App 知道当前是哪个群)
  9. // · 容器产出 → 靠「派发锚点」反查(后续版本),或 App 惰性补归并
  10. //
  11. // 新增字段:`groupId`(所属群;'' = 不属于任何群)、`groupIdSource`、`prevThreadRoot`
  12. // 新增 action:`listByGroup` / `claimToGroup`
  13. //
  14. // 🔴 `threadRoot` 语义不变(单聊 = 单聊会话 id,群 = 群 id)。
  15. // `claimToGroup` 会把记录**搬**进群(threadRoot 一并改写),
  16. // 保证一条文件只出现在一个页签 —— 这就是「不串台」的落地方式。
  17. //
  18. // ## 为什么新建而不是改老函数
  19. //
  20. // 老函数 lfYlgU7SkK(fmodeagent-deliverables) 的 report 用 UPDATABLE 白名单写字段,
  21. // 里面**没有 threadRoot** —— 容器传了也会被静默丢弃,所以成果永远无法归属到会话。
  22. // 用户裁决(2026-11-10):**现有云函数一行不动,新建独立函数走新接口**。
  23. //
  24. // ## 职责边界(用户裁决)
  25. //
  26. // · 消息**不入库**(单聊/群聊都在 Matrix)
  27. // · 只有**文件与成果**入库,目的是让右侧栏能按会话直接加载
  28. // · 只存访问链接与文件元信息,**不存文件内容**(内容由 AlP56LCKFm 签名直传 OBS)
  29. // · 不做老数据适配:没有 threadRoot 的历史成果不出现,按用户裁决"全面切新逻辑"
  30. //
  31. // ## 调用
  32. //
  33. // POST /api/functions {token, id:<Function objectId>, params:{action, ...}}
  34. // action: registerFile | listBySession | listByAgent
  35. //
  36. // ## 表
  37. //
  38. // 复用 AgentDeliverable(已有 user / company / ACL),新增字段:
  39. // threadRoot / uploadedBy / fileName / fileSize / mimeType / storageKey / roomId
  40. // ==================== 基础工具(各云函数本就各自复制一份,沿用惯例) ====================
  41. var CLASS_NAME = 'AgentDeliverable';
  42. var MAX_LIMIT = 200;
  43. var DEFAULT_LIMIT = 50;
  44. /** 会话标识、URL、文件名等的长度上限 */
  45. var LEN = { threadRoot: 200, roomId: 200, agentId: 120, url: 1000, name: 200, key: 500, mime: 120 };
  46. /** 单个文件大小上限(与 App 侧 upload-limits.ts 的 20MB 保持一致) */
  47. var MAX_FILE_BYTES = 20 * 1024 * 1024;
  48. /**
  49. * 「派发锚点」的有效窗口(v0.2.0)。
  50. *
  51. * App 发群消息时为每个目标容器记一条锚点,容器产出的文件在**锚点之后
  52. * 这个窗口内**才认它属于那个群。超过窗口不认 —— 宁可漏,不归错
  53. * (用户裁决 2026-11-11)。
  54. */
  55. var GROUP_ANCHOR_TTL_MS = 30 * 60 * 1000;
  56. /** 锚点记录的识别标记(App 写入时用的 mimeType) */
  57. var ANCHOR_MIME = 'application/x-fmode-anchor';
  58. function _ok(response, data) {
  59. var body = { code: 200 };
  60. if (data) for (var k in data) body[k] = data[k];
  61. response.status(200).json(body);
  62. }
  63. function _fail(response, code, msg) {
  64. response.status(200).json({ code: code, msg: msg });
  65. }
  66. function _str(v, max) {
  67. if (v === undefined || v === null) return '';
  68. var s = String(v).trim();
  69. return max && s.length > max ? s.slice(0, max) : s;
  70. }
  71. function _num(v) {
  72. var n = Number(v);
  73. return isFinite(n) && n >= 0 ? n : null;
  74. }
  75. function _sessionToken() {
  76. // 与 fmodeagent-status 同口径:请求头优先(平台实测只保留请求头)
  77. if (request.headers && request.headers['x-parse-session-token']) {
  78. return request.headers['x-parse-session-token'];
  79. }
  80. if (params && params.token) return params.token;
  81. if (request.body && request.body.token) return request.body.token;
  82. return null;
  83. }
  84. async function _getUser(t) {
  85. if (!t) return null;
  86. if (request.user && request.user.id) return request.user;
  87. try {
  88. var q = new Parse.Query(Parse.Session);
  89. q.equalTo('sessionToken', t);
  90. q.include('user');
  91. var s = await q.first({ useMasterKey: true });
  92. return s ? s.get('user') : null;
  93. } catch (e) {
  94. return null;
  95. }
  96. }
  97. /**
  98. * 反查容器产出的文件属于哪个群(v0.2.0)。
  99. *
  100. * ## 为什么需要
  101. *
  102. * 伪群聊下容器只在自己的 DM 房间工作,回报文件时**不知道群**。
  103. * App 在派活前为每个目标容器记了一条锚点(`uploadedBy:'agent'` +
  104. * `ANCHOR_MIME`),锚点上带着 `groupId` / `agentId` / `roomId`。
  105. * 容器产出到达时,按「同 user + 同 agentId + 同 roomId + 时间在锚点之后」匹配。
  106. *
  107. * ## 宁可漏,不归错(用户裁决)
  108. *
  109. * - 有多条候选锚点 → **不认**(同时被多个群派活的典型场景,认了就会串台)
  110. * - 锚点太旧(超出 TTL)→ 不认
  111. * - 匹配不到 → 返回 '',文件照常登记,只是不归群
  112. *
  113. * @returns {{ groupId: string }} 命中返回群 id,否则空串
  114. */
  115. async function _resolveGroup(user, agentId, roomId) {
  116. if (!agentId) return '';
  117. var q = new Parse.Query(CLASS_NAME);
  118. q.equalTo('user', user);
  119. q.equalTo('agentId', agentId);
  120. q.equalTo('uploadedBy', 'agent');
  121. q.equalTo('mimeType', ANCHOR_MIME);
  122. q.greaterThan('deliveredAt', new Date(Date.now() - GROUP_ANCHOR_TTL_MS));
  123. q.descending('deliveredAt');
  124. q.limit(10);
  125. var rows;
  126. try {
  127. rows = await q.find({ useMasterKey: true });
  128. } catch (e) {
  129. if (!_isMissingColumn(e)) throw e;
  130. await _ensureColumns();
  131. rows = await q.find({ useMasterKey: true });
  132. }
  133. if (rows.length === 0) return '';
  134. /*
  135. * 🔴 唯一性要求:窗口内必须只有**同一个群**的锚点。
  136. *
  137. * 同一容器被群 G 和群 H 先后派活 → 有两条锚点指向不同群 →
  138. * 无法判断这个文件是谁的 → 不认。这是「不串台」的底线,
  139. * 代价是这种并发场景下文件不归群(仍会出现在单聊里)。
  140. */
  141. var groups = new Set();
  142. for (var i = 0; i < rows.length; i++) {
  143. var g = rows[i].get('groupId') || '';
  144. if (g) groups.add(g);
  145. }
  146. if (groups.size !== 1) return '';
  147. return groups.values().next().value || '';
  148. }
  149. /** 云盘链接只接受本平台域名,防止登记任意外链冒充成果 */
  150. function _isCloudUrl(u) {
  151. return /^https:\/\/(s3|file-cloud)\.fmode\.cn\//i.test(u);
  152. }
  153. /**
  154. * 校验 `groupId` 确实是**本用户的群会话**(v0.2.0)。
  155. *
  156. * 🔴 为什么必须校验:`groupId` 是隔离边界。若不校验,客户端可以传任意字符串,
  157. * 把文件"归"到一个不存在的群或别人的群 —— 隔离就成了摆设。
  158. *
  159. * 会话目录在 `FmodeChatThread` 表,`kind === 'group'` 才是群。
  160. * 查不到 / 不是群 / 不是本人 → 一律拒绝。
  161. */
  162. async function _isOwnGroup(user, groupId) {
  163. if (!groupId) return false;
  164. try {
  165. var q = new Parse.Query('FmodeChatThread');
  166. q.equalTo('user', user);
  167. q.equalTo('objectId', groupId);
  168. var row = await q.first({ useMasterKey: true });
  169. if (!row) return false;
  170. var kind = String(row.get('kind') || '').toLowerCase();
  171. return kind === 'group';
  172. } catch (e) {
  173. /* 表不存在或查询失败 → 保守拒绝,宁可登记成"不归群" */
  174. return false;
  175. }
  176. }
  177. /**
  178. * 确保 class 上存在某个列(2026-11-10)。
  179. *
  180. * 🔴 Parse 的自动建列**只在写入时发生**:数据库里还没有 `threadRoot` 列时,
  181. * 直接 `equalTo('threadRoot', x)` 会让 PostgreSQL 报 42703 errorMissingColumn。
  182. * 历史数据本来就没有这个字段,所以第一次查询必然踩到。
  183. *
  184. * 做法:写一个带该字段的探测对象再立刻销毁,把列建出来。
  185. * 只在捕获到缺列错误时执行一次,正常路径零开销。
  186. */
  187. var _ensured = false;
  188. /**
  189. * 一次性建出所有新列。
  190. *
  191. * 历史数据里这些字段一个都不存在,分散建列会让每个字段都触发一次
  192. * 失败查询 + 重试,这里一次建全,后续查询零开销。
  193. */
  194. async function _ensureColumns() {
  195. if (_ensured) return;
  196. var probe = new Parse.Object(CLASS_NAME);
  197. probe.set('threadRoot', '');
  198. probe.set('fileUrl', '');
  199. probe.set('uploadedBy', '');
  200. probe.set('fileName', '');
  201. probe.set('fileSize', 0);
  202. probe.set('mimeType', '');
  203. probe.set('storageKey', '');
  204. probe.set('roomId', '');
  205. /* v0.2.0(2026-11-11):群隔离字段 */
  206. probe.set('groupId', '');
  207. probe.set('groupIdSource', '');
  208. probe.set('scope', '');
  209. await probe.save(null, { useMasterKey: true });
  210. // 探测对象必须销毁,否则会在成果列表里留下一条空记录
  211. await probe.destroy({ useMasterKey: true });
  212. _ensured = true;
  213. }
  214. /**
  215. * 判断是否「列不存在」错误。
  216. *
  217. * 🔴 只认 PostgreSQL 的错误码,不能按字段名匹配 ——
  218. * 查询语句本身就包含字段名,按名匹配会让任何错误都被当成缺列。
  219. */
  220. function _isMissingColumn(e) {
  221. try {
  222. var s = JSON.stringify(e);
  223. return s.indexOf('42703') >= 0 || s.indexOf('errorMissingColumn') >= 0;
  224. } catch (e2) {
  225. return false;
  226. }
  227. }
  228. // ==================== 行 → 返回对象 ====================
  229. function _toFile(r) {
  230. var artifacts = r.get('artifacts') || [];
  231. var first = Array.isArray(artifacts) && artifacts.length ? artifacts[0] : null;
  232. if (typeof first === 'string') first = { url: first, name: '' };
  233. return {
  234. id: r.id,
  235. threadRoot: r.get('threadRoot') || '',
  236. /* v0.2.0:所属群会话 id;'' = 不属于任何群 */
  237. groupId: r.get('groupId') || '',
  238. groupIdSource: r.get('groupIdSource') || '',
  239. agentId: r.get('agentId') || '',
  240. roomId: r.get('roomId') || '',
  241. // 文件信息优先取新字段,回退到 artifacts[0](两者写入时保持一致)
  242. name: r.get('fileName') || (first && first.name) || '',
  243. size: typeof r.get('fileSize') === 'number' ? r.get('fileSize') : -1,
  244. mimeType: r.get('mimeType') || (first && first.mimeType) || '',
  245. url: (first && first.url) || '',
  246. storageKey: r.get('storageKey') || '',
  247. uploadedBy: r.get('uploadedBy') || 'agent',
  248. status: r.get('status') || 'delivered',
  249. deliveredAt: (r.get('deliveredAt') || r.get('createdAt'))
  250. ? new Date(r.get('deliveredAt') || r.get('createdAt')).getTime()
  251. : 0,
  252. };
  253. }
  254. /**
  255. * 过滤掉**派发锚点**记录(v0.2.0)。
  256. *
  257. * 锚点是 App 在派活前写的内部记录(`mimeType = ANCHOR_MIME`),
  258. * 只用来反查文件归属,**不是文件**,不能出现在任何列表里。
  259. */
  260. function _toFiles(rows) {
  261. var out = [];
  262. for (var i = 0; i < rows.length; i++) {
  263. if (rows[i].get('mimeType') === ANCHOR_MIME) continue;
  264. out.push(_toFile(rows[i]));
  265. }
  266. return out;
  267. }
  268. // ==================== actions ====================
  269. /**
  270. * registerFile —— 登记一条文件记录
  271. *
  272. * 用户上传(uploadedBy:'user')与容器产出(uploadedBy:'agent')共用。
  273. * 幂等:同一 (user, threadRoot, url) 重复登记返回已有记录,不产生重复。
  274. */
  275. async function opRegisterFile(user, response) {
  276. var p = params || {};
  277. var threadRoot = _str(p.threadRoot, LEN.threadRoot);
  278. var url = _str(p.url, LEN.url);
  279. var name = _str(p.name, LEN.name);
  280. if (!threadRoot) return _fail(response, 400, 'threadRoot required');
  281. if (!url) return _fail(response, 400, 'url required');
  282. if (!_isCloudUrl(url)) return _fail(response, 400, 'url must be a platform cloud link');
  283. if (!name) return _fail(response, 400, 'name required');
  284. var size = _num(p.size);
  285. if (size !== null && size > MAX_FILE_BYTES) return _fail(response, 400, 'file too large');
  286. var uploadedBy = p.uploadedBy === 'user' ? 'user' : 'agent';
  287. var agentId = _str(p.agentId, LEN.agentId);
  288. /*
  289. * 群归属(v0.2.0,2026-11-11)。
  290. *
  291. * 传了 `groupId` 就必须是本用户的群,否则拒绝 —— 见 `_isOwnGroup`。
  292. * 没传或校验不过 → `groupId` 留空,按原来的「只按会话」处理,
  293. * 不影响存量调用方。
  294. */
  295. var groupId = _str(p.groupId, LEN.threadRoot);
  296. if (groupId) {
  297. var ok = await _isOwnGroup(user, groupId);
  298. if (!ok) return _fail(response, 400, 'groupId must be your own group session');
  299. } else if (uploadedBy === 'agent' && _str(p.mimeType, LEN.mime) !== ANCHOR_MIME) {
  300. /*
  301. * 容器产出没带 groupId → 反查派发锚点(v0.2.0)。
  302. *
  303. * 用户上传(uploadedBy='user')不做反查:App 知道群,直接传就行。
  304. * 锚点记录本身(ANCHOR_MIME)也跳过,否则会自己匹配自己。
  305. */
  306. groupId = await _resolveGroup(user, agentId, _str(p.roomId, LEN.roomId));
  307. }
  308. /*
  309. * 幂等:同一会话内同一 URL 只存一条。
  310. *
  311. * 🔴 不能查 `artifacts.url`(数组内字段)—— 实测该查询永远匹配不到,
  312. * 会导致重复登记。改查顶层 `fileUrl`:registerFile 写入时同步落一份。
  313. * 该列首次查询时也不存在,需要建列后重试(见 _ensureColumn)。
  314. */
  315. var dupQ = new Parse.Query(CLASS_NAME);
  316. dupQ.equalTo('user', user);
  317. dupQ.equalTo('threadRoot', threadRoot);
  318. dupQ.equalTo('fileUrl', url);
  319. var dup;
  320. try {
  321. dup = await dupQ.first({ useMasterKey: true });
  322. } catch (e) {
  323. if (!_isMissingColumn(e)) throw e;
  324. await _ensureColumns();
  325. dup = await dupQ.first({ useMasterKey: true });
  326. }
  327. if (dup) return _ok(response, { id: dup.id, duplicated: true });
  328. var obj = new Parse.Object(CLASS_NAME);
  329. obj.set('user', user);
  330. /*
  331. * 🔴 反查命中的群文件,`threadRoot` **一并改写为群 id**(v0.2.0)。
  332. *
  333. * 这是「不串台」的落地:一条文件只能属于一个页签。
  334. * 若仍保留 DM thread,单聊 `listBySession(dm)` 也会返回它 ——
  335. * 同一个文件在单聊和群里各出现一次。
  336. *
  337. * 原始的 DM thread 存进 `prevThreadRoot`,出问题可据此还原。
  338. */
  339. var resolvedByAnchor = !p.groupId && !!groupId;
  340. obj.set('threadRoot', resolvedByAnchor ? groupId : threadRoot);
  341. if (resolvedByAnchor) obj.set('prevThreadRoot', threadRoot);
  342. obj.set('groupId', groupId);
  343. obj.set(
  344. 'groupIdSource',
  345. groupId ? (resolvedByAnchor ? 'anchor' : _str(p.groupIdSource, 20) || 'app') : '',
  346. );
  347. obj.set('roomId', _str(p.roomId, LEN.roomId));
  348. obj.set('agentId', agentId);
  349. obj.set('uploadedBy', uploadedBy);
  350. obj.set('fileName', name);
  351. obj.set('fileSize', size === null ? -1 : size);
  352. obj.set('mimeType', _str(p.mimeType, LEN.mime));
  353. obj.set('storageKey', _str(p.key, LEN.key));
  354. /* 幂等键:顶层单独存一份 URL,见 opRegisterFile 的去重说明 */
  355. obj.set('fileUrl', url);
  356. obj.set('title', name);
  357. obj.set('summary', p.source ? '容器产出' : '用户上传');
  358. obj.set('status', 'delivered');
  359. obj.set('deliveredAt', new Date());
  360. obj.set('reportedAt', new Date());
  361. obj.set('tags', ['file-hub', uploadedBy]);
  362. /*
  363. * artifacts 保留数组形态:App 现有的 Deliverable 映射(mapDeliverable)
  364. * 按 artifacts[0].url 取链接,写在这里就不用改 App 的解析层。
  365. */
  366. obj.set('artifacts', [
  367. {
  368. name: name,
  369. url: url,
  370. type: _str(p.mimeType, LEN.mime),
  371. source: _str(p.source, LEN.url),
  372. },
  373. ]);
  374. // ACL:只给本人读写(成果属于个人会话,不跨用户可见)
  375. var acl = new Parse.ACL(user);
  376. acl.setPublicReadAccess(false);
  377. acl.setPublicWriteAccess(false);
  378. obj.setACL(acl);
  379. // 公司指针从 agent 带过来,保持与老成果表一致的多租户口径
  380. if (agentId) {
  381. try {
  382. var aq = new Parse.Query('FmodeAgent');
  383. aq.equalTo('agentId', agentId);
  384. var agent = await aq.first({ useMasterKey: true });
  385. if (agent) {
  386. obj.set('agent', agent);
  387. obj.set('agentObjectId', agent.id);
  388. var company = agent.get('company');
  389. if (company) obj.set('company', company);
  390. if (!agentId) obj.set('agentId', agent.get('agentId') || '');
  391. }
  392. } catch (e) {
  393. /* agent 查不到不影响登记:文件仍归属到用户与会话 */
  394. }
  395. }
  396. var saved = await obj.save(null, { useMasterKey: true });
  397. return _ok(response, { id: saved.id });
  398. }
  399. /**
  400. * listBySession —— 按会话拉文件(右侧栏主路径)
  401. *
  402. * 这是用户要求「每次直接从数据库加载文件」的入口:
  403. * 不依赖加载聊天历史,也不依赖 FmodeChatThread.deliverableUrls。
  404. */
  405. async function opListBySession(user, response) {
  406. var p = params || {};
  407. var threadRoot = _str(p.threadRoot, LEN.threadRoot);
  408. if (!threadRoot) return _fail(response, 400, 'threadRoot required');
  409. var q = new Parse.Query(CLASS_NAME);
  410. q.equalTo('user', user);
  411. q.equalTo('threadRoot', threadRoot);
  412. if (p.before) {
  413. var before = new Date(Number(p.before));
  414. if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
  415. }
  416. q.descending('deliveredAt');
  417. q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
  418. var rows;
  419. try {
  420. rows = await q.find({ useMasterKey: true });
  421. } catch (e) {
  422. // 列还不存在 → 建列后重试一次(历史数据没有 threadRoot,首次查询必然走到这里)
  423. if (!_isMissingColumn(e)) throw e;
  424. await _ensureColumns();
  425. rows = await q.find({ useMasterKey: true });
  426. }
  427. var list = _toFiles(rows);
  428. return _ok(response, {
  429. threadRoot: threadRoot,
  430. files: list,
  431. count: list.length,
  432. });
  433. }
  434. /** listByAgent —— 按容器拉(成果页用,不按会话过滤) */
  435. async function opListByAgent(user, response) {
  436. var p = params || {};
  437. var q = new Parse.Query(CLASS_NAME);
  438. q.equalTo('user', user);
  439. var agentId = _str(p.agentId, LEN.agentId);
  440. if (agentId) q.equalTo('agentId', agentId);
  441. if (p.before) {
  442. var before = new Date(Number(p.before));
  443. if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
  444. }
  445. q.descending('deliveredAt');
  446. q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
  447. var rows = await q.find({ useMasterKey: true });
  448. var list = _toFiles(rows);
  449. return _ok(response, { files: list, count: list.length });
  450. }
  451. /**
  452. * listByGroup —— 按**群**拉文件(v0.2.0,2026-11-11)
  453. *
  454. * ## 为什么不能只用 threadRoot
  455. *
  456. * 群里的文件有两种来源:
  457. * · **用户上传**:写入时 `threadRoot = groupId`(历史数据也只有 threadRoot)
  458. * · **容器产出**:容器只知道 DM thread,由服务端反查/补归并后
  459. * `threadRoot` 改写为群 id、同时补 `groupId`
  460. *
  461. * 查询用 `groupId == g OR threadRoot == g`,两条来源都能覆盖,
  462. * 也让**没有 groupId 的存量群内上传记录**照样查得到(无需数据迁移)。
  463. */
  464. async function opListByGroup(user, response) {
  465. var p = params || {};
  466. var groupId = _str(p.groupId, LEN.threadRoot);
  467. if (!groupId) return _fail(response, 400, 'groupId required');
  468. var byGroup = new Parse.Query(CLASS_NAME);
  469. byGroup.equalTo('user', user);
  470. byGroup.equalTo('groupId', groupId);
  471. var byThread = new Parse.Query(CLASS_NAME);
  472. byThread.equalTo('user', user);
  473. byThread.equalTo('threadRoot', groupId);
  474. var q = Parse.Query.or(byGroup, byThread);
  475. if (p.before) {
  476. var before = new Date(Number(p.before));
  477. if (!isNaN(before.getTime())) q.lessThan('deliveredAt', before);
  478. }
  479. q.descending('deliveredAt');
  480. q.limit(Math.min(Number(p.limit) || DEFAULT_LIMIT, MAX_LIMIT));
  481. var rows;
  482. try {
  483. rows = await q.find({ useMasterKey: true });
  484. } catch (e) {
  485. if (!_isMissingColumn(e)) throw e;
  486. await _ensureColumns();
  487. rows = await q.find({ useMasterKey: true });
  488. }
  489. var list = _toFiles(rows);
  490. return _ok(response, { groupId: groupId, files: list, count: list.length });
  491. }
  492. /**
  493. * claimToGroup —— 惰性补归并(v0.2.0,2026-11-11)
  494. *
  495. * 有些容器产出登记时没能确定归属群(`groupId=''`)。群页面打开时,
  496. * App 把「有把握属于本群」的记录 id 传进来,这里把它们**搬**到群上:
  497. * 补 `groupId`、把 `threadRoot` 改写为群 id。
  498. *
  499. * 🔴 改写 threadRoot 是「互斥」的落地:一条文件只能出现在一个页签 ——
  500. * 搬进群之后,单聊 `listBySession(单聊sid)` 自然查不到它了。
  501. *
  502. * 安全:只允许操作**本人**的、`uploadedBy='agent'`(容器产出)、
  503. * 且当前 `groupId` 为空的记录。用户上传的文件不允许被搬。
  504. */
  505. async function opClaimToGroup(user, response) {
  506. var p = params || {};
  507. var groupId = _str(p.groupId, LEN.threadRoot);
  508. var ids = Array.isArray(p.ids) ? p.ids.filter((x) => typeof x === 'string' && x) : [];
  509. if (!groupId) return _fail(response, 400, 'groupId required');
  510. if (ids.length === 0) return _fail(response, 400, 'ids required');
  511. if (!(await _isOwnGroup(user, groupId))) {
  512. return _fail(response, 400, 'groupId must be your own group session');
  513. }
  514. var claimed = 0;
  515. var skipped = 0;
  516. for (var i = 0; i < ids.length && i < 100; i++) {
  517. var obj;
  518. try {
  519. var q = new Parse.Query(CLASS_NAME);
  520. q.equalTo('user', user);
  521. obj = await q.get(ids[i], { useMasterKey: true });
  522. } catch (e) {
  523. skipped++;
  524. continue;
  525. }
  526. if (!obj) {
  527. skipped++;
  528. continue;
  529. }
  530. if (obj.get('uploadedBy') !== 'agent' || obj.get('groupId')) {
  531. skipped++;
  532. continue;
  533. }
  534. try {
  535. /* 留一份原 threadRoot,便于出问题时还原 */
  536. if (!obj.get('prevThreadRoot')) obj.set('prevThreadRoot', obj.get('threadRoot') || '');
  537. obj.set('groupId', groupId);
  538. obj.set('groupIdSource', 'claim');
  539. obj.set('threadRoot', groupId);
  540. await obj.save(null, { useMasterKey: true });
  541. claimed++;
  542. } catch (e) {
  543. skipped++;
  544. }
  545. }
  546. return _ok(response, { groupId: groupId, claimed: claimed, skipped: skipped });
  547. }
  548. // ==================== 入口 ====================
  549. function handler(request, response) {
  550. (async function () {
  551. var p = params || {};
  552. var act = p.action || 'listBySession';
  553. var token = _sessionToken();
  554. var user = await _getUser(token);
  555. if (!user) return _fail(response, 401, 'invalid session');
  556. try {
  557. if (act === 'registerFile') return await opRegisterFile(user, response);
  558. if (act === 'listBySession') return await opListBySession(user, response);
  559. if (act === 'listByAgent') return await opListByAgent(user, response);
  560. /* v0.2.0(2026-11-11):群隔离 */
  561. if (act === 'listByGroup') return await opListByGroup(user, response);
  562. if (act === 'claimToGroup') return await opClaimToGroup(user, response);
  563. return _fail(response, 400, 'unknown action: ' + act);
  564. } catch (e) {
  565. /*
  566. * Parse 的异常对象字符串化是 `[object Object]`,直接丢出去排查不了。
  567. * 新函数上线初期必须能看到真实原因(字段不存在 / 索引缺失等)。
  568. */
  569. var msg = 'unknown';
  570. try {
  571. msg = (e && (e.message || e.error || e.code)) || String(e);
  572. if (typeof msg === 'object') msg = JSON.stringify(msg);
  573. } catch (e2) {
  574. msg = String(e);
  575. }
  576. return _fail(response, 500, String(msg));
  577. }
  578. })();
  579. }