dsh-doc-read
在终端中运行以下命令:
dsh plugin install dcd887/dsh-doc-read
将以下提示词粘贴到 DeepSeek Harness 对话框中:
在 DeepSeek Harness 的 dsh profile 目录执行 dsh plugin install dcd887/dsh-doc-read,并在 cordis.patch.yml 中启用该插件(源码见 https://github.com/dcd887/dsh-doc-read)。
插件介绍
在 Harness 里让智能体读长文档时,整本 PDF 或 Office 文件一旦全量进上下文,token 往往瞬间耗尽,还未必命中你要的那一句。dsh-doc-read 把「先摸清结构、再按页读、最后只捞命中行」拆成三条路径,查一个数不必把三百页都塞进来。
core 上是三个工具,越用越窄:doc_outline 先看总页数、字节量和每页一行预览;doc_read 在已知页码范围时读带页码标记的纯文本;doc_grep 用正则(可选)只返回命中行与页码。三者都带字符预算,并在结果里提示「下一页从哪读」,避免一口气撑爆窗口。格式覆盖 .pdf、.docx、.xlsx、.txt、.md、.csv。
需要说明的是只读不写;PDF 仅文本层,扫描件需先 OCR;xlsx 按 sheet 摊平,不保留合并单元格结构;单文件大小受 maxBytes 等配置约束。自带 fixtures 自测,也可用自有目录压测(grep 断言词需与文件内容一致)。
适合经常在 dsh 里查合同、报表、手册或日志里零星事实的开发者与智能体编排者——尤其是长 PDF 上只想 grep「违约金」一类关键词、只想看某几页时。
使用场景
- 合同或手册里用关键词定位条款与页码
- 已知章节页码后只读取指定页范围
- 上传长 PDF 前先预览大纲与每页摘要
适合人员
- 在 dsh 中编排文档问答的智能体开发者
- 需要处理 PDF、Word、Excel 等附件的 Harness 用户
- 希望控制上下文长度、避免整文档进窗口的团队