skr311/dsh-codex-pet

README 摘要

English · 简体中文 dsh-codex-pet DeepSeek Harness（DSH）桌面宠物插件：导入/上传 codex 风格的 精灵图序列帧宠物 ，在 DSH Web GUI 以 shell.overlay 悬浮浮层渲染，含图库管理、基础交互与 Agent 状态联动。 📸 预览 ✨ 核心特性 - 序列帧播放 ：单 WebP 精灵图（格式 A），逐帧毫秒时长，行=动画（idle / running / waiting / review / failed / 移动 / 挥手 / 跳跃）。 - 悬浮浮层交互 ：右下角常驻，可拖拽（视口钳制 + 位置持久化）、点击挥手、空闲随机小动作。 - 图库管理 ：设置 → 宠物图库——zip 上传 / URL 导入 / 启用 / 停用 / 删除 / 首帧预览。 - Agent 状态联动 ：订阅 DSH 会话状态——工作中→跑动（常驻）；审批/提问→等待（脉冲一次）；任务完成→得意（脉冲一次）；任务失败→沮丧（脉冲一次）。 - 深/浅主题 ：全部样式走 --dsw- 主题令牌，自动适配 DSH 主题。 🎮 操作指南 1. 打开 DSH Web GUI（默认 http://127.0.0.1:3080）。 2. 设置 → 宠物图库 → 上传/导入宠物 zip（或从 URL 导入）→ 点「启用」。 3. 右下角出现宠物浮层： - 拖拽 ：按住移动，松手后位置自动保存。 - 点击 ：宠物挥手。 - Agent 联动 ：Agent 干活时宠物跑动；等你确认/回答时发呆一次；任务完成得意一次；失败沮丧一次。 4. 想隐藏宠物：图库页点「停用宠物」。 📦 安装 方式一：pnpm（推荐） 方式二：GitHub clone 安装后 重启 DSH Web GUI （宿主半改动需重启；客户端 bundle 改完热更免重启），再刷新页面。 🛠️ 开发 - 项目结构 ： packages/dsh-codex-pet/ （宿主半 lib/index.js + pet-library.js ；客户端半 lib/client.js ；vendored lib/vendor/fflate.mjs ）。 - 测试 （零依赖，纯 Node + vendored fflate）： - 开发流程 ：客户端 bundle 改完 HMR 热更、免重启；宿主半改动需重启 DSH Web GUI。开发规范见 docs/development-spec.md ，工作指引见 AGENTS.md 。 - 参与贡献 ：见 CONTRIBUTING.md。 📚 文档 - docs/README.md：标准文件索引； AGENTS.md ：开发工作指引；docs/execution-steps.md：里程碑状态。 - 资产格式见 docs/asset-spec…

分类