桌面橘猫 ldystudy0913-jpg/dsh-pet

dsh-pet 🐱

DeepSeek Harness（DSH）Web 界面的桌宠布丁：页面右下角书桌上的一只小橘猫，会根据当前 Agent 会话的实时状态进行表演 —— 工作中在迷你笔记本前敲键盘，任务完成时把电脑丢出去，空闲时打瞌睡，等你回复时歪头。

English version: README.md。

功能

- 状态驱动动画 —— 通过 shell.overlay 槽位上的标准 useSessions hook 读取当前会话的实时摘要（SessionSummary.running / .completed / .pendingInteraction）：
- running → 敲键盘（迷你笔记本 + 滚动代码 + 闪烁光标）
- running → done → 丢电脑 + 撒花 🎉
- idle → 打瞌睡（漂浮的 Zzz）
- pendingInteraction → 歪头 + "?" 气泡
- 纯客户端 —— 静态 Client 插件，无宿主逻辑、无网络请求、后端零负担。
- 可交互 —— 点击跳一下并说话；拖动可移到任意位置；双击隐藏（会出现重召唤按钮）；悬停齿轮打开演示面板（开工 / 丢电脑 / 出错）。
- 状态持久化 —— 位置与隐藏状态通过 localStorage（dshpet.pos、dshpet.hidden）在刷新后保留。

演示

工作原理

包在 package.json 中把自己声明为 web dsh.client 插件：

"dsh": { "client": { "inject": ["@deepseek-ai/dsh-client-runtime"], "platform": "web" } }

Loader 激活该包后，@deepseek-ai/dsh-client-modules 会扫描它并通过 /plugins/dsh-pet/client.js 提供 lib/client.js；浏览器端 bundle 注册到 shell.overlay 槽位。宿主入口（lib/index.js）故意为空 —— 它只为了让 Loader 激活包并扫描其客户端 bundle。

环境要求

- DSH 0.1.0-rc.7 及以上版本（web profile，即 dsh web）
- 浏览器中运行中的 DSH Web 界面（桌宠渲染在页面上）

安装

1. 把包加入你的 web profile

从 GitHub 安装（任意已发布的 tag / 分支均可）：

dsh plugin --profile web add "dsh-pet@github:ldystudy0913-jpg/dsh-pet"

或者手动把依赖写进 $DSH_HOME/profiles/web/package.json，再执行 dsh plugin --profile web install：

"dependencies": {
"dsh-pet": "github:ldystudy0913-jpg/dsh-pet"
}

从 npm 安装（发布之后）：

dsh plugin --profile web add dsh-pet

dsh plugin --profile 会把参数原样转发给 profile 目录里的 pnpm，因此任何 pnpm 依赖写法都适用。

2. 在 profile patch 中激活该行

在 $DSH_HOME/profiles/web/cordis.patch.yml 末尾追加：

- insert:
- id: pet
name: 'dsh-pet'

3. 重启

重启 dsh web（或 dsh --profile web）。小橘猫应该出现在页面右下角。

卸载

删除 patch 行，然后：

dsh plugin --profile web remove dsh-pet

交互方式

| 操作 | 效果 |
| 单击 | 跳一下 + 随机气泡台词 |
| 拖动 | 把桌宠移到任意位置 |
| 双击 | 隐藏（右下角出现 🐱 重召唤按钮） |
| 悬停 ⚙ | 演示面板：强制 开工 / 丢电脑 / 出错 状态 5 秒 |

开发

在你自己 profile 里联调，改动立即可见：

在 $DSH_HOME/profiles/web 下
pnpm add "dsh-pet@file:./dsh-pet"

然后添加 patch 行并重启 dsh web。客户端 bundle 是纯 JavaScript，无需构建步骤 —— 它使用 DSH 客户端模块加载器要求的 tsdown 风格 window.__ModuleLoader__.load({ id, factory }) 格式（具体约定见 @deepseek-ai/dsh-client-modules 的 README）。

兼容性说明： 动画状态通过 shell.overlay 槽位上的 useSessions 标准 hook 从 SessionSummary.running / .completed / .pendingInteraction 推导。如果未来 DSH 版本重命名或重构这些字段，需要同步更新 lib/client.js 中 PetView 的推导逻辑。

发布（维护者）

- GitHub —— 给仓库添加 topics 以便被检索：deepseek-harness、dsh、dsh-plugin、desktop-pet、deepseek。
- npm —— dsh-pet 这个包名目前未被占用，发布方法：

npm login
npm version patch && npm publish

许可证

MIT