minybear/DeepSeek-Harness-Pet

README 摘要

@minybear/dsh-pet Codex 风格的「桌面宠物」DSH 客户端插件：在 DeepSeek Harness（DSH）Web GUI 里漂浮一只动画小宠物，由当前会话的 agent 运行状态 实时驱动（工作 / 等待输入 / 报错 / 刚完成 / 待机）。 复刻对象：OpenAI Codex 桌面版的 Pets 功能。调研结论见 docs/Codex-Pet-能力分析.md 与 docs/复刻方案.md 。 能力 - 漂浮宠物 ：注册进 DSH 的 shell.overlay 槽（帧级浮动层，可点透，右下角常驻）。 - 状态驱动 ：读当前会话状态并映射到 Codex 的 9 状态动画行： DSH 信号 宠物状态（行） 状态标签 running === true running（7） Working pendingInteraction waiting（6） Needs input lastAgentError failed（5） Blocked running true→false 边沿 jumping（4） Done!（约 2.6s） completed 且未选 review（8） Ready 无活动 idle（0） （无） - 交互 ： - 点击 → 弹出菜单：🍗 喂食（ eat ）、🎾 玩耍（ play ）、⚙ 尺寸/透明度设置。 - 拖拽 → 移动宠物位置（ drag 姿态，位置持久化到 localStorage）。 - 外观设置 ：尺寸（0.5–1.5）、透明度（0.2–1），持久化到 localStorage 。 - Codex 兼容包格式 ：宠物由 pet.json （ id/displayName/description/spritesheetPath/frame/animations ）+ 一张 行优先图集 （无独立 atlas 文件，帧索引 index = row×columns + col ）描述；内置默认宠物在运行时用 canvas 生成。前 9 行为 Codex V1 官方 9 状态，第 9–11 行为交互状态（eat/play/drag），经官方 frame 覆写（96×104×8×12）与 animations 字段声明。 结构 测试 安装到 DSH 然后重启 dsh web 并刷新页面，宠物应出现在右下角。离线环境或无需 pnpm 时，用 deploy\install.ps1 手动装；完整步骤见 INSTALL.md 。 注：客户端插件需宿主端打包（ dsh.client.inject ）与重启后生效。

分类