winBrain Creator Lab · App Factory × AgentBay

整合后「一 App = 一会话」构建流程

期望 UX · 变体 C · 整页 = 一条纵向 PCB 时间线 · 5 步旅程

结论：一 App = 一会话 —— POST /api/v1/apps 建壳即懒创建绑定云会话，构建即会话、产物自动回写、一键发布。下方整页是一条 5 步纵向构建旅程：点任一焊盘节点展开该步窄门详情、其余压成一行，紫色 pad 统一 API 收线。

Journey · 5 pads + 1 shared pad · 点焊盘节点展开当前展开 STEP 1

期望 UI 剪影 · 落页即进构建，无 App 列表中间跳转

名称 <120 字 类型 ai | dashboard 按钮 创建并进入构建

本步勾选清单
- POST /api/v1/apps 建 App 壳，id 自动 app-<time36>
- 懒创建绑定云会话，落页即进构建，无中间跳转
- 一 App = 一会话，创建即绑定 projectId
期望 UI 剪影 · 本步视觉最重：聊天 + 执行依据面板 + Skill 加载 + 状态流

发送 Enter / 停止 Esc 执行依据 展开 / 收起 流式 idle→running→streaming→completed Skill json-render-skills:core/react/codegen（限定名）

本步勾选清单
- 会话绑定 appId + projectId，一 App = 一会话
- 执行依据仅脱敏 trace，无思维链、不伪造进度
- Skill 只按限定名加载 json-render-skills:core/react/codegen
- prompt ≤20000 字，超长拒绝
期望 UI 剪影 · 目录树 + 文本预览，entryId 对宿主机路径透明

目录树 展开 / 收起 点文件 → 文本预览 上传 1–20 文件 · ≤4MiB

本步勾选清单
- 浏览用 opaque directoryId / entryId，不泄露宿主机路径
- 预览只读文本文件，执行中不可浏览
- 禁上传 .env / .pem / .key 与点文件
- 上传上限 20 文件 · 单文件 ≤4MiB
期望 UI 剪影 · 发端口让沙盒 App 真正跑起来

目录 /tmp | /home/wuying 端口 30100–30199 按钮 发布 / 打开 / 接管 / 停止

本步勾选清单
- 目录仅 /tmp 或 /home/wuying 下规范路径，禁 ..
- 端口限定 30100–30199
- 预览 URL 需浏览器 http/https 校验
- 空闲 10 分钟销毁沙盒，预览最长 60 分钟
期望 UI 剪影 · 构建完自动回写，一键 published，旅程收尾

回写 N 文件 · status=built 发布 status=published 端点 POST /api/v1/apps/{id}/publish

本步勾选清单
- 构建产物自动回写 /apps/{id}/workspace，files 真实入库
- 发布前校验非空，禁空壳发布
- 发布后走统一项目 API，不重复开放端点
- App 只绑定一个 Project，无改绑控件
期望剪影 · 5 步 trace 在此收进共享 pad：所有构建动作只走 AgentBay MCP 一条 API

构建链路 apps → cloud/responses(SSE) → workspace → publish 预览 / 文件 preview · files · session 工具边界 宿主内置工具禁用

安全边界勾选清单
- 宿主内置工具禁用，工具只走 AgentBay MCP
- 沙盒内完整工具 + bypassPermissions，沙盒外 fail closed
- 业务凭据仅经 Credential MCP 注入，不经 prompt

当前步骤已完成待执行统一 API · AgentBay MCP 点时间轴任一焊盘节点 → 该区块展开完整窄门详情，其余压成一行；再点一次收起。

来源：winBrain Creator Lab · 生成 2026-08-12 · 单文件自包含，无 CDN / 无外链，离线可开。
项目绝对路径：/Users/liushiyuwin/projects/winbrain_os-ink-agent-sdk-clean · 设计依据：frontend/src/presentation/workbench.css（Enterprise V4 light tokens）· frontend/home.html（PCB Scroll World 母题，95 处 trace/pad）· src/application/workbench.ts（createApp / publishApp）· src/application/cloud-agent-workbench.ts · src/adapters/inbound/http/expert-api-server.ts + openapi-v1.ts（/api/v1/apps · cloud/responses · preview · files · session）· 变体 C：整页 = 纵向 PCB 时间线，5 步旅程，末节点紫 shared pad 收线。