at-tuner CLI 命令完整文档
mkdir -p ~/.npm-global npm config set prefix '~/.npm-global' echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc source ~/.zshrc npm install -g @datami/at-tuner

配置管理

at-tuner config set # 保存配置到 ~/.at-tuner/config.json
at-tuner config list # 查看所有配置（敏感值掩码）
at-tuner config init # 配置引导提示

支持的 key：

┌──────────────┬───────────────────────────┐
│ Key │ 说明 │
├──────────────┼───────────────────────────┤
│ server │ AskTable API 地址 │
├──────────────┼───────────────────────────┤
│ api-key │ 管理员 API Key │
├──────────────┼───────────────────────────┤ │ datasource │ 数据源 ID │ ├──────────────┼───────────────────────────┤ │ project │ 项目 ID（术语库用） │ ├──────────────┼───────────────────────────┤ │ llm-provider │ LLM 引擎: openai / claude │ ├──────────────┼───────────────────────────┤ │ llm-api-key │ LLM API Key │ ├──────────────┼───────────────────────────┤ │ llm-model │ LLM 模型名 │ ├──────────────┼───────────────────────────┤ │ llm-base-url │ LLM API 自定义地址 │ └──────────────┴───────────────────────────┘

优先级：CLI flag > 工作区配置 > 全局配置

5 步调优流水线

┌────────┬──────────────────────────────┬────────────────┬─────────────────┐ │ 命令 │ 功能 │ 输入 │ 输出 │ ├────────┼──────────────────────────────┼────────────────┼─────────────────┤ │ at-tun │ │ │ .at-tuner/resul │ │ er │ 创建工作区目录 │ — │ ts/ │ │ init │ │ │ │ ├────────┼──────────────────────────────┼────────────────┼─────────────────┤ │ at-tun │ 获取数据源 schema 转 │ │ │ │ er exp │ Markdown │ --datasource │ schema.md │ │ lore │ │ │ │ ├────────┼──────────────────────────────┼────────────────┼─────────────────┤ │ at-tun │ │ │ │ │ er gen │ AI 生成 15 个测试问题 │ schema.md │ test-cases.md │ │ erate │ │ │ │ ├────────┼──────────────────────────────┼────────────────┼─────────────────┤ │ at-tun │ │ │ results/case-*. │ │ er exe │ 批量并发提问，收集 SQL 结果 │ test-cases.md │ json │ │ cute │ │ │ │ ├────────┼──────────────────────────────┼────────────────┼─────────────────┤ │ at-tun │ │ │ tuning-report.m │ │ er ana │ 分析失败+LLM 诊断根因 │ results/ │ d + .json │ │ lyze │ │ │ │ ├────────┼──────────────────────────────┼────────────────┼─────────────────┤ │ at-tun │ 执行调优（更新字段备注/术语/ │ tuning-report. │ │ │ er │ Skill） │ json │ API 调用 │ │ apply │ │ │ │ └────────┴──────────────────────────────┴────────────────┴─────────────────┘

一键流水线

at-tuner tune # 自动执行全部 5 步

参数速查

┌─────────────────┬───────────────────────────────┬────────────────┐ │ 参数 │ 说明 │ 默认值 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ -w, --workspace │ 工作区路径 │ .at-tuner │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --datasource │ 数据源 ID │ 从 config 加载 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --server │ API 地址 │ 从 config 加载 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --api-key │ API Key │ 从 config 加载 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --concurrency │ 并发数（execute 步骤） │ 3 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --timeout │ 单问超时（ms） │ 120000 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --scope │ 业务场景范围（generate 步骤） │ — │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --llm-provider │ LLM 引擎 │ 从 config 加载 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --llm-api-key │ LLM Key │ 从 config 加载 │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --llm-model │ LLM 模型 │ — │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --llm-base-url │ LLM 自定义地址 │ — │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --project │ 项目 ID（术语库） │ "" │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --dry-run │ 预览不执行 │ false │ ├─────────────────┼───────────────────────────────┼────────────────┤ │ --confirm │ 跳过确认 │ false │ └─────────────────┴───────────────────────────────┴────────────────┘