前言¶

用 DSH 寫代碼或跑任務時，Agent 的思考、查找、修改、執行這些階段大多隻顯示在會話窗口裏。窗口一最小化或切到別的應用，就看不到當前進度；想知道 DeepSeek 餘額還要另開一個頁面。下面介紹 dsh-dafeiyu，它把狀態拉到桌面上：一個透明、無邊框、始終置頂的原生窗口，隨 DSH 一起啓動和退出，讓你在編輯器或瀏覽器旁邊也能看到 Agent 在做什麼。

dsh-dafeiyu 是一個 DSH 插件（客戶端類），由 skyzou071026-collab 維護鏡像，上游倉庫是 QCYTSN/dsh-dafeiyu，代碼按 MIT 許可發佈。當前穩定版 0.1.23。它不讀取屏幕，狀態全部來自 DSH 會話事件；推理強度與進度只顯示上游實際提供的信息，拿不到真實進度時顯示階段。

能做什麼¶

1. 顯示真實任務狀態：思考、查找、修改、執行、驗證、等待確認、完成和錯誤。
2. 展示項目、步驟、多任務和 DSH 提供的待辦進度；沒有真實進度時顯示階段。
3. 顯示 DeepSeek 餘額：狀態氣泡底部和設置頁都會顯示，區分 API Key 與已登錄賬戶兩種來源。
4. 兼容 WebUI 與官方桌面端，兩個客戶端使用各自的插件配置，各自啓動一個原生角色。
5. 支持拖動、摸頭、戳身體、碰尾巴，以及角色大小、氣泡大小、聲音和減少動態設置。
6. 可選在 DSH 頁面右下角顯示輕量角色，默認關閉。

先選你的 DSH 客戶端¶

WebUI 用戶的插件裝在 web profile；官方桌面端裝在 desktop profile。兩者的設置入口在 DSH 0.2 都是左側「插件 → dsh-dafeiyu」，但角色右鍵菜單的打開目標不同：WebUI 默認打開 http://127.0.0.1:3080/，桌面端通過 dsh://open 喚起桌面應用。

需要注意：WebUI 中安裝的插件不會自動出現在桌面端。 兩邊都啓用會各自啓動一個原生角色，可以在其中一個 profile 關閉「大肥魚」。第三方桌面包裝器可能仍使用 web profile，以它的實際啓動方式爲準。

安裝與啓用¶

使用命令行安裝、升級或移除前，先完全退出對應的 DSH Host，操作完再重新啓動。下面按客戶端分別給出命令。

瀏覽器 WebUI¶

已全局安裝 DSH 時：

dsh plugin --profile web add dsh-dafeiyu@0.1.23
dsh web

沒有全局安裝 DSH，用 npx：

npx -y @deepseek-ai/dsh plugin --profile web add dsh-dafeiyu@0.1.23
npx -y @deepseek-ai/dsh web

從 DeepSeek Harness 源碼運行的用戶，在 Harness 倉庫中執行：

pnpm dsh plugin --profile web add dsh-dafeiyu@0.1.23
pnpm dsh web

官方桌面端¶

推薦直接在應用內安裝：打開官方桌面應用，點擊左側「插件」→「添加插件」，輸入 dsh-dafeiyu@0.1.23，安裝後點「立即啓用」。這套流程使用應用自帶的安裝環境，不需要自己裝 Node.js 或執行 npm 命令。

如果走命令行：

1. 先啓動一次官方桌面應用，讓它初始化 desktop profile，然後完全退出。
2. 使用桌面應用自帶的 dsh 命令（也可直接調用安裝目錄的 resources/runtime/cli/bin/dsh，Windows 是 dsh.cmd）。
3. 執行：

dsh plugin --profile desktop add dsh-dafeiyu@0.1.23

4. 重新打開桌面應用，在左側插件 → dsh-dafeiyu 調整角色。

這裏的 dsh 必須來自桌面應用。 獨立安裝的 npm 或 npx @deepseek-ai/dsh CLI 不能修改官方桌面端的 profile。

只填 dsh-dafeiyu 會取默認安裝源中的最新版，新發布時可能仍是舊版；指定 @0.1.23 可以避免裝錯，裝完覈對詳情頁版本號。

使用 Release 安裝包¶

在 Release 頁 的 Assets 中下載 dsh-dafeiyu-0.1.23.tgz，用對應客戶端的命令安裝，無需解壓：

# WebUI；路徑替換爲實際下載路徑
npx -y @deepseek-ai/dsh plugin --profile web add "C:\Downloads\dsh-dafeiyu-0.1.23.tgz"

# 桌面端；必須使用應用自帶的 dsh
dsh plugin --profile desktop add "C:\Downloads\dsh-dafeiyu-0.1.23.tgz"

Windows、Linux 與 macOS 共用這一個包。GitHub 自動生成的 Source code (zip / tar.gz) 是源碼，不是安裝包，不要拿來安裝。

典型用法¶

裝好後無需額外配置即可看到狀態。

1. 默認透明窗口懸浮在桌面上，隨會話階段變化。不同的表情和動作對應狀態，具體觸發與銜接規則見倉庫內的 docs/animation-behavior.md。
2. 在設置頁開啓餘額顯示，憑據在 DSH 的模型／賬戶設置中配置，大肥魚設置頁不需要填寫 API Key。餘額每分鐘自動刷新，同一 Host 內共享緩存，手動刷新最快每 5 秒一次。服務失敗時保留上次成功結果並標明「上次查詢」。不配置憑據也能正常顯示任務狀態。
3. 在設置頁調整角色大小與氣泡大小、切換安靜／標準／活潑（待機休息時長 45～90 / 25～45 / 12～22 秒）、開啓減少動態、設置提示音與通知場景、選擇氣泡常駐／隱藏／僅在指定狀態顯示。
4. 右鍵角色可調整大小、切換減少動態、打開對應 DSH 客戶端，或僅在本次運行隱藏／關閉角色。
5. 若 WebUI 使用自定義地址，在啓動 Host 時設置 DSH_DAFEIYU_WEBUI_URL，它優先於自動推斷的默認地址。

平臺與運行環境¶

標準安裝包已包含 Helper，不需要自己安裝 Python 或運行 Helper。原生角色顯示在 Host 所在的桌面：如果 Host 跑在遠程服務器或無圖形環境，而你在本地瀏覽器使用客戶端，角色不會出現在你本機，頁面內角色除外。

更新與排錯¶

WebUI 用戶退出 DSH 後執行：

npx -y @deepseek-ai/dsh plugin --profile web update dsh-dafeiyu

官方桌面端 0.2.0-rc.2 暫不支持應用內自動更新：在插件頁面卸載後重新添加 dsh-dafeiyu@0.1.23，或退出應用後執行：

dsh plugin --profile desktop update dsh-dafeiyu

幾個常見問題的方向：角色不出現時先檢查 profile、插件是否啓用、Host 是否有可用圖形桌面，Helper 啓動原因會寫入日誌（Windows %LOCALAPPDATA%\dsh-dafeiyu\logs\helper.log，macOS ~/Library/Logs/dsh-dafeiyu/helper.log，Linux ${XDG_STATE_HOME:-~/.local/state}/dsh-dafeiyu/helper.log）。首次啓動要解壓約 100 MB 的 Qt 運行庫，殺毒軟件實時掃描可能讓冷啓動明顯變慢，首次就緒等待上限已放寬到 180 秒。餘額查詢失敗時檢查 DSH 中的憑據及所用網關是否支持餘額接口。需要更詳細輸出可用 DSH_DAFEIYU_LOG_FILE=<路徑> 改日誌位置，或設爲 off 關閉；日誌只含本地路徑與啓動錯誤，不含憑據。

適用場景與注意¶

適合想長期掛着 DSH、希望編排過程中不斷確認 Agent 狀態的用戶，尤其是需要盯住等待確認和工具出錯場景的人。它是一個社區維護的鏡像插件（上游 QCYTSN/dsh-dafeiyu），目錄頁顯示星標爲 0。

使用前有幾件事要知道：插件以當前 DSH 進程的權限運行，安裝前應檢查源碼與許可證，本篇只轉述上游 README 的能力說明。代碼適用 MIT，但角色素材來自 PC2005-cloud/dsh-pet，軟件代碼與素材授權不同，發佈包內附 ASSET_LICENSE.md 與素材許可證。當前動態素材以 24 fps 轉成透明 WebP，含 16 組動作、3,444 幀，幀畫布 412 × 344。插件不發起模型調用，也不會把 API Key、登錄憑據和上游原始錯誤寫入餘額頁、角色消息或事件流。

目錄頁與源碼¶

• 目錄頁：https://www.skillhub.cn/plugins/skyzou071026-collab/dsh-dafeiyu
• 鏡像倉庫：https://github.com/skyzou071026-collab/dsh-dafeiyu
• 上游倉庫：https://github.com/QCYTSN/dsh-dafeiyu