dsh-llm-sub2api-dsml
DeepSeek Harness（DSH）的 DSML 兼容插件。当 DeepSeek 经 Sub2API 等渠道把工具调用输出成 reasoning / text 中的 DSML 文本时，将完整合法的调用转换成 DSH 原生工具事件，让 Agent Loop 继续运行。
作者：wwj · 许可证：MIT
现有 LLM provider → reasoning / text 中的 DSML
→ 流式缓冲 → 当前工具 schema 校验 → DSH tool-call
→ finish(kind=tool-calls) → DSH 权限检查与工具执行
插件根据模型 ID 自动匹配任意 provider 的流，直接使用原模型分组，不需要切换模型或填写提供商列表。原适配器继续处理上游协议、SSE、认证、附件和历史序列化；本插件不保存密钥。
兼容要求
- DSH：
>=0.2.1-rc.3；已在 Linux 的 0.2.1-rc.3 和 0.2.1-rc.5 上验证，尚未验证 Windows 桌面端。
- Node.js：
>=22.19.0，CI 覆盖 Node.js 22.19.0 与 24。
- 已配置并可用的 LLM provider；其模型 ID 包含
deepseek（不区分大小写）。
- 不限定提供商或上游协议；
deepseek-v4.1-flash、prefix/DeepSeek-R1 等模型 ID 均自动匹配。插件不创建上游连接，也不提供模型或凭据配置。
安装
克隆本仓库后，在源码目录安装依赖、测试并生成安装包：
git clone https://github.com/Nicolas-One/dsh-llm-sub2api-dsml.git
cd dsh-llm-sub2api-dsml
npm install --ignore-scripts
npm test
npm pack
dsh plugin --profile web add ./dsh-llm-sub2api-dsml-0.2.1-rc.5.1.tgz
web 替换为目标 profile。包已包含 JavaScript 入口和 dsh.bundle 配置层，无需构建。安装与配置层机制见 DSH 官方插件打包文档。
安装并加载后，任意已有 provider 下模型 ID 包含 deepseek 的请求都会自动参与检测（不区分大小写）。不需要填写提供商名称，模型 ID 中没有 deepseek 的别名不会被识别；正常响应保持原样，检测到完整合法 DSML 才转换；已确认的孤立 DSML 残留会单独清理。
如需关闭转换或调整缓冲上限，可将下面配置合并到 $DSH_HOME/profiles/web/cordis.patch.yml 的顶层数组中：
- id: sub2api-dsml
config:
dsmlCompatibility: true
maxBufferChars: 1048576
已有其他配置时保留其数组项。此行覆盖 bundle 插入的插件配置，无需再添加 insert；覆盖会替换整个 config，请完整保留上述字段。可复制 配置示例。
使用 dsh --profile web --dump-config 检查最终配置。让目标实例加载新配置后，继续选择原 provider 下的 DeepSeek 模型即可。是否可热加载取决于宿主，安排重启时应先结束正在运行的任务；已开始的请求不会被转换。
若之前手动挂载过同名插件，请先统一安装方式，避免重复插件行和内部路由冲突。
配置项
| 字段 | 说明 |
|---|
dsmlCompatibility | 默认 true；设为 false 关闭转换。 |
maxBufferChars | DSML 缓冲上限，默认 1048576 字符，允许 1024 到 8388608。 |
自动检测仅根据模型 ID，辅助请求（purpose 非空）直接透传。新注册的 provider 同样生效，无需重新维护提供商名单。
升级旧配置时，compatibleProviders 字段仍可被读取，但不再限制模型匹配，可以删除。sourceProvider 默认留空，默认不注册额外路由；只有需要继续使用旧内部路由的会话才显式填写实际源 provider ID。此时可通过 provider 指定内部路由 ID（默认 sub2api-deepseek-dsml），不得与源路由或其他已注册路由冲突。内部路由不发布模型列表，普通会话始终使用原 provider。
解析行为与限制
- 支持跨 SSE 分片的单竖线和双竖线标签、reasoning / text，以及最终
block-end 权威文本。
- 工具转换只识别行首的带 DSML 包装的
calls、tool_calls 或 function_calls 根节点；两种竖线均支持。行内示例、代码围栏、引用、缩进代码和无根 XML 不会被执行。
- 支持多个
invoke、带或不带 DSML 前缀的内部标签、单双引号属性、字符串与 JSON 参数。
- 清理块首无名 DSML 标记及末尾一个或多个孤立闭合标签；允许单竖线、双竖线和裸闭合混合。尾部必须含明确 DSML 闭合标签，仅裸 XML 闭合原样保留。正文为空且无原生工具调用时返回
EMPTY_RESPONSE，由 DSH retry policy 决定是否重试。
- 按当前请求声明的工具 schema 校验。未知工具、重复参数、缺参、非法 JSON 或类型不符会失败，不猜测参数或补全闭合标签。
- 每段最多 64 个调用，每个调用生成独立 ID；具体可用工具取决于当前请求声明。
- 完整合法 DSML 到达后立即关闭上游流并提交调用，调用段后的生成不再读取；多工具应放在同一根节点中。
- 若原生工具调用先到，不再转换 DSML，避免重复提交。
- DSML 闭合前的取消、错误或截断不产生工具调用；未闭合调用遇到正常结束返回
DSML_INVALID_CALL。
- 插件只产生原生事件，工具执行与权限检查由 DSH 负责。它无法恢复已结束的历史回合。
- 明确介绍示例或讨论标签的上下文会保护当前文本块余下内容；行内代码、围栏、引用和缩进代码也受保护。自然语言判别仍有局限：未声明引用语境的孤立标签可能被清理，包含示例介绍的真实调用也可能保守保留。时间戳残句等非空正文不会触发空回复重试。
- 主动结束可能收不到最终 usage，只保留已收到的用量，不伪造完整计费数据。
- 修改响应后丢弃旧
replayState，下一次请求由原适配器按标准历史序列化；日志只记录状态和调用数量。
本插件不设置推理强度，也不解决所有 thinking 历史回传问题。 Sub2API 的推理强度显示、output_config.effort 映射，以及 content[].thinking must be passed back 等问题，需要另行核对上游协议与原适配器配置。
其他泄漏标签的处理边界
讨论 #10100 列出的类别不是完整协议定义。本插件采用以下策略：
| 类别 | 当前行为 |
|---|
| 完整 DSML 调用 | 解析并校验当前工具 schema，通过后产生原生调用。 |
| 孤立 DSML 闭合尾部、块首无名标记 | 跨分片清理；没有正文且没有原生工具调用时返回空回复错误。 |
裸 XML 工具包装、ds_tool、ds_safety | 保留原文，只记录结构标签的类别；不补参数、不执行。 |
gongfeng/gazelle/gitsource、ai-content/route/framework、answer | 保留包装及内容，不猜测哪部分是元数据或答案；只记录类别。 |
| 中文工具包装、全角工具分隔符 | 检测已列出的标记并记录类别，保留原文。 |
| JSON 工具代码块 | 作为普通示例保留，不转换执行。 |
观测日志形如 [sub2api-dsml] observed category=ds-safety，不包含命令、参数、正文或密钥；同一类别每次请求最多报告一次。observed 只表示出现了结构标签，不能直接统计为真实泄漏。受保护的示例不参与观测；检测只维护有界上下文，超长或未列出的标签不保证识别。
清理发生在流式 delta 与权威 block-end 两条路径。没有 finish 时，尚未确认的闭合尾部会保留；已清理的块首标记不恢复。不会根据残句猜测完整回答，也不会把 reasoning 提升为最终正文。
开发与验证
npm install --ignore-scripts
npm test
npm pack --dry-run
测试使用真实 Cordis、LlmRuntime、BlockAssembler 和官方 dsh-llm-pi-ai，连接本地模拟 HTTP/SSE。覆盖分片、多工具、参数拒绝、主动关闭、工具结果回传、冷启动、卸载，以及泄漏样本、讨论保护、实时 delta 和回放状态；工具执行使用无害替身，无需真实密钥，也不运行 shell。
test/replay.mjs 从标准输入读取本地消息与工具 schema，仅解析和组装，不执行工具。不要将真实会话、命令或凭据提交到仓库。贡献方式见 CONTRIBUTING.md。
GitHub Actions 以 DSH LLM rc.3/rc.5 和 Node.js 22.19.0/24 矩阵执行依赖安装、测试和打包检查；推送版本标签后自动创建 GitHub Release，上传安装包及 SHA-256 校验文件，不发布 npm 或部署 DSH。private: true 用于防止误发 npm，不影响 GitHub 上的 MIT 开源和 tarball 安装。问题反馈请提交到 GitHub Issues。
当前未提交锁文件，依赖解析可能随兼容版本更新而变化；新安装以 CI 的测试结果为准。
卸载
确认旧会话不再使用隐藏路由后，删除 profile 中的 sub2api-dsml 覆盖配置，再移除 bundle：
dsh plugin --profile web remove dsh-llm-sub2api-dsml
许可证
MIT License，Copyright (c) 2026 wwj。
