dsh-deepseek-web-adapter

Readme

# dsh-deepseek-web-adapter

> **English**: [README.en.md](README.en.md)

> ⚠️ **Developer Preview（开发者预览）**：本插件由个人开发者发布，**未经大规模真实环境测试**。
> 已验证：登录、基本问答、专家模式切换、单次工具调用、网关自动拉起/回收。
> 未充分验证：多轮工具循环、长对话迁移、子 agent 并发、无头模式、识图模式、断线恢复。
> 使用前请阅读下方[已知限制](#已知限制)。遇到问题欢迎提交 [Issues](https://github.com/huermi/dsh-deepseek-web-adapter/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 场景回归覆盖常见格式；模型输出极端怪异格式时工具调用仍可能失败 |

## 安装

```bash
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: { ... }` 内加入：

```yaml
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 并发 | 并发请求用独立页面（多窗口并行） |

## 手动控制

```bash
# 查看网关日志 / 状态
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、修改、继续开发、再发布，无需授权。**

如果你要接手或贡献：

```bash
# 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](https://github.com/huermi/dsh-deepseek-web-adapter/issues) 讨论。

主要维护点：
- `resources/driver.js` —— 浏览器引擎 + 工具调用解析器（DeepSeek 网页版 UI 变化时改这里）
- `resources/dsweb-gateway.js` —— 网关（OpenAI API / 登录 / 校准 / 并发 / 迁移）
- `lib/index.js` —— 插件 host（加载时拉起网关，卸载时回收）

## License

MIT —— 保留版权声明即可自由使用/修改/再分发。详细条款见 [LICENSE](LICENSE)。