dsh-file-manager：DeepSeek Harness Web 的文件管理與編輯視圖

前言¶

DeepSeek Harness（DSH）採用插件化架構，旨在通過外部組件擴展功能。在 Web Session 中，開發者往往需要跳轉外部編輯器來查看或修改代碼。dsh-file-manager 插件在 Web Session 的 conversation.view 中新增了 File 視圖，集成 Monaco 編輯器，爲 Web 環境提供了工作區文件樹、文本查看與編輯、語法高亮等能力，嚴格限制在當前 Session 的權威工作目錄中運行。

dsh-file-manager¶

dsh-file-manager 是由 starstorm-ai 維護的一個 DeepSeek Harness Web 插件。它通過 Monaco 編輯器爲 Web Session 提供文件管理與編輯視圖，不修改 DSH 源碼或替換 provider，安裝到任意兼容 DSH 的 Web Profile 後即可使用。

核心功能¶

文件瀏覽與管理
- 文件樹逐層加載、目錄優先排序並支持鍵盤導航。
- 緊湊文件欄與軌跡篩選欄，支持多文件 Tab 切換。
- 每個 Tab 獨立保留未保存內容、光標、選區和滾動位置。
代碼編輯與高亮
- 支持多種語言的語法高亮：TypeScript/JavaScript、JSON、HTML、CSS、Markdown、YAML、Shell、Python、Go、Rust、Java、C/C++。
- Monaco 樣式與 worker 在構建期內聯，運行時不訪問 CDN，保證加載速度。
安全與衝突處理
- 所有瀏覽與編輯嚴格限制在當前 Session 的權威 cwd 中。
- 保存使用讀取版本令牌和原子 replaceIfVersion，防止靜默覆蓋 Agent、Git 或外部編輯器已經修改的文件。
- 對二進制、無效 UTF-8、超限、權限、路徑和版本衝突有穩定錯誤碼與 UI 狀態。

安裝與啓用¶

在安裝前，請確保環境滿足以下要求：
* Node.js ^22.19.0 或 >=24.0.0
* pnpm 11.7.0

通過命令行安裝插件：

dsh plugin --profile web add dsh-file-manager

安裝成功後，在 Web Session 中切換到 File 視圖即可使用。

典型用法¶

插件安裝後，開發者可以直接在 DSH Web 中查看和編輯本地文件。

在終端生成可安裝的 .tgz 包（用於驗證或離線安裝）：

    pnpm pack

使用生成的包安裝（確保已停止正在運行的 Web 進程）：

    dsh plugin --profile web add .\dsh-file-manager-0.1.0.tgz

在 Web Session 中切換到 File 視圖，瀏覽文件樹並編輯代碼。

適用場景與注意¶

適用場景：適合需要在 DeepSeek Harness Web 環境中直接查看代碼、編輯代碼片段或進行簡單文件管理的場景。
版本限制：V1 暫不包含新建、刪除、重命名、二進制預覽、全局搜索和工作區級 LSP。
權限與安全：所有操作嚴格限制在當前 Session 的權威 cwd 中，避免對系統其他目錄造成影響。
更新提示：如果使用 pnpm dev:install 安裝，執行安裝命令後必須重啓 Web 進程才能看到新內容。

總結¶

dsh-file-manager 通過內聯 Monaco 資源和原子保存機制，在保證性能的同時提供了安全的文件編輯體驗，適合集成到 DSH 工作流中。更多細節請參考 GitHub 倉庫或 SkillHub 目錄。