安装 Downcity CLI
推荐安装 CLI，并初始化 Downcity 默认使用的 microsandbox microVM 运行时。
npm install -g downcity
npx microsandbox setup
downcity --version- • 每个 Workspace 拥有独立、持久的 Sandbox，项目固定挂载到 `/workspace`。
Quick Start
用一条最短路径，把第一个项目接入 Downcity。
先选择当前系统，完成 CLI 与本地沙箱准备，再从你已经在运行的仓库开始。
建议直接从一个真实仓库开始，不要先用玩具项目演练。先跑一个最小闭环，再接入审批、技能和更多渠道。如果团队多人协作，先确定目录边界，再讨论角色分工。
01 / Install
选择你的系统
Downcity CLI 与 microsandbox Provider 在各平台使用同一套 Sandbox 模型。首次使用 Shell 前只需初始化一次本机运行时。
需要 Apple Silicon Mac 与 Node.js 22 或更高版本。
下载 macOS Desktop（Apple Silicon）02
在仓库里创建 Agent
进入真实项目目录后初始化，让规则、权限和产物落在仓库本身，而不是外部平台。
cd /path/to/your-repo
downcity agent create .03
连接 City 并启动 Runtime
先登录 Federation，再启动唯一的 CLI City 宿主。City 会在启动时装配全部 Agent；Agent 本身没有独立启动命令。
city federation login
city on
# 调试时以前台模式运行
city on --foreground04
选择 Session 模型
City 或直接的 Agent Session 都可以开始对话。Session 模型选择只影响当前会话，不需要重启 City。
city agent chat <agent_id>
# 选择默认模型
city agent model <agent_id> --set <model-id>05
做一次健康检查
确认服务状态、再开始接技能、渠道和自动任务。先保证边界成立，再扩展自动化。
curl http://localhost:3000/health
curl http://localhost:3000/api/status