deepseek-harness-pets

让 DeepSeek Harness 的状态动起来——官方原生 dsh 桌宠插件。

本项目是一个符合 DeepSeek Harness (dsh) 官方原生安装要求的插件：按官方 bundle/profile 机制安装后，一只鲸鱼（官方 DeepSeek Whale SVG，v0.2 艺术层）会常驻 DSH Web UI 的右下角悬浮窗（shell.overlay 插槽，不占用聊天流），随你的评测与回合状态实时换动作、弹气泡——像 Codex 桌宠一样，但零外部依赖。

宠物可通过 cordis.yml 一行配置切换或随机；宠物资产采用 Petdex 标准格式（pet.json + 8×9 spritesheet），将来可直接复用到 Petdex 桌面悬浮端或提交到 petdex.dev 社区画廊。

效果演示：（待像素图就绪后补 GIF——见 皮肤创作指南）

---

免责声明：本项目是社区驱动的非官方项目，与 DeepSeek（深度求索）无隶属关系。"DeepSeek" 是 DeepSeek AI 的注册商标，此处仅作主题致敬。

包名区分：dsh 官方为 npm 包 @deepseek-ai/dsh（Node.js）。PyPI 上的 deepseek-harness 是与本插件无关的第三方 Python 库，安装时请勿混淆。

核心特性

• 官方原生安装：标准 dsh bundle（package.json 的 dsh.bundle.patch + cordis.patch.yml），无 fork、无补丁宿主。
• 右下角常驻悬浮窗：宠物浮在 Web UI 右下角（shell.overlay root 域插槽，跨会话常驻，不占聊天流），基于官方 DeepSeek 鲸鱼 SVG，随回合状态实时换 CSS 动画。
• 拟真互动四项：点击（跃起 + 随机开心文案，~1.5s 回落）、悬停（放大微倾 + 气泡"嗯？"）、随机闲置（idle 时每 20–60s 一次 3s 小动作）、拖拽（自由摆放、clamp 视口内、localStorage 位置持久化，刷新不丢）。
• 状态实时映射：dsh durable session 事件（turn/step/tool）驱动宠物状态机，评测跑分过程一眼可读。
• 彩蛋触发：评测完成弹 Score 气泡、跃出水面；检测到 SOTA 特征（v0.1 为文本近似判定）触发限定动画。
• 宠物切换 / 随机：默认出场是 DeepSeek 标志性大鲸鱼 deepseek-whale；可在 ~/.dsh/settings.yaml（用户设置层）或 profile patch（base 层）换成 random（按 turn id 种子确定性选择，重放一致）或三源发现的任意皮肤；设置面板选择行开发中（见 Roadmap）。注：v0.2 悬浮窗艺术层统一渲染鲸鱼 SVG，其他皮肤的专属视觉待 spritesheet 就绪（见 Roadmap）。
• 皮肤源优先级：自定义源 > Petdex 社区源 > 内置源——同名皮肤高优先源覆盖，你的自定义皮肤永远赢。
• Petdex 资产兼容：像素资产即标准 Petdex 宠物包，可 npx petdex submit 上架社区画廊。

宠物状态映射

三层契约：dsh 事件信号 → 插件语义状态 → 悬浮窗 CSS 动画 + 气泡（Petdex 动画行作为 spritesheet 就绪后的资产契约保留）。机器可读版见 mappings/harness-states.json。