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 一条命令，网关自动启动/停止

已知限制

安装

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 网页版（快速/专家/识图）直接使用。

手动控制

# 查看网关日志 / 状态
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。