前言¶

在 DeepSeek Harness（DSH）里跑智能体时，主窗口往往占满屏幕，任务进度和思考过程又分散在会话里。若只想在桌面角落放一个不挡操作的小伴侣——能聊几句、偶尔自言自语、并在当前会话干活时用短句播报——需要插件在宿主进程里接模型与会话事件，再单独开一个透明置顶窗口。下面介绍社区插件 dsh-firefly-pet（维护者 Firefly26710Lover，分类：趣味换装）：在 Windows 上的 DSH Desktop 里实现上述能力，聊天走 DSH 自带的 ctx.llm，无需单独填 API Key。

它是什么¶

dsh-firefly-pet 是一个本地 DSH 插件：在桌面上打开透明、置顶、无边框小窗，展示流萤主题 GIF。人设来自包内 assets/roleplay.md；对话记忆持久化在 ~/.dsh/dsh-firefly-pet/memory.json。插件版本 0.1.0（MIT 许可证； bundled 美术为同人素材，权利归各自权利人）。

与「只在 DSH 主界面里聊天」不同，桌宠窗口透明区域支持点击穿透，拖动位置会记住；任务播报绑定 DSH 会话事件，带会话标签，便于区分是哪个对话框在运行。

核心功能¶

安装与启用¶

插件以当前 DSH 进程权限运行，安装前建议在 GitHub 仓库核对源码与许可证。需要 DSH Desktop 自带的 Electron 运行时（~/.dsh/electron）；找不到时桌宠不会出现，日志会有提示。可先安装 dsh-pet 等插件让运行时落盘，或设置环境变量 FIREFLY_ELECTRON_PATH。

DSH 桌面应用：设置 → 插件 → 搜索 dsh-firefly-pet → 安装，装完重启应用。

命令行（官方 README 原文）：

dsh plugin --profile desktop add dsh-firefly-pet

package.json 中声明与 DSH 0.2.1-rc.3 为 compatible；Node 需 >=22.12.0。已知限制：仅 Windows（Electron 查找与窗口行为按 Windows 实现）；只支持桌面模式，无网页 overlay；任务播报仅在「最后发过消息的那个会话」上工作。

配置与素材¶

用户配置位于 ~/.dsh/dsh-firefly-pet/config.json，不存在则使用包内默认值。常用字段示例：

{
  "gifDir": ".../assets/gifs",
  "gif": "流萤_狐狸_躺.gif",
  "size": 220,
  "marginX": 24,
  "marginY": 16,
  "roleplayPath": ".../assets/roleplay.md",
  "roleplayMaxChars": 20000,
  "whisperEnabled": true,
  "whisperIntervalSec": 300,
  "whisperPolish": true,
  "whisperBubbleMs": 9000,
  "chatModel": { "provider": "", "model": "" }
}

chatModel 留空表示跟随当前会话模型；whisperPolish 为 false 时碎碎念直出包内台词，不调用模型。

待机池与动作池可在 ~/.dsh/dsh-firefly-pet/ 放置 idle-gifs.json、click-gifs.json，不写则用包内默认。动作池支持为单张 GIF 指定时长，例如：

[{ "file": "流萤_鼬_跳_x5_5s.gif", "ms": 5000 }, "流萤_小恐龙_喷火.gif"]

台词库在包内 assets/whisper-lines.json，可直接替换。

典型用法¶

1. 按上文安装并重启 DSH Desktop，确认 Windows 环境与 Electron 运行时可用。
2. 在桌面右下角（默认 marginX / marginY）看到待机 GIF；单击看随机动作，双击或右键进入聊天。
3. 在 DSH 里对当前会话发消息后，桌宠会对该会话的思考、工具调用、Todo 更新与轮次结束做短句播报。
4. 需要零成本碎碎念时，在 config.json 将 whisperPolish 设为 false。
5. 卸载（开发文档中的命令）：

dsh plugin --profile desktop remove dsh-firefly-pet

本地开发可用软链安装：dsh plugin --profile desktop add link:C:/path/to/dsh-firefly-pet（路径按本机修改）。

适用场景与注意¶

适合已在 DSH Desktop（Windows） 上日常跑智能体、希望桌面有轻量陪伴且不想单独配置聊天 API Key 的开发者。聊天、碎碎念润色与任务播报轮次结束润色会走宿主模型服务，用量与当前 DSH 账号/模型配置相关。

社区目录页与 GitHub 为独立信息源，与 DeepSeek / 幻方无官方从属关系。星标与兼容性以仓库当前说明为准。

结尾¶

dsh-firefly-pet 把透明置顶小窗、流式聊天、定时碎碎念和会话级任务播报收进一个 DSH 桌面插件，依赖 DSH 自带 LLM 与人设文件，配置与 GIF 池均可本地扩展。

• 目录页：https://www.skillhub.cn/plugins/Firefly26710Lover/dsh-firefly-pet
• 仓库：https://github.com/Firefly26710Lover/dsh-firefly-pet