dsh-helper 0.16.7 → 0.17.1

package/CHANGELOG.md

@@ -8,6 +8,115 @@
 > （`package-lock.json` 根节点跟齐）与本文件顶部段落，两者连同提交一起走；发布只补 annotated tag，
 > 不再用 `npm version` 升版。
 
+## [0.17.1] — 未发布
+
+**修复 `lib/client.js` 的构建污染**：仓库里那份产物被打进了错误的 zod。
+
+### 问题
+
+本地 `node_modules` 从未 `npm ci` 过（只有一个 `.cache` 目录），esbuild 解析 `zod`
+时向上层目录搜，命中了 **`../dsh-expert/node_modules/zod`（4.6.2）**，于是产物变成
+994300 字节、内嵌 4.6.2；而干净环境（npm ci 后有 `node_modules/zod` 4.6.5）应当产出
+**994948 字节、内嵌 4.6.5**。表现为 `verify:ci` 报「产物与仓库里的 lib/client.js 不一致」，
+但 `src/client` 一行都没改 —— 是构建环境的问题，不是代码的问题。
+
+### 修复
+
+`npm ci` 补齐依赖后 `npm run build` 重出产物：994948 字节，md5 `a68f5e62…`，
+内嵌 `node_modules/zod` 4.6.5。typecheck / client smoke(81) / host smoke(118) 全绿。
+
+> 提醒：以后在干净 clone 上改客户端代码前，先 `npm ci`，否则产物会被隔壁仓库的依赖污染。
+
+## [0.17.0] — 2026-11-11
+
+**`send_file_to_im` 默认跟随当前会话，不再要求每个人手配 botId / toUserId。**
+
+### 为什么改
+
+0.16.9 及以前，「发给谁」只能靠 `config.json` 里的 `botId` + `toUserId` 或者工具参数指定。
+这对单人环境够用，但这个插件是公开装的：**每个用户都得先去微信机器人插件里把
+账号 id 和收件人 id 抄一遍**，抄错就静默失败（跨机器人投递在 iLink 侧是「已受理但
+对方收不到」）。而这两个值本来就在微信机器人插件的 `config.json` 里，且**当前会话是
+谁发起的**这件事，会话本身就知道。
+
+### 现在怎么做
+
+新增会话推断：从最近的 `user/message` 里解析 IM 层注入的
+`<dsh_im_source>{"senderId":"…"}</dsh_im_source>`，用 senderId 去 match 账号表的
+`ownerUserId`，反查出该用哪个机器人、回给谁。
+
+取值优先级（高 → 低）：
+
+| 层 | 账号 | 收件人 |
+|---|---|---|
+| ① 工具参数 | `botId` | `toUserId` |
+| ② 当前会话推断 | 匹配到的机器人 | 该 senderId |
+| ③ config.json | `botId` | `toUserId` |
+| ④ 兜底 | 第一个账号 | 该账号 `ownerUserId` |
+
+`config.json` 从「必填」降级为「非 IM 会话时的默认值」——对话框、CLI、定时任务
+这些没有 IM 来源的会话，仍然按它发。
+
+### 实测
+
+用真实会话事件验证（妻子账号的会话）：
+
+- 会话推断 → `{botId: wx_97dda581…, toUserId: o9cq8008sm…}` ✅
+- 无参数无配置 → 跟随会话 ✅
+- 配置指向 A、会话是 B → **按会话走 B** ✅
+- 显式传参 → 压过一切 ✅
+- 非 IM 会话 / 账号表查无此人 → 返回 null，正常回落到配置 ✅
+
+## [0.16.9] — 2026-11-11
+
+**`send_file_to_im` 支持指定用哪个微信机器人发送** —— 修掉「在 A 账号的会话里发文件，永远从第一个账号发出」的问题。
+
+### 新增
+
+- 工具参数 `botId`：显式指定用哪个微信机器人账号发送文件。
+  省略时仍按 config.json 的 `botId` → 首个账号的顺序回落，行为与旧版一致。
+- 为什么必须有它：跨机器人投递在 iLink 侧是静默失败的——用 A 机器人的 token 给 B 机器人
+  的用户发文件，接口会回「受理」，但对方永远收不到（各 bot 的用户 id 体系互相不认）。
+  之前实现里 `account = accountStore.list()[0]`，与当前会话所属账号无关，于是
+  「在谁的会话说、就发给谁」这个直觉落空了。
+
+### 用法
+
+```js
+send_file_to_im({ path: '/绝对/路径.xlsx', botId: 'wx_97dda58120f44f44ffa50e8e' })
+// 收件人省略时会自动用该账号的 ownerUserId，即「发给这个机器人绑定的人」
+```
+
+## [0.16.8] — 2026-11-11
+
+**桌面端的重启按钮不再骗人** —— 原先在 DSH Desktop 里它显示为可点，一点就报「重启失败：untrusted」。
+
+### 修复
+
+- **根因**：桌面窗口跑在 `dsh-app://app`，请求由 Electron 主进程的 `forwardWebRequest` 转发给宿主，
+  而它转发前会删掉 `origin` / `host` / `cookie` / `sec-fetch-site`。重启闸 `trustedRestartRequest`
+  要求 `Origin` 存在且与 `Host` 同源，于是桌面端恒为 false；而状态接口走的是松一档的
+  `trustedLocalRequest`（放行无 Origin），按钮因此显示成"可点" —— 两者不一致，成了
+  「看起来能用、一点就 403」。
+- 新增 `detectedDesktopHost()`（判据 `DSH_CLIENT_VERSION`，Electron 主进程只发给桌面端宿主；
+  刻意不吃 `ELECTRON_RUN_AS_NODE` —— 那是「Electron 当 Node 用」的通用标记，会误伤别的 Electron 应用）：
+  桌面端 `/restart/status` 返回 `allowed: false, reason: 'desktop'`，按钮置灰并提示
+  「桌面端宿主由 DeepSeek Harness App 管理：退出 App 后重新打开即可」；`POST /restart` 补上同一档 403，
+  且**排在来源闸之前**，免得用户继续看到没头没尾的 untrusted。
+- 与上游 dshmarket 口径一致：它在桌面端把重启标成 `supported: false` / `managedBy: 'desktop-host'`。
+  桌面端也确实不该自己重启 —— 宿主一退出，Electron 主进程立刻 `fail("dsh desktop host stopped")`
+  进 fatal 恢复；插件另起的替代进程还拿不到主进程持有的 hostCookie（窗口会 401）。
+- 冒烟：新增 4 条桌面端断言（含「只认 `DSH_CLIENT_VERSION`」与「非桌面端的无 Origin 请求仍被来源闸拒掉」
+  两条边界，后者保证这一档没把来源闸整体顶掉），host-smoke 114 → 118 项；`docs/DEVELOPMENT.md`
+  自检表的项数同步。
+
+### 备注
+
+- **桌面端其余功能不受影响**：`/config`、`/send-file`、`/restart/status` 走的都是放行无 Origin 的那道闸，
+  一直是正常的；桌面端只有「重启」这一项走不通。
+- 桌面端要重启宿主，用 App 自己的方式：退出 App 后重新打开（开发模式下 App 菜单里另有
+  「重启应用与 Host」，正式版没有这一项）。
+
 ## [0.16.7] — 未发布
 
 **README 精简** —— 357 行 → 55 行。

package/docs/DEVELOPMENT.md

@@ -53,7 +53,7 @@ npm run build     # tools/build-client.mjs → lib/client.js（esbuild）
 | --- | --- | --- |
 | `npm run typecheck` | `tsc -p tsconfig.json`：只检查标了 `// @ts-check` 的自研 Host 文件（`lib/schedule*.js`），不碰构建产物 | 见下 |
 | `npm run smoke` | 模拟 `__ModuleLoader__` + 假 React/DOM 跑客户端逻辑：打标、未读判定、cron 模型往返、样式表结构、布局度量、remote 方法集合、提示音、界面外观覆盖规则、设置卡片分组与投递加固两项的呈现、apply 分阶段降级 | 81 项 |
-| `npm run host-smoke` | host 侧纯函数与真实引擎：图片嗅探、投递方式、错误翻译、投递加固（口令 / 目录白名单）、重启安全闸、平台适配 spawn、文案表、来源闸，以及用真实调度引擎跑的定时任务用例（执行窗口并发变更、迁移诊断自动合并 / 仍搁浅、合并幂等性 = 删任务后提示消失 / migration 字段穿过 persist、损坏文件留存、改名迁移与幂等） | 114 项 |
+| `npm run host-smoke` | host 侧纯函数与真实引擎：图片嗅探、投递方式、错误翻译、投递加固（口令 / 目录白名单）、重启安全闸、平台适配 spawn、文案表、来源闸，以及用真实调度引擎跑的定时任务用例（执行窗口并发变更、迁移诊断自动合并 / 仍搁浅、合并幂等性 = 删任务后提示消失 / migration 字段穿过 persist、损坏文件留存、改名迁移与幂等） | 118 项 |
 | `npm run render-smoke` | 客户端组件真实渲染断言（配置卡片、定时任务面板、界面外观组、标题栏刷新按钮） | 10 项 |
 | `npm run preview` | 把呼吸灯样式抽成预览页，调动画参数用 | — |
 | `npm run verify` | `typecheck` + `build` + 上面三个冒烟 | — |

package/lib/client.js

@@ -23481,6 +23481,8 @@ function restartDisabledTitle(reason) {
       return "\u5BBF\u4E3B\u6B63\u88AB\u8C03\u8BD5\u5668\u9644\u7740\uFF0C\u4E0D\u80FD\u91CD\u542F";
     case "supervisor":
       return "\u5BBF\u4E3B\u7531 systemd \u7B49\u76D1\u7763\u5668\u7BA1\u7406\uFF0C\u91CD\u542F\u529F\u80FD\u5DF2\u7981\u7528";
+    case "desktop":
+      return "\u684C\u9762\u7AEF\u5BBF\u4E3B\u7531 DeepSeek Harness App \u7BA1\u7406\uFF1A\u9000\u51FA App \u540E\u91CD\u65B0\u6253\u5F00\u5373\u53EF";
     case "untrusted":
       return "\u8BF7\u6C42\u6765\u6E90\u4E0D\u662F\u540C\u6E90\u73AF\u56DE";
     default:

package/lib/index.js

@@ -33,6 +33,7 @@ import {
 import { IMAGE_EXTENSIONS, sniffImageKind } from '../src/host/image-sniff.js';
 import {
   detectedDebugger,
+  detectedDesktopHost,
   detectedSupervisor,
   scheduleRestart,
   servingPort,
@@ -713,8 +714,13 @@ async function handleRestartStatusRequest(request, response) {
   const restartEnabled = settings.restartEnabled !== false;
   const supervisor = detectedSupervisor();
   const debuggerAttached = detectedDebugger();
+  const desktopHost = detectedDesktopHost();
   let reason = null;
+  // 桌面端排在 debugger / supervisor 之前：它是"这一档从根本上不该点"，
+  // 而调试器/监督器是"这台机器上的偶然状态"。桌面端打开宿主调试端口时两者会同时命中，
+  // 那时该告诉用户的是前者。
   if (!restartEnabled) reason = 'disabled-in-config';
+  else if (desktopHost !== null) reason = 'desktop';
   else if (debuggerAttached !== null) reason = 'debugger';
   else if (supervisor !== null) reason = 'supervisor';
   json(response, 200, {
@@ -722,14 +728,15 @@ async function handleRestartStatusRequest(request, response) {
     reason,
     supervisor,
     debugger: debuggerAttached,
+    desktopHost,
     restartEnabled,
   });
 }
 
 /**
  * POST /api/dsh-helper/restart
- * 过四道闸：restartEnabled / trustedRestartRequest / detectedDebugger / detectedSupervisor
- * 通过则 scheduleRestart(port)，本进程 500ms 后自杀。
+ * 过五道闸：restartEnabled / detectedDesktopHost / trustedRestartRequest /
+ * detectedDebugger / detectedSupervisor，通过则 scheduleRestart(port)，本进程 500ms 后自杀。
  */
 async function handleRestartRequest(request, response) {
   if (request.method !== 'POST') {
@@ -742,6 +749,13 @@ async function handleRestartRequest(request, response) {
       json(response, 403, { error: 'disabled-in-config', reason: 'disabled-in-config' });
       return;
     }
+    // 桌面端必须排在 trustedRestartRequest **之前**：Electron 的 forwardWebRequest 转发时
+    // 会剥掉 Origin，这一档在桌面端永远过不了来源闸，先判桌面端才能给出说得通的理由
+    // （否则用户看到的是没头没尾的 untrusted，而按钮又是亮的）。
+    if (detectedDesktopHost() !== null) {
+      json(response, 403, { error: 'desktop', reason: 'desktop' });
+      return;
+    }
     if (!trustedRestartRequest(request)) {
       json(response, 403, { error: 'untrusted', reason: 'untrusted' });
       return;
@@ -1071,6 +1085,50 @@ export function describeDeliveryFailure(error, { tokenAgeMinutes } = {}) {
   return wrapped;
 }
 
+/**
+ * 从当前会话最近的入站消息里推断「该用哪个机器人、发给谁」。
+ *
+ * 入站消息带一段由 IM 层注入的 `<dsh_im_source>{"senderId":"…"}</dsh_im_source>`，
+ * 其中的 senderId 就是这次对话的主人。拿它去 match 账号表的 ownerUserId，就能反查出
+ * 该用哪个机器人回他——**不需要用户在插件配置里再抄一遍 botId / toUserId**。
+ *
+ * 推断失败（不是 IM 会话、或账号表里没有这个人）返回 null，调用方按老逻辑回落。
+ */
+function inferImTargetFromSession(session, accounts) {
+  let events;
+  try {
+    events = typeof session?.snapshotEvents === 'function'
+      ? session.snapshotEvents()
+      : session?.events;
+  } catch {
+    return null;
+  }
+  if (!Array.isArray(events) || events.length === 0) return null;
+
+  for (let i = events.length - 1; i >= 0; i -= 1) {
+    const ev = events[i];
+    if (ev?.type !== 'user/message') continue;
+    const content = ev?.data?.content ?? ev?.data?.message?.content;
+    const text = Array.isArray(content)
+      ? content.map((part) => (part?.type === 'text' && typeof part.text === 'string' ? part.text : '')).join('')
+      : '';
+    if (!text || !text.includes('dsh_im_source')) continue;
+
+    const matched = /<dsh_im_source>\s*(\{[\s\S]*?\})\s*<\/dsh_im_source>/.exec(text);
+    if (!matched) continue;
+    let senderId;
+    try {
+      senderId = JSON.parse(matched[1])?.senderId;
+    } catch {
+      continue;
+    }
+    if (typeof senderId !== 'string' || !senderId.trim()) continue;
+    const owner = accounts.find((a) => a?.ownerUserId === senderId.trim());
+    if (owner?.botId) return { botId: owner.botId, toUserId: senderId.trim() };
+  }
+  return null;
+}
+
 /**
  * dsh-im 后端：把文件投递到微信。
  *
@@ -1078,14 +1136,21 @@ export function describeDeliveryFailure(error, { tokenAgeMinutes } = {}) {
  * 文件已由 deliverFile 读完并校验过大小时才进来。
  */
 async function deliverViaDshIm({
-  credentials, settings, absolutePath, bytes, signal, logger,
+  credentials, settings, absolutePath, bytes, signal, logger, session,
 }) {
   const dshImDir = resolveDshImDir(settings.dshImDir);
   const { api, state, config } = await loadWeixinModules(dshImDir);
 
   const dir = weixinDir();
   const accountStore = await new config.WeixinConfigStore(join(dir, 'config.json')).load();
-  const wantedBotId = typeof settings.botId === 'string' ? settings.botId.trim() : '';
+  // 优先级：显式参数 → 当前会话推断 → 配置默认值 → 第一个账号。
+  // 会话推断排在配置之前，是因为「谁在跟我说话」比「设置里填过谁」更精确：
+  // 在有 IM 来源的会话里，默认就该回给那个发消息的人。
+  const inferred = inferImTargetFromSession(session, accountStore.list());
+  const wantedBotId = (typeof settings.explicitBotId === 'string' ? settings.explicitBotId.trim() : '')
+    || inferred?.botId
+    || (typeof settings.botId === 'string' ? settings.botId.trim() : '')
+    || '';
   const account = (wantedBotId ? accountStore.get(wantedBotId) : null) ?? accountStore.list()[0];
 
   if (!account?.botId) {
@@ -1098,7 +1163,9 @@ async function deliverViaDshIm({
     throw new Error('微信机器人凭据缺失，请在「设置 → IM机器人」里移除后重新接入。');
   }
 
-  const toUserId = (typeof settings.toUserId === 'string' && settings.toUserId.trim())
+  const toUserId = (typeof settings.explicitToUserId === 'string' && settings.explicitToUserId.trim())
+    || (inferred && inferred.botId === account.botId ? inferred.toUserId : '')
+    || (typeof settings.toUserId === 'string' && settings.toUserId.trim())
     || account.ownerUserId;
   if (!toUserId) throw new Error('没有可用的收件人（账号里缺少 ownerUserId），请在配置里指定 toUserId。');
 
@@ -1225,7 +1292,7 @@ export function detectDeliveryBackend(settings = {}) {
 
 /** 核心：把文件投递到 IM。后端选好后各自投递，本函数只负责「读文件 + 分派」。 */
 async function deliverFile({
-  credentials, settings, filePath, workspace, signal, logger,
+  credentials, settings, filePath, workspace, signal, logger, session,
 }) {
   // 白名单在这里归一化（一次 realpath），再交给唯一的读文件收口点。
   const { absolutePath, bytes } = await readDeliveryFile(
@@ -1239,7 +1306,7 @@ async function deliverFile({
     });
   }
   return deliverViaDshIm({
-    credentials, settings, absolutePath, bytes, signal, logger,
+    credentials, settings, absolutePath, bytes, signal, logger, session,
   });
 }
 
@@ -1761,6 +1828,13 @@ export function apply(ctx) {
             type: 'string',
             description: '可选：收件人 id。省略时用配置里的默认收件人，再退回该账号绑定的用户。',
           },
+          botId: {
+            type: 'string',
+            description: '可选：用哪个微信机器人账号发送（如 wx_97dda58120f44f44ffa50e8e）。'
+              + '省略时用 config.json 里的 botId，再退回第一个账号。'
+              + '**要投递给另一个微信绑定（另一个机器人账号的用户）时必须指定**——'
+              + '否则会从第一个机器人发出，跨机器人投递会被平台静默丢弃。',
+          },
         },
         required: ['path'],
       },
@@ -1787,20 +1861,21 @@ export function apply(ctx) {
             + '在「插件列表 → 辅助补丁」的设置卡片里打开「允许把文件投递到 IM」即可恢复。');
         }
 
-        const requested = typeof args?.toUserId === 'string' && args.toUserId.trim()
-          ? args.toUserId.trim()
-          : settings.toUserId;
+        // 显式参数单独带下去：它必须压过「会话推断」和「配置默认值」。
+        const explicitToUserId = typeof args?.toUserId === 'string' ? args.toUserId.trim() : '';
+        const explicitBotId = typeof args?.botId === 'string' ? args.botId.trim() : '';
 
         const workspace = exec?.agent?.session?.header?.cwd;
         return deliverFile({
           credentials: imCtx.credentials,
           // 后端目录（dshImDir / imConnectDir）已经随 ...settings 展开（来自 config.json），
           // 不需要再从 apply 的第二参数里拼一次——那个参数以前根本没被 DSH 传进来。
-          settings: { ...settings, toUserId: requested },
+          settings: { ...settings, explicitToUserId, explicitBotId },
           filePath: args?.path,
           workspace: typeof workspace === 'string' && workspace ? workspace : undefined,
           signal: exec?.signal,
           logger: imCtx.logger,
+          session: exec?.agent?.session,
         });
       },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-helper",
-  "version": "0.16.7",
+  "version": "0.17.1",
   "type": "module",
   "description": "给 DeepSeek Harness 打补丁：在任意会话把文件主动投递到 IM（微信）、按 cron 跑定时任务、工作区活动呼吸灯（含折叠未读提示）、会话标题栏活跃指示、对话完成提示音，另有一键重启按钮。",
   "icon": "icon.svg",

package/src/host/restart.js

@@ -7,10 +7,13 @@
  *   - scheduleRestart 不接受 recovery 参数（不写 .recovery.json）
  *   - restartHelperSource 不带 recovery 移交分支
  *   - 删除 recoveryScriptPath（依赖 lib/recovery.js 产物，本插件无产物）
+ *   - 新增 detectedDesktopHost：dshmarket 靠配置里的 desktopHost 标记达成同一件事，
+ *     本插件没有那份配置，改成从宿主环境自己认
  *
  * 安全闸逻辑一行不漏照搬：
  *   - supervisor: INVOCATION_ID||JOURNAL_STREAM 且 (ppid===1 || comm==='systemd')
  *   - debugger:   inspector.url() || execArgv/NODE_OPTIONS 按 token 前缀匹配
+ *   - desktop:    DSH_CLIENT_VERSION 非空（Electron 主进程只发给桌面端宿主）
  *   - 请求来源:   trustedRestartRequest（独立文件）
  */
 
@@ -81,6 +84,35 @@ export function detectedSupervisor(
   return null;
 }
 
+/**
+ * 桌面端宿主检测（DSH Desktop）。
+ *
+ * 判据取 `DSH_CLIENT_VERSION`：Electron 主进程在 spawn 宿主进程时注入它
+ * （app.asar/lib/main.js 里构造 DesktopHostProcess 的那处 env），`dsh web`、
+ * 内置 CLI、headless 都不会有。比 `ELECTRON_RUN_AS_NODE` 精确 —— 后者是所有
+ * "把 Electron 当 Node 用"的通用标记，别的 Electron 应用里跑 dsh 也会命中。
+ *
+ * 为什么桌面端要单独判一档（2026-10-06 实测定案）：桌面窗口跑在 `dsh-app://app`，
+ * 请求由 Electron 主进程的 forwardWebRequest 转发给宿主，而它**转发前会删掉
+ * origin / host / cookie / sec-fetch-site**。于是重启闸（trustedRestartRequest
+ * 要求 Origin 存在且与 Host 同源）在桌面端恒为 false，用户点按钮只会拿到
+ * `403 untrusted`；而 status 走的是松一档的 trustedLocalRequest（放行无 Origin），
+ * 按钮反倒显示成"可点"——两者不一致，就成了"看起来能用、一点就报错"。
+ * 上游 dshmarket 在 routes.ts 里把桌面端的 restart 直接标成
+ * `supported: false` / `managedBy: 'desktop-host'`，本插件补上同一档。
+ *
+ * 桌面端也确实不该自己重启：宿主一退出，Electron 主进程立刻
+ * `fail("dsh desktop host stopped")` 进 fatal 恢复；插件另起的替代进程还拿不到
+ * 主进程持有的 hostCookie（窗口会 401）。正确做法是让用户从 App 侧退出后重开。
+ *
+ * @returns {'desktop' | null}
+ */
+export function detectedDesktopHost(env = process.env) {
+  const version = env.DSH_CLIENT_VERSION;
+  if (typeof version !== 'string' || version.trim() === '') return null;
+  return 'desktop';
+}
+
 /**
  * 检测器附着检测。按以下优先级：
  *   1. inspector.url() 已设置（覆盖 --inspect 启动 / inspector.open() / SIGUSR1 attach）