前言¶

DeepSeek Harness (DSH) 在解析 Provider 凭证时，通常期望配置一个 API Key。然而，本地安装的 Codex CLI 或 Claude Code 仅持有 OAuth 令牌，并不存在传统的 API Key。dsh-llm-local-token 插件解决了这个断层，它直接读取本地 CLI 维护的凭证文件，将 OAuth 令牌转化为 DSH 可用的模型路由，同时提供订阅使用量的实时展示。

插件简介¶

这是一个 DeepSeek Harness 插件，由 tianxia-- 维护，遵循 MIT 许可证。它的核心作用是将本地已登录的 Codex 和 Claude 订阅直接转化为 DSH 内部的模型路由，无需为 DSH 单独配置 API Key。

核心功能¶

1. 复用本地订阅：读取 Codex 和 Claude 的本地 OAuth 令牌，将其注册为 openai-codex 和 anthropic 路由。
2. 使用量 Badge：在 Composer 工具栏显示订阅的使用情况（配额、使用率、重置倒计时）。
3. 自动刷新令牌：当令牌临近过期时自动刷新。
4. 自动配置注入：通过 profile bundle 自动插入 loader 行，无需手动编辑 cordis.patch.yml。

安装与启用¶

使用官方命令安装：

dsh plugin --profile web add dsh-llm-local-token

安装完成后重启 dsh。该插件声明了一个 profile bundle (dsh.bundle.patch -> cordis.patch.yml)，DSH 会自动处理配置文件的注入，你不需要手动修改 profile 下的 cordis.patch.yml。

典型用法¶

安装完成后，路由会自动出现在模型选择器中。若要将 Codex 设为默认模型，可在 ~/.dsh/settings.yaml 中配置：

agent-default-model:
  provider: openai-codex
  model: gpt-5.6-terra
  reasoningEffort: medium

注意事项与适用场景¶

• 路由缺失处理：如果某个路由的凭证缺失，插件会跳过该路由，而不会导致 DSH 启动失败。
• GLM 行为：插件仅报告 GLM Coding Plan 的配额，不会注册新的 GLM 路由（DSH 自身已通过 zai-coding-cn 路由服务 GLM）。
• 传输协议与配额：配额 Badge 依赖 sse 传输协议。若将 codexTransport 设置为 auto，DSH 会优先使用 WebSocket，此时无法获取 Codex 的配额数据。
• GLM 配额来源：GLM 配额优先从配置项、环境变量 (ZAI_CODING_CN_API_KEY)、credentials.yaml 或本地 zcode 文件中读取。
• 版本要求：需要 Node.js >= 22.13.0。