docs(tier2): 部署档补 B1 控制面真驱配方 + 凭据/chat 体口径 + setsid 起服务铁律

团队共享(创始人「记录部署位置/端点」铁律):
- B1 control_plane 跑一款到门绿落库的 detached 命令 + game_id=session_id 评门口径;
- 凭据注册体 {data:{...}} / chat input.content 须内容块列表(smoke 实证定稿);
- 起常驻服务必 setsid 脱离 ssh 会话(nohup 会挂通道致启动被 timeout 打断)。

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

docs/内网凭据与端点.md

@@ -65,10 +65,25 @@
 - 源文件全文 → MinIO 桶 `tier2-src` · key `tier2-src/<game_id>/<version_id>/<工程内相对路径>`。
 - 已验:save→fetch 往返、main.js 内容字节一致(2026-06-24)。
 
+**B1 控制面有界 resume(`service/control_plane.py`)—— 真驱服务跑一款到门绿落库**
+- 它是服务消费方:驱动上面的 :8200 服务,每回合等 SSE 末态(REPLY_END)→ 独立跑 run_gates 机器判门 → 门绿落库 / 否则带 verdict 反馈续修,直到门绿/预算耗尽。等价 CLI `run_studio` 的外层有界 resume,补服务态此前缺的那道循环。
+- 跑一款(detached,日志落 `cp-smoke.log`):
+  ```bash
+  ssh mini-desktop
+  cd /root/tier2-run/tier2/gen-worker
+  NEWAPI_KEY=<见 new-api 段> NO_PROXY=100.64.0.8 \
+    setsid /root/.venvs/agentscope-tier2/bin/python -m service.control_plane <game_id> \
+      --base-url http://127.0.0.1:8200 --brief "<一句话富游戏题面>" --max-resumes 3 \
+      >/root/tier2-run/cp-smoke.log 2>&1 </dev/null &
+  ```
+- 评门 `game_id` = 框架分配的 `session_id`(九工具按它管工程目录 `game-runtime/games/_tier2-gen/<session_id>`);控制面不靠内存 session 判收敛,靠每回合独立 run_gates。
+- 凭据体口径(2026-06-24 smoke 实证定稿):POST `/credential/` 要 `{data:{type:"anthropic_credential",api_key,base_url}}`(凭据载荷嵌 `data`、无 `model`);POST `/chat/` 的 `input.content` 必须是内容块列表 `[{type:"text",text:...}]`、不能是裸字符串。模型名在 session `chat_model_config.model`。
+
 **运行环境(mini-desktop · 权威运行机)**
 - venv:`/root/.venvs/agentscope-tier2`(`agentscope[full]==2.0.2` + `redis`/`pymysql`/`minio`/`httpx`/`esbuild`/`ws`/`phaser`)。
-- 部署 worktree:`/root/tier2-run`(detached @ dev/2.0.0)。
+- 部署 worktree:`/root/tier2-run`(detached @ dev/2.0.0;同步新代码 = `git fetch origin dev/2.0.0 && git checkout origin/dev/2.0.0`)。
 - 装依赖:`/root/.venvs/agentscope-tier2/bin/pip install -r tier2/gen-worker/requirements.txt`(含 pymysql/minio)`+ redis httpx`。
+- **起服务铁律(踩坑)**:经 ssh 起常驻服务,**必须 `setsid … >log 2>&1 </dev/null &` 完全脱离会话**——`nohup … &` 会让 ssh 通道挂住、`timeout ssh` 到点把启动一并打断(实测 service.log 空、:8200 不起)。起完用单独一条只读 ssh 轮询 `/openapi.json`=200 确认就绪。
 - 纪律:真玩门(run_gates / chrome / esbuild)只在 mini-desktop;6c6g 禁 chrome、只做静态校验。
 
 > 历史 demo 服务:feie-005 富游戏静态服务在 `mini-desktop:4180`(`python -m http.server 4180 --directory /root/tier2-run`),供创始人亲玩;非生产、可随时关。