WildDragonLLC/9router
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs(i18n): fix port typo and add RTK Token Saver features

Browse source 
Fix port 201281 -> 20128/v1 typo in README.zh-CN.md diagram, add
RTK Token Saver mention to README.vi.md/README.zh-CN.md, update
Tier 3 free providers to 2026 lineup, and drop hardcoded /tmp
node_modules path from tests/package.json and tests/README.md.
This commit is contained in:
huuanh20 2026-08-05 11:53:19 +07:00 committed by decolua
parent 25e4bf1c6c
commit baebc9a06e
4 changed files with 64 additions and 64 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

78
i18n/README.vi.md
View file

@ -1,21 +1,15 @@
Dưới đây là bản dịch tiếng Việt của tài liệu Markdown, giữ nguyên toàn bộ cú pháp và cấu trúc kỹ thuật.
<div align="center"> <div align="center">
<img src="../images/9router.png?1" alt="Bảng điều khiển 9Router" width="800"/> <img src="../images/9router.png?1" alt="Bảng điều khiển 9Router" width="800"/>
# 9Router - Free AI Router # 9Router - Free AI Router & Token Saver
**Không bao giờ ngừng code. Tự động định tuyến tới các mô hình AI MIỄN PHÍ & giá rẻ với cơ chế dự phòng thông minh.** **Không bao giờ ngừng code. Tiết kiệm 20-40% token với RTK + tự động dự phòng sang các mô hình AI MIỄN PHÍ & giá rẻ.**
**Nhà cung cấp AI Miễn cho OpenClaw.** **Kết nối tất cả công cụ AI Code (Claude Code, Codex, Cursor, Cline, Copilot, Antigravity...) tới 40+ Nhà cung cấp AI & 100+ Mô hình.**
<p align="center">
<img src="../public/providers/openclaw.png" alt="OpenClaw" width="80"/>
</p>
[![npm](https://img.shields.io/npm/v/9router.svg)](https://www.npmjs.com/package/9router) [![npm](https://img.shields.io/npm/v/9router.svg)](https://www.npmjs.com/package/9router)
[![Downloads](https://img.shields.io/npm/dm/9router.svg)](https://www.npmjs.com/package/9router) [![Downloads](https://img.shields.io/npm/dm/9router.svg)](https://www.npmjs.com/package/9router)
[![License](https://img.shields.io/npm/l/9router.svg)](https://github.com/decolua/9router/blob/main/LICENSE) [![License](https://github.com/decolua/9router/blob/main/LICENSE)](https://github.com/decolua/9router/blob/main/LICENSE)
[🚀 Bắt đầu nhanh](#-quick-start) • [💡 Tính năng](#-key-features) • [📖 Cài đặt](#-setup-guide) • [🌐 Website](https://9router.com) [🚀 Bắt đầu nhanh](#-quick-start) • [💡 Tính năng](#-key-features) • [📖 Cài đặt](#-setup-guide) • [🌐 Website](https://9router.com)
</div> </div>
@ -24,19 +18,21 @@ Dưới đây là bản dịch tiếng Việt của tài liệu Markdown, giữ
## 🤔 Tại sao chọn 9Router? ## 🤔 Tại sao chọn 9Router?
**Ngừng lãng phí tiền bạc và gặp phải giới hạn:** **Ngừng lãng phí tiền bạc, token và không bao giờ lo chạm giới hạn (rate limit):**
- ❌ Hạn mức gói đăng ký hết hạn mỗi tháng mà không dùng hết - ❌ Hạn mức gói đăng ký hết hạn mỗi tháng mà không dùng hết
- ❌ Giới hạn tốc độ (rate limit) ngăn bạn giữaừng khi code - ❌ Giới hạn tốc độ (rate limit) làm gián đoạn công việc mid-coding
- ❌ Các API đắt đỏ ($20-50/tháng cho mỗi nhà cung cấp) - ❌ Kết quả của công cụ (git diff, grep, ls...) ngốn rất nhiều token
- ❌ Phải chuyển đổi thủ công giữa các nhà cung cấp - ❌ Chi phí API đắt đỏ ($20-50/tháng cho từng nhà cung cấp)
- ❌ Phải chuyển đổi thủ công giữa các nhà cung cấp AI
**9Router giải quyết vấn đề này:** **9Router giải quyết vấn đề này:**
- ✅ **Tối đa hóa gói đăng ký** - Theo dõi hạn mức, sử dụng từng bit trước khi reset - ✅ **RTK Token Saver** - Tự động nén nội dung `tool_result`, tiết kiệm 20-40% token trên mỗi request
- ✅ **Tự động dự phòng** - Gói đăng ký → Giá rẻ → Miễn phí, thời gian chết bằng không - ✅ **Tối đa hóa gói đăng ký** - Theo dõi hạn mức, tận dụng triệt để trước khi reset
- ✅ **Đa tài khoản** - Vòng tròn (round-robin) các tài khoản của mỗi nhà cung cấp - ✅ **Tự động dự phòng (Auto Fallback)** - Gói đăng ký → Giá rẻ → Miễn phí, không lo downtime
- ✅ **Phổ quát** - Hoạt động với Claude Code, Codex, Gemini CLI, Cursor, Cline, bất kỳ công cụ CLI nào - ✅ **Đa tài khoản (Multi-account)** - Xoay vòng (round-robin) các tài khoản cho mỗi nhà cung cấp
- ✅ **Phổ quát (Universal)** - Hoạt động với Claude Code, Codex, Cursor, Cline, Antigravity và mọi công cụ CLI
--- ---
@ -44,25 +40,26 @@ Dưới đây là bản dịch tiếng Việt của tài liệu Markdown, giữ
``` ```
┌─────────────┐ ┌─────────────┐
│ Your CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) │ Công cụ │ (Claude Code, Codex, OpenClaw, Cursor, Cline, Antigravity...)
│ Tool │ │ CLI AI │
└──────┬──────┘ └──────┬──────┘
│ http://localhost:20128/v1 │ http://localhost:20128/v1
↓ ↓
┌────────────────────────────────────────┐ ┌─────────────────────────────────────────────┐
│ 9Router (Smart Router) │ │ 9Router (Smart Router) │
│ • Format translation (OpenAI ↔ Claude) │ │ • RTK Token Saver (nén tool_result token) │
│ • Quota tracking │ │ • Dịch chuyển định dạng (OpenAI ↔ Claude) │
│ • Auto token refresh │ │ • Quota tracking (theo dõi hạn mức) │
└──────┬──────────────────────────────────┘ │ • Tự động làm mới OAuth Token │
└──────┬──────────────────────────────────────┘
│ │
├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI ├─→ [Tier 1: GÓI ĐĂNG KÝ] Claude Code, Codex, GitHub Copilot
│ ↓ quota exhausted │ ↓ hết hạn mức quota
├─→ [Tier 2: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) ├─→ [Tier 2: GIÁ RẺ] GLM ($0.6/1M), MiniMax ($0.2/1M)
│ budget limit │ ↓ chạm ngân sách
└─→ [Tier 3: FREE] iFlow, Qwen, Kiro (unlimited) └─→ [Tier 3: MIỄN PHÍ] Kiro AI, OpenCode Free, Vertex AI ($300 credits)
Result: Never stop coding, minimal cost Kết quả: Không bao giờ ngừng code, chi phí tối thiểu + tiết kiệm 20-40% token qua RTK
``` ```
--- ---
@ -76,26 +73,26 @@ npm install -g 9router
9router 9router
``` ```
🎉 Bảng điều khiển mở tại `http://localhost:20128` 🎉 Bảng điều khiển (Dashboard) sẽ tự động mở tại `http://localhost:20128`
**2. Kết nối nhà cung cấp MIỄN PHÍ (không cần đăng ký):** **2. Kết nối nhà cung cấp MIỄN PHÍ (không cần đăng ký):**
Bảng điều khiển → Providers -> Kết nối **ude Code** hoặc **Antigravity** -> Đăng nhập OAuth -> Xong! Bảng điều khiển → Providers → Kết nối **Kiro AI** (~50 credits/tháng miễn phí: Claude 4.5 + GLM-5 + MiniMax) hoặc **OpenCode Free** (không cần auth) → Xong!
**3. Sử dụng trong công cụ CLI của bạn:** **3. Sử dụng trong công cụ CLI của bạn:**
``` ```
Cài đặt Claude Code/Codex/Gemini CLI/OpenClaw/Cursor/Cline: Cài đặt Claude Code/Codex/OpenClaw/Cursor/Cline/Antigravity:
Endpoint: http://localhost:20128/v1 Endpoint: http://localhost:20128/v1
API Key: [sao chép từ bảng điều khiển] API Key: [sao chép từ bảng điều khiển]
Model: if/kimi-k2-thinking Model: kr/claude-sonnet-4.5
``` ```
**Xong rồi!** Bắt đầu code với các mô hình AI MIỄN PHÍ. **Thế là xong!** Bắt đầu code ngay với các mô hình AI MIỄN PHÍ.
**Phương án khác: chạy từ nguồn (k lưu trữ này):** **Phương án khác: chạy từ mã nguồn (repository này):**
Gói kho lưu trữ này là riêng tư (`9router-app`), vì vậy việc thực thi nguồn/Docker là đường dẫn phát triển cục bộ dự kiến. Gói kho lưu trữ này là riêng tư (`9router-app`), vì vậy việc chạy từ nguồn/Docker là cách phát triển cục bộ mặc định.
```bash ```bash
cp .env.example .env cp .env.example .env
@ -111,11 +108,12 @@ PORT=20128 HOSTNAME=0.0.0.0 NEXT_PUBLIC_BASE_URL=http://localhost:20128 npm run
``` ```
URL mặc định: URL mặc định:
- Bảng điều khiển: `http://localhost:20128/dashboard` - Bảng điều khiển Dashboard: `http://localhost:20128/dashboard`
- API tương thích OpenAI: `http://localhost:20128/v1` - API tương thích OpenAI: `http://localhost:20128/v1`
--- ---
## 🎥 Hướng dẫn Video ## 🎥 Hướng dẫn Video
<div align="center"> <div align="center">

29
i18n/README.zh-CN.md
View file

@ -42,25 +42,26 @@
``` ```
┌─────────────┐ ┌─────────────┐
│ Your CLI │ (Claude Code, Codex, Gemini CLI, OpenClaw, Cursor, Cline...) │ Your CLI │ (Claude Code, Codex, OpenClaw, Cursor, Cline, Antigravity...)
│ Tool │ │ Tool │
└──────┬──────┘ └──────┬──────┘
│ http://localhost:201281 │ http://localhost:20128/v1
↓ ↓
┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────────┐
│ 9Router (Smart Router) │ │ 9Router (Smart Router) │
│ • Format translation (OpenAI ↔ Claude) │ │ • RTK Token Saver (节省 20-40% Token) │
│ • Quota tracking │ │ • 格式转换 (OpenAI ↔ Claude) │
│ • Auto token refresh │ │ • 配额追踪 (Quota tracking) │
└──────┬──────────────────────────────────┘ │ • 自动刷新 OAuth Token │
└──────┬──────────────────────────────────────┘
│ │
├─→ [Tier 1: SUBSCRIPTION] Claude Code, Codex, Gemini CLI ├─→ [Tier 1: 订阅] Claude Code, Codex, GitHub Copilot
│ ↓ quota exhausted │ ↓ 配额用尽
├─→ [Tier 2: CHEAP] GLM ($0.6/1M), MiniMax ($0.2/1M) ├─→ [Tier 2: 低价] GLM ($0.6/1M), MiniMax ($0.2/1M)
│ ↓ budget limit │ ↓ 触及预算上限
└─→ [Tier 3: FREE] iFlow, Qwen, Kiro (unlimited) └─→ [Tier 3: 免费] Kiro AI, OpenCode Free, Vertex AI ($300 credits)
Result: Never stop coding, minimal cost 结果：永不停歇的编程体验，最低成本 + 通过 RTK 节省 20-40% Token
``` ```
--- ---

17
tests/README.md
View file

@ -4,25 +4,26 @@ Unit tests for the `/v1/embeddings` endpoint implementation.
## Setup ## Setup
Vitest must be installed globally or in `/tmp/node_modules` (due to npm workspace hoisting from the root Next.js project): Install test dependencies from the `tests/` directory:
```bash ```bash
cd /tmp && npm install vitest cd tests/ && npm install
``` ```
## Running Tests ## Running Tests
```bash From the `tests/` directory:
cd tests/
NODE_PATH=/tmp/node_modules /tmp/node_modules/.bin/vitest run --reporter=verbose --config ./vitest.config.js
```
Or using the package script (from the `tests/` directory):
```bash ```bash
npm test npm test
``` ```
Or run vitest directly with npx:
```bash
npx vitest run --reporter=verbose --config ./vitest.config.js
```
## Test Files ## Test Files
| File | What it tests | | File | What it tests |

4
tests/package.json
View file

@ -5,8 +5,8 @@
"type": "module", "type": "module",
"description": "Unit tests for 9router embeddings endpoint", "description": "Unit tests for 9router embeddings endpoint",
"scripts": { "scripts": {
"test": "NODE_PATH=/tmp/node_modules /tmp/node_modules/.bin/vitest run --reporter=verbose", "test": "vitest run --reporter=verbose",
"test:watch": "NODE_PATH=/tmp/node_modules /tmp/node_modules/.bin/vitest --reporter=verbose" "test:watch": "vitest --reporter=verbose"
}, },
"devDependencies": { "devDependencies": {
"vitest": "^4.0.0" "vitest": "^4.0.0"