快速上手

常用子命令

命令	作用
magic-stack init [path]	注册项目，生成 .magic-stack/ 配置
magic-stack up [project] [stack...]	启动 stack
magic-stack down [project] [stack...]	停止 stack
magic-stack restart <project> <stack> [--rebuild]	重启单个 stack
magic-stack status [project]	查看状态总览
magic-stack logs <project> <stack> [service] [--follow] [--tail=N]	跟服务运行日志
magic-stack hot <project> <stack>	查热更新规则（改什么需要 restart）
magic-stack adopt --all	收编现有 infra 容器
magic-stack sync [project]	引擎升级后重渲染项目引擎产物

读日志是只读操作，不受「禁裸 docker」约束。容器名规则：<项目slug小写>-<stack>[-<service>]。

典型流程

# 1. 注册项目
magic-stack init /path/to/myproject

# 2. 启动
magic-stack up myproject backend

# 3. 跟日志
magic-stack logs myproject backend --follow --tail=100

# 4. 停止
magic-stack down myproject backend

查看日志（排错）

# magic-stack 跟日志
magic-stack logs <project> <stack> [service] --follow --tail=200

# 直接过滤容器报错（DEBUG 刷屏时）
docker logs --since 30m <容器名> 2>&1 | grep -iE "ERROR|Exception|Caused by" | tail -40