前言¶
DeepSeek Harness (DSH) 是一个支持插件化扩展的智能体开发框架。在构建能够处理办公文档的智能体时，开发者通常需要手动编写文件解析逻辑或集成第三方库。dsh-doc-toolkit 是一个为 DSH 设计的文档读写工具包，由开发者 qingmumingyang 维护。它通过提供标准的读写工具接口，解决了 AI 助手直接读取与生成 PDF、Word、Excel、CSV 等常用格式文档的需求。
核心功能¶
该插件提供以下核心能力：
- 多格式支持：支持读取与写入 PDF、DOCX、XLSX、CSV 四种格式。
- 大文件处理：通过
limit和offset参数控制返回行数，防止上下文溢出。 - 中文 PDF 导出：支持生成 PDF 文档，中文内容会自动查找系统 CJK 字体并子集化嵌入，确保文本可复制与可搜索。
- AI 友好接口：解析结果直接返回纯文本或 TSV 格式，方便大模型理解与处理。
- 内置 Skill：插件加载时会自动注册
doc-toolkit-usage技能，引导 AI 何时以及如何调用读写工具。
安装与启用¶
安装前请确保你的 DSH 版本满足兼容性要求（>=0.1.0-rc.12 <0.2.0）。插件在 Web 运行时下注册。
执行以下命令进行安装：
dsh plugin --profile web add https://github.com/qingmumingyang/dsh-doc-toolkit
安装完成后，插件会自动注册相应的工具与 Skill。
典型用法¶
安装并启用后，AI 助手即可使用自然语言调用以下功能：
- 读取文档：
> “帮我读取 D:\report.pdf 的内容”
> “读取 D:\data.xlsx 的前 50 行” - 写入文档：
> “生成一份销售报告 DOCX，包含标题和三个段落，保存到 D:\sales.docx”
底层调用时会解析为结构化的读写接口。
注意事项¶
- 版本兼容性：仅支持 DSH 版本
>=0.1.0-rc.12 <0.2.0。 - PDF 限制：
- 读取 PDF 时，文件必须包含文本层，不支持扫描件 OCR（光学字符识别）。
- 写入 PDF 时，支持标题、段落和表格，中文会自动嵌入字体。
- Node.js 环境：Node.js v18+ 仅在安装或开发时需要，插件运行时由 DSH 提供。
