悬浮Q版宠物 Cheva1234/dsh-chibi-pet

dsh-chibi-pet

非官方粉丝项目。 与 COVER Corp.、Hololive Production、DeepSeek 均无关联，也未获其背书或参与制作。免费、非商业用途；美术素材遵循 COVER 的 Derivative Works Guidelines——详见 ATTRIBUTION.md。

一个给 DeepSeek Harness Web GUI 用的 Q 版宠物。它浮在界面上，只属于一个会话，实时显示这个会话在干什么——思考、跑工具、等审批、收尾、出错、打瞌睡。你可以把它拖到任意位置，摸摸它的头，还能直接对它打字提需求：你写的内容会排进它所属的会话。

宠物的各种姿态

安装

这个插件是一个 Harness bundle。挑一种你顺手的方式就行——三条路殊途同归。

从 GUI 装（最省事）。 打开 Settings → Plugins，把下面任意一条粘进安装框，确认即可：

dsh-chibi-pet # after it is on npm
github:Cheva1234/dsh-chibi-pet # straight from this repo
https://github.com/Cheva1234/dsh-chibi-pet/releases/download/v1.0.1/dsh-chibi-pet-1.0.1.tgz

用 Plugin Manager 工具装（智能体或你自己都能用）：

{ "action": "install_bundle", "target": "github:Cheva1234/dsh-chibi-pet" }

从克隆的仓库装，适合开发调试：

git clone https://github.com/Cheva1234/dsh-chibi-pet
then point the Plugin Manager at that absolute directory

安装时不需要构建：浏览器 bundle 已经提交进仓库，安装器只负责拉文件。想停用或卸载，随时回到同一个 Plugins 页面操作。

使用

| 操作 | 效果 |
| 点一下宠物 | 摸摸头——屏幕上有审批或报错时会被拒绝 |
| 拖动宠物 | 它会跟着移动，拖得越远身体倾得越厉害 |
| 气泡按钮 | 打开输入框：写一条需求，按 Enter 发到宠物所属的会话 |
| 右键 | 把宠物送回角落 |
| 侧边栏开关、Settings 里的那一行，或 Ctrl/⌘+Shift+. | 显示或隐藏宠物 |

侧边栏开关

刷新后位置会保留。宠物只在自己那一小块区域里捕获指针——它下面的东西照样能点。

一只宠物只认一个会话

宠物只绑定一个会话，对其他会话一概不理。它看到的第一个对话就是它的会话；之后别的会话再怎么动，它也不挪窝。聊天输入框的标题会写明它服务的是哪个会话，如果那个会话宠物消失时会说一声，并主动跟随你正在查看的会话。

打开 跟随模式（聊天输入框里的开关），宠物就不再待在原地，而是跟着你当前查看的会话走。

和它说话

聊天输入框

Enter 把你输入的内容排进绑定的会话，和输入框自己发送时完全一样——它绝不会打断正在运行的回合。Esc 或点击输入框外面即可关闭。提示词被拒绝时，输入框里会给出提示，不会静默失败。

拎着它

拎起宠物时，它会笔直垂下；拖动时，它会朝移动方向倾斜，拖得越远倾得越多。距离从你拎起它的位置算起，所以拖到一半停下，它也不会重新立正。

被拎起时的姿态逐渐形成

当你在看别处时

如果绑定的会话在后台完成回合、失败，或需要审批，而它并不是屏幕上正在看的会话，宠物身上和侧边栏开关上就会出现一个小圆点。你一看那个会话，或打开宠物的输入框，圆点立刻消失。

设置

设置 → 通用

| 设置项 | 默认值 | 作用 |
| Chibi 宠物 | 开 | 在当前窗口显示或隐藏宠物 |
| 宠物大小 | 中 | 小 84 px / 中 112 px / 大 140 px 宽 |
| 宠物打盹时间 | 2 分钟 | 宠物空闲多久后睡着；从不让它一直醒着 |
| 跟随我正在查看的会话 | 关 | 把宠物重新安置到你正在查看的会话上 |

偏好设置存在当前浏览器里（localStorage），不在 Harness 配置档里，所以不会在浏览器或机器之间同步。

宠物会对什么做出反应

| 姿态 | 触发条件 | 播放方式 |
| greeting | 每次页面加载一次，挂载后约 250 ms，且只在没有任务运行时 | 一次 |
| thinking | 会话运行中，助手文本正在流式输出 | 循环 |
| working | 会话运行中，有正在进行的工具调用 | 循环 |
| waiting | 出现新的待处理交互（审批 / 提问），按它的 key 去重 | 一次，然后保持到被回答 |
| success | 运行超过 600 ms 的回合结束，且没有新错误 | 一次 |
| error | 出现新的智能体错误 | 一次 |
| head-pat | 你点击宠物，除非正在显示审批或失败 | 一次 |
| idle | 没什么可报告的 | 循环 |
| sleep | 空闲达到配置的打盹时间，且没有待处理任务 | 循环 |
| drag | 被拎着——两张图，每个方向一张 | 保持 |

开启 prefers-reduced-motion: reduce 时，宠物只显示每个状态的第一帧，并且只在状态变化时切换。

宠物只是装饰：它从不批准、拒绝、提交或关闭任何东西，也看不到、影响不了工具策略。

自己构建

client.js 是生成出来的：它就是 src/pet-client.js 内联了精灵表。Harness 只以 JavaScript 形式提供客户端插件——插件包无法通过 HTTP 获取自己的 PNG——所以图集以 WebP data URI 的形式打包进 bundle 里。
python3 tools/build_sprites.py --zip /path/to/sprite-pack.zip
python3 tools/build_sprites.py --pack /path/to/extracted-pack

它要求的目录结构：<state>/frames/<state>-NN.png（每个状态六张 512×560 RGBA 姿势图）和 <state>/animation.json（时间序列与循环策略），适用于 idle、thinking、working、waiting、success、error、head-pat、drag、sleep、greeting。

常用参数：--frame-width 224 生成更小的包（显示尺寸会相应缩小），--quality 80 压缩更狠。包里的模块 id 取自 package.json，所以两者永远不会对不上。

测试

node --check client.js # the bundle parses as a browser script
node tools/check-bundle.mjs # module id, atlas count, Loader row
node tools/test-machine.mjs # 22 behaviour checks, no browser needed

tools/test-machine.mjs 用打桩的 window.__ModuleLoader__ 加载真实包，驱动导出的行为折叠逻辑：问候一次、有任务进行中不问候、thinking 与 working 的区分、审批去重与保持、成功阈值、错误去重、摸头紧急度、睡眠与唤醒、切换会话不欢呼、三档携带等级，以及偏好表。

渲染在无头 Chrome 里对着替身外壳验证过：每个姿势、亮色与暗色、两个携带方向、聊天输入框发送真实提示词、全部三种尺寸、侧边栏开关、Settings 各行、注意徽标、跟随模式、键盘命令，以及 prefers-reduced-motion。

目录结构

| 路径 | 作用 |
| package.json | 包清单、dsh.client、显示元数据、图标 |
| cordis.patch.yml | 插入 dsh-pet 的 Loader 行 |
| index.js | 宿主侧——有意保持惰性 |
| src/pet-client.js | 客户端源码：状态机、渲染器、插槽、偏好 |
| client.js | 生成的包，供浏览器加载 |
| tools/build_sprites.py | 精灵包 → 图集表 → 包 |
| tools/check-bundle.mjs | 生成包的 CI 守卫 |
| tools/test-machine.mjs | 行为测试 |
| locale/en.json、locale/zh.json | 插件管理器的标题与描述 |
| docs/ | 本 README 里的图片 |

要求与限制

- 需要 Harness Web GUI。宠物绘制到 shell.overlay、sidebar.footer.action、settings.general.item 和 conversation.composer.dock。
- 它浮在 Harness 窗口内部的任意位置。网页插件无法创建覆盖操作系统桌面的置顶窗口。
- 发送任务走客户端 sessions 服务，排入绑定的会话；它绝不会替你批准任何东西。
- 键盘命令用的是 Web 组合层允许的少数物理组合之一；如果冲突，在 Settings → Shortcuts 里重新绑定。

许可

代码：MIT。

精灵美术是第三方同人作品，不在该许可范围内。它依据 COVER Corp. 的 Derivative Works Guidelines 使用，作为免费、非商业同人项目，与官方无任何隶属关系。复用或 fork 之前，请先读 ATTRIBUTION.md。另外注意：以准则本身为准，准则可能变更。