前言¶
在使用 DeepSeek Harness 開發智能體時,處理文檔(如 Word、Excel、PDF)通常需要藉助外部服務。將文件上傳到服務器雖然方便,但存在隱私泄露風險,且對敏感文檔並不適用。本地處理是更安全的選擇。
插件介紹¶
jetformat/dsh-plugin 是 DeepSeek Harness 的一個插件,由 jetformat 維護。它通過本地調用 Jetformat CLI,實現了 Office 文檔轉 PDF、文本提取、文件驗證以及 PDF 的信息查看、合併、提取和渲染功能。該插件屬於客戶端類型。
核心功能¶
該插件註冊了以下工具,均通過本地 jetformat 二進制文件執行:
jetformat_to_pdf:將 Word、Excel 或 PowerPoint 文件轉換爲 PDF,根據文件擴展名自動選擇格式。jetformat_text:提取文檔文本內容(不包含 OCR)。jetformat_validate:對文件進行驗證。jetformat_pdf:提供 PDF 信息查看、合併、提取和渲染功能。
安裝與啓用¶
使用前需先安裝並登錄 Jetformat CLI,然後添加插件。
1、安裝並登錄 CLI:
npm install -g jetformat
jetformat login
2、添加插件:
dsh plugin --profile web add @jetformat/dsh-plugin
典型用法¶
插件運行時不會上傳文件到服務器,而是調用本地安裝的 jetformat 二進制文件進行處理。CLI 會與 jetformat.com 通信以進行登錄、付費命令的扣費以及匿名使用數據上報(可通過 jetformat telemetry off 關閉)。
注意事項與適用場景¶
- 網絡依賴:CLI 需要訪問
jetformat.com進行身份驗證和計費,插件本身不涉及文件上傳。 - 兼容性:已測試兼容 DeepSeek Harness (
@deepseek-ai/dsh) 0.1.5-rc.3。 - 權限與運行:插件在 DSH 進程的權限下運行,請確保本地環境配置正確。
- 閉源組件:Jetformat CLI 爲閉源軟件,插件本身採用 MIT 許可證。
總結¶
對於需要在本地安全處理 Office 和 PDF 文檔的開發者,這是一個直接集成的方案。
- 目錄:https://www.skillhub.cn/plugins/jetformat/dsh-plugin
- 倉庫:https://github.com/jetformat/dsh-plugin