DSH Connect Doubao

DSH Connect Doubao

把本机豆包（Doubao）桌面客户端已有的登录态接入 DeepSeek Harness，作为 Seed 系列模型 provider， 并在设置面板里提供一个只读的额度概览（5 小时限额 / 周额度 + 重置倒计时）。

---

⚠️ 前置条件（必读）

本插件复用豆包桌面客户端的登录态，因此必须先在豆包客户端登录。

它不会替你登录、也不会输入任何账号密码：它读取豆包客户端已保存在本机的 Chromium cookie（通过 Windows DPAPI 在本进程内解密），把它当作请求凭据。

如果你没有登录豆包客户端，插件会明确报错而不是静默失败。

---

功能特性

• Seed 系列模型接入 —— 豆包桌面客户端发布的 6 个条目（见下表），作为 DSH 的模型 provider。
• 推理强度三档 —— 低 / 中 / 高，对应上游 reasoning_effort 实测值 3 / 4 / 5。
• 只读额度面板 —— 5 小时限额与周额度两条进度条，各带重置倒计时；设置面板里手动刷新 + 5 分钟自动刷新。
• 模型勾选清单 —— 勾选的条目会出现在 DSH 的模型选择器中，请求时按 model_item_key 指定模型。
• 账号状态行 —— 区分「已登录 / 未登录 / 登录信息读不出来」等状态，各自给出不同的处置建议。
• 独立 loopback shim —— 对话请求走一个只监听 127.0.0.1 的本地端点，带每进程共享密钥，任何非本机请求一律拒绝。
• 命令行诊断 —— doctor / probe，不消耗推理额度即可体检整条链路。

---

已验证

验证环境（一次具体的真机条件，不是"所有环境都可用"的承诺）：

真机截图证明（用户实拍）

• ✅ 卡片挂在设置左侧导航里 —— 设置面板左栏出现「豆包」一级导航项，点击后右侧显示本卡片。
• ✅ 额度面板读到真实数据 —— 截图里可见 标准套餐、5 小时限额 已用 0% · 2h 17m 后重置、 周额度 已用 9% · 5d 21h 后重置、账号状态: 已登录、每 5 分钟自动刷新、配置目录路径。
• ✅ 模型清单六个条目全部渲染 —— 豆包 快速 / 2.1 Lite（0921 新版）/ 2.1 Turbo（专家）/ 2.1 Pro / 2.1 Turbo（即将下线）/ 自动，角标与桌面包一致，计数显示 已启用 6 ↑。
• ✅ 模型选择器里出现「豆包（Doubao）」分组 —— 六个条目逐一列出。 这是 provider 注册成功 + catalog 生效 的端到端证据。
• ✅ 勾选交互可用 —— 每行一个勾选框，配 刷新 / 全选 / 全不选 / 保存 四个按钮。

代码级 / 抓包级证据（非截图）

• doctor 四段检查全绿：凭据 29 cookie 解密且 9/9 必需会话 cookie 齐备、账号被上游接受、 shim 绑定回环端口且错误 bearer 返回 401、两个额度窗口可读。
• 推理强度 低=3 / 中=4 / 高=5：由抓取客户端切换档位时重新序列化的配置 diff读出， 并由客户端配置里的 reasoning_effort_config 独立确认。
• 请求体带 model_item_key 与 reasoning_effort：抓包确认。

这不代表什么

以上只对上述那台机器、那个账号、被验证的那个时间点成立。 不构成任何兼容性保证 —— 请务必读下面的「已知限制」。

---

模型目录

豆包把模型按模式分组，menu_list 每个模式有自己的一份清单：

本插件只提供「对话」模式的两条：

「工作任务」的四条故意不列：它们的执行侧是豆包客户端进程内的 CUA 运行时 （tasks-mode-resource + sbox），外部客户端注册不进去，每一轮都会得到 710010702。与其在模型选择器里摆出选不中的条目，不如不摆。

推理强度：低 = 3、中 = 4、高 = 5（由客户端切换档位时重新序列化的配置 diff 读出， 并由配置里的 reasoning_effort_config 独立确认）。深度思考开关本身走 need_deep_think: 0，档位只由 reasoning_effort 携带 —— 这是 2026-10-22 CDP 抓包更正的。

---

工作原理

DSH (pi-ai provider)
  └─ doubao-adapter ──► 本机 loopback shim (127.0.0.1，仅本进程密钥)
                         └─ doubao-upstream ──► 豆包 /chat/completion
                                                 （带上本机读到的会话 cookie）

1. 凭据：从豆包客户端的 Chromium cookie jar 读取，用 Windows DPAPI 在本进程内解密。 cookie 值从不写入磁盘、日志、命令行或网络请求以外的任何地方。
2. provider：把 pi-ai 的 OpenAI 形状请求翻译成豆包方言（bot_id + reasoning_effort）。
3. 流式：上游的三行帧被解析成 pi-ai 的事件流，工具调用 / 压缩 / 权限仍由 Harness 掌控。
4. 只读路由：/plugins/dsh-connect-doubao/quota 与 /catalog 提供额度与目录， 按显式允许清单构造响应，不透传上游任何字段，并拒绝非 loopback 来源。

---

安装

三种方式

# ① 通过 DSH CLI（推荐）
dsh plugin --profile desktop add dsh-connect-doubao

# ② npm 直装
npm install -g dsh-connect-doubao
dsh plugin --profile desktop add dsh-connect-doubao

# ③ 本地开发（不发布，直接挂源码目录）
dsh plugin --profile desktop add "E:\path\to\dsh-connect-doubao"

方式 ③ 会写成 link: 依赖，改完源码 npm run build 即可，不需要重装。

受支持的宿主范围

官方 @deepseek-ai/* 依赖全部声明为 peerDependencies（不打包，由宿主提供）， 这既是插件市场的硬性要求，也保证运行期用的是宿主那一份。

---

平台支持

凭据查找逻辑（findDoubaoUserDataDir）按顺序尝试：

1. %LOCALAPPDATA%\Doubao\User Data
2. %APPDATA%\Doubao\User Data
3. C:\Users\<各用户>\AppData\Local\Doubao\User Data

命中条件是存在 Default\Network\Cookies。 只写实测过的那条：第 1 条在本机实测通过，第 2/3 条是代码里的兜底分支，未在真机验证。

---

命令行

# 体检整条链路（不消耗推理额度）
dsh-connect-doubao-doctor
dsh-connect-doubao-doctor --json

# 冒烟探针（会消耗一次推理额度）
dsh-connect-doubao-probe --prompt "hi"
dsh-connect-doubao-probe --prompt "hi" --model 5 --thinking high --json

probe 的完整参数：

--prompt <text>              提示词（默认 "hi"）
--model <key>                模型 id，见上表
--thinking <low|mid|high>    推理强度
--json                       输出 JSON
--timeout <ms>               超时（默认 120000）

doctor 输出四段独立结论：凭据 / 账号 / provider 装配 / 额度。 凭据只报数量，不报值。

---

开发

npm install
npm run typecheck   # 节点侧 + 浏览器侧两套 tsconfig
npm run build       # 两个 target：node(ESM) + browser(CJS)
npm run test        # 客户端产物格式回归
npm run check       # 以上全部

⚠️ 浏览器侧产物必须是 CommonJS：桌面外壳用 <script> 加载它，不加 type="module"。 ESM 会直接抛 Cannot use import statement outside a module， 并让整个 web boot 失败（1 entry did not activate）。 tests/client-bundle-format.test.ts 钉住了这条规则。

---

已知限制（请如实预期）

1. 使用非官方接口。 豆包没有公开的第三方 API，本插件逆向其客户端行为。 上游任何改动都可能让它失效，且不会有预告。
2. '4'（豆包 2.1 Turbo「即将下线」）未实测。 其余 5 个条目已实测可对话。
3. 无法从响应侧独立验证"确实是这个模型"。 上游 SSE 的 message.ext 里有一个 不透明标记（实测为 38），它不是版本号也不是档位，字节跳动从未公布其含义 —— 所以没有一个响应侧的字段可以拿来证明"服务端真的用了你选的那个模型"。 本插件能确定的是：它把 model_item_key 随请求发出（这已抓包确认）。 至于服务端如何解释这个键，只能由服务端回答。
4. 仅 Windows。 凭据解密依赖 DPAPI。
5. 风控滑块无法自动处理。 触发后需去豆包客户端手动发一条消息完成验证。
6. 图片输入未提供。 本 provider 只发送文本块，不转发图片。
7. 单账号。 没有账号池、没有区域切换、没有签到。
8. 「工作任务」跑不了。 agent_mode 的取值是 2 = 普通对话、1 = 工作任务（CDP 抓包实测， 2026-10-22）。任务模式下服务端会把每一轮交给 Agent-GeneralTask，而它的执行运行时是豆包 客户端进程里的 CUA（tasks-mode-resource + sbox），外部客户端注册不进去，必然回 710010702。所以插件固定走对话模式；请求体里的 general_task_param 发的是客户端在普通 对话下的默认值 {"server_do_compare":true}。
9. model_item_key 目前不影响谁来回答。 实测（2026-10-22）：0 / 3 / 5 / seed-lite-7b 以及一个刻意写错的 key，回答长度和耗时都无法区分（12.3–14.0 s）， 响应里的 model_id 恒为不透明标记 38。结论：对话模式下服务端按账号/模式路由， 不看这个字段。插件仍原样转发它（服务端会把值记在消息上），但不要指望换 key 换模型； 「工作任务」模式是否按 key 路由，因为它根本跑不通，未验证。

---

免责声明

本项目仅供个人学习与研究使用。

• 使用本插件即表示你同意遵守豆包（Doubao）的服务条款；
• 使用风险自负，本项目作者不对任何账号封禁、额度损失或数据后果承担责任；
• 本项目与字节跳动（ByteDance）、DeepSeek、DeepSeek Harness 官方无任何关联或背书；
• 请勿用于商业用途或任何超出个人学习范围的场景。

---

致谢

• dsh-connect-workbuddy —— 本插件在设计思路与插件结构上借鉴了它的做法 （loopback shim、provider 注册链路、设置卡片挂载、构建与打包约定）， 所有代码均为独立实现，未复制其源码。

第三方开源依赖

运行时不引入任何第三方连接器插件。

许可证

MIT