## Commands

| Command | What it does |
|---------|-------------|
| `list models` | Show all available Chinese LLMs with status |
| `use <model>` | Switch to a specific model |
| `compare <models>` | Compare capabilities & pricing |
| `recommend <task>` | Get model recommendation for a task type |
| `test <model>` | Send a test prompt to verify connectivity |
| `status` | Check which models are currently accessible |

## Model Selection Guide

| Task | Recommended Model | Why |
|------|------------------|-----|
| General chat | Qwen3-Max | Best all-rounder, strong Chinese |
| Coding | GLM-5 / Kimi K2.5 | Top coding benchmarks |
| Math & reasoning | DeepSeek R1 | Purpose-built for reasoning |
| Long documents | Kimi K2.5 (128K) / DeepSeek V3.2 (1M) | Massive context windows |
| Fast & cheap | Step 3.5 Flash / Doubao Seed 2.0 Mini | Sub-second latency |
| Creative writing | Qwen3-Max / Doubao Seed 2.0 Pro | Rich Chinese expression |
| Agent tasks | GLM-5 / Qwen3-Max | Best tool-use support |

## Configuration

The skill reads API keys from environment or from `~/.chinese-llm-router/config.json`:

## Setup

1. Get API keys from the providers you want (most offer free tiers):
   - DeepSeek: https://platform.deepseek.com
   - Qwen (Alibaba): https://dashscope.console.aliyun.com
   - GLM (Zhipu): https://open.bigmodel.cn
   - Kimi (Moonshot): https://platform.moonshot.cn
   - Doubao (ByteDance): https://console.volcengine.com/ark
   - MiniMax: https://platform.minimaxi.com
   - Step (StepFun): https://platform.stepfun.com
   - Baichuan: https://platform.baichuan-ai.com
   - Spark (iFlytek): https://console.xfyun.cn
   - Hunyuan (Tencent): https://cloud.tencent.com/product/hunyuan

2. Run the setup script:

{
  "providers": {
    "deepseek": {
      "apiKey": "sk-xxx",
      "baseUrl": "https://api.deepseek.com/v1",
      "models": ["deepseek-chat", "deepseek-reasoner"]
    },
    "qwen": {
      "apiKey": "sk-xxx",
      "baseUrl": "https://dashscope.aliyuncs.com/compatible-mode/v1",
      "models": ["qwen3-max", "qwen3-max-thinking", "qwen3-coder-plus"]
    },
    "glm": {
      "apiKey": "xxx.xxx",
      "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
      "models": ["glm-5", "glm-4-plus"]
    },
    "kimi": {
      "apiKey": "sk-xxx",
      "baseUrl": "https://api.moonshot.cn/v1",
      "models": ["kimi-k2.5", "kimi-k2.5-thinking"]
    },
    "doubao": {
      "apiKey": "xxx",
      "baseUrl": "https://ark.cn-beijing.volces.com/api/v3",
      "models": ["doubao-seed-2.0-pro", "doubao-seed-2.0-lite", "doubao-seed-2.0-mini"]
    },
    "minimax": {
      "apiKey": "xxx",
      "baseUrl": "https://api.minimax.chat/v1",
      "models": ["minimax-m2.5"]
    },
    "step": {
      "apiKey": "xxx",
      "baseUrl": "https://api.stepfun.com/v1",
      "models": ["step-3.5-flash"]
    },
    "baichuan": {
      "apiKey": "xxx",
      "baseUrl": "https://api.baichuan-ai.com/v1",
      "models": ["baichuan4-turbo"]
    },
    "spark": {
      "apiKey": "xxx",
      "baseUrl": "https://spark-api-open.xf-yun.com/v1",
      "models": ["spark-v4.0-ultra"]
    },
    "hunyuan": {
      "apiKey": "xxx",
      "baseUrl": "https://api.hunyuan.cloud.tencent.com/v1",
      "models": ["hunyuan-turbo-s"]
    }
  },
  "default": "qwen3-max",
  "fallback": ["deepseek-chat", "doubao-seed-2.0-pro"]
}