DeepSeek Harness (DSH) 的 Agent 模式懸浮窗。這是一個可自由拖動的 Web-UI 面板，用於在「本機提示詞」與 13 個歸檔的編碼 Agent CLI 提示詞之間切換當前會話的系統提示詞。
在調試或對比不同 Agent 的行爲時，頻繁修改系統提示詞會打斷工作流。這個插件提供了懸浮窗，將切換過程圖形化，同時確保會話日誌的完整性與安全性。
插件簡介¶
這是一個爲 DeepSeek Harness (dsh) 插件生態設計的組件，由 deepseekharness 維護。它通過一個懸浮面板，允許用戶在 DeepSeek Harness 的默認提示詞與 13 個主流編碼 Agent 的歸檔提示詞之間快速切換。
核心功能¶
- 可自由拖動的懸浮窗：支持按住窗口任意位置拖動，收起後的膠囊狀態也可拖動。
- 位置與狀態記憶：窗口的位置和開合狀態會自動保存在瀏覽器本地存儲中，刷新頁面或重開會話後自動恢復。
- 一鍵回到默認位置：提供標題欄控件，可一鍵將窗口復位到默認右上角位置。
- 實時狀態：當前模式與 Host 側會話投影實時同步，不依賴輪詢，切換後即時生效。
- 會話日誌安全：通過官方
/agent命令執行切換，日誌中記錄的是標準的 Agent 選擇卡片，可追溯、可復現。 - 中英雙語：界面語言隨 DSH 的語言設置自動切換。
- 熱更新友好：在開發模式下，修改
client.js後會自動熱重載，無需重啓。 - 零網絡、零文件寫入：不聯網、不註冊工具、不注入提示詞正文、不修改已有日誌內容。
安裝與啓用¶
使用 DSH 的插件命令安裝此包：
dsh plugin --profile <profile> add agent-mode-change
安裝完成後，刷新 Web 頁面即可看到懸浮窗（默認位於右上角）。
典型用法¶
| 操作 | 效果 |
|---|---|
| 點任意一行 | 切換當前會話的模式（從下一步生效） |
| 按住窗口任意位置拖動 | 移動懸浮窗（列表滾動條除外） |
點標題欄 – |
收起爲一枚顯示當前模式的小膠囊 |
| 點膠囊 | 展開 |
點標題欄 ⊙ |
回到默認位置（右上角） |
按 Escape |
收起 |
適用場景與注意¶
此插件適合需要頻繁對比或復現不同 Agent 行爲的開發者。
前置依賴：
* 需要已安裝並啓用 @deepseek-ai/dsh-agent-emulation 包，這是提供 13 個歸檔提示詞的來源。
* 僅支持 Web 平臺。
* Node 版本要求 ≥ 20。
權限與副作用：
* 插件僅執行 /agent 命令，不復制、不轉發任何提示詞正文到網絡或文件系統。
* 不修改已有的會話日誌內容，日誌始終作爲唯一真源。
* 不做任何網絡請求。
總結¶
該插件通過一個輕量級的懸浮窗，解決了 DeepSeek Harness 中切換 Agent 模式的操作成本問題，同時嚴格遵守了「零副作用」原則，確保了會話日誌的純淨與安全。
