test-push.mjs 12 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309
  1. #!/usr/bin/env node
  2. /**
  3. * 推送链路测试脚本(AI 自动测试用)
  4. *
  5. * 配套手册:docs/05-operations/推送链路测试手册-AI自动测试用.md
  6. *
  7. * 子命令:
  8. * --status 汇总设备/App/权限/游标/最近推送
  9. * --check-room 看 lj-test 房间最新事件(含 turn_status)
  10. * --trigger 调监听函数并打印结果
  11. * --notify '<json>' 直接推一条(验证通知链路本身)
  12. * --cdp '<expr>' 在 WebView 里执行表达式
  13. * --watch [秒] 循环调监听函数,直到 pushed>0 或超时
  14. *
  15. * 用法:
  16. * node scripts/test-push.mjs --status
  17. * node scripts/test-push.mjs --trigger
  18. * node scripts/test-push.mjs --notify '{"title":"测试","body":"内容"}'
  19. * node scripts/test-push.mjs --watch 180
  20. *
  21. * 设计说明:
  22. * · 所有判据都打印原始数据,不替使用者下结论(避免脚本自己误判)
  23. * · 任何一步失败都给出**可执行的下一步建议**,而不是只报错
  24. */
  25. import { execFileSync } from 'node:child_process';
  26. const ADB = process.env.ADB_PATH || 'E:/coding-environment/adb/adb.exe';
  27. const APP_ID = 'ncloudmaster';
  28. const MASTER_KEY = 'SnkK12*&sunq2#@20!';
  29. const SERVER_TOKEN = 'fmpush-srv-2026-11-c33a9e71';
  30. const PUSH_FN_ID = 'oCRJCCdiAx';
  31. const WATCH_FN_ID = 'KMmY5DxKzs';
  32. const PARSE = 'https://server.fmode.cn/parse';
  33. const FUNCTIONS = 'https://server.fmode.cn/api/functions';
  34. const TEST_USER = 'xhVRjTMwQH';
  35. const TEST_TOKEN = 'r:b64c5748a5be24fda063b5466851c01e';
  36. const LJ_AGENT = 'agent-node-lj-test';
  37. const HS = 'https://matrix.fmode.cn';
  38. const argv = process.argv.slice(2);
  39. const has = (f) => argv.includes(f);
  40. const val = (f) => {
  41. const i = argv.indexOf(f);
  42. return i >= 0 ? argv[i + 1] : undefined;
  43. };
  44. // ---------- 基础工具 ----------
  45. function adb(args, { allowFail = false } = {}) {
  46. try {
  47. return execFileSync(ADB, args, {
  48. encoding: 'utf8',
  49. timeout: 30000,
  50. env: { ...process.env, MSYS_NO_PATHCONV: '1' },
  51. }).trim();
  52. } catch (e) {
  53. if (allowFail) return '';
  54. throw e;
  55. }
  56. }
  57. /**
  58. * 调 Parse REST。
  59. *
  60. * 🔴 这个平台的 Function / FmodePush* 表禁止 GET(返回 403),
  61. * 必须用 `POST` + body 里带 `_method: 'GET'` 的变通写法。
  62. */
  63. async function parseQuery(cls, body) {
  64. const res = await fetch(`${PARSE}/classes/${cls}`, {
  65. method: 'POST',
  66. headers: {
  67. 'X-Parse-Application-Id': APP_ID,
  68. 'X-Parse-Master-Key': MASTER_KEY,
  69. 'Content-Type': 'application/json',
  70. },
  71. body: JSON.stringify({ ...body, _method: 'GET' }),
  72. });
  73. return res.json();
  74. }
  75. async function callFunction(id, params, headers = {}) {
  76. const res = await fetch(FUNCTIONS, {
  77. method: 'POST',
  78. headers: {
  79. 'X-Parse-Application-Id': APP_ID,
  80. 'Content-Type': 'application/json',
  81. ...headers,
  82. },
  83. body: JSON.stringify({ id, params }),
  84. });
  85. const text = await res.text();
  86. try { return { status: res.status, json: JSON.parse(text) }; }
  87. catch { return { status: res.status, raw: text.slice(0, 300) }; }
  88. }
  89. // ---------- 子命令 ----------
  90. /** 设备与 App 状态 */
  91. async function cmdStatus() {
  92. console.log('=== 设备 ===');
  93. const dev = adb(['devices'], { allowFail: true });
  94. const connected = /device\s*$/.test(dev.split('\n').filter((l) => l.includes('\tdevice')).join(''));
  95. console.log(dev.split('\n').slice(1).filter(Boolean).join('\n') || '(未连接)');
  96. if (!connected) {
  97. /*
  98. * 🔴 设备断开时**不要继续输出「已解锁 / 权限正常」这类肯定结论**。
  99. * 之前这里在 adb 失败时读不到锁屏字段,被误判成「已解锁」,
  100. * 会把排查方向带偏。
  101. */
  102. console.log('\n❌ 没有可用设备 —— 后续检查全部跳过。');
  103. console.log(' 请确认数据线连接、USB 调试已开启。');
  104. await dumpServerSide();
  105. return;
  106. }
  107. const pid = adb(['shell', 'pidof', 'cn.fmode.app'], { allowFail: true });
  108. console.log('\n=== App 进程 ===');
  109. console.log(pid ? `运行中 pid=${pid}` : '❌ 未运行 → 先执行 adb shell am start -n cn.fmode.app/.MainActivity');
  110. const lock = adb(['shell', 'dumpsys', 'window'], { allowFail: true });
  111. console.log('\n=== 锁屏 ===');
  112. if (/mDreamingLockscreen=true/.test(lock)) console.log('❌ 已锁屏 → adb 无法解锁,需用户手动解锁');
  113. else if (/mDreamingLockscreen=false/.test(lock)) console.log('✅ 已解锁');
  114. else console.log('⚠️ 读不到锁屏状态(adb 异常)');
  115. const appops = adb(['shell', 'cmd', 'appops', 'get', 'cn.fmode.app', 'POST_NOTIFICATION'], { allowFail: true });
  116. console.log('\n=== 通知权限 ===');
  117. console.log(appops || '(读取失败)');
  118. if (!appops.includes('allow')) {
  119. console.log('❌ 通知权限未开 → 去「设置 → 应用 → Fmode → 允许通知」手动打开(pm grant 不够)');
  120. }
  121. const imp = adb(['shell', 'dumpsys', 'notification'], { allowFail: true });
  122. const m = imp.match(/AppSettings: cn\.fmode\.app[^\n]*importance=(\w+)/);
  123. console.log('\n=== 通知重要性 ===');
  124. console.log(m ? m[1] : '(未读到)');
  125. const notifCount = adb(['shell', 'dumpsys', 'notification', '--noredact'], { allowFail: true })
  126. .split('\n').filter((l) => l.includes('pkg=cn.fmode.app')).length;
  127. console.log('\n=== 通知栏基线 ===');
  128. console.log(`${notifCount} 条(记录这个数字,推送后应增加)`);
  129. console.log('\n=== 最近推送记录 ===');
  130. await dumpServerSide();
  131. }
  132. /** 服务端侧信息(不依赖设备),设备断开时也能查 */
  133. async function dumpServerSide() {
  134. const logs = await parseQuery('FmodePushLog', {
  135. where: { eventId: { $regex: 'turn:' } },
  136. limit: 3,
  137. order: '-pushedAt',
  138. });
  139. console.log('\n=== 最近推送记录(服务端) ===');
  140. for (const o of logs.results || []) {
  141. console.log(` ${o.pushedAt?.iso ?? '?'} ${o.eventId} msgId=${o.msgId || '(空)'}`);
  142. }
  143. if (!(logs.results || []).length) console.log(' (无记录)');
  144. const cursors = await parseQuery('FmodePushCursor', { where: { userId: TEST_USER }, limit: 1000 });
  145. console.log(`\n=== 游标 ===\n 该用户游标数:${(cursors.results || []).length}`);
  146. }
  147. /** 看 lj-test 房间最新事件 */
  148. async function cmdCheckRoom() {
  149. const bindings = await parseQuery('FmodeMatrixBinding', {
  150. where: {
  151. userPointer: { __type: 'Pointer', className: '_User', objectId: TEST_USER },
  152. agentId: LJ_AGENT,
  153. status: 'active',
  154. },
  155. limit: 1,
  156. });
  157. const b = (bindings.results || [])[0];
  158. if (!b) {
  159. console.log('❌ 找不到 lj-test 的 Matrix 绑定记录');
  160. console.log(' 检查 FmodeMatrixBinding 表里是否有 userPointer=' + TEST_USER + ' 且 agentId=' + LJ_AGENT);
  161. return;
  162. }
  163. console.log('房间:', b.roomId);
  164. const res = await fetch(
  165. `${HS}/_matrix/client/v3/rooms/${encodeURIComponent(b.roomId)}/messages?dir=b&limit=10&access_token=${b.accessToken}`,
  166. );
  167. const data = await res.json();
  168. if (!data.chunk) {
  169. console.log('❌ 读取房间失败:', JSON.stringify(data).slice(0, 200));
  170. return;
  171. }
  172. console.log('\n最新 10 条事件(倒序):');
  173. for (const ev of data.chunk) {
  174. const c = ev.content || {};
  175. const kind = ev.type === 'com.fmode.turn_status' ? `TURN ${c.status}` : ev.type.replace('m.room.', '');
  176. const text = c.body ? String(c.body).replace(/\s+/g, ' ').slice(0, 40) : '';
  177. const ts = new Date(ev.origin_server_ts).toISOString().slice(11, 19);
  178. console.log(` ${ts} ${kind.padEnd(18)} ${text}`);
  179. }
  180. const idle = data.chunk.find((e) => e.type === 'com.fmode.turn_status' && e.content?.status === 'idle');
  181. console.log('\n最新 idle 事件:', idle ? idle.event_id : '❌ 没有(任务可能还在执行)');
  182. }
  183. /** 调监听函数 */
  184. async function cmdTrigger() {
  185. const r = await callFunction(WATCH_FN_ID, { userId: TEST_USER }, {
  186. 'X-Fmode-Push-Token': SERVER_TOKEN,
  187. });
  188. console.log(JSON.stringify(r.json ?? r, null, 1));
  189. if (r.json?.pushed > 0) {
  190. console.log('\n✅ 已推送,接下来验证通知栏:node scripts/test-push.mjs --status');
  191. } else if (r.json?.errors?.length) {
  192. console.log('\n⚠️ errors 非空,按内容排查:');
  193. for (const e of r.json.errors.slice(0, 5)) console.log(' -', e);
  194. }
  195. }
  196. /** 直接推一条(验证通知链路本身,不经过回合判定) */
  197. async function cmdNotify(json) {
  198. let payload;
  199. try { payload = JSON.parse(json || '{}'); }
  200. catch { console.log('❌ --notify 后面必须是 JSON,如 \'{"title":"测试","body":"内容"}\''); return; }
  201. const r = await callFunction(PUSH_FN_ID, {
  202. alias: TEST_USER,
  203. title: payload.title || 'Fmode 测试',
  204. alert: payload.body || payload.alert || '测试推送',
  205. deepLink: payload.deepLink,
  206. }, { 'X-Parse-Session-Token': TEST_TOKEN });
  207. console.log(JSON.stringify(r.json ?? r, null, 1));
  208. if (r.json?.msgId) {
  209. console.log('\nmsgId:', r.json.msgId);
  210. console.log('查回执:curl -u "c3904d49d3c95e976d8576e3:27c168d11f61a4c083f9c8c6" "https://report.jpush.cn/v3/received?msg_ids=' + r.json.msgId + '"');
  211. }
  212. }
  213. /** 在 WebView 里执行表达式 */
  214. async function cmdCdp(expr) {
  215. const pid = adb(['shell', 'pidof', 'cn.fmode.app'], { allowFail: true });
  216. if (!pid) { console.log('❌ App 未运行'); return; }
  217. adb(['forward', '--remove-all'], { allowFail: true });
  218. adb(['forward', 'tcp:9222', `localabstract:webview_devtools_remote_${pid}`], { allowFail: true });
  219. await new Promise((r) => setTimeout(r, 800));
  220. try {
  221. const list = await (await fetch('http://localhost:9222/json/list')).json();
  222. const page = list.find((p) => p.type === 'page');
  223. if (!page) { console.log('❌ 没有可调试的 WebView 页面'); return; }
  224. const ws = new WebSocket(page.webSocketDebuggerUrl);
  225. let id = 0;
  226. const pending = new Map();
  227. ws.onmessage = (e) => {
  228. const m = JSON.parse(e.data);
  229. if (m.id && pending.has(m.id)) { pending.get(m.id)(m); pending.delete(m.id); }
  230. };
  231. await new Promise((r) => { ws.onopen = r; });
  232. const send = (method, params) =>
  233. new Promise((res) => { const i = ++id; pending.set(i, res); ws.send(JSON.stringify({ id: i, method, params })); });
  234. const out = await send('Runtime.evaluate', {
  235. expression: expr || '({url: location.href, vis: document.visibilityState})',
  236. returnByValue: true,
  237. awaitPromise: true,
  238. });
  239. console.log(JSON.stringify(out.result?.result?.value ?? out.result, null, 1));
  240. ws.close();
  241. } catch (e) {
  242. console.log('❌ CDP 连接失败:', String(e).slice(0, 150));
  243. }
  244. }
  245. /** 循环调用直到推出去 */
  246. async function cmdWatch(seconds) {
  247. const total = Number(seconds) || 180;
  248. const step = 20;
  249. const t0 = Date.now();
  250. while (Date.now() - t0 < total * 1000) {
  251. const r = await callFunction(WATCH_FN_ID, { userId: TEST_USER }, { 'X-Fmode-Push-Token': SERVER_TOKEN });
  252. const j = r.json || {};
  253. console.log(`${new Date().toISOString().slice(11, 19)} rooms=${j.rooms} turns=${j.turnsFound} pushed=${j.pushed}`);
  254. if (j.pushed > 0) { console.log('\n✅ 推送成功'); return; }
  255. await new Promise((res) => setTimeout(res, step * 1000));
  256. }
  257. console.log('\n⏱ 超时仍未推送。可能原因:');
  258. console.log(' · 任务还没执行完(容器没有发 idle 事件)→ node scripts/test-push.mjs --check-room');
  259. console.log(' · 该回合此前已推过(去重)→ 看 FmodePushLog');
  260. console.log(' · 游标判定异常 → node scripts/test-push.mjs --status');
  261. }
  262. // ---------- 入口 ----------
  263. const USAGE = `推送链路测试脚本
  264. 用法:
  265. node scripts/test-push.mjs --status
  266. node scripts/test-push.mjs --check-room
  267. node scripts/test-push.mjs --trigger
  268. node scripts/test-push.mjs --notify '{"title":"测试","body":"内容"}'
  269. node scripts/test-push.mjs --cdp '({url:location.href})'
  270. node scripts/test-push.mjs --watch 180
  271. 手册:docs/05-operations/推送链路测试手册-AI自动测试用.md`;
  272. (async () => {
  273. if (has('--status')) return cmdStatus();
  274. if (has('--check-room')) return cmdCheckRoom();
  275. if (has('--trigger')) return cmdTrigger();
  276. if (has('--notify')) return cmdNotify(val('--notify'));
  277. if (has('--cdp')) return cmdCdp(val('--cdp'));
  278. if (has('--watch')) return cmdWatch(val('--watch'));
  279. console.log(USAGE);
  280. })().catch((e) => {
  281. console.error('执行失败:', e.message);
  282. process.exit(1);
  283. });