cloud: worker dispatch, DB abstraction, packaging 0.1.0, repo CI workflow

README.md

@@ -198,6 +198,43 @@ turn 可以真正并发（不是轮流排队）。
   或 crontab；daemon 适合常驻机器，VM 上是“会话内常驻 +
   回收后重拉”的定位。
 
+## 宿主快速开始（最小闭环）
+
+下面全部是 `host.py --help` 核对过的真实子命令和参数，
+不要凭印象编命令。先装检查，再走闭环；**不要在示例里
+直接派发真实模型任务来“试一下”**——dispatch 一步就会跑模型。
+
+```bash
+cd ~/workspace/codex-app-server
+./install.sh                    # 只检查 python3、git、codex，不写密钥、不跑模型
+python3 host.py health          # 不跑模型：查二进制、配置、state、server、daemon
+python3 host.py init --repo /path/to/your/repo
+# 上一步写 host-config.json（CLI > 配置 > 默认；key 绝不进配置文件，只走环境变量）
+python3 host.py dispatch --name example-task --task "你要做的事" --repo /path/to/your/repo
+# ^ 这一步跑模型：需要模型 key 已走环境变量提供，且会建 git worktree host/example-task
+python3 host.py review --task example-task   # 看 status + diff + untracked + open 评审评论
+python3 host.py merge --task example-task    # 默认仓库有 tests/ 就跑 unittest，验测失败自动回滚
+# 合并不了就别硬合：python3 host.py discard --task example-task  # 删 worktree 和分支
+python3 host.py daemon --interval 300        # 双 fork 常驻：每轮 recover + run-due
+python3 host.py daemon-status
+python3 host.py daemon-stop
+```
+
+三条边界，闭环前先知道：
+
+- `health` 不跑模型、不花额度，随时可跑；`daemon-status` /
+  `daemon-stop` 同样不跑模型。
+- `daemon` 在这台 VM 上活不过平台回收（和微信桥 serve 同理）：
+  回收后要重拉；VM 上更稳的定时是 Muse cron 调 `health` /
+  `run-due`，而不是只靠 daemon 或 crontab。
+- `run-due` 到期会跑模型、会花额度：先用
+  `python3 host.py automations --add --name <名> --task "<任务>" --repo <仓> --interval 86400`
+  登记自动化，再确认模型 key 已走环境变量提供，才让定时去调
+  `python3 host.py run-due`；未到期的自动化 run-due 时不重复派发。
+- 云端控制面演示另起一端（不跑模型回合）：
+  `python3 -m cloud.server`（默认 127.0.0.1:8765），
+  除 `GET /health`、`/webhooks/*`、`/oauth/*` 外都要 `X-API-Key` 请求头。
+
 ## GitHub PR/CI 的外部条件（真实 PR 仍缺这两样）
 
 PR/CI 这条线本轮只做了代码和本地可测部分，真实 PR 没有跑，