mirror of
https://github.com/Nezumi-2711/9router.git
synced 2026-09-22 13:38:31 +00:00
Feat : Gitbook
This commit is contained in:
decolua
@@ -0,0 +1,387 @@
|
||||
# 常见问题
|
||||
|
||||
关于 9Router 的常见问题。
|
||||
|
||||
---
|
||||
|
||||
## 什么是 9Router?
|
||||
|
||||
**9Router 是一款 AI 模型路由工具,能够最大化你的订阅价值并最小化成本。**
|
||||
|
||||
它使用 3 层回退系统在多个 AI 提供商之间智能路由请求:
|
||||
1. **订阅层** - 充分利用你已付费的 Claude Code、Codex、Gemini 配额
|
||||
2. **低价层** - 超低价替代方案(每 1M tokens $0.20-$0.60)
|
||||
3. **免费层** - 无限免费模型应急备用
|
||||
|
||||
**核心优势:**
|
||||
- 不再浪费订阅配额
|
||||
- 配额耗尽时自动回退
|
||||
- 实时配额跟踪
|
||||
- 比直接使用 API 节省 90% 成本
|
||||
|
||||
---
|
||||
|
||||
## 价格是如何计算的?
|
||||
|
||||
**9Router 采用三层定价策略:**
|
||||
|
||||
### 第 1 层:订阅(优先使用)
|
||||
- **Claude Code**(Pro/Max):$20-100/月 - 5 小时 + 每周配额
|
||||
- **OpenAI Codex**(Plus/Pro):$20-200/月 - 5 小时 + 每周配额
|
||||
- **Gemini CLI**:免费 - 每月 180K 次补全 + 每天 1K
|
||||
- **GitHub Copilot**:$10-19/月 - 每月重置
|
||||
- **Antigravity**:免费 - 类似 Gemini
|
||||
|
||||
**目标:** 在配额重置前用掉每一点!
|
||||
|
||||
### 第 2 层:低价(备用)
|
||||
- **GLM-4.7**:每 1M tokens $0.60/$2.20 - 每日 10AM 重置
|
||||
- **MiniMax M2.1**:每 1M tokens $0.20/$1.00 - 5 小时滚动
|
||||
- **Kimi K2**:$9/月固定(10M tokens)
|
||||
|
||||
**目标:** 比 ChatGPT API(每 1M $20)便宜 90%!
|
||||
|
||||
### 第 3 层:免费(应急)
|
||||
- **iFlow**:8 个免费模型(Kimi K2、Qwen3、GLM、MiniMax...)
|
||||
- **Qwen**:3 个免费模型(Qwen3 Coder Plus/Flash、Vision)
|
||||
- **Kiro**:2 个免费模型(Claude Sonnet 4.5、Haiku 4.5)
|
||||
|
||||
**目标:** 当其他配额都受限时零成本回退!
|
||||
|
||||
---
|
||||
|
||||
## 9Router 是免费的吗?
|
||||
|
||||
**是的,9Router 本身 100% 免费且开源。**
|
||||
|
||||
**可用的免费层提供商:**
|
||||
- **Gemini CLI** - 每月 180K 次补全(免费 Google 账户)
|
||||
- **iFlow** - 8 个无限模型(免费 OAuth)
|
||||
- **Qwen** - 3 个无限模型(免费 OAuth)
|
||||
- **Kiro** - Claude Sonnet/Haiku(免费 AWS Builder ID)
|
||||
|
||||
**只用免费层提供商,就可以永久免费编码!**
|
||||
|
||||
**可选的付费提供商:**
|
||||
- 你可能已有的订阅服务(Claude Code、Codex、Copilot)
|
||||
- 超低价替代方案(每 1M tokens $0.20-$0.60)
|
||||
|
||||
---
|
||||
|
||||
## 支持哪些提供商?
|
||||
|
||||
### 订阅型提供商
|
||||
- **Claude Code**(Pro/Max)- Claude 4.5 Opus/Sonnet/Haiku
|
||||
- **OpenAI Codex**(Plus/Pro)- GPT 5.2 Codex、GPT 5.1 Codex Max
|
||||
- **Gemini CLI**(免费)- Gemini 3 Flash/Pro、2.5 Pro/Flash
|
||||
- **GitHub Copilot** - GPT-5、Claude 4.5、Gemini 3
|
||||
- **Antigravity**(Google)- Gemini 3 Pro、Claude Sonnet 4.5
|
||||
|
||||
### 低价提供商
|
||||
- **GLM**(Zhipu AI)- GLM 4.7、GLM 4.6V Vision
|
||||
- **MiniMax** - MiniMax M2.1
|
||||
- **Kimi**(Moonshot AI)- Kimi Latest
|
||||
- **OpenRouter** - 透传到任意 OpenRouter 模型
|
||||
|
||||
### 免费提供商
|
||||
- **iFlow** - 8 个模型(Kimi K2、Qwen3、GLM、MiniMax、DeepSeek...)
|
||||
- **Qwen** - 3 个模型(Qwen3 Coder Plus/Flash、Vision)
|
||||
- **Kiro** - 2 个模型(Claude Sonnet 4.5、Haiku 4.5)
|
||||
|
||||
**合计:15+ 个提供商,50+ 个模型**
|
||||
|
||||
详情请见 [提供商文档](providers/subscription.md)。
|
||||
|
||||
---
|
||||
|
||||
## 可以同时使用多个提供商吗?
|
||||
|
||||
**可以!这正是 9Router 的核心功能。**
|
||||
|
||||
**通过组合(Combos),你可以把多个提供商串联起来实现自动回退:**
|
||||
|
||||
```
|
||||
示例组合: "premium-coding"
|
||||
1. cc/claude-opus-4-5(订阅主力)
|
||||
2. glm/glm-4.7(低价备用)
|
||||
3. if/kimi-k2(免费应急)
|
||||
|
||||
→ 配额耗尽时自动切换
|
||||
→ 永不停止编码
|
||||
→ 几乎零额外成本
|
||||
```
|
||||
|
||||
**创建组合的方法:**
|
||||
```
|
||||
仪表盘 → 组合 → 新建
|
||||
→ 按优先级添加模型
|
||||
→ CLI 中使用组合名: "premium-coding"
|
||||
```
|
||||
|
||||
**优势:**
|
||||
- 配额耗尽时零停机
|
||||
- 自动成本优化
|
||||
- 所有工具使用同一个模型名
|
||||
|
||||
详情见 [组合文档](features/combos.md)。
|
||||
|
||||
---
|
||||
|
||||
## 配额跟踪是如何工作的?
|
||||
|
||||
**9Router 为所有提供商提供实时配额跟踪:**
|
||||
|
||||
**功能:**
|
||||
- **Token 消耗** - 每次请求的输入/输出 tokens
|
||||
- **重置倒计时** - 配额刷新前剩余时间
|
||||
- **使用统计** - 每日/每周/每月报告
|
||||
- **成本估算** - 预计支出(付费层)
|
||||
- **配额告警** - 配额不足时通知
|
||||
|
||||
**配额类型:**
|
||||
- **5 小时滚动** - Claude Code、Codex、MiniMax
|
||||
- **每日重置** - Gemini CLI(每日 1K)、GLM(10AM)
|
||||
- **每周重置** - Claude Code、Codex(额外配额)
|
||||
- **每月重置** - Gemini CLI(180K)、GitHub Copilot(1 日)
|
||||
|
||||
**查看配额:**
|
||||
```
|
||||
仪表盘 → 提供商 → 配额跟踪
|
||||
→ 实时使用情况 + 重置倒计时
|
||||
```
|
||||
|
||||
详情见 [配额跟踪文档](features/quota-tracking.md)。
|
||||
|
||||
---
|
||||
|
||||
## 9Router 能配合 Cursor 使用吗?
|
||||
|
||||
**可以,但 Cursor 需要使用云端 endpoint。**
|
||||
|
||||
**问题:** Cursor IDE 不支持 localhost endpoint。
|
||||
|
||||
**解决方案:** 使用 9Router 云端部署:
|
||||
|
||||
```
|
||||
Cursor Settings → Models → Advanced:
|
||||
OpenAI API Base URL: https://9router.com/v1
|
||||
OpenAI API Key: [从仪表盘获取]
|
||||
Model: cc/claude-opus-4-5-20251101
|
||||
```
|
||||
|
||||
**替代方案:** 在 VPS 上自托管,使用公开域名:
|
||||
```bash
|
||||
# 部署到 VPS
|
||||
git clone https://github.com/decolua/9router.git
|
||||
cd 9router/app
|
||||
npm install && npm run build
|
||||
npm start
|
||||
|
||||
# 配置 Nginx 反向代理
|
||||
# 将 Cursor 指向: https://your-domain.com/v1
|
||||
```
|
||||
|
||||
**其他 CLI 工具支持 localhost:**
|
||||
- Cline ✅
|
||||
- Claude Desktop ✅
|
||||
- Codex CLI ✅
|
||||
- Continue ✅
|
||||
- RooCode ✅
|
||||
|
||||
详情见 [Cursor 集成指南](integration/cursor.md)。
|
||||
|
||||
---
|
||||
|
||||
## 可以自托管 9Router 吗?
|
||||
|
||||
**可以!9Router 支持多种部署方式:**
|
||||
|
||||
### Localhost(默认)
|
||||
```bash
|
||||
npm install -g 9router
|
||||
9router
|
||||
→ 仪表盘: http://localhost:3000
|
||||
→ API: http://localhost:20128/v1
|
||||
```
|
||||
|
||||
### VPS/云
|
||||
```bash
|
||||
git clone https://github.com/decolua/9router.git
|
||||
cd 9router/app
|
||||
npm install && npm run build
|
||||
|
||||
export JWT_SECRET="your-secure-secret"
|
||||
export INITIAL_PASSWORD="your-password"
|
||||
export NODE_ENV="production"
|
||||
|
||||
npm start
|
||||
```
|
||||
|
||||
### Docker
|
||||
```bash
|
||||
docker build -t 9router .
|
||||
docker run -d \
|
||||
-p 3000:3000 \
|
||||
-e JWT_SECRET="your-secret" \
|
||||
-v 9router-data:/app/data \
|
||||
9router
|
||||
```
|
||||
|
||||
### Cloudflare Workers
|
||||
```bash
|
||||
cd 9router/app
|
||||
npm run deploy:cloudflare
|
||||
```
|
||||
|
||||
**环境变量:**
|
||||
- `JWT_SECRET` - **生产环境必须修改!**
|
||||
- `DATA_DIR` - 数据库存储路径(默认:`~/.9router`)
|
||||
- `INITIAL_PASSWORD` - 仪表盘登录(默认:`123456`)
|
||||
- `NODE_ENV` - 部署时设为 `production`
|
||||
|
||||
详情见 [部署指南](getting-started/installation.md#deployment)。
|
||||
|
||||
---
|
||||
|
||||
## 我的数据安全吗?
|
||||
|
||||
**是的,9Router 优先考虑安全和隐私:**
|
||||
|
||||
**本地存储:**
|
||||
- 所有数据存储在本地 `~/.9router`(或自定义 `DATA_DIR`)
|
||||
- 不会发送数据到 9Router 服务器
|
||||
- OAuth tokens 使用 JWT 加密
|
||||
|
||||
**无遥测:**
|
||||
- 不跟踪使用情况
|
||||
- 不分析
|
||||
- 不向外回连
|
||||
|
||||
**开源:**
|
||||
- GitHub 上提供完整源码
|
||||
- 可自行审计安全性
|
||||
- 社区评审
|
||||
|
||||
**最佳实践:**
|
||||
- 生产环境修改 `JWT_SECRET`
|
||||
- 使用强 `INITIAL_PASSWORD`
|
||||
- 云端部署启用 HTTPS
|
||||
- 定期轮换 API keys
|
||||
|
||||
**9Router 存储的内容:**
|
||||
- 提供商 OAuth tokens(加密)
|
||||
- API keys(加密)
|
||||
- 使用统计(仅本地)
|
||||
- 组合配置
|
||||
|
||||
**9Router 不存储的内容:**
|
||||
- 你的 prompt 或响应
|
||||
- 你生成的代码
|
||||
- 个人信息
|
||||
|
||||
---
|
||||
|
||||
## 如何更新 9Router?
|
||||
|
||||
**更新方式取决于安装类型:**
|
||||
|
||||
### 全局 NPM 安装
|
||||
```bash
|
||||
npm update -g 9router
|
||||
```
|
||||
|
||||
### 本地安装
|
||||
```bash
|
||||
cd 9router/app
|
||||
git pull origin main
|
||||
npm install
|
||||
npm run build
|
||||
npm start
|
||||
```
|
||||
|
||||
### Docker
|
||||
```bash
|
||||
docker pull 9router:latest
|
||||
docker stop 9router
|
||||
docker rm 9router
|
||||
docker run -d \
|
||||
-p 3000:3000 \
|
||||
-v 9router-data:/app/data \
|
||||
9router:latest
|
||||
```
|
||||
|
||||
**查看版本:**
|
||||
```bash
|
||||
9router --version
|
||||
```
|
||||
|
||||
**破坏性变更:**
|
||||
- 查看 [CHANGELOG.md](https://github.com/decolua/9router/blob/main/CHANGELOG.md)
|
||||
- 大版本更新前备份 `~/.9router`
|
||||
- 阅读大版本的迁移指南
|
||||
|
||||
---
|
||||
|
||||
## 如何贡献?
|
||||
|
||||
**欢迎贡献!**
|
||||
|
||||
### 贡献方式:
|
||||
|
||||
1. **报告 bug:**
|
||||
- [GitHub Issues](https://github.com/decolua/9router/issues)
|
||||
- 附上错误日志、复现步骤
|
||||
|
||||
2. **功能请求:**
|
||||
- [GitHub Discussions](https://github.com/decolua/9router/discussions)
|
||||
- 描述使用场景和价值
|
||||
|
||||
3. **提交代码:**
|
||||
```bash
|
||||
# Fork 仓库
|
||||
git clone https://github.com/YOUR_USERNAME/9router.git
|
||||
cd 9router
|
||||
|
||||
# 创建分支
|
||||
git checkout -b feature/your-feature
|
||||
|
||||
# 修改代码
|
||||
npm install
|
||||
npm run dev
|
||||
|
||||
# 测试
|
||||
npm test
|
||||
|
||||
# 提交并推送
|
||||
git add .
|
||||
git commit -m "Add your feature"
|
||||
git push origin feature/your-feature
|
||||
|
||||
# 在 GitHub 上创建 Pull Request
|
||||
```
|
||||
|
||||
4. **改进文档:**
|
||||
- 修正错别字、添加示例
|
||||
- 翻译到其他语言
|
||||
- 编写教程
|
||||
|
||||
5. **添加提供商:**
|
||||
- 实现新的 provider adapter
|
||||
- 参考 `app/lib/providers/` 中的示例
|
||||
|
||||
**贡献指南:**
|
||||
- 遵循现有代码风格
|
||||
- 为新功能添加测试
|
||||
- 更新文档
|
||||
- 提交保持原子化、描述清晰
|
||||
|
||||
详情见 [CONTRIBUTING.md](https://github.com/decolua/9router/blob/main/CONTRIBUTING.md)。
|
||||
|
||||
---
|
||||
|
||||
## 需要更多帮助?
|
||||
|
||||
- **文档:** [9router.com/docs](https://9router.com/docs)
|
||||
- **GitHub:** [github.com/decolua/9router](https://github.com/decolua/9router)
|
||||
- **Issues:** [github.com/decolua/9router/issues](https://github.com/decolua/9router/issues)
|
||||
- **故障排除:** [troubleshooting.md](troubleshooting.md)
|
||||
Reference in New Issue
Block a user