FastClaw / API 与集成
项目运行时
Project Runtime 是 FastClaw 的 coding agent 层：项目、运行实例、模板脚手架、dev server、预览、日志和 changed files。
两层模型
docs/coding-agent-runtime.md 把它拆成 Project 和 Project Runtime。Project 是源代码树和聊天分组；Project Runtime 是这个项目的一个运行实例、dev server 或 preview。
| 层 | 含义 |
|---|---|
| Project | 用户、Agent、项目 ID 下的源代码树和会话分组 |
| Project Runtime | 对应项目的运行实例，包含状态、预览 URL、日志、后端 sandbox |
| Workspace | host dir workspaces/<agent>/projects/<pid>/，运行容器和 per-turn sandbox 共享挂载 |
实时预览
运行时容器和每次 turn 的 sandbox bind mount 同一个 host dir，所以 Agent 改文件后，dev server 的 HMR 能立即反映。不需要额外同步文件。
- API: /api/agents/{id}/projects/{pid}/runtime
- 动作: GET、up、sleep、wake、DELETE、preview、logs
- 工具: start_app_preview、app_preview_logs
- 状态: none、scaffolding、starting、running、sleeping、crashed
模板
main.go 注册了 shipany-tanstack 和 vite-react 两个模板。模板声明 DevPort、ScaffoldCmd、DevCmd、TemplateMount、Image 等参数，可以在同一 sandbox image 上跑多个模板。
| 模板 | 端口 | 用途 |
|---|---|---|
| shipany-tanstack | 3000 | SaaS / TanStack Start 项目脚手架 |
| vite-react | 5173 | 轻量 Vite + React + TS 示例 |
| 自定义模板 | 可配置 | 通过 TemplateSpec 扩展 |