← 返回列表
未验证
一个 DeepSeek Harness 插件，为模型提供 somarkparse 工具：通过 SoMark 文档解析…
尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。 · 最近上游提交 2026/8/14 · 已提供中文文档
DeepSeek Harness 的 SoMark 文档解析工具（somark_parse）插件
综合分
27.8
GitHub 分
27.8
用户评分
—
★ Stars
2
周下载量
—
安装插件（需先安装 dsh CLI 引擎：npm install -g @deepseek-ai/dsh）
dsh plugin --profile web add SoMarkAI/dsh-tool-somark该插件未发布到 npm，走 GitHub 源安装（pnpm 若拦截 prepare 脚本，按其提示在 pnpm-workspace.yaml 的 allowBuilds 中放行后重跑）
信任档位：仅索引本站尚未对其实装验证，仅收录元数据
- 是什么
- dsh 原生插件 · tool
- 装得上吗
- 本站尚未做安装检查
- 安全吗
- 本站尚未对该插件做风险分级（暂未覆盖，不等同于无风险）
- 还在维护吗
- 更新放缓：最近一次提交在 42 天前
档位由下列信号合成：本站实装验证（真实安装，当前最高到 L4）· 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。 验证判据与等级说明 →
数据截至 2026/9/20（元数据每日更新 · 实装验证按队列轮转，单条结论的验证时间见上方）
依赖的 DSH / Cordis 模块
@deepseek-ai/schemastery@deepseek-ai/cordis@deepseek-ai/cordis-plugin-loader@deepseek-ai/dsh-brand@deepseek-ai/dsh-fs@deepseek-ai/dsh-fs-local@deepseek-ai/dsh-invariants@deepseek-ai/dsh-launch-environment@deepseek-ai/dsh-llm@deepseek-ai/dsh-scope@deepseek-ai/dsh-session@deepseek-ai/dsh-system-prompt用户评分
还没有人投票，来当第一个
订阅周报，不错过优质插件更新
每周一封 · 高评分插件 + 新用户活动
README
由 DeepSeek 最新模型翻译生成dsh-tool-somark
一个 DeepSeek Harness 插件，为模型提供 somark_parse 工具：通过 SoMark 文档解析 API 将 PDF、图片、Word 和 PowerPoint 文件解析为保留结构的 Markdown 和 JSON，并附带页数和 token 计数。
文档读取通过 ctx.fs 进行，因此任何已挂载的文件系统策略都会应用于该读取。解析后的内容作为数据返回，绝不能被执行。
安装
从 npm 安装（发布后）
dsh plugin --profile add dsh-tool-somark
从 tarball 安装
dsh plugin --profile add ./dsh-tool-somark-0.1.0.tgz
从 git 安装（需要该包的 prepare 构建；参见 harness 文档）
dsh plugin --profile add github:you/dsh-tool-somark
然后启动该 profile；somark_parse 工具会自动注册。该插件也可作为普通库依赖用于编程式解析（src/client.ts 导出 API 客户端）。
要求
- 一个带有基础 bundle（@deepseek-ai/dsh-base）的 DeepSeek Harness profile，它提供 ctx.tools 和 ctx.fs。
- 一个 SoMark API 密钥。在环境中设置 SOMARK_API_KEY，或配置下方的 apiKey。SoMark 是一个外部付费服务，会接收上传的文档内容。
配置
所有字段均为可选；省略时应用默认值。
| 字段 | 默认值 | 含义 |
| --- | --- | --- |
| apiKey | 未设置 | SoMark API 密钥 $SOMARK_API_KEY 为空 → 工具在执行时报错。 |
| baseURL | https://somark.tech/api/v1 | API 基础地址；会追加 /parse/async 和 /parse/async_check。 |
| outputFormats | ['markdown', 'json'] | 当调用省略 outputFormats 时请求的格式。 |
| elementFormats | { image: 'url', formula: 'latex', table: 'html', cs: 'image' } | 部分逐元素渲染格式覆盖。 |
| featureConfig | 跨页关闭，内联图片 / 表格图片 / 图片理解开启，页眉页脚关闭 | 部分功能开关覆盖。 |
| pollIntervalMs | 2000 | 状态轮询之间的延迟。 |
| maxPollAttempts | 1000 | 最大轮询次数（默认间隔下约 33 分钟）。 |
| maxFileBytes | 209715200 | 上传上限；SoMark 文档说明为 200 MB 限制。 |
| markdownCapChars | 200000 | 单次结果中返回的 markdown 字符数的包含上限。 |
| jsonCapChars | 200000 | 单次结果中返回的字符串化 JSON 字符数的包含上限。 |
示例 profile 补丁（profile 中的 cordis.patch.yml，或 --patch 覆盖层）：
- id: tool-somark
config:
apiKey: 'sk-…'
无效的 element/feature/output-format 值会导致插件加载失败并报 CONFIG_INVALID 错误，而不是被静默接受。
工具
somark_parse 接受一个必需的 path（文档的绝对路径）和一个可选的 outputFormats 数组。它返回解析后的 Markdown（受 markdownCapChars 限制，并标记为 truncated）、页数/token 计数，以及在请求时且处于 jsonCapChars 范围内的结构化 JSON（否则标记为 jsonOmitted）。
失败时会在工具结果上携带可机器路由的错误码：NO_API_KEY、DOCUMENT_NOT_FOUND、DOCUMENT_NOT_A_FILE、UNSUPPORTED_EXTENSION、FILE_TOO_LARGE、CONFIG_INVALID、SUBMIT_FAILED、TASK_FAILED、POLL_TIMEOUT、ABORTED、REQUEST_FAILED、INVALID_RESPONSE。
开发
pnpm install
pnpm test # vitest（79 个测试，100% src 覆盖率）
pnpm build # tsc → lib/
pnpm pack # 用于 dsh plugin add 的 tarball
已知限制与待办工作
- 不支持批量/目录解析——每次调用一个 path；调用方需循环调用该工具。
- 元素和功能格式属于部署配置，而非每次调用的参数。
- 无产物持久化——结果返回内容；消费方可通过 tool/result 进行持久化。
- 过大的 JSON 会被省略（jsonOmitted），而非溢出保存。
许可证
MIT