前言¶
在 DeepSeek Harness（DSH）里接第三方模型，常见做法是本机再起网关、装官方桌面客户端，或自己维护一套转发服务。若你只是想用 DeepAI Code 账号里的模型做推理，多出来的进程和客户端往往会增加维护成本。
下面介绍社区插件 dsh-deepai-connector：把 DeepAI Code 上游模型接入 DSH，用浏览器完成一次 OAuth 授权即可，不需要安装 DeepAI Code 桌面客户端，也不需要额外的网关进程。插件由 REALOIYO 维护，在 SkillHub 目录中归类为「模型推理」。
这是什么¶
dsh-deepai-connector 是面向 DSH 的模型提供方插件。它在 Harness 进程内完成鉴权、请求头对齐、签到与 SSE 解析，直连 DeepAI Code 上游，而不是把对话再转给本机上的 DeepAI Code 应用。
- 维护者：REALOIYO
- 许可证：MIT
- 当前包版本（npm / 仓库）：0.1.2
- 目录页：https://www.skillhub.cn/plugins/REALOIYO/dsh-deepai-connector
- 源码：https://github.com/REALOIYO/dsh-deepai-connector
社区插件目录（SkillHub）独立于 DeepSeek / 幻方，并非官方应用商店；安装前宜自行阅读源码与许可证。插件与 DSH 同进程运行，权限边界与当前 Harness 一致。
核心功能¶
以下能力均来自项目 README 说明，节选要点便于对照预期行为。
登录与模型列表¶
- 浏览器 OAuth 获取 Key，采用 RFC 8252 本机回调，流程与桌面端同类。
- 模型目录由上游下发，本地只做缓存；免费模型在 DSH 模型选择器中带「· 免费」标记。
协议与推理路径¶
- 复刻上游请求头形状：
Api-Key鉴权、车道版本、进程实例号、机器指纹，User-Agent: node。 - 推理前自动签到：先请求
/theos拉取 nonce 再回传。 - 自建请求体与 SSE 解析，不依赖第三方 LLM SDK。
- 若上游以
400 This request is not one DeepAI Code sends.拒绝异形请求体，插件报错后按桌面端字段白名单重排并重试一次。 - 内置车道版本探测；上游抬升车道版本时，旧值可能统一返回
426，较大协议变动需跟进插件更新。
本机标识¶
插件使用本机真实机器指纹（Windows 上优先 Win32_ComputerSystemProduct.UUID，否则回落 MachineGuid），仅上传其 sha256，不上传原始标识。可用环境变量 DEEPAI_MACHINE_ID 覆盖。签到按上游要求的最小间隔节流；命中 check_in_refused 后静默锁定 6 小时。
插件仅服务单个自用账号，不包含账号池、批量注册或额度绕行逻辑。
安装与启用¶
DSH 要求版本 >=0.2.0-rc.1 且 <0.3.0-0（见 package.json 的 engines.dsh）。包内含预构建产物，安装过程不执行构建。装完后需重启 DSH。
在「设置 → 插件」中按包名安装，或使用插件管理器：
dsh plugin add dsh-deepai-connector
首次使用¶
- 打开「设置 → DeepAI Code」，点击「登录」。
- 将授权链接复制到浏览器，使用 Google 或 Apple 账号完成授权。
- 授权成功后，模型会自动出现在 DSH 的模型选择器里。
之后在 Harness 中像选用其他提供方模型一样选择对应条目即可；具体 UI 以当前 DSH 版本为准。
适用场景与已知限制¶
适合谁¶
- 已在 DeepAI Code 侧有可用账号，希望在 DSH 里统一选模型、做智能体或对话开发。
- 不愿在本机长期运行 DeepAI Code 桌面客户端或单独网关进程。
- 能接受社区插件随上游协议变更而更新，并自行承担账号与网络侧限制。
账号与额度¶
- 上游自 0.3.19 起仅允许 Google / Apple 登录的账号推理；邮箱密码注册账号会得到
403 social_login_required，重试或换网络无效。 - 免费额度按出口 IP 发放，同网段为共享池；用尽后需等待上游在
403 network_bound中给出的refresh_at。 - 当日签到次数用尽会返回
403 check_in_refused，推理仍可用，但可能落到替身后端。
缓存与后端¶
- 上游不提供 prompt 缓存：README 记载实测同一段 1028 token 前缀连发三次时，
prompt_tokens_details.cached_tokens与cache_write_tokens均为 0，DSH 用量面板因此可能始终显示 0% 命中，属上游行为。 - 即使协议对齐，请求仍可能被转到另一条后端。判据为响应中
usage.cost_details.upstream_inference_cost是否大于 0；状态码仍为 200，无法仅靠状态码区分。
环境与依赖¶
- Node：
^22.19.0 || >=24.0.0（插件engines字段）。 - 与
@deepseek-ai/dsh-llm、@deepseek-ai/cordis及 DSH 客户端 UI 相关包存在 peer 依赖，由 DSH 宿主环境提供。
开发与参考¶
若需从源码构建或跑测试（一般使用者可跳过）：
# 构建（esbuild 为构建期依赖，不写入 package.json）
DEEPAI_ESBUILD=<esbuild 目录> node build.mjs
# 测试
node --test "test/*.test.ts"
产物为 lib/index.js（Host，ESM）与 lib/client.js（浏览器，CJS）。协议实现参考 2951461586/DeepAICode2API 的逆向文档结论，插件形态参考同作者的 dsh-qwenwork-connector。
结尾¶
dsh-deepai-connector 把 DeepAI Code 上游模型以插件形式挂进 DSH：浏览器 OAuth、无桌面客户端、无额外网关。使用前请确认 Google / Apple 登录与网络额度规则，并留意上游协议与车道版本变更。
- 目录页：https://www.skillhub.cn/plugins/REALOIYO/dsh-deepai-connector
- GitHub：https://github.com/REALOIYO/dsh-deepai-connector
