# 1. 克隆项目
git clone https://github.com/chx17864762631/modelmix.git
cd modelmix

# 2. 安装依赖
npm install

# 3. 配置加密密钥
cp .env.example .env.local
# 编辑 .env.local，填入你的 MASTER_ENCRYPTION_KEY
# 生成密钥: node -e "console.log(require('crypto').randomBytes(32).toString('hex'))"

# 4. 启动开发服务器
npm run dev
# 打开 http://localhost:3000

# 5. 在 Web 界面添加 API Key（设置 → API Keys）

# 列出所有可用模型
npx tsx cli.ts models --json

# 对比模型（JSON 输出，适合 Agent）
npx tsx cli.ts compare \
  --task "将以下合同条款翻译成英文：甲方应于每月5日前支付上月服务费用..." \
  --models "deepseek-chat,glm-4" \
  --judge --json

# 人工阅读（Markdown 输出）
npx tsx cli.ts compare -t "Write a Python function to merge two sorted lists" -m "gpt-4o,claude-sonnet-4-20250514" -j

# 评判已有对比
npx tsx cli.ts judge <comparison-id> --json

cp -r skills/modelmix ~/.claude/skills/modelmix

modelmix/
├── app/                    # Next.js App Router
│   ├── page.tsx            # 首页：任务输入 + 推荐 + 对比
│   ├── leaderboard/        # 排行榜页面
│   ├── keys/               # API Key 管理页面
│   ├── templates/          # 模板管理页面
│   └── api/                # API 路由
│       ├── compare/        # 模型对比（SSE 流式）
│       ├── comparisons/    # 对比历史 CRUD
│       ├── judge/          # AI 评判
│       ├── recommend/      # 模型智能推荐
│       ├── tips/           # 省 Token 技巧
│       ├── savings/        # 节省计算
│       ├── leaderboard/    # 排行榜数据
│       └── user/           # 用户统计
├── components/             # React 组件
│   ├── home/               # 首页组件（输入面板、技巧面板）
│   ├── compare/            # 对比视图组件
│   ├── leaderboard/        # 排行榜组件
│   ├── keys/               # API Key 管理组件
│   └── layout/             # 布局组件（Header）
├── lib/                    # 核心库
│   ├── models.ts           # 模型定义
│   ├── provider-config.ts  # 提供商配置 + 智能推荐逻辑
│   ├── providers.ts        # 流式调用适配器
│   ├── db.ts               # SQLite 数据库（sql.js）
│   ├── judge.ts            # AI 评判引擎
│   ├── tips.ts             # 26 条优化技巧
│   ├── savings.ts          # 节省计算
│   ├── crypto.ts           # AES-256-GCM 加密
│   └── types.ts            # TypeScript 类型定义
├── hooks/                  # React Hooks
├── cli.ts                  # 命令行工具
├── mcp-server.ts           # MCP stdio 服务器
├── .mcp.json               # Claude Code MCP 配置
├── skills/modelmix/        # Claude Code 技能文件
├── public/screenshots/     # 界面截图
└── data/                   # SQLite 数据库文件（运行时生成）