feat(cli): V1.22.0-alpha tagent config CLI — 多模型 onboarding Step 2

[Wool-xing]

摘要

新增 tagent config 子命令组, 解锁 LLM provider 一键切换. 实装 V1.21 后多 provider 通道的 onboarding 路径, README 命令名同步.

Step 2 收尾 (多模型 onboarding 3 步: Step 3 通用 env 通道 PR #79 ✅ · Step 1 README 卖点 PR #80 ✅ · Step 2 config CLI 本 PR).

变更

1. runtime/cli/config.py 新 (193 行)

4 子命令:

命令	行为
tagent config list	列内置 6 厂商 (路径 A) + 5 兼容样例 (路径 B)
tagent config show	显当前 .env (TAGENT_LLM_* + 厂商 key 全脱敏 4+4)
tagent config use <name>	路径 A: 写 TAGENT_LLM_PROVIDER + 厂商 key 占位
tagent config use-compat --base --key --model	路径 B: OpenAI 兼容兜底通道

helper (4):

• _find_env_file() — 当前 CWD/.env
• _parse_env(p) — 保留注释 / 引号 strip / 缺失返 {}
• _write_env(p, env) — 写前必备份 .env.bak (覆盖)
• _mask(s) — key 脱敏 4 头 4 尾

provider 模型名严格对齐 runtime/router/llm_client.py:PROVIDER_MODEL_MAP (claude / openai / gemini / qwen / deepseek / ollama).

2. runtime/cli/main.py (+2 行)

from runtime.cli.config import config_app
app.add_typer(config_app, name="config")

(main.py 9 个 pre-existing ruff issue 不在本 PR scope.)

3. runtime/tests/test_cli_config.py 新 (149 行 / 15 case)

helper 单元 7:

• _mask 短返 *** / 长返 4+4
• _parse_env 注释 / 引号 strip / 缺失返 {}
• _write_env 备份策略 (已存生 .bak / fresh 不生)
• _find_env_file CWD

CLI 集成 8 (CliRunner + tmp_path + monkeypatch.chdir):

• list 含 6 内置 + 兼容样例 + cookbook link
• show 脱敏 / 缺文件 hint
• use 写 provider + 占位 + 清 B 路径残值
• use 未知 provider exit 2
• use ollama 显本地启动提示
• use-compat 写 3 env + key 不泄

4. README.md + README.zh-CN.md (#69 5 Key #3)

tagent model → tagent config use <name> + tagent config use-compat

(原 tagent model 仅 README 提及, 从未实装. 此 PR 让 README 与 CLI 对齐, 不再说不实之话.)

测试

• pytest runtime/tests/test_cli_config.py -v: 15/15 PASSED (0.21s)
• pytest runtime/tests/ 全 regression: 83 passed, 2 skipped (0 fail)
• ruff check runtime/cli/config.py runtime/tests/test_cli_config.py: clean
• tagent --help 实测显 config 子组
• tagent config --help 实测显 4 子命令
• pre-commit 全过 (markdownlint / detect-secrets / 数量校验 / 私有路径防护)
• CI 13 必修绿

关联

• 续 PR feat(llm): 多 provider 通用 env 通道 + stub 扩 4 path + 厂商配置 cookbook #79 (多 provider 通用 env 通道) — Step 3 工程实装
• 续 PR docs(readme): 多 provider 卖点上 README + ZH 数字校准 + cookbook hero block #80 (README 卖点 + cookbook hero) — Step 1 营销
• 本 PR = Step 2 onboarding — 用户能 tagent config use claude 直接生 .env

后续 (followup, 不在 scope)

• tagent config unset 子命令清 LLM 段
• tagent config use 之后自动跑 tagent doctor --llm-smoke 验路由
• ROADMAP.md 表格 "7 production" 校 8 (PR docs(readme): 多 provider 卖点上 README + ZH 数字校准 + cookbook hero block #80 followup)