@mrrisega/dsh-remote 0.7.12-beta.1 → 0.7.12-beta.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (25) hide show
  1. package/clients/dsh-remote/dingtalk-bot.mjs +1318 -0
  2. package/clients/dsh-remote/docs/feishu-bot-contract.md +177 -0
  3. package/clients/dsh-remote/dsh-bridge.mjs +398 -86
  4. package/clients/dsh-remote/feishu-bot.mjs +1668 -0
  5. package/clients/dsh-remote/mirror-diag-script.js +53 -14
  6. package/clients/dsh-remote/mobile-adapter.mjs +355 -40
  7. package/clients/dsh-remote/test/bridge-http-abort.test.mjs +143 -0
  8. package/clients/dsh-remote/test/bridge-slow-response.test.mjs +107 -0
  9. package/clients/dsh-remote/test/bridge-tunnel-receiver.test.mjs +135 -0
  10. package/clients/dsh-remote/test/dingtalk-bot.test.mjs +550 -0
  11. package/clients/dsh-remote/test/feishu-bot.test.mjs +839 -0
  12. package/clients/dsh-remote/test/mirror-diag.test.mjs +47 -2
  13. package/clients/dsh-remote/test/mobile-adapter-load-watch.test.mjs +208 -9
  14. package/dsh-setup.mjs +1 -1
  15. package/package.json +2 -2
  16. package/packages/dsh-remote-web/lib/client.js +332 -4
  17. package/packages/dsh-remote-web/lib/index.js +367 -21
  18. package/packages/dsh-remote-web/package.json +1 -1
  19. package/packages/dsh-remote-web/runtime/clients/dsh-remote/dsh-bridge.mjs +7 -1
  20. package/packages/dsh-remote-web/runtime/clients/dsh-remote/im-format.mjs +372 -0
  21. package/packages/dsh-remote-web/runtime/clients/dsh-remote/upstream-discovery.mjs +495 -43
  22. package/packages/dsh-remote-web/runtime/clients/dsh-remote/wecom-bot.mjs +238 -12
  23. package/packages/dsh-remote-web/runtime/dsh-setup.mjs +77 -6
  24. package/packages/dsh-remote-web/test/im-bots.test.mjs +224 -2
  25. package/packages/dsh-remote-web/test/panel-ia.test.mjs +197 -32
@@ -12,7 +12,7 @@
12
12
  // 暴露给任何能打开本机 dsh web 页面的人(哪怕它只是一台共享电脑)。
13
13
  import assert from "node:assert/strict";
14
14
  import http from "node:http";
15
- import { mkdtemp, readFile, stat, writeFile } from "node:fs/promises";
15
+ import { mkdir, mkdtemp, readFile, stat, writeFile } from "node:fs/promises";
16
16
  import os from "node:os";
17
17
  import path from "node:path";
18
18
  import test from "node:test";
@@ -199,7 +199,7 @@ test("POST /test:桥写的状态显示已连接 → {ok:true, connected:true,
199
199
  await writeStatus(relayDir, { enabled: true, connected: true, authenticated: true, lastError: "" });
200
200
  const r = await postTest(base); // 不传 body = 测已保存的配置
201
201
  assert.equal(r.status, 200);
202
- assert.deepEqual(r.body, { ok: true, connected: true, authenticated: true, lastError: "" });
202
+ assert.deepEqual(r.body, { ok: true, platform: "wecom", connected: true, authenticated: true, lastError: "" });
203
203
  });
204
204
  });
205
205
 
@@ -398,3 +398,225 @@ test("GET:tier 只认三个枚举值;remainingMessages=null 表示不限/未
398
398
  assert.equal(st.tier, "pro_max");
399
399
  });
400
400
  });
401
+
402
+ // ─────────────────── 钉钉 / 飞书通道(2026-11-08) ───────────────────
403
+
404
+ const putPlatform = (base, platform, config) => json(`${base}/dsh-remote/im-bots`, {
405
+ method: "PUT", headers: { "content-type": "application/json" }, body: JSON.stringify({ platform, config }),
406
+ });
407
+ const postPlatformTest = (base, platform, config) => json(`${base}/dsh-remote/im-bots/test`, {
408
+ method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify(config ? { platform, config } : { platform }),
409
+ });
410
+ const getDeps = async (base) => (await json(`${base}/dsh-remote/im-deps`)).body;
411
+ const post = (base, url) => json(url, { method: "POST", headers: { "content-type": "application/json" }, body: "{}" });
412
+
413
+ test("GET:dingtalk / feishu 两段都只回脱敏视图(有 hasSecret,绝无 clientSecret/appSecret 值)", async () => {
414
+ const relayDir = await tmpRelay();
415
+ await withHost(relayDir, {}, async (base) => {
416
+ await putPlatform(base, "dingtalk", { clientId: "ding-id", clientSecret: "DING-SECRET", robotCode: "ding-robot" });
417
+ await putPlatform(base, "feishu", { appId: "cli_1", appSecret: "FS-SECRET", receiveId: "ou_1", receiveIdType: "open_id" });
418
+ const r = await json(`${base}/dsh-remote/im-bots`);
419
+ assert.equal(r.body.dingtalk.clientId, "ding-id");
420
+ assert.equal(r.body.dingtalk.robotCode, "ding-robot");
421
+ assert.equal(r.body.dingtalk.hasSecret, true);
422
+ assert.equal(r.body.feishu.appId, "cli_1");
423
+ assert.equal(r.body.feishu.receiveIdType, "open_id");
424
+ assert.equal(r.body.feishu.hasSecret, true);
425
+ const raw = JSON.stringify(r.body);
426
+ assert.ok(!raw.includes("DING-SECRET"), "★ 钉钉 secret 绝不能出现");
427
+ assert.ok(!raw.includes("FS-SECRET"), "★ 飞书 secret 绝不能出现");
428
+ assert.ok(!raw.includes("clientSecret") && !raw.includes("appSecret"), "连字段名都不出现");
429
+ });
430
+ });
431
+
432
+ test("PUT:保存钉钉配置(0600 原子写 + 保留未知字段 + 空 secret 不覆盖);缺字段给人话错误", async () => {
433
+ const relayDir = await tmpRelay();
434
+ await withHost(relayDir, {}, async (base) => {
435
+ // 先写一份带未知字段的旧文件:插件不认识,但不能删掉
436
+ await writeFile(path.join(relayDir, "im-bots.json"), JSON.stringify({ version: 1, future: { keep: 1 } }));
437
+ let r = await putPlatform(base, "dingtalk", { clientId: "id1", clientSecret: "sec1", robotCode: "rc1" });
438
+ assert.equal(r.status, 200);
439
+ let cfg = JSON.parse(await readFile(path.join(relayDir, "im-bots.json"), "utf8"));
440
+ assert.equal(cfg.dingtalk.clientId, "id1");
441
+ assert.equal(cfg.dingtalk.clientSecret, "sec1");
442
+ assert.equal(cfg.dingtalk.robotCode, "rc1");
443
+ assert.equal(cfg.dingtalk.enabled, true, "首次保存凭据 = 想让它生效");
444
+ assert.deepEqual(cfg.future, { keep: 1 }, "未知字段必须保留");
445
+ const mode = (await stat(path.join(relayDir, "im-bots.json"))).mode & 0o777;
446
+ assert.equal(mode, 0o600, "配置文件必须 0600");
447
+
448
+ // 空 secret = 不修改
449
+ r = await putPlatform(base, "dingtalk", { clientId: "id2", clientSecret: "", robotCode: "rc2" });
450
+ assert.equal(r.status, 200);
451
+ cfg = JSON.parse(await readFile(path.join(relayDir, "im-bots.json"), "utf8"));
452
+ assert.equal(cfg.dingtalk.clientId, "id2");
453
+ assert.equal(cfg.dingtalk.clientSecret, "sec1", "空 secret 表示不修改");
454
+ assert.equal(cfg.dingtalk.robotCode, "rc2");
455
+
456
+ // 缺字段
457
+ r = await putPlatform(base, "dingtalk", { clientId: "id3", clientSecret: "sec3", robotCode: "" });
458
+ assert.equal(r.status, 400);
459
+ assert.equal(r.body.error, "missing_robot_code", "三个字段都要:缺 Robot Code 要报出来");
460
+ });
461
+ });
462
+
463
+ test("PUT:保存飞书配置(字段锁死 + receiveIdType 校验 + 空 secret 不覆盖)", async () => {
464
+ const relayDir = await tmpRelay();
465
+ await withHost(relayDir, {}, async (base) => {
466
+ let r = await putPlatform(base, "feishu", { appId: "cli_a", appSecret: "fs_a", receiveId: "ou_a", receiveIdType: "chat_id" });
467
+ assert.equal(r.status, 200);
468
+ let cfg = JSON.parse(await readFile(path.join(relayDir, "im-bots.json"), "utf8"));
469
+ assert.equal(cfg.feishu.receiveIdType, "chat_id");
470
+ assert.equal(cfg.feishu.domain, "https://open.feishu.cn", "domain 默认官方");
471
+ r = await putPlatform(base, "feishu", { appId: "cli_b", appSecret: "", receiveId: "ou_b" });
472
+ cfg = JSON.parse(await readFile(path.join(relayDir, "im-bots.json"), "utf8"));
473
+ assert.equal(cfg.feishu.appSecret, "fs_a", "空 secret 不覆盖");
474
+ assert.equal(cfg.feishu.receiveIdType, "chat_id", "未传的字段 = 不修改(保留上次的 chat_id)");
475
+ // 非法 receiveIdType
476
+ r = await putPlatform(base, "feishu", { appId: "x", appSecret: "y", receiveId: "z", receiveIdType: "userid" });
477
+ assert.equal(r.status, 400);
478
+ assert.equal(r.body.error, "invalid_receive_id_type");
479
+ });
480
+ });
481
+
482
+ test("POST /test:platform=dingtalk / feishu 各自轮询对应状态(不再混用 wecom 状态)", async () => {
483
+ const relayDir = await tmpRelay();
484
+ await withHost(relayDir, {}, async (base) => {
485
+ await putPlatform(base, "dingtalk", { clientId: "i", clientSecret: "s", robotCode: "r" });
486
+ await putPlatform(base, "feishu", { appId: "cli_i", appSecret: "fs_s", receiveId: "ou_i" });
487
+ await writeStatus(relayDir, { connected: false, authenticated: false, lastError: "" }, {
488
+ dingtalk: { enabled: true, connected: true, authenticated: true, lastError: "" },
489
+ feishu: { enabled: true, connected: true, authenticated: true, lastError: "" },
490
+ });
491
+ let r = await postPlatformTest(base, "dingtalk");
492
+ assert.equal(r.status, 200);
493
+ assert.equal(r.body.platform, "dingtalk");
494
+ assert.equal(r.body.connected, true);
495
+ r = await postPlatformTest(base, "feishu");
496
+ assert.equal(r.body.platform, "feishu");
497
+ assert.equal(r.body.connected, true);
498
+ // 未保存 secret 的平台:给明确错误,而不是"连不上"
499
+ await withHost(await tmpRelay(), {}, async (base2) => {
500
+ const rr = await postPlatformTest(base2, "dingtalk");
501
+ assert.equal(rr.status, 400);
502
+ assert.equal(rr.body.error, "missing_secret");
503
+ });
504
+ });
505
+ });
506
+
507
+ test("GET 状态白名单:status.dingtalk / status.feishu 按契约透出(含 tier/caps/usage/state),状态文件敏感字段不外泄", async () => {
508
+ const relayDir = await tmpRelay();
509
+ await withHost(relayDir, {}, async (base) => {
510
+ await writeStatus(relayDir, { connected: false }, {
511
+ dingtalk: {
512
+ enabled: true, state: "connected", connected: true, authenticated: true, lastError: "", boundChatId: "chat-9",
513
+ tier: "pro", caps: ["dingtalk"], capsCount: 1, bindingGated: false, messagesPerMonth: 0, remainingMessages: null,
514
+ usage: { month: "2026-11", messages: 5 }, clientSecret: "LEAK-D", token: "LEAK-T",
515
+ },
516
+ feishu: {
517
+ enabled: true, state: "failed", connected: false, authenticated: false, lastError: "鉴权失败", boundChatId: "",
518
+ tier: "free", caps: [], capsCount: 0, bindingGated: true, messagesPerMonth: 20, remainingMessages: 19,
519
+ usage: { month: "2026-11", messages: 1 }, appSecret: "LEAK-F",
520
+ },
521
+ });
522
+ const r = await json(`${base}/dsh-remote/im-bots`);
523
+ const d = r.body.status.dingtalk;
524
+ assert.equal(d.state, "connected");
525
+ assert.equal(d.tier, "pro");
526
+ assert.deepEqual(d.caps, ["dingtalk"]);
527
+ assert.equal(d.remainingMessages, null, "null 必须保持 null(≠0)");
528
+ assert.deepEqual(d.usage, { month: "2026-11", messages: 5 });
529
+ const f = r.body.status.feishu;
530
+ assert.equal(f.state, "failed");
531
+ assert.equal(f.tier, "free");
532
+ assert.equal(f.bindingGated, true);
533
+ assert.equal(f.remainingMessages, 19);
534
+ assert.ok(!JSON.stringify(r.body).includes("LEAK"), "★ 桥写状态里的敏感字段必须被白名单挡掉");
535
+ // wecom 老字段仍在(向后兼容)
536
+ assert.equal(typeof r.body.status.connected, "boolean");
537
+ });
538
+ });
539
+
540
+ // 假子进程:测试注入 opts.imDepsSpawn,绝不真的联网 npm install
541
+ function fakeSpawnChild(installed, stderrText) {
542
+ const handlers = {};
543
+ return {
544
+ stdout: { on() {} },
545
+ stderr: { on(_e, cb) { handlers.data = cb; } },
546
+ on(ev, cb) { handlers[ev] = cb; },
547
+ _finish() {
548
+ if (installed) handlers.installed = true;
549
+ setTimeout(() => {
550
+ if (stderrText && handlers.data) handlers.data(Buffer.from(stderrText));
551
+ if (handlers.exit) handlers.exit(installed ? 0 : 1);
552
+ }, 20);
553
+ }
554
+ };
555
+ }
556
+
557
+ test("GET /im-deps + POST /im-deps/feishu:后台安装(注入假 spawn,不联网),phase 从 downloading→done", async () => {
558
+ const relayDir = await tmpRelay();
559
+ const pkgDir = path.join(relayDir, "im-deps", "node_modules", "@larksuiteoapi", "node-sdk");
560
+ const spawnCalls = [];
561
+ const imDepsSpawn = (cmd, args) => {
562
+ spawnCalls.push({ cmd, args });
563
+ const child = fakeSpawnChild(true, "");
564
+ // 模拟 npm 装完后落盘(测试里直接写好 package.json)
565
+ setTimeout(async () => {
566
+ await mkdir(pkgDir, { recursive: true });
567
+ await writeFile(path.join(pkgDir, "package.json"), JSON.stringify({ name: "@larksuiteoapi/node-sdk", version: "1.40.0" }));
568
+ child._finish();
569
+ }, 10);
570
+ return child;
571
+ };
572
+ await withHost(relayDir, { imDepsSpawn }, async (base) => {
573
+ let deps = await getDeps(base);
574
+ assert.equal(deps.feishu.installed, false);
575
+ assert.equal(deps.feishu.phase, "idle");
576
+
577
+ const r = await post(base, `${base}/dsh-remote/im-deps/feishu`);
578
+ assert.equal(r.status, 200);
579
+ assert.equal(r.body.ok, true);
580
+ assert.equal(r.body.started, true);
581
+ assert.ok(spawnCalls.length === 1, "应触发一次 npm install");
582
+ assert.ok(spawnCalls[0].args.join(" ").includes("@larksuiteoapi/node-sdk@1.40.0"), "安装命令必须钉死 SDK 版本");
583
+
584
+ // 轮询 phase 直到 done
585
+ let phase = "";
586
+ for (let i = 0; i < 50; i++) {
587
+ deps = await getDeps(base);
588
+ phase = deps.feishu.phase;
589
+ if (phase === "done" || phase === "failed") break;
590
+ await new Promise((r2) => setTimeout(r2, 30));
591
+ }
592
+ deps = await getDeps(base);
593
+ assert.equal(deps.feishu.phase, "done", "安装完成后 phase=done,实际 " + deps.feishu.phase);
594
+ assert.equal(deps.feishu.installed, true);
595
+ assert.equal(deps.feishu.version, "1.40.0");
596
+ assert.ok(deps.feishu.path.includes("node-sdk"));
597
+ });
598
+ });
599
+
600
+ test("POST /im-deps/feishu:安装失败 → phase=failed + 人话原因(network/disk/permission/sdk_install_failed)", async () => {
601
+ const relayDir = await tmpRelay();
602
+ const imDepsSpawn = () => {
603
+ const child = fakeSpawnChild(false, "npm ERR! code ETIMEDOUT network registry.npmjs.org");
604
+ setTimeout(() => child._finish(), 10);
605
+ return child;
606
+ };
607
+ await withHost(relayDir, { imDepsSpawn }, async (base) => {
608
+ const r = await post(base, `${base}/dsh-remote/im-deps/feishu`);
609
+ assert.equal(r.status, 200);
610
+ let deps = null;
611
+ for (let i = 0; i < 60; i++) {
612
+ deps = await getDeps(base);
613
+ if (deps.feishu.phase === "failed") break;
614
+ await new Promise((r2) => setTimeout(r2, 30));
615
+ }
616
+ assert.equal(deps.feishu.phase, "failed", "失败必须落到 failed 而不是永远 downloading");
617
+ assert.match(deps.feishu.lastError, /网络不通/, "网络类错误要翻成人话");
618
+ // 已失败后重试:再次触发安装
619
+ const r2 = await post(base, `${base}/dsh-remote/im-deps/feishu`);
620
+ assert.equal(r2.body.started, true, "失败后允许重试");
621
+ });
622
+ });
@@ -99,6 +99,8 @@ function loadPlugin(opts = {}) {
99
99
  const injects = new Map();
100
100
  const requests = [];
101
101
  const clipboard = [];
102
+ const depsCalls = [];
103
+ const depsInstalls = [];
102
104
  let unmounted = false;
103
105
 
104
106
  // ── 迷你 React:真实 useState/useEffect + 递归展开**函数子组件** ──
@@ -192,6 +194,7 @@ function loadPlugin(opts = {}) {
192
194
  let imBotsGetReply = { ok: true, wecom: { enabled: false, botId: "", hasSecret: false, url: "", targetChatId: "" }, status: { connected: false, authenticated: false, lastError: "" }, updatedAt: 0 };
193
195
  let imBotsPutReply = { status: 200, body: { ok: true, wecom: { enabled: true, botId: "aibdemo1234", hasSecret: true, url: "", targetChatId: "" }, status: { connected: false, authenticated: false, lastError: "" }, updatedAt: 0 } };
194
196
  let imBotsTestReply = { status: 200, body: { ok: true, connected: true, authenticated: true, lastError: "" } };
197
+ let imDepsReply = { installed: false, phase: "idle", version: "", lastError: "" };
195
198
  const nextPoll = () => (pollReplies.length > 1 ? pollReplies.shift() : pollReplies[0]);
196
199
 
197
200
  const makeEl = () => ({
@@ -255,6 +258,15 @@ function loadPlugin(opts = {}) {
255
258
  imBotsCalls.push({ method: "POST", body: options.body ? JSON.parse(options.body) : null });
256
259
  return response(imBotsTestReply.status, imBotsTestReply.body);
257
260
  }
261
+ if (path === "/dsh-remote/im-deps") {
262
+ depsCalls.push(Date.now());
263
+ return response(200, { ok: true, feishu: imDepsReply });
264
+ }
265
+ if (path === "/dsh-remote/im-deps/feishu") {
266
+ depsInstalls.push(Date.now());
267
+ imDepsReply = { ...imDepsReply, phase: "downloading", installed: false };
268
+ return response(200, { ok: true, started: true, deps: { feishu: imDepsReply } });
269
+ }
258
270
  return response(200, { ok: true });
259
271
  },
260
272
  Set, Symbol, Date, JSON, Math, Number, String, Object, Array, console
@@ -321,6 +333,9 @@ function loadPlugin(opts = {}) {
321
333
  setImBotsGet(body) { imBotsGetReply = body; },
322
334
  setImBotsPut(body, status = 200) { imBotsPutReply = { status, body }; },
323
335
  setImBotsTest(body, status = 200) { imBotsTestReply = { status, body }; },
336
+ setImDeps(body) { imDepsReply = body; },
337
+ depsCalls() { return depsCalls.slice(); },
338
+ depsInstalls() { return depsInstalls.slice(); },
324
339
  imBotsCalls() { return imBotsCalls.slice(); },
325
340
  /** 向 document 派发键盘事件(测试 Esc / Tab 的弹层契约)。 */
326
341
  fireKey(key, init = {}) {
@@ -667,47 +682,168 @@ test("会保存:选中某会话 → PUT 带 sessionId + sessionTitle;选回
667
682
  assert.equal(sent.body.wecom.sessionTitle, "", "★ 清空时标题也必须清空(否则 UI 会显示错目标)");
668
683
  });
669
684
 
670
- // ───────────────────── ⑥ 飞书 / 钉钉:诚实的「即将支持」 ─────────────────────
685
+ // ───────────────────── ⑥ 钉钉 / 飞书通道(2026-11-08 本轮支持) ─────────────────────
671
686
 
672
- test("平台列表:飞书 / 钉钉都标注「即将支持」,不放进假表单", async () => {
687
+ test("平台列表:企业微信 / 钉钉 / 飞书 / Webhook 都是真入口(不再有「即将支持」),Webhook 注明免费", async () => {
673
688
  const plugin = loadPlugin();
674
689
  let tree = await plugin.settle();
675
690
  openEntry(tree, "channel");
676
691
  tree = await plugin.settle();
677
- const rows = byClass(tree, "dru-ia-row");
678
- const texts = rows.map((r) => textOf(r));
679
- assert.ok(texts.some((t) => t.includes("飞书机器人") && t.includes("即将支持")), "飞书行必须标注即将支持");
680
- assert.ok(texts.some((t) => t.includes("钉钉机器人") && t.includes("即将支持")), "钉钉行必须标注即将支持");
681
- assert.ok(texts.some((t) => t.includes("企业微信智能机器人") && !t.includes("即将支持")), "企微行是已支持(主推)");
692
+ const texts = byClass(tree, "dru-ia-row").map((r) => textOf(r));
693
+ assert.ok(texts.some((t) => t.includes("企业微信智能机器人")), "企业微信在列表里(已支持)");
694
+ assert.ok(texts.some((t) => t.includes("钉钉机器人")), "钉钉机器人必须在列表里(本轮支持)");
695
+ assert.ok(texts.some((t) => t.includes("飞书机器人")), "飞书机器人必须在列表里(本轮支持,按需下载依赖)");
696
+ assert.ok(texts.some((t) => t.includes("Webhook") && t.includes("免费")), "高级 Webhook 保留并注明免费");
697
+ assert.ok(!texts.some((t) => t.includes("钉钉机器人") && t.includes("即将支持")), "钉钉不再是即将支持");
698
+ assert.ok(!texts.some((t) => t.includes("飞书机器人") && t.includes("即将支持")), "飞书不再是即将支持");
682
699
  });
683
700
 
684
- test("飞书/钉钉:点进去只有说明 + 「告诉我,优先支持」;**没有输入框、没有提交**,点优先支持走现有反馈", async () => {
701
+ test("钉钉配置页:Client ID / Client Secret / Robot Code + 保存并连接/测试;提交体字段锁死", async () => {
685
702
  const plugin = loadPlugin();
686
- for (const [row, name] of [["飞书机器人", "飞书机器人"], ["钉钉机器人", "钉钉机器人"]]) {
687
- const p = loadPlugin();
688
- let tree = await p.settle();
689
- openEntry(tree, "channel");
690
- tree = await p.settle();
691
- assert.ok(clickChannelRow(tree, row), "应能点开 " + row);
692
- tree = await p.settle();
693
- const dlg = dialogOf(tree);
694
- assert.ok(dlg, row + " 必须打开弹层(不是假入口)");
695
- const text = textOf(dlg);
696
- assert.ok(text.includes("即将支持"), row + " 必须标注「即将支持」");
697
- assert.ok(text.includes("企业管理员"), row + " 说明要写清为什么现在还接不了(企业管理员配置应用)");
698
- assert.equal(find(dlg, (n) => n.type === "input" || n.type === "select"), undefined,
699
- "★ 不许放任何输入框/下拉(假表单)");
700
- const tell = btnWith(dlg, "告诉我,优先支持");
701
- assert.ok(tell, "必须有「告诉我,优先支持」按钮(复用反馈通道)");
702
- const before = p.imBotsCalls().length;
703
- tell.props.onClick();
704
- tree = await p.settle();
705
- assert.equal(dialogOf(tree), undefined, "点「优先支持」后关闭弹层");
706
- assert.equal(p.imBotsCalls().length, before, "★ 不得调用 im-bots 写接口(不新增后端)");
707
- const dbgText = textOf(tree);
708
- assert.ok(dbgText.includes("想要 " + name), "反馈视图应带一句引导(告知用户写什么);实际视图文本片段=" + dbgText.slice(0, 200));
709
- void plugin;
703
+ plugin.setImBotsGet({
704
+ ok: true,
705
+ wecom: { enabled: false, botId: "", hasSecret: false, url: "", targetChatId: "", sessionId: "", sessionTitle: "" },
706
+ dingtalk: { enabled: false, clientId: "", hasSecret: false, robotCode: "" },
707
+ feishu: { enabled: false, appId: "", hasSecret: false, receiveId: "", receiveIdType: "open_id" },
708
+ status: { connected: false, sessions: [], activeSessionId: "", boundSessionId: "", dingtalk: {}, feishu: {}, deps: { feishu: { installed: false, phase: "idle" } } },
709
+ });
710
+ let tree = await plugin.settle();
711
+ openEntry(tree, "channel");
712
+ tree = await plugin.settle();
713
+ assert.ok(clickChannelRow(tree, "钉钉机器人"), "应能进钉钉配置页");
714
+ tree = await plugin.settle();
715
+ const dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
716
+ assert.ok(dlg, "钉钉配置页应打开");
717
+ for (const id of ["dru-ding-client", "dru-ding-secret", "dru-ding-robot"]) {
718
+ assert.ok(find(dlg, (n) => n.type === "input" && n.props?.id === id), "缺字段: " + id);
710
719
  }
720
+ assert.ok(textOf(dlg).includes("AppKey") && textOf(dlg).includes("AppSecret") && textOf(dlg).includes("机器人编码"),
721
+ "说明要写清 Client ID/Secret = AppKey/AppSecret、Robot Code 是机器人编码");
722
+ assert.ok(btnWith(dlg, "保存并连接"), "要有「保存并连接」");
723
+ assert.ok(btnWith(dlg, "测试"), "要有「测试」");
724
+
725
+ find(dlg, (n) => n.props?.id === "dru-ding-client").props.onChange({ target: { value: "ding-client-1" } });
726
+ find(dlg, (n) => n.props?.id === "dru-ding-secret").props.onChange({ target: { value: "ding-secret-1" } });
727
+ find(dlg, (n) => n.props?.id === "dru-ding-robot").props.onChange({ target: { value: "ding-robot-1" } });
728
+ tree = await plugin.settle();
729
+ btnWith(tree, "仅保存").props.onClick();
730
+ await flush(); await flush();
731
+ const put = plugin.imBotsCalls().filter((c) => c.method === "PUT").pop();
732
+ assert.ok(put, "应 PUT /dsh-remote/im-bots");
733
+ assert.equal(put.body.platform, "dingtalk", "提交体要带 platform=dingtalk");
734
+ assert.deepEqual(put.body.config, { clientId: "ding-client-1", clientSecret: "ding-secret-1", robotCode: "ding-robot-1" },
735
+ "★ 钉钉提交体字段必须锁死为 clientId/clientSecret/robotCode");
736
+ });
737
+
738
+ test("飞书:依赖未装 → 41MB 下载入口 + 「不下载也能用其它通道」;已装 → 表单/官方链接/8 步向导/顺序坑", async () => {
739
+ // 未装依赖
740
+ const p1 = loadPlugin();
741
+ p1.setImDeps({ installed: false, phase: "idle", version: "", lastError: "" });
742
+ p1.setImBotsGet({
743
+ ok: true, wecom: {}, dingtalk: {}, feishu: {},
744
+ status: { deps: { feishu: { installed: false, phase: "idle", version: "", lastError: "" } } },
745
+ });
746
+ let tree = await p1.settle();
747
+ openEntry(tree, "channel");
748
+ tree = await p1.settle();
749
+ assert.ok(clickChannelRow(tree, "飞书机器人"), "应能进飞书页");
750
+ tree = await p1.settle();
751
+ assert.ok(textOf(tree).includes("41MB"), "未装依赖要说明约 41MB、仅装一次");
752
+ const dlBtn = btnWith(tree, "下载依赖");
753
+ assert.ok(dlBtn, "要有「下载依赖」按钮");
754
+ assert.ok(textOf(tree).includes("不下载也能用其它通道"), "要说明不下载也能用其它通道");
755
+ assert.equal(find(tree, (n) => n.props?.id === "dru-fs-appid"), undefined, "未装依赖时不放配置表单");
756
+ dlBtn.props.onClick();
757
+ await flush(); await flush();
758
+ assert.ok(p1.requests.some((r) => r.path === "/dsh-remote/im-deps/feishu" && r.method === "POST"),
759
+ "点下载必须 POST /dsh-remote/im-deps/feishu");
760
+
761
+ // 已装依赖
762
+ const p2 = loadPlugin();
763
+ p2.setImDeps({ installed: true, phase: "done", version: "1.40.0", lastError: "" });
764
+ p2.setImBotsGet({
765
+ ok: true, wecom: {}, dingtalk: {},
766
+ feishu: { enabled: false, appId: "", hasSecret: false, receiveId: "", receiveIdType: "open_id" },
767
+ status: { deps: { feishu: { installed: true, phase: "done", version: "1.40.0", lastError: "" } } },
768
+ });
769
+ tree = await p2.settle();
770
+ openEntry(tree, "channel");
771
+ tree = await p2.settle();
772
+ clickChannelRow(tree, "飞书机器人");
773
+ tree = await p2.settle();
774
+ let dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
775
+ assert.ok(dlg, "已装依赖应打开飞书配置页");
776
+ assert.ok(textOf(dlg).includes("1.40.0"), "应显示依赖版本");
777
+ for (const id of ["dru-fs-appid", "dru-fs-secret", "dru-fs-recv", "dru-fs-rtype"]) {
778
+ assert.ok(find(dlg, (n) => (n.type === "input" || n.type === "select") && n.props?.id === id), "缺字段: " + id);
779
+ }
780
+ const links = findAll(dlg, (n) => n.type === "a");
781
+ assert.equal(links.length, 2, "配置页顶部要有两个官方文档外链,实际 " + links.length);
782
+ for (const a of links) {
783
+ assert.equal(a.props.target, "_blank");
784
+ assert.equal(a.props.rel, "noopener");
785
+ assert.match(String(a.props.href), /^https:\/\/open\.feishu\.cn\//, "外链必须是飞书官方文档");
786
+ }
787
+ const wizard = find(dlg, (n) => n.type === "button" && (n.children || []).some((c) => typeof c === "string" && c.includes("配置步骤(8 步)")));
788
+ assert.ok(wizard, "要有 8 步配置向导(可折叠)");
789
+ assert.equal(wizard.props["aria-expanded"], "false", "默认收起,避免文字堆砌");
790
+ wizard.props.onClick();
791
+ tree = await p2.settle();
792
+ dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
793
+ const steps = findAll(dlg, (n) => n.type === "li");
794
+ assert.equal(steps.length, 8, "向导必须正好 8 步,实际 " + steps.length);
795
+ assert.ok(textOf(dlg).includes("长连接必须已在线"), "必须写明顺序坑:保存事件配置时长连接必须已在线");
796
+ assert.ok(textOf(dlg).includes("先在第 8 步填凭据"), "必须写明正确顺序:先填凭据连上,再去后台保存事件配置");
797
+ });
798
+
799
+ test("飞书依赖:失败状态可重试,失败原因人话展示", async () => {
800
+ const plugin = loadPlugin();
801
+ plugin.setImDeps({ installed: false, phase: "failed", version: "", lastError: "网络不通:检查能否访问 npm registry" });
802
+ plugin.setImBotsGet({
803
+ ok: true, wecom: {}, dingtalk: {}, feishu: {},
804
+ status: { deps: { feishu: { installed: false, phase: "failed", version: "", lastError: "网络不通:检查能否访问 npm registry" } } },
805
+ });
806
+ let tree = await plugin.settle();
807
+ openEntry(tree, "channel");
808
+ tree = await plugin.settle();
809
+ clickChannelRow(tree, "飞书机器人");
810
+ tree = await plugin.settle();
811
+ assert.ok(textOf(tree).includes("网络不通"), "失败原因要人话展示");
812
+ assert.ok(btnWith(tree, "重试下载"), "失败后按钮变为「重试下载」");
813
+ btnWith(tree, "重试下载").props.onClick();
814
+ await flush(); await flush();
815
+ assert.ok(plugin.requests.some((r) => r.path === "/dsh-remote/im-deps/feishu" && r.method === "POST"), "重试必须再次触发安装");
816
+ });
817
+
818
+ test("飞书表单提交体:appId/appSecret/receiveId/receiveIdType;secret 不回显", async () => {
819
+ const plugin = loadPlugin();
820
+ plugin.setImDeps({ installed: true, phase: "done", version: "1.40.0", lastError: "" });
821
+ plugin.setImBotsGet({
822
+ ok: true, wecom: {}, dingtalk: {},
823
+ feishu: { enabled: true, appId: "cli_old", hasSecret: true, receiveId: "ou_old", receiveIdType: "open_id" },
824
+ status: { deps: { feishu: { installed: true, phase: "done", version: "1.40.0", lastError: "" } } },
825
+ });
826
+ let tree = await plugin.settle();
827
+ openEntry(tree, "channel");
828
+ tree = await plugin.settle();
829
+ clickChannelRow(tree, "飞书机器人");
830
+ tree = await plugin.settle();
831
+ const dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
832
+ // 已保存的 secret 不回显:password 输入框初始为空 + 占位提示
833
+ const sec = find(dlg, (n) => n.props?.id === "dru-fs-secret");
834
+ assert.equal(sec.props.value, "", "★ 已保存的 Secret 绝不能回显到输入框");
835
+ assert.ok(String(sec.props.placeholder || "").includes("已保存"), "要提示「已保存(留空表示不修改)」");
836
+ find(dlg, (n) => n.props?.id === "dru-fs-appid").props.onChange({ target: { value: "cli_new" } });
837
+ find(dlg, (n) => n.props?.id === "dru-fs-recv").props.onChange({ target: { value: "oc_chat_1" } });
838
+ find(dlg, (n) => n.props?.id === "dru-fs-rtype").props.onChange({ target: { value: "chat_id" } });
839
+ tree = await plugin.settle();
840
+ btnWith(tree, "仅保存").props.onClick();
841
+ await flush(); await flush();
842
+ const put = plugin.imBotsCalls().filter((c) => c.method === "PUT").pop();
843
+ assert.ok(put, "应 PUT /dsh-remote/im-bots");
844
+ assert.equal(put.body.platform, "feishu");
845
+ assert.deepEqual(put.body.config, { appId: "cli_new", appSecret: "", receiveId: "oc_chat_1", receiveIdType: "chat_id" },
846
+ "★ 飞书提交体字段锁死;空 secret = 不修改(不覆盖已保存的)");
711
847
  });
712
848
 
713
849
  // ───────────────────── ⑦ 配置页收口:说明折叠 + 统一字段结构 ─────────────────────
@@ -994,3 +1130,32 @@ test("版本与更新:有一行可复制的安装/更新命令 npx @mrrisega/d
994
1130
  tree = await plugin.settle();
995
1131
  assert.ok(textOf(tree).includes("✅ 已复制"), "复制成功要有与其它复制按钮一致的反馈");
996
1132
  });
1133
+
1134
+ test("飞书依赖下载:点下载 → POST 安装 → 轮询 /im-deps,装好后页面自动切到配置表单(无需重开弹层)", async () => {
1135
+ const plugin = loadPlugin();
1136
+ plugin.setImDeps({ installed: false, phase: "idle", version: "", lastError: "" });
1137
+ plugin.setImBotsGet({
1138
+ ok: true, wecom: {}, dingtalk: {}, feishu: {},
1139
+ status: { deps: { feishu: { installed: false, phase: "idle", version: "", lastError: "" } } },
1140
+ });
1141
+ let tree = await plugin.settle();
1142
+ openEntry(tree, "channel");
1143
+ tree = await plugin.settle();
1144
+ clickChannelRow(tree, "飞书机器人");
1145
+ tree = await plugin.settle();
1146
+ assert.ok(btnWith(tree, "下载依赖"), "未装依赖先给下载入口");
1147
+
1148
+ btnWith(tree, "下载依赖").props.onClick();
1149
+ await flush(); await flush();
1150
+ assert.equal(plugin.depsInstalls().length, 1, "★ 点下载必须触发一次后台安装");
1151
+
1152
+ // 先渲染一次让"下载中"的轮询 effect 挂上定时器,再模拟安装完成
1153
+ tree = await plugin.settle(2);
1154
+ plugin.setImDeps({ installed: true, phase: "done", version: "1.40.0", lastError: "" });
1155
+ await plugin.advance(1000); // 触发轮询定时器(真实环境 900ms 一次)
1156
+ await flush(); await flush();
1157
+ tree = await plugin.settle(4);
1158
+ assert.ok(plugin.depsCalls().length >= 1, "应轮询 /dsh-remote/im-deps 拿进度");
1159
+ assert.ok(textOf(tree).includes("1.40.0"), "装好后面板直接显示版本(用户不需要重开弹层)");
1160
+ assert.ok(find(tree, (n) => n.props?.id === "dru-fs-appid"), "装好后应出现飞书配置表单");
1161
+ });