小蓝桌宠 JHyugou/dsh-sidebar-pet

小蓝桌宠 · DeepSeek Harness 侧栏插件 v0.2.1

沿用已认可的蓝发女仆与几何纸片风格。小蓝位于侧栏工作区列表下方的空白处，跟随真实会话状态：待机、思考、执行工具、等待确认、本轮结束和异常。

本地插件，无 npm 运行依赖、无需构建。适配本机 DeepSeek Harness 0.2.0-rc.2。聊天框和输入框使用原生布局；人物和设置仅由本插件管理。

使用

- 点击人物，轮流播放打招呼、开心点头与好奇回应三段完整动画；动作结束后恢复真实任务状态。
- 连点最多排一个后续动作，当前动作会自然演完。连续密集点击不会积压长队列。
- 拖动人物，在侧栏空白处移动。聚焦人物后，方向键可微调位置，Enter / Space 可触发互动。
- 点击状态或短句，返回对应任务会话；后台会话需要确认时优先提示。
- 点击侧栏底部的 DeepSeek 图标，打开设置。图标直接使用 DSH 自带的 FishLogo，与侧栏品牌标记一致。也可从 设置 → 小蓝桌宠 进入。
- 设置中可调整人物大小、不透明度、动效、安静模式、短句与任务提醒标记。
- 收起人物后保留 DeepSeek 入口。侧栏列表占满、窗口变矮或侧栏折叠时，人物自动避让；空间恢复后重新显示。
- 设置中的六个动作可随时预览；8 秒后自动恢复真实状态。预览不产生任务提醒。

默认大小为 148 px（图片宽度），不透明度为 100%；可调范围为 100–220 px、25–100%。实际大小自动适应空白高度。拖动位置保存在当前设备，并随窗口尺寸重新计算。

安静模式停止动画与闲聊短句，保留必要的状态及提醒标记。系统「减少动态效果」只暂停自动呼吸、眨眼等待机循环和装饰纸片；主动点击仍会播放有限时长的人物动作。窗口不可见时暂停所有动画。

v0.2.1 修复了 Windows 关闭界面动画时「短句变化、人物不动」的问题。v0.2.0 将系统减少动态效果同时作为点击动画的禁止条件，即使插件的「启用动效」已打开也不会播放。现在自动动效与主动点击分别处理，无需更改 Windows 设置。

点击互动

| 动作 | 连贯过程 | 时长 |
| 打招呼 | 回应 → 眨眼 → 抬手 → 来回挥手 → 放下手 → 微笑 → 恢复 | 3.20 秒 |
| 开心点头 | 回应 → 闭眼微笑 → 轻轻点头 → 睁眼 → 恢复 | 2.34 秒 |
| 好奇回应 | 倾身听你 → 眨眼 → 举手回应 → 微笑 → 恢复 | 3.06 秒 |

六张同位置、同尺寸的透明关键姿势配合短过渡与轻微缓动，每段都有开始和收尾。人物外形、服装与几何纸片画风保持一致。等待确认、任务异常或断线时，互动及后续队列会让位于真实任务提示。拖动不会触发点击动画。

关闭「启用动效」后仍可显示简短回应；安静模式同时关闭闲聊。升级沿用原有设置存储键，大小、透明度、位置和开关可以继续使用。

以下为已安装插件的实际页面录制，仅截取人物和底部入口：

三种点击互动

状态和提醒

任务状态来自 DSH 的 sessions.list、uiSession.sessionStatus 与当前会话事件源：

| 状态 | 表现 |
| 待机 | 轻微呼吸，间歇眨眼 |
| 思考 | 小幅歪头，几何纸片缓慢浮起 |
| 执行工具 | 轻微起伏，纸片环绕 |
| 等待确认 | 一次短动作，提示「这里需要你确认」 |
| 本轮结束 | 点头、举手打招呼，纸片短暂散开 |
| 异常 | 微微歪头，提示本次任务有问题 |

本轮结束使用真实运行状态的结束信号，稳定 700 ms 后提醒；手动停止也可能触发「本轮结束」，因此不宣称任务成功。正在等待确认或遇到错误时不会显示结束庆祝。刷新和重新连接会重新建立基线，避免补发旧任务的结束提醒。

全局状态覆盖当前窗口已加载的会话；当前会话可进一步区分思考与工具执行。未打开的后台会话显示通用执行状态。

提醒仅显示在 DSH 窗口中，没有声音或额外 Windows 通知。设置面板保留本次打开期间最近 12 条提醒，点击可返回会话。不会自动确认授权、回答问题、发送消息或调用模型。

安装与卸载

本地安装，在 PowerShell 运行：

& "E:\DSH-DeskTop\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "E:\OpencodeProject\Project\DSH-Plugin\dsh-sidebar-pet"

本机已安装为本地链接，并已将当前运行的桌宠服务热更新至 v0.2.1，无需重装或重启 DSH。若桌面窗口仍显示旧效果，按 Ctrl+R 刷新。ZIP 使用者先解压整个文件夹，再将末尾路径替换为解压目录。保留插件目录，以便宿主提供图片。其他环境升级已经缓存的服务端模块时，可以在无任务运行期间重新启动 DSH。

卸载：

& "E:\DSH-DeskTop\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop remove dsh-sidebar-pet

素材与维护

assets/idle.png 为已认可的半身稿；原有 blink.png 与 wave.png 保留。本次使用内置 image_gen 生图工具，以原图为编辑目标，新增 lift.png（抬手中间姿势）、wave-in.png（挥手另一端）和 smile.png（闭眼微笑）。六张图片均为 1024 × 1536 的透明 RGBA PNG，随插件本地提供。

完整提示词见 assets/idle-prompt.txt、assets/action-prompts.txt 与本次的 interaction-prompts.txt。运行期间不调用生图或模型服务。DeepSeek 入口使用原生矢量组件。

人物与 DeepSeek 入口

验证覆盖状态、动画队列、图片服务和已安装页面。v0.2.1 增加「系统关闭动画、真实任务状态、不切换待机预览」的回归检查，直接以鼠标坐标点击人物，确认三段动作都切换到可见姿势并自然收尾；同时检查待机循环和装饰纸片仍暂停。检查也覆盖连点衔接、原生 Logo 路径、键盘、安静模式、任务提示、断线、拖动、设置持久化、列表避让、聊天布局和卸载。验证记录保存在 docs/；没有发送测试消息。动画预览为 v0.2.0 已安装页面录制，人物素材和动作脚本在此次修复中保持一致。
插件用 shell.overlay 获取生命周期，通过侧栏 CSS 模块语义后缀定位空白区域；设置页和 DeepSeek 按钮使用原生插槽。动画只在阶段切换时更新，不持续执行逐帧 JavaScript 循环。卸载时清理人物、样式、设置入口、监听器与计时器。

设置保存在设备 localStorage，不会写入会话文件；提醒仅驻留内存。插件不修改其他插件源码、DSH 安装文件或聊天布局。

开发检查（Node.js 22 或更新）：

npm run check
npm test
npm run verify
npm run preview
node tools/browser-check.mjs --fixtures
node tools/browser-check.mjs --installed

verify 需要本机 DSH 已启动、插件已安装。浏览器检查使用临时 Chrome 上下文；仅该临时浏览器关闭本地网络检查，以便连接本机 DSH，不调整正常 Chrome 或 DSH 的设置。浏览器工具需要本机 Codex 随附的 Playwright，可通过 DSH_PET_NODE_MODULES 指定其他本地模块目录。

--fixtures 在独立浏览器页面里使用与 DSH 同形状的临时任务来源验证动作和提醒；不发送测试消息、不执行真实任务，不改服务器会话。普通和 --installed 检查使用真实服务读取和原生界面。

诊断入口：window.__dshSidebarPet.inspect()，其中 motion 显示系统动效偏好、窗口可见性、自动动画状态及点击受限原因。可用 .update({quiet:true})、.reset() 和 .openSettings()；诊断不会输出认证信息或会话正文。