f0909172434/dsh-deepseek-girl-pet

deepseek娘 DeepSeek Harness 桌宠

一个供 DeepSeek Harness Web UI 使用的开源 Cordis 桌宠插件。她会待在界面右下角，根据当前 Session 状态切换动画，也会用 16 个方向跟随鼠标注视。

实际在 DeepSeek Harness 中使用的画面：

deepseek娘在 DeepSeek Harness 中待机、追视与放大

这是社区制作的非官方插件，不会修改 Session 数据、对话记录或 DeepSeek Harness 核心源代码。

功能

- DeepSeek Harness 原生 Cordis 插件与 shell.overlay 扩展槽
- 待机时拿着简体「区」的板子，对话框文字维持「凶」
- Harness 执行任务时切换至工作动画
- Session 等待交互时切换至等待动画
- 完整 16 方向鼠标追视，每 22.5 度一格
- 鼠标停止 1.1 秒后回到拿板子的待机动画
- 点击桌宠可在一般与放大尺寸间切换
- 支持 prefers-reduced-motion
- Codex pet v2 图集：1536 × 2288 WebP、8 × 11、每格 192 × 208

兼容性

| 插件版本 | 需要的 DeepSeek Harness |
|---|---|
| 0.2.0 | 0.1.2-alpha.1 的源接口；更高版本待验证 |
| 0.1.1 | 0.1.0-rc.6 ～ 0.1.1-rc.2 |

0.2.0 起改用 dsh-client-ui-renderer／dsh-client-ui-session 获取 slots 与 Session 状态，并改读独立的 useSessionPendingInteraction snapshot——官方在 0.1.2-alpha.1 移除了旧的 dsh-client-runtime 包，并把 pending interaction 从 session summary 移到独立的 snapshot map。

桌宠与其他 web profile 插件可以同时安装。已用官方 cordis-plugin-include 对 dsh-base + dsh-web-app + @linxin666/dsh-web-all（dsh-web 全家桶）+ 本插件 + dsh-plugin-verified-search 的五层叠加做过组合验证：169 个 entries、零重复 id、零缺漏、零警告；dsh-web 各套件的 HTTP 路由也与本插件的 spritesheet 路由无碰撞。

注意：dsh-web 内置桌宠（@linxin666/dsh-pet）默认出现在右下角（可拖拽、可在「Web 插件 → 桌宠」设置隐藏），与本桌宠的默认位置会有视觉重叠；两者 API 层互不冲突，择一显示或拖开即可。

固定版本下载

0.2.0 TGZ 与 SHA-256 · 重现、验证与还原

安装

一行安装

dsh plugin --profile web add github:f0909172434/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，代表旧的 Harness 还在执行，不是安装失败。请先回到原本的 Harness 终端按 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/。

从源代码安装

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

状态映射

| Harness 状态 | 桌宠表现 |
|---|---|
| Idle | 拿着「区」板子待机，对话框显示「凶」 |
| Running | 工作动画 |
| Pending interaction | 等待交互动画 |
| Pointer movement | 16 方向追视 |

插件直接读取 Harness 的官方状态来源——useSessions 的 Session summary（待机／工作）与 useSessionPendingInteraction 的等待交互 snapshot（等待）——不会用脆弱的 DOM 文字扫描猜测状态。

技术方式

- Host plugin 只在 /deepseek-girl-pet/spritesheet.webp 提供固定 WebP 图集
- Client plugin 只注册 shell.overlay slot
- 不修改 DeepSeek Harness 核心文件
- 不读取或写入对话内容
- 不依赖外部 CDN 或追踪服务

验证

新增的封装校验与 CI 范围见 RELEASE.md。以下图集与宿主画面是既有记录，没有因打包更新而重新宣称为新的宿主实测。

- node --check lib/index.js
- node --check lib/client.js
- Hatch Pet 确定性 v2 图集验证：PASS
- 图集 SHA-256：234F24A97C18195A00C6093DA0090773E675993C169E92E7E13A24C37B323FA2
- DeepSeek Harness 首页、client module 与 spritesheet route：HTTP 200

授权与声明

本项目采用 MIT License。

这是社群制作的非官方项目，与 DeepSeek、OpenAI 或 Codex 没有从属、合作或背书关系。DeepSeek、Codex 与相关名称及标志仍属其各自权利人所有。

共用图集来源

图集的唯一维护来源是 Codex pet 的 pet/spritesheet.webp。本套件保留经 hash 核对的副本，执行时不下載图集；host adapter 与安装入口各自保留。完整 commit、路径、SHA-256 与大小在 atlas-source.json。

npm run atlas:check
node scripts/sync-atlas.mjs --source ../deepseek-girl-codex-pet
或从 manifest 指定的完整 commit 下载（需要网络）：
node scripts/sync-atlas.mjs --download
npm test

更新图集时，先在 Codex 来源完成 QA，再明确更新 manifest 的 commit/hash/大小与 SHA256SUMS，同步后跑测试。旧的 v0.2.0 release 保留原始 bytes；目前 main 的来源追踪工具不代表新的 host 功能版本。