上手

10 分钟首次跑通

目标是用最少命令快速拿到首个可用结果：安装、配置、连通性验证、ask、chat。

1. 确认 CLI 可用

mosaic --version
mosaic --help
mosaic --project-state directory --ensure --check-writable

2. 初始化一个 profile

export OPENAI_API_KEY=<your_key>

mosaic --project-state --profile default setup \
  --base-url https://api.openai.com \
  --api-key-env OPENAI_API_KEY \
  --model gpt-4o-mini

3. 验证 provider/model 连通性

mosaic --project-state --profile default models list
mosaic --project-state --profile default health
mosaic --project-state --profile default status

4. 执行首个 ask/chat/tui

mosaic --project-state --profile default ask "hello"
mosaic --project-state --profile default chat
mosaic --project-state --profile default tui

REPL 内常用命令：/help、/status、/exit。

5. 查看会话记录

mosaic --project-state session list
mosaic --project-state session show <session_id>

6. 可选：配置 terminal 通道

mosaic --project-state channels add --name local-terminal --kind terminal
mosaic --project-state channels list
mosaic --project-state channels send <channel_id> --text "quickstart ok"

快速验收清单

• models list 无网络/配置错误。
• ask 能返回模型输出。
• chat 与 tui 都能正常进入和退出。
• session list 能看到会话记录。