前言¶
在 DeepSeek Harness（DSH）里跑 Agent，界面往往只有日志和状态文本。长时间盯屏时，「当前是在跑任务、等确认还是已经告一段落」需要你自己从文案里推断。若你希望在 Web GUI 里有一个不联网、不占后端资源的轻量反馈层，社区插件 mufanlee/dsh-pikachu-pet 提供了一种做法：在页面右下角常驻一只非官方粉丝向皮卡丘桌宠，动作与当前会话 Agent 状态对齐，并在适当时机播放叫声。
这是什么¶
dsh-pikachu-pet 是由维护者 mufanlee 发布的 DSH 桌宠插件（社区目录分类：趣味换装）。定位为「Unofficial fan-made Pikachu desktop pet plugin for the DeepSeek Harness Web GUI」——仅在浏览器端注入 UI，跟随会话状态切换姿势与音效，不替代 DSH 核心能力。
插件以 bundle 形式接入 Cordis 宿主：package.json 中 dsh.client 指向 Web 平台，并注入 @deepseek-ai/dsh-client-ui-layout 与 @deepseek-ai/dsh-client-ui-session。代码采用 MIT License；assets/ 与 icon.png 中的皮卡丘素材来自网络免费资源，仅供粉丝非官方用途，详见仓库 NOTICE。
核心功能¶
下面行为均来自仓库 README 中的状态表与说明。
与 Agent 状态联动¶
| 状态 | 反应 |
|---|---|
| 运行中 | 奔跑 / 跳跃，脸颊冒电火花 |
| 等待确认 | 举手跳，头顶「！」 |
| 一轮完成 | 欢呼 + 星光 + 随机叫声 |
| 空闲 90 秒 | 换睡姿趴下，头顶「Zzz」 |
任务完成时会播放「皮卡皮卡」类叫声。插件共 8 张姿势、3 段叫声，从候选里随机选取，避免连续重复同一资源。
交互与声音¶
- 点击皮卡丘会叫一声。
- 悬停桌宠右上角可静音；设置 → 通用 中也有声音开关，与喇叭按钮同步。
- 声音偏好写在浏览器
localStorage，不跨设备同步。 - 浏览器通常要求用户先与页面有一次点击交互后才允许出声。
隐私与运行方式¶
README 写明：仅使用 localStorage 与 Web Audio，不联网、无遥测。桌宠逻辑在已构建的 client.js 中执行，属当前 DSH Web 会话的前端能力，不单独请求远端服务。
安装与启用¶
官方 README 的安装起点是克隆仓库（安装命令须与资料一致，勿自行拼接 dsh plugin add github:...）：
git clone https://github.com/mufanlee/dsh-pikachu-pet.git
克隆完成后，任选其一装入当前 profile：
- 在 DSH 会话中让 Agent 将克隆目录作为 bundle 安装（
plugin_manager的install_bundle）。 - 打开 设置 → Plugins 添加该 bundle，然后刷新页面。
成功时返回 application: applied。
卸载：设置 → Plugins 停用，或调用 plugin_manager 的 remove_bundle。
安装前建议自行阅读仓库源码与 LICENSE、NOTICE。插件随当前 DSH 进程与 Web 环境运行，权限边界与宿主一致。
典型用法¶
- 在 DSH 0.2.1-rc.5（Web GUI） 上完成安装并刷新（README 标明该版本；其他版本未验证）。
- 正常发起 Agent 任务，观察右下角桌宠随「运行中 / 等待确认 / 完成 / 长时间空闲」变化。
- 若不需要声音：在桌宠悬停区关喇叭，或到 设置 → 通用 → 皮卡丘桌宠 · 声音 关闭。
版本与包名以 package.json 为准：当前文档抓取时为 @local/dsh-pikachu-pet 1.0.0。
适用场景与注意¶
适合谁： 经常在 DSH Web GUI 里长时间跑 Agent、希望用视觉与轻量音效感知会话节奏，且能接受非官方粉丝素材合规边界的开发者。
需要注意：
- 素材与商标归属见 NOTICE，非 MIT 范围内容勿当作可任意再分发商用素材。
- 星标、社区目录展示信息可能滞后；以 GitHub 仓库 为准。
- 社区插件目录 skillhub.cn 为独立站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，本文介绍的是社区贡献之一。
若你参与二次开发：修改 src/client.template.js 或 assets/ 后需重建 client.js（勿手改生成产物）：
npm run build
npm run verify
或：
node src/build-client.cjs
node src/verify-client.cjs
结尾¶
mufanlee/dsh-pikachu-pet 把会话状态映射到右下角桌宠动作与本地音效，安装路径清晰、依赖浏览器本地能力。若你需要在不改后端的前提下给 Web GUI 加一点状态反馈，可按 README 克隆仓库并通过 Plugins 或 install_bundle 启用。
