前言¶
在 DeepSeek Harness 的 Web 界面中，Agent 修改文件時缺乏直觀的實時反饋。開發者需要頻繁切換標籤頁或查看終端輸出，才能確認修改內容。dsh-code-studio 插件將文件變更監視和代碼編輯功能集成在 DSH Web UI 內部，解決了這一問題。
插件介紹¶
這是一個由 WindyPro-rourou 維護的插件，定位爲 DSH Web UI 內的文件變更監視器與代碼編輯器。它允許用戶在不離開瀏覽器界面的情況下，實時查看 Agent 對文件的修改（以 Diff 形式呈現），並進行還原或手動編輯。
核心功能¶
該插件提供以下核心能力：
1. 實時文件修改監視：基於會話工具事件直推，不依賴文件系統輪詢。
2. 多工作區覆蓋 + 切換器：支持多工作區切換，按會話記憶。
3. 按會話隔離：每個 Code Studio 只響應當前會話的修改。
4. 會話狀態記憶：變更列表、打開的標籤、面板寬度、過濾條件按會話保留。
5. 一鍵還原：每個變更條目帶還原按鈕，可撤銷 Agent 在本會話內的全部修改。
6. 修改歷史時間線：按時間倒序回放 Agent / 用戶 / 還原事件。
7. 發送到會話：把當前打開的文件內容一鍵發給當前會話的 Agent。
8. 語法高亮編輯器：行號、光標、滾動同步，支持 Ctrl+S 保存。
9. 大文件虛擬滾動：Diff 視圖窗口化渲染，支持萬行級文件流暢滾動。
10. SSE 斷線自愈：事件帶序號 + 服務端環形緩衝，斷線重連自動補發丟失的變更。
11. 變更過濾搜索：按路徑關鍵詞 + 文件類型過濾變更列表。
12. 鍵盤快捷鍵：Ctrl+Alt+C 開關面板，Alt+↓/↑ 在變更間跳轉。
13. 可拖拽面板：寬度自由調整，UI 與 DSH 主題一致。
安裝與啓用¶
使用以下命令安裝插件：
dsh plugin --profile web add @windypro-rourou/dsh-code-studio
安裝完成後，重啓 dsh web 服務，左側邊欄會出現 Code Studio 入口。
典型用法¶
- 打開面板：通過對話頭部工具欄的變更膠囊或側邊欄入口打開 Code Studio。
- 查看修改：讓 Agent 修改代碼，面板會自動浮現該文件的逐行 Diff（
+新增 /−刪除 /~修改）。 - 還原修改：對不滿意的修改點點擊「還原」，一鍵回到 Agent 動手前。
- 文件操作：在「文件」頁籤中切換工作區、瀏覽文件樹、直接編輯保存。
- 快速定位：使用頂部搜索框 + 類型篩選快速定位變更。
注意事項¶
- 插件以當前 DSH 進程權限運行，安裝前應檢查源碼與許可證。
- 單文件超過 512KB 不讀取內容。
- 超過 100KB 的歷史事件內容會截斷保存。
- 通過 bash/pwsh 等非文件工具寫入的變更依賴文件監視兜底，可能有少量延遲。
- 還原點保存在內存中，服務重啓後丟失。
短結尾¶
該插件通過提供實時的 Diff 視圖和內置編輯器，簡化了 Agent 代碼編輯的交互流程。更多細節可參考插件目錄或GitHub 倉庫。
