DSH Minecraft Pet · DSH 我的世界桌面宠物

一个运行在 DeepSeek Harness (DSH) Web GUI 右下角的 Minecraft 主题桌面宠物——史蒂夫（Steve）、苦力怕（Creeper）与奥特曼（Ultraman），根据当前 Agent 的工作状态实时切换动作，并在任务完成时播放专属音效。

A Minecraft-themed desktop pet in the bottom-right corner of the DSH Web GUI — Steve, Creeper and Ultraman react to the agent's working status with animations and per-pet completion sounds.

特性 Features

🐾 三只宠物

宠物	说明	皮肤
⛏ 史蒂夫 Steve	左手拿钻石镐，像素画	普通 / 钻石甲
💥 苦力怕 Creeper	侧视四腿，像素画	—
🦸 奥特曼 Ultraman	SVG 矢量，红银条纹	初代 / 赛文 / 泰罗 / 迪迦 / 泽塔

🎬 三态动作

状态	动作
待机 idle	轻微上下浮动
工作 working	史蒂夫挥镐、奥特曼出拳 + 踏步、苦力怕渐进变红膨胀（蓄力）
完成 completed	专属必杀 + 音效

✨ 完成专属必杀

宠物	必杀	音效
史蒂夫	跳跃 + 矿石掉落粒子	「叮叮」上行琶音
苦力怕	爆炸光球 + 火光粒子	「嘶嘶 → Boom」
奥特曼·初代	斯派修姆光线（蓝白光）	变身英雄登场
奥特曼·赛文	冰斧投掷（旋转飞出 + 命中闪光）	变身英雄登场
奥特曼·泰罗	斯特利姆光线（五彩光束）	变身英雄登场
奥特曼·迪迦	哉佩利敖光线（双手十字 + 紫光）	变身英雄登场
奥特曼·泽塔	泽斯蒂姆光线（双手并拢 + 蓝光）	变身英雄登场

🖱 交互

操作	效果
左键点击	切换宠物（史蒂夫 → 苦力怕 → 奥特曼）
右键点击	打开 / 关闭设置菜单
拖拽	移动宠物
菜单内	切换皮肤、四角定位、试听音效、静音、复位、隐藏

目录结构

dsh-minecraft-pet/
├── README.md
├── LICENSE
├── package.json
├── .gitignore
├── src/                       # 动态插件形态（临时运行，重启消失）
│   ├── host.js        # Host 半：Agent 状态跟踪 + Client 私有 RPC
│   └── client.js      # Client 半：宠物 UI / 动画 / 音效 / 交互
├── plugin/                    # 正式插件形态（随 DSH 启动自动加载，推荐）
│   ├── package.json   # dsh.client 声明：lib/client.js 进入浏览器 boot 图
│   └── lib/
│       ├── index.js   # Host 半：agent/status 跟踪 + SSE 状态推送
│       └── client.js  # Client 半：CJS bundle，EventSource 订阅 + overlay UI
└── audio/
    ├── generate.js    # 音效生成脚本（8-bit PCM WAV 程序化合成）
    ├── steve.wav
    ├── ultraman.wav
    └── creeper.wav

截图 / 演示 Screenshots

史蒂夫 Steve

更多宠物（苦力怕 / 奥特曼）与三态动作（待机 / 工作 / 完成）的动图可继续补充到 assets/ 目录。

如何安装 Install

环境要求

DeepSeek Harness (DSH) Web GUI（支持 Cordis 动态插件）
可选：Node.js ≥ 14（用于运行 npm run audio 重新生成音效交付物）

本插件有两种安装方式：

方式一：正式插件，随 DSH 启动自动加载（推荐）

把 plugin/ 目录安装到 DSH 的 profile 依赖里，并在 profile 的 patch 层追加一行即可； DSH 每次启动都会自动加载宠物，无需手动定义/运行。

# 1) 安装插件包（路径按你的 DSH_HOME / profile 调整）
$dst = "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-desktop-pet"
Copy-Item "plugin" $dst -Recurse

# 2) 在 $env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml 末尾追加：
#    - insert:
#        - id: desktop-pet
#          name: 'dsh-desktop-pet'

# 3) 重启 DSH（patch 在启动时应用）

两种形态行为一致（宠物、皮肤、音效、三态动画完全相同）；区别仅在于状态通道：动态插件用 get-status 私有 RPC 轮询，正式插件用 host 的 SSE 端点 /plugins/dsh-desktop-pet/events 实时推送。

方式二：Cordis 动态插件（临时体验，重启后消失）

本插件也是一个 Cordis 动态插件（Dynamic Cordis Plugin），由「Host 半」和「Client 半」组成。

在 DSH Web GUI 中，将 src/host.js 里 createHostHalf() 返回的 { ... } 作为 Host 代码（code.host），将 src/client.js 里 createClientHalf() 返回的 { ... } 作为 Client 代码（code.client）。
通过 cordis_define 定义插件，再用 cordis_run 激活。
首次使用前，在菜单里点一次「🔊 试听音效」以「预热」浏览器的音频自动播放。

这两个文件为了可读性被包装成了 module.exports 工厂函数；实际作为动态插件使用时，直接取函数体内 return { ... } 的部分即可（host.js / client.js 的 return 行到结尾大括号）。

注意：动态插件只存在于 DSH 进程内存中，重启后自动消失，需要重新定义。

技术实现 Implementation

状态来源（Host）：监听 agent/status 事件（idle ⇄ running），按 Agent id 精确计数，避免子代理干扰。
- 动态插件形态：通过 get-status 私有 RPC 边沿触发「已完成」。
- 正式插件形态：通过 webServer 注册 SSE 端点 /plugins/dsh-desktop-pet/events 实时推送三态与序号。
渲染（Client）：注册到 shell.overlay 槽位，用纯 React.createElement + 内联 SVG 绘制像素画/矢量宠物。
动画：注入 CSS keyframes（正式插件用 <style> 标签，动态插件用 styles.insert），对 SVG <g> 局部元素（镐子、手臂、腿）做 transform 动画。
音效：客户端没有 AudioContext/fetch/文件访问，因此用纯 JS 程序化合成 8-bit PCM WAV 数据 URI，渲染 <audio> 元素播放；audio/generate.js 用同一套合成算法生成可试听的 .wav 交付物。

常见问题 FAQ

音效不响？ 浏览器自动播放策略要求页面至少有过一次用户交互。先在菜单里点「🔊 试听音效」一次即可「预热」。
如何切换奥特曼皮肤？ 右键打开菜单，选中奥特曼后会出现「初代 / 赛文 / 泰罗 / 迪迦 / 泽塔」按钮。
宠物位置怎么复位？ 菜单里点「↺ 复位位置」，或直接拖拽到任意位置后用四角定位按钮重新固定。
想加新宠物 / 新皮肤？ 参考 src/client.js 里的 PETS、ULTRA_SKINS 与对应的 Art 渲染函数即可扩展，欢迎 PR。

贡献 Contributing

欢迎提交 Issue 和 Pull Request。

Fork 本仓库并克隆到本地。
修改 src/host.js / src/client.js（纯 JavaScript，无 TypeScript / JSX / 打包）。
保持代码风格一致，提交信息清晰。
推送到你的 fork，发起 Pull Request 到 main 分支。

致谢 Acknowledgments

Minecraft（© Mojang / Microsoft）—— 史蒂夫、苦力怕形象来源
奥特曼系列（© 圆谷制作株式会社 Tsuburaya Productions）—— 奥特曼形象与必杀技来源
DeepSeek Harness —— 运行平台

免责声明 Disclaimer

本项目仅用于学习与技术演示，为粉丝致敬性质，与 Mojang / Microsoft 及圆谷制作株式会社无关。

「Minecraft」「Steve」「Creeper」及相关形象版权归 Mojang / Microsoft 所有。
「奥特曼 / Ultraman」及相关角色、必杀技名称版权归 圆谷制作株式会社 所有。

本项目不包含任何官方素材、音频或图像资源；所有宠物造型均为代码绘制的原创近似风格，音效为程序化合成。请勿将本项目用于任何商业用途。

License

MIT

DSH Minecraft Pet · DSH 我的世界桌面宠物

A Minecraft-themed desktop pet in the bottom-right corner of the DSH Web GUI — Steve, Creeper and Ultraman react to the agent's working status with animations and per-pet completion sounds.

目录 Contents

特性 Features
目录结构
截图 / 演示 Screenshots
如何安装 Install
技术实现 Implementation
常见问题 FAQ
贡献 Contributing
致谢 Acknowledgments
免责声明 Disclaimer
License

特性 Features

🐾 三只宠物

宠物	说明	皮肤
⛏ 史蒂夫 Steve	左手拿钻石镐，像素画	普通 / 钻石甲
💥 苦力怕 Creeper	侧视四腿，像素画	—
🦸 奥特曼 Ultraman	SVG 矢量，红银条纹	初代 / 赛文 / 泰罗 / 迪迦 / 泽塔

🎬 三态动作

状态	动作
待机 idle	轻微上下浮动
工作 working	史蒂夫挥镐、奥特曼出拳 + 踏步、苦力怕渐进变红膨胀（蓄力）
完成 completed	专属必杀 + 音效

✨ 完成专属必杀

宠物	必杀	音效
史蒂夫	跳跃 + 矿石掉落粒子	「叮叮」上行琶音
苦力怕	爆炸光球 + 火光粒子	「嘶嘶 → Boom」
奥特曼·初代	斯派修姆光线（蓝白光）	变身英雄登场
奥特曼·赛文	冰斧投掷（旋转飞出 + 命中闪光）	变身英雄登场
奥特曼·泰罗	斯特利姆光线（五彩光束）	变身英雄登场
奥特曼·迪迦	哉佩利敖光线（双手十字 + 紫光）	变身英雄登场
奥特曼·泽塔	泽斯蒂姆光线（双手并拢 + 蓝光）	变身英雄登场

🖱 交互

操作	效果
左键点击	切换宠物（史蒂夫 → 苦力怕 → 奥特曼）
右键点击	打开 / 关闭设置菜单
拖拽	移动宠物
菜单内	切换皮肤、四角定位、试听音效、静音、复位、隐藏

目录结构

dsh-minecraft-pet/
├── README.md
├── LICENSE
├── package.json
├── .gitignore
├── src/                       # 动态插件形态（临时运行，重启消失）
│   ├── host.js        # Host 半：Agent 状态跟踪 + Client 私有 RPC
│   └── client.js      # Client 半：宠物 UI / 动画 / 音效 / 交互
├── plugin/                    # 正式插件形态（随 DSH 启动自动加载，推荐）
│   ├── package.json   # dsh.client 声明：lib/client.js 进入浏览器 boot 图
│   └── lib/
│       ├── index.js   # Host 半：agent/status 跟踪 + SSE 状态推送
│       └── client.js  # Client 半：CJS bundle，EventSource 订阅 + overlay UI
└── audio/
    ├── generate.js    # 音效生成脚本（8-bit PCM WAV 程序化合成）
    ├── steve.wav
    ├── ultraman.wav
    └── creeper.wav

截图 / 演示 Screenshots

史蒂夫 Steve

更多宠物（苦力怕 / 奥特曼）与三态动作（待机 / 工作 / 完成）的动图可继续补充到 assets/ 目录。

如何安装 Install

环境要求

DeepSeek Harness (DSH) Web GUI（支持 Cordis 动态插件）
可选：Node.js ≥ 14（用于运行 npm run audio 重新生成音效交付物）

本插件有两种安装方式：

方式一：正式插件，随 DSH 启动自动加载（推荐）

把 plugin/ 目录安装到 DSH 的 profile 依赖里，并在 profile 的 patch 层追加一行即可； DSH 每次启动都会自动加载宠物，无需手动定义/运行。

# 1) 安装插件包（路径按你的 DSH_HOME / profile 调整）
$dst = "$env:USERPROFILE\.dsh\profiles\node_modules\dsh-desktop-pet"
Copy-Item "plugin" $dst -Recurse

# 2) 在 $env:USERPROFILE\.dsh\profiles\web\cordis.patch.yml 末尾追加：
#    - insert:
#        - id: desktop-pet
#          name: 'dsh-desktop-pet'

# 3) 重启 DSH（patch 在启动时应用）

两种形态行为一致（宠物、皮肤、音效、三态动画完全相同）；区别仅在于状态通道：动态插件用 get-status 私有 RPC 轮询，正式插件用 host 的 SSE 端点 /plugins/dsh-desktop-pet/events 实时推送。

方式二：Cordis 动态插件（临时体验，重启后消失）

本插件也是一个 Cordis 动态插件（Dynamic Cordis Plugin），由「Host 半」和「Client 半」组成。

在 DSH Web GUI 中，将 src/host.js 里 createHostHalf() 返回的 { ... } 作为 Host 代码（code.host），将 src/client.js 里 createClientHalf() 返回的 { ... } 作为 Client 代码（code.client）。
通过 cordis_define 定义插件，再用 cordis_run 激活。
首次使用前，在菜单里点一次「🔊 试听音效」以「预热」浏览器的音频自动播放。

这两个文件为了可读性被包装成了 module.exports 工厂函数；实际作为动态插件使用时，直接取函数体内 return { ... } 的部分即可（host.js / client.js 的 return 行到结尾大括号）。

注意：动态插件只存在于 DSH 进程内存中，重启后自动消失，需要重新定义。

技术实现 Implementation

状态来源（Host）：监听 agent/status 事件（idle ⇄ running），按 Agent id 精确计数，避免子代理干扰。
- 动态插件形态：通过 get-status 私有 RPC 边沿触发「已完成」。
- 正式插件形态：通过 webServer 注册 SSE 端点 /plugins/dsh-desktop-pet/events 实时推送三态与序号。
渲染（Client）：注册到 shell.overlay 槽位，用纯 React.createElement + 内联 SVG 绘制像素画/矢量宠物。
动画：注入 CSS keyframes（正式插件用 <style> 标签，动态插件用 styles.insert），对 SVG <g> 局部元素（镐子、手臂、腿）做 transform 动画。
音效：客户端没有 AudioContext/fetch/文件访问，因此用纯 JS 程序化合成 8-bit PCM WAV 数据 URI，渲染 <audio> 元素播放；audio/generate.js 用同一套合成算法生成可试听的 .wav 交付物。

常见问题 FAQ

音效不响？ 浏览器自动播放策略要求页面至少有过一次用户交互。先在菜单里点「🔊 试听音效」一次即可「预热」。
如何切换奥特曼皮肤？ 右键打开菜单，选中奥特曼后会出现「初代 / 赛文 / 泰罗 / 迪迦 / 泽塔」按钮。
宠物位置怎么复位？ 菜单里点「↺ 复位位置」，或直接拖拽到任意位置后用四角定位按钮重新固定。
想加新宠物 / 新皮肤？ 参考 src/client.js 里的 PETS、ULTRA_SKINS 与对应的 Art 渲染函数即可扩展，欢迎 PR。

贡献 Contributing

欢迎提交 Issue 和 Pull Request。

Fork 本仓库并克隆到本地。
修改 src/host.js / src/client.js（纯 JavaScript，无 TypeScript / JSX / 打包）。
保持代码风格一致，提交信息清晰。
推送到你的 fork，发起 Pull Request 到 main 分支。

致谢 Acknowledgments

DeepSeek Harness —— 运行平台

免责声明 Disclaimer

本项目仅用于学习与技术演示，为粉丝致敬性质，与 Mojang / Microsoft 及圆谷制作株式会社无关。

「Minecraft」「Steve」「Creeper」及相关形象版权归 Mojang / Microsoft 所有。
「奥特曼 / Ultraman」及相关角色、必杀技名称版权归 圆谷制作株式会社 所有。

本项目不包含任何官方素材、音频或图像资源；所有宠物造型均为代码绘制的原创近似风格，音效为程序化合成。请勿将本项目用于任何商业用途。

License

MIT

dsh-minecraft-pet

DSH Minecraft Pet · DSH 我的世界桌面宠物

目录 Contents

特性 Features

🐾 三只宠物

🎬 三态动作

✨ 完成专属必杀

🖱 交互

目录结构

截图 / 演示 Screenshots

如何安装 Install

环境要求

方式一：正式插件，随 DSH 启动自动加载（推荐）

方式二：Cordis 动态插件（临时体验，重启后消失）

技术实现 Implementation

常见问题 FAQ

贡献 Contributing

致谢 Acknowledgments

免责声明 Disclaimer

License

Community comments

dsh-minecraft-pet

DSH Minecraft Pet · DSH 我的世界桌面宠物

目录 Contents

特性 Features

🐾 三只宠物

🎬 三态动作

✨ 完成专属必杀

🖱 交互

目录结构

截图 / 演示 Screenshots

如何安装 Install

环境要求

方式一：正式插件，随 DSH 启动自动加载（推荐）

方式二：Cordis 动态插件（临时体验，重启后消失）

技术实现 Implementation

常见问题 FAQ

贡献 Contributing

致谢 Acknowledgments

免责声明 Disclaimer

License

Community comments