Night Dog (夜官)：DSH 界面桌宠

在 DeepSeek Harness (DSH) 的开发过程中，除了日志输出，开发者往往需要一个直观且低干扰的视觉反馈来缓解枯燥。dsh-plugin-night-dog 插件提供了一只名为“夜官”的土黄色小狗。它是一个纯客户端插件，不涉及宿主侧执行、网络请求或模型访问，直接嵌入 DSH 的 Web 界面，随当前主题变化自动适配颜色。

核心功能¶

夜官的交互与行为逻辑主要分为用户交互、自动动作和状态响应三类。

用户交互¶

• 点击夜官：触发开心蹦跳动作，伴随吐舌和冒泡效果。左键点击不会隐藏它。
• 按住拖动：1:1 跟随鼠标移动。位置被持久化保存（版本 dsh.night-dog.state.v6），刷新页面后位置不变。窗口级监听配合坐标守卫，防止位置跳变。
• 双击夜官：将位置复位到右下角默认位置。
• 右键夜官：隐藏到右下角呼吸光晕的小圆点（仅当前会话有效，刷新或重启 DSH 会恢复显示）。点击小圆点可唤醒。
• 悬停夜官：头顶浮现名字“夜官”。
• 长时间无操作：自动趴下睡觉（侧卧、头枕前爪、闭眼、打呼噜 Zzz）。

自动动作¶

在空闲状态下，夜官会按周期触发一系列动作，互不中断：

1. 张嘴吐舌：约 9 秒，张大嘴哈气、舌头伸出、眯眼笑、尾巴狂摇。
2. 双脚站立：约 26 秒，身体竖直、前爪作揖、弹跳入场。
3. 歪头：约 32 秒，左右卖萌晃动。
4. 站立走动：约 52 秒，左右踱步，前爪交替迈步。
5. 打哈欠：约 42 秒，大张嘴、眯眼。
6. 凶叫：约 45 秒，怒眉、龇牙、抖动、冒出“汪！”气泡。
7. 追尾巴转圈：约 60 秒，原地转一整圈。
8. 委屈呜咽：约 78 秒，水汪汪眼睛、撇嘴。

Agent 状态响应¶

夜官能感知 DSH Agent 的运行状态，并做出相应反应：

• 思考 / 工具 / 错误 / 庆祝 / 睡眠：对应的动画状态。
• 连接重置：吓一跳（X 眼 + 抖动）。
• 执行斜杠命令：开心庆祝（眯眼 + 吐舌头）。

安装与启用¶

通过 DSH CLI 安装此插件：

dsh profile plugin add dsh-plugin-night-dog

安装完成后，插件会自动加载并出现在 Web 界面中。由于它是纯客户端组件，无需配置宿主环境或网络权限。

技术实现与安全¶

• 纯客户端：插件仅运行在浏览器端，不触碰宿主执行、网络请求或模型访问。所有副作用（事件监听、定时器、本地存储）均在 ctx.effect disposer 内管理，卸载时可完全回收。
• 主题自适应：颜色取自 DSH 主题令牌（--dsw-*），主体使用琥珀色系，确保在不同主题下视觉融合。
• 位置持久化：使用 dsh.night-dog.state.v6 存储位置数据，包含版本号和视口校验，防止越界或损坏导致的位置错误。

适用场景¶

适合需要在 DSH 界面中获得陪伴感或简单视觉反馈的开发者。它不占用过多系统资源，且作为开源项目（MIT 许可证），用户可自行审查源码与安全性。

• 目录页：https://www.skillhub.cn/plugins/zzhi191/dsh-plugin-night-dog
• GitHub：https://github.com/zzhi191/dsh-plugin-night-dog