DeepSeek Harness 原生插件，新增 `read_document` 工具处理内置 read 工具搞不定的 PDF / DOCX / XLSX 提取。MIT 许可，要求 harness 0.1.3+。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-09-06
许可证
MIT
01它能帮你完成什么？
读取内置 read 工具拒绝的二进制文档（PDF / DOCX / XLSX）
结构化文本提取，外加编码回退、分页与按工作表读取 XLSX 的能力，供模型消费
需要把二进制文档（PDF / DOCX / XLSX）喂给模型消费的 DeepSeek Harness 用户
从已上传的工作簿中读取指定的某个 Excel 工作表
`list_sheets` 列出工作表，`sheet` 参数整表读取（无行数上限）；越界时报错并列出可用工作表
处理表格数据、需要按工作表而非整文件读取的 DeepSeek Harness 用户
02如何接入 DeepSeek Harness？
前置条件
- Requires harness ≥ 0.1.3-alpha.1.
安装步骤
- 01
$ curl -fsSL https://raw.githubusercontent.com/taxueseek/dsh-files/main/install.sh | sh
- 02
# restart dsh web
- 03
$ dsh plugin --profile web add git+https://github.com/taxueseek/dsh-files.git
- 04
# restart dsh web
验证接入成功
作者未说明
03DSH 适配与能力边界
DeepSeek Harness 原生插件：提供 `read_document` 工具，补足 harness 0.1.3 内置 read 工具在 PDF / DOCX / XLSX 提取上的空缺，读取经由 `ctx.fs` 并继承会话沙箱
内容嗅探
已上传文档的字节→依据字节判断格式（PDF 头 / ZIP 成员 / UTF-8 / UTF-16 BOM / GB18030）；伪装文件被拒绝
编码链路
编码未知的文本内容字节→UTF-16 BOM → UTF-8（致命）→ GB18030（致命）→ 无 BOM 的 UTF-16；GBK 与无 BOM UTF-16 均可读取
分页读取
文档句柄 + 行偏移/限制→行号 + 偏移/限制；每次调用的字符预算随格式变化，超出则以剩余行标记截断
XLSX 按工作表读取
已上传的 .xlsx 工作簿→`list_sheets` 列出工作表；`sheet` 参数整表读取（无行数上限）；越界时报错并列出可用工作表
协作式取消
进行中的解析→用户取消 / 会话关闭时立即中止解析
04适合谁？何时不该用？
适合
- 需要把二进制文档（PDF / DOCX / XLSX）喂给模型消费的 DeepSeek Harness 用户
- 处理表格数据、需要按工作表而非整文件读取的 DeepSeek Harness 用户
不适合
- 名为 dsh-files 的 npm 包是一个无关的第三方占位包——只能通过官方安装脚本或 `dsh plugin add` 的 git 命令安装，切勿执行 `npm install dsh-files`。
05兼容性、维护与安全提示
- 名为 dsh-files 的 npm 包是一个无关的第三方占位包——只能通过官方安装脚本或 `dsh plugin add` 的 git 命令安装，切勿执行 `npm install dsh-files`。
- 没有文本层的 PDF 会返回明确的提示而非提取出的文本——dsh-files 不会对扫描件做 OCR。
- 需要 harness ≥ 0.1.3-alpha.1；更早的 harness 版本不被支持。
readme_verified
06常见问题
dsh-files 能做而内置 read 工具做不到的是什么？
内置 read 工具会以 `FS_NOT_TEXT` 拒绝二进制内容。dsh-files 新增 `read_document` 工具，对 PDF / DOCX / XLSX 做结构化文本提取，并提供编码回退、分页与按工作表读取 XLSX。
怎么安装 dsh-files？
运行 `curl -fsSL https://raw.githubusercontent.com/taxueseek/dsh-files/main/install.sh | sh`，或 `dsh plugin --profile web add git+https://github.com/taxueseek/dsh-files.git`，然后重启 dsh web。需要 harness ≥ 0.1.3-alpha.1。
名为 dsh-files 的 npm 包是同一个插件吗？
不是。名为 `dsh-files` 的 npm 包是一个无关的第三方占位包——只能通过官方脚本或上面的 git 命令安装。
扫描版 PDF 会怎样处理？
没有文本层的 PDF 会返回明确的提示，而不是空字符串。dsh-files 不会对扫描文档做 OCR。
需要哪个 harness 版本？
需要 harness ≥ 0.1.3-alpha.1。
07相关的 DSH 工作流
dsh-tui
作者 ccch1mneyyy
DSH's officially top-recommended TUI plugin — high performance, low overhead, cute pixel whale, smooth mouse interaction. One-command install via npm. / DSH 官方首推的 TUI 插件，高性能低占用，可爱像素鲸鱼，流畅鼠标交互，npm 一键安装
dsh-better-sidebar
作者 omdsh-dev
开放的侧边栏底座，支持三方拓展注册新侧边栏页面。内置文件渲染编辑/终端/侧边对话/Git/子代理页面 ｜ Open sidebar foundation, supports third-party extensions to register new sidebar pages. Built-in file rendering/editing, terminal, side chat, Git, and sub-agent pages.
dsh-tianshu-tui
作者 huiliyi37
官方 DeepSeek Harness 的交互式终端 UI 插件：自研 ANSI 极简交互渲染、流式 Markdown/工具卡、16+ 主题、slash 命令与选择器、输入历史与本地偏好持久化、LSP 诊断、memory记忆，很丝滑的开发体验。
dsh-damage-pulse
作者 wssfk12138
DeepSeek Harness Token 余额监控插件：鲸鱼娘待机/扣费/复苏动画、峰谷计费、连续扣费飘字与会话费用统计。
08数据与来源
A DeepSeek Harness plugin that does exactly one thing: the **`read_document` tool** — structured text extraction for bin…
Reads go through `ctx.fs`, inheriting the session sandbox, same rights as the built-in read tool
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成；最后核验于 2026-09-06。发现错误？提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件，覆盖各个分类。