dsh-deepseek-web-adapter
> English: README.en.md
> ⚠️ Developer Preview（开发者预览）：本插件由个人开发者发布，未经大规模真实环境测试。 > 已验证：登录、基本问答、专家模式切换、单次工具调用、网关自动拉起/回收。 > 未充分验证：多轮工具循环、长对话迁移、子 agent 并发、无头模式、识图模式、断线恢复。 > 使用前请阅读下方[已知限制](#已知限制)。遇到问题欢迎提交 Issues。
把 DeepSeek 网页版（chat.deepseek.com） 变成 DSH 的免 API Key 模型提供方。 插件加载后自动拉起本地网关（resources/dsweb-gateway.js + driver.js，单一常驻浏览器）， 提供 OpenAI 兼容 API。支持：连续对话、工具调用、模型校准、子 agent 并发。
- 无需 API Key、无需登录第三方平台（只需登录你自己的 DeepSeek 账号）
dsh plugin add一条命令，网关自动启动/停止
已知限制
| 限制 | 说明 |
|---|---|
| 开发中（Beta） | 未经大规模真实环境验证，可能有不稳定行为 |
| 无 client 卡片 UI | 本包只有 host（自动拉起网关）。没有登录按钮/校准/无头开关等卡片控件——登录请手动打开 http://127.0.0.1:5688/login，配置用 curl 调 /config（见手动控制）。卡片 UI 在开发仓库（dsweb-plugin/client-llm.js），欢迎贡献 |
| 依赖真实浏览器 | 需要本机安装 Chrome；登录态是内存 cookie，关闭窗口需重新登录 |
| 依赖 DeepSeek 网页版 UI | 网页版改版可能导致选择器失效（校准/发送/提取），届时需更新 driver.js |
| 解析器有兜底但非万能 | 54 场景回归覆盖常见格式；模型输出极端怪异格式时工具调用仍可能失败 |
安装
dsh plugin --profile web add dsh-deepseek-web-adapter
# 或从 GitHub（发布后）：
dsh plugin --profile web add github:你的用户名/dsh-deepseek-web-adapter插件加载后，网关自动启动（3-8 秒，日志见 DSH 终端：DeepSeek 网页版网关已监听 5688）。
配置 DSH 模型提供方
编辑 ~/.dsh/settings.yaml，在 llm-pi-ai.providers: { ... } 内加入：
dsweb:
{
displayName: DeepSeek 网页版 (免 API),
apiKeyEnv: MOCK_LLM_KEY,
api: openai-completions,
baseURL: http://127.0.0.1:5688/v1/,
models:
[
{ id: deepseek-chat, name: DeepSeek 快速 },
{ id: deepseek-reasoner, name: DeepSeek 专家 },
{ id: deepseek-vision, name: DeepSeek 识图 }
]
}并在 ~/.dsh/.credentials.yaml 加：MOCK_LLM_KEY: sk-mock-any-value（任意值，网关不校验）。 DSH 配置热加载——模型选择器立即出现 DeepSeek 网页版。
登录
浏览器打开 http://127.0.0.1:5688/login → 登录 chat.deepseek.com （若有"保持登录/记住我"务必勾上——会话持久，关窗口/重启不丢）。
使用
DSH 模型选择器选 DeepSeek 网页版（快速/专家/识图）直接使用。
| 能力 | 说明 |
|---|---|
| 连续对话 | 网页版历史保持，超长度限制（默认 50 条，可调）自动迁移+摘要 |
| 工具调用 | 模型输出 tool_call 代码块 → 网关解析（54 场景容错）→ DSH 执行 |
| 模型校准 | deepseek-reasoner → 专家模式（校准数据内置，可重录） |
| 子 agent 并发 | 并发请求用独立页面（多窗口并行） |
手动控制
# 查看网关日志 / 状态
curl http://127.0.0.1:5688/v1/models
# 重启网关（卸载插件即停止网关；重新启用即自动拉起）
dsh plugin --profile web remove dsh-deepseek-web-adapter && dsh plugin --profile web add dsh-deepseek-web-adapter目录结构
lib/index.js # host：加载时自动拉起网关，卸载时回收
resources/
dsweb-gateway.js # 核心网关（OpenAI API + 登录 + 校准 + 并发 + 迁移 + 工具解析）
driver.js # 浏览器引擎（单一常驻页面）
runtime/ # 运行时（driver 副本 + 校准数据；profile 首次启动自动生成）
cordis.patch.yml # bundle 配置补丁工作原理
DSH (dsweb provider) → 网关 5688 → driver (单一常驻 Chrome) → chat.deepseek.com
插件加载 → 自动 spawn 网关 → 卸载 → 自动回收DeepSeek 网页版没有原生 function calling——网关用提示工程让模型输出 tool_call JSON， 再经多层容错解析（嵌套/别名/单反斜杠路径/尾逗号/缺引号/安全网重试）转换为标准 tool_calls 交给 DSH 执行。工具结果回传网页版继续。回归测试 54 场景（tests/ 见开发仓库）。
开发 / 接手
本仓库采用 MIT License——任何人可以自由 fork、修改、继续开发、再发布，无需授权。
如果你要接手或贡献：
# 1. fork 或 clone
git clone https://github.com/huermi/dsh-deepseek-web-adapter.git
# 2. 安装依赖（无第三方运行时依赖，仅 Node 18+ 与 Chrome）
# 3. 本地启动网关调试
node resources/dsweb-gateway.js --port 5688 --base resources/runtime
# 4. 跑解析器回归测试（改动 driver.js 后必须跑）
node tests/test-parser-all.js # 期望 54/54 通过开发仓库（含卡片 UI、host 自动拉起、完整回归套件）：见 dsweb-plugin/ 目录说明或 Issues 讨论。
主要维护点：
resources/driver.js—— 浏览器引擎 + 工具调用解析器（DeepSeek 网页版 UI 变化时改这里）resources/dsweb-gateway.js—— 网关（OpenAI API / 登录 / 校准 / 并发 / 迁移）lib/index.js—— 插件 host（加载时拉起网关，卸载时回收）
License
MIT —— 保留版权声明即可自由使用/修改/再分发。详细条款见 [LICENSE](LICENSE)。