前言¶
在使用 DeepSeek Harness (DSH) 進行本地文檔處理時，直接拖入 Office 文檔或壓縮包通常需要經過特定的“增強導入”流程。該插件通過攔截 read 工具，在不修改官方源碼的前提下，將 DOCX、XLSX、PPTX、CSV 和 ZIP 文件的解析能力接入原生拖放和粘貼操作。
插件定位¶
該插件是 DeepSeek Harness 的外部擴展，由用戶 aa2246740 維護。它通過官方的 tools/execute 接口分流，爲支持的文檔類型提供自動的結構目錄、預覽和定位信息，同時保持原有圖片、文本和 PDF 的原生處理能力。
核心功能¶
- 文檔類型支持：支持拖放文件、文件夾、ZIP 以及 Office 附件（DOCX、XLSX、PPTX、CSV）。
- Office 解析增強：Agent 調用
read時自動獲取 Office 文件的結構目錄、預覽和定位信息。 - ZIP 處理邏輯：ZIP 文件先列目錄，再按條目路徑讀取文本或代碼，不自動展開嵌套壓縮包。
- 緩存機制：解析緩存位於
$DSH_HOME/dragndrop-attachments/v1/native-cache。
安裝與啓用¶
安裝後需等待當前任務完成，重啓 Host 或刷新頁面才能生效。
Web UI¶
dsh plugin --profile web add github:aa2246740/dsh-dragndrop-attachments
官方桌面端 / DSH Studio¶
打開 設置 → 插件 → 添加插件，在“包名或地址”中填入：
github:aa2246740/dsh-dragndrop-attachments
也可下載最新 Release 的 .tgz 文件，填入該文件的絕對路徑。
使用方法¶
- 常規操作：照常拖放、粘貼或使用原生附件按鈕。已有原生拖放不會被整體攔截。
- Office 文件：Agent 調用
read時自動獲得增強信息，支持按需讀取表格、幻燈片或文檔段落。 - ZIP 文件：插件會先列出目錄結構，再根據路徑讀取內容，不佔用工作區空間。
- 文件夾處理：
- 桌面端：拖入文件夾保留原生本地路徑引用。
- Web UI：拖入文件夾自動保存快照，也可通過+菜單手動添加文件夾快照。
適用場景與限制¶
- 平臺限制：Office 解析僅承諾在 macOS Apple Silicon 平臺使用 OfficeCLI 1.0.144。
- 功能範圍：不支持 DOC/XLS/PPT 舊格式、OCR、公式重算和複雜圖表視覺理解。PDF 和圖片能力由官方 DSH 提供。
- 文件大小：單個增強讀取文件最大 50 MiB，展開 ZIP 最大 256 MiB。大文件需要分段查詢。
- 權限與數據：插件通過當前會話的文件系統讀取，保留權限；結果行號是解析行號，非文件編輯行號。解析緩存位於
$DSH_HOME/dragndrop-attachments/v1/native-cache；卸載不主動刪除歷史數據。
總結¶
該插件爲 DSH 提供了無需手動配置即可增強文檔讀取體驗的能力。通過保留原生交互方式和緩存機制，它在提升文檔處理效率的同時，維持了系統的穩定性和兼容性。插件目錄與 GitHub 鏈接見上方信息。
