README.md

MTGA

简介

MTGA 是一个基于本地代理的 IDE 固定模型服务商解决方案，适用于 Windows 和 macOS。

注意：从 v2.4.0 起，MTGA 下游统一暴露 OpenAI Chat Completions API；后端通过 LiteLLM 转发到 openai_chat_completion、openai_response、Anthropic、Gemini 等上游。上游类型通过配置组里的“提供商”字段显式指定；其中 openai_response 会由 MTGA 在代理层完成 chat-completions 与 responses 之间的转换。限制见 docs/provider-support.md。

你什么也看不见~~

MTGA 即 Make Trae Great Again !

目录

• MTGA
  • 简介
  • 目录
  • 更新日志
  • 快速开始
    • 安装
      • Windows
      • macOS
    • 使用
  • macOS 解决 “包已损坏” 问题
    • 图形化解决方案
    • cli 解决方案
  • trae 端提示 “添加模型失败” 的排查方案
  • 配置 Trae IDE
  • 😎 保持更新
  • 贡献
  • 架构与依赖约束
  • 友链
  • 引用
  • Star History

---

更新日志

最新日志详见： 最新发行版

历史日志归档： CHANGELOG.md

---

快速开始

安装

Windows

1. 从 GitHub Releases 下载最新版本的 MTGA_v{version}_windows_x64-setup.exe
2. 双击安装

macOS

1. 从 GitHub Releases 下载最新版本的 MTGA_v{version}_apple_{arch}.dmg
   • {arch} 为指令集架构：
     • x64：Intel 处理器
     • aarch64：Apple Silicon 处理器（M 系列）
2. 双击 DMG 文件，系统会自动挂载安装包
3. 将 MTGA_GUI.app 拖拽到 Applications 文件夹

使用

1. 启动 MTGA 应用程序
2. 添加代理配置组
   • API URL 只需要填域名（端口号可选，不懂的就不要填），不需要填后面的路由，例如：https://your-api.example.com
   • 如果你的接口不是标准 /v1 路由，可以自定义中间路由
3. 填写全局配置
   • 如果希望启用多模态能力，可以将模型名映射到内置多模态模型名上：
     • 
     • 
4. 点击"一键启动全部服务"按钮（macOS 需要管理员权限）
5. 等待程序自动完成以下操作：
   • 生成并安装证书
   • 修改hosts文件
   • 启动代理服务器
6. 完成后，按照配置 Trae IDE进行IDE配置

Note

• 代理配置和生成证书会持久化存储于用户数据目录，见 设置 - 用户数据

Warning

• 需要管理员权限
• macOS 端如提示“包已损坏”，请参考 macOS 解决 “包已损坏” 问题
• 如 trae 端添加模型失败，请参考 trae 端提示 “添加模型失败” 的排查方案

macOS 解决 “包已损坏” 问题

如果启动 MTGA_GUI.app 时弹出这样的提示：

点击取消。然后参考以下步骤解决：

图形化解决方案

1. 到 Sentinel Releases 下载 Sentinel.dmg
2. 双击 Sentinel.dmg 文件，将 Sentinel.app 拖拽到 Applications 文件夹
3. 从启动台或 Applications 文件夹启动 Sentinel.app
4. 将本项目的 MTGA_GUI.app 拖拽到 Sentinel.app 的左侧窗口中
   • 

MTGA_GUI.app 将被自动处理并启动

cli 解决方案

1. 找到 MTGA_GUI.app 完整路径，如 /Applications/MTGA_GUI.app。
2. 打开终端（Terminal）应用程序。
3. 执行以下命令签名 MTGA_GUI.app：

   xattr -d com.apple.quarantine <应用完整路径>

   这会移除 MTGA_GUI.app 中的 com.apple.quarantine 扩展属性。
4. 启动 MTGA_GUI.app。

trae 端提示 “添加模型失败” 的排查方案

如果一切顺利，你应该会在日志区看到收到请求的日志：

如无日志，请检查：

• hosts：确保包含 127.0.0.1 api.openai.com 这一行，且未被注释掉（# 开头）。

• 端口监听：确保没有其他程序正在使用端口 443（如浏览器、VPN 等）。

  • 可以使用以下命令检查：

    # windows
    netstat -ano | find ":443" | find "LISTENING"
    
    # macos
    netstat -lnp tcp | grep :443
    

  • 如果有进程在监听 443 端口，建议关闭该进程。

• 网络代理：确保没有其他代理软件正在运行，它们可能会干扰 MTGA 的代理功能。

  • 如需科学上网，请使用 TUN 模式而非系统代理。有条件的请在 本机之外 部署其他代理服务。
  • 如果 DNS 配置错误，也可能导致无法解析。
  • 不懂的请保持网络环境干净。

• 证书问题：如果 Trae 报错 SSL/TLS 相关错误，请检查 CA 证书是否已正确安装到"受信任的根证书颁发机构"。

• 防火墙：确保防火墙允许监听 443 端口的入站连接 (尽管是本地连接 127.0.0.1，通常不需要特别配置防火墙，但值得检查)。

• 进阶排查方法：

  • MTGA 配置好，主要流程 - 代理服务器操作 - 勾选 “关闭SSL严格模式”，启动全部服务。
  • 安装并打开 Reqable 工具，根据其提示安装其证书。
  • 其启动默认会打开调试，在右上角关闭它：
  • 打开一个 http 测试页：
  • 填写 list api 的 url，授权选择 “Bearer Token”，并填写你在 MTGA 全局配置处的 Key：
  • 点击发送并观察响应体。

---

配置 Trae IDE

1. 打开并登录 Trae IDE。
2. 在 AI 对话框中，点击右下角的模型图标，选择末尾的"添加模型"。
3. 服务商：选择 OpenAI。
4. 模型：按你在全局配置中填写的模型 ID，如果是 gpt-5，则选择 GPT-5。
5. API 密钥：全局配置中填写的 Key。
6. 点击"添加模型"。
7. 回到 AI 聊天框，右下角选择你刚刚添加的自定义模型。

现在，当你通过 Trae 与这个自定义模型交互时，请求应该会经过你的本地 MTGA 代理，并被转发到你配置的 API URL。

---

😎 保持更新

点击仓库右上角 Star 和 Watch 按钮，获取最新动态。

---

贡献

请查阅 贡献指南

架构与依赖约束

为避免模块耦合失控，项目遵循以下分层与依赖规则：

• UI -> actions -> services -> 领域模块（cert/hosts/network/proxy/update）-> runtime/platform
• UI 不得直接依赖领域模块，所有操作通过 actions/services 统一编排。
• 平台相关逻辑放在 modules/platform。

友链

引用

ca目录引用自wkgcass/vproxy仓库，感谢大佬！

Star History