zuodazuoqiang001/dsh-pet

README 摘要

dsh-pet 给 DSH (DeepSeek Harness) 用的 Windows 桌面宠物 插件。 复用 Codex 兼容宠物包（ pet.json + spritesheet.webp ），在桌面上显示透明置顶的分层窗口；会话运行、授权等待、完成后会在宠物头顶出气泡。宠物 只出现在桌面 ，不会注入 DSH 网页。 - 设置卡片 ：设置 → 插件 → 桌面宠物（开关、缩放、帧间隔、默认宠物） - Codex 宠物零转换 ：默认读 /.codex/pets 和 $DSH HOME/pets - 会话气泡 ：多个运行中会话可叠放，悬停展开；点击定位到已打开的 DSH 标签页 - 授权 / 完成提醒 ：只在宠物上提示，不弹 Windows 系统通知 目录 - 前置要求 - 安装 - 配置页 - 配置项 - 宠物格式 - 桌面交互 - HTTP 路由 - 卸载 - 文件结构 - 开发注意 前置要求 1. Windows 10/11，已安装 DSH，并用 dsh web 打开 Web GUI 2. 本机有 Codex 兼容宠物，放在 %USERPROFILE%\.codex\pets\ \ 3. 桌面悬浮窗需要 Windows PowerShell 5.1 （自带）。 desktop/dsh-pet-desktop.ps1 必须保持 UTF-8 带 BOM ，否则 param() 解析失败、开关打开也看不到窗口 安装 推荐：用 DSH 插件命令（会装依赖） 在插件目录外执行： 本地路径也可用 pnpm 的 file: 协议： 然后编辑 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml ，追加： 重启 DSH（自己启动 dsh web ），浏览器硬刷新。打开 设置 → 插件 ，应看到「桌面宠物」卡片。 备选：复制目录 把整个 dsh-pet 文件夹复制到： 目录名必须是 dsh-pet 。同样注册上面的 cordis.patch.yml 条目，并确保 profile 的 node modules 里能解析到 sharp 与 @deepseek-ai/schemastery （用 dsh plugin add 时会自动安装）。 配置页 设置 → 插件 → 展开「桌面宠物」： 项 说明 启动桌面宠物 卡片标题栏开关，打开即拉起桌面悬浮窗，关闭即退出。开关会立刻写入设置，不必点保存 桌面缩放 0.5～4，保存后立即生效 桌面动画每帧毫秒 30～1000，越小越快 默认宠物 桌面未手动选过宠物时使用；空 = 清单第一只 配置页保存写入 DSH 的 settings.yaml （ pet: 节），不必再改 cordis.patch.yml 。 配置项 cordis.patch.yml 的 config: 与设置页用户层叠加后生…

分类