MTGA 即 Make Trae Great Again !
3. 填写全局配置
- **如果希望启用多模态能力，可以将模型名映射到内置多模态模型名上：**
- 
4. 点击"一键启动全部服务"按钮（macOS 需要管理员权限）
5. 等待程序自动完成以下操作：
- 生成并安装证书
- 修改hosts文件
- 启动代理服务器
6. 完成后，按照[配置 Trae IDE](#配置-trae-ide)进行IDE配置
> [!NOTE]
>
> - 代理配置和生成证书会持久化存储于用户数据目录，见 `设置 - 用户数据`
> [!WARNING]
>
> - 需要管理员权限
> - macOS 端如提示“包已损坏”，请参考 [macOS 解决 “包已损坏” 问题](#macos-解决-包已损坏-问题)
> - 如 trae 端添加模型失败，请参考 [trae 端提示 “添加模型失败” 的排查方案](#trae-端提示-添加模型失败-的排查方案)
## macOS 解决 “包已损坏” 问题
如果启动 `MTGA_GUI.app` 时弹出这样的提示：
**点击取消**。然后参考以下步骤解决：
### 图形化解决方案
1. 到 [Sentinel Releases](https://github.com/alienator88/Sentinel/releases/latest) 下载 `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`：
```zsh
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](https://reqable.com/) 工具，根据其提示安装其证书。
- 其启动默认会打开调试，在右上角关闭它：
- 打开一个 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 按钮，获取最新动态。
---
## 贡献
请查阅 [贡献指南](CONTRIBUTING.md)
## 架构与依赖约束
为避免模块耦合失控，项目遵循以下分层与依赖规则：
- UI -> actions -> services -> 领域模块（cert/hosts/network/proxy/update）-> runtime/platform
- UI 不得直接依赖领域模块，所有操作通过 actions/services 统一编排。
- 平台相关逻辑放在 `modules/platform`。
- 多 provider 上游调用由 `python-src/modules/mlitellm` 提供，它是项目内置的精简执行层模块，不作为独立第三方依赖安装。
## 友链
[](https://linux.do/)
## 引用
`ca`目录引用自`wkgcass/vproxy`仓库，感谢大佬！
## Star History