skr311/dsh-codex-pet
50Last commit Aug 14, 2026
dsh-codex-pet DSH plugin
dsh-codex-pet adds a sprite sheet pet to the DSH Web GUI. It supports sequence frame playback, drag-and-drop, click interactions, and automatic animation based on the DSH Agent's state. The pet is rendered as a floating overlay in the bottom-right corner and can be managed via a settings page.
How to install the dsh-codex-pet DSH plugin
dsh plugin --profile web add dsh-codex-petCopying does not run this command. Review the repository and version before installing the dsh-codex-pet DSH plugin.
dsh-codex-pet DSH plugin data source
dsh-codex-pet DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-codex-pet DSH plugin can do
- Play sprite sheet animations (single WebP with rows for idle, running, waiting, review, failed, move, wave, jump).
- Floating overlay with draggable positioning, viewport clamp, and persistent position storage.
- Pet gallery management: upload zip, import from URL, enable/disable/delete, and preview first frame.
- Agent state integration: running on working, pulse on waiting, triumph on success, sadness on failure.
- Automatic theme adaptation via DSW tokens (light/dark).
Where the dsh-codex-pet DSH plugin fits
- Add a fun desktop pet to the DSH Web GUI for visual enjoyment.
- Monitor Agent status indirectly through pet animations without checking the main interface.
- Customize the pet appearance by uploading or importing custom sprite sheets.
- Use the pet as a subtle attention indicator when the Agent is waiting for user input.
- Enhance the DSH UI with a retro Codex-style pet for a nostalgic feel.
Who the dsh-codex-pet DSH plugin is for
- DSH users who want a more playful and interactive interface.
- Developers who enjoy desktop pets or virtual character interactions.
dsh-codex-pet DSH plugin limitations
- Only supports the specific WebP sprite sheet format (Format A) as described in the asset spec.
- Requires the DSH Web GUI environment and host-side changes need a restart to take effect.
- The repository does not include sample sprite sheets; users must provide or generate their own.
- Test scripts use runtime-synthesized WebP, not real artwork.
dsh-codex-pet DSH plugin: from the repository README
Quoted from the skr311/dsh-codex-pet README, the upstream source of the dsh-codex-pet DSH plugin. Copyright remains with the original authors.
DeepSeek Harness（DSH）桌面宠物插件：导入/上传 codex 风格的**精灵图序列帧宠物**，在 DSH Web GUI 以 `shell.overlay` 悬浮浮层渲染，含图库管理、基础交互与 Agent 状态联动。 [](https://awesome-dsh-plugin.com) [](https://www.npmjs.com/package/dsh-codex-pet) [](LICENSE) ## 📸 预览 <!-- 截图占位 ①：WebUI 页 —— 宠物浮层显示在 DSH Web GUI 右下角（放一张 1280×800 截图） -->  <!-- 截图占位 ②：设置页 —— 宠物图库（列表 / 上传 / 启用 / 停用 / 删除 / URL 导入） -->  ## ✨ 核心特性 - **序列帧播放**：单 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 干活时宠物跑动；等你
Read the full READMERepository license: MIT
dsh-codex-pet DSH plugin questions
How do I install dsh-codex-pet?
Run the command `dsh plugin --profile web add dsh-codex-pet` in your terminal. After installation, restart the DSH Web GUI (host-side changes require a restart) and refresh the page. Alternatively, you can clone the repository and use the local path with the same command.
My pet is not showing up after installation. What should I do?
First, make sure you have restarted the DSH Web GUI after installing the plugin. Then go to Settings → Pet Gallery, upload or import a pet sprite sheet (zip file or URL), and click 'Enable' to activate the pet. If the pet still doesn't appear, check your browser console for errors or ensure the sprite sheet format matches the specification (single WebP with rows for each animation).
Can I use my own sprite sheet images?
Yes, you can upload your own sprite sheet via the Settings → Pet Gallery page. The sprite sheet must be a single WebP image with rows corresponding to the supported animations: idle, running, waiting, review, failed, move, wave, jump. Each row should contain frames with equal duration. See the asset specification (docs/asset-spec.md) for exact format requirements.
Does the pet work with the DSH Agent's state?
Yes, the pet subscribes to DSH session state changes. When the Agent is working, the pet runs in place; when it's waiting for input (approval/question), the pet does a waiting pulse once; when a task completes successfully, the pet shows a triumphant animation; when a task fails, it shows a sad animation. You can see these effects without any extra configuration.
How can I remove or disable the pet?
Go to Settings → Pet Gallery, and click the 'Disable' button for the active pet. This will hide the floating overlay. To completely remove the plugin, you can use `dsh plugin --profile web remove dsh-codex-pet` and restart the DSH Web GUI.