前言¶
在 DeepSeek Harness（DSH）里接第三方模型，常见做法是自备 API Key 或走官方开放平台。豆包（Doubao）桌面客户端若已登录，会话凭据保存在本机 Chromium cookie 中，但 Harness 本身不会读取这些文件。若希望把同一账号下的 Seed 系列模型当作 DSH 的 model provider，并在设置里看到额度概况，就需要一条「读本机登录态 → 注册 provider → 可选模型清单」的插件链路。
下面介绍社区插件 DSH Connect Doubao（npm 包名 dsh-connect-doubao，维护者 Wahwayhale）。它不复用账号密码登录，而是依赖 Windows 上已登录的豆包电脑版，把解密后的 cookie 用于上游对话请求，并在设置面板提供只读的 5 小时限额与周额度展示。
这是什么¶
DSH Connect Doubao 的定位是：把本机豆包桌面客户端已有的登录态接入 DeepSeek Harness，作为 Seed 系列模型的 provider，并在设置面板里提供只读的额度概览（5 小时限额 / 周额度及重置倒计时）。
插件通过 DSH 插件机制注册 pi-ai provider、挂载设置侧「豆包」导航卡片，并运行仅监听 127.0.0.1 的 loopback shim 转发对话请求。项目采用 MIT 许可证，当前 npm 版本为 0.1.0（以 package.json 为准）。
前置条件¶
使用前需满足 README 中的硬性条件，否则卡片会显示「未登录」或 provider 不可用。
| 要求 | 说明 |
|---|---|
| 豆包桌面客户端已登录 | 插件不会代你登录或输入账号密码 |
| Windows x64 | 凭据解密依赖 Windows DPAPI；macOS / Linux 不支持 |
| 有可用订阅额度 | 免费账号可连，但配额较小 |
凭据从豆包客户端的 Chromium cookie jar 读取，在本进程内用 DPAPI 解密；cookie 值不写入磁盘、日志或命令行。未登录豆包客户端时，插件会明确报错，而不是静默失败。
核心功能¶
Seed 模型与推理强度¶
模型目录来自豆包客户端配置缓存（服务端下发的 menuConfV2），model_item_key 与 DSH 侧模型 id 为同一字符串，不做额外映射。README 列出的六个条目如下：
| id | 名称 | 徽章 | 推理强度 |
|---|---|---|---|
0 |
豆包 快速 | — | 支持 |
seed-lite-7b |
豆包 2.1 Lite | 0921 新版 |
支持 |
3 |
豆包 2.1 Turbo | 专家 |
支持 |
5 |
豆包 2.1 Pro | — | 支持 |
4 |
豆包 2.1 Turbo | 即将下线 |
支持 |
9 |
自动 | — | 支持 |
推理强度三档（低 / 中 / 高）对应上游 reasoning_effort 实测值 3 / 4 / 5。在设置卡片中可勾选要在 DSH 模型选择器里出现的条目，保存后按 model_item_key 发起请求。
只读额度与账号状态¶
设置面板左侧会出现「豆包」一级导航；右侧卡片展示 5 小时限额与周额度两条进度条及各自重置倒计时，支持手动刷新与约 5 分钟自动刷新。账号状态行区分「已登录 / 未登录 / 登录信息读不出来」等，并给出对应处置建议。
本地 shim 与诊断命令¶
对话请求经本机 loopback 端点转发，带每进程共享密钥，非本机来源一律拒绝。只读路由 /plugins/dsh-connect-doubao/quota 与 /catalog 按显式允许清单构造响应，不透传上游任意字段。
不消耗推理额度即可做链路体检：
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 可选参数包括 --model <key>、--thinking <low|mid|high>、--json、--timeout <ms>（默认 120000）。doctor 输出凭据、账号、provider 装配、额度四段结论；凭据只报数量，不报值。
安装与宿主版本¶
推荐通过 DSH CLI 安装（命令来自项目 README）：
dsh plugin --profile desktop add dsh-connect-doubao
也可全局安装 npm 包后再执行同一条 add：
npm install -g dsh-connect-doubao
dsh plugin --profile desktop add dsh-connect-doubao
本地开发可将源码目录路径传给 add（会写成 link: 依赖，改源码后 npm run build 即可，无需重装）。
受支持的宿主范围（README 声明）：
| 项目 | 版本 |
|---|---|
| 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 |
| Node.js | ^22.19.0 \|\| >=24.0.0 |
安装前请自行查看 GitHub 仓库 源码与 MIT 许可证。插件以当前 DSH 进程权限运行，会读取本机豆包用户数据目录下的 cookie 文件。
典型用法¶
- 在 Windows 上安装并登录豆包电脑版（README 一次验证环境为豆包 2.31.4）。
- 按上文命令将插件加入 DSH desktop profile，重启或按宿主要求加载插件。
- 打开 Harness 设置 → 左侧「豆包」，确认账号状态为已登录，刷新额度与模型清单，勾选需要的模型并保存。
- 在 DSH 模型选择器中选择「豆包（Doubao）」分组下的条目；需要调整思考深度时，在插件支持的档位（低 / 中 / 高）范围内配置。
- 若 provider 不可用，先运行
dsh-connect-doubao-doctor，再按四段结论排查凭据路径、登录态与 shim。
凭据查找顺序（代码逻辑）：%LOCALAPPDATA%\Doubao\User Data → %APPDATA%\Doubao\User Data → 各用户下的 AppData\Local\Doubao\User Data；命中条件为存在 Default\Network\Cookies。README 注明第 1 条在本机实测通过，其余为兜底分支且未在真机验证。
适用场景与注意¶
适合谁： 已在 Windows 上使用 DSH 桌面版、且日常通过豆包电脑版消耗 Seed 额度的开发者；希望在 Harness 里统一选模型、看双窗口额度，而不另开一套开放平台 Key 的场景。
务必知晓的限制（README「已知限制」摘要）：
- 使用非官方接口，逆向客户端行为；上游变更可能导致失效且无预告。
- 平台仅 Windows；风控滑块需回豆包客户端手动验证。
- 本 provider 只发送文本块，不提供图片输入；单账号，无账号池。
- id 为
'4'的 Turbo「即将下线」条目 README 标明未实测对话；响应侧无法独立证明服务端一定使用了所选model_item_key。 - 项目声明仅供个人学习与研究，与字节跳动、DeepSeek、DeepSeek Harness 官方无关联；使用须遵守豆包服务条款，风险自负。
社区插件目录 SkillHub 条目 与 GitHub 仓库相互独立，不构成官方应用商店或官方背书。安装第三方插件前，建议通读 README 中的免责声明与致谢（设计思路上借鉴了 dsh-connect-workbuddy 的插件结构，代码为独立实现）。
链接¶
- 目录页：https://www.skillhub.cn/plugins/Wahwayhale/dsh-connect-doubao
- 源码与完整说明：https://github.com/Wahwayhale/dsh-connect-doubao
DSH Connect Doubao 把「本机已登录豆包」变成 Harness 内可勾选、可诊断的 Seed provider，并附带只读额度面板；在 Windows 与豆包客户端已就绪的前提下，按官方 dsh plugin --profile desktop add 命令安装即可开始配置与 doctor 体检。
