小齐演示

🫶 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 即可。

xiaoqi-pet

安装

说明文档