前言¶
在 DeepSeek Harness Web UI 里长时间跑 Session 时，界面往往只有任务状态与对话区，缺少对「当前是否在跑、是否在等交互」的直观反馈。用 DOM 扫描或自制浮层猜状态，维护成本高，Harness 升级后也容易失效。下面介绍社区维护的 Cordis 桌宠插件 dsh-deepseek-girl-pet：挂在官方 shell.overlay 槽位，直接读 Harness 提供的 Session 与等待交互 snapshot，在右下角用精灵图动画反映状态，并支持鼠标追视。
这是什么¶
dsh-deepseek-girl-pet（deepseek娘）是由 Chih-Kai-Wang 维护的开源 Cordis 桌宠外挂，面向 DeepSeek Harness Web UI。简介为：Animated deepseek girl desktop pet plugin for DeepSeek Harness。在 SkillHub 目录中归类为「趣味换装」。它是社群非官方插件，不修改 Session 数据、对话记录或 Harness 核心源码，也不读取或写入对话内容。
核心功能¶
桌宠固定在界面右下角，行为与 Harness 状态绑定，主要包括：
- Cordis 原生挂载：注册
shell.overlay扩展槽；Host 在/deepseek-girl-pet/spritesheet.webp提供固定 WebP 图集（Codex pet v2：1536×2288，8×11 格，每格 192×208）。 - Session 状态动画：Idle 时持写有简体「区」的板子，对话框字为「凶」；Running 时切换工作动画；Pending interaction 时切换等待动画。状态来自
useSessions的 Session summary 与useSessionPendingInteraction的等待交互 snapshot，不靠扫 DOM 猜状态。 - 鼠标追视：按 16 个方向（每 22.5° 一格）跟随指针；停止约 1.1 秒后回到待机动画。
- 交互与无障碍：单击在一般与放大尺寸间切换；支持
prefers-reduced-motion。 - 资源与隐私：不依赖外部 CDN 或跟踪服务；图集随包分发，运行时不下载图集。
| Harness 状态 | 桌宠表现 |
|---|---|
| Idle | 拿「区」板子待机，对话框「凶」 |
| Running | 工作动画 |
| Pending interaction | 等待互动动画 |
| Pointer movement | 16 方向追视 |
安装与启用¶
当前资料中的推荐版本为 0.2.0，对应 DeepSeek Harness 来源界面 0.1.2-alpha.1（更高 Harness 版本待验证）。插件以当前 dsh 进程权限运行，安装前可在 GitHub 查阅源码与 MIT License。
一行安装（web profile）¶
在 PowerShell 中执行：
dsh plugin --profile web add github:Chih-Kai-Wang/dsh-deepseek-girl-pet#v0.2.0
安装后需重启 Harness：在原执行 dsh web 的窗口按 Ctrl+C，确认 3080 已停止，再执行：
dsh web
若出现 EADDRINUSE: address already in use 127.0.0.1:3080，表示旧进程仍在，并非安装失败；先 Ctrl+C 停掉旧进程，再 dsh web，浏览器中 Ctrl+F5 强制刷新。
若安装时出现 Issues with peer dependencies found，应对照列出的套件与版本，不要默认与本插件无关。出现 Done 只表示包管理步骤完成，建议用下列命令确认配置后再看画面：
dsh --profile web --dump-config | Select-String deepseek-girl-pet
然后打开 http://127.0.0.1:3080/。
固定版本 TGZ 与 SHA-256 见 v0.2.0 Release。
典型用法¶
安装并重启后，桌宠会自动出现在 Web UI 右下角，无需额外配置文件字段。使用方式即日常 Harness 操作：待机、执行任务、进入等待用户交互时，观察动画是否与上表一致；移动鼠标可验证追视，停止约 1.1 秒应回到持板待机；单击桌宠可在大小尺寸间切换。
若同时安装了 dsh-web 全家桶，内置桌宠 @linxin666/dsh-pet 默认也在右下角，两只可能重叠。两者 API 层不冲突：可在「Web 插件 → 桌宠」中隐藏内置桌宠，或拖开其一，与本插件择一显示即可。维护者曾用 cordis-plugin-include 与 dsh-base、dsh-web-app、@linxin666/dsh-web-all、本插件及 dsh-plugin-verified-search 做叠层组合验证，无重复 id 与路由冲突记录。
适用场景与注意¶
适合希望在 Harness Web 界面获得轻量、状态驱动的桌宠反馈、又不愿改核心或猜 DOM 的开发者。需注意：
- 版本对应：0.2.0 针对 Harness
0.1.2-alpha.1起改用dsh-client-ui-renderer/dsh-client-ui-session与独立useSessionPendingInteraction；旧版 0.1.1 对应 Harness0.1.0-rc.6～0.1.1-rc.2。 - 与内置桌宠：同屏可能重叠，按上文择一或隐藏即可。
- 安全与许可：非 DeepSeek / OpenAI / Codex 官方产品；安装前自行审阅仓库与 MIT 许可。
延伸阅读¶
- 插件目录：SkillHub - dsh-deepseek-girl-pet
- 源码与说明：GitHub - Chih-Kai-Wang/dsh-deepseek-girl-pet
- 图集上游：deepseek-girl-codex-pet
经过上面的步骤，你可以在 Web profile 下用一行命令挂上桌宠，用官方状态源驱动动画，而不碰 Session 内容与核心代码。
