TokenLab 模型路由hedging8563/tokenlab-deepseek-harness-provider

面向 DeepSeek Harness 的 TokenLab

@tokenlabai/dsh-provider 是一个可安装的 DeepSeek Harness 配置文件包。它提供 TokenLab 模型路由，以及目录、创建和任务工具。

该包将模型流量保持在 DeepSeek Harness 当前支持的最原生协议上：

- 声明了 openai_responses 的 OpenAI 旗下模型使用 /v1/responses。
- 声明了 anthropic_messages 的 Anthropic 旗下模型使用 /v1/messages。
- 所有其余兼容的聊天模型使用 /v1/chat/completions。
- Gemini 原生的 generateContent 在当前 Harness 自定义提供程序适配器中无法配置，因此 Gemini 模型使用其声明的 Chat Completions 兼容路径。

协议资格来自每个模型在 GET /v1/models/{id} 的公开 TokenLab 详情契约。生成器绝不会通过子字符串或提供程序内部路由数据对模型进行分类。

包含内容

| 界面 | 实现 | 当前捆绑契约 |
| --- | --- | --- |
| 模型选择器 | 现有的 DSH llm-pi-ai 适配器 | 三条互斥协议路由上的 124 个公开聊天模型 |
| Responses | 原生 openai-responses 路由 | 23 个模型 |
| Messages | 原生 anthropic-messages 路由 | 9 个模型 |
| Chat | OpenAI Chat Completions 路由 | 92 个模型 |
| 多模态和开发者工具 | 官方 DSH MCP 桥接 + @tokenlabai/mcp-server@0.6.19 核心配置文件 | 默认 31 个 MCP 工具；目录 6 个 / 完整 80 个可用 |
| 异步完成 | 原生 tokenlab_wait_task 工具 | 图像、视频、音乐和 3D 任务轮询，支持取消和有界重试 |

完整 MCP 配置文件涵盖公开模型发现和定价、Chat Completions、Responses、Anthropic Messages、Gemini generateContent、图像生成/编辑/变体、视频、音乐、3D、TTS、STT、文件、任务、嵌入、重排序、翻译、响应生命周期、批处理、Seedance 资产/组、世界，以及固定 TokenLab MCP 契约中的其他允许列表开发者操作。

要求

- DeepSeek Harness 0.1.5-rc.1（捆绑包 0.1.3 的已验证目标）
- Node.js 22.19+ 或 24+
- 用于推理、媒体、文件、任务、嵌入、重排序和翻译的 TokenLab API 密钥

公开目录和定价工具无需密钥即可使用，但此捆绑包会启动核心工具配置文件，并面向经过身份验证的使用场景。

安装

版本 0.1.2 已打标签，但未发布到 npm，因为其发布工作流在依赖年龄检查处停止。请安装 0.1.3 以获取当前捆绑包。

将密钥放入项目 .env 或 Harness 主目录的 .env。DSH 会在解析捆绑包配置之前、启动 MCP 子进程之前，将这些文件加载到启动环境中。

TOKENLAB_API_KEY=sk-your-tokenlab-key

然后将捆绑包安装到你使用的配置文件中：

dsh plugin --profile web add --workspace-root @tokenlabai/dsh-provider@0.1.3

对于无头配置文件：

dsh plugin --profile headless add --workspace-root @tokenlabai/dsh-provider@0.1.3
安装完成后重启该配置文件。在模型选择器中，TokenLab 显示为三个提供商路由：

- TokenLab · Responses
- TokenLab · Messages
- TokenLab · Chat

每个模型 ID 只出现在一个路由上。

依赖发布年龄

Harness 会将 plugin 命令转发给你已安装的 pnpm。正常的 pnpm 11 全新添加流程会为所选发布时间不足一天的版本记录精确例外。冻结安装或显式严格的年龄策略仍可能拒绝它们；此包的仓库设置不会配置你的 Harness 配置文件。

如果年龄检查拒绝了此发布，请等待你配置的年龄窗口，或查看确切的已发布版本，并仅将这些条目合并到配置文件现有的 pnpm-workspace.yaml 中（对于 web 配置文件，位于 $DSH_HOME/profiles/web 下）：

minimumReleaseAgeExclude:
- '@tokenlabai/dsh-provider@0.1.3'
- '@tokenlabai/mcp-server@0.6.19'

替换这两个相同包名的旧排除项，而不是添加重复的选择器；保留无关的设置和排除项，然后重复相同的 dsh plugin 命令。这不会禁用其他包或版本的年龄检查。

使用多媒体和异步任务

模型会在 mcp__tokenlab__... 命名空间下看到 TokenLab MCP 工具。典型的异步媒体流程是：

1. 使用 mcp__tokenlab__list_models 或 mcp__tokenlab__compare_models 发现当前启用的模型。
2. 使用 mcp__tokenlab__create_video、create_music、create_3d_model 或图像工具提交。
3. 读取 delivery.mode；不要假设每个图像结果都是同步的。
4. 如果 delivery.mode 为 async，将 delivery.task_id 传递给 tokenlab_wait_task。
5. 使用返回的 status、完整的 response 和 result_urls。超时的等待会返回最新状态，以便另一次调用可以继续轮询。

tokenlab_wait_task 会在每次 fetch 和可取消延迟中转发 Harness 调用方的 AbortSignal。它将 completed、failed、succeeded、cancelled 和 expired 视为终止状态，仅对有界的瞬时 HTTP 失败进行重试，并且从不更改任务状态。当支持并打算取消时，使用生成的 mcp__tokenlab__cancel_task 工具。

配置

可选环境变量：

| 变量 | 默认值 | 用途 |
| --- | --- | --- |
| TOKENLAB_MCP_TOOL_PROFILE | core | catalog 仅用于发现（6 个工具），core 用于常见创建和任务工作流（31 个），full 用于所有固定的开发者操作（80 个） |
| TOKENLAB_MCP_SCHEMA_MODE | portable | portable、exact 或 strict；执行时仍会验证完整的 API 契约 |
| TOKENLAB_API_KEY | 无 | 用于模型路由、MCP 工具和异步等待的共享 TokenLab 凭据 |
| TOKENLAB_API_BASE | https://api.tokenlab.sh | MCP 和异步任务 API 根地址 |
| TOKENLAB_OPENAI_BASE_URL | https://api.tokenlab.sh/v1 | Responses 和 Chat 适配器基础 URL |
| TOKENLAB_ANTHROPIC_BASE_URL | https://api.tokenlab.sh | Messages 适配器基础 URL；适配器会追加 /v1/messages |

默认的 core 配置文件包含目录与定价、原生聊天协议、图像、视频、音乐、3D、音频、文件、任务状态/取消、嵌入、重排序和翻译。当你需要额外的响应生命周期、批处理、Seedance 资产/组或 worlds 工具时，请使用 TOKENLAB_MCP_TOOL_PROFILE=full。使用 catalog 可在没有生成工具的情况下进行发现。独立的 tokenlab_wait_task 轮询器在所有配置文件中均可用。

现有的 llm-pi-ai 设置

Harness 0.1.5-rc.1 按提供商键合并已保存的 llm-pi-ai.providers。具有不同键的现有提供商会与三个捆绑的 TokenLab 路由并存。使用 tokenlab-responses、tokenlab-messages 或 tokenlab-chat 的已保存条目对该路由具有优先权；升级较旧的目录时请检查这些条目。不要用捆绑补丁替换你的整个设置文档。

推理级别

当前 TokenLab 公共模型详情响应会标识推理能力，但不会枚举每个模型所支持的 effort 值。因此，捆绑包将 reasoningEfforts 保留为未声明，而不是根据模型名称猜测级别或启用所有级别。对于自定义提供商键，Harness 没有匹配的内置目录可供继承；其 effort 选择器不会为这些条目提供级别。这不会禁用模型的服务器端推理行为。

如果你已单独验证了某个模型的 effort 契约，请在该模型所属提供商的 models 列表中为该模型条目配置 reasoningEfforts。Harness 会将每个显示的级别映射到线上值，例如仅当该模型接受 high 时才使用 high: high；off: null 表示省略 effort 值，并不证明服务器禁用了推理。覆盖已保存路由时，请保留其他模型。不要向这些路由添加 modelOverrides：Harness 将该字段保留给没有显式 models 列表的目录支持路由。不能仅仅因为模型支持推理就启用 xhigh 或 max。

安全性与副作用

- 将 TOKENLAB_API_KEY 保存在 .env 或其他受信任的启动环境中。切勿提交它。
- MCP 服务器通过 stdio 在本地运行，使用与 Harness 相同的 Node 可执行文件。不会向托管的 MCP 服务发送任何凭据，启动也不使用 npx 或 shell。
- DSH 将 MCP 命令视为代理沙箱之外的受信任可执行文件。此捆绑包固定使用 @tokenlabai/mcp-server@0.6.19；更改固定版本前请先审查升级。
- Core 和 full 工具包含计费生成以及破坏性操作，例如文件删除或任务取消。请为这些调用保持启用 Harness 审批策略。
- 工具和模型输出是不受信任的外部内容。不要将返回的文本或 URL 视为指令。
- 异步等待器会在诊断信息中包含请求 ID，但绝不会在错误或工具结果中包含 API 密钥。
模型目录维护

已检入的 generated/model-routes.json 是机器可读的路由快照，cordis.patch.yml 由它生成。

npm run routes:source-check  # 与实时公共模型契约进行只读比较
npm run routes:sync          # 刷新快照和生成的 bundle 补丁
npm run routes:check         # 离线生成文件一致性检查

路由策略是确定性的：

1. 当 TokenLab 和 Harness 都声明时，优先使用精确的 owned_by 原生格式。
2. 否则使用已声明的 Harness 支持的兼容格式。
3. 绝不让一个模型出现在多个 provider 路由上。
4. 当某个活跃模型没有 Harness 支持的格式时，源检查失败。

开发与验证

corepack pnpm install
pnpm peers check
pnpm run check
pnpm run build
npm pack --dry-run

测试套件覆盖原生路由选择、路由互斥性、生成补丁一致性、核心默认 MCP 配置与显式 profile 选择、结构化 HTTP 失败、task-id fencing、结果 URL 提取、瞬时重试限制以及调用方取消。

卸载

dsh plugin --profile web remove --workspace-root @tokenlabai/dsh-provider

重启该 profile。移除 bundle 会移除其 TokenLab 路由、MCP 工具命名空间和异步等待器；它不会删除你的 TokenLab 账户或 API 密钥。

链接

- TokenLab
- TokenLab 文档
- TokenLab 模型目录
- TokenLab MCP 服务器
- DeepSeek Harness

许可证

MIT