deploy-cloud-fn.mjs 7.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228
  1. #!/usr/bin/env node
  2. /**
  3. * 云函数热更脚本(本地使用,不部署、不上传)
  4. *
  5. * ## 用途
  6. *
  7. * 把 `cloud/functions/*.js` 的最新源码推到线上 Parse 的 `Function` 表。
  8. * 热更免重启(`PUT /parse/classes/Function/<objectId>`)。
  9. *
  10. * ## 为什么需要 Master-Key
  11. *
  12. * 写 `Function` 表属于平台管理操作,只有 Master-Key 有权限。
  13. * 🔴 **Master-Key 绝不能写进代码或提交进 git**,只能通过环境变量传入:
  14. *
  15. * ```bash
  16. * PARSE_MASTER_KEY=xxx node scripts/deploy-cloud-fn.mjs
  17. * PARSE_MASTER_KEY=xxx node scripts/deploy-cloud-fn.mjs --dry-run
  18. * ```
  19. *
  20. * ## 安全
  21. *
  22. * · 默认 **dry-run**:只打印将要更新什么,不发请求
  23. * · `--apply` 才真正 PUT
  24. * · 不发请求前先 GET 一次,对比线上版本,避免误覆盖别人改过的代码
  25. *
  26. * ## 频率限制
  27. *
  28. * 实测:`PUT` 连续请求会返回 403,需退避重试(见操作追踪 :3125)。
  29. */
  30. import { readFileSync } from 'node:fs';
  31. import { dirname, resolve } from 'node:path';
  32. import { fileURLToPath } from 'node:url';
  33. const here = dirname(fileURLToPath(import.meta.url));
  34. const root = resolve(here, '..');
  35. const APP_ID = 'ncloudmaster';
  36. const BASE = 'https://server.fmode.cn/parse';
  37. const MK = process.env.PARSE_MASTER_KEY;
  38. const APPLY = process.argv.includes('--apply');
  39. /**
  40. * 只部署指定函数(2026-11-12 新增)。
  41. *
  42. * 背景:本地保存的是各函数的源码副本,但不保证与线上随时同步 ——
  43. * 别人可能在控制台改过线上版本。批量 `--apply` 会把本地较旧的副本推上去,
  44. * 覆盖掉那些改动。
  45. *
  46. * 用法:`--only=fmodeagent-matrix-provision`(按 name 或 id 精确匹配)
  47. */
  48. const ONLY = (process.argv.find((a) => a.startsWith('--only=')) ?? '').slice('--only='.length);
  49. /** 要部署的函数清单
  50. *
  51. * `create: true` 表示「线上还没这条就新建」——新建后会在控制台打印 objectId,
  52. * 需要把它写回 `src/app/core/api/parse-api.ts` 的 `FN` 常量。
  53. */
  54. const TARGETS = [
  55. {
  56. file: 'cloud/functions/fmodeagent-chatthreads.js',
  57. id: 'oR5O67i1Cm',
  58. name: 'fmodeagent-chatthreads',
  59. version: '0.1.9',
  60. },
  61. {
  62. file: 'cloud/functions/fmodeagent-matrix-provision.js',
  63. id: 'RP5Ht55NeX',
  64. name: 'fmodeagent-matrix-provision',
  65. version: '0.1.6',
  66. },
  67. {
  68. file: 'cloud/functions/fmode-file-hub.js',
  69. id: null, // 新建前未知,部署时按 name 查
  70. name: 'fmode-file-hub',
  71. /* v0.3.0(2026-11-13):归属主键切 roomId + 新增 listByUrl */
  72. version: '0.3.0',
  73. create: true,
  74. },
  75. {
  76. /* 2026-11-21:v0.2.0 修复「无鉴权」—— 初版不带任何身份即可给任意用户发推送 */
  77. file: 'cloud/functions/fmodeagent-push.js',
  78. id: 'oCRJCCdiAx',
  79. name: 'fmodeagent-push',
  80. version: '0.2.0',
  81. },
  82. {
  83. /* 2026-11-21:新建。Matrix 新消息 → 调极光(服务端触发链路,此前完全缺失) */
  84. file: 'cloud/functions/fmodeagent-push-watch.js',
  85. id: null,
  86. name: 'fmodeagent-push-watch',
  87. version: '0.1.0',
  88. create: true,
  89. },
  90. ];
  91. function authHeaders() {
  92. return {
  93. 'X-Parse-Application-Id': APP_ID,
  94. 'X-Parse-Master-Key': MK,
  95. 'Content-Type': 'application/json',
  96. };
  97. }
  98. async function getRemote(id) {
  99. const res = await fetch(`${BASE}/classes/Function/${id}`, { headers: authHeaders() });
  100. if (!res.ok) throw new Error(`读取失败 HTTP ${res.status}`);
  101. return res.json();
  102. }
  103. /** 按函数名查 objectId(新建前用于判断「线上是否已存在」) */
  104. async function findByName(name) {
  105. const where = encodeURIComponent(JSON.stringify({ name }));
  106. const res = await fetch(`${BASE}/classes/Function?where=${where}&limit=1`, {
  107. headers: authHeaders(),
  108. });
  109. if (!res.ok) throw new Error(`按名查询失败 HTTP ${res.status}`);
  110. const j = await res.json();
  111. return (j.results ?? [])[0] ?? null;
  112. }
  113. /** 新建云函数(POST /classes/Function),返回新 objectId */
  114. async function createRemote(name, code, version) {
  115. const res = await fetch(`${BASE}/classes/Function`, {
  116. method: 'POST',
  117. headers: authHeaders(),
  118. body: JSON.stringify({ name, code, version, enabled: true }),
  119. });
  120. const text = await res.text();
  121. if (!res.ok) throw new Error(`新建失败 HTTP ${res.status}: ${text.slice(0, 200)}`);
  122. const j = JSON.parse(text);
  123. return j.objectId;
  124. }
  125. /** PUT 有频率限制,403 时退避重试 */
  126. async function putRemote(id, body, attempt = 1) {
  127. const res = await fetch(`${BASE}/classes/Function/${id}`, {
  128. method: 'PUT',
  129. headers: authHeaders(),
  130. body: JSON.stringify(body),
  131. });
  132. if (res.status === 403 && attempt <= 4) {
  133. const wait = 1000 * attempt;
  134. console.log(` ⚠️ 403(频率限制),${wait}ms 后重试 ${attempt}/4`);
  135. await new Promise((r) => setTimeout(r, wait));
  136. return putRemote(id, body, attempt + 1);
  137. }
  138. const text = await res.text();
  139. if (!res.ok) throw new Error(`PUT 失败 HTTP ${res.status}: ${text.slice(0, 200)}`);
  140. try {
  141. return JSON.parse(text);
  142. } catch {
  143. return { raw: text.slice(0, 200) };
  144. }
  145. }
  146. async function main() {
  147. if (!MK) {
  148. console.error('❌ 缺少 PARSE_MASTER_KEY 环境变量');
  149. console.error(' 用法:PARSE_MASTER_KEY=xxx node scripts/deploy-cloud-fn.mjs [--apply]');
  150. process.exit(2);
  151. }
  152. console.log(APPLY ? '🔴 APPLY:将热更线上云函数' : '🟡 DRY-RUN:只对比,不写入');
  153. if (ONLY) console.log(`🎯 只处理:${ONLY}`);
  154. for (const t of TARGETS) {
  155. /* `--only=` 指定时,跳过不匹配的(按 name 或 id) */
  156. if (ONLY && t.name !== ONLY && t.id !== ONLY) continue;
  157. const code = readFileSync(resolve(root, t.file), 'utf8');
  158. console.log(`\n=== ${t.name} (${t.id ?? '待新建'}) ===`);
  159. console.log(` 本地源码:${t.file},${code.length} 字符,v${t.version}`);
  160. /* 新建分支:线上还没有这条 Function 记录 */
  161. if (t.create) {
  162. let existing = null;
  163. try {
  164. existing = await findByName(t.name);
  165. } catch (e) {
  166. console.log(` ⚠️ 按名查询失败:${e.message}`);
  167. }
  168. if (!existing) {
  169. console.log(' → 线上不存在,将新建');
  170. if (!APPLY) {
  171. console.log(' → 加 --apply 才会真正新建');
  172. continue;
  173. }
  174. const id = await createRemote(t.name, code, t.version);
  175. console.log(` ✅ 已新建,objectId = ${id}`);
  176. console.log(` 🔴 请把它写进 src/app/core/api/parse-api.ts 的 FN 常量`);
  177. continue;
  178. }
  179. t.id = existing.objectId;
  180. console.log(` → 线上已存在,objectId = ${t.id},转为更新`);
  181. }
  182. let remote;
  183. try {
  184. remote = await getRemote(t.id);
  185. } catch (e) {
  186. console.log(` ⚠️ 读取线上失败:${e.message}(跳过对比)`);
  187. remote = null;
  188. }
  189. if (remote) {
  190. const rc = remote.code || '';
  191. console.log(` 线上源码:${rc.length} 字符,v${remote.version ?? '?'}`);
  192. if (rc === code) {
  193. console.log(' ✅ 与线上完全一致,无需部署');
  194. continue;
  195. }
  196. if (rc.length && code.length < rc.length * 0.7) {
  197. console.log(' 🔴 警告:本地源码明显小于线上,可能回退功能,已跳过');
  198. continue;
  199. }
  200. }
  201. if (!APPLY) {
  202. console.log(' → 加 --apply 才会真正热更');
  203. continue;
  204. }
  205. const r = await putRemote(t.id, { code, version: t.version, enabled: true });
  206. console.log(` ✅ 已热更:${JSON.stringify(r).slice(0, 120)}(免重启,立即生效)`);
  207. }
  208. }
  209. main().catch((e) => {
  210. console.error('❌ 执行失败:', e.message);
  211. process.exit(1);
  212. });