前言¶
DSH 的理念是“一切皆插件”。对于使用 DeepSeek Harness Web UI 的人来说,当前 Session 是空闲、正在执行任务,还是等待交互,通常要看界面提示。dsh-deepseek-girl-pet 是一个开源 Cordis 桌宠插件,会在界面右下角加入一个动画角色,依照当前 Session 状态切换动画,也会用 16 个方向跟着鼠标看。
它不修改 Session 数据、对话记录或 DeepSeek Harness 核心源码,适合想给 Web UI 加一个轻量状态提示的场景。
这是什么¶
dsh-deepseek-girl-pet 是一个面向 DeepSeek Harness Web UI 的开源桌宠插件,仓库路径为 f0909172434/dsh-deepseek-girl-pet,采用 MIT License。它是社群非官方项目,与 DeepSeek、OpenAI 或 Codex 没有从属、合作或背书关系。
它主要解决两件事:
- 用动画表达当前 Harness 状态:空闲、执行任务、等待交互。
- 用鼠标追视提供轻量交互反馈,而不是读取或修改对话内容。
核心功能¶
下面介绍已核实的插件能力。
状态动画¶
插件会依照当前 Session 状态切换动画:
- 空闲时:拿着简体“区”的板子待机,对话框文字保持“凶”。
- Harness 执行任务时:切换至工作动画。
- Session 等待交互时:切换至等待动画。
鼠标追视与交互¶
- 支持完整 16 方向鼠标追视,每 22.5 度一格。
- 鼠标停止 1.1 秒后,回到拿板子的待机动画。
- 点击桌宠可在一般尺寸与放大尺寸之间切换。
- 支持
prefers-reduced-motion。
资源与集成方式¶
- 作为 DeepSeek Harness 原生 Cordis 插件安装,使用
shell.overlay扩展槽。 - 使用 Codex pet v2 图集:1536 × 2288 WebP、8 × 11、每格 192 × 208。
- 不修改 DeepSeek Harness 核心文件。
- 不读取或写入对话内容。
- 不依赖外部 CDN 或追踪服务。
安装与启用¶
一行安装¶
执行安装命令:
dsh plugin --profile web add github:f0909172434/dsh-deepseek-girl-pet
安装后需要重启 Harness。先在原本执行 dsh web 的窗口按 Ctrl+C,确认 3080 已停止,再执行:
dsh web
如果看到:
EADDRINUSE: address already in use 127.0.0.1:3080
说明旧的 Harness 进程还在运行。先回到原本 Harness 终端按 Ctrl+C,再重新执行:
dsh web
最后到浏览器按 Ctrl+F5 强制重新加载。
安装完成后打开:
http://127.0.0.1:3080/
可用下面命令确认插件已经进入 web profile:
dsh --profile web --dump-config | Select-String deepseek-girl-pet
从源码安装¶
也可以先打包再安装:
git clone https://github.com/f0909172434/dsh-deepseek-girl-pet.git
cd dsh-deepseek-girl-pet
npm pack
dsh plugin --profile web add .\dsh-deepseek-girl-pet-0.2.0.tgz
源码安装完成后,同样重启 dsh web,并在浏览器强制刷新。
典型用法¶
经过上面的步骤后,可以这样使用:
1、打开 DeepSeek Harness Web UI,桌宠默认出现在界面右下角。
2、移动鼠标时,它按 16 个方向追视;鼠标停止 1.1 秒后,回到拿板子的待机动画。
3、当 Harness 执行任务时,切换至工作动画;Session 等待交互时,切换至等待动画。
4、点击桌宠,可在一般尺寸与放大尺寸之间切换。
5、如果 DSH Web 内置桌宠 @linxin666/dsh-pet 也显示在右下角,两者可能在视觉上重叠。它们在 API 层互不冲突,可以择一显示或拖开内置桌宠。
兼容性¶
| 插件版本 | 需要的 DeepSeek Harness |
|---|---|
| 0.2.0 | 0.1.2-alpha.1(含)以后 |
| 0.1.1 | 0.1.0-rc.6 ~ 0.1.1-rc.2 |
适用场景与注意¶
- 适合在 DeepSeek Harness Web UI 中加入一个状态可见、可点击、不侵入数据的桌宠。
- 它不读取或写入对话内容,不修改 Session 数据、对话记录或核心源码。
- 它是社群非官方项目,采用 MIT License;安装前建议检查源码与许可证。
- 插件以当前
dsh进程权限运行,安装前应确认插件来源可信。 - DSH 社区目录是独立站点,不等同于官方应用商店;当前资料未确认固定目录页 URL,建议在社区目录中按
dsh-deepseek-girl-pet检索。
结尾¶
dsh-deepseek-girl-pet 把 Session 状态变成右下角的动画提示:空闲时拿板子待机,执行任务时切换工作动画,等待交互时切换等待动画,还能进行 16 方向追视和点击放大。对于想把 Web UI 反馈做得更直观、同时不希望插件触碰对话内容的人来说,它是一个基于 DSH 插件机制的轻量选择。
GitHub:https://github.com/f0909172434/dsh-deepseek-girl-pet
目录页:DSH 社区目录中按 dsh-deepseek-girl-pet 检索。