Mosaic CLI 文档 EN

Sessions

Session 生命周期:创建、复用与清理

session 用于保持上下文连续性和可回放性,适合脚本化与日常运维。

步骤 1:通过 ask/chat 创建会话

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

在 chat 中用 /exit 退出,确保会话落盘。

步骤 2:列出会话

mosaic --project-state --profile default session list

步骤 3:查看单个会话详情

mosaic --project-state --profile default session show <session_id>

步骤 4:恢复历史会话

mosaic --project-state --profile default session resume <session_id>

# 显式绑定 session 继续 ask/chat
mosaic --project-state --profile default ask --session <session_id> "continue from previous context"
mosaic --project-state --profile default chat --session <session_id>

步骤 5:并行管理多个会话

mosaic --project-state --profile default ask --session <session_a> "summary A"
mosaic --project-state --profile default ask --session <session_b> "summary B"
mosaic --project-state --profile default session list

步骤 6:清理废弃会话

mosaic --project-state --profile default session clear <session_id>
# 全量清理
mosaic --project-state --profile default session clear --all

步骤 7:JSON 模式用于 CI/Audit

mosaic --project-state --profile default --json session list
mosaic --project-state --profile default --json session show <session_id>

步骤 8:排障建议

  • 如果提示配置错误,先对该 profile 执行 setup
  • 若 resume 上下文不一致,确认 --profile--project-state 未切换。
  • 诊断建议:logs --tail 120 + doctor