levi52/dsh-pet

README 摘要

🐾 DeepSeek Harness 桌宠插件 Codex 风格的桌面宠物：内嵌 DSH Web 界面，跟着 Agent 实时状态播放动画，设置页里可视化配置精灵图与节奏。 English · 中文 特性 - 🏠 内嵌 3080 页面 ：通过官方 webServer.tapIndex 注入浮层，桌宠与 dsh 同源同页、一起出现一起消失 - 🎬 真实事件驱动 ：订阅根 context 的 session/event ，按 turn/start 、 tool/call 、 turn/end 等切换待机 / 思考 / 执行 / 等待 / 完成 / 失败动画 - 🖼️ 精灵图即配置 ：网格布局与状态→行映射由配置声明（ config.sprite 或同名 .json 侧车文件），渲染器运行时拉取， 换图无需改源码 - ⚙️ 设置页管理 ：dsh 设置页「桌宠」分区可视化配置——上传/选择精灵图、网格、状态映射、缩放、动画速度、待机延迟、显隐 - ⚡ 改动实时生效 ：配置经 SSE config 事件热推给渲染器，缩放、动画速度、待机延迟调整即时生效，无需刷新或重启 - 💾 自动持久化 ：所有设置保存到 pet/user-config.json ，刷新后自动恢复，优先级高于 cordis.patch.yml - 🪟 多形态呈现 ：除内嵌浮层外，还提供独立弹窗页、Chrome app 无边框窗、pywebview 透明窗（可打包 .exe）、Electron 四种用法 安装 环境要求 - DeepSeek Harness（ dsh CLI）已安装并运行过 Web profile - Node.js ≥ 18 安装步骤 启动后打开 dsh 的 Web 地址（终端会打印，通常 http://127.0.0.1:3080/ ），右下角出现桌宠；管理入口在 设置 → 桌宠 。 卸载 纯客户端改动（精灵图、缩放、动画速度等设置）只需 强制刷新浏览器 ；宿主侧改动（ index.js 的路由/逻辑）需要重启 dsh。 界面说明 管理面板位于 dsh 设置页的「桌宠」分区（ settings.section 槽），各区域功能如下： 区域 说明 启用 桌宠显示开关，即时生效（关闭后浮层立即隐藏） 精灵图 预览当前图；「上传图片」从本地选任意精灵图（webp / png / gif / jpg / svg），自动存入 pet/uploads/ ；已上传图可删除；「默认（哆啦A梦）」固定切回内置图 网格 列数 / 行数。精灵图按 列 × 行 等分，每行是一种状态动画 状态 → 行映射 为 idle / thinking / working / waiting / failed / completed 各指定精灵图行号（0 起） 外观与节奏 缩放（0.5×–3×）、动画速度（0…

分类