上手
选择你的使用路径
文档现在分成入门、深度学习、生产运维三条路线：先跑通 10 分钟上手，再进入分阶段学习与模块专项，最后落到生产运维。
10 分钟上手
最短路径跑通 install/setup/models/ask/chat。
分阶段学习
从最简单到复杂的完整阶段化教程。
进入分阶段学习Models 与 Profiles
多 provider、多模型 alias/fallback、profile 安全变更。
进入 Models 与 ProfilesSessions 生命周期
会话创建、查看、恢复、清理与脚本化复用。
进入 Sessions 教程TUI 教程
chat-first 全屏终端界面，含会话栏、消息流和实时 inspector。
进入 TUI 教程策略基线
approvals + sandbox 策略配置与命令级判定。
进入策略教程Azure 运维剧本
一条完整可执行路径：Azure profile、channels、gateway、策略与回归门禁。
进入 Azure 运维剧本Agents 专项
agents 与路由控制的完整分步教程。
Channels 模块
Terminal/Slack/Telegram 通道运维与可靠投递验证。
进入 Channels 教程Gateway Call API
gateway call 的契约与自动化调用细节。
生产运维
面向日常稳定运行：channels、gateway、策略、诊断、回归门禁。
进入生产运维回归测试教程
从基础检查到发版门禁的脚本化回归路径。
进入回归测试教程路径 A：10 分钟上手
适用于首次使用，或在新机器上快速验证环境。
- 安装并验证
mosaic --help。 - 用一个 profile 跑通
setup。 - 通过
models list和health验证连通性。 - 执行
ask和chat。
路径 B：生产运维
适用于团队/长期运行场景，强调可观测、可诊断、可恢复。
- 配置并验证消息通道。
- 运行网关并持续探测健康状态。
- 启用 approvals + sandbox 策略。
- 使用
status/health/doctor/logs/dashboard做日常巡检。
路径 C：深度学习与模块专项
适用于需要系统化掌握能力细节的场景。
- 按 分阶段学习 从入门走到高级。
- 按 Models 与 Profiles 固化模型路由与配置基线。
- 按 Sessions 教程 建立可回放会话流程。
- 按 TUI 教程 使用 chat-first 终端界面并掌握快捷键流程。
- 按 策略教程 建立 approvals/sandbox 安全基线。
- 按 Azure 运维剧本 一次性跑通生产基线。
- 按 Agents 专项 完整掌握 agent 与路由。
- 按模块教程补齐 Channels、Memory、Knowledge、Plugins、Skills、Gateway、Gateway Call API。