前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。在純聊天界面中處理代碼文件和終端命令通常需要切換上下文或使用外部工具。dsh-ide-lite 插件將「文件」和「終端」標籤頁直接集成到 DSH WebUI 的會話界面中，爲開發者提供一個輕量級的本地編輯與運行環境。
插件簡介¶
dsh-ide-lite 是一個由 justarook1e 維護的輕量 IDE 插件。它將文件瀏覽、編輯、Agent 變更審閱以及集成終端功能注入到 WebUI 會話中。插件遵循 MIT 許可證。
核心功能¶
- 工作區側邊欄：提供項目文件樹（按層加載、Git 狀態着色、
.gitignore灰顯）及會話歷史管理（新建、切換、置頂、刪除）。 - 文件瀏覽與編輯：支持 24 種語言語法高亮、Markdown 渲染。提供獨立的撤銷/重做棧（僅撤銷用戶編輯）、自動保存及 Ctrl+S 手動保存。
- Agent 變更審閱：提供行級 diff 視圖。採用基線機制，接受變更即建立新基線，拒絕則將基線寫回磁盤，新增文件拒絕即刪除。
- 大文件可用：支持按需加載大文件內容並保留指紋，避免因文件體積導致無法審閱。
- 即時更新：Agent 對文件的改/增/刪操作約 1.5 秒內同步到界面；純換行符變化（CRLF/LF）不計入改動。
- 集成終端：獨立進程運行，支持 ANSI 顏色、進度條重寫、命令歷史。終端命令不受 Agent 沙箱限制，等同於本機終端。
- 運行按鈕：支持執行當前打開的代碼文件（如
.py,.js,.ts,.sh），優先使用項目內的本地運行時（如.venv、runtime\python\python.exe），有未保存編輯會先保存再運行。
安裝與啓用¶
安裝命令：
pnpm dsh plugin --profile web add @justarook1e/dsh-ide-lite
重啓與刷新：
安裝完成後，重啓 pnpm dsh web 並在瀏覽器中按 Ctrl+F5 刷新頁面。
桌面端安裝：
桌面應用擁有獨立的 desktop profile，無法通過上述 CLI 命令安裝。需在應用內左側欄的「插件」頁安裝同一個包 @justarook1e/dsh-ide-lite。
典型用法¶
- 運行代碼：在「文件」標籤頁打開代碼文件，點擊工具欄的運行按鈕即可執行。
- 終端操作：在「終端」標籤頁輸入
npm run dev或docker compose up等複雜命令。 - 審閱變更：當 Agent 修改文件後，在「文件」標籤頁的變更列表中選擇逐文件或全部接受/拒絕。
注意事項¶
- 版本兼容：適配 DSH
dsh-v0.1.7-rc.2；Host 半區兼容0.1.2-alpha.1到0.1.7-rc.2。 - 測試版狀態：包含實驗性功能（如撤銷/重做、自動保存），建議對重要數據做好備份。
- 權限差異：終端命令不受 Agent 沙箱限制，等同於本機終端。
- 文檔位置：插件文檔位於開發者本地工作副本，不隨 npm 發佈。
總結¶
該插件通過集成文件編輯、變更審閱和終端功能，降低了在 DSH 與外部工具間切換的損耗。更多細節可查閱 GitHub。
