dsh-remote-wecom 0.1.1 → 0.1.3

package/README.md

@@ -1,11 +1,20 @@
 # dsh-remote-wecom
 
 [![npm](https://img.shields.io/npm/v/dsh-remote-wecom)](https://www.npmjs.com/package/dsh-remote-wecom)
+[![license](https://img.shields.io/npm/l/dsh-remote-wecom)](LICENSE)
 
-> Control DeepSeek Harness Desktop sessions from WeCom (企业微信) on your phone. Docs and commands are in Chinese.
+> Control DeepSeek Harness Desktop sessions from WeCom (企业微信) on your phone: send prompts, get results and files back, approve tool calls, switch sessions and models. Docs and commands are in Chinese.
 
 在手机企业微信里遥控 DeepSeek Harness Desktop：发消息、收结果、切会话和模型、审批与回答提问、取回产物。插件跑在 Desktop 里，自己持有企微智能机器人的长连接。
 
+![手机企业微信里切换会话、审批、插话、收结果和文件、切换模型](docs/images/chat.png)
+
+- 任务跑完自动推结果，生成的文件一并发到手机
+- 审批和提问同时发到手机和 Desktop，哪边先答用哪边
+- 运行中可以插话、停止，也能设长期目标让它自己续跑
+- 引用某条推送回复，消息就发回那个会话，多个任务并行不串
+- Desktop 没开也能发：消息先暂存，后台拉起 Desktop 后自动处理（macOS）
+
 ## 要求
 
 - DeepSeek Harness Desktop（DSH `>=0.2.0-rc.2`）
@@ -21,7 +30,7 @@ Desktop 运行时会锁住 `desktop` profile，`dsh plugin add` 用不了，需
 
    ```json
    {
-     "dependencies": { "dsh-remote-wecom": "^0.1.0" },
+     "dependencies": { "dsh-remote-wecom": "^0.1.2" },
      "dsh": { "profile": { "bundles": ["…", "dsh-remote-wecom"] } }
    }
    ```
@@ -36,15 +45,26 @@ Desktop 运行时会锁住 `desktop` profile，`dsh plugin add` 用不了，需
 
 升级时改版本号，再重复第 3 步。
 
+也可以把下面这段发给 Agent（Claude Code、Cursor、pi 等）代装：
+
+```text
+按 https://github.com/lukeinx/dsh-remote-wecom 的 README 给我的 DeepSeek Harness Desktop 安装 dsh-remote-wecom，
+遵守「让 Agent 代装」一节的规则；装好后提醒我到「设置 → 企微远程」扫码绑定。
+```
+
 ## 绑定
 
 打开 Desktop「设置 → 企微远程」：
 
+<img src="docs/images/settings.png" alt="Desktop 设置页「企微远程」" width="560">
+
 1. 用企业微信扫码，自动创建机器人并连接。
 2. 10 分钟内给机器人发一条单聊消息，发送人即成为主人；过了窗口就发页面上的 6 位绑定码。之后只接主人的单聊。
 
 同一页可以换机器人、解绑、选新会话位置、设置手机审批超时。扫不了码时可以手动填 BotID / Secret。
 
+打开「桌面端退出后仍可拉起」（macOS）：Desktop 没开时，手机发来的消息先暂存，并在后台启动 Desktop，启动后自动处理。移除插件前先关掉它。
+
 ## 手机上用
 
 选中会话后直接发消息；引用某条推送回复，消息会发给该推送所属的会话。图片和文件可以先发，5 分钟内再补说明。任务完成后自动推送结果；审批和提问同时出现在手机和 Desktop，谁先答用谁的。
@@ -67,28 +87,21 @@ Desktop 运行时会锁住 `desktop` profile，`dsh plugin add` 用不了，需
 
 中文命令和参数之间要有空格：`模型 high` 是命令，`模型high` 会当普通消息发出。
 
-## 离线看门狗（可选，macOS）
+## 命令行
 
-插件随 Desktop 启停，Desktop 退出后就没人接企微了。看门狗是一个独立的 launchd 进程：发现插件不在线时暂存消息、在后台拉起 Desktop，插件上线后自动处理。
+设置页之外的备用入口：
 
 ```sh
 alias dsh-remote-wecom='node ~/.dsh/profiles/desktop/node_modules/dsh-remote-wecom/bin/dsh-remote.mjs'
-dsh-remote-wecom watchdog install     # 升级插件或换 Node 后要重新执行
-dsh-remote-wecom watchdog status
-dsh-remote-wecom watchdog uninstall
 ```
 
-## 命令行
-
-设置页之外的备用入口（`dsh-remote-wecom` 即上面的 alias）：
-
 | 命令 | 作用 |
 |---|---|
 | `setup [--bot-id ID --secret S]` | 写入机器人凭证并生成绑定码 |
 | `bind` | 解除当前主人，生成新绑定码 |
 | `status` | 查看配置、绑定状态和最近日志 |
 | `alias [名称 目录 \| rm 名称]` | 管理目录别名，供「创建会话」「工作区」使用 |
-| `watchdog install\|uninstall\|status` | 离线看门狗 |
+| `watchdog install\|uninstall\|status` | 「桌面端退出后仍可拉起」的开关与状态 |
 
 数据在 `~/.dsh/integrations/dsh-remote-wecom/`，`config.json` 权限为 600。可选配置和实现细节见 [docs/DESIGN.md](docs/DESIGN.md)。
 

package/bin/dsh-remote.mjs

@@ -7,8 +7,8 @@ import {parseArgs} from 'node:util';
 import {BIND_FILE, BIND_TTL_MS, CONFIG_FILE, VERSION, applyCredentials, defaultDataDir, hasCredentials, loadConfig, readUserConfig, resetOwner} from '../lib/core/config.mjs';
 import {checkName, expandDir, loadAliases, missingDirs, saveAliases, tildeDir} from '../lib/core/aliases.mjs';
 import {execFileSync} from 'node:child_process';
-import {fileURLToPath} from 'node:url';
-import {createWatchdog, heartbeatAge, heartbeatFresh, spoolCount, watchdogState} from '../lib/core/watchdog.mjs';
+import {DESKTOP_BUNDLE_ID, createWatchdog, heartbeatAge, heartbeatFresh, spoolCount, watchdogState} from '../lib/core/watchdog.mjs';
+import {createLaunchd, launchdSupported} from '../lib/core/launchd.mjs';
 
 const USAGE = `dsh-remote-wecom ${VERSION}
 
@@ -103,13 +103,9 @@ function alias(dir, args) {
   console.log(rows.length ? rows.map(([n, d]) => `${n} → ${d}${missing.has(n) ? '（目录不存在）' : ''}`).join('\n') : '还没有目录别名。');
 }
 
-const WATCHDOG_LABEL = 'com.dsh-remote-wecom.watchdog';
 const WATCHDOG_TICK_MS = 2000;
 const WATCHDOG_LOG = 'watchdog.log';
 const WATCHDOG_LOG_MAX = 1024 * 1024;
-const plistFile = () => path.join(process.env.HOME, 'Library', 'LaunchAgents', `${WATCHDOG_LABEL}.plist`);
-const domain = () => `gui/${process.getuid()}`;
-const xml = s => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
 
 function watchdogRun(dir) {
   const file = path.join(dir, WATCHDOG_LOG);
@@ -129,55 +125,29 @@ function watchdogRun(dir) {
   process.on('SIGINT', quit);
 }
 
+// 看门狗进程用的也是 Desktop 的可执行文件，按进程名判断会误报；只认登记到 LaunchServices 的 App。
 function desktopRunning() {
-  try { execFileSync('pgrep', ['-x', 'DeepSeek Harness'], {stdio: 'ignore'}); return true; } catch { return false; }
+  try { return execFileSync('lsappinfo', ['find', `bundleid=${DESKTOP_BUNDLE_ID}`], {encoding: 'utf8'}).trim() !== ''; } catch { return false; }
 }
 
 function watchdogInstall(dir, force) {
   // 旧版插件不写心跳：此时装上看门狗会把正在运行的插件踢下线。
   if (!force && desktopRunning() && !heartbeatFresh(dir))
     throw new Error('DSH Desktop 正在运行，但插件没有心跳（可能是旧版本插件或插件未启用）。请先重启 Desktop 加载新版插件再安装；确认无误可加 --force。');
-  const args = [process.execPath, fileURLToPath(import.meta.url), 'watchdog', 'run', '--dir', dir];
-  const env = {PATH: '/usr/bin:/bin:/usr/sbin:/sbin', ...(process.env.DSH_HOME ? {DSH_HOME: process.env.DSH_HOME} : {})};
-  const plist = `<?xml version="1.0" encoding="UTF-8"?>
-<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
-<plist version="1.0">
-<dict>
-  <key>Label</key><string>${WATCHDOG_LABEL}</string>
-  <key>ProgramArguments</key>
-  <array>
-${args.map(a => `    <string>${xml(a)}</string>`).join('\n')}
-  </array>
-  <key>EnvironmentVariables</key>
-  <dict>
-${Object.entries(env).map(([k, v]) => `    <key>${k}</key><string>${xml(v)}</string>`).join('\n')}
-  </dict>
-  <key>RunAtLoad</key><true/>
-  <key>KeepAlive</key><true/>
-  <key>ProcessType</key><string>Background</string>
-  <key>StandardErrorPath</key><string>${xml(path.join(dir, 'watchdog.err'))}</string>
-</dict>
-</plist>
-`;
-  fs.mkdirSync(path.dirname(plistFile()), {recursive: true});
-  fs.mkdirSync(dir, {recursive: true, mode: 0o700});
-  try { execFileSync('launchctl', ['bootout', `${domain()}/${WATCHDOG_LABEL}`], {stdio: 'ignore'}); } catch {}
-  fs.writeFileSync(plistFile(), plist);
-  execFileSync('launchctl', ['bootstrap', domain(), plistFile()]);
-  console.log(`看门狗已安装并启动：${plistFile()}`);
-  console.log(`Node：${process.execPath}（升级或切换 Node 后请重新执行 watchdog install）`);
+  const launchd = createLaunchd({dir});
+  launchd.install();
+  console.log(`看门狗已安装并启动：${launchd.file}`);
+  console.log('也可以在 Desktop「设置 → 企微远程」里开关。');
 }
 
-function watchdogUninstall() {
-  try { execFileSync('launchctl', ['bootout', `${domain()}/${WATCHDOG_LABEL}`], {stdio: 'ignore'}); } catch {}
-  fs.rmSync(plistFile(), {force: true});
+function watchdogUninstall(dir) {
+  createLaunchd({dir}).uninstall();
   console.log('看门狗已卸载。');
 }
 
 function watchdogStatus(dir) {
-  let loaded = false;
-  try { execFileSync('launchctl', ['print', `${domain()}/${WATCHDOG_LABEL}`], {stdio: 'ignore'}); loaded = true; } catch {}
-  console.log(`看门狗：${loaded ? '已安装并运行' : fs.existsSync(plistFile()) ? '已安装但未加载' : '未安装'}`);
+  const launchd = createLaunchd({dir});
+  console.log(`看门狗：${launchd.loaded() ? '已安装并运行' : fs.existsSync(launchd.file) ? '已安装但未加载' : '未安装'}`);
   const age = heartbeatAge(dir);
   console.log(`插件心跳：${Number.isFinite(age) ? `${Math.round(age / 1000)} 秒前` : '无'}`);
   const wd = watchdogState(dir);
@@ -190,10 +160,10 @@ function watchdogStatus(dir) {
 }
 
 function watchdog(dir, [sub = 'status'], force) {
-  if (process.platform !== 'darwin' && sub !== 'run') throw new Error('看门狗仅支持 macOS（launchd）');
+  if (!launchdSupported() && sub !== 'run') throw new Error('看门狗仅支持 macOS（launchd）');
   if (sub === 'run') watchdogRun(dir);
   else if (sub === 'install') watchdogInstall(dir, force);
-  else if (sub === 'uninstall') watchdogUninstall();
+  else if (sub === 'uninstall') watchdogUninstall(dir);
   else if (sub === 'status') watchdogStatus(dir);
   else throw new Error('用法：dsh-remote-wecom watchdog install|uninstall|status');
 }

package/dist/client.js

@@ -174,7 +174,8 @@ var zh = {
   "row.owner": "\u7ED1\u5B9A\u8D26\u53F7",
   "row.place": "\u65B0\u4F1A\u8BDD\u4F4D\u7F6E",
   "row.confirm": "\u624B\u673A\u5BA1\u6279",
-  "row.openDesktop": "\u65B0\u5EFA\u4F1A\u8BDD\u65F6\u6253\u5F00 Desktop",
+  "row.openDesktop": "\u65B0\u5EFA\u4F1A\u8BDD\u65F6\u6253\u5F00\u684C\u9762\u7AEF",
+  "row.watchdog": "\u684C\u9762\u7AEF\u9000\u51FA\u540E\u4ECD\u53EF\u62C9\u8D77",
   "bot.rescan": "\u66F4\u6362",
   "bot.rescanConfirm": "\u5C06\u66FF\u6362\u5F53\u524D\u673A\u5668\u4EBA",
   "owner.unbind": "\u89E3\u7ED1",
@@ -220,6 +221,7 @@ var en = {
   "row.place": "New sessions in",
   "row.confirm": "Phone approvals",
   "row.openDesktop": "Open Desktop for new sessions",
+  "row.watchdog": "Stay reachable after Desktop quits",
   "bot.rescan": "Change",
   "bot.rescanConfirm": "Replaces the current bot",
   "owner.unbind": "Unlink",
@@ -432,7 +434,15 @@ function Configured({ s, now, act, busy, errors, setError, t }) {
       disabled: busy.open,
       onChange: (v) => act("open", "setPrefs", { openDesktop: v })
     }
-  ))), /* @__PURE__ */ h("div", { className: "drw-foot" }, /* @__PURE__ */ h(Button, { variant: "outline", disabled: busy.restart, onClick: () => act("restart", "restart") }, busy.restart ? t("restarting") : t("restart")), errors.restart ? /* @__PURE__ */ h("span", { className: "drw-error", role: "alert" }, errors.restart) : null));
+  )), s.watchdog ? /* @__PURE__ */ h(Row, { label: t("row.watchdog"), error: errors.watchdog }, /* @__PURE__ */ h(
+    Switch,
+    {
+      checked: s.watchdog.enabled,
+      label: t("row.watchdog"),
+      disabled: busy.watchdog,
+      onChange: (v) => act("watchdog", "setWatchdog", { enabled: v })
+    }
+  )) : null), /* @__PURE__ */ h("div", { className: "drw-foot" }, /* @__PURE__ */ h(Button, { variant: "outline", disabled: busy.restart, onClick: () => act("restart", "restart") }, busy.restart ? t("restarting") : t("restart")), errors.restart ? /* @__PURE__ */ h("span", { className: "drw-error", role: "alert" }, errors.restart) : null));
 }
 function Settings({ call, t }) {
   const [s, setS] = useState(null);

package/docs/DESIGN.md

@@ -55,7 +55,7 @@ DeepSeek Harness.app ── host 进程
 
 事件（`ctx.on(name, fn, { global: true })`）：
 
-- `session/event (session, event)`：`turn/start{turn}`、`user/message{source.kind, source.rpcId}`（`source.kind` 除 `user` 外还有注入类 `runtime-context` / `skill-catalog` / `time-context`，以及宿主唤起的 `schedule` / `goal`）、`assistant/message{message.content[]}`、`tool/call{name, arguments}`、`tool/result{message.isError, meta.path}`、`turn/end{reason.kind: completed|aborted|error|max-tokens, reason.error.message}`、`session/title{title, source}`、`model/selection{provider, model, reasoningEffort}`（只在切模型时发）、`request/header{header.config{provider, model, reasoningEffort}}`（每次 LLM 请求，新会话首轮靠它拿模型，此时 `modelSelection` 投影还是空的）。`user/message` 的 data 就是消息本身（`data.source`、`data.content`），混有 runtime-context 等系统注入消息，只认 `source.kind === 'user'`。一轮的顺序：`agent/inbox/spliced` → `api-session/status [sid, true]` → `turn/start` → `user/message` → … → `turn/end`。标题先来一条 `source.kind:'fallback'`（首条消息截断），模型起的标题随后再来一条。
+- `session/event (session, event)`：`turn/start{turn}`、`user/message{source.kind, source.rpcId}`（`source.kind` 除 `user` 外还有注入类 `runtime-context` / `skill-catalog` / `time-context`，以及宿主唤起的 `schedule` / `goal`）、`assistant/message{message.content[]}`、`tool/call{name, arguments}`、`tool/result{message.isError, meta.path}`、`turn/end{reason.kind: completed|aborted|error|max-tokens, reason.error.message}`、`session/title{title, source}`、`model/selection{provider, model, reasoningEffort}`（只在切模型时发）、`request/header{header.config{provider, model, reasoningEffort}}`（每次 LLM 请求，新会话首轮靠它拿模型，此时 `modelSelection` 投影还是空的；还没发首条时按 `modelCatalog.default` 显示）。`user/message` 的 data 就是消息本身（`data.source`、`data.content`），混有 runtime-context 等系统注入消息，只认 `source.kind === 'user'`。一轮的顺序：`agent/inbox/spliced` → `api-session/status [sid, true]` → `turn/start` → `user/message` → … → `turn/end`。标题先来一条 `source.kind:'fallback'`（首条消息截断），模型起的标题随后再来一条。
 - `api-session/added (summary)`、`api-session/removed (sessionId)`、`api-session/status (sessionId, running)`。
 - `approval/request (req, next)`，注册时加 `prepend: true`：`req.{toolName, callId, reason, displayReason.zh, agent, signal}`，返回 `'allowed-once' | 'rejected' | 'cancelled' | 'unavailable'`。会话 id 取 `req.agent.session.id ?? req.agent.id`。
 - `user-questions/request (req, next)`：`req.questions[{id, question, header, options[{label, description}], multiSelect}]`，返回 `{answers:[{id, selected:[label], custom?}]}`。
@@ -144,7 +144,10 @@ DeepSeek Harness.app ── host 进程
 
 ## Desktop 离线看门狗
 
-插件随 Desktop 启停，macOS 上 Cmd+Q 后企微无人接。`dsh-remote-wecom watchdog install` 装一个 launchd LaunchAgent（`KeepAlive`）跑 `watchdog run`，每 2 秒 tick 一次（`lib/core/watchdog.mjs`）。
+插件随 Desktop 启停，macOS 上 Cmd+Q 后企微无人接。设置页「桌面端退出后仍可拉起」（`setWatchdog`）或 `dsh-remote-wecom watchdog install` 装一个 launchd LaunchAgent（`KeepAlive`）跑 `watchdog run`，每 2 秒 tick 一次（`lib/core/watchdog.mjs`）。
+
+- 登记在 `lib/core/launchd.mjs`。可执行文件优先用 Desktop 自带的 Electron（`ELECTRON_RUN_AS_NODE=1`，与 dsh 命令行相同），不依赖用户的 Node。这样的进程不向 LaunchServices 登记，`open -b` 照常拉起 Desktop；但进程名同为 `DeepSeek Harness`，判断 Desktop 是否在运行要用 `lsappinfo find bundleid=...`，不能用 `pgrep`。
+- 插件启动时 `sync()`：登记指向本数据目录且内容与当前插件路径不一致（pnpm 升级后路径会变）或未加载时重装；指向其他数据目录的登记（如测试）不动。插件配置 `watchdog: false` 隐藏开关，`watchdogDryRun: true`（预览、e2e）把 plist 写进数据目录且不调 launchctl。
 
 - 交接靠心跳：插件 `apply` 时先写 `alive.json`（先于连企微），此后每 10 秒刷新，插件停止且遥控实例收尾后删除（只删自己 pid 写的）。心跳 30 秒内新鲜时看门狗不连、已连则断开；未配置或未绑定主人也不连。配置重载只重建遥控实例，心跳不断。
 - 企微服务端在新连接建立时向旧连接发 `disconnected_event` 并断开，SDK 不重连被踢的一方。插件上线时挤掉看门狗是预期路径；看门狗被其他连接踢掉时退避 5 分钟，避免与重复部署互踢。反向竞争（看门狗刚好在插件连上后才连，把插件踢掉）：传输层记 `kickedAt`，看门狗下一个 tick 看到心跳会断开并把 `watchdog.json` 写成 `connected:false`，插件心跳 tick 发现「被踢之后看门狗已让出」就重建遥控实例。

package/lib/core/launchd.mjs

@@ -0,0 +1,98 @@
+// 看门狗的 launchd 登记：设置页开关与命令行共用。
+// 优先用 Desktop 自带的 Electron 以 Node 模式运行（dsh 命令行也是这样跑的），不依赖用户自己装的 Node。
+// 这样的进程不向 LaunchServices 登记，`open -b` 仍会正常拉起 Desktop。
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import {execFileSync} from 'node:child_process';
+import {fileURLToPath} from 'node:url';
+
+export const WATCHDOG_LABEL = 'com.dsh-remote-wecom.watchdog';
+export const DESKTOP_EXECUTABLE = '/Applications/DeepSeek Harness.app/Contents/MacOS/DeepSeek Harness';
+const BIN = fileURLToPath(new URL('../../bin/dsh-remote.mjs', import.meta.url));
+const BOOTSTRAP_TRIES = 5;
+
+export const launchdSupported = (platform = process.platform) => platform === 'darwin';
+
+const xml = s => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+const sleep = ms => Atomics.wait(new Int32Array(new SharedArrayBuffer(4)), 0, 0, ms);
+
+function runtime() {
+  if (process.versions.electron) return {execPath: process.execPath, electron: true};
+  if (fs.existsSync(DESKTOP_EXECUTABLE)) return {execPath: DESKTOP_EXECUTABLE, electron: true};
+  return {execPath: process.execPath, electron: false};
+}
+
+export function renderPlist({dir, execPath, electron, bin = BIN, dshHome = process.env.DSH_HOME}) {
+  const args = [execPath, bin, 'watchdog', 'run', '--dir', dir];
+  const env = {
+    PATH: '/usr/bin:/bin:/usr/sbin:/sbin',
+    ...(electron ? {ELECTRON_RUN_AS_NODE: '1'} : {}),
+    ...(dshHome ? {DSH_HOME: dshHome} : {}),
+  };
+  return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key><string>${WATCHDOG_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+${args.map(a => `    <string>${xml(a)}</string>`).join('\n')}
+  </array>
+  <key>EnvironmentVariables</key>
+  <dict>
+${Object.entries(env).map(([k, v]) => `    <key>${k}</key><string>${xml(v)}</string>`).join('\n')}
+  </dict>
+  <key>RunAtLoad</key><true/>
+  <key>KeepAlive</key><true/>
+  <key>ProcessType</key><string>Background</string>
+  <key>StandardErrorPath</key><string>${xml(path.join(dir, 'watchdog.err'))}</string>
+</dict>
+</plist>
+`;
+}
+
+/**
+ * 一台机器只登记一个看门狗：只认指向 dir 的那份，别的数据目录（如测试）不会改写它。
+ * @param {{dir: string, home?: string, uid?: number, run?: (cmd: string, args: string[]) => void, execPath?: string, electron?: boolean, bin?: string}} opts
+ */
+export function createLaunchd({dir, home = os.homedir(), uid = process.getuid?.(), run = null, ...spec}) {
+  const exec = run || ((cmd, args) => execFileSync(cmd, args, {stdio: 'ignore'}));
+  const file = path.join(home, 'Library', 'LaunchAgents', `${WATCHDOG_LABEL}.plist`);
+  const target = `gui/${uid}/${WATCHDOG_LABEL}`;
+  const render = () => renderPlist({dir, ...runtime(), ...spec});
+  const read = () => { try { return fs.readFileSync(file, 'utf8'); } catch { return ''; } };
+  const bootout = () => { try { exec('launchctl', ['bootout', target]); } catch {} };
+  const loaded = () => { try { exec('launchctl', ['print', target]); return true; } catch { return false; } };
+
+  function install() {
+    fs.mkdirSync(path.dirname(file), {recursive: true});
+    fs.mkdirSync(dir, {recursive: true, mode: 0o700});
+    bootout();
+    fs.writeFileSync(file, render());
+    // bootout 是异步卸载，紧接着 bootstrap 可能还在卸载中。
+    for (let i = 1; ; i++) {
+      try { exec('launchctl', ['bootstrap', `gui/${uid}`, file]); return; }
+      catch (e) { if (i >= BOOTSTRAP_TRIES) throw e; sleep(200 * i); }
+    }
+  }
+  return {
+    file,
+    loaded,
+    install,
+    /** 当前登记的是不是这个数据目录的看门狗。 */
+    enabled: () => read().includes(`<string>${xml(dir)}</string>`),
+    uninstall() {
+      bootout();
+      fs.rmSync(file, {force: true});
+    },
+    /** 已开启时把登记对齐到当前插件（升级后安装路径会变）；返回是否改写。 */
+    sync() {
+      const current = read();
+      if (!current.includes(`<string>${xml(dir)}</string>`)) return false;
+      if (current === render() && loaded()) return false;
+      install();
+      return true;
+    },
+  };
+}

package/lib/core/remote.mjs

@@ -665,6 +665,15 @@ export function createRemote({ host, dir, config, log: echo = () => { }, createT
             catch (e) {
                 log(`dsh[${this.key}] projections 失败（沿用上次信息）：${e?.message || e}`);
             }
+            // 新会话跑完首轮前 modelSelection 投影为空，按部署默认模型显示。
+            if (!this.model) {
+                const d = await host.modelCatalog().then((c) => c?.default, () => null);
+                if (d?.model) {
+                    this.model = String(d.model);
+                    this.modelProvider = String(d.provider || "");
+                    this.thinkingLevel = d.reasoningEffort ? String(d.reasoningEffort) : "";
+                }
+            }
         }
         async stats() {
             await this.refreshMeta();

package/lib/core/watchdog.mjs

@@ -76,8 +76,14 @@ export function takeLaunched(dir, now = Date.now()) {
   return Number.isFinite(at) && now - at <= SPOOL_TTL_MS;
 }
 
+/** 看门狗跑在 ELECTRON_RUN_AS_NODE 下；`open` 会把环境传给 Desktop，不去掉它 Desktop 会以 Node 模式启动后立即退出。 */
+export function desktopEnv(env = process.env) {
+  const {ELECTRON_RUN_AS_NODE, ...rest} = env;
+  return rest;
+}
+
 export function launchDesktop() {
-  return new Promise((resolve, reject) => execFile('open', ['-g', '-j', '-b', DESKTOP_BUNDLE_ID], {timeout: 15_000},
+  return new Promise((resolve, reject) => execFile('open', ['-g', '-j', '-b', DESKTOP_BUNDLE_ID], {timeout: 15_000, env: desktopEnv()},
     e => e ? reject(e) : resolve()));
 }
 

package/lib/core/wecom.mjs

@@ -353,6 +353,11 @@ export class WeComTransport {
   async flush() {
     if (!this.connected || this.closed || this.working) return;
     this.working = true;
+    // 回执超时时服务端多半已送达（常见于电脑睡眠），重发只会重复，按已送达处理；明确报错才重试。
+    const deliver = async request => {
+      try { await request(); }
+      catch (e) { if (!/ack timeout/i.test(String(e?.message || ''))) throw e; this.log('企微回执超时，按已送达处理'); }
+    };
     try {
       for (const name of this.queueFiles()) {
         if (!this.connected || this.closed) break;
@@ -363,10 +368,10 @@ export class WeComTransport {
         try {
           for (; packet.cursor < packet.steps.length; packet.cursor++) {
             const step = packet.steps[packet.cursor];
-            if (step.kind === 'text') await this.client.sendMessage(packet.recipient, {msgtype: 'markdown', markdown: {content: step.text}});
+            if (step.kind === 'text') await deliver(() => this.client.sendMessage(packet.recipient, {msgtype: 'markdown', markdown: {content: step.text}}));
             if (step.kind === 'card') {
               try {
-                await this.client.sendMessage(packet.recipient, {msgtype: 'template_card', template_card: step.card});
+                await deliver(() => this.client.sendMessage(packet.recipient, {msgtype: 'template_card', template_card: step.card}));
                 this.rememberCard(step.card);
               }
               catch (e) {
@@ -380,7 +385,7 @@ export class WeComTransport {
             }
             if (step.kind === 'file') {
               const media = await this.client.uploadMedia(fs.readFileSync(step.file), {type: 'file', filename: path.basename(step.file)});
-              await this.client.sendMediaMessage(packet.recipient, 'file', media.media_id);
+              await deliver(() => this.client.sendMediaMessage(packet.recipient, 'file', media.media_id));
             }
             writeJson(file, {...packet, cursor: packet.cursor + 1});
           }

package/lib/host/settings-rpc.mjs

@@ -9,7 +9,7 @@ import path from 'node:path';
 import {tildeDir} from '../core/aliases.mjs';
 
 export const SETTINGS_ENDPOINT = 'dsh-remote-wecom/settings';
-export const SETTINGS_METHODS = ['state', 'qrStart', 'qrCancel', 'saveCredentials', 'newBindCode', 'unbind', 'setPrefs', 'setPlace', 'restart'];
+export const SETTINGS_METHODS = ['state', 'qrStart', 'qrCancel', 'saveCredentials', 'newBindCode', 'unbind', 'setPrefs', 'setPlace', 'setWatchdog', 'restart'];
 // 与遥控实例共用：手机「工作区」命令和设置页写同一个文件，内容 {workspaceId} 或 {cwd}，没有文件 = 未分组。
 export const DEFAULT_PLACE_FILE = '.default-place';
 const UNGROUPED = 'none';
@@ -89,11 +89,12 @@ const RELOAD_WAIT_MS = 2500;
 const QR_READY_WAIT_MS = 3000;
 
 /**
- * getWorkspaces 缺省时（宿主不支持工作区）不显示默认位置。
+ * getWorkspaces 缺省时（宿主不支持工作区）不显示默认位置；watchdog 缺省时（非 macOS）不显示看门狗开关。
  * @param {{dir: string, getRemote: () => any, getBootError: () => string, reload: (why: string, opts?: {notify?: boolean}) => Promise<void>, qr: any,
- *   getWorkspaces?: (() => Promise<{items: {id: string, path: string, title: string}[]}>) | null}} deps
+ *   getWorkspaces?: (() => Promise<{items: {id: string, path: string, title: string}[]}>) | null,
+ *   watchdog?: {enabled: () => boolean, install: () => void, uninstall: () => void} | null}} deps
  */
-export function createSettingsHandler({dir, getRemote, getBootError, reload, qr, getWorkspaces = null}) {
+export function createSettingsHandler({dir, getRemote, getBootError, reload, qr, getWorkspaces = null, watchdog = null}) {
   const settle = p => Promise.race([Promise.resolve(p).catch(() => {}), delay(RELOAD_WAIT_MS)]);
   const placeFile = path.join(dir, DEFAULT_PLACE_FILE);
 
@@ -156,6 +157,7 @@ export function createSettingsHandler({dir, getRemote, getBootError, reload, qr,
         ? {remoteConfirm: cfg.remoteConfirm, remoteConfirmTimeoutMs: cfg.remoteConfirmTimeoutMs, openDesktop: cfg.openDesktop}
         : {remoteConfirm: 'ask-then-allow', remoteConfirmTimeoutMs: 600000, openDesktop: false},
       place: placeState(items),
+      watchdog: watchdog ? {enabled: watchdog.enabled()} : null,
       version: VERSION,
     };
   }
@@ -212,6 +214,12 @@ export function createSettingsHandler({dir, getRemote, getBootError, reload, qr,
       fs.mkdirSync(dir, {recursive: true, mode: 0o700});
       fs.writeFileSync(placeFile, JSON.stringify({workspaceId: id}) + '\n', {mode: 0o600});
     },
+    async setWatchdog(payload) {
+      if (!watchdog) throw new Error('当前系统不支持');
+      if (typeof payload?.enabled !== 'boolean') throw new Error('参数无效');
+      try { payload.enabled ? watchdog.install() : watchdog.uninstall(); }
+      catch { throw new Error(payload.enabled ? '开启失败，请稍后重试' : '关闭失败，请稍后重试'); }
+    },
     async restart() {
       requireConfigured();
       await settle(reload('设置页重启服务'));

package/lib/index.mjs

@@ -8,6 +8,7 @@ import {createQrAuth, createQrFlow} from './core/qr-auth.mjs';
 import {createDshHost} from './host/dsh-host.mjs';
 import {HEARTBEAT_MS, clearHeartbeat, watchdogState, writeHeartbeat} from './core/watchdog.mjs';
 import {createSettingsHandler, qrSuccessWriter, registerSettingsRoute} from './host/settings-rpc.mjs';
+import {createLaunchd, launchdSupported} from './core/launchd.mjs';
 
 export const name = 'dsh-remote-wecom';
 export const inject = ['typertGateway', 'connection'];
@@ -95,9 +96,16 @@ export function apply(ctx, options = {}) {
     intervalMs: Number(options?.qrPollMs) > 0 ? Number(options.qrPollMs) : undefined,
     log: debug,
   });
+  // watchdogDryRun：预览和测试用，plist 写进数据目录、不调 launchctl。
+  const dryRun = options?.watchdogDryRun === true;
+  const launchd = options?.watchdog === false || !(dryRun || launchdSupported()) ? null
+    : createLaunchd({dir, ...(dryRun ? {home: dir, run: () => {}} : {})});
+  try { if (launchd?.sync()) debug('看门狗已对齐到当前插件'); }
+  catch (e) { warn(`看门狗更新失败：${e?.message || e}`); }
   const handler = createSettingsHandler({
     dir, getRemote: () => remote, getBootError: () => bootError, reload, qr,
     getWorkspaces: typeof host.workspaces === 'function' ? () => host.workspaces() : null,
+    watchdog: launchd,
   });
   ctx.effect(() => registerSettingsRoute(ctx, handler), 'dsh-remote-wecom: settings route');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-remote-wecom",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "DeepSeek Harness plugin: control Desktop sessions from WeCom, with session cards, attachments, approvals and task results.",
   "author": "lukeinx",
   "repository": {
@@ -19,7 +19,13 @@
     "deepseek-desktop",
     "wecom",
     "wechat-work",
-    "remote-control"
+    "remote-control",
+    "deepseek",
+    "dsh",
+    "ai-agent",
+    "chatops",
+    "mobile",
+    "企业微信"
   ],
   "main": "lib/index.mjs",
   "exports": {
@@ -38,7 +44,7 @@
     "README.md",
     "LICENSE",
     "NOTICE.md",
-    "docs"
+    "docs/DESIGN.md"
   ],
   "dsh": {
     "bundle": {