DSH 的理念是「一切皆插件」。在 Web 界面中直接調用本地 Windows 操作能力，是很多智能體開發者的需求。dsh-winagent 插件解決了這個問題，它把桌面版 WinAgent 的能力封裝進 DSH，讓你無需離開瀏覽器就能使用 Windows Agent 的功能。
插件介紹¶
這是一個由 HarrisXiu 維護的插件，授權協議爲 MIT。它的核心作用是將 WinAgent 的完整能力——包括 OpenAI 兼容 API / 本地 Ollama、53+ 個 Windows 工具、Skills、MCP 以及 LLM Wiki 個人知識庫——移植到 DSH 的 Web 界面中。
核心功能¶
- 聊天與交互：支持流式輸出、思維鏈摺疊、工具調用卡片。處理附件時支持圖片、文本和 PDF。對於危險操作，系統會彈出確認彈窗。
- 配置與設置：支持 Provider 管理（OpenAI 或 Ollama），可配置請求行爲、視覺輔助、人設提示詞，以及 skills/mcp/vault 的路徑。
- 個人知識庫：提供文件樹瀏覽、全文搜索、編輯功能，支持通過 URL 導入或上傳文件自動編譯入庫（LLM Wiki），包含 LINT / REFLECT 工作流。
- 文檔處理：支持 PDF、Word、Excel、PPT 的轉換與處理。
- 數據存儲：插件數據位於
$DSH_HOME/winagent/。
安裝與啓用¶
使用官方安裝命令即可：
dsh plugin --profile web add dsh-winagent
安裝完成後，需要重啓 dsh web 進程並在瀏覽器刷新頁面，插件纔會生效。
使用步驟¶
- 安裝並重啓
dsh web後，頁面右下角會出現 WinAgent 懸浮按鈕，點擊打開插件界面。 - 先在「設置」裏配置 Provider。如果是 OpenAI 兼容端，需填寫含
/v1的 Base URL + API Key + 模型；如果是本地 Ollama，配置 Ollama 服務地址即可。 - 配置完成後，直接在輸入框下指令即可使用。
適用場景與注意¶
- 權限與安全：插件以當前 Windows 用戶權限執行工具。刪除、寫註冊表、結束進程、執行命令等危險操作默認需要彈窗確認，可在設置裏關閉，但需謹慎操作。API Key 以明文存於
$DSH_HOME/winagent/config.json（用戶私有目錄），請勿分享該目錄。 - 範圍說明：個性化桌寵主題（如立繪）不在本插件範圍內；人設提示詞可在設置裏自由修改。
總結¶
dsh-winagent 插件通過將桌面版 WinAgent 的能力集成到 DSH 的 Web 界面，實現了在瀏覽器中直接操作 Windows 系統的能力。開發者可以在配置好 Provider 後，直接在 Web 界面使用 53+ 個 Windows 工具、管理個人知識庫並處理各類文檔。
