DeepSeek Harness 接入开桥 ​

DeepSeek Harness（DSH）支持两种方式接入开桥：

安装 DeepSeek Harness ​

使用 npm 全局安装官方 @deepseek-ai/dsh 包：

npm i -g @deepseek-ai/dsh

安装完成后检查命令是否可用：

dsh --version

如果终端提示找不到 dsh，请重新打开终端，并确认 npm 全局可执行文件目录已加入 PATH。

使用普通 API Key 配置 ​

普通配置直接复用 DSH 内置的 deepseek-official Provider，不需要安装开桥 PKCE 插件。

先设置开桥 API Key：

export OPENQIAO_API_KEY="sk-ai-v1-xxx"

然后编辑 $DSH_HOME/settings.yaml；如果未设置 DSH_HOME，默认路径为 ~/.dsh/settings.yaml：

llm-deepseek:
  apiKeyEnv: OPENQIAO_API_KEY
  baseURL: https://openqiao.com/api/v1

启动 DSH，并在模型选择器中选择内置的 DeepSeek-V4-Flash 或其他开桥支持的 DeepSeek 模型：

dsh web

apiKeyEnv 只保存环境变量名称，API Key 本身不会写入 settings.yaml。DSH 已内置默认模型列表，所以普通配置不需要重复填写模型；只有使用其他模型或自定义显示名称时才需要增加 models。

如果需要让 API Key 长期生效，请根据当前 Shell 将 export OPENQIAO_API_KEY="..." 写入 ~/.zshrc 或 ~/.bashrc，然后重新打开终端。

为 DeepSeek Harness 设置代理 ​

DeepSeek Harness（dsh）底层运行在 Node.js 环境中。由于 Node.js 运行时默认不会读取系统的 http_proxy / https_proxy 环境变量，如果你的网络环境需要通过代理访问外网或开桥，请在启动命令前显式开启代理支持并注入环境变量：

# 开启 Node.js 代理支持，并将 7890 替换为你的实际代理端口
export NODE_USE_ENV_PROXY="1"
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

dsh web

# 将 7890 替换为你的实际代理端口
NODE_USE_ENV_PROXY="1" HTTPS_PROXY="http://127.0.0.1:7890" dsh web

# 开启 Node.js 运行时读取系统代理环境变量（将 7890 替换为你的实际代理端口）
export NODE_USE_ENV_PROXY="1"
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

使用 OAuth PKCE ​

官方 npm 包 @openqiao/dsh-plugins 使用 OAuth 2.0 Authorization Code + PKCE 完成浏览器授权，无需创建或复制开桥 API Key，并会在 Access Token 到期前自动刷新登录状态。

当前 PKCE 集成面向交互式 DSH Web，提供以下能力：

• /openqiao login、/openqiao status 和 /openqiao logout 命令。
• 通过浏览器完成开桥 OAuth PKCE 授权。
• 自动保存并轮换 Access Token 与 Refresh Token。
• 预置开桥 DeepSeek V4 Pro 和 DeepSeek V4 Flash 模型。
• 通过 Anthropic Messages 协议使用提示词缓存与思考预算。

安装插件 ​

将插件安装到 DSH Web Profile：

dsh plugin --profile web add @openqiao/dsh-plugins

然后启动 DSH Web：

dsh web

安装包会自动挂载开桥 OAuth 控制器，并在 DSH 已有的 pi-ai Adapter 中加入开桥 Provider。它不会替换 DSH 内置的 DeepSeek 路由，也不会自动切换已有对话的 Provider。

登录开桥 ​

在 DSH Web 中执行：

/openqiao login

DSH Web 会在新标签页打开开桥授权页，同时显示一个 打开开桥登录 的备用链接。确认账号和授权范围后，等待回调页面显示 开桥 connected，然后返回 DSH。

插件只请求以下权限：

• inference:invoke：调用开桥模型。
• offline_access：在 Access Token 过期后刷新登录状态。

OAuth 回调使用一次性的 127.0.0.1:<临时端口>/callback。监听器会校验 state，并在成功接收一次响应或登录超时后关闭。

选择模型 ​

登录成功后，在模型选择器中选择：

• 开桥 · DeepSeek V4 Pro
• 开桥 · DeepSeek V4 Flash

这两个预置模型通过开桥的 Anthropic Messages 端点调用，以便 DSH/pi-ai 使用 Anthropic 提示词缓存和思考预算。

如需使用其他开桥模型，可以在 设置 → 模型 中编辑开桥 Provider 的 models 数组。请填写开桥模型 ID，并根据模型能力配置推理等级。不要把 OAuth Token 粘贴到模型配置中。

管理登录状态 ​

查看当前连接状态和到期时间：

/openqiao status

退出登录：

/openqiao logout

退出时，插件会尝试在开桥撤销 Refresh Token，然后清除 DSH 中保存的 OAuth 凭据。还可以前往开桥的已授权应用页面撤销该授权。

代理与网络配置 ​

OAuth Discovery、Token 和 Revocation 请求默认直接连接开桥。如果 DSH 所在环境必须使用代理，由于底层的 Node.js 运行时默认不读取系统的 http_proxy 环境变量，请在启动命令前显式开启代理支持并注入环境变量（请将 7890 替换为你实际使用的代理端口）：

# 将 7890 替换为你的代理客户端实际端口
export NODE_USE_ENV_PROXY="1"
export HTTPS_PROXY="http://127.0.0.1:7890"
export HTTP_PROXY="http://127.0.0.1:7890"

dsh web

也可以在 DSH Profile 中显式配置 proxyUrl（DSH Profile 中配置的 proxyUrl 优先于环境变量）。插件支持 HTTP、HTTPS、socks4a:// 和 socks5h:// 代理。

如果企业代理使用本地 CA 重新签发 TLS 证书，应在 Node.js 启动前加载 CA：

NODE_EXTRA_CA_CERTS=/absolute/path/to/ca.pem dsh web

不要使用 NODE_TLS_REJECT_UNAUTHORIZED=0。关闭 TLS 校验可能暴露 Authorization Code 和 Refresh Token。

可选环境变量 ​

生产环境通常不需要额外配置。以下变量主要用于代理环境、开发环境或自托管服务：

支持范围与限制 ​

• 当前包面向能执行 /openqiao 命令的交互式 DSH Web。
• 不消费 ctx.commands 的纯 Headless 或自动化部署不能自行发起浏览器登录。
• Headless 部署可以复用同一个 Harness Home 中由交互式 DSH Web 创建的凭据。
• 插件不会把 OAuth 状态、Token 或到期时间加入模型输入或对话历史。
• 代理不可用时登录与刷新会失败，不会静默回退到其他网络路径。

需要了解所有支持 OAuth PKCE 的 Agent，请参阅使用 OAuth PKCE 登录开桥。