dsh-workbuddy-account-care
Verifieddsh-workbuddy-account-care · v0.0.8 · MIT · Web UI
dsh-workbuddy 账号呵护:dsh-connect-workbuddy 的配套辅助插件。按 WorkBuddy 官方接口字段与安装包文件名解析出的版本号(取高者)与本地基线比对,不一致就提示并停用 dsh-connect-workbuddy、软结束正在用它的会话,并在界面顶部挂持久水印;同时自动升级 dsh-connect-workbuddy 自身。
Install
dsh plugin add dsh-workbuddy-account-care Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-workbuddy 账号呵护
dsh-workbuddy-account-care—— WorkBuddy 账号的看门人。本仓库是
dsh-connect-workbuddy的配套辅助插件——它不提供任何模型能力,只为那个插件踩刹车。安装本插件之前,请先安装
dsh-connect-workbuddy。 没有它,本插件不产生任何效果。WorkBuddy 官方接口报的版本号一旦和本地记录的对不上,立刻停用那个插件;它自己在 npm 上有新版,就自动升级并提示重启。 全程零模型调用,DSH 不启动就什么都不做。

⚠️ 前置条件:先装 dsh-connect-workbuddy
本插件是 dsh-connect-workbuddy 的配套插件,不是它的替代品,也不能单独工作。
它没有自己的模型、没有自己的 provider、没有自己的界面入口;它的全部动作都围绕
「那个插件现在安不安全」展开。所以你必须先装好 dsh-connect-workbuddy,再来装本插件。
请先按这里的说明安装好:
👉 https://github.com/dingminhua/dsh-connect-workbuddy
# 1) 先装 dsh-connect-workbuddy(按它自己的 README)
dsh plugin --profile web add dsh-connect-workbuddy
# 2) 确认它已被选中、且模型选择器里能看到 WorkBuddy 的模型
# 然后才装本插件
dsh plugin --profile web add dsh-workbuddy-account-care
没装就完全不动。 本插件每次检查前先确认 dsh-connect-workbuddy 真的在
node_modules 里;不在就整轮跳过——不停用、不升级、不挂水印、不碰 profile,
连基线都不写(只留一行日志说明为什么跳过)。
这条不是礼貌,是必需的:本插件的一项动作是「自动升级
dsh-connect-workbuddy」。在没有装它的机器上,那个动作会变成凭空安装一个
你没要求过的插件。所以未安装时它必须彻底安静。
它解决什么
dsh-connect-workbuddy 靠 WorkBuddy 客户端的私有接口工作(伪装客户端、
复用本机登录态),客户端一更新,那些接口随时可能变。这个插件把风险面收窄成两条规则:
| 事件 | 动作 |
|---|---|
| WorkBuddy 版本号与基线不一致 | 红色水印 + 让你选怎么结束(软结束 / 硬结束)+ 桌面通知(防止伤害到你的账号的鳞片) |
dsh-connect-workbuddy 在 npm 上有新版 |
自动升级 + 橙色水印提示重启 DSH |
| 什么都没有 | 静默,只写一行日志 |
判断依据只有一个数字:接口报的版本号 ≠ 本地记录的基线版本号。规则很硬, 没有「可能」、「大概」、「指纹相近」——对不上就是变了,对上就什么都不做。 而这个版本号本身取自两处:接口字段、安装包文件名,取高者(见下)。
判定数据源
整个插件只读一个外部数据源:
GET https://www.workbuddy.cn/v2/update?platform=workbuddy-darwin-x64
{
"version": "5.9.3.42398134",
"productVersion": "5.9.3.42398134",
"url": "https://download.codebuddy.cn/workbuddy/saas/…-5.9.3.42398134-d4692421.zip",
"sha256hash": "e093e214…",
"timestamp": 1793121334
}
每轮探 5 个平台,只有 3 个参与判定:
| 角色 | platform | 参与判定 |
|---|---|---|
| 判定 | workbuddy-darwin-x64 / -arm64 / workbuddy-win32-x64-user |
✅ 三者取高者 |
| 记录 | workbuddy-linux-x64-deb / -arm64-deb |
❌ 只写日志与 --status |
为什么把 Linux 摘出去:实测它整线滞后一个大版本段(5.6.2 vs 5.9.3),
算进「取高者」只会制造噪声。等官方三端对齐了,把它加回
PLATFORMS_JUDGE 即可,代码里就一个数组。
每个平台从响应里取两个版本号:
| # | 来源 | 例子 |
|---|---|---|
| 1 | productVersion(没有时退回 version) |
5.9.3.42398134 |
| 2 | url 的文件名里的版本号 |
WorkBuddy-darwin-x64-5.9.3.42398134-d4692421.dmg → 5.9.3.42398134 |
单个平台内部,两者取高;三个判定平台之间,再取高者,得到判定版本。
最后与 state.json 的 baseline.version 做字符串比较:不等就报一次
「版本不一致」。
链接按平台给,脚本按各自的平台分别解析文件名,格式是稳定的一段:
…/workbuddy/saas/darwin-x64/WorkBuddy-darwin-x64-5.9.3.42398134-d4692421.dmg
└── 平台 ──┘ └─── 版本 ───┘ └ 构建 ┘ └扩展┘
.dmg / .zip 是同一版本的两个包(其它平台是 .deb / .exe / .AppImage),
所以扩展名不参与判定,版本号才参与。同一版本号有 4 段数字,最后一段是构建号;
构建哈希(d4692421)是十六进制、不含点,不会被误认成版本。
只解析,不下载。 这个插件每次检查只读几百字节,为了一句「没看错」去拖 180MB 的安装包显然不合理。解析是纯字符串操作:拆 URL、取最后一段、跑一条正则。 它也不会对链接发 HEAD 或任何请求。
两处不一致时取高者,不投票。 发布是不同步的——清单先改、CDN 上的文件名
晚几分钟跟上(或者反过来)是常态。要求两者一致,等于每次发版都要白等一个检查
周期;取高者的含义很直接:谁先说新版本,就按谁算。低的那一路只记一条
warn 日志,--status 的 lastJudge.versionGap 里也能看到,方便排查。
安装
三种都行,装完都要重启 DSH——Host 半只有重启才会换。
# 1) 直接指向本地目录(开发时最方便,改完只需重启 Host)
dsh plugin --profile web add link:/path/to/dsh-workbuddy-account-care
# 2) 装 GitHub Release 里的 tarball(推荐给使用者)
dsh plugin --profile web add /path/to/dsh-workbuddy-account-care-0.0.6.tgz
# 3) 如果以后发到了 npm
dsh plugin --profile web add dsh-workbuddy-account-care
浏览器半(client.js)改完刷新页面即可,不用重启进程。
没有定时器要装。 插件自带定时:加载完立即跑第一次,之后每 3 分钟一次, 不需要 systemd、cron、launchd,也不需要 DSH 的「自动化任务」。
0.0.6起,首次检查不再等一个间隔;并且把用户能感知的那两段轮询收紧到秒级。从触发到看见水印,要经过三段轮询:
段 做什么 旧 新 ① 派生 watch.mjs探官方版本接口3 分钟 3 分钟(后台检查,用户无感) ② 宿主读 guard.json并发布水印15 秒 2 秒(脚本跑完还会立刻同步一次) ③ 浏览器拉 /plugins/…/state30 秒 5 秒(仅标签页可见时) 段① 刻意保持 3 分钟:它是后台探测,多等两分钟用户不会有任何感觉; 真正会被察觉的是 ②③ 那两段「已经知道了却还没显示出来」的延迟,所以只收紧它们。
各时机的行为:
时机 行为 DSH 启动、bundle 加载完成 startupDelayMs(默认 3 秒,只用来躲开 profile 收敛)后立刻检查运行中安装 / 卸载 / 改启用状态 收到 plugin-manager/changed后 1 秒内补跑一次dsh-connect-workbuddy一时读不到先按 15 秒重试,最多 4 次,再回到常规节奏 其余 每 intervalMinutes(默认 3 分钟)一次
装完之后可以这样确认它在工作:
npx dsh-workbuddy-account-care status # 插件状态:目标插件版本 / 启用与否 / 水印 / 检查次数
npx dsh-workbuddy-account-care where # 各条路径 + 当前定时来源
status 里 plugin on 指的是 dsh-connect-workbuddy 是否仍被选中——
本插件自己始终是启用的,它不守自己。
界面
WorkBuddy 版本不一致时(红色,等你选软结束 / 硬结束):

插件自身升级后(橙色,提示重启):

- 水印挂在
shell.overlay(frame 级浮层),切会话、滚页面都不会带走。 - 玻璃感浮层:半透明底色 +
backdrop-filter模糊 + 极细描边 + 顶部高光, 像浮在页面之上的一层玻璃,而不是一块实心色条;入场 340ms 从上方淡入浮起, 关闭 180ms 淡出下沉。 - 容器
pointer-events: none,不吃点击,不挡对话。 - 颜色跟随主题令牌(
--dsw-alias-*),亮/暗自动适配;prefers-reduced-motion时动画全关。
工作方式
只有一条定时链,全部在 DSH 进程内:
dsh-workbuddy-account-care(Host 半)
├─ 加载完 → 3 秒后立刻 spawn 一次 scripts/watch.mjs
├─ 运行中装/卸插件(plugin-manager/changed)→ 1 秒后补跑一次
├─ 之后每 3 分钟 spawn 一次 scripts/watch.mjs
│ ├─ 前置检查:dsh-connect-workbuddy 装了吗?没装 → 直接退出
│ │ (插件侧读不到时先 15 秒 × 4 次短重试,避免把「还在收敛」误判成未安装)
│ ├─ 探 5 个平台(mac×2 + win 判定,linux×2 只记录)
│ │ ├─ 每个平台:productVersion ↔ url 文件名版本,取高
│ │ └─ 三个判定平台之间再取高 = 判定版本
│ ├─ 读 npm 上 dsh-connect-workbuddy 的 latest
│ ├─ 判定版本 ≠ 基线 → 写 guard.json(水印,等你选软结束/硬结束)
│ │ 基线随即推进,同一版本不会反复弹
│ └─ npm 有新版本 → 写 guard.json 的 upgrade 指令
│
│ (升级不由脚本执行:脚本是 node 派生的独立进程,
│ 在 Desktop 里没有 dsh 命令可用,见下节)
│
├─ 脚本退出时立刻同步一次(不等下一轮轮询)
└─ 每 2 秒读一次 guard.json
├─ 水印 → 经 HTTP 端点给浏览器半,由它在 shell.overlay 里画
├─ upgrade 指令 → 按环境挑一条路执行安装,结果回写 guard.json
└─ 软结束指令 → cancel 正在跑的轮次 + followup 一条「本机 provider 已更新…」
升级 dsh-connect-workbuddy 的三条路
这个插件同时活在两种宿主里,而它们没有共同的可执行入口,所以按环境挑一条:
| 顺序 | 方式 | 适用 | 说明 |
|---|---|---|---|
| 1 | host-service |
DSH Desktop(Electron)、任何装了 dsh-plugin-manager 的 profile |
用 ctx.get('pluginManager') 调 installBundle。与界面里点「更新」同一条 pnpm 路径,装完自动 reconcile dsh.profile.bundles,HMR 下可热生效。不需要 dsh 在 PATH 上 |
| 2 | dsh-cli |
命令行启动的 Harness(dsh web) |
调 dsh plugin --profile <p> add <spec>。Windows 上经 cmd.exe /c 调用 .cmd |
| 3 | none |
两者都没有 | 只记录、不改动,把结论写进日志与 --status,由你手动升 |
为什么不能只用 CLI:scripts/watch.mjs 是 node 派生的独立子进程,它继承的是
宿主进程的 PATH。DSH Desktop 的宿主里没有 dsh 命令——安装目录下只有
dsh.cmd,而 Node 从 18.20/20.12/21.7 起修 CVE-2024-27980,拒绝在不带 shell
时 spawn .cmd/.bat:
execFileSync('dsh', …) → ENOENT (PATHEXT 不参与解析)
execFileSync('…\dsh.cmd', …) → EINVAL (防注入保护)
所以 0.0.5 及更早在桌面端的自动升级是 100% 失败的(日志里只有一条
spawnSync dsh ENOENT)。0.0.6 起改为「脚本判定、宿主执行」:桌面端走第 1 条,
命令行端走第 2 条。
升级指令写在 guard.json 的 upgrade 字段,宿主每 15 秒读一次。执行结果回写为
done / failed,--status 可以直接看到当前卡在哪一步:
npx dsh-workbuddy-account-care check --status
# → "upgrade": {"status":"done","method":"host-service","application":"applied", …}
同一个 from → to 只会下发一次;失败后最多重试 2 次(防每轮无限重试)。
水印的生命周期分在两半,各管一段:
scripts/watch.mjs index.js(Host 半) client.js(浏览器半)
├─ 写 watermark{at} ├─ 首次 poll 先判过期: ├─ 每 5 秒 / 切回标签页拉一次
├─ 危险水印:不带 untilRestart │ untilRestart 且 at < 启动时刻 ├─ 玻璃卡在 shell.overlay 里淡入
└─ 升级水印:带 untilRestart │ → 清成 null、revision +1 └─ 「知道了」按 revision 记 localStorage
├─ 脚本退出后立刻同步一次
└─ 之后每 2 秒读 guard.json
首次执行时机
检查由 Host 半自己排期,所以「什么时候跑第一次」完全是插件的行为,与 DSH
的自动化任务无关。0.0.6 的行为:
bundle 加载
│ startupDelayMs(默认 3000ms)—— 只为躲开 profile 收敛,不是等一个间隔
▼
第一次检查 ──► 之后每 intervalMinutes(默认 3 分钟)
▲
│ 以下任一情况会把下一次检查**提前**到秒级:
│ · plugin-manager/changed(运行中安装 / 卸载 / 改启用状态)→ 1 秒
│ · 目标插件一时读不到(profile 还在收敛)→ 15 秒重试,最多 4 次
为什么不是「apply 里同步跑」:apply() 执行时 Cordis 的 loader 树可能还没收敛,
此时问 pluginManager.listBundles() 会短暂看不到 dsh-connect-workbuddy,
这一轮就会被误判成「目标未安装」而跳过。3 秒足够绝大多数机器走完收敛,又短到
用户感觉不到;嫌慢可以设 startupDelayMs: 0。
首次执行也会走完整的判定链路(探接口、比基线、升级插件),不是一次「预热」。 如果目标插件确实未安装,脚本按既有规则整轮跳过、不写任何状态。
对应的回归用例:test/startup-check.test.mjs(排期逻辑)、
test/e2e-startup.test.mjs(用假 ctx 真跑一遍 apply(),观察脚本被派生的时刻)。
软结束会话
只针对正在跑(status === 'running')且确实在用 WorkBuddy的会话,
「在用」只认会话投影 modelSelection——它和界面上的模型选择器读的是同一份
数据(next = pending ?? lastUsed),所以不会出现「界面没提示、会话却被停用」。
以前还把
agent.options.provider当独立证据,那是会话创建时的配置,中途 换 provider 不会更新。结果一条一直在用 deepseek 的会话(只是在对话里聊到 WorkBuddy)被软结束了。现在它只在投影服务整个不可用时才参与,而且要与最后 一条 assistant 消息的 provider 同时命中才算。test/uses-workbuddy.test.mjs锁住了这个行为。
具体动作:
agent.cancel({ kind: 'hook' }, { keepInbox: true })—— 中止当前轮,保留收件箱;agent.followup(...)—— 排一条「本机 provider 已更新,本条消息由监控插件自动发送,收到后暂停你的所有任务, 等待重启 agent 工具」
先 cancel 再 followup 是有意的:那条说明才会成为下一轮的唯一输入,而不是被 这次中止一起丢掉。已经软结束过的会话不会重复插入(收件箱里有 「本条消息由监控插件自动发送」这句话就跳过),空闲会话不动。
命令
npx dsh-workbuddy-account-care status # 插件状态:版本、启用与否、水印、检查次数
npx dsh-workbuddy-account-care where # 各条路径 + 当前定时来源
npx dsh-workbuddy-account-care check # 立刻跑一次检查
check 可透传:
npx dsh-workbuddy-account-care check --dry-run # 演练,不落盘
npx dsh-workbuddy-account-care check --check # 只检查,绝不改 profile
npx dsh-workbuddy-account-care check --enable # 恢复被停用的插件
npx dsh-workbuddy-account-care check --clear-watermark # 只清界面水印
npx dsh-workbuddy-account-care check --no-upgrade # 跳过自动升级
npx dsh-workbuddy-account-care check --status # 机器可读 JSON
也可以直接跑脚本:
node node_modules/dsh-workbuddy-account-care/scripts/watch.mjs
配置
在 profile 的 cordis.patch.yml 里覆盖,改完重启 DSH:
- id: dsh-workbuddy-account-care
name: dsh-workbuddy-account-care
config:
intervalMinutes: 3 # 内置定时间隔,分钟
selfSchedule: true # false = 关掉内置定时(此时不会有任何自动检查)
startupDelayMs: 3000 # 加载后多久跑第一次;0 = 立刻(默认就是秒级,不是等一个间隔)
notify: true # false = 不弹桌面通知
pollMs: 15000 # 读指令文件的轮询间隔
profile: desktop # 目标 profile(强烈建议显式写,见下)
⚠️ 请显式配置 profile
这一项建议每个用户都显式写上,尤其是用 DSH Desktop(Electron 客户端) 的:
profile: desktop # Desktop 用户
# profile: web # 命令行 `dsh web` 用户(这也是不写时的默认候选首位)
为什么必须显式配:本插件的检测脚本需要知道「去哪个 profile 里找 dsh-connect-workbuddy」。
它读的是 config.profile → 环境变量 DSH_PROFILE → 默认值。但 DSH Desktop 是 Electron
应用,宿主进程从托盘/快捷方式启动时不带 DSH_PROFILE 环境变量,于是取值回落到默认,
而用户实际用的往往不是那个 profile。结果是脚本去错的目录里找目标插件,报
「未安装」,然后整轮静默跳过——看起来像插件没工作,实际是查错了地方。
排查这种「什么都没发生」时,先看 --status 的 profileResolution.source:
detected-miss 配 pluginInstalled: null 基本就是这个原因。
不配也能工作(0.0.6 起):没给 --profile、没给 config.profile、也没有 DSH_PROFILE
时,脚本会按候选顺序串行探测,第一个真正装了 dsh-connect-workbuddy 的 profile 胜出。
默认候选顺序是 desktop → web(Desktop 优先,因为那是 Electron 用户最常见的形态)。
三种输入,优先级从高到低:
| 顺序 | 来源 | 行为 |
|---|---|---|
| 1 | --profile-dir <目录> |
目录说了算,名字只用于日志 |
| 2 | --profile <名字> / config.profile |
只认它,不回退(显式即精确,便于排障) |
| 3 | 都没有 | 按候选顺序探测;全都没装则回落到候选首位,走「未安装则完全静默」路径 |
候选顺序也可以显式覆盖:
// ~/.dsh/workbuddy-update-watch/config.json 里
{ "profile": "desktop" } // 等价于 config.profile,但不必重启 DSH
命令行临时指定:
node scripts/watch.mjs --profile desktop --check # 只查这一个,不回退
node scripts/watch.mjs --profiles web,desktop --check # 自定义探测顺序
探测是串行的,不是并行:脚本用
run.lock做全局互斥,并行会互相抢锁。 单次探测只读一个package.json,串行代价可以忽略。
策略文件 ~/.dsh/workbuddy-update-watch/config.json:
{ "autoDisable": false }
| 键 | 含义 |
|---|---|
autoDisable |
false(默认)= 检测到先挂提示,由你在界面上选;true = 检测到就当场停用(无人值守) |
disableOn |
旧键,为兼容保留。"never" 仍然有效(命中只挂提示、永不自动改 profile);其它值都等同于默认 |
profile |
目标 profile 名(等价于 config.profile,改完不必重启 DSH) |
环境变量
| 变量 | 默认 | 说明 |
|---|---|---|
DSH_HOME |
~/.dsh |
DSH 主目录 |
DSH_PROFILE |
未设 → 按候选探测 | 目标 profile。Desktop 客户端通常不设这个变量,所以更推荐用 config.profile(见上) |
WORKBUDDY_WATCH_PLATFORM |
按平台猜 | 版本接口的 platform 标识(workbuddy-darwin-x64、workbuddy-linux-x64-deb、workbuddy-win32-x64-user) |
WORKBUDDY_WATCH_UPSTREAM |
官网 /v2/update |
覆盖版本接口(自建镜像、内网代理时用) |
WORKBUDDY_WATCH_DISABLE_ON_UPSTREAM |
未设 | 兼容旧配置;设为 1 仍表示「命中即算停用条件」 |
状态文件
都在 $DSH_HOME/workbuddy-update-watch/:
| 文件 | 内容 |
|---|---|
state.json |
基线版本(baseline.version / source / linkFile)、最近一次两路判定(lastJudge)、已见版本、事件去重 |
guard.json |
给插件的指令(水印 + 软结束),插件回写 handled |
watch.log |
每次检查一行 |
config.json |
策略(可选) |
run.lock |
多执行器互斥(手动跑与定时跑撞车时用) |
package.json.bak-* |
每次改 profile 前的备份 |
许可
MIT