dsh-file-review：DeepSeek Harness 的文件瀏覽側邊欄

前言¶

DeepSeek Harness (DSH) 採用插件化架構，旨在通過擴展實現功能解耦。在使用本地開發環境或編寫智能體時，應用內缺乏直接管理文件的能力，通常需要依賴外部終端或文件管理器。dsh-file-review 旨在解決這一痛點，爲 Harness 提供一個可停靠、可調整大小的文件瀏覽側邊欄與編輯器。

插件介紹¶

dsh-file-review 是一個 DeepSeek Harness 客戶端插件，由開發者 ylw-a 維護。它主要解決在 DSH 環境下無法直接瀏覽本地文件樹、進行文件讀寫操作以及查看 Markdown 渲染的問題。

核心功能¶

該插件提供了一套完整的文件管理能力，具體包括：

文件樹側邊欄
- 支持停靠在左或右，寬度可在 220px 到 900px 之間調整。
- 支持目錄懶加載、全部展開/摺疊，以及工作區搜索。
右鍵菜單操作
- 提供剪切、複製、粘貼、複製絕對/相對路徑、重命名、刪除到回收站等操作。
- 支持新建文件/文件夾、刷新、以及在 VS Code 中打開文件。
統一編輯器
- 集成 Shiki 語法高亮與直接編輯功能，實現“預覽即編輯”。
- 編輯器具備防抖高亮、滾動同步以及 Ctrl/Cmd+S 保存功能。
Markdown 支持
- 默認以語法高亮的源碼模式編輯。
- 支持渲染與編輯模式的切換。
自動刷新機制
- 可見目錄樹每約 2 秒輪詢一次，僅在文件簽名變化時重渲染。
- 執行寫入操作時立即刷新。
雙宿主模式
- 無會話時以浮動編輯器窗口顯示。
- 有會話時自動切換爲固定文件標籤頁（與對話/軌跡標籤頁共存）。
安全刪除
- 刪除文件時通過 PowerShell Microsoft.VisualBasic 發送至 Windows 回收站，非永久刪除。

安裝與啓用¶

在安裝前，請確保已安裝 DeepSeek Harness 並配置了本地 web 模式。

進入插件源碼目錄。
構建項目：

    npm install
    npm run build

添加插件到 Harness 配置：

    dsh plugin --profile web add -w <path-to-this-package>

重啓 Harness 以加載插件。

典型用法¶

文件操作：在側邊欄右鍵點擊文件，選擇“複製絕對路徑”可直接獲取路徑供智能體調用。
代碼編輯：點擊文件進入編輯模式，直接修改代碼，按 Ctrl/Cmd+S 保存，編輯器會自動根據 Shiki 進行語法高亮。
Markdown 預覽：在 Markdown 文件中切換至“渲染”視圖查看排版效果。

適用場景與注意¶

適用場景：適合需要在 DSH 環境中直接查看、修改或創建本地代碼文件、配置文件或文檔的開發者。
權限與依賴：插件以當前 DSH 進程權限運行，刪除操作需系統允許。安裝前建議檢查源碼與許可證。
技術細節：編輯器客戶端內聯了 Shiki（使用 JS 正則引擎，非 WASM），依賴 DSH 的本地 web 模式配置。構建產物 lib/ 和設計文檔 docs/ 未提交至倉庫。

結語¶

dsh-file-review 通過側邊欄與編輯器的結合，補齊了 DeepSeek Harness 在本地文件處理上的短板。若需進一步瞭解或獲取源碼，可訪問插件目錄或 GitHub 倉庫。