前言¶
在 DeepSeek Harness（DSH）里长时间跑会话时，侧栏工作区列表下方往往是一片空白：任务是否在思考、是否在等确认，只能靠扫列表和聊天区。小蓝桌宠（dsh-sidebar-pet）由社区维护者 JHyugou 发布，归类为「趣味换装」，把几何纸片风格的侧蓝发女仆放在侧栏空白处，并跟真实会话状态联动。它是本地插件，无 npm 运行依赖、无需构建；聊天框与输入框仍用 DSH 原生布局，人物与设置由插件单独管理。下面介绍定位、能力、安装与日常用法。
这是什么¶
插件全名在 package 中为 dsh-sidebar-pet，当前版本 v0.2.1（MIT）。一句话：侧栏中的几何风任务伙伴，支持连贯点击动画、任务提醒与独立外观设置。
README 写明适配本机 DeepSeek Harness 0.2.0-rc.2。插件通过 shell.overlay 获取生命周期，在侧栏 CSS 模块语义后缀定位的空白区域渲染人物；设置页与底部 DeepSeek 按钮使用原生插槽。
核心功能¶
会话状态跟随¶
任务状态来自 DSH 的 sessions.list、uiSession.sessionStatus 与当前会话事件源，人物表现与下表一致（资料原文）：
| 状态 | 表现 |
|---|---|
| 待机 | 轻微呼吸，间歇眨眼 |
| 思考 | 小幅歪头，几何纸片缓慢浮起 |
| 执行工具 | 轻微起伏，纸片环绕 |
| 等待确认 | 一次短动作，提示「这里需要你确认」 |
| 本轮结束 | 点头、举手打招呼，纸片短暂散开 |
| 异常 | 微微歪头，提示本次任务有问题 |
本轮结束使用真实运行状态的结束信号，稳定 700 ms 后提醒；手动停止也可能触发「本轮结束」，因此不宣称任务成功。正在等待确认或遇到错误时不会显示结束庆祝。刷新和重新连接会重新建立基线，避免补发旧任务的结束提醒。
全局状态覆盖当前窗口已加载的会话；当前会话可进一步区分思考与工具执行。未打开的后台会话显示通用执行状态。
点击互动与队列¶
点击人物会轮流播放三段完整动画：打招呼、开心点头、好奇回应。动作结束后恢复真实任务状态。连点最多排一个后续动作，当前动作会自然演完，密集连点不会积压长队列。拖动人物可在侧栏空白处移动；聚焦人物后，方向键可微调位置，Enter / Space 可触发互动。拖动不会触发点击动画。
关闭「启用动效」后仍可显示简短回应；安静模式停止动画与闲聊短句，保留必要的状态及提醒标记。系统「减少动态效果」只暂停自动呼吸、眨眼等待机循环和装饰纸片；主动点击仍会播放有限时长的人物动作（v0.2.0 起自动动效与主动点击分别处理）。窗口不可见时暂停所有动画。
| 动作 | 连贯过程 | 时长 |
|---|---|---|
| 打招呼 | 回应 → 眨眼 → 抬手 → 来回挥手 → 放下手 → 微笑 → 恢复 | 3.20 秒 |
| 开心点头 | 回应 → 闭眼微笑 → 轻轻点头 → 睁眼 → 恢复 | 2.34 秒 |
| 好奇回应 | 倾身听你 → 眨眼 → 举手回应 → 微笑 → 恢复 | 3.06 秒 |
等待确认、任务异常或断线时，互动及后续队列会让位于真实任务提示。
提醒与导航¶
- 点击状态或短句，返回对应任务会话；后台会话需要确认时优先提示。
- 提醒仅显示在 DSH 窗口中，没有声音或额外 Windows 通知。
- 设置面板保留本次打开期间最近 12 条提醒，点击可返回会话。
- 插件不会自动确认授权、回答问题、发送消息或调用模型。
外观与设置¶
点击侧栏底部的 DeepSeek 图标（使用 DSH 自带的 FishLogo）打开设置，也可从 设置 → 小蓝桌宠 进入。可调人物大小、不透明度、动效、安静模式、短句与任务提醒标记。设置中的六个动作可随时预览，8 秒后自动恢复真实状态，预览不产生任务提醒。
默认大小为 148 px（图片宽度），不透明度 100%；范围为 100–220 px、25–100%。实际大小自动适应空白高度。拖动位置保存在当前设备 localStorage，并随窗口尺寸重新计算；不会写入会话文件，提醒仅驻留内存。
收起人物后仍保留 DeepSeek 入口。侧栏列表占满、窗口变矮或侧栏折叠时，人物自动避让；空间恢复后重新显示。
安装与启用¶
本地安装。README 给出的示例在 PowerShell 中执行（路径需按本机 DSH 与插件目录替换；ZIP 使用者先解压整个文件夹，再将末尾路径改为解压目录，并保留插件目录以便宿主加载图片）：
& "E:\DSH-DeskTop\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add "E:\OpencodeProject\Project\DSH-Plugin\dsh-sidebar-pet"
卸载：
& "E:\DSH-DeskTop\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop remove dsh-sidebar-pet
资料未提供通用的 github:owner/repo 一键安装命令，请以你环境中的 dsh CLI 路径与 --profile 为准。安装前建议阅读仓库源码与 MIT 许可证；插件以当前 DSH 进程权限运行。
热更新至 v0.2.1 后若界面仍是旧效果，可按 Ctrl+R 刷新桌面窗口。其他环境在已缓存服务端模块时，可在无任务运行期间重新启动 DSH。
典型用法¶
- 按上文命令将插件目录
add到 desktop profile，刷新 DSH 窗口。 - 在侧栏列表下方看到小蓝后，单击人物体验三段轮换动画；需要定位任务时点击人物旁的状态或短句回到会话。
- 侧栏底部 DeepSeek 图标或 设置 → 小蓝桌宠 中调整大小、透明度与安静模式；需要排查动效时，在开发者工具控制台执行
window.__dshSidebarPet.inspect()，motion字段会显示系统动效偏好、窗口可见性、自动动画状态及点击受限原因。也可用.update({quiet:true})、.reset()、.openSettings()。
开发侧自检（Node.js 22 或更新，见 README）：
npm run check
npm test
npm run verify
npm run preview
verify 需要本机 DSH 已启动且插件已安装。
适用场景与注意¶
适合希望在 DSH 侧栏直观看到当前与后台会话状态、并用轻量互动缓解等待感的桌面用户。人物素材为本地 assets/ 下六张 1024×1536 透明 PNG，运行期间不调用生图或模型服务。
需注意：
- 依赖 DSH 客户端 UI 模块注入（
dsh.client.inject列表见package.json），大版本升级 DSH 后应核对插件是否仍兼容 0.2.0-rc.2 一类说明。 - 卸载会清理人物、样式、设置入口、监听器与计时器；设置键在升级时沿用，大小、透明度、位置和开关可继续使用。
- 社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系；星标与收录信息以站点与 GitHub 为准（资料抓取时 GitHub 星标为 0）。
结尾¶
小蓝桌宠把侧栏空白区变成与会话状态同步的任务伙伴：六态表现、三段点击动画、可配置的安静模式与任务提醒，且不改动聊天布局或代为操作会话。进一步了解请查看 GitHub 仓库 与 SkillHub 目录页。
