fmode-app/cloud/functions

云函数源码（随项目版本化）

平台把云函数存在 Parse 库的 Function 表（objectId 即前端调用的函数 id）。 本目录保存源码副本，便于 code review 与回滚；发布方式见下。

已发布

文件	Function.objectId	name	path	version
fmodeagent-chatthreads.js	oR5O67i1Cm	fmodeagent-chatthreads	/fmodeagent/chatthreads	0.1.6（与线上一致，2026-11-06 对齐）
fmodeagent-status.js	xlosi3m46q	fmodeagent-status	/fmodeagent/status	v0.0.9（余额口径修复，2026-11-11 已上线）
fmode-file-hub.js	THXAOGKiPK	fmode-file-hub	/fmodeagent/file-hub	v0.2.0（群隔离，2026-11-11 已上线）
fmode-file-read.js	tocXyQjyh6	fmode-file-read	/fmodeagent/file-read	v0.1.0（云盘文本代理，2026-11-11 新建）

fmode-file-read v0.1.0（2026-11-11 新建） 云盘 s3.fmode.cn 是 public-read 但没配 CORS，浏览器 fetch 必被拦， .md / .txt 在页内渲染不出来。本函数在服务端取正文再回传， 浏览器只调本域（已配 ACAO:*）。三条安全约束：只放行云盘域名（防 SSRF）、 必须有效 session、2MB 上限。 实测：读取 w-test.md 返回 {"code":200,"text":"测试\n"}； 非云盘域名 → 400；无 token → 401。

fmode-file-hub v0.2.0（2026-11-11 群隔离） 伪群聊下容器只在自己的 DM 房间工作、回报文件时不知道群。 新增字段 groupId / groupIdSource / prevThreadRoot，新增 action listByGroup / claimToGroup。App 在派活前写一条派发锚点 （mimeType = application/x-fmode-anchor），容器产出登记时服务端按 「同 user + 同 agentId + 同 roomId + 30 分钟内」反查归属。 多群同时派活时不认（宁可漏，不归错）；命中后 threadRoot 一并改写为群 id， 保证一条文件只出现在一个页签。 回滚：cloud/backup/THXAOGKiPK-fmode-file-hub-live-20261111-before-v0.2.0.json。

v0.0.9 说明（2026-11-11） 余额口径修复：旧实现用 fmodeApiToken 调 api.fmode.cn/api/usage/token/ 取 total_available 再自行换汇， 而该令牌是 unlimited_quota: true → 线上 App 显示 -76.12，Studio 充值页实际 948.09。 新版改为与 Studio 同源：POST /api/fmode/billing/query（data.balance.availableCny）优先， POST /api/fmode/newapi/user（data.user.balance）回落；不再自行换算；unlimited_quota 令牌被明确拒绝。 缓存键改为按用户 objectId（__FM9_BAL_CACHE）、TTL 60s（原 300s 且不区分用户）。 上线前已本地仿真：新旧实现分别对真实接口取数 → 新实现 948.09 ✅ / 旧实现 -76.12 ❌。 回滚：cloud/backup/xlosi3m46q-fmodeagent-status-live-20261111-before-v0.0.9.json（改前线上全文）， PUT {code: <该文件 code>} 即回到改前状态。 本文件以线上当前代码为基线（线上比 -v0.1.2.patched.js 新，别拿旧备份覆盖）。

v0.1.6 说明（2026-11-06） 群会话需要在会话目录里区分出来，靠两个字段：kind（dm/group）与 memberIds（成员容器 id）。 这两个字段此前只存在于线上，工作区源码仍停在 v0.1.5 —— 直接部署工作区这份会把线上功能回退掉。 本次已补齐 opUpsert 写入与 opList 返回，并用本地仿真验证 8 项语义（含「不带 kind 的后续 upsert 不得把群降级成单聊」）。 部署前务必先校验：node scripts/verify-cloud-fn.mjs（对比线上返回的字段集）。

v0.1.4：工作区归属 workspaceId（'' = 日常对话）。

发布 / 热更

# 新建（objectId 自动生成）
curl -X POST https://server.fmode.cn/parse/classes/Function \
  -H "X-Parse-Application-Id: ncloudmaster" -H "X-Parse-Master-Key: <MK>" \
  -H "Content-Type: application/json" -d '{"name":"...","code":"...","enabled":true,...}'

# 热更（免重启）
curl -X PUT https://server.fmode.cn/parse/classes/Function/<objectId> \
  -H "X-Parse-Application-Id: ncloudmaster" -H "X-Parse-Master-Key: <MK>" \
  -H "Content-Type: application/json" -d '{"code":"..."}'

函数体约定（从现有函数反推，实测）

• 入口：async function handler(request, response)；入参在全局 params。
• 身份：request.user 由平台按 X-Parse-Session-Token 解析后注入。
• 🔴 输出必须 response.status(200).json(...) 显式写出；直接 return 对象 平台不回包（请求挂起）。
• token 只能放 X-Parse-Session-Token 请求头；放 body 的 token 字段会被平台鉴权层直接 401。