DeepSeek Harness 右側欄文件編輯插件：dsh-right-editor

前言¶

DeepSeek Harness（DSH）採用插件化架構，允許開發者擴展 Web 界面的功能。在使用 Web 環境進行開發或調試時，開發者經常需要快速查看或修改當前會話工作區的文件。dsh-right-editor 是一個面向 DSH Web 的右側欄插件，旨在將文件瀏覽與編輯能力集成到界面右側，減少開發者切換窗口或打開外部編輯器的操作成本。

該插件由 banttethai-ops 維護，遵循 MIT 協議。它通過直接在 DSH Web 界面中提供文件操作能力，實現了從瀏覽目錄、編輯文本到查看 Office 文檔的一站式體驗。

核心功能¶

• 文件瀏覽：面板默認從當前會話工作區開始。支持目錄導航、返回上級、刷新列表，以及通過路徑欄輸入絕對路徑進行跳轉。
• 文本/代碼編輯：支持查看並編輯任意 UTF-8 編碼的文本文件（上限 8MB）。編輯後可通過 Ctrl+S 或面板上的保存按鈕將修改寫回原文件。
• 圖片處理：支持 png、jpg、jpeg、gif、webp、bmp、svg、ico、avif 格式。提供亮度、對比度、灰度調節，以及 90° 旋轉和水平/垂直翻轉功能，調整後可直接保存回原文件。
• Word 文檔 (docx)：支持查看與原位編輯。可以修改正文段落、表格單元格，並保留原有樣式，保存後寫回原文件。
• Excel 表格 (xlsx)：支持查看與原位編輯。支持切換工作表標籤以及修改單元格內容，保存後寫回原文件。
• PPT 演示 (pptx) 與 PDF：均爲只讀模式。支持逐頁文本預覽（PDF 爲文本型 PDF 的提取預覽，掃描件需配合 OCR）。

安裝與啓用¶

1. 前置條件：

   • 確保 DSH Web 正在運行（通過 dsh web 命令或桌面版）。
   • 安裝 Node.js ≥ 20。

2. Python 依賴（可選）：
   若需要編輯 Word、Excel、PPT 或 PDF 文檔，需安裝 Python 3 及相關依賴庫：

    pip install python-docx openpyxl python-pptx pdfplumber

若未安裝上述庫，插件仍可正常瀏覽目錄、編輯文本和圖片，但無法解析 Office/PDF 文檔。

3. 執行安裝：
   在 DSH 所在環境執行以下命令：

    dsh plugin --profile web add dsh-right-editor

4. 加載插件：
   安裝完成後，需硬刷新瀏覽器（Windows/Linux 使用 Ctrl + Shift + R，Mac 使用 Cmd + Shift + R）才能在頂部標題欄右側看到 📝 按鈕。

典型用法¶

1. 打開面板：在 DSH 頂部標題欄右側點擊 📝 按鈕，右側欄會展開文件瀏覽面板。
2. 瀏覽文件：點擊目錄進入，點擊 ⬆ 返回上級，或直接在路徑欄輸入絕對路徑並回車。
3. 編輯文本：打開文本文件後直接編輯，點擊“💾 保存”或按 Ctrl+S。
4. 編輯圖片：打開圖片後使用滑塊調整參數，點擊“💾 保存”。
5. 編輯 Office 文檔：點擊 Word 或 Excel 文件右上角的“✏️ 編輯”按鈕進入編輯態，修改後保存。
6. 查看文檔：PPT 和 PDF 文件僅支持只讀預覽，無法直接編輯。

適用場景與注意¶

• 權限範圍：文件操作權限繼承自當前 DSH 進程的授權策略，與用戶對當前會話的權限一致。
• 安全機制：Office 和 PDF 的解析腳本通過標準輸入流（stdin）傳入 Python，不會將腳本落盤，避免被 Temp/inspect.py 等文件干擾。
• 只讀限制：PPT 和 PDF 僅提供文本預覽，不支持修改。
• 風險提示：插件通過 DSH 的沙箱策略運行，建議在安裝前檢查源碼與許可證。

結語¶

dsh-right-editor 將本地文件系統的瀏覽與編輯能力無縫集成到 DSH Web 界面中，適合需要頻繁處理文檔或配置文件的智能體開發者使用。

• 項目主頁：GitHub - dsh-right-editor
• 生態目錄：DSH 生態目錄 - dsh-right-editor