前言¶
DeepSeek Harness (DSH) 采用插件化架构，旨在通过「一切皆插件」的方式扩展能力。在网页端开发或使用过程中，直接读取本地文档（如 PDF、Word、PPT）并填入对话输入框，往往需要手动复制粘贴，效率较低。dsh-document-reader 插件解决了这一痛点，为 DSH 的 Web Profile 增加了文件读取能力，支持通过上传或拖拽的方式将文档内容导入到编辑器中。
插件定位¶
- 名称：dsh-document-reader
- 类别：客户端
- 作者：Yun-tech123
- 许可证：MIT
- 核心价值：在 DSH 聊天界面的输入框中，直接读取 PDF、Word、PPT 及纯文本文件的内容。
核心功能¶
该插件主要提供以下三种交互方式与支持格式：
-
上传读取
安装后，输入框工具栏会出现「文档」按钮。点击该按钮，系统会弹出文件选择框，支持多选文件。 -
整页拖拽
将文档文件拖动到页面任意位置，界面会出现「释放以读取文档」的遮罩提示，松手后即可触发读取。 -
格式与限制
- 支持格式：PDF、.docx、.pptx、以及 txt、md、csv、yaml、代码文件。
- 输出上限：单文件读取字符数上限为 20 万，超出部分会自动截断。
安装与启用¶
使用 DSH 的命令行工具安装插件。安装过程会自动注册到 dsh.profile.bundles。
- 执行安装命令：
dsh plugin --profile web add github:Yun-tech123/dsh-document-reader
- 重启 Web 服务：
dsh web
- 刷新页面后，在输入框工具栏即可看到新增的「文档」按钮。
典型用法¶
安装完成后，可以通过以下两种方式使用：
- 点击输入框工具栏的「文档」按钮，选择本地文件。
- 直接将文件拖拽至页面任意空白处。
适用场景与注意¶
该插件以 DSH 进程当前的权限运行。在使用前，建议检查源码与许可证。
- PDF 限制：该插件仅支持文本提取。对于纯扫描件（图片型 PDF），因为没有文本层，无法提取内容。
- 旧版格式：老式的二进制 .doc、.xls、.ppt 格式暂不支持，请先转换为 .docx 或 .pptx 格式。
- 浏览器要求：需要较新的浏览器环境，支持
.docx/.pptx解压（Chrome/Edge/Firefox 2022 及以上版本）。
结语¶
dsh-document-reader 为 DSH 用户提供了便捷的文件导入手段，减少了手动输入的繁琐步骤。更多细节与源码，请参考项目目录或 GitHub 仓库。
