前言¶

DSH 的插件生态强调“一切皆插件”，社区插件目录是独立站点，与 DeepSeek / 幻方无官方从属关系。

对于智能体开发者来说，一个常见诉求是：希望把某个模型能力接入 DSH，但不想先申请或配置 API Key。dsh-deepseek-web-adapter 面向这个场景，把 DeepSeek 网页版（chat.deepseek.com）包装成 DSH 的免 API Key 模型提供方。

下面介绍这个插件的定位、已核实能力、安装方式、典型配置，以及当前需要关注的限制。

这是什么¶

dsh-deepseek-web-adapter 是 huermi 维护的一个 DSH 插件。

它做的事情是：

• 让 DSH 通过本地网关访问 DeepSeek 网页版；
• 插件加载后自动拉起本地网关；
• 插件卸载时回收网关；
• 对外提供 OpenAI 兼容 API；
• 使用本地 MOCK_LLM_KEY，网关不校验该值。

它的核心对象是 DeepSeek 网页版账号，而不是 DeepSeek 官方 API Key。

核心功能¶

当前资料中可核实的 capability 包括：

1、免 API Key 的 DeepSeek 网页版模型提供方。
2、插件加载后自动拉起本地网关，卸载时回收。
3、提供 OpenAI 兼容 API。
4、连续对话。
5、工具调用。
6、模型校准。
7、子 agent 并发；资料标注该能力未充分验证。

需要注意，这是开发者预览版本，未经大规模真实环境测试。

已验证：

• 登录；
• 基本问答；
• 专家模式切换；
• 单次工具调用；
• 网关自动拉起/回收。

未充分验证：

• 多轮工具循环；
• 长对话迁移；
• 子 agent 并发；
• 无头模式；
• 识图模式；
• 断线恢复。

安装与启用¶

插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。该仓库使用 MIT License，允许自由 fork、修改、继续开发、再发布。

先安装插件：

dsh plugin --profile web add dsh-deepseek-web-adapter

插件加载后，网关会自动启动。资料中给出的启动时间是约 3-8 秒，DSH 终端日志会显示：

DeepSeek 网页版网关已监听 5688

配置 DSH 模型提供方¶

下一步是告诉 DSH 使用这个本地网关。

先编辑 ~/.dsh/settings.yaml，在 llm-pi-ai.providers 中加入 dsweb provider。示例如下：

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 识图 }
      ]
  }

这里的 baseURL 指向本地网关的 OpenAI 兼容接口。

再编辑 ~/.dsh/.credentials.yaml，加入：

MOCK_LLM_KEY: sk-mock-any-value

MOCK_LLM_KEY 可以是任意值，因为网关不校验它。

完成配置后，在 DSH 模型选择器中选择 DeepSeek 网页版，可选：

• DeepSeek 快速；
• DeepSeek 专家；
• DeepSeek 识图。

登录¶

本包只有 host，没有 client 卡片 UI，因此登录需要手动完成。

在浏览器打开：

http://127.0.0.1:5688/login

然后登录 chat.deepseek.com。登录页如有“保持登录/记住我”，资料建议勾上。

注意当前限制说明仍将登录态描述为内存 cookie，并提示关闭窗口后需重新登录。

典型用法¶

先验证网关是否可用。执行：

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

如果要本地启动网关调试，可以执行：

node resources/dsweb-gateway.js --port 5688 --base resources/runtime

如果要跑解析器回归测试，可以执行：

node tests/test-parser-all.js

适用场景与注意¶

适合：

• 想在不配置 DeepSeek API Key 的情况下，把 DeepSeek 网页版接入 DSH；
• 想通过 OpenAI 兼容 API 使用本地网关；
• 想在 DSH 模型选择器中直接选择 DeepSeek 快速、专家、识图；
• 愿意手动完成浏览器登录，并接受当前 Beta 状态。

需要特别注意：

1、本插件是开发者预览版本，未经大规模真实环境测试。
2、插件加载后自动拉起本地网关，卸载时回收网关。
3、依赖本机安装 Chrome。
4、登录态是内存 cookie，关闭窗口需重新登录。
5、依赖 DeepSeek 网页版 UI；网页改版可能导致选择器失效，需要更新 driver.js。
6、工具调用解析器有兜底但非万能；54 场景回归覆盖常见格式，极端怪异格式仍可能失败。
7、本包只有 host，无 client 卡片 UI；登录需手动打开 http://127.0.0.1:5688/login，配置可用 curl 调 /config，当前资料未给出 /config 的具体请求参数或示例。
8、需要 Node 18+ 与 Chrome，无第三方运行时依赖。
9、插件以当前 dsh 进程权限运行，安装前应检查源码与许可证。

链接¶

目录页：

https://www.skillhub.cn/plugins/huermi/dsh-deepseek-web-adapter

GitHub：

https://github.com/huermi/dsh-deepseek-web-adapter