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\<pet-id>\
3. 桌面悬浮窗需要 Windows PowerShell 5.1（自带）。desktop/dsh-pet-desktop.ps1 必须保持 UTF-8 带 BOM，否则 param() 解析失败、开关打开也看不到窗口

安装

推荐：用 DSH 插件命令（会装依赖）

在插件目录外执行：

dsh plugin --profile web add %CD%

本地路径也可用 pnpm 的 file: 协议：

dsh plugin --profile web add file:%CD%

然后编辑 %USERPROFILE%\.dsh\profiles\web\cordis.patch.yml，追加：

- insert:
    - id: pet
      name: 'dsh-pet'
      config:
        routeBase: /dsh-pet

重启 DSH（自己启动 dsh web），浏览器硬刷新。打开 设置 → 插件，应看到「桌面宠物」卡片。

备选：复制目录

把整个 dsh-pet 文件夹复制到：

%USERPROFILE%\.dsh\profiles\node_modules\dsh-pet\

目录名必须是 dsh-pet。同样注册上面的 cordis.patch.yml 条目，并确保 profile 的 node_modules 里能解析到 sharp 与 @deepseek-ai/schemastery（用 dsh plugin add 时会自动安装）。

配置页

设置 → 插件 → 展开「桌面宠物」：

配置页保存写入 DSH 的 settings.yaml（pet: 节），不必再改 cordis.patch.yml。

配置项

cordis.patch.yml 的 config: 与设置页用户层叠加后生效。

以下键仍可出现在旧配置里以免解码失败，但网页宠物已关闭，界面不再提供：inject、scale、position、frameMs。

宠物格式

一个宠物 = 一个文件夹：

<pet-id>/
├── pet.json
└── spritesheet.webp

pet.json 与 Codex 一致：id、displayName、description、spritesheetPath、kind。可选扩展字段 states 覆盖行映射。

图集默认 9 行 × 8 列，每格 192×208。第 0 行视为 idle。1～8 行因宠物包而异，可用 states / petStates 配置。未映射的状态回落到 idle。

桌面交互

• 拖动：向右播 running-right，向左播 running-left（与 Codex 相同）
• 鼠标移上：播一轮 thinking/happy，再回到待机/工作循环
• 左键单击：播一次 happy
• 右键：切换宠物 / 鼠标穿透 / 退出
• 托盘图标：右键同款菜单；关闭窗口即最小化到托盘
• 气泡：运行中会话、等待授权、已完成（约 60 秒，可点掉）。多会话折叠叠放，悬停展开。点击气泡会尽量激活已打开的 DSH 浏览器标签并定位会话，没有标签时才新开
• DSH 退出：桌面宠物一并退出（正常关闭或服务连不上约 4.5 秒后）
• 位置 / 所选宠物：保存在 $DSH_HOME/dsh-pet-desktop.json（默认 %USERPROFILE%\.dsh\dsh-pet-desktop.json）

需要 DSH 服务在运行（默认 http://127.0.0.1:3080）。手动调试：

powershell.exe -NoProfile -ExecutionPolicy Bypass -STA -File desktop\dsh-pet-desktop.ps1 -Scale 0.5 -FrameMs 300

信任与安全

本仓库按「可审计的开源插件」发布，不要求任何人「先信作者」。请用源码和运行范围自己核对。

别人怎么确认不是木马

1. 只从本 GitHub 仓库安装，不要用来路不明的 zip / 网盘包 / 已编译 exe。
2. 源码全部在仓库里：index.js、client/、desktop/*.ps1、desktop/*.cmd。没有加壳、没有混淆、没有闭源二进制。
3. 许可证是 MIT，允许阅读、修改、再分发。
4. 自己读再装：桌面窗是 Windows PowerShell + 公开的 Win32 API（分层窗口、托盘）。Host 插件只给本机 DSH 加 HTTP 路由和设置卡片。
5. 用 git 核对提交，不要执行你看不懂的额外脚本。

git clone https://github.com/zuodazuoqiang001/dsh-pet.git

它实际会做什么（也只做这些）

不收集遥测、不上传宠物或会话内容、不改系统服务、不读写浏览器密码。

为什么杀毒软件仍可能报警

火绒等「系统加固 / HIPS」会把这些 正常桌面程序手法 标成敏感：

• 启动 PowerShell 运行窗口脚本
• 运行时 Add-Type 调用 Win32（透明分层窗必须如此）
• 结束自己的悬浮窗进程

这是启发式误报，不是发现了木马样本。安装者若核对过源码，把插件目录加入信任区、在弹窗里允许即可。

请不要 为了「看起来不像木马」去加壳、混淆或绕过 AMSI——那才会让开源项目更像恶意软件。

长期若要让杀软更友好：把 desktop/*.ps1 收成可复现构建、带 Authenticode 签名的开源 WinExe，并发布校验和。在此之前，信任来自 可读源码，而不是「杀软没报」。

HTTP 路由

卸载

1. 设置卡片里关掉「启动桌面宠物」，或删除 cordis.patch.yml 中的 pet 条目
2. 删除 $DSH_HOME/profiles/node_modules/dsh-pet/（若用 dsh plugin 安装，也可用对应 remove）
3. 可选：清理 $DSH_HOME/settings.yaml 的 pet: 节，以及 $DSH_HOME/dsh-pet-desktop.json
4. 重启 DSH

文件结构

dsh-pet/
├── package.json              # dsh.plugin / dsh.client + exports
├── index.js                  # Host 插件：路由、设置命名空间、拉起桌面窗
├── client/
│   ├── settings-card.js      # 设置 → 插件 卡片（须 inject sessions）
│   ├── settings.html         # 旧版 /dsh-pet/settings 页
│   └── player.js             # 保留的网页播放器（默认不注入）
├── desktop/
│   ├── dsh-pet-desktop.cmd   # 手动启动器
│   └── dsh-pet-desktop.ps1   # 分层窗口实现（UTF-8 BOM）
├── README.md
└── LICENSE

开发注意

• 改 Host / 设置卡片后：重启 DSH，并硬刷新浏览器
• 只改 desktop/*.ps1：关掉桌面宠物再打开，或结束 dsh-pet-desktop 进程后重启
• 不要把 dsh-pet-desktop.ps1 存成无 BOM 的 UTF-8
• Cordis 浏览器插件必须 inject: ["slots", "settingsScope", "sessions"]，否则会 cannot get property "sessions" without inject
• 不要向 DSH 网页注入播放器（inject 固定为 false）

许可证

MIT