Skip to main content

​
安装并配置 SoMark 插件

1

安装插件

确认 DeepSeek Harness 已可正常运行，再将 dsh-tool-somark 安装到需要使用的 profile。安装完成后，重新启动对应的 profile。插件会自动注册 somark_parse 工具。
2

配置 API Key

推荐在启动 DeepSeek Harness 的终端中通过环境变量配置 SoMark API Key。
还没有 API Key？前往 SoMark API 工作台获取 API Key。免费额度无需领取，会自动发放到账户（每日 500 页、每月 2000 页）。
3

按 profile 配置（可选）

如果不使用环境变量，也可以在该 profile 的 cordis.patch.yml 中配置 API Key：
请勿将包含真实 API Key 的配置文件提交到 Git 仓库。

​
在 DeepSeek Harness 中解析文档

1

准备文档

将待解析的 PDF、图片、Word 或 PPT 文件放在当前 DeepSeek Harness 工作区可访问的位置，并确认文件路径为绝对路径。
2

发送解析指令

在对话中直接告诉 Agent 要解析的文件和处理目标。例如：
  • “使用 SoMark 解析 /workspace/report.pdf，总结主要结论。”
  • “把 /workspace/contract.docx 解析成 Markdown，并提取关键条款。”
  • “解析 /workspace/slides.pptx，按章节整理内容。”
Agent 会调用 somark_parse 读取文件并等待 SoMark 完成解析。
3

使用解析结果

解析完成后，您可以继续让 Agent 总结内容、提取字段、整理表格，或将结果保存为 Markdown 等格式。

​
插件参数与输出

​
输入参数

​
常用配置

以下配置写在 tool-somark 的 config 中。未填写时使用插件默认值。 完整配置项与默认值请查看插件仓库的 README。

​
返回结果

​
注意事项

  • somark_parse 一次解析一个文件。需要处理多个文件时，请让 Agent 逐个调用工具。
  • 插件通过 DeepSeek Harness 的文件系统读取文档，因此文件需要位于当前工作区允许访问的位置。
  • 插件会将文档发送到 SoMark API 进行解析，请确认文档符合您的数据安全与合规要求。