Skip to content

fssl168/trae-switch

 
 

Repository files navigation

Trae Switch

Trae Switch 是一个专为 Trae IDE 设计的工具,通过 DNS 劫持 + 本地反向代理,让 Trae IDE 支持第三方大模型服务商 API(如阿里百炼 Coding Plan、kimi coding plan等)。详细使用教程:https://mp.weixin.qq.com/s/W_Z_nbrO7ioU8upcq4KkOw

🚀 功能特点

  • 多服务商支持:可添加、编辑、删除多个服务商配置
  • 本地模型管理/v1/models 请求返回本地配置的模型(因为第三方通常不支持此接口)
  • 自动 Hosts 配置:将 api.openai.com 重定向到 127.0.0.1
  • CA 证书管理:生成并安装本地 CA 证书,用于 HTTPS 拦截
  • 实时状态监控:显示代理运行状态和当前激活的服务商
  • 不需要输入key:通过在trae中配置key,在本工具不需要输入任何apikey

📋 支持的服务商

  • ✅ 阿里百炼、Kimi等 Coding Plan
  • ✅ 其他支持 OpenAI 协议的第三方api服务商

🔧 技术架构

技术栈

  • 后端:Go (Wails 框架)
  • 前端:Svelte + Tailwind CSS
  • 网络:HTTPS 代理服务器
  • 系统:Windows 系统集成(Hosts 管理、证书安装)

核心模块

  1. 代理服务器:监听 443 端口,处理 OpenAI API 请求
  2. 配置管理:读写 config.json 配置文件
  3. Hosts 管理:自动设置和恢复 Hosts 配置
  4. 证书管理:生成和安装自签名 CA 证书
  5. 前端界面:现代化的用户交互界面

📦 安装方法

方法一:直接下载可执行文件

  1. Releases 页面下载最新版本的 trae-switch.exe
  2. 以管理员身份运行程序

方法二:从源码构建

  1. 克隆仓库:
    git clone https://github.com/yourusername/trae-switch.git
    cd trae-switch
  2. 安装依赖并编译

🛠️ 使用方法

1. 添加服务商配置

  1. 点击「+ 添加」按钮
  2. 填写服务商信息:
    • 名称:服务商显示名称(如 "阿里百炼")
    • API 地址:OpenAI 协议的 API 地址(如 https://coding.dashscope.aliyuncs.com/v1
    • 模型列表:添加可用的模型 ID(如 qwen3.5-pluskimi-k2.5 等)
  3. 点击「保存」

2. 启动代理

  1. 确保系统配置中的「Hosts 配置」和「CA 证书」都已启用
  2. 点击右上角的「启动」按钮
  3. 代理启动成功后,状态栏会显示「运行中」

3. 在 Trae IDE 中使用

  1. 打开 Trae IDE
  2. 进入模型设置
  3. 选择 OpenAI 服务商
  4. 输入对应第三方服务商的真实 API Key(如 sk-xxx
  5. 手动输入你想要使用的模型名称
  6. 关闭 auto mode 并选择刚添加的模型
  7. 开始使用!

⚙️ 配置文件

配置文件位于程序同目录下的 config.json,格式如下:

{
  "providers": [
    {
      "name": "服务商名称",
      "openai_base": "https://api.example.com/v1",
      "models": ["model-1", "model-2"]
    }
  ],
  "active_provider": 0
}
  • name:服务商显示名称
  • openai_base:OpenAI 协议的 API 地址
  • models:模型 ID 列表
  • active_provider:当前激活的服务商索引

📝 使用说明

  1. 添加服务商配置(API 地址和模型列表)并点击「启动」
  2. 在 Trae IDE 添加自定义模型,服务商选择 OpenAI 服务商
  3. 模型手动输入你想要使用的模型并且输入对应 API Key(如 sk-xxx)
  4. 关闭 auto mode 并且选择刚添加的模型

🔍 常见问题

Q: 启动失败怎么办?

A: 请检查:

  • 是否以管理员身份运行
  • 443 端口是否被占用
  • Hosts 配置是否成功
  • CA 证书是否安装

Q: 模型不显示怎么办?

A: 请确保:

  • 已在服务商配置中添加了模型
  • 已选择了正确的服务商
  • 代理已成功启动

Q: API Key 如何获取?

A: API Key 需要从对应服务商的官方网站获取

Q: 支持哪些模型?

A: 支持所有支持openai接口协议服务商提供的模型,只要在配置中添加对应的模型 ID 即可。

🛡️ 安全性

  • 本地运行:所有数据处理都在本地进行,不会上传任何数据
  • 自签名证书:仅用于本地 HTTPS 拦截,不会影响其他应用
  • Hosts 修改:仅修改 api.openai.com 的解析,不影响其他域名
  • 不存储key:通过在trae中配置key,在本工具不需要输入任何key

📄 许可证

本项目采用 MIT 许可证


Star History

Star History Chart

About

Trae Switch 是一个专为 Trae IDE 设计的工具,通过 DNS 劫持 + 本地反向代理,让 Trae IDE 支持第三方大模型服务商 API(如阿里百炼 Coding Plan、kimi coding plan等)。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • Go 42.4%
  • Svelte 33.9%
  • JavaScript 18.3%
  • CSS 4.5%
  • HTML 0.9%