在 DSH 的开发与调试流程中，让智能体访问本地文件系统往往涉及上传、沙盒配置或临时存储等步骤。dsh-doc-quick 插件提供了一种更直接的方案：通过 Web 界面拖拽文件，由 Agent 直接读取本地文件内容并进行处理。
这是一个 DSH 插件，允许用户将文档拖入 Web 对话框，宿主程序将文件保存至本地目录，Agent 读取文件后，在右侧侧栏展示处理结果与文件路径。
核心功能¶
拖拽与存储¶
用户将文件拖入 Web 对话框后，宿主程序会将文件保存至 ~/.dsh/doc-quick/<sessionId>/ 目录，并注册一个任务。
本地文件读取¶
插件允许宿主直接读取本地文件系统。支持的格式包括：PDF、Word (doc/docx)、PowerPoint (ppt/pptx)、EPUB、Notebook (ipynb)、Markdown 和纯文本。
Agent 工具¶
插件为 Agent 提供了三个工具：
* doc_list：查看当前待处理的任务列表。
* doc_read：读取指定文件的内容。
* doc_complete：将处理后的产出注册回插件系统。
结果侧栏¶
处理完成后，对话界面的右侧会弹出侧栏，显示任务状态、摘要以及输出文件路径。用户可以点击链接预览或下载结果。
安装与启用¶
该插件依赖 DSH 的 Web Profile。安装命令如下：
dsh plugin --profile web add github:Entity-Him/dsh-doc-quick
插件本身是纯 JavaScript 实现，不包含原生或 Node-gyp 依赖。PDF 解析会按需加载 pdfjs-dist，如果不可用则能优雅降级。
典型用法¶
- 打开 DSH Web 聊天界面。
- 将需要处理的文档（如 PDF 或 Markdown）拖入输入框。
- 向 Agent 发出指令，Agent 会自动识别已挂载的文件并进行读取和处理。
- 任务完成后，右侧侧栏会列出输出内容和文件路径，支持直接预览或下载。
适用场景与注意¶
此插件适合需要在 Web 环境下快速处理本地文档的场景。使用前需确保当前使用的是 DSH Web Profile（侧栏是 Web 客户端 UI）。
- 依赖环境：必须启用 Web Profile。
- 文件处理：PDF 解析依赖
pdfjs-dist，环境未配置时可能无法解析。 - 许可证：MIT 许可证。
- 生态归属：该插件收录于 DSH 生态目录，与 DeepSeek / 幻方无官方从属关系。
总结¶
dsh-doc-quick 将本地文件系统的读写能力通过插件形式注入到 DSH Web 聊天中，配合右侧侧栏展示结果，降低了文档处理的交互成本。更多细节与源码可访问项目主页查看。
- GitHub 仓库：https://github.com/Entity-Him/dsh-doc-quick
- 生态目录：https://www.skillhub.cn/plugins/QinpanWan/dsh-doc-quick
