xiaoqi-pet
A draggable AI-agent companion pet for the DeepSeek Harness web terminal: reacts to agent states and speaks on approval and completion.
AI 분석
核心用途是为 DSH 网页端引入一个互动的虚拟桌宠伙伴。适合希望在编写代码或等待 AI 思考时有桌宠陪伴、增加趣味性的用户。
설치
검증된 bundle이 없거나 호환성 검사에 실패했습니다. 먼저 저장소 설명을 읽어 주세요. 전체 README 읽기 ↗

🫶 DSH-Pet · 小齐
住在 DeepSeek Harness 网页终端里的 AI Agent 桌宠 你写代码,她陪着你——思考、工作、等你确认、为你庆祝 🎉
A draggable AI-agent companion pet that lives in the DeepSeek Harness web terminal — reacts to agent states, waves when confirmation is needed, cheers when the task is done.
✨ 她能做什么
- 🐾 实时陪伴:随 Agent 状态切换六种姿态——思考 🤔 · 工作 💻 · 等待确认 🙋 · 任务完成 🎉 · 出错 😟 · 待机 😌
- 🔊 会说话:需要确认时播「快来确认」,任务完成时播「任务完成啦」
- 🖱️ 可拖动:任意摆放,位置自动记忆(localStorage)
- 🎨 可换装:替换一张图集 + 两段录音,秒变你的专属桌宠
- 🧩 原生插件:直接装进 DeepSeek Harness 网页终端,无需额外窗口、无需 API key
🚀 快速开始
需要:DeepSeek Harness(网页模式)+ Node.js
git clone git@github.com:Zhoujiajia824/DSH-pet.git
cd DSH-pet
node scripts/install.cjs
# 完全重启 DeepSeek Harness —— 右下角见 💙
桌宠工具栏:♫ 静音 · ▶ 预览完整工作流程 · − 隐藏 · 按住拖动改变位置。
🎨 换成你的专属形象 / 声音
仓库自带示例素材(角色图集 + 两段语音),直接替换同名文件即可:
| 文件 | 用途 |
|---|---|
assets/private/companion-atlas.png | 角色图集:RGBA 透明 PNG,3×2 方格,顺序 idle / thinking / working / waiting / done / error |
mp3/任务完成.mp3 | 完成语音 |
mp3/快来确认.mp3 | 等待确认语音 |
详见 assets/README.md、mp3/README.md。
🧠 工作原理
Host 半部分监听 DeepSeek Harness 内部事件,浏览器半部分在 shell.overlay 层渲染桌宠:
| 信号 | 桌宠状态 |
|---|---|
api-session/activity(用户提交消息) | 🤔 思考 |
api-session/status running=true / tools/pre-execute | 💻 工作 |
api-session/status running=false(轮次结束) | 🎉 完成 → 播「任务完成啦」 |
api-session/error | 😟 出错 |
| 浏览器 pending interaction(审批 / 结构化提问) | 🙋 等待确认 → 播「快来确认」 |
⚠️ 插件只观察状态,绝不干预任何审批决定。
🧹 卸载
node scripts/install.cjs --remove
# 再完全重启 DeepSeek Harness
❓ FAQ
- 听不到声音? 浏览器自动播放策略:页面加载后先点一下页面任意处即可解锁。
- 没有形象 / 语音? 检查
assets/private/与mp3/下的文件是否齐全;缺失时桌宠只是无图 / 无声,功能不受影响。 - 安装后没出现? 必须完全重启 DeepSeek Harness(只刷新页面不够)。
- 会不会影响审批? 不会。插件从不修改、拒绝或批准任何请求。
📁 目录结构
├── lib/index.js # Host 半部分(事件监听 + 素材/状态 HTTP 路由)
├── lib/client.js # 浏览器半部分(桌宠 UI、拖动、语音)
├── scripts/install.cjs # 安装 / 卸载
├── assets/private/ # 角色图集
├── mp3/ # 语音
├── docs/pet-demo.gif # 演示动图
└── test/plugin.test.cjs # 无浏览器冒烟测试
🤝 贡献
欢迎 issue 与 PR(模板见 .github/)。改动后跑一下 node test/plugin.test.cjs 即可。
⭐ Star 历史
📄 许可证
MIT © 2025 XiaoQi Pet Contributors