非官方 · MIT 开源 · 本地桥接

连接网页,
接入你的工作流。

将 DeepSeek 网页版转换为本机可用的 OpenAI 兼容 API。在专用浏览器中登录,继续使用你熟悉的客户端。

WINDOWS / macOS / LINUX · x64 + ARM64

桥接服务在本机运行,模型推理仍由 DeepSeek 网页服务提供。

bridge / request trace交互示意
POST/v1/chat/completions
{
  "model": "deepseek-web",
  "stream": true,
  "messages": [{
    "role": "user",
    "content": "Hello, bridge."
  }]
}
客户端本机桥接DeepSeek 网页
↳运行一次示意,看看请求如何流转。
浏览器内的流程示意,不访问本机服务或真实账号。
接入熟悉的工具
Chatbox+CC Switch → Codex CLI+cURL / HTTP
查看接入方式 ↗

01 / BRIDGE THE GAP

保留能力,连接更多可能。

围绕网页版的真实能力,\n把常用交互带到兼容的客户端。

STREAM / THINK / SEARCH

从一个问题,到持续的回答。

支持流式输出、深度思考与联网搜索。在本地设置页统一控制,也能通过请求级字段覆盖思考与搜索开关。

TOOL CALLS

让工具,加入对话。

通过提示词协议桥接 function calling,并将有效结果转换为标准 tool_calls,供支持的客户端继续执行。

工具请求缓冲完整回答后返回;解析失败回退文本。
FILES & CONTEXT

不止文字,也保留上下文。

支持图片、PDF、TXT、Markdown 与 DOCX 附件。持久化会话映射,让客户端旧对话对应回原来的网页会话。

CONTROL & QUEUE

每一次请求,有序抵达。

一个账号串行处理,后续请求进入队列。提供取消、超时、限流提示与最小请求间隔设置,登录、诊断和日志集中在本机管理页。

02 / UNDER THE HOOD

一座桥,两端各司其职。

阅读架构说明 ↗
01 / CLIENT

你的客户端

发送 Chat Completions 请求,使用本地 API Key 连接桥接服务。

Chatbox · cURL · CC Switch
02 / LOCAL

Local Bridge

FastAPI 接口、串行队列、会话映射,再交给 Playwright 操作专用浏览器。

127.0.0.1:8317 / Playwright
03 / WEB SERVICE

DeepSeek 网页服务

使用你登录的网页账号处理消息,再由桥接服务将结果转为兼容响应。

chat.deepseek.com
i

这是浏览器自动化与协议适配,不是离线模型。消息与附件会提交到 DeepSeek 服务;本地保存浏览器配置、附件、日志与会话映射。

03 / FIT YOUR WORKFLOW

熟悉的工具,新的连接方式。

启动服务并在专用浏览器登录后,\n从本机设置页复制 API Key,即可接入。

OPENAI-COMPATIBLE PROVIDER

三项配置,接好下一次对话。

在 Chatbox 添加自定义供应商,选择 OpenAI API 兼容类型,填写地址、API Key 与模型。

完整接入指南 ↗
API 域名http://127.0.0.1:8317
API Key从本机设置页复制
模型deepseek-web

Chatbox 通常会自动补 /v1;如遇 404 或连接失败,再改用完整 /v1 地址。

04 / RUN IT YOUR WAY

选好平台,让连接发生。

RELEASE v0.1.1 ↗

Windows

Windows 10 / 11

解压后运行 DeepSeekBridge.exe

Linux

常见 Linux 发行版

需有可用的桌面浏览器环境

便携包自带 Python 运行时;仍需 Edge、Chrome 或可用的 Chromium。跨平台打包与 CI 验证不等同于真实账号端到端实测。

查看最新发行版 ↗SHA256SUMS.txt ↗
也可从源码开始

需要 Python 3.10+ 与 Edge / Chrome,首次启动自动安装依赖。

git clone https://github.com/Jimmy-xuzimo/deepseek-local-bridge.git
cd deepseek-local-bridge
.\start.bat
01

启动 Bridge

运行便携包或启动脚本,打开本机设置页。

02

登录网页版

在专用浏览器窗口登录 DeepSeek,并保持窗口运行。

03

连接客户端

复制本地 API Key,填写地址与 deepseek-web 模型名。

05 / KNOW THE BOUNDARIES

开始之前,了解边界。

非官方项目,仅限个人学习使用。网页改版、账号风控和服务条款都可能影响可用性;请勿商用或大规模并发。

常见问题与排查 ↗
需要 DeepSeek 官方 API Key 吗?

此项目使用已登录的 DeepSeek 网页账号,不使用官方 API Key。客户端需要填写的是 Bridge 在本机生成的 API Key。它不是官方 API 的替代服务承诺,可用性与使用限制仍受网页服务影响。

“本地”意味着对话不会联网吗?

不是。桥接程序、浏览器配置与会话映射在本机运行和保存,但消息与附件会发往 DeepSeek 网页服务处理。它不是离线推理,也不保证所有数据都不离开设备。

能让手机或局域网里的设备使用吗?

可以通过设置页提供的局域网地址和相同 API Key 接入。当前配置默认开启局域网服务与 CORS;端口及局域网开关变更需重启。管理页仅允许本机访问。请勿将端口映射到公网,也不要关闭 API Key 校验。

工具调用与流式有什么限制?

工具调用通过提示词协议桥接,需要等待完整回答后再解析;格式无效时回退为普通文本。一个账号串行处理请求,多步任务会排队。Codex CLI 使用 Responses 协议,需要经 CC Switch 路由转换。

Windows 提示未知发布者怎么办?

当前 Windows 便携包未做代码签名,可能出现 SmartScreen 信誉提示。先确认下载来源,并对照 Release 中的 SHA256SUMS.txt 检查文件。签名状态、信誉提示与恶意软件检测是不同事项,处理方式详见仓库文档。

网页改版或登录过期了怎么办?

先在本机设置页检查登录状态并重新登录。遇到网页结构变化,可保存诊断信息,根据文档使用 selectors.json 覆盖选择器,并通过 Issues 提供经过脱敏的问题说明。

LOCAL BRIDGE. CONNECTED WORKFLOW.

让工具之间,少一道距离。

从下载、登录,到你的下一次本地 API 调用。

获取 Bridge ↓反馈与建议 ↗