DSH 豆包原生模型插件
把豆包接进 DeepSeek Harness(DSH)的原生模型选择器。登录后在对话底部直接选「豆包」分组,不用填 Base URL、不用建 DSH 专用 API Key。
它和 DSH 里其它通用 HTTP 供应商的区别在于:模型是注册进原生目录的,和本地模型、官方模型出现在同一个菜单里,享受同一套工具调用、图片输入、流式输出与用量统计。
为什么用它
| 通用 OpenAI 兼容供应商 | 本插件 | |
|---|---|---|
| 配置 | 填地址 + Key | 扫码/浏览器登录 |
| 模型目录 | 手填模型名 | 自动同步上游目录 |
| 工具调用 | 需自测兼容性 | 适配器负责转换与命名空间隔离 |
| 多模态 | 另接一套 | 图片/视频/音乐在同面板管理 |
| 账号 | 单账号 | 多账号池 + 静默续期 |
功能
原生模型接入
通过 ctx.llm.registerAdapter 把豆包注册成 DSH 的原生供应商——与 Jet Hub 用的是同一个接口。
- 工作模型:DeepSeek、Kimi、GLM、豆包工作系列,支持文本、图片输入与工具调用
- 豆包专家:豆包网页会话,支持深度思考与联网
- 原生目录随上游更新,未连接时也有静态兜底目录
工作账号池
- 扫码登录 / 浏览器登录 / JSON 导入三种方式
- 多账号调度:按可用性、额度、亲和性分配请求
- 静默续期:凭证快过期时自动刷新,不打断对话
- 额度与签到状态按上游真实返回展示
豆包网页会话
独立于工作账号池的第二套登录(两者互不替代):
- Playwright 维持登录页,页面内签名(
a_bogus/msToken/X-Bogus)由字节前端函数生成 - 真实浏览器指纹,请求走页面内
fetch - 掉登录能检测、能自动重登
多模态创作
图片、视频、音乐与文件中转,都在「多模态创作」页:
- 文生图 / 参考图生图,比例可选
- 文生视频、文生音乐
- 文件上传与中转下载链接
- 草稿与任务跨页保留;「停止等待」只代表客户端不等,不承诺上游已取消
模型开关
- 整个「豆包渠道」可一键关闭
- 单模型逐个启停,支持按筛选结果批量操作
- 设置即时生效,无需重启,立即同步到对话菜单
- 关闭渠道保留各模型开关状态;重新打开沿用原选择
- 旧会话指向已停用模型时会提示切换,不会静默换模型
用量与日志
- 「请求用量」:最近 24 小时 / 7 天 / 30 天,按模型、账号、Key 分组
- 「运行日志」:进程日志与请求日志分开,支持关键词/级别筛选、分页、暂停刷新、导出
- 未知或估算数据会明确标注,不冒充精确计费
自动签到
- 每日定时、可指定账号范围
- 状态如实展示:已确认 / 待回查 / 需人工处理
- 「待回查」不代表已领取成功
本地输出预算
网页模型使用保守的 UTF-8 预算估算;生成内容是否可用仍受上游状态影响。工作 Flash 模型支持一个可回退的本地窗口覆盖(327,680),关闭即恢复官方值。
界面
侧栏「豆包」下有七个页面:
| 页面 | 做什么 |
|---|---|
| 模型与登录 | 原生目录、渠道/模型开关、后台连接、网页登录 |
| 账号与登录 | 扫码/浏览器登录、导入导出、分组、额度、批量管理 |
| 多模态创作 | 图片、参考图、视频、音乐、文件中转 |
| 请求用量 | 请求量、Token 统计、分组趋势 |
| 自动签到 | 定时与账号范围、执行结果 |
| 插件设置 | 端口、Python 解释器、自动启动、高级兼容配置 |
| 运行日志 | 进程/请求日志、筛选、导出 |
界面继承 DSH 主题变量,不引入独立配色;浅色/深色跟随宿主。
安装
前置要求
- Node.js ≥ 20
- Python ≥ 3.10
- git(用于拉取上游源码)
1. 拉取上游源码
本仓库不附带上游源码(详见 THIRD_PARTY_NOTICES.md)。第一次必须执行:
python scripts/setup_upstream.py
它会按锁定的 commit 拉取两个上游仓库、应用本项目的适配补丁,并放到 python/ 下。
补丁是按锁定 commit 生成的。上游更新后要跟进,用
--refresh重新拉取; 若补丁无法应用,说明上游已变动,需要重新生成补丁。
2. 安装 Python 依赖
python -m pip install -r python/requirements.txt
python -m playwright install chromium
3. 装进 DSH
在 DSH 里 Plugins → 添加插件 → 选择本地目录,指向本仓库根目录。
Host 会注入 DOUBAO_GW_DATA_DIR(默认 ~/.dsh/doubao-gateway)并自动拉起本地服务。
首次启动较慢(要初始化 Python 环境与浏览器),之后常驻。
使用
- 打开侧栏「豆包 → 模型与登录」,确认模型已注册
- 在「账号与登录」扫码或浏览器登录(工作账号池),需要专家模型时再登录豆包网页会话
- 在对话底部模型菜单选「豆包」分组下的模型
- 要生成图片/视频/音乐,去「多模态创作」
架构
DSH Host
└── index.js 原生模型注册 + 后台生命周期 + 管理桥
├── native-provider.js LlmAdapter:消息/工具/图片/SSE → DSH 内部格式
└── [spawn] python/gateway.py (单进程、单端口 18790)
└── merged_app.py
├── / 工作账号池(doubao_work2api)
├── /doubao 豆包网页会话(doubao2api)
└── /v1 统一 OpenAI 兼容出口
- 浏览器侧代码在
client.js,由ui/*.part.js构建 - 内部模型调用使用仅存在于运行期的随机身份,不落盘
- 对外兼容 API 与管理面板的 Key 与会话,与 DSH 内部身份相互隔离
目录结构:
index.js Host:注册、生命周期、管理桥
native-provider.js DSH LlmAdapter
native-models.json 未连接时的静态模型目录
client.js 浏览器侧面板(由 ui/ 构建)
ui/*.part.js 界面源码
patches/ 上游适配补丁
scripts/ 构建与安装脚本
python/ 胶水层 + 由脚本拉取的上游包
开发与测试
# 构建 client.js
npm run build
# JS 测试
npm test
# Python 契约测试(需先完成 setup_upstream)
python -m unittest discover -s tests -p "test_merged_contract.py" -q
改完 ui/ 要重新 npm run build;改完 Python 侧在面板点「重新连接」或重载插件。
已知限制
- 上游会变:豆包前端或接口变动可能导致登录/签名失效,需要跟着修
- 网页会话需要 Chromium;headless 可用,但上游加强检测时可能失效
- 图片输入仅工作模型支持;网页专家声明文本输入
- Python 服务是独立子进程,占用约 60–100 MB 内存
- 「停止等待」只代表客户端停止,不承诺上游任务已取消
许可与第三方
本项目以 Apache-2.0 发布,见 LICENSE。
它依赖两个上游项目,均不由本仓库分发:
| 上游 | 许可 | 分工 |
|---|---|---|
| wangchuxiaoji-oss/doubao2api | Apache-2.0 | 网页会话、多模态、OpenAI 兼容服务 |
| niyouqianma/doubaowork2api | 上游未声明 | 工作账号池、Responses 接口 |
完整的来源、锁定版本与适配改动说明见 THIRD_PARTY_NOTICES.md。
免责声明
第三方社区作品,与字节跳动 / 豆包官方无任何隶属、合作或担保关系。
使用者需自行确保其使用方式符合上游服务条款与所在地法律法规。账号、Cookie、密钥属于 个人敏感数据,不应提交到公开仓库。
No comments yet. Be the first to write one.