@mrrisega/dsh-remote 0.7.0-beta.7 → 0.7.0

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 (68) hide show
  1. package/clients/dsh-remote/dsh-bridge.mjs +17 -17
  2. package/clients/dsh-remote/dsh-events.mjs +6 -6
  3. package/clients/dsh-remote/e2ee-client.mjs +7 -7
  4. package/clients/dsh-remote/e2ee-shim-script.js +9 -9
  5. package/clients/dsh-remote/mobile-adapter.mjs +21 -21
  6. package/clients/dsh-remote/test/bridge-gzip.test.mjs +1 -1
  7. package/clients/dsh-remote/test/device-registration-report.test.mjs +1 -1
  8. package/clients/dsh-remote/test/dsh-events.test.mjs +10 -10
  9. package/clients/dsh-remote/test/e2ee-bridge.test.mjs +4 -4
  10. package/clients/dsh-remote/test/e2ee-client.test.mjs +7 -7
  11. package/clients/dsh-remote/test/e2ee-shim.test.mjs +1 -1
  12. package/clients/dsh-remote/test/e2ee-wecrypto-parity.test.mjs +1 -1
  13. package/clients/dsh-remote/test/harness-cookie-authority.test.mjs +4 -4
  14. package/clients/dsh-remote/test/machine-fingerprint.test.mjs +2 -2
  15. package/clients/dsh-remote/test/mobile-adapter-guards.test.mjs +6 -6
  16. package/clients/dsh-remote/test/mobile-adapter-image.test.mjs +1 -1
  17. package/clients/dsh-remote/test/mobile-adapter-runtime.test.mjs +5 -5
  18. package/clients/dsh-remote/test/upstream-discovery.test.mjs +1 -1
  19. package/clients/dsh-remote/test/wechat-channel.test.mjs +5 -5
  20. package/clients/dsh-remote/test/wechat-runtime.test.mjs +26 -26
  21. package/clients/dsh-remote/test/wechat-tier-source.test.mjs +2 -2
  22. package/clients/dsh-remote/wechat-channel.mjs +9 -9
  23. package/clients/dsh-remote/wechat-runtime.mjs +38 -38
  24. package/docs/telemetry.md +3 -3
  25. package/dsh-setup.mjs +63 -26
  26. package/package.json +2 -2
  27. package/packages/dsh-remote-web/lib/client.js +56 -56
  28. package/packages/dsh-remote-web/lib/fix-prompt.js +1 -1
  29. package/packages/dsh-remote-web/lib/index.js +43 -43
  30. package/packages/dsh-remote-web/lib/tarball-update.js +1 -1
  31. package/packages/dsh-remote-web/package.json +1 -1
  32. package/packages/dsh-remote-web/runtime/clients/dsh-remote/dsh-bridge.mjs +17 -17
  33. package/packages/dsh-remote-web/runtime/clients/dsh-remote/dsh-events.mjs +6 -6
  34. package/packages/dsh-remote-web/runtime/clients/dsh-remote/e2ee-client.mjs +7 -7
  35. package/packages/dsh-remote-web/runtime/clients/dsh-remote/e2ee-shim-script.js +9 -9
  36. package/packages/dsh-remote-web/runtime/clients/dsh-remote/mobile-adapter.mjs +21 -21
  37. package/packages/dsh-remote-web/runtime/clients/dsh-remote/wechat-channel.mjs +9 -9
  38. package/packages/dsh-remote-web/runtime/clients/dsh-remote/wechat-runtime.mjs +38 -38
  39. package/packages/dsh-remote-web/runtime/clients/dsh-web/native.html +5 -5
  40. package/packages/dsh-remote-web/runtime/dsh-setup.mjs +63 -26
  41. package/packages/dsh-remote-web/test/account-switch-device.test.mjs +2 -2
  42. package/packages/dsh-remote-web/test/activation-single-point.test.mjs +1 -1
  43. package/packages/dsh-remote-web/test/announcements-ui.test.mjs +1 -1
  44. package/packages/dsh-remote-web/test/connect-loop.test.mjs +1 -1
  45. package/packages/dsh-remote-web/test/connect-ui.test.mjs +2 -2
  46. package/packages/dsh-remote-web/test/desktop-compat.test.mjs +4 -4
  47. package/packages/dsh-remote-web/test/diag-report.test.mjs +1 -1
  48. package/packages/dsh-remote-web/test/fix-prompt.test.mjs +2 -2
  49. package/packages/dsh-remote-web/test/harness-restart.test.mjs +1 -1
  50. package/packages/dsh-remote-web/test/install-profile-targets.test.mjs +6 -4
  51. package/packages/dsh-remote-web/test/installer-cli.test.mjs +1 -1
  52. package/packages/dsh-remote-web/test/launchd-domain.test.mjs +2 -2
  53. package/packages/dsh-remote-web/test/patch-activation.test.mjs +2 -2
  54. package/packages/dsh-remote-web/test/picker-pin.test.mjs +1 -1
  55. package/packages/dsh-remote-web/test/plugin-manifest.test.mjs +2 -2
  56. package/packages/dsh-remote-web/test/quota-absent.test.mjs +4 -4
  57. package/packages/dsh-remote-web/test/remote-access-ui.test.mjs +2 -2
  58. package/packages/dsh-remote-web/test/settings-entry-placement.test.mjs +6 -6
  59. package/packages/dsh-remote-web/test/settings-entry.test.mjs +2 -2
  60. package/packages/dsh-remote-web/test/settings-open-path.test.mjs +4 -4
  61. package/packages/dsh-remote-web/test/setup-output.test.mjs +32 -9
  62. package/packages/dsh-remote-web/test/tarball-update.test.mjs +1 -1
  63. package/packages/dsh-remote-web/test/telemetry.test.mjs +4 -4
  64. package/packages/dsh-remote-web/test/uninstall-safety.test.mjs +2 -2
  65. package/packages/dsh-remote-web/test/watcher-upstream-port.test.mjs +1 -1
  66. package/packages/dsh-remote-web/test/wechat-bot-ui.test.mjs +7 -7
  67. package/packages/dsh-remote-web/test/windows-compat.test.mjs +5 -5
  68. package/scripts/test-net-guard.cjs +1 -1
@@ -165,7 +165,7 @@ function loadPlugin(opts = {}) {
165
165
  test("入口:settings.section 栏目(id/order/label)+ 侧栏底部官方槽 sidebar.footer.action", () => {
166
166
  const plugin = loadPlugin();
167
167
 
168
- // 2026-10-10 三修(业主口径「就要放侧栏底部那个位置」):入口改注册进**官方列表槽**
168
+ // 2026-10-10 三修(用户约定「就要放侧栏底部那个位置」):入口改注册进**官方列表槽**
169
169
  // `sidebar.footer.action`(宿主为侧栏底部区域提供的扩展点;0.2 实测该槽当前为空)。
170
170
  // 不再自己注入 DOM —— 前两次都是"自己找落点"找错的。
171
171
  assert.ok(plugin.injects.has("sidebar.footer.action"), "应注入官方侧栏底部槽");
@@ -359,7 +359,7 @@ test("源码约束:侧栏注入「远程访问」按钮与官方「设置」
359
359
  });
360
360
 
361
361
  test("源码约束:侧栏入口走官方槽位/无浮动面板/无切换账号;命名统一为「远程访问」", () => {
362
- // 2026-10-10 三修:侧栏入口**改回**官方槽位(业主口径「就要放侧栏底部那个位置」),
362
+ // 2026-10-10 三修:侧栏入口**改回**官方槽位(用户约定「就要放侧栏底部那个位置」),
363
363
  // 所以这条从"不得出现 footer.action"翻转为"必须走官方槽位、不得自己注入 DOM"。
364
364
  assert.match(SOURCE, /slots\.inject\("sidebar\.footer\.action"/);
365
365
  assert.doesNotMatch(SOURCE, /insertBefore\(btn, host\)/, "不得再自己插 DOM 找落点");
@@ -1,7 +1,7 @@
1
1
  /**
2
- * 「点入口怎么打开设置」契约测试(2026-10-11 业主反馈后的最终形态)。
2
+ * 「点入口怎么打开设置」契约测试(2026-10-11 用户反馈后的最终形态)。
3
3
  *
4
- * 背景(业主原话):
4
+ * 背景(用户原话):
5
5
  * ① 「账号菜单里面的那个删掉。只保留官方槽位的那个。」
6
6
  * ② 「设置界面出现了两个远程访问菜单。」—— 因为账号菜单注入的判据里加了"以设置结尾",
7
7
  * 而「通用设置」正好以"设置"结尾 → 注入行被插进了**设置面板**里,多出一个"远程访问"。
@@ -63,9 +63,9 @@ test("★ 设置面板打开后自动点中「远程访问」栏目", () => {
63
63
  assert.deepEqual(clicked, ["远程访问"], "面板开了要顺手切到我们的栏目");
64
64
  });
65
65
 
66
- test("★ 不再往账号菜单里插任何东西(业主明确要求删掉)", () => {
66
+ test("★ 不再往账号菜单里插任何东西(用户明确要求删掉)", () => {
67
67
  for (const banned of ["dru-menu-row", "accountMenuInjectTick", "MENU_ENTRY_SIG"]) {
68
- assert.ok(!SOURCE.includes(banned), `不得再往账号菜单里插条目:${banned}(已按业主要求删除)`);
68
+ assert.ok(!SOURCE.includes(banned), `不得再往账号菜单里插条目:${banned}(已按用户要求删除)`);
69
69
  }
70
70
  });
71
71
 
@@ -26,7 +26,7 @@ const SETUP = join(HERE, "..", "..", "..", "dsh-setup.mjs");
26
26
  const src = readFileSync(SETUP, "utf8");
27
27
 
28
28
  test("测试隔离:unset 系统操作开关的用例必须同时伪造 HOME(否则污染真实自启动)", () => {
29
- // 事故复盘:harness-restart 用例 unset DSH_RELAY_SKIP_SERVICE 去走真实分支,
29
+ // 故障回顾:harness-restart 用例 unset DSH_RELAY_SKIP_SERVICE 去走真实分支,
30
30
  // 但没伪造 HOME → 插件写 plist 的路径是 join(homedir(), "Library/LaunchAgents/…"),
31
31
  // 于是把**指向测试临时目录**的 plist 覆盖到开发者真实的 ~/Library/LaunchAgents,
32
32
  // 临时目录随即被删 → 真实 bridge 自启动彻底失效(本机实测踩到,macOS 26 用户反馈排查时发现)。
@@ -105,13 +105,13 @@ test("安装输出:跳过/不支持自启动时不得自相矛盾地显示「运
105
105
  });
106
106
 
107
107
  test("安装输出:服务状态字符串仍是插件面板可解析的稳定契约", () => {
108
- // 插件半按 running / 未运行 解析,不能因为排版调整改口径
109
- assert.ok(/\? `✅ 运行中/.test(src), "running 口径保留(带 pid)");
110
- assert.ok(/`未运行 \(\$\{st\.detail \|\| st\.status\}\)`/.test(src), "未运行口径保留(带原因)");
108
+ // 插件半按 running / 未运行 解析,不能因为排版调整改约定
109
+ assert.ok(/\? `✅ 运行中/.test(src), "running 约定保留(带 pid)");
110
+ assert.ok(/`未运行 \(\$\{st\.detail \|\| st\.status\}\)`/.test(src), "未运行约定保留(带原因)");
111
111
  });
112
112
 
113
113
  test("版本比较:预设版 < 同号正式版;beta.10 < beta.11(更新提示不能误判)", () => {
114
- // 事故背景:面板原本用 `latest !== current` 判断"有没有新版本",于是
114
+ // 故障背景:面板原本用 `latest !== current` 判断"有没有新版本",于是
115
115
  // ① 0.6.4-beta.11 与 0.6.4-beta.10 无法比大小;② 正式版 0.6.4 发布后,
116
116
  // 装了 0.6.4-beta.11 的人反而被当成"落后"(其实预设版 semver 低于正式版)。
117
117
  const src = readFileSync(join(HERE, "..", "lib", "index.js"), "utf8");
@@ -135,8 +135,8 @@ test("版本比较:预设版 < 同号正式版;beta.10 < beta.11(更新提
135
135
  assert.match(src, /cmp === null \? Boolean\(latest && latest !== current\) : cmp > 0/);
136
136
  });
137
137
 
138
- test("★ 插件覆盖必须原子:staging → 必需文件自检 → rename 切换(2026-09-26「dsh 起不来」事故)", () => {
139
- // 事故:旧实现 `rmSync(dest)` → `cpSync(pluginDir, dest)`,于是拷贝期间 dest 是"半个插件":
138
+ test("★ 插件覆盖必须原子:staging → 必需文件自检 → rename 切换(2026-09-26「dsh 起不来」故障)", () => {
139
+ // 故障:旧实现 `rmSync(dest)` → `cpSync(pluginDir, dest)`,于是拷贝期间 dest 是"半个插件":
140
140
  // dsh 恰在此刻启动 → package.json 已声明 bundle,但 cordis.patch.yml 还没拷到 →
141
141
  // `failed to read overlay … cordis.patch.yml: ENOENT` → **整个 GUI 起不来**。
142
142
  // 时间证据:dsh 报错 23:46:03,cordis.patch.yml 写完 23:46:05(差 2 秒)。
@@ -153,12 +153,12 @@ test("★ 插件覆盖必须原子:staging → 必需文件自检 → rename
153
153
  assert.match(fn, /renameSync\(backup, dest\)/, "切换失败必须把 backup 改回来(旧版仍可用)");
154
154
  // 反向锁:绝不允许回到"先 rm dest、再 cpSync 逐文件"的旧写法
155
155
  assert.ok(!/fs\.rmSync\(dest,\s*\{\s*recursive:\s*true,\s*force:\s*true\s*\}\);\s*\n\s*fs\.cpSync\(/.test(fn),
156
- "🔴 不得再出现「先删 dest 再原地逐文件拷贝」——那正是这次事故的成因");
156
+ "🔴 不得再出现「先删 dest 再原地逐文件拷贝」——那正是这次故障的成因");
157
157
  assert.match(fn, /\.staging-\$\{process\.pid\}|\.staging-/, "被强杀留下的 staging 要能清理");
158
158
  });
159
159
 
160
160
  test("★ 插件拷贝必须保留**自带的 runtime/node_modules**(ws 是桥唯一的裸依赖)", () => {
161
- // 2026-10-10 事故形态:过滤规则写的是"任何一段叫 node_modules 就剔除",
161
+ // 2026-10-10 故障形态:过滤规则写的是"任何一段叫 node_modules 就剔除",
162
162
  // 本意只想去掉插件自己的依赖目录(那些由 profile 的包管理器管),
163
163
  // 却把 `runtime/node_modules/ws` 一起剔了 —— 而这份运行时正是"只有插件半"的机器
164
164
  // **自愈补装时的唯一来源**。剔掉它 → 自愈出来的运行环境缺 ws
@@ -226,3 +226,26 @@ test("★ 自启动配置里可以钉住上游(多 profile 时代,各宿主
226
226
  const svcAt = src.indexOf("svc = installAutostart()");
227
227
  assert.ok(pinAt > 0 && svcAt > 0 && pinAt < svcAt, "钉定必须发生在 installAutostart() 之前");
228
228
  });
229
+
230
+ test("★ 桌面应用在运行时,绝不改写它的 profile(否则应用会自己退出/重启)", () => {
231
+ // 2026-10-11 故障:在应用运行中改写 ~/.dsh/profiles/desktop/ 的插件文件 →
232
+ // 应用随即自己退出/重启(用户:"怎么又触发了 dsh 的关闭")。安装器文案早就写了"先完全退出应用",
233
+ // 但必须由程序强制,不能靠人记得。
234
+ const src = readFileSync(SETUP, "utf8");
235
+ assert.match(src, /function dshDesktopAppRunning\(/, "要有「桌面应用是否在运行」的探测");
236
+ assert.match(src, /Contents\/MacOS\/DeepSeek/, "探测要匹配 App 包内可执行文件(-x DeepSeek 匹配不到,实测)");
237
+ // 必须在真正写 profile **之前**判断
238
+ const loopAt = src.indexOf("for (const t of targets) {");
239
+ const guardAt = src.indexOf("dshDesktopAppRunning()", loopAt);
240
+ const applyAt = src.indexOf("await pluginApplyTo(", loopAt);
241
+ assert.ok(loopAt > 0 && guardAt > loopAt && applyAt > guardAt,
242
+ "顺序必须是:循环 → 应用在运行?→ 跳过;否则才 pluginApplyTo()");
243
+ assert.match(src, /跳过 desktop:DeepSeek Harness 应用正在运行/, "要如实说明跳过了 desktop");
244
+ assert.match(src, /应用内「插件」页安装/, "要给出官方替代路径(应用内插件页)");
245
+ assert.match(src, /"--force"/, "要留 --force 逃生口");
246
+ // sync-local 脚本同样要保护(本机同步最常用)
247
+ const sync = readFileSync(join(HERE, "..", "..", "..", "scripts", "sync-local.mjs"), "utf8");
248
+ assert.match(sync, /function dshDesktopAppRunning\(/, "本机同步脚本也要有同样的保护");
249
+ assert.match(sync, /跳过插件半/, "要明确说「只跳过插件半」(桥半不受影响)");
250
+ assert.match(sync, /--force-plugin/, "要留逃生口");
251
+ });
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 零依赖 tarball 更新通道的回归测试(node:test,零框架)。
3
3
  *
4
- * 背景(真实事故,见 lib/tarball-update.js 顶部注释):
4
+ * 背景(真实故障,见 lib/tarball-update.js 顶部注释):
5
5
  * Windows 上「一键更新」走的 `npx` 在 Node ≥20.12 起同步 EINVAL,0.6.6 及更早的升级通道
6
6
  * 本身是坏的 —— 79 台点过一键更新的 Windows 机器全部 update_failed,且产品内无出路。
7
7
  * 本文件就是给替代通道(HTTPS 取 tarball → 内置 zlib + 自解析 tar 落 staging)上锁:
@@ -268,7 +268,7 @@ test("触发点:plugin_loaded → install_started → runtime_ready → bridge
268
268
 
269
269
  const { host, base } = await serve(routes);
270
270
  try {
271
- // ③ 运行环境补齐(dsh-setup.mjs 落地)→ 面板轮询触达探针 → runtime_ready
271
+ // ③ 运行环境补齐(dsh-setup.mjs 落地)→ 面板轮询触达探测 → runtime_ready
272
272
  await writeFile(path.join(env.relayDir, "dsh-setup.mjs"), "// runtime stub");
273
273
  let r = await bridgeStatus(base);
274
274
  assert.equal(r.ok, true);
@@ -351,7 +351,7 @@ test("隐私审计:对抗性 extra 字段(手机号/hostname/machine_fp/路
351
351
  // 直接往唯一的构造点灌脏数据:字段白名单 + 事件名校验必须把它们全部丢掉
352
352
  TELEMETRY.record(env.relayDir, "install_started", { device_id: "dev-telemetry", machine_fp: "fp-abc" });
353
353
  TELEMETRY.record(env.relayDir, "plugin_loaded", { hostname: "mac.local", username: "mac" });
354
- TELEMETRY.record(env.relayDir, "panel_opened", { path: "/Users/mac/.dsh-remote", phone: "13800000000" });
354
+ TELEMETRY.record(env.relayDir, "panel_opened", { path: "/home/user/relay", phone: "13800000000" });
355
355
  TELEMETRY.record(env.relayDir, "update_started", { email: "a@b.c", token: "jwt", password: "pw" });
356
356
  TELEMETRY.record(env.relayDir, "harness_restart", { ip: "1.2.3.4" });
357
357
  // 白名单外的事件名:一条都不入队
@@ -554,7 +554,7 @@ test("冻结契约:既有事件名与既有字段一字不改(本次只新
554
554
  assert.match(String(ev.node), /^\d+$/);
555
555
  assert.ok(!("fail_code" in ev), "fail_code 仍只出现在 *_failed 事件上");
556
556
  assert.equal(TELEMETRY.eventOf("user_login"), null, "白名单外事件名照旧不发");
557
- // 通道与"一键更新"同源:面板看到的通道 = 上报的通道(两处口径必须是一处)
557
+ // 通道与"一键更新"同源:面板看到的通道 = 上报的通道(两处约定必须是一处)
558
558
  assert.equal(ev.channel, TELEMETRY.updateTag);
559
559
  });
560
560
 
@@ -845,7 +845,7 @@ test("面板可见性:关于卡片写明「匿名统计 + 关闭方式」,
845
845
  "客户端上报的事件,不是服务端的实时存量",
846
846
  "bot_id",
847
847
  ]) {
848
- assert.ok(doc.includes(line), "docs/telemetry.md 必须写明微信通道事件的口径边界:" + line);
848
+ assert.ok(doc.includes(line), "docs/telemetry.md 必须写明微信通道事件的约定边界:" + line);
849
849
  }
850
850
  for (const code of TELEMETRY.failCodes) assert.ok(doc.includes(code), "docs/telemetry.md 必须列出失败码:" + code);
851
851
  });
@@ -89,7 +89,7 @@ async function plantProfile(home, { extraPatch = "", unmarked = false } = {}) {
89
89
  fs.mkdirSync(path.join(home, "relay"), { recursive: true });
90
90
  // ⚠️ api_url 必须指向本地死端口:这些是**假账号**,一旦按默认地址请求生产,
91
91
  // /api/device-login 会带着假密码失败,而服务端登录限流是按出口 IP 计的(5 次/15 分钟)——
92
- // 实测结果是把**本机真实的 bridge** 连坐进限流(2026-09-19 事故)。
92
+ // 实测结果是把**本机真实的 bridge** 连坐进限流(2026-09-19 故障)。
93
93
  fs.writeFileSync(path.join(home, "relay", ".dsh-config.json"),
94
94
  JSON.stringify({ phone: "13800000000", password: "pw", api_url: "http://127.0.0.1:1" }));
95
95
  return { profile, patchFile: path.join(profile, "cordis.patch.yml") };
@@ -418,7 +418,7 @@ test("安全:三处机密写入都要显式收紧 ACL(Windows 上 mode 0o600
418
418
  });
419
419
 
420
420
  test("安全:Cookie 的每个写入点都必须紧跟着 hardenFile(按 authority 分文件后不得漏收)", () => {
421
- // 0.7.0-beta.2 把 Cookie 从「一份共享文件」改成「本宿主专属 + 旧版镜像」两份(见 P0-2 事故根治)。
421
+ // 0.7.0-beta.2 把 Cookie 从「一份共享文件」改成「本宿主专属 + 旧版镜像」两份(见 P0-2 故障根治)。
422
422
  // 写点从 1 个变 2 个 —— 逐个按变量名断言,漏收的那一份在 Windows 上就是 ACL 敞开状态。
423
423
  const mint = INDEX_SRC.slice(INDEX_SRC.indexOf("async function mintHarnessCookie"), INDEX_SRC.indexOf("function readHarnessCookie"));
424
424
  assert.ok(mint.length > 0, "应能定位到 mintHarnessCookie(找不到说明函数被改名,请同步本用例)");
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  /**
3
- * watcher 的上游端口发现回归 —— 复现 2026-09-23 两起真实事故的**用户可见形态**。
3
+ * watcher 的上游端口发现回归 —— 复现 2026-09-23 两起真实故障的**用户可见形态**。
4
4
  *
5
5
  * 现场(用户报告,DSH Desktop 2.0.4 + 插件 0.6.10):
6
6
  * ```
@@ -16,7 +16,7 @@
16
16
  // ⑦ 控制面缺失(bridge 没跑/版本旧)要说清楚怎么办,**绝不**留一个永久 spinner;
17
17
  // ⑧ 无障碍:真 <button>、aria-live 播报、不靠颜色单独表意。
18
18
  //
19
- // 【0.6.12 新增】产品引导(业主口径:「动效引导」+ 微信通道要求已注册并登录):
19
+ // 【0.6.12 新增】产品引导(用户约定:「动效引导」+ 微信通道要求已注册并登录):
20
20
  // ⑨ 首屏导览:未绑定时内容体最上面三行讲清用途(推送 / 回数字拍板 / 微信里交代任务),
21
21
  // DOM 顺序在「连接微信机器人」之前,且是小字紧凑排版(不把按钮挤出首屏);
22
22
  // ⑩ 登录门:未登录**不渲染**微信 tab,登录后当场出现(不刷新页面);会话在 tab 开着时失效
@@ -355,7 +355,7 @@ test("入口:settings.section 里**只有**「📱 远程访问」一个栏目
355
355
  const list = plugin.sectionList();
356
356
  const ids = list.map((m) => m.id);
357
357
  // 【0.6.11 改断言】旧断言 deepEqual(ids, ["dsh-remote", "dsh-remote-wechat"]) + order 31 + label 含
358
- // 「🤖 微信机器人」编码的是**旧行为**(微信面板作为第二个设置栏目)。业主口径:「不要给它单独弄
358
+ // 「🤖 微信机器人」编码的是**旧行为**(微信面板作为第二个设置栏目)。用户约定:「不要给它单独弄
359
359
  // 一个菜单,直接放到『远程控制』面板里面」→ 第二个栏目已删,这里改为断言「只有一个栏目」。
360
360
  assert.deepEqual(ids, [ROOT_SECTION_ID], `设置页只应有一个栏目,实际:${ids.join(",")}`);
361
361
  assert.equal(list.length, 1, "settings.section 注册次数必须恰好是 1(不多不少)");
@@ -426,7 +426,7 @@ test("tab 条(home 与 wechat 共用):第三个 tab 是「微信机器人
426
426
  });
427
427
 
428
428
  test("绿泡泡与零外部资源(源码级):.dru-wx-ico 是微信品牌绿、不新增任何外部资源/依赖", () => {
429
- // 图标颜色:微信品牌绿 #07c160(业主口径:「增加上微信的绿泡泡小图标」)
429
+ // 图标颜色:微信品牌绿 #07c160(用户约定:「增加上微信的绿泡泡小图标」)
430
430
  assert.match(SOURCE, /\.dru-wx-ico\{[^}]*color:#07c160/, "绿泡泡必须是微信品牌绿 #07c160");
431
431
  // 装饰性:节点上 aria-hidden(可读名字来自同 tab 的文字标签,见上一条用例)
432
432
  assert.match(SOURCE, /className: "dru-wx-ico", "aria-hidden": "true"/, "图标节点必须 aria-hidden");
@@ -499,10 +499,10 @@ test("首屏导览:未绑定时就在最上面(DOM 顺序在「连接微信
499
499
  assert.ok(textHas(intro, "继续已有任务"), "③ 要明说免费也能继续已有任务(回复即续接)");
500
500
  assert.ok(textHas(intro, "开新任务"), "③ 要明说「在微信里开新任务」是会员能力");
501
501
  assert.ok(textHas(intro, "切换会话"), "③ 要明说「切换会话」是会员能力");
502
- // ★ 分层必须如实写在面板上:免费用户要能看出**付费多什么**(业主:"增加一个对比展示")。
502
+ // ★ 分层必须如实写在面板上:免费用户要能看出**付费多什么**(用户:"增加一个对比展示")。
503
503
  // 面板里含糊其辞 → 用户绑完去微信发句话拿到付费提示 → 只会觉得产品骗人。
504
504
  assert.ok(textHas(intro, "会员"), "必须标出哪些是会员能力(不能含糊)");
505
- assert.ok(textHas(intro, "额度"), "免费档要写明每月消息额度(业主:免费给每月 N 条)");
505
+ assert.ok(textHas(intro, "额度"), "免费档要写明每月消息额度(用户:免费给每月 N 条)");
506
506
  // 未绑定/未读到状态时不显示锁,免得闪一下
507
507
  assert.ok(!textHas(intro, "🔒") || textHas(intro, "会员"), "锁必须配「会员」字样,不能只给一个符号");
508
508
 
@@ -513,7 +513,7 @@ test("首屏导览:未绑定时就在最上面(DOM 顺序在「连接微信
513
513
  assert.ok(introAt < btnAt, `导览必须排在连接按钮之前(导览 #${introAt},按钮 #${btnAt})`);
514
514
  // 而且紧凑块排在内容体最前面:不会把连接按钮推到需要滚动才看得见的地方
515
515
  // (harness 渲染时会对普通节点做浅拷贝,所以拿树里的同一个节点比,不比组件里的原对象)
516
- // 【0.6.18】内容体第一个孩子变成了「两步走」操作引导块(.dru-wx-guide):用户口径是
516
+ // 【0.6.18】内容体第一个孩子变成了「两步走」操作引导块(.dru-wx-guide):用户约定是
517
517
  // 先在微信通道首屏讲清"这是干啥用的 + 两步怎么接",再给"你现在能用哪些能力"的清单 ——
518
518
  // 所以导览降为**第二个**孩子,连接按钮仍在首屏(两块都是紧凑小字卡片)。
519
519
  assert.equal(embed.children[0], find(embed, (n) => n.props?.className === "dru-wx-guide"),
@@ -923,7 +923,7 @@ test("★★ 面板能力镜像必须与运行时判定表一致(否则面板
923
923
  //
924
924
  // 上面那条镜像一致性用例保证的是「冷启动兜底等于运行时内置表」;
925
925
  // 下面这三条保证的是**服务端一旦下发了权益包,面板就以它为准** ——
926
- // 这是业主「后台改权限无需发版」与「话术与权限必须一致、不多承诺」的交汇点:
926
+ // 这是用户「后台改权限无需发版」与「话术与权限必须一致、不多承诺」的交汇点:
927
927
  // 后台把免费额度从 20 改成 5,面板必须当场说 5;说 20 就是让用户按 20 去发、
928
928
  // 第 6 条被拦,然后认为产品坏了。
929
929
  // ---------------------------------------------------------------------------
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * Windows 兼容回归(0.6.7 新增)。
3
3
  *
4
- * 背景(真实事故,用户诊断报告 + 本地逐条复现):
4
+ * 背景(真实故障,用户诊断报告 + 本地逐条复现):
5
5
  * dsh-remote-web 0.6.6 及更早的整套「服务状态 / 启停 / 重启」按 macOS/Linux 写死,
6
6
  * 在 Windows 上**运行期必死**——安装与网络都正常,坏的全是运行期:
7
7
  * ① launchTarget() 无条件调 process.getuid():Windows 没有这个 API(typeof !== "function")
@@ -267,7 +267,7 @@ test("win32:重启 harness 生成 node 助手(不再 /bin/sh),且生成
267
267
  });
268
268
 
269
269
  test("契约:插件里不存在「裸 spawn」——每个子进程都必须有 'error' 监听(否则打挂宿主)", () => {
270
- // 事故原文:spawn("/bin/sh") 在 Windows ENOENT,而 ChildProcess 没有 'error' 监听
270
+ // 故障原文:spawn("/bin/sh") 在 Windows ENOENT,而 ChildProcess 没有 'error' 监听
271
271
  // → 未捕获异常把 dsh web 打挂,且代码已经先把「已调度重启」写进日志、返回成功。
272
272
  // 生成的 Windows 助手源码是模板字符串(它自己挂了 error 监听),先从「真实代码」里剔除
273
273
  const helperStart = INDEX_SRC.indexOf("function buildRestartHelperSource(");
@@ -425,7 +425,7 @@ test("win32:dsh-setup 注册任务计划程序登录任务(不再只说「
425
425
  test("win32:彻底卸载会删掉任务计划条目(否则下次登录又被拉起来)", () => {
426
426
  const uninstall = INDEX_SRC.slice(INDEX_SRC.indexOf("function uninstallRuntime("), INDEX_SRC.indexOf("// ---------- DeepSeek harness 重启"));
427
427
  assert.ok(/schtasks", \["\/Delete", "\/TN", WIN_TASK_NAME, "\/F"\]/.test(uninstall), "卸载应删除 Windows 登录任务");
428
- assert.ok(/servicePlatform: isDarwin\(\) \? "launchd"/.test(uninstall), "servicePlatform 应包含 Windows 口径");
428
+ assert.ok(/servicePlatform: isDarwin\(\) \? "launchd"/.test(uninstall), "servicePlatform 应包含 Windows 约定");
429
429
  });
430
430
 
431
431
  test("win32:dsh-setup 生成的「重启 dsh web」助手也是合法可执行的 JS", async () => {
@@ -465,7 +465,7 @@ test("前端:bridge-status 轮询失败不再静默(旧版让面板永久停
465
465
  });
466
466
 
467
467
  test("测试隔离:套件不得访问任何外部地址(生产限流会被测试污染)", () => {
468
- // 事故(2026-09-19):有用例在配置里写了假账号却没覆盖 api_url → 按默认地址请求**生产中继**,
468
+ // 故障(2026-09-19):有用例在配置里写了假账号却没覆盖 api_url → 按默认地址请求**生产中继**,
469
469
  // 其中 /api/device-login 带假密码必然失败,而服务端登录限流按**出口 IP** 计(5 次/15 分钟)——
470
470
  // 结果不仅污染生产审计,还让**本机自己的 bridge 被连坐**(拿不到 JWT),
471
471
  // 真机表现成"切换账号后设备一直登记不上去",排查方向被彻底带偏。
@@ -564,7 +564,7 @@ test("win32:登录任务经 wscript+VBS 隐藏启动(旧版会弹黑色空
564
564
  test("win32:桌面端(Electron 解释器)自启动必须先设 ELECTRON_RUN_AS_NODE=1", async () => {
565
565
  // 现场价值:DeepSeek Harness 桌面端宿主里 process.execPath 是 Electron 应用二进制。
566
566
  // 不设这个变量,自启动拉起的不是 bridge 守护,而是**又开一个桌面端应用** ——
567
- // 表现为「服务登记成功、进程秒退、bridge 永远起不来」,与 0.6.15 端口事故一样难排查。
567
+ // 表现为「服务登记成功、进程秒退、bridge 永远起不来」,与 0.6.15 端口故障一样难排查。
568
568
  const dir = await mkdtemp(path.join(os.tmpdir(), "dsh-win-electron-"));
569
569
  try {
570
570
  const src = SETUP_SRC.slice(
@@ -1,7 +1,7 @@
1
1
  /**
2
2
  * 测试期网络护栏(NODE_OPTIONS=--require 注入,见 package.json 的 test 脚本)。
3
3
  *
4
- * 为什么必须有(2026-09-19 实测事故):
4
+ * 为什么必须有(2026-09-19 实测故障):
5
5
  * 有测试用例在 profile 配置里写了**假账号**(phone/password)却没覆盖 `api_url`,
6
6
  * 于是插件按默认地址去请求**生产中继** `https://n.risegao.cn:…`。其中
7
7
  * `/api/device-login` 带着假密码必然失败,而服务端的登录限流是**按出口 IP**