dsh-deepseek-pet
DeepSeek 桌宠：把「DSH 账户余额 + 蓝鲸女仆桌宠」连起来。宿主端查询余额、通过 127.0.0.1 回环接口喂给桌面悬浮窗，并提供 pet_balance / pet_control 两个模型工具。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:Yoshino-JF/dsh-deepseek-pet#1084348111865460be3224e514d7a6f0c410392cDeepseek Pet 以 dsh-deepseek-pet 发布，当前版本为 0.2.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
把 DeepSeek 账户余额喂给桌面上的蓝鲸女仆桌宠，并提供两个模型工具。
D:\DeepSeek\deepseek-pet（独立原生程序，WPF 透明置顶窗）127.0.0.1 上开一个只读状态接口、起停桌宠进程DSH 宿主插件 ──HTTP(127.0.0.1:47831/state)──▶ 桌宠窗口
│ 持 DEEPSEEK_API_KEY │ 只拿到余额数字
└─ ctx.credentials.resolve() └─ 每 5 秒取一次
plugin_manager install_bundle D:\DeepSeek\deepseek-pet-plugin
首次安装即为新 bundle，热生效；此后修改 index.js 再装会返回
restart-required（同包替换需要重启 DSH 才会加载新的 JS 世代）。
cordis.patch.yml → dsh-pet 行）| 字段 | 默认 | 说明 |
|---|---|---|
port | 47831 | 状态接口端口，只监听 127.0.0.1 |
petPath | D:\DeepSeek\deepseek-pet\build\DeepSeekPet.exe | 桌宠程序路径 |
credential | DEEPSEEK_API_KEY | 用哪条 DSH 凭据查余额（不写死密钥） |
apiBase | https://api.deepseek.com | 余额接口前缀 |
refreshSeconds | 60 | 缓存/刷新周期（秒） |
lowBalance | 10 | 低于该值桌宠切「担心」表情、徽章变红 |
autoStart | true | 宿主启动 3 秒后自动叫起桌宠 |
startDelayMs | 3000 | 自动启动延迟，避开宿主 boot 期 |
stopOnUnload | false | 卸载插件时是否顺手关掉桌宠（默认留着） |
GET /state?wait=25 长轮询：插件把请求挂起最多 25 秒，有事件立刻返回（实测反应 < 100ms），没有事件则超时返回一次心跳。agent/inbox/inserted（用户消息进入 inbox）→ 10 秒内 agent/status 变为 running。
自动续跑 / 子代理 / 定时任务没有这条用户消息，因此不会触发桌宠的"被吓一跳"演出。work-start、work-end、balance（余额变化）、message（留言）、quit（软退出）。插件改了 JS 之后，同包替换要重启 DSH 才生效。dev-mock-server.mjs 用完全相同的协议顶替插件：
node dev-mock-server.mjs 47835
DeepSeekPet.exe --url http://127.0.0.1:47835/state --screen on
curl "http://127.0.0.1:47835/dev/event?kind=work-start" :: 模拟"用户开始干活"→ 桌宠被吓一跳
curl "http://127.0.0.1:47835/dev/event?kind=work-end"
curl "http://127.0.0.1:47835/say?text=hello"
| 工具 | 参数 | 作用 |
|---|---|---|
pet_balance | fresh? | 读余额；fresh=true 跳过 60 秒缓存 |
pet_control | action（start/stop/status/refresh/say/hide/show）、text? | 起停桌宠、立即刷新、让桌宠弹一句话 |
| 路径 | 说明 |
|---|---|
GET /health | {ok:true} |
GET /state?pid=<桌宠pid> | 桌宠拉取的状态（余额+留言），先回缓存再后台补数据 |
GET /say?text=... | 让桌宠说一句话（也可以由别的脚本调用） |
GET /refresh | 触发一次强制刷新 |
/say、/refresh 也只影响桌宠显示）。