@mrrisega/dsh-remote 0.7.11-beta.3 → 0.7.12-beta.2

package/packages/dsh-remote-web/test/panel-ia.test.mjs

@@ -75,6 +75,12 @@ function domIndex(tree, predicate) {
 }
 const flush = () => new Promise((resolve) => setImmediate(resolve));
 
+/** 收集所有匹配节点（用例里要数"有几个单选"这类）。 */
+function findAll(tree, predicate) {
+  const out = [];
+  walk(tree, (n) => { if (predicate(n)) out.push(n); });
+  return out;
+}
 /** 子树全部文本（拼接；用于"卡片文案/按钮文案"断言）。 */
 function textOf(node) {
   let out = "";
@@ -92,6 +98,9 @@ function loadPlugin(opts = {}) {
   const metas = [];
   const injects = new Map();
   const requests = [];
+  const clipboard = [];
+  const depsCalls = [];
+  const depsInstalls = [];
   let unmounted = false;
 
   // ── 迷你 React：真实 useState/useEffect + 递归展开**函数子组件** ──
@@ -185,6 +194,7 @@ function loadPlugin(opts = {}) {
   let imBotsGetReply = { ok: true, wecom: { enabled: false, botId: "", hasSecret: false, url: "", targetChatId: "" }, status: { connected: false, authenticated: false, lastError: "" }, updatedAt: 0 };
   let imBotsPutReply = { status: 200, body: { ok: true, wecom: { enabled: true, botId: "aibdemo1234", hasSecret: true, url: "", targetChatId: "" }, status: { connected: false, authenticated: false, lastError: "" }, updatedAt: 0 } };
   let imBotsTestReply = { status: 200, body: { ok: true, connected: true, authenticated: true, lastError: "" } };
+  let imDepsReply = { installed: false, phase: "idle", version: "", lastError: "" };
   const nextPoll = () => (pollReplies.length > 1 ? pollReplies.shift() : pollReplies[0]);
 
   const makeEl = () => ({
@@ -223,7 +233,7 @@ function loadPlugin(opts = {}) {
     document: doc,
     localStorage,
     MutationObserver: MutationObserverMock,
-    navigator: { clipboard: { writeText: async () => {} } },
+    navigator: { clipboard: { writeText: async (t) => { clipboard.push(String(t)); } } },
     setTimeout: fakeSetTimeout,
     clearTimeout: fakeClear,
     setInterval: fakeSetInterval,
@@ -248,6 +258,15 @@ function loadPlugin(opts = {}) {
         imBotsCalls.push({ method: "POST", body: options.body ? JSON.parse(options.body) : null });
         return response(imBotsTestReply.status, imBotsTestReply.body);
       }
+      if (path === "/dsh-remote/im-deps") {
+        depsCalls.push(Date.now());
+        return response(200, { ok: true, feishu: imDepsReply });
+      }
+      if (path === "/dsh-remote/im-deps/feishu") {
+        depsInstalls.push(Date.now());
+        imDepsReply = { ...imDepsReply, phase: "downloading", installed: false };
+        return response(200, { ok: true, started: true, deps: { feishu: imDepsReply } });
+      }
       return response(200, { ok: true });
     },
     Set, Symbol, Date, JSON, Math, Number, String, Object, Array, console
@@ -299,7 +318,7 @@ function loadPlugin(opts = {}) {
   }
 
   return {
-    requests, metas, injects,
+    requests, metas, injects, clipboard,
     counts() { return { ...counts }; },
     /** 设置页栏目列表（模拟 shell 的 ctx.slots.entries("settings.section")，按 order 排序）。 */
     sectionList() { return metas.filter((m) => m.name === "settings.section").slice().sort((a, b) => a.order - b.order); },
@@ -314,6 +333,9 @@ function loadPlugin(opts = {}) {
     setImBotsGet(body) { imBotsGetReply = body; },
     setImBotsPut(body, status = 200) { imBotsPutReply = { status, body }; },
     setImBotsTest(body, status = 200) { imBotsTestReply = { status, body }; },
+    setImDeps(body) { imDepsReply = body; },
+    depsCalls() { return depsCalls.slice(); },
+    depsInstalls() { return depsInstalls.slice(); },
     imBotsCalls() { return imBotsCalls.slice(); },
     /** 向 document 派发键盘事件（测试 Esc / Tab 的弹层契约）。 */
     fireKey(key, init = {}) {
@@ -660,47 +682,168 @@ test("会保存：选中某会话 → PUT 带 sessionId + sessionTitle；选回
   assert.equal(sent.body.wecom.sessionTitle, "", "★ 清空时标题也必须清空（否则 UI 会显示错目标）");
 });
 
-// ───────────────────── ⑥ 飞书 / 钉钉：诚实的「即将支持」 ─────────────────────
+// ───────────────────── ⑥ 钉钉 / 飞书通道（2026-11-08 本轮支持） ─────────────────────
 
-test("平台列表：飞书 / 钉钉都标注「即将支持」，不放进假表单", async () => {
+test("平台列表：企业微信 / 钉钉 / 飞书 / Webhook 都是真入口（不再有「即将支持」），Webhook 注明免费", async () => {
   const plugin = loadPlugin();
   let tree = await plugin.settle();
   openEntry(tree, "channel");
   tree = await plugin.settle();
-  const rows = byClass(tree, "dru-ia-row");
-  const texts = rows.map((r) => textOf(r));
-  assert.ok(texts.some((t) => t.includes("飞书机器人") && t.includes("即将支持")), "飞书行必须标注即将支持");
-  assert.ok(texts.some((t) => t.includes("钉钉机器人") && t.includes("即将支持")), "钉钉行必须标注即将支持");
-  assert.ok(texts.some((t) => t.includes("企业微信智能机器人") && !t.includes("即将支持")), "企微行是已支持（主推）");
+  const texts = byClass(tree, "dru-ia-row").map((r) => textOf(r));
+  assert.ok(texts.some((t) => t.includes("企业微信智能机器人")), "企业微信在列表里（已支持）");
+  assert.ok(texts.some((t) => t.includes("钉钉机器人")), "钉钉机器人必须在列表里（本轮支持）");
+  assert.ok(texts.some((t) => t.includes("飞书机器人")), "飞书机器人必须在列表里（本轮支持，按需下载依赖）");
+  assert.ok(texts.some((t) => t.includes("Webhook") && t.includes("免费")), "高级 Webhook 保留并注明免费");
+  assert.ok(!texts.some((t) => t.includes("钉钉机器人") && t.includes("即将支持")), "钉钉不再是即将支持");
+  assert.ok(!texts.some((t) => t.includes("飞书机器人") && t.includes("即将支持")), "飞书不再是即将支持");
 });
 
-test("飞书/钉钉：点进去只有说明 + 「告诉我，优先支持」；**没有输入框、没有提交**，点优先支持走现有反馈", async () => {
+test("钉钉配置页：Client ID / Client Secret / Robot Code + 保存并连接/测试；提交体字段锁死", async () => {
   const plugin = loadPlugin();
-  for (const [row, name] of [["飞书机器人", "飞书机器人"], ["钉钉机器人", "钉钉机器人"]]) {
-    const p = loadPlugin();
-    let tree = await p.settle();
-    openEntry(tree, "channel");
-    tree = await p.settle();
-    assert.ok(clickChannelRow(tree, row), "应能点开 " + row);
-    tree = await p.settle();
-    const dlg = dialogOf(tree);
-    assert.ok(dlg, row + " 必须打开弹层（不是假入口）");
-    const text = textOf(dlg);
-    assert.ok(text.includes("即将支持"), row + " 必须标注「即将支持」");
-    assert.ok(text.includes("企业管理员"), row + " 说明要写清为什么现在还接不了（企业管理员配置应用）");
-    assert.equal(find(dlg, (n) => n.type === "input" || n.type === "select"), undefined,
-      "★ 不许放任何输入框/下拉（假表单）");
-    const tell = btnWith(dlg, "告诉我，优先支持");
-    assert.ok(tell, "必须有「告诉我，优先支持」按钮（复用反馈通道）");
-    const before = p.imBotsCalls().length;
-    tell.props.onClick();
-    tree = await p.settle();
-    assert.equal(dialogOf(tree), undefined, "点「优先支持」后关闭弹层");
-    assert.equal(p.imBotsCalls().length, before, "★ 不得调用 im-bots 写接口（不新增后端）");
-    const dbgText = textOf(tree);
-    assert.ok(dbgText.includes("想要 " + name), "反馈视图应带一句引导（告知用户写什么）；实际视图文本片段=" + dbgText.slice(0, 200));
-    void plugin;
+  plugin.setImBotsGet({
+    ok: true,
+    wecom: { enabled: false, botId: "", hasSecret: false, url: "", targetChatId: "", sessionId: "", sessionTitle: "" },
+    dingtalk: { enabled: false, clientId: "", hasSecret: false, robotCode: "" },
+    feishu: { enabled: false, appId: "", hasSecret: false, receiveId: "", receiveIdType: "open_id" },
+    status: { connected: false, sessions: [], activeSessionId: "", boundSessionId: "", dingtalk: {}, feishu: {}, deps: { feishu: { installed: false, phase: "idle" } } },
+  });
+  let tree = await plugin.settle();
+  openEntry(tree, "channel");
+  tree = await plugin.settle();
+  assert.ok(clickChannelRow(tree, "钉钉机器人"), "应能进钉钉配置页");
+  tree = await plugin.settle();
+  const dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
+  assert.ok(dlg, "钉钉配置页应打开");
+  for (const id of ["dru-ding-client", "dru-ding-secret", "dru-ding-robot"]) {
+    assert.ok(find(dlg, (n) => n.type === "input" && n.props?.id === id), "缺字段: " + id);
+  }
+  assert.ok(textOf(dlg).includes("AppKey") && textOf(dlg).includes("AppSecret") && textOf(dlg).includes("机器人编码"),
+    "说明要写清 Client ID/Secret = AppKey/AppSecret、Robot Code 是机器人编码");
+  assert.ok(btnWith(dlg, "保存并连接"), "要有「保存并连接」");
+  assert.ok(btnWith(dlg, "测试"), "要有「测试」");
+
+  find(dlg, (n) => n.props?.id === "dru-ding-client").props.onChange({ target: { value: "ding-client-1" } });
+  find(dlg, (n) => n.props?.id === "dru-ding-secret").props.onChange({ target: { value: "ding-secret-1" } });
+  find(dlg, (n) => n.props?.id === "dru-ding-robot").props.onChange({ target: { value: "ding-robot-1" } });
+  tree = await plugin.settle();
+  btnWith(tree, "仅保存").props.onClick();
+  await flush(); await flush();
+  const put = plugin.imBotsCalls().filter((c) => c.method === "PUT").pop();
+  assert.ok(put, "应 PUT /dsh-remote/im-bots");
+  assert.equal(put.body.platform, "dingtalk", "提交体要带 platform=dingtalk");
+  assert.deepEqual(put.body.config, { clientId: "ding-client-1", clientSecret: "ding-secret-1", robotCode: "ding-robot-1" },
+    "★ 钉钉提交体字段必须锁死为 clientId/clientSecret/robotCode");
+});
+
+test("飞书：依赖未装 → 41MB 下载入口 + 「不下载也能用其它通道」；已装 → 表单/官方链接/8 步向导/顺序坑", async () => {
+  // 未装依赖
+  const p1 = loadPlugin();
+  p1.setImDeps({ installed: false, phase: "idle", version: "", lastError: "" });
+  p1.setImBotsGet({
+    ok: true, wecom: {}, dingtalk: {}, feishu: {},
+    status: { deps: { feishu: { installed: false, phase: "idle", version: "", lastError: "" } } },
+  });
+  let tree = await p1.settle();
+  openEntry(tree, "channel");
+  tree = await p1.settle();
+  assert.ok(clickChannelRow(tree, "飞书机器人"), "应能进飞书页");
+  tree = await p1.settle();
+  assert.ok(textOf(tree).includes("41MB"), "未装依赖要说明约 41MB、仅装一次");
+  const dlBtn = btnWith(tree, "下载依赖");
+  assert.ok(dlBtn, "要有「下载依赖」按钮");
+  assert.ok(textOf(tree).includes("不下载也能用其它通道"), "要说明不下载也能用其它通道");
+  assert.equal(find(tree, (n) => n.props?.id === "dru-fs-appid"), undefined, "未装依赖时不放配置表单");
+  dlBtn.props.onClick();
+  await flush(); await flush();
+  assert.ok(p1.requests.some((r) => r.path === "/dsh-remote/im-deps/feishu" && r.method === "POST"),
+    "点下载必须 POST /dsh-remote/im-deps/feishu");
+
+  // 已装依赖
+  const p2 = loadPlugin();
+  p2.setImDeps({ installed: true, phase: "done", version: "1.40.0", lastError: "" });
+  p2.setImBotsGet({
+    ok: true, wecom: {}, dingtalk: {},
+    feishu: { enabled: false, appId: "", hasSecret: false, receiveId: "", receiveIdType: "open_id" },
+    status: { deps: { feishu: { installed: true, phase: "done", version: "1.40.0", lastError: "" } } },
+  });
+  tree = await p2.settle();
+  openEntry(tree, "channel");
+  tree = await p2.settle();
+  clickChannelRow(tree, "飞书机器人");
+  tree = await p2.settle();
+  let dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
+  assert.ok(dlg, "已装依赖应打开飞书配置页");
+  assert.ok(textOf(dlg).includes("1.40.0"), "应显示依赖版本");
+  for (const id of ["dru-fs-appid", "dru-fs-secret", "dru-fs-recv", "dru-fs-rtype"]) {
+    assert.ok(find(dlg, (n) => (n.type === "input" || n.type === "select") && n.props?.id === id), "缺字段: " + id);
   }
+  const links = findAll(dlg, (n) => n.type === "a");
+  assert.equal(links.length, 2, "配置页顶部要有两个官方文档外链，实际 " + links.length);
+  for (const a of links) {
+    assert.equal(a.props.target, "_blank");
+    assert.equal(a.props.rel, "noopener");
+    assert.match(String(a.props.href), /^https:\/\/open\.feishu\.cn\//, "外链必须是飞书官方文档");
+  }
+  const wizard = find(dlg, (n) => n.type === "button" && (n.children || []).some((c) => typeof c === "string" && c.includes("配置步骤（8 步）")));
+  assert.ok(wizard, "要有 8 步配置向导（可折叠）");
+  assert.equal(wizard.props["aria-expanded"], "false", "默认收起，避免文字堆砌");
+  wizard.props.onClick();
+  tree = await p2.settle();
+  dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
+  const steps = findAll(dlg, (n) => n.type === "li");
+  assert.equal(steps.length, 8, "向导必须正好 8 步，实际 " + steps.length);
+  assert.ok(textOf(dlg).includes("长连接必须已在线"), "必须写明顺序坑：保存事件配置时长连接必须已在线");
+  assert.ok(textOf(dlg).includes("先在第 8 步填凭据"), "必须写明正确顺序：先填凭据连上，再去后台保存事件配置");
+});
+
+test("飞书依赖：失败状态可重试，失败原因人话展示", async () => {
+  const plugin = loadPlugin();
+  plugin.setImDeps({ installed: false, phase: "failed", version: "", lastError: "网络不通：检查能否访问 npm registry" });
+  plugin.setImBotsGet({
+    ok: true, wecom: {}, dingtalk: {}, feishu: {},
+    status: { deps: { feishu: { installed: false, phase: "failed", version: "", lastError: "网络不通：检查能否访问 npm registry" } } },
+  });
+  let tree = await plugin.settle();
+  openEntry(tree, "channel");
+  tree = await plugin.settle();
+  clickChannelRow(tree, "飞书机器人");
+  tree = await plugin.settle();
+  assert.ok(textOf(tree).includes("网络不通"), "失败原因要人话展示");
+  assert.ok(btnWith(tree, "重试下载"), "失败后按钮变为「重试下载」");
+  btnWith(tree, "重试下载").props.onClick();
+  await flush(); await flush();
+  assert.ok(plugin.requests.some((r) => r.path === "/dsh-remote/im-deps/feishu" && r.method === "POST"), "重试必须再次触发安装");
+});
+
+test("飞书表单提交体：appId/appSecret/receiveId/receiveIdType；secret 不回显", async () => {
+  const plugin = loadPlugin();
+  plugin.setImDeps({ installed: true, phase: "done", version: "1.40.0", lastError: "" });
+  plugin.setImBotsGet({
+    ok: true, wecom: {}, dingtalk: {},
+    feishu: { enabled: true, appId: "cli_old", hasSecret: true, receiveId: "ou_old", receiveIdType: "open_id" },
+    status: { deps: { feishu: { installed: true, phase: "done", version: "1.40.0", lastError: "" } } },
+  });
+  let tree = await plugin.settle();
+  openEntry(tree, "channel");
+  tree = await plugin.settle();
+  clickChannelRow(tree, "飞书机器人");
+  tree = await plugin.settle();
+  const dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
+  // 已保存的 secret 不回显：password 输入框初始为空 + 占位提示
+  const sec = find(dlg, (n) => n.props?.id === "dru-fs-secret");
+  assert.equal(sec.props.value, "", "★ 已保存的 Secret 绝不能回显到输入框");
+  assert.ok(String(sec.props.placeholder || "").includes("已保存"), "要提示「已保存（留空表示不修改）」");
+  find(dlg, (n) => n.props?.id === "dru-fs-appid").props.onChange({ target: { value: "cli_new" } });
+  find(dlg, (n) => n.props?.id === "dru-fs-recv").props.onChange({ target: { value: "oc_chat_1" } });
+  find(dlg, (n) => n.props?.id === "dru-fs-rtype").props.onChange({ target: { value: "chat_id" } });
+  tree = await plugin.settle();
+  btnWith(tree, "仅保存").props.onClick();
+  await flush(); await flush();
+  const put = plugin.imBotsCalls().filter((c) => c.method === "PUT").pop();
+  assert.ok(put, "应 PUT /dsh-remote/im-bots");
+  assert.equal(put.body.platform, "feishu");
+  assert.deepEqual(put.body.config, { appId: "cli_new", appSecret: "", receiveId: "oc_chat_1", receiveIdType: "chat_id" },
+    "★ 飞书提交体字段锁死；空 secret = 不修改（不覆盖已保存的）");
 });
 
 // ───────────────────── ⑦ 配置页收口：说明折叠 + 统一字段结构 ─────────────────────
@@ -796,3 +939,223 @@ test("发送预览卡片：已绑定（boundChatId 非空）→ 不显示未绑
   assert.ok(!textOf(tree).includes("先在企微里给机器人发一句话完成绑定"), "已绑定就不该再提示未绑定");
   assert.ok(textOf(tree).includes("上次预览：09:07"), "应显示上次预览时间（HH:MM）");
 });
+
+// ───────────── ⑨ 未登录守卫 + 后台服务横排 + 卸载挽留（2026-11-07 业主逐条）─────────────
+
+test("未登录「手机访问」卡：文案写「登录并生成访问码」，点击弹登录弹层；登录成功后自动回到手机访问", async () => {
+  const plugin = loadPlugin();
+  plugin.setSignedIn(false);
+  let tree = await plugin.settle();
+  const card = find(tree, (n) => String(n.props?.className || "").includes("dru-ia-card")
+    && textOf(n).includes("手机访问"));
+  assert.ok(card, "入口网格里应有「手机访问」卡");
+  assert.ok(textOf(card).includes("登录并生成访问码"), "未登录时按钮文案必须是「登录并生成访问码」（不是静默失败）");
+  const btn = find(card, (n) => n.type === "button");
+  btn.props.onClick();
+  tree = await plugin.settle();
+  assert.ok(textOf(tree).includes("登录后才能用手机访问"), "点击后弹登录弹层并说明原因");
+
+  // 登录成功 → 自动回到「手机访问」流程（iaAfterLogin 回跳），不再让用户自己再找一遍
+  plugin.setSignedIn(true);
+  tree = await plugin.settle(4);
+  assert.ok(textOf(tree).includes("手机访问"), "登录后应回到手机访问流程");
+  const dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
+  assert.ok(dlg, "登录后应自动打开手机访问弹层");
+});
+
+test("后台服务区块（A6）：显眼提示 + 横向紧凑网格（状态/启停/自启动/设备ID 不再竖排占屏）", async () => {
+  const plugin = loadPlugin();
+  const tree = await plugin.settle();
+  assert.ok(textOf(tree).includes("保持在线，才能用手机端远程控制这台电脑"), "必须有「保持在线」提示（业主点名）");
+  const grid = find(tree, (n) => String(n.props?.className || "") === "dru-bridge-grid");
+  assert.ok(grid, "后台服务应为横向网格布局（.dru-bridge-grid）");
+  const cells = byClass(grid, "dru-bridge-cell");
+  assert.ok(cells.length >= 4, "网格应含 4 格：状态 / 启停 / 自启动 / 设备 ID，实际 " + cells.length);
+  assert.ok(cells.some((c) => textOf(c).includes("设备 ID")), "设备 ID 在网格里（横向）");
+});
+
+test("彻底卸载（A7）：先弹挽留反馈（原因单选 + 建议）→ 提交走现有反馈通道 → 才继续卸载", async () => {
+  const plugin = loadPlugin();
+  let tree = await plugin.settle();
+  const unBtn = btnWith(tree, "彻底卸载");
+  assert.ok(unBtn, "应有「彻底卸载」按钮");
+  unBtn.props.onClick();
+  tree = await plugin.settle();
+  const dlg = find(tree, (n) => String(n.props?.className || "").split(/\s+/).includes("dru-ia-dialog"));
+  assert.ok(dlg, "点彻底卸载应先弹挽留反馈弹层");
+  assert.ok(textOf(dlg).includes("为什么要卸载"), "弹层要问「为什么要卸载？」；实际=" + textOf(dlg).slice(0, 200));
+  const radios = findAll(dlg, (n) => n.type === "input" && n.props?.type === "radio");
+  assert.ok(radios.length >= 4, "应有多个原因单选，实际 " + radios.length);
+  assert.ok(find(dlg, (n) => n.type === "textarea"), "应有可填建议的输入框");
+  assert.ok(btnWith(dlg, "我再想想"), "必须有「我再想想」退出选项");
+  // 未选原因就点「仍要卸载」→ 就近报错，且不提交/不卸载
+  const before = plugin.requests.length;
+  btnWith(dlg, "仍要卸载").props.onClick();
+  tree = await plugin.settle();
+  assert.ok(textOf(tree).includes("请选择一个卸载原因"), "未选原因要给就近错误");
+  const after = plugin.requests.slice(before).map((r) => r.path);
+  assert.ok(!after.includes("/dsh-remote/feedback"), "未选原因不得提交反馈（" + after.join(",") + "）");
+  assert.ok(!after.includes("/dsh-remote/self/uninstall"), "未选原因更不得开始卸载");
+
+  // 选一个原因 + 写建议 → 仍要卸载：先 POST 反馈（kind=uninstall），再 POST 卸载
+  const r0 = findAll(tree, (n) => n.type === "input" && n.props?.type === "radio")[0];
+  r0.props.onChange({ target: { value: r0.props.value } });
+  tree = await plugin.settle();
+  const note = find(tree, (n) => n.type === "textarea");
+  note.props.onChange({ target: { value: "加载太慢，希望优化" } });
+  tree = await plugin.settle();
+  btnWith(tree, "仍要卸载").props.onClick();
+  await flush(); await flush(); await flush();
+  const fb = plugin.requests.find((r) => r.path === "/dsh-remote/feedback" && r.method === "POST");
+  assert.ok(fb, "★ 必须先提交挽留反馈（复用现有反馈通道，不新增后端）");
+  assert.equal(fb.body.kind, "uninstall", "反馈必须带 kind=uninstall 标记");
+  assert.ok(String(fb.body.content).includes("原因"), "反馈内容要含所选原因");
+  assert.ok(String(fb.body.content).includes("加载太慢"), "用户填的建议要带上");
+  assert.ok(plugin.requests.some((r) => r.path === "/dsh-remote/self/uninstall" && r.method === "POST"),
+    "★ 提交反馈后应继续执行卸载（反馈不能反过来卡住用户）");
+});
+
+// ───────────────────── ⑩ 会员档位条 + 会话固定门禁（2026-11-07 桥侧判定） ─────────────────────
+
+test("企微配置页档位条：免费档 → 「本月剩余 N 条指令（每月 20 条）」+ 「升级 Pro 不限量」链接", async () => {
+  const plugin = loadPlugin();
+  plugin.setImBotsGet({
+    ok: true,
+    wecom: { enabled: true, botId: "aibdemo1234", hasSecret: true, url: "", targetChatId: "", sessionId: "", sessionTitle: "" },
+    status: {
+      connected: true, authenticated: true, tier: "free",
+      messagesPerMonth: 20, remainingMessages: 7, usage: { month: "2026-11", messages: 13 },
+      bindingGated: false, caps: ["wecom"], capsCount: 1,
+      sessions: [], activeSessionId: "", boundSessionId: "",
+    },
+  });
+  const tree = await openWecom(plugin);
+  const tierBar = find(tree, (n) => String(n.props?.className || "").includes("dru-ia-tier"));
+  assert.ok(tierBar, "免费档应渲染档位条");
+  assert.ok(textOf(tierBar).includes("免费档"), "档位条要写明「免费档」");
+  assert.ok(textOf(tierBar).includes("本月剩余 7 条指令"), "要显示剩余指令数");
+  assert.ok(textOf(tierBar).includes("每月 20 条"), "要显示每月上限");
+  const link = find(tierBar, (n) => n.type === "a");
+  assert.ok(link, "免费档必须有升级入口");
+  assert.equal(link.props.href, "/app/promo", "升级链接指向 /app/promo");
+  assert.ok((link.children || []).join("").includes("升级 Pro 不限量"));
+});
+
+test("企微配置页档位条：pro / pro_max → 「会员档 · 指令不限」，不出现升级链接", async () => {
+  for (const tier of ["pro", "pro_max"]) {
+    const plugin = loadPlugin();
+    plugin.setImBotsGet({
+      ok: true,
+      wecom: { enabled: true, botId: "aibdemo1234", hasSecret: true, url: "", targetChatId: "", sessionId: "", sessionTitle: "" },
+      status: { connected: true, authenticated: true, tier, bindingGated: false, sessions: [], activeSessionId: "", boundSessionId: "" },
+    });
+    const tree = await openWecom(plugin);
+    const tierBar = find(tree, (n) => String(n.props?.className || "").includes("dru-ia-tier"));
+    assert.ok(tierBar, tier + " 应渲染档位条");
+    assert.ok(textOf(tierBar).includes("会员档 · 指令不限"), tier + " 文案应为「会员档 · 指令不限」");
+    assert.equal(find(tierBar, (n) => n.type === "a"), undefined, tier + " 会员档不该有升级链接");
+  }
+});
+
+test("企微配置页档位条：取不到 tier / 未知值 → 整行不渲染（绝不瞎猜）", async () => {
+  for (const status of [
+    { connected: true, sessions: [], activeSessionId: "", boundSessionId: "" },                 // 旧桥：没有 tier
+    { connected: true, tier: "gold", sessions: [], activeSessionId: "", boundSessionId: "" },    // 未知值
+  ]) {
+    const plugin = loadPlugin();
+    plugin.setImBotsGet({
+      ok: true,
+      wecom: { enabled: false, botId: "", hasSecret: false, url: "", targetChatId: "", sessionId: "", sessionTitle: "" },
+      status,
+    });
+    const tree = await openWecom(plugin);
+    assert.equal(find(tree, (n) => String(n.props?.className || "").includes("dru-ia-tier")), undefined,
+      "拿不到有效档位时不得渲染档位条（" + JSON.stringify(status.tier) + "）");
+  }
+});
+
+test("会话固定门禁：bindingGated=true → 下拉置灰 + 「会员功能」徽章 + 悬停说明；已选值被忽略时如实说明", async () => {
+  const plugin = loadPlugin();
+  plugin.setImBotsGet({
+    ok: true,
+    wecom: { enabled: true, botId: "aibdemo1234", hasSecret: true, url: "", targetChatId: "", sessionId: "sess-1-abcdef123456", sessionTitle: "修复登录问题" },
+    status: {
+      connected: true, authenticated: true, tier: "free", bindingGated: true,
+      sessions: [{ id: "sess-1-abcdef123456", title: "修复登录问题", updatedAt: 1 }],
+      activeSessionId: "sess-2-xyz", activeSessionTitle: "部署到 NAS", boundSessionId: "",
+    },
+  });
+  const tree = await openWecom(plugin);
+  const sel = find(tree, (n) => n.type === "select" && n.props?.id === "dru-wecom-session");
+  assert.ok(sel, "下拉仍应存在（只是置灰）");
+  assert.equal(sel.props.disabled, true, "★ 免费档必须置灰（不能假装能选）");
+  assert.equal(sel.props.title, "升级后可固定转接会话", "悬停必须说明为什么不能选");
+  assert.equal(sel.props.value, "", "被忽略的选择不能显示成生效值");
+  const badge = find(tree, (n) => String(n.props?.className || "").includes("dru-ia-badge"));
+  assert.ok(badge && textOf(badge).includes("会员功能"), "置灰处要有「会员功能」徽章");
+  assert.ok(textOf(tree).includes("当前跟随活跃会话"), "已选值被忽略时要显示「当前跟随活跃会话」");
+  assert.ok(textOf(tree).includes("免费档不能固定转接"), "小字要说明原因");
+});
+
+// ───────────────────── ⑪ 品牌全名 + 安装命令（2026-11-07 业主） ─────────────────────
+
+test("品牌：面板标题 / 关于卡片统一用全名 dsh-remote-web，旧的「关于 dsh-remote」不再出现", async () => {
+  const plugin = loadPlugin();
+  const tree = await plugin.settle();
+  // 顶部面板标题（业主：「我的插件名字叫 dsh-remote-web，这个是全名」）
+  const title = find(tree, (n) => String(n.props?.className || "").includes("dru-settings-title"));
+  assert.ok(title, "应有面板标题");
+  assert.equal((title.children || []).join(""), "dsh-remote-web", "顶部标题必须是品牌全名 dsh-remote-web");
+  // 关于卡片
+  assert.ok(textOf(tree).includes("关于 dsh-remote-web"), "关于段落标题应为「关于 dsh-remote-web」");
+  // 精确断言：不得再出现裸品牌「关于 dsh-remote」（但不能误伤包名 @mrrisega/dsh-remote）
+  assert.doesNotMatch(SOURCE, /关于 dsh-remote(?!-web)/, "旧品牌写法「关于 dsh-remote」不得再出现");
+  assert.match(SOURCE, /@mrrisega\/dsh-remote/, "包名 @mrrisega/dsh-remote 必须保留（不是品牌文案）");
+  assert.match(SOURCE, /~\/\.dsh-remote/, "配置目录 ~/.dsh-remote 必须保留（代码/数据路径，不是品牌文案）");
+});
+
+test("版本与更新：有一行可复制的安装/更新命令 npx @mrrisega/dsh-remote@latest + 「重跑这条命令即可」说明", async () => {
+  const plugin = loadPlugin();
+  let tree = await plugin.settle();
+  assert.ok(textOf(tree).includes("npx @mrrisega/dsh-remote@latest"), "版本卡必须给出安装/更新命令");
+  assert.ok(textOf(tree).includes("已安装的更新：重跑这条命令即可"), "要说明更新方式是重跑该命令");
+  const copyBtn = find(tree, (n) => n.type === "button" && n.props?.["aria-label"] === "复制安装命令");
+  assert.ok(copyBtn, "命令旁必须有复制按钮（复用现有复制反馈样式）");
+  const code = find(tree, (n) => String(n.props?.className || "").includes("dru-code-val"));
+  assert.ok(code && (code.children || []).join("").includes("@mrrisega/dsh-remote@latest"), "命令要以可复制的代码样式展示");
+
+  copyBtn.props.onClick();
+  await flush(); await flush();
+  assert.deepEqual(plugin.clipboard, ["npx @mrrisega/dsh-remote@latest"], "★ 点复制必须把安装命令写进剪贴板");
+  tree = await plugin.settle();
+  assert.ok(textOf(tree).includes("✅ 已复制"), "复制成功要有与其它复制按钮一致的反馈");
+});
+
+test("飞书依赖下载：点下载 → POST 安装 → 轮询 /im-deps，装好后页面自动切到配置表单（无需重开弹层）", async () => {
+  const plugin = loadPlugin();
+  plugin.setImDeps({ installed: false, phase: "idle", version: "", lastError: "" });
+  plugin.setImBotsGet({
+    ok: true, wecom: {}, dingtalk: {}, feishu: {},
+    status: { deps: { feishu: { installed: false, phase: "idle", version: "", lastError: "" } } },
+  });
+  let tree = await plugin.settle();
+  openEntry(tree, "channel");
+  tree = await plugin.settle();
+  clickChannelRow(tree, "飞书机器人");
+  tree = await plugin.settle();
+  assert.ok(btnWith(tree, "下载依赖"), "未装依赖先给下载入口");
+
+  btnWith(tree, "下载依赖").props.onClick();
+  await flush(); await flush();
+  assert.equal(plugin.depsInstalls().length, 1, "★ 点下载必须触发一次后台安装");
+
+  // 先渲染一次让"下载中"的轮询 effect 挂上定时器，再模拟安装完成
+  tree = await plugin.settle(2);
+  plugin.setImDeps({ installed: true, phase: "done", version: "1.40.0", lastError: "" });
+  await plugin.advance(1000);   // 触发轮询定时器（真实环境 900ms 一次）
+  await flush(); await flush();
+  tree = await plugin.settle(4);
+  assert.ok(plugin.depsCalls().length >= 1, "应轮询 /dsh-remote/im-deps 拿进度");
+  assert.ok(textOf(tree).includes("1.40.0"), "装好后面板直接显示版本（用户不需要重开弹层）");
+  assert.ok(find(tree, (n) => n.props?.id === "dru-fs-appid"), "装好后应出现飞书配置表单");
+});

package/packages/dsh-remote-web/test/purchase-agreement-ui.test.mjs

@@ -266,7 +266,7 @@ test("① 免费用户账号卡：升级 PRO 按钮仍在，但协议文案/链
   const plugin = loadPlugin();
   const tree = await plugin.settle(4);
   // 购买入口（升级按钮）必须还在 —— 这次只删协议文案，不动购买能力
-  assert.ok(nodeWithText(tree, "🚀 升级 PRO"), "免费用户的「🚀 升级 PRO」按钮必须保留");
+  assert.ok(nodeWithText(tree, "升级 PRO"), "免费用户的「升级 PRO」按钮必须保留（图标换成内联 SVG，文案不再用 emoji）");
   // 协议痕迹一个都不能有
   assertNoAgreementInPanel(tree);
   // 客户端也不再为了这句话去问 node 半（面板里已经没有消费者了）
@@ -278,7 +278,7 @@ test("② 会员账号卡（业主点名场景）：续费会员按钮下方不
     account: { plan: "pro", plan_source: "subscription", plan_ends_at: 1893456000000, invite_code: "ABC12345" },
   });
   const tree = await plugin.settle(4);
-  assert.ok(nodeWithText(tree, "🔄 续费会员"), "前提：会员的续费入口在（这正是业主看到那句话的位置）");
+  assert.ok(nodeWithText(tree, "续费会员"), "前提：会员的续费入口在（这正是业主看到那句话的位置）");
   assertNoAgreementInPanel(tree);
 });
 
@@ -314,7 +314,7 @@ test("④ 未登录：没有购买入口，也没有任何协议痕迹/请求",
     },
   });
   const tree = await plugin.settle(4);
-  assert.equal(nodeWithText(tree, "🚀 升级 PRO"), undefined, "未登录没有购买入口");
+  assert.equal(nodeWithText(tree, "升级 PRO"), undefined, "未登录没有购买入口");
   assertNoAgreementInPanel(tree);
   assert.equal(plugin.agreementRequests().length, 0);
 });
@@ -334,7 +334,7 @@ test("⑤ 源码级回归锁：client.js 里不得再残留协议渲染痕迹（
 test("⑥ 只删文案、不动购买能力：点「升级 PRO」仍走既有购买流程（请求 /dsh-remote/access-key）", async () => {
   const plugin = loadPlugin();
   let tree = await plugin.settle(4);
-  const btn = nodeWithText(tree, "🚀 升级 PRO");
+  const btn = nodeWithText(tree, "升级 PRO");
   assert.ok(btn, "升级按钮必须还在");
   btn.props.onClick();
   await plugin.settle(2);