9router-gateway

🚀 9router-gateway: 本地大模型网关 Agent Skill (全自包含跨平台版)

这是一个专为 AI Agent（WorkBuddy、TRAE、Codex、Google Antigravity 等）打造的全自包含、开箱即用的 9router 本地网关技能包。

用户或 AI 安装本 Skill 后，无需手动编译安装任何损坏的 npm 包，只需一键运行 Python 脚本，即可启动本地网关并畅享 Google Antigravity 渠道的 16+ 个 Gemini / Claude 满血大模型。

🌟 核心特性

• 📦 全自包含（Self-Contained）：内嵌修复好的 9router 运行时与全量依赖，零全局污染。
• 🛡️ 守护保活（Daemon Process）：自动脱离父进程会话树，防止被各类 FDE / IDE 的清理机制杀掉。
• ⚡ 自动化向导（Zero-Config Wizard）：内置 oauth_helper.py，自动拦截 Google OAuth 回调并生成 API Key。
• 🛠️ 5 大铁律防御：代码级规避 Clash TUN 流量劫持（绑定 127.0.0.1）、彻底屏蔽 --log 崩溃参数。
• 🔌 OpenAI 兼容协议：无缝对接任意支持 Custom OpenAI 协议的客户端。

📂 项目结构

9router-gateway/
├── SKILL.md                     # [入口] Agent Skill 核心规范与使用说明书
├── README.md                    # 项目快速上手文档
├── vendor/                      # [内置载荷] 完整免安装 9router 运行时
│   └── 9router/                 # （已修复 Next.js 路由清单与全量依赖）
├── scripts/                     # [自动化运维脚本]
│   ├── common.py                # 动态寻找 Node.js 解释器与端口探测
│   ├── start_gateway.py         # 守护进程拉起 9router
│   ├── health_check.py          # 一键探测网关与 16 个 ag/ 模型状态
│   └── oauth_helper.py          # 自动化 OAuth 回调拦截器与 Key 签发向导
└── references/                  # [配置] 16 个 ag/ 满血模型清单
    └── models_map.json

🚀 快速上手

1. 安装 Skill

将本项目直接 Clone 或下载解压至你的 AI Agent 技能目录：

# WorkBuddy（推荐，开箱即用）
git clone https://github.com/Bm7651/9router-gateway.git ~/.workbuddy/skills/9router-gateway

# TRAE / Codex / 其他 FDE：clone 到对应的 skills 目录即可
git clone https://github.com/Bm7651/9router-gateway.git

• WorkBuddy: ~/.workbuddy/skills/9router-gateway
• TRAE / Codex / 通用 Agent: 放入项目 .skills/ 或用户全局 Skills 目录。

仓库体积约 85MB（内置 9router 绿色运行时），clone 时间取决于网络。

2. 启动网关

在终端运行内置脚本即可拉起网关守护进程：

python scripts/start_gateway.py

3. 授权绑定（首次使用）

在新机器上首次使用，运行向导完成 Google 授权绑定与密钥生成：

python scripts/oauth_helper.py

4. 客户端配置（OpenAI 兼容协议）

📄 开源协议

本项目遵循 MIT License。