前言¶
在使用 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 链接见上方信息。
