proxy-deepseek

一个基于 Bun 构建的本地代理服务器，用于将 OpenAI 兼容的 API 请求转发到 DeepSeek API，特别为 Xcode Intelligence 设计。

项目简介

proxy-deepseek 是一个本地代理服务器，它：

• 提供 OpenAI 兼容的 API 接口
• 将请求转发到 DeepSeek API
• 默认运行在端口 30011
• 支持 Xcode Intelligence 等需要 OpenAI 兼容接口的工具

功能特性

• ✅ OpenAI 兼容的 API 接口
• ✅ 支持流式和非流式响应
• ✅ 智能消息截断策略（支持 recent/last_only/all 三种模式）
• ✅ 自动配置文件生成
• ✅ 跨平台编译支持（Windows、macOS Intel、macOS ARM）
• ✅ 健康检查端点
• ✅ CORS 支持

快速开始

前置要求

• Bun 运行时环境

安装依赖

bun install

首次运行配置

1. 首次运行程序：

   bun run index.ts

2. 配置 DeepSeek API Key： 程序首次运行后会自动创建 proxy-deepseek-config.yaml 配置文件，请编辑该文件：

   # 编辑配置文件，填入你的 DeepSeek API Key
   vim proxy-deepseek-config.yaml

   将 deepseek.apiKey 的值改为你的实际 API Key：

   deepseek:
     apiKey: "your-actual-deepseek-api-key-here"

3. 重新启动服务：

   bun run index.ts

开发模式运行

bun run dev

配置说明

配置文件位置

• proxy-deepseek-config.yaml - 主配置文件

配置项说明

server:
  port: 30011                    # 服务端口

deepseek:
  apiKey: "your-deepseek-api-key" # DeepSeek API Key
  baseURL: "https://api.deepseek.com/v1" # DeepSeek API 地址
  defaultModel: "deepseek-chat"   # 默认模型

messageStrategy:
  strategy: "recent"             # 消息策略：recent | last_only | all
  maxMessages: 10                # 最大消息数量（recent 策略时）
  alwaysKeepSystem: true         # 是否始终保留系统消息

completion:
  defaultTemperature: 0.7        # 默认温度参数
  defaultMaxTokens: 1000         # 默认最大 token 数

消息策略说明

• recent: 保留最近的对话（推荐用于 Xcode Intelligence）
• last_only: 只保留最后一条用户消息
• all: 保留所有消息

API 接口

模型列表

GET /v1/models

聊天补全

POST /v1/chat/completions

健康检查

GET /health

Xcode Intelligence 配置

在 Xcode 中配置本地代理：

1. 打开 Xcode → Settings → Intelligence
2. 点击 "Add a Model Provider"
3. 选择 "Locally Hosted"
4. 在端口字段中输入：

   30011
   

构建可执行文件

构建所有平台

bun run build:all

构建特定平台

# Windows
bun run build:win

# macOS ARM (M1/M2)
bun run build:mac-m1

# macOS Intel
bun run build:mac-x64

构建后的可执行文件位于 dist/ 目录下。

项目结构

proxy-deepseek/
├── index.ts                    # 主程序文件
├── proxy-deepseek-config.yaml  # 配置文件
├── package.json               # 项目配置
├── tsconfig.json              # TypeScript 配置
├── bun.lock                   # Bun 锁文件
└── README.md                  # 项目说明

故障排除

常见问题

1. 端口被占用

   • 修改 proxy-deepseek-config.yaml 中的 server.port 配置

2. API Key 错误

   • 检查 proxy-deepseek-config.yaml 中的 deepseek.apiKey 是否正确
   • 确认 DeepSeek API Key 有效且未过期

3. 连接超时

   • 检查网络连接
   • 确认 DeepSeek API 服务可用

日志查看

程序运行时会输出详细的日志信息，包括：

• 配置加载状态
• 请求处理信息
• 错误信息

许可证

本项目基于 MIT 许可证开源。

贡献

欢迎提交 Issue 和 Pull Request！