前言¶
在 DSH「一切皆插件」的模式下，桌面窗口、運行時管理、平臺兼容、計費查看和文件編輯都可以作爲插件接入。dsh-desktop-tools 是一個 dsh 環境管理插件：安裝後，dsh web 可自動獲取桌面宿主並打開桌面窗口，同時提供環境面板彈窗、DeepSeek 官方計費面板和內置代碼編輯器。
這是什麼¶
dsh-desktop-tools 是 TypeScript 編寫的 dsh 環境管理插件，許可證爲 MIT，倉庫地址是 https://github.com/YUEEEEY/dsh-desktop-tools。它覆蓋幾類能力：
- 桌面窗口：Rust/Tauri 宿主按系統自動獲取；
- 運行時管理：提供一鍵更新入口；
- 平臺兼容：自動適配，非 Windows 自動跳過；
- DeepSeek 官方計費面板；
- 內置代碼編輯器：瀏覽與編輯工作區文件。
插件聲明 peerDependencies 爲 @deepseek-ai/schemastery ^3.18.1。
核心功能¶
桌面窗口¶
安裝插件後，可配備桌面窗口。宿主是 Tauri 2 二進制，約 5MB，支持 Windows / macOS / Linux。
啓動 dsh web 時，插件會自動獲取桌面宿主並打開桌面窗口。如果不想自動開窗，可以使用：
dsh web --no-desktop
環境面板彈窗¶
使用 Ctrl+Shift+P，或從托盤/菜單打開獨立面板窗口。面板內容包含宿主狀態、運行時、平臺兼容和計費摘要。
運行時一鍵更新¶
插件提供運行時一鍵更新能力。更新和平臺適配都依賴 dsh 安裝位置；無法定位 dsh 安裝時，會返回“未定位到 dsh 安裝”，但計費、編輯器與頁面功能不受影響。
平臺兼容自動適配¶
平臺兼容適配會按系統自動處理：非 Windows 自動跳過；配置 autoApplyPatches 僅在 win32 下生效。
DeepSeek 官方計費面板¶
插件提供 DeepSeek 官方計費面板，用於查看 DeepSeek 官方計費信息。
代碼編輯器¶
使用 Ctrl+Shift+E，或從托盤/菜單在主窗口內打開代碼編輯器，可以瀏覽與編輯工作區文件。
代碼視圖頂部可用「對話 / 代碼」切換，或用 Ctrl+B 回到對話視圖。
編輯器支持多標籤：按擴展名識別語言，Ctrl+S 保存，未保存文件有標記，狀態欄顯示路徑、語言和行列。也可以在運行時切換工作區根目錄，打開其它項目，無需重啓。
默認根目錄爲 dsh 工作區，可用配置 editorRoot 覆蓋。文件 API 包括：
/api/fs/tree
/api/fs/read
/api/fs/write
/api/fs/watch
/api/fs/changes
/api/fs/root
這些接口嚴格限定在工作區根目錄內，僅本地訪問；變更類接口同源校驗。
安裝與啓用¶
安裝命令：
dsh plugin --profile web add dsh-desktop-tools
安裝後啓動：
dsh web
插件會自動獲取桌面宿主並打開桌面窗口。若需關閉自動開窗：
dsh web --no-desktop
插件以當前 dsh 進程權限運行，安裝前應檢查源碼與許可證。
典型用法¶
下面介紹幾個可直接復現的用法。
1、打開環境面板：使用 Ctrl+Shift+P 或托盤/菜單，查看宿主狀態、運行時、平臺兼容和計費摘要。
2、打開代碼編輯器：使用 Ctrl+Shift+E 或托盤/菜單，在工作區內瀏覽和編輯文件。
3、切回對話視圖：在代碼視圖頂部點擊「對話 / 代碼」切換，或按 Ctrl+B。
4、保存文件：編輯完成後按 Ctrl+S；未保存文件會有標記，狀態欄顯示路徑、語言、行列。
5、切換項目：運行時切換工作區根目錄，打開其它項目，無需重啓。
6、網絡異常處理：網絡不可用時插件照常工作，只是暫不打開桌面窗口；之後可在面板點擊“重新獲取宿主”。
適用場景與注意¶
適合需要把 dsh web 接入桌面窗口、統一查看環境狀態並編輯工作區文件的開發者。
使用注意：
- 平臺兼容自動適配中，
autoApplyPatches僅win32生效，非 Windows 自動跳過； - 代碼編輯器默認根目錄爲 dsh 工作區；如需改變範圍，使用
editorRoot； - 文件 API 僅訪問工作區根目錄內，變更類接口同源校驗；
- 無法定位 dsh 安裝時，更新與適配會提示“未定位到 dsh 安裝”，但計費、編輯器與頁面功能不受影響；
- 插件以當前 dsh 進程權限運行，安裝前應檢查源碼與 MIT 許可證。
結尾¶
dsh-desktop-tools 把桌面窗口、環境面板、運行時管理、平臺兼容適配、計費面板和代碼編輯器放進同一個 dsh 插件裏，適合在 dsh web 日常使用中使用。
GitHub 倉庫：https://github.com/YUEEEEY/dsh-desktop-tools。
DSH 社區目錄是獨立站點，與 DeepSeek / 幻方無官方從屬關係；可在目錄中搜索 dsh-desktop-tools。
