deskbuddy 0.2.0-beta.2 → 0.2.0-beta.21

package/docs/INSTALL.md

@@ -4,7 +4,7 @@
 > 你按顺序执行下面的步骤即可。每一步都给了**判定成功的依据**，不满足就按「排查」一节处理。
 > 需要用户本人动手的地方（扫码、Codex 授信）已经标出来了，到那一步要停下来告诉用户。
 
-DeskBuddy 让桌面硬件和电脑上的 AI 编码智能体（Claude Code、Codex、WorkBuddy、Qoder CN、opencode）配合：
+DeskBuddy 让桌面硬件和电脑上的 AI 编码智能体（Claude Code、Codex、WorkBuddy、Qoder CN、Qoder、opencode）配合：
 
 - **状态上屏**：每个会话窗口在干活、在等你确认、还是做完了，抬头看一眼桌上的屏就知道
 - **远程下指令**：在设备上对某个任务说一句话，电脑上的智能体接着干；也能在设备上新建任务
@@ -52,7 +52,9 @@ npx deskbuddy@beta setup --api-base https://test-api.shifengintelli.com
 npx deskbuddy@beta enable claude_code,codex,opencode     # 用户用哪几个写哪几个，逗号分隔
 ```
 
-可选：`claude_code`、`codex`、`workbuddy`、`qoder`（Qoder CN 桌面端）、`opencode`。
+可选：`claude_code`、`codex`、`workbuddy`、`qoder_cn`（Qoder CN 国内版）、`qoder`（Qoder 国际版：Qoder.app / qodercli）、`opencode`。
+
+> 0.2.0-beta.9 及以前的 `qoder` 指国内版；`deskbuddy update`（含自动升级）会把它迁成 `qoder_cn`，本机也装了国际版时一并启用 `qoder`。
 
 `enable` 做三件事：往各智能体配置里装 hook / 插件、把脚本同步到 `~/.deskbuddy/`、**设好守护进程开机自启并启动它**。
 
@@ -74,12 +76,14 @@ npx deskbuddy@beta enable claude_code,codex,opencode     # 用户用哪几个写
 
 ### 各智能体的能力
 
-| 能力 | Claude Code | Codex | WorkBuddy | Qoder CN | opencode |
-|---|---|---|---|---|---|
-| 状态上屏 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 远程下指令 / 续会话 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 远程任务在设备上批准 | ✅ | ✅ | ✅ | ✅ | ✅ |
-| 窗口授权框同步到设备 | ✅ | 仅 `--remote` 常驻 app-server | ❌ | ✅ | ✅ |
+| 能力 | Claude Code | Codex | WorkBuddy | Qoder CN | Qoder（国际版）⚠️ | opencode |
+|---|---|---|---|---|---|---|
+| 状态上屏 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 远程下指令 / 续会话 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 远程任务在设备上批准 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
+| 窗口授权框同步到设备 | ✅ | 仅 `--remote` 常驻 app-server | ❌ | ✅ | ✅ | ✅ |
+
+⚠️ Qoder 国际版与 CN 同一套代码，按官方安装包核对了路径，桌面端未装机实测。
 
 WorkBuddy 的授权框由它自己的「安全中心」弹出、不经过任何 hook，所以做不了；Codex 的 hook 会先卡住授权框（等 hook 返回才弹），所以只能走 app-server。
 
@@ -115,6 +119,16 @@ npx deskbuddy@<新版本号> update
 - 版本号用 `npm view deskbuddy dist-tags` 查；写死版本号比写 `@beta` 稳：npx 有缓存，`@beta` 可能还拿到旧版
 - 只跑任意一个命令（如 `status`）也会把 `~/.deskbuddy/` 里的脚本同步到当前版本，但**不会**补装新 hook、也不会换掉守护进程——所以升级一律用 `update`
 
+### 【2026-10-01 新增】自动升级（0.2.0-beta.8 起）
+
+升到 beta.8 及以后，**不用再手动升级**：守护进程每小时问一次它所连的服务端「该用哪个版本」，有新版就在后台装好，等电脑空闲（没有正在执行的设备指令、没有待批准的授权）时自己切换过去，切换只停几秒。
+
+- 升到哪一版由**所连服务端**指定（测试环境指定 beta 版，正式环境指定正式版），只升不降；
+- 新版本 5 分钟内连续崩溃 3 次会自动退回上一版，并且以后不再自动升到它；
+- 切换那几秒里设备发来的指令会提示「电脑上的 DeskBuddy 正在升级，请过一会儿再发」，重发即可；
+- 不想自动升级：在 `~/.deskbuddy/config.json` 里加 `"autoUpdate": false`，之后照上面手动 `update`；
+- beta.7 及更早的电脑要先手动 `update` 一次到 beta.8，才进入自动升级。
+
 ---
 
 ## 国内用户
@@ -133,10 +147,10 @@ npx --registry=https://registry.npmjs.org deskbuddy@beta setup --api-base https:
 |---|---|
 | `~/.claude/settings.json` | **幂等合并**上报 hook 与窗口授权 hook（你已有的 hook 一条都不动） |
 | `~/.codex/config.toml` | 在文件**末尾追加**一段带 `# >>> deskbuddy >>>` / `# <<< deskbuddy <<<` 标记的块；其余字节一个都不碰 |
-| `~/.workbuddy/settings.json`、`~/.qoder-cn/settings.json` | 同 Claude Code，幂等合并 |
+| `~/.workbuddy/settings.json`、`~/.qoder-cn/settings.json`、`~/.qoder/settings.json` | 同 Claude Code，幂等合并 |
 | `~/.config/opencode/plugin/deskbuddy.js` | 新建一个几行的插件入口（同名文件不是我们生成的就拒绝覆盖） |
 | `~/Library/LaunchAgents/com.deskbuddy.daemon.plist`（macOS）/ systemd 用户单元（Linux）/ 「启动」文件夹里的 `DeskBuddyDaemon.vbs`（Windows，不需要管理员权限） | 守护进程开机自启 |
-| `~/.deskbuddy/` | 我们自己的目录：授权配置、hook 与授权关卡脚本、opencode 插件本体、每个会话的状态、待批准记录、守护进程日志 |
+| `~/.deskbuddy/` | 我们自己的目录：授权配置、hook 与授权关卡脚本、opencode 插件本体、每个会话的状态、待批准记录、守护进程日志；【2026-10-01】起还有 `versions/`（当前与上一版 CLI，自动升级用）和固定启动入口 `launcher.cjs`（开机自启指向它） |
 
 写用户配置文件时都是**原子写并保留原权限位**（`config.toml` 通常是 `0600`，不会被放宽）。
 

package/hook/deskbuddy-dsh.d.mts

@@ -0,0 +1,24 @@
+// hook/deskbuddy-dsh.mjs 的类型声明（只给测试用；插件本体是零依赖 JS，跑在 dsh 进程里）
+type Cc = { tool_name: string; tool_input: Record<string, unknown> }
+export const TOOL: string
+export const SUPPORTED_VERSION_RE: RegExp
+export function toCcTool(tool: unknown, args: unknown): Cc
+export function parseArgs(raw: unknown): Record<string, unknown>
+export function questionsToCc(questions: unknown): { tool_name: string; tool_input: { questions: Array<Record<string, unknown>> } } | null
+export function answersFromLists(questions: unknown, lists: unknown): { answers: Array<{ id: string; selected: string[]; custom?: string }> } | null
+export function skippedAnswers(questions: unknown): { answers: Array<{ id: string; selected: string[] }> } | null
+export function profileName(ctxProfile: unknown, argv?: string[]): string
+export function isWindowProfile(name: unknown): boolean
+export function gatingAllowed(version: string): boolean
+export function dshVersion(argv?: string[]): string
+export function parseGateOut(r: unknown): { decision: 'allow' | 'deny'; answers: string[][] | null } | null
+export function race<T>(next: () => Promise<T> | T, device: Promise<T | null>, cancelDevice: () => void, abortNative: () => void): Promise<T>
+export function spliceSignal(req: { signal?: AbortSignal }, ac: AbortController): boolean
+export const name: string
+export function apply(ctx: unknown, config?: { node?: string }): void
+export function runIdFromEnv(env?: Record<string, string | undefined>): string
+export function mailboxHome(env?: Record<string, string | undefined>): string
+export function runGateAllowed(r: unknown): boolean
+export function rootSession(parents: Map<string, string>, sid: string): string
+export const STALE_LETTER_MS: number
+export const LETTER_RE: RegExp