网页对话桥接 sam666-byte/dsh-better-bridge

dsh-better-bridge

在免费的 DeepSeek 网页版聊天上运行 DeepSeek Harness（dsh），不用按量计费的平台 API —— 另外还带一个通往 Better DeepSeek 浏览器扩展的桥接。

DeepSeek Harness 是个能力很强的开源智能体框架，但它内置的账号服务商会从 DeepSeek 平台钱包扣费。chat.deepseek.com 上的消费级聊天是免费的。这个项目把两个世界连起来：

1. chatbrain relay（relay/）—— 一个小的 OpenAI 兼容 HTTP 中继，把自己注册成 dsh 里的自定义服务商。底层用你自己已登录的网页会话驱动 DeepSeek 的消费级网页聊天 API，解出网页客户端的 proof-of-work 挑战，再把框架的工具调用翻译成聊天模型能照做的文本标签约定。
2. BDS 桥接插件（外部依赖，见 PLUGIN.md）—— 上游的 dsh-better-deepseek 插件，让 Better DeepSeek 浏览器扩展把 dsh 当作执行端。

💛 Dukung Kami

This project is free and open source. If it helps you, consider supporting
its development — any amount, no minimum burden (from Rp1.000).

👉 saweria.co/Nusantaraeaters

"Dukung Nusantara Bots - aplikasi AI agent gratis di HP. Donasi seikhlasnya buat pengembangan aplikasi. Terima kasih!"

架构

your machine
┌───────────────────────────────────────────────────────────────┐
│ │
│ Browser DeepSeek Harness (dsh) │
│ ┌──────────────────┐ ┌────────────────────────────┐ │
│ │ chat.deepseek.com│ │ agent loop, tools, memory │ │
│ │ + Better │ ping / │ │ │
│ │ DeepSeek ext ├────────►│ dsh-better-deepseek plugin│ │
│ └────────┬─────────┘ bridge └──────────────┬─────────────┘ │
│ │ │ provider: │
│ │ web session │ "chatbrain" │
│ │ (extract.py) ▼ │
│ │ ┌────────────────────────┐ │
│ └───────────────────────►│ chatbrain relay │ │
│ .websession.json │ relay/relay2.py │ │
│ (chmod 600) │ OpenAI API on :20232 │ │
│ └───────────┬────────────┘ │
└──────────────────────────────────────────────┼───────────────┘
│ HTTPS + PoW header
▼
chat.deepseek.com web API
(/api/v0/chat/completion)

组件

| 路径 | 说明 |
| relay/relay2.py | 中继服务：在回环地址上提供兼容 OpenAI 的 /v1/chat/completions 和 /v1/models，后端接 DeepSeek 网页版聊天 API。 |
| relay/extract.py | 一次性提取器：从专用 Firefox 配置档（你手动登录的那个）里取出 userToken 和 cookies，写入 .websession.json。 |
| PLUGIN.md | 桥接插件是上游包（EdgeTypE 的 dsh-better-deepseek，MIT 协议），没有放进本仓库。这里只记录它的职责和 ping 约定。 |
| .env.example | 全部配置变量，值都是占位符。 |

工作原理

会话提取

你先在专用 Firefox 配置档里手动登录一次 chat.deepseek.com。extract.py 用 Selenium/geckodriver 重新打开这个配置档，读取 localStorage["userToken"]，把 {token, cookies} 存成 JSON，文件权限 600。之后中继服务就像网页客户端一样，用这份凭证向网页 API 认证。token 失效后，重跑提取器（或者重新登录）即可。

工作量证明请求头

每次网页版聊天补全都要带 x-ds-pow-response 请求头：客户端先请求挑战（/api/v0/chat/create_pow_challenge），解出答案，再回传一段 base64 编码的 JSON。中继服务用 deepseek-pow 包（WASM 求解器）算哈希。

坑点： 这个包的 to_answer_payload() 会漏掉 target_path，少了它 API 直接拒绝该请求头。中继服务自己拼 payload：{algorithm, challenge, salt, signature, answer: int, target_path: "/api/v0/chat/completion"}。

工具调用标签约定

网页版聊天没有原生函数调用，所以中继服务把 harness 的完整系统提示词 + 工具目录每个会话只渲染一次，作为文本前导，之后只发增量。模型用文本标签输出工具调用：

<tool_call>{"name": "bash", "arguments": {"command": "ls -la"}}</tool_call>

回复再解析回 OpenAI 的 tool_calls。解析器故意写得很偏执，因为模型会混用多种方言：

- <tool_call> 里的 JSON 靠括号配对扫描定位（闭合标签不可靠——JSON 块会被 DSML 标签收尾，反过来也一样）；
- DeepSeek 原生的 DSML 方言（<｜｜DSML｜｜invoke …>）也解析，包括修复乱码损坏的全角分隔符；
- 「拍平」的工具 JSON（参数在顶层）会重新嵌套回去；
- 可见文本里残留的标签碎片会被清掉；
- 跟着工具调用一起出现的长代码围栏会被裁掉（完整文本本来就在工具调用里）。

一段简短前导 + 每轮一次的近期提醒，让聊天模型表现得像个自主智能体（自己用工具，绝不甩给用户一段脚本；最终答案用可读的聊天文本，而不是代码块报告）。

多链隔离

harness 也会发辅助请求（会话标题、记忆任务）。请求携带工具的消息进入主智能体链；其余消息各自成链，链的键取自其开头若干条消息的哈希。辅助链永远不会重置或污染主对话。链的数量有上限（约 6 条），超出时按简单淘汰策略移除。

对话映射

每条链与一个服务端网页聊天会话一一对应（/api/v0/chat_session/create）。中继会记录消息数量水位线，以及最后一条已转发消息的指纹；如果 harness 的历史出现分叉（编辑、回滚、新建会话），链会重置为新的聊天，并重新发送完整渲染内容。权威的助手文本从 /api/v0/chat/history_messages（RESPONSE 片段）读回，而不是从 SSE 流中读取。

安装与使用

前置条件

- Python 3.11+
- Node.js LTS（harness 本身运行在 Node 上；Python 只用于中继）
- 单独安装 DeepSeek Harness
- Firefox + geckodriver（用于一次性的登录/提取）
- 一个你能在 chat.deepseek.com 登录的 DeepSeek 账号

步骤

git clone <this-repo> dsh-better-bridge
cd dsh-better-bridge
pip install -r requirements.txt

1) One-time: create a dedicated Firefox profile and log in
firefox -ProfileManager # create e.g. "chatbrain", log in to
chat.deepseek.com, then close Firefox
CHATBRAIN_FF_PROFILE=/path/to/profile python3 relay/extract.py
→ writes ./.websession.json (mode 600)

2) Start the relay
python3 relay/relay2.py # listens on 127.0.0.1:20232

3) Register the relay as a dsh provider (cordis patch, profile "web"):
an OpenAI-compatible provider entry, e.g.
chatbrain:
baseURL: http://127.0.0.1:20232/v1
apiKeyEnv: CHATBRAIN_API_KEY # any dummy value; relay is loopback
models: [deepseek-chat] # contextWindow 1000000
then select provider "chatbrain", model "deepseek-chat" in dsh.

4) (Optional) Add the Better DeepSeek bridge plugin — see PLUGIN.md.

单独对中继做一次基本检查：

curl http://127.0.0.1:20232/v1/models
curl http://127.0.0.1:20232/v1/chat/completions \
-H 'Content-Type: application/json' \
-d '{"model":"deepseek-chat","messages":[{"role":"user","content":"ping"}]}'

DeepSeek Web (4Free) — 把 V3 + R1 作为额外模型（无需官方 API）

d4f-wrapper/ 把 DeepSeek V3（deepseek-v3-d4f）和 DeepSeek R1 （deepseek-r1-d4f）加入 dsh 模型选择器，走的是中继所用的同一个 DeepSeek 网页聊天——不需要官方 API key。它是一个 OpenAI 兼容服务器（端口 20233），基于 xtekky/deepseek4free 构建，共用中继的 userToken（运行时从 .websession.json 读取，绝不存进仓库）。安装步骤、服务商 YAML 和验证方法见 d4f-wrapper/README.md。上游停留在 2025 年 1 月且无人维护——wrapper 自带补丁让它继续可用（会话路径、JSON-patch SSE、首片段路径、R1 思考泄露），外加与 relay 相同的 DBS/工具调用处理（从 relay2.py 导入）。

Windows（原生，不用 WSL）

同一套流程在 Windows 上也能跑，区别只在 shell 语法和几个路径。使用期间保持 3 个独立终端打开：

1. 安装 Node.js LTS：从 nodejs.org 下载，然后克隆仓库并安装 Python 依赖：
git clone https://github.com/sam666-byte/dsh-better-bridge
cd dsh-better-bridge
pip install -r requirements.txt

2. 创建专用 Firefox 配置档： 按 Win+R，输入 firefox -ProfileManager，新建配置档（比如「chatbrain」），在该配置档里登录 chat.deepseek.com，然后彻底关闭 Firefox ——配置档还开着，提取器就读不到。配置档路径大致是 C:\Users\<you>\AppData\Roaming\Mozilla\Firefox\Profiles\xxxx.chatbrain

3. 在 CMD 里设置环境变量（相当于 Windows 版的 export）：
set CHATBRAIN_FF_PROFILE=C:\Users\<you>\AppData\Roaming\Mozilla\Firefox\Profiles\xxxx.chatbrain
set FIREFOX_BIN=C:\Program Files\Mozilla Firefox\firefox.exe
set GECKODRIVER_PATH=C:\path\to\geckodriver.exe

set 只对当前终端生效，所以第 4–5 步要在同一个终端里跑（或者用 setx 让变量永久生效）。

4. 提取会话（Firefox 必须完全关闭；用 python，不要用 python3）：
python relay\extract.py

成功标志 = 仓库文件夹里出现 .websession.json。

5. 启动 relay，终端保持打开：
python relay\relay2.py

另开一个终端检查：curl http://127.0.0.1:20232/v1/models

6. 在新终端里启动 dsh（PowerShell 若报执行策略错误，改用 CMD）。先全局安装 dsh —— 不要用 npx（npx @deepseek-ai/dsh 的下载目前是坏的：缺 @deepseek-ai/cordis-plugin-group 依赖，会报 ERR_MODULE_NOT_FOUND）：
npm install -g @deepseek-ai/dsh
dsh web --host 127.0.0.1 --port 3080 --no-open

全局安装后仍报同一个缺包错误，就先单独装它：npm install -g @deepseek-ai/cordis-plugin-group，再跑一次 dsh。
不要用 --host 0.0.0.0 —— dsh 拒绝通配地址。在 VPS 上，回环地址就够了：你从 VPS 内部访问 GUI（比如走 RDP）。打开控制台打印的 token URL，用 DeepSeek 账号登录。

7. 把 relay 注册为 dsh 服务商： 编辑 C:\Users\<you>\.dsh\profiles\web\cordis.patch.yml，加一条 OpenAI 兼容的服务商条目： chatbrain: baseURL: http://127.0.0.1:20232/v1 apiKeyEnv: CHATBRAIN_API_KEY # any dummy value; relay is loopback
models: [deepseek-chat]

把 CHATBRAIN_API_KEY 设成任意假值，重启 dsh，然后选择在 GUI 里选择服务商 chatbrain、模型 deepseek-chat。完成——dsh 现在跑在免费网页聊天上了。

注意：所有端口都走回环地址，不需要配置 VPS 防火墙规则。如果之后聊天报错或返回空，说明会话 token 过期了——重新执行第 4 步即可。Better DeepSeek 桥接插件（见 PLUGIN.md）是可选的，可以以后再添加。

配置

所有配置都通过环境变量完成（见 .env.example）：

| 变量 | 默认值 | 使用方 | 含义 |
| CHATBRAIN_PORT | 20232 | relay | OpenAI 兼容 API 的回环端口 |
| CHATBRAIN_SESSION_FILE | ./.websession.json | relay、extractor | 会话 {token, cookies} 文件 |
| CHATBRAIN_LOG_FILE | ./relay2.log | relay | 主 relay 日志 |
| CHATBRAIN_REPLIES_LOG | ./relay2-replies.log | relay | 模型原始回复（私密——包含对话内容） |
| CHATBRAIN_FF_PROFILE | ./ff-profile | extractor | 专用 Firefox 配置档目录 |
| FIREFOX_BIN | /usr/bin/firefox | extractor | Firefox 可执行文件 |
| GECKODRIVER_PATH | geckodriver | extractor | geckodriver 可执行文件（默认从 PATH 查找） |

安全须知

- 你的会话 token 就是你的账号。 .websession.json 里存着一个有效的 userToken，等同于已登录状态。把它设为 chmod 600，放在你信任的机器上，绝不要提交到仓库（它已在 .gitignore 里）。
- relay 只监听回环地址。不要把它暴露出去：任何能访问该端口的人都能消耗你的聊天会话。
- 回复日志包含你的原始对话——像对待 token 一样对待它。
- 使用专用 Firefox 配置档（最好再配一个专用账号），这样万一出错，影响范围也小。

免责声明

这是一个非官方项目。它与 DeepSeek、Anysphere、EdgeTypE 均无关联，也未获其认可或赞助。

它通过你自己的账号会话与 DeepSeek 的消费级网页聊天界面交互，而不是官方平台 API。这可能违反 DeepSeek 的服务条款，账号可能因此受到处理（限流、限制或封禁）。仅供学习与个人使用，风险自负。如果你需要受支持的集成方式，请使用官方 DeepSeek 平台 API。

致谢与署名

- DeepSeek Harness © DeepSeek — MIT License — github.com/deepseek-ai/deepseek-harness
- Better DeepSeek © EdgeTypE — MIT License — github.com/EdgeTypE/better-deepseek （包括 dsh-better-deepseek 插件包）
- deepseek-pow — relay 使用的 PoW 求解包（PyPI）

许可证

MIT — 见 LICENSE。