dsh-pet

1. 安装并启动 DeepSeek Harness：npx @deepseek-ai/dsh web
2. 在终端执行上面的安装命令（CLI 会解析插件并核验来源）
3. 用 dsh plugins list 确认已安装，必要时重启 Harness 生效

插件以当前 dsh 进程的权限运行，安装时可能执行代码。请先通读仓库源码与许可证，确认无破坏性命令与越权访问；本站只做索引，不对第三方插件安全性作担保。

事实信息来自公开插件目录快照（2026-10-03），介绍文案由本站再加工。

以下为插件仓库 README 全文（原始内容，由公开目录抓取整理）。

[图片: 小齐 演示]

🫶 DSH-Pet · 小齐

住在 DeepSeek Harness 网页终端里的 AI Agent 桌宠
你写代码，她陪着你——思考、工作、等你确认、为你庆祝 🎉

  [图片: license]

  [图片: platform]

  [图片: version]

  [图片: stars]

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

```powershell
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（审批 / 结构化提问） | 🙋 等待确认 → 播「快来确认」 |

> ⚠️ 插件只观察状态，**绝不干预任何审批决定**。

## 🧹 卸载

```powershell
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 历史

[![Star History Chart](https://api.star-history.com/svg?repos=Zhoujiajia824/DSH-pet&type=Date)](https://star-history.com/#Zhoujiajia824/DSH-pet&Date)

## 📄 许可证

[MIT](./LICENSE) © 2025 XiaoQi Pet Contributors