DSH Connect Doubao

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

---

⚠️ 前置条件（必读）

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

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

要求	说明
豆包桌面客户端已登录	未登录 → 卡片显示「未登录」，provider 不可用
Windows	凭据解密依赖 Windows DPAPI。macOS / Linux 不支持
有可用订阅额度	免费账号也能连，但配额很小

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

---

功能特性

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

---

已验证

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

项	值
操作系统	Windows x64
豆包电脑版	2.31.4（已登录）
DeepSeek Harness	0.2.0-rc.2（桌面版）
Node.js	24.18.1（宿主内）

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

• ✅ 卡片挂在设置左侧导航里 —— 设置面板左栏出现「豆包」一级导航项，点击后右侧显示本卡片。
• ✅ 额度面板读到真实数据 —— 截图里可见 标准套餐、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：抓包确认。

这不代表什么

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

---

模型目录

目录读自豆包客户端自身的配置缓存（服务端下发给 app 的 menuConfV2）， 不是我们臆测的。model_item_key 与 DSH 侧的模型 id 是同一个字符串， 刻意不做映射，少一层可能出错的翻译。

id	名称	徽章	推理强度
0	豆包 快速	—	✅
seed-lite-7b	豆包 2.1 Lite	0921 新版	✅
3	豆包 2.1 Turbo	专家	✅
5	豆包 2.1 Pro	—	✅
4	豆包 2.1 Turbo	即将下线	✅
9	自动	—	✅

推理强度：低 = 3、中 = 4、高 = 5。 这三个值是通过抓取客户端切换档位时重新序列化的配置 diff读出来的， 并由客户端配置里的 reasoning_effort_config 独立确认了一次，不是推断的。

「即将下线」不是某个模型的属性 —— app 发布了两个 Turbo 条目， 只有即将下线的那一个带这个徽章。

---

工作原理

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 Harness	>=0.1.7-rc.1 <0.3.0-0（实测：0.2.0-rc.2）
@earendil-works/pi-ai	>=0.85.0 <0.88.0（宿主实测：0.87.1）
Node.js	^22.19.0 || >=24.0.0

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

---

平台支持

平台	状态
Windows x64	✅ 实测验证
macOS	❌ 不支持（DPAPI 是 Windows 专有）
Linux	❌ 不支持（同上）

凭据查找逻辑（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. 单账号。 没有账号池、没有区域切换、没有签到。

---

免责声明

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

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

---

致谢

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

第三方开源依赖

依赖	用途
@earendil-works/pi-ai	模型 provider 运行时（宿主提供）
@deepseek-ai/*	Harness 插件框架（宿主提供）
@deepseek-ai/schemastery	设置 schema（宿主提供）

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

许可证

MIT