dsh-helper 0.16.8 → 0.17.1

package/CHANGELOG.md

@@ -8,7 +8,86 @@
 > （`package-lock.json` 根节点跟齐）与本文件顶部段落，两者连同提交一起走；发布只补 annotated tag，
 > 不再用 `npm version` 升版。
 
-## [0.16.8] — 未发布
+## [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」。
 

package/lib/index.js

@@ -1085,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 后端：把文件投递到微信。
  *
@@ -1092,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) {
@@ -1112,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。');
 
@@ -1239,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(
@@ -1253,7 +1306,7 @@ async function deliverFile({
     });
   }
   return deliverViaDshIm({
-    credentials, settings, absolutePath, bytes, signal, logger,
+    credentials, settings, absolutePath, bytes, signal, logger, session,
   });
 }
 
@@ -1775,6 +1828,13 @@ export function apply(ctx) {
             type: 'string',
             description: '可选：收件人 id。省略时用配置里的默认收件人，再退回该账号绑定的用户。',
           },
+          botId: {
+            type: 'string',
+            description: '可选：用哪个微信机器人账号发送（如 wx_97dda58120f44f44ffa50e8e）。'
+              + '省略时用 config.json 里的 botId，再退回第一个账号。'
+              + '**要投递给另一个微信绑定（另一个机器人账号的用户）时必须指定**——'
+              + '否则会从第一个机器人发出，跨机器人投递会被平台静默丢弃。',
+          },
         },
         required: ['path'],
       },
@@ -1801,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.8",
+  "version": "0.17.1",
   "type": "module",
   "description": "给 DeepSeek Harness 打补丁：在任意会话把文件主动投递到 IM（微信）、按 cron 跑定时任务、工作区活动呼吸灯（含折叠未读提示）、会话标题栏活跃指示、对话完成提示音，另有一键重启按钮。",
   "icon": "icon.svg",