前言¶

在 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