deskbuddy weekly downloads statistics

DeskBuddy CLI

DeskBuddy 桌面硬件的电脑端配套程序：把你电脑上的 AI 智能体和桌上的 DeskBuddy 连起来。

• 状态上屏：每个会话在干活、在等你确认、还是做完了，抬头看一眼设备就知道
• 远程下指令 / 新建任务：在设备上对某个任务说一句话，电脑上的智能体接着干；也能在设备上新建任务
• 在设备上批准授权：智能体要跑命令、改文件时，设备上弹卡片，按「允许 / 拒绝」
• 窗口授权框同步：你在电脑窗口里遇到授权框时，设备上也出一张卡片，两边谁先答算谁
• 传输加密（可选）：在 DeskBuddy App 里设密码开启后，消息内容用由密码派生的密钥加密传输

支持 macOS、Windows、Linux。

支持的智能体

Claude Code、Codex、WorkBuddy、Qoder CN、Qoder、opencode、千问办公、百度搭子、DeepSeek Harness、TRAE、扣子（扣子支持 macOS、Windows）。

安装时会接入本机检测到的全部智能体；之后新装的智能体，后台守护进程会自动接入（每 5 分钟检查一次，你 disable 过的不会再接）。

快速开始

推荐：用 App 给的安装命令。 在 DeskBuddy App 里点「添加电脑」，复制给出的命令，在终端运行，或者直接丢给你自己的 AI 智能体代跑：

npx -y deskbuddy@beta install --code <安装码>

全程不需要交互：绑定账号 → 接入本机所有智能体 → 设好开机自启并启动守护进程 → 检查各智能体命令行是否已登录（没登录的会打开登录窗口）。最后输出一段 === DeskBuddy 安装结果 ===，RESULT: ok 即成功。装完后重启已经开着的智能体才会开始同步状态；Codex 下次启动会要求信任 DeskBuddy 的 hook，请选择同意。

安装码 10 分钟内有效。请使用 App 生成的原命令，不要修改其中的地址。

手动方式（扫码授权）：

npx -y deskbuddy@beta setup                       # 用 DeskBuddy App 扫码；扫不出就在 App 里手输授权码
npx -y deskbuddy@beta enable claude_code,codex    # 用哪几个写哪几个，逗号分隔
npx -y deskbuddy@beta status                      # 看连的哪个环境、接入了什么

setup 默认连 https://api.shifengintelli.com，联调测试环境可加 --api-base https://test-api.shifengintelli.com。

工具名：claude_code、codex、workbuddy、qoder_cn、qoder、opencode、qwenwork（千问办公）、dumate（百度搭子）、deepseek_harness、trae、coze（扣子）。

让智能体代跑时会遇到的情况

• 受限环境：智能体的沙箱可能拦住写配置或设开机自启，结果里会说明。智能体应向你申请在受限环境外运行后重跑同一条命令；申请被拒就停下，改由你双击完成安装文件。
• 待补装：某个智能体的配置文件被占用、这次没写进去，结果里列为「待补装」。后台守护进程会每 5 分钟自动补装；想立刻好就按结果里的提示做。
• 双击「完成DeskBuddy安装」：需要时会在 ~/.deskbuddy/ 生成 完成DeskBuddy安装.cmd（Windows）/ .command（macOS），并在资源管理器 / 访达中定位，双击即可完成剩余步骤。
• 只关窗口不算退出：WorkBuddy、Qoder、千问办公等桌面 App 关掉窗口后常驻托盘 / 后台，配置文件仍被占着。提示「先退出」时，请从菜单栏或托盘图标选「退出」（macOS 也可 ⌘Q）。

命令

命令	作用
deskbuddy install --code <安装码>	一键接入：绑定账号、接入本机所有智能体、设好开机自启（无交互）
deskbuddy setup [--api-base <url>]	扫码授权，--api-base 指定网关并记住（默认生产）
deskbuddy enable <tool[,tool]>	接入指定智能体，并设好守护进程开机自启
deskbuddy disable [tool[,tool]]	移除接入（不带参数 = 全部，连同开机自启），保留授权
deskbuddy update	手动升级到当前这版：重装已启用工具的 hook、重启守护进程
deskbuddy status	账号、服务端、已启用工具、开机自启、本地会话等
deskbuddy logout [--yes]	移除接入与开机自启，并删除本机全部 DeskBuddy 数据
deskbuddy config set|get <开关> [值]	本地开关：transcript on|off（会话对话同步）、设备回复后是否切到该会话等
deskbuddy workbuddy-setup [--yes]	可选：安装 WorkBuddy 的独立版命令行
deskbuddy daemon [--foreground]	守护进程（开机自启会自动拉起，一般不用手动跑）
deskbuddy wrap <tool> …	内部使用：经 DeskBuddy 打开智能体窗口

自动升级：守护进程会定期向所连服务端查询应使用的版本，有新版就在后台装好，等电脑空闲时切换；新版本 5 分钟内崩溃 3 次会自动退回上一版。不想自动升级：在 ~/.deskbuddy/config.json 里加 "autoUpdate": false，之后用 npx -y deskbuddy@<版本号> update 手动升级。

隐私与安全

• 只连我们自己的服务端（api.shifengintelli.com）。自动升级只从 npm 官方源（及 npmmirror 镜像）拉取 deskbuddy 这一个包。
• 本地签名密钥：每台电脑生成一对密钥，私钥存在本机（macOS 钥匙串 / Windows DPAPI / 权限 0600 的文件），请求用它签名。
• 传输加密（可选）：在 App 里设密码开启。
• 上报内容：工具名、状态、会话标题、项目目录名等；等设备批准时会上报要执行的命令 / 要改的文件摘要。会话对话同步默认开启（隐藏常见密钥、不含工具输出），可用 deskbuddy config set transcript off 关闭。
• 日志上传：只在我们的后台为排查你的设备发起时才上传，且先脱敏（主目录路径、token、密钥、URL 参数）。
• 开机自启只装在当前用户下，不需要管理员权限；npm install 时不执行任何脚本。

完整说明见安装包内的 DISCLOSURE 文件。详细安装手册在安装包内的 docs/INSTALL.md（npx 缓存或全局安装目录下）。

卸载

npx -y deskbuddy@beta disable codex     # 只移除某个智能体
npx -y deskbuddy@beta disable           # 移除全部接入与开机自启，保留授权，随时可再 enable
npx -y deskbuddy@beta logout            # 移除接入与开机自启，并删除整个 ~/.deskbuddy（要确认，--yes 跳过）

disable 只摘掉 DeskBuddy 自己写入的条目，你自己的配置原样保留。logout 只清本机数据；之后重新安装会换一个新的本机标识，旧的不再上报。