前言¶
在使用 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