DeepSeek Cursor Bridge

Cursor 扩展，集成 deepseek-cursor-proxy，提供可视化控制面板，在 IDE 内一键启停代理。

仓库地址： https://github.com/taoorange/deepseek-cursor-bridge

前置条件

cd /Users/KXWELL/deepseek-cursor-bridge
npm install
npm run compile

cursor /Users/KXWELL/deepseek-cursor-bridge

任选一种方式：

方式	操作
侧边栏	点击左侧活动栏 DeepSeek Bridge 图标（盾牌）
状态栏	点击右下角 DeepSeek 状态
命令面板	`Cmd+Shift+P` → 输入 `DeepSeek Bridge: Open Control Panel`

左侧 DeepSeek Bridge → 代理控制 面板提供：

cd /Users/KXWELL/deepseek-cursor-bridge
npm install -g @vscode/vsce
vsce package
cursor --install-extension deepseek-cursor-bridge-0.1.0.vsix

安装后重启 Cursor，左侧会出现 DeepSeek Bridge 图标。

命令	说明
DeepSeek Bridge: Open Control Panel	打开控制面板
DeepSeek Bridge: Start Proxy	启动代理
DeepSeek Bridge: Stop Proxy	停止代理
DeepSeek Bridge: Restart Proxy	重启代理
DeepSeek Bridge: Copy Base URL	复制 Base URL
DeepSeek Bridge: Show Logs	查看日志
DeepSeek Bridge: Setup Wizard	配置向导

Settings → DeepSeek Bridge 或通过控制面板保存：

配置	默认值	说明
`deepseekBridge.proxyPath`	`/Users/github/deepseek-cursor-proxy/.venv/bin/deepseek-cursor-proxy`	proxy 可执行文件
`deepseekBridge.proxyCwd`	`/Users/github/deepseek-cursor-proxy`	工作目录
`deepseekBridge.port`	`9000`	本地端口
`deepseekBridge.ngrok`	`true`	是否启用 ngrok
`deepseekBridge.ngrokUrl`	`""`	固定 ngrok 域名（可选）
`deepseekBridge.autoStart`	`true`	启动 Cursor 时自动运行
`deepseekBridge.verbose`	`false`	详细日志

问题	处理
启动失败	面板查看错误信息 → 查看日志
ngrok 报错	确认已安装 ngrok 并配置 authtoken
Cursor 连不上	Base URL 必须以 `/v1` 结尾，且为 HTTPS
修改配置不生效	保存配置后点击重启
扩展看不到	确认在 Extension Development Host 窗口中操作

架构说明见项目根目录 ARCHITECTURE.md。

本扩展通过子进程调用 deepseek-cursor-proxy，负责进程管理、UI 控制和日志展示，不重写 proxy 核心逻辑。