总览
Mosaic CLI 文档站
Mosaic 是 Rust 优先的本地 Agent 运行时与运维 CLI。本文档聚焦安装、配置、日常运行和故障定位。
范围说明：当前阶段为 CLI 核心能力，不包含 Web/Desktop 外壳交互。
当前命令范围
- 核心命令：
setup、configure、models、ask、chat、tui、session - 运维命令：
status、health、doctor、logs、system - 运行模块：
channels、gateway、approvals、sandbox、memory、knowledge、security
首批命令
mosaic --project-state setup \
--base-url https://api.openai.com \
--api-key-env OPENAI_API_KEY \
--model gpt-4o-mini
mosaic --project-state models list
mosaic --project-state ask "hello"
mosaic --project-state chat
mosaic --project-state tui阅读路径
10 分钟上手
最快路径跑通 ask/chat。
进入 10 分钟上手分阶段学习
从最简单到复杂的完整学习主线。
进入分阶段学习Agents 专项
agent 与路由控制的详细分步教程。
进入 Agents 教程生产运维
面向日常稳定运行的通道、网关、策略与诊断手册。
进入生产运维模块专项教程
- Azure 运维剧本：用 Azure profile 一次跑通生产基线。
- Models 与 Profiles：多 profile 配置与模型路由。
- Sessions 教程：会话创建、恢复、清理全流程。
- TUI 教程：全屏终端界面、快捷键与脚本化单次调用。
- 策略教程：approvals 与 sandbox 基线。
- Agents 教程：自定义 agent 与路由控制。
- Channels 教程：terminal/slack/telegram 通道管理。
- Memory 教程：索引/检索/清理全流程。
- Knowledge 教程：采集本地/HTTP/MCP 文档并基于检索问答。
- Plugins 教程：安装/检查/执行/启停。
- Skills 教程：安装/检查/详情/移除。
- Gateway 教程：生命周期与 call 接口。
- Gateway Call API：请求/响应契约与自动化模式。
- 回归测试教程：从零到发版门禁验证。