前言¶

DeepSeek Harness (DSH) 是一個支持插件化擴展的智能體開發框架。在構建能夠處理辦公文檔的智能體時，開發者通常需要手動編寫文件解析邏輯或集成第三方庫。dsh-doc-toolkit 是一個爲 DSH 設計的文檔讀寫工具包，由開發者 qingmumingyang 維護。它通過提供標準的讀寫工具接口，解決了 AI 助手直接讀取與生成 PDF、Word、Excel、CSV 等常用格式文檔的需求。

核心功能¶

該插件提供以下核心能力：

1. 多格式支持：支持讀取與寫入 PDF、DOCX、XLSX、CSV 四種格式。
2. 大文件處理：通過 limit 和 offset 參數控制返回行數，防止上下文溢出。
3. 中文 PDF 導出：支持生成 PDF 文檔，中文內容會自動查找系統 CJK 字體並子集化嵌入，確保文本可複製與可搜索。
4. AI 友好接口：解析結果直接返回純文本或 TSV 格式，方便大模型理解與處理。
5. 內置 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 提供。

資源鏈接¶

• GitHub 倉庫
• 插件目錄頁