前言¶
用 DeepSeek Harness（DSH）跑智能体时，界面多半是终端、日志和工具调用列表。长时间盯着这些输出，很难直观感受到「代理正在想」还是「已经空闲」。一些桌面宠物类工具能在别的环境里做陪伴，但 DSH 的 Web 界面本身并不自带这类层。
dsh-cat-pet 是维护者 iypavlov 发布的 DSH 插件：在 Web UI 上叠加一只可拖动的动画猫，并根据代理是否在思考、回合是否结束、你是否在输入等情况切换姿态。下面介绍它做什么、怎么装、装完要注意什么。
这是什么¶
- 名称：npm 包
dsh-cat-pet，仓库 iypavlov/dsh-cat-pet。 - 定位：面向 DeepSeek Harness Web 客户端的动画猫伴侣（README 与
package.json描述一致）。 - 许可：MIT（见仓库 LICENSE）。
- 当前版本（资料中的
package.json）：0.1.0。
插件通过 DSH 的客户端扩展机制注入 Web 层（dsh.client.platform 为 web，immediately 为 true），不属于 DeepSeek 或幻方官方组件；社区目录页在 skillhub.cn，与官方无从属关系。
核心功能¶
资料中明确写到的行为如下，未列出的能力不要自行推断。
- 浮层显示：猫绘制在界面之上，不占用单独窗口（README：「живёт поверх интерфейса」）。
- 可拖动：用鼠标拖走猫，避免挡住控件。
- 记住位置：再次打开会话时仍使用上次放置的位置（README：「помнит позицию」）。
- 随代理状态变化：
- 一切平静时：坐着；
- 代理在「思考」时：躺下并睡觉；
- 回合回到你这边，或你开始打字时：醒来。
README 附带预览图 assets/preview.png，可在 GitHub 仓库首页查看静态效果。
安装与启用¶
DSH 插件生态的思路是「一切皆插件」：安装方式以官方 README 为准。常见有两种；npm 不可用时再用 GitHub 地址。
从 npm 安装（推荐）¶
包已在 npm 发布（徽章指向 dsh-cat-pet），且为预构建产物，不含 install 脚本，安装时不会触发本地编译，也不会弹出 build 脚本权限提示。
在终端执行：
dsh plugin add dsh-cat-pet
或在 DSH 里打开 Plugins → Add plugin，填入 dsh-cat-pet，点击 Install。
从 GitHub 安装¶
当 npm 不可用，或需要指定仓库修订时：
dsh plugin add github:iypavlov/dsh-cat-pet
同一对话框也支持其他写法（README 表格）：
| 填入内容 | 适用情况 |
|---|---|
github:iypavlov/dsh-cat-pet |
常规 GitHub 安装 |
https://github.com/iypavlov/dsh-cat-pet |
与上一行等价 |
git@github.com:iypavlov/dsh-cat-pet.git |
已配置 SSH 时 |
本地仓库的绝对路径（如 C:\path\to\dsh-cat-pet） |
使用本地副本 |
.tgz 归档路径 |
安装器同样识别 |
安装后必做一步¶
重启 DSH。配置文件会从自身 node_modules 里的插件副本加载；不重启则界面上看不到猫（README「После установки」）。
若你要改插件源码再本地调试，README 要求 Node ≥ 22，在仓库内 pnpm install、pnpm build（输出到 lib/）、再 pnpm install-local 写入 DSH profile；每次改代码后重复 build 与 install-local。一般使用者只需 npm 或 dsh plugin add 路径即可。
典型用法¶
README 未提供单独的配置文件或 CLI 子命令：安装并重启 DSH 后，打开 Web 界面即可。典型操作只有交互层面：
- 启动或重启 DSH，进入 Web UI。
- 观察猫在「空闲 / 代理思考 / 你输入」时的姿态切换。
- 若遮挡内容，拖动猫到空闲区域；位置会被记住。
插件客户端依赖注入 @deepseek-ai/dsh-client-locale（见 package.json 的 dsh.client.inject），由 DSH 在加载插件时处理，无需用户手动配置该项。
适用场景与注意¶
适合谁
- 长期在 DSH Web 界面里调试、旁路观察智能体回合的人，希望用轻量视觉反馈区分「代理在跑」和「等你输入」。
- 想要桌面宠物式陪伴、又希望与 DSH 会话状态联动，而不是另开独立小窗的用户。
使用前请知悉
- 权限：插件与当前 DSH 进程相同权限运行。安装前建议浏览 仓库源码 与 MIT 许可证，确认可接受再安装。
- 平台：面向 Web 客户端；是否在非 Web 环境生效，资料未说明，不要假设。
- 网络：优先
dsh plugin add dsh-cat-pet需要能访问 npm；否则用 GitHub 或本地路径。 - 维护状态：GitHub 星标为 0（线索与公开页一致时），属社区小插件，行为以当前版本 README 为准。
结尾¶
dsh-cat-pet 把「代理是否在思考」映射成猫睡/醒/坐，并支持拖动与位置记忆，改动面小、安装命令明确。若你在 DSH Web 里长时间盯会话，可以把它当作状态指示兼一点界面趣味。
