[**中文**](README.md) · [English](README.en.md)
[](LICENSE)
[](https://github.com/deepseek-ai/deepseek-harness)
[](#模型档位)
[](#测试与验证)
[](https://github.com/cv-superding/dsh-deepseek-web-login/actions/workflows/ci.yml)
[](https://github.com/cv-superding/dsh-deepseek-web-login/releases)
[](#免责声明)
[](#贡献)
[](#开发)
**把 chat.deepseek.com 网页版接进 DSH：用浏览器登录态（不是 API Key）驱动 agent 的工具调用、思考流与图片理解。**
---
## 这是什么
DSH（DeepSeek Harness）通过 `ctx.llm` 的 **provider 适配器**接入模型。本项目实现了 `deepseek-web`
这个 provider —— 它不调用官方 API，而是复用你**已登录的网页版**：PoW 挑战、会话、SSE 流式、
文件上传，全部走网页端私有接口。
于是：**在模型选择器里选 `DeepSeek 网页 · 快速模式`，就能用网页版免费额度跑 DSH 的 agent**。
```text
DSH agent loop ──▶ ctx.llm ──▶ [deepseek-web 适配器] ──▶ chat.deepseek.com
│ ├─ PoW（SHA3 WASM，**在浏览器页面里**求解）
│ ├─ chat_session（**按 DSH 会话复用，跨重启续上**）
│ ├─ chat/completion（SSE patch 流，链式只发增量）
│ └─ file/upload_file（图片输入）
└─ 提示词工具协议 ⇄ tool-call 块
```
> **⚠️ 0.7.0 起：必须能启动 Edge / Chrome。**
> PoW 挑战改为**在真实页面上下文里**求解（原因见下方「为什么这样更不容易被限流」）。
> 找不到浏览器时**会明确报错，不会退回 Node 侧求解** —— 这是刻意的：
> Node 侧解 PoW 是被公开列为的封号触发条件，退回去等于这个改动没做。
> 已经用 `DSH_NO_BROWSER_TRANSPORT=1` 显式关掉浏览器传输的环境需要撤销该设置。
## 它是怎么工作的（以及为什么不是「反代」）
被问得最多的两个问题：**你们是操作 DOM，还是截获页面的请求？是不是个反代？**
答案都是**不是** —— 它自己构造请求、直接发给网页端私有接口。准确的说法是
「**网页端私有接口的非官方客户端**」。逐步拆开：
| 阶段 | 做什么 | 用什么 |
| --- | --- | --- |
| **① 登录捕获**（只做一次） | 开一个**独立 profile** 的浏览器窗口让你登录，把页面自己发出的请求头读一份存下来：`Authorization: Bearer`、域 cookie、反爬头 `x-hif-dliq` / `x-hif-leim`、一批 `x-client-*` | Electron 的 `webRequest.onBeforeSendHeaders` |
| **② 请求构造**（每次调用） | 自己拼 `POST /api/v0/chat/completion`；PoW 自己解：先要 `create_pow_challenge`，再用 SHA3 WASM 算出答案塞进 `x-ds-pow-response` | 插件自己的 HTTP 客户端 |
| **③ 发送** | 默认**交给系统 Edge / Chrome 的网络栈**发出（CDP 驱动真实页面），TLS / HTTP2 指纹与真实浏览器一致；也可切回 Node | 见下方「传输层」 |
| **④ 解析与对接** | 自己解 `response/fragments` 的 SSE 帧、分思考与正文通道；工具调用走**提示词协议**（网页端没有原生 function calling；主形态是行首 `DO:{...}`） | 自研解析器 |
**唯一沾到"截获"的只有第 ① 步**，而且那一步是「读一份 + 清掉自己的痕迹」：同一个回调顺手把请求头里的
Electron 品牌（UA 与 UA-CH）删掉，否则网页端会判「使用环境异常」。它**不改写业务请求、也不转发任何东西**，
而且只在登录那一次生效 —— **登录完之后页面关掉，插件照样跑。**
### 为什么不是「反代」
反代（反向代理）的关键是**中间人**：客户端以为自己在跟原服务器说话，实际请求被转发了一层。
这里没有中间人 —— **插件自己就是那个客户端**，以网页端的身份直连 DeepSeek。
中间没有转发层，也不需要额外跑一个本地服务。
### 和另外两条常见路线的区别
| | DOM 自动化（如 cuckoo-code） | 请求 hook（浏览器扩展，如 deepseek-pp） | 本插件 |
| --- | --- | --- | --- |
| **请求由谁发出** | **页面** | **页面** | **插件自己** |
| 登录态来源 | 人在窗口里手动登 | 你日常浏览器里的登录态 | 开窗捕获一次、存在本机 |
| 网页改版会怎样 | 选择器一改就坏 | 只依赖接口路径 | 只依赖接口，完全不碰 DOM |
| 浏览器要一直开着吗 | 是 | 是 | **否** |
前两条路线的共同点是「**请求是浏览器发的**」，只有本插件是发送方。代价是接口变了要跟着改；
换来的是不依赖 DOM、可以后台无人值守地跑。
## 为什么这样更不容易被限流
网页端会拦自动化调用，而且公开的同类项目文档里已经列出了触发条件。0.7.0 按其中最可识别的那几条
做了调整：
| 原本的做法 | 问题 | 现在 |
|---|---|---|
| 在 **Node 里** `WebAssembly.instantiate` 求PoW 挑战 | 被明确列为「自动解挑战」的封号触发条件 | **在真实页面里**用官方自己的 wasm 求 |
| 每次调用**临时建会话、用完即删** | 真人不会这样建删对话（实测曾一天建 182 个会话） | **按 DSH 会话复用**，跨重启续上（`resume-state.json`） |
| 每轮**全量重发** | 请求体量与节奏都不像真人 | **链式投喂**：只发增量，`parent_message_id` 挂在上一条回答下面 |
| 固定请求间隔 | 真人打字不是等距的 | 见设置页的请求间隔（可配随机区间） |
**代价（也是 0.7.0 的破坏性变更）**：必须有可用的 Edge / Chrome。
找不到浏览器时会明确报错—— **不会静默退回 Node 侧解PoW**，因为那样等于这个改动没做，
只是给了「已经改好了」的错觉。
⚠️ **需要说清的边界**：这些调整**降低**被识别为自动化的概率，**不构成"不会被封"的保证**。
逆向网页端本身违反服务条款，风险是"判罚多严"而不是"会不会被抓到"。
稳定性优先请用官方 API，或用已有的付费订阅走 OAuth。
## 界面预览
设置页按用途分成 **7 个标签**（一次只显示一页）—— **账号**（登录状态 / 当前账号 / **账号库** / 手动 Token）·
**模型**（可用模型 / 连通性测试）· **Token 统计**（用量与台账扫读）·
**防风控**（请求节流 / 会话清理及其三个区间 / **调用台账**）·
**传输层**（指纹 + 一键测试）· **上下文**（每轮全量 / 链式投喂）· **关于**（版本与更新 / 数据位置 / 风险说明）。
操作反馈条常驻在标签栏之上，切到哪一页都看得见。
设置页（**真实截图**，拍于拆页之前）：当前账号 / 登录状态（适配器注册、凭证来源、PoW WASM、服务端校验）/ 三种登录方式（Microsoft Edge · 我的默认浏览器 · 从已登录窗口恢复）/ 手动粘贴 token。
DSH「使用统计」里看到的调用量 —— 免费网页通道，当日 1042.8 万 tokens / 164 次调用：
设置页**示意图**（标注各区块用途）：登录状态 / **当前账号（退出当前账号 · 退出并登录其它账号）** / 浏览器窗口登录 / 从已登录窗口恢复 / 手动 token / 连通性测试 / 模型列表。
## 核心能力
| 能力 | 说明 |
|---|---|
| 🔐 **网页登录（无 API Key）** | Electron 独立分区窗口里正常登录，插件**旁路捕获**真实 `Authorization`、cookie、`x-hif-*` 指纹头与客户端版本头 |
| 🧩 **PoW 求解** | `create_pow_challenge` + DeepSeek 自家 `sha3_wasm_bg.*.wasm` 的 `wasm_solve`，**在浏览器页面上下文里执行**（0.7.0 起，见下方「为什么这样更不容易被限流」）；WASM 地址**自动发现**（哈希随部署变化），失败自动回退 |
| 🌊 **流式** | 同时兼容 `response/fragments`（THINK/RESPONSE 片段）与直连 `thinking_content`/`content` 两套 SSE 格式，含 `{o:"APPEND"}` 与裸 `{v}` 续段；按逻辑流去重，快照重放不重复吐字 |
| 🛠 **工具调用** | 网页端没有原生 function calling → 提示词 JSON 协议 + 流式过滤器（跨包标记、围栏、多调用、假阳性回退）→ 合成 `tool-call` 块并给出 `finish: tool-calls`；工具定义按 5.6 万字符预算整段下发，超预算时**列出被省略的工具名**并要求模型别猜参数 |
| 🛡 **格式漂移双保险** | ① 指令层显式禁止 XML/DSML 标记并说明后果（实测模型会主动拒绝该格式）；② 解析层同时容忍 JSON 与 XML/DSML 两族（`\|DSML\|` 前缀、`dsml-` 连字符、裸 `
