Imports the previously untracked working tree as-is so that the review changes that follow (requirements -> design -> implementation) can be reviewed as diffs and reverted if needed. No content changes. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
7.3 KiB
WishForge 管理台设计与实现
本实现使用 Next.js App Router、React、SWR 与 Lucide。以真实控制面数据驱动所有列表、状态、预算与操作反馈,不内置演示指标或模拟成功流程。
视觉基线
完整主屏概念:apps/web/design/console-concept.png。概念使用内置 ImageGen 生成,描述为“深色导航、冷浅色内容、零数据工作概览、运行列表、交付路径与项目准备入口”。图片仅作为设计参考,不作为可交互产品界面。
主要设计约束:
- 导航背景
#102031,页面背景#f8fafc,内容白色,主操作#168574,细边框#e1e7ef。 - 桌面左侧导航 248 px,顶部导航 58 px;主屏运行列表与交付路径采用约 1.68:1 的两栏结构。
- 标题、表格、表单、时间线与空态为代码原生组件;没有远程字体、装饰图表或虚构数值。
- 760 px 以下使用抽屉导航;运行列表切换为保留表格语义的纵向字段布局,其他宽表仅在自己的容器内滚动;操作和配置表单保持可用。
- 所有按钮与表单有可见焦点、标签和错误反馈,尊重 reduced-motion 偏好。
相对概念的必要变化:连接真实控制面后,横杠替换为实际计数;连接提示根据请求结果显示状态;运行表格随真实记录变化。新增设置、环境、凭据、证据与审批页面沿用相同组件系统。
页面与操作
| 页面 | 实际接口与行为 |
|---|---|
| 工作概览 | GET /v1/dashboard;真实计数、最近运行、项目与执行器入口 |
| 项目空间 | 项目列表、POST /projects、项目详情与设置、工作空间创建与 IDE 入口 |
| 项目设置 | PATCH /projects/:id;验证命令、容器构建配置、发布环境与业务冒烟检查 |
| 运行 | 提交愿望(幂等键)、条件筛选、阶段进度、JSON 事件及 SSE 更新、暂停/继续/取消/补充信息 |
| 证据 | 验证/构建/部署证据、退出码、源代码摘要、检查点 patch;不展示检查点的内部运行路径 |
| 部署与审批 | 展示 sourceCommit/imageDigest/bindingDigest;明确确认后按绑定摘要批准或拒绝 |
| 目标环境 | 平台托管 Kubernetes、自带 Kubernetes、Docker Compose;登记环境与注册 Runner |
| 执行器 | 明确区分 Codex、CodeBuddy、WorkBuddy Cloud;真实能力与连接状态、保存/撤销 BYOK 凭据 |
| 演进实验 | 提交不可变候选、读取可信评估、调用审批/影子/灰度/推进/回滚接口;不生成评估报告 |
| 用量 | 真实 Token、预留额度、计算时间、存储、并发;BYOK 费用由外部服务商结算 |
Runner 注册前明确说明会撤销环境旧令牌。新令牌只保存在当前 React 会话,不写浏览器存储或日志;用户可以复制配置模板、下载验签公钥,保存确认后关闭。模板要求 HTTPS/mTLS 与管理员签发证书,默认禁用实际部署,须显式启用。
身份与代理
/api/*是服务端代理到控制面/v1/*,不会配置绕过身份检查的公开 rewrite。- 开发模式仅服务端读取
WF_DEV_AUTH_TOKEN;生产模式不接受开发令牌。 - OIDC 使用 discovery、授权码、PKCE S256、state、nonce 和 ID token 签名/issuer/audience 校验。
- Access token 存入加密 HttpOnly cookie,浏览器 JavaScript 无法读取;cookie 到期或 access token 到期后重新登录。
- 变更请求校验来源,代理不接受上游重定向;UI 不替代 API 的角色和项目成员检查。
/ide/:id/launch在服务端调用网关/launch,只把 30 秒一次性兑换 URL 返回浏览器,不把 access token 放进 URL。
环境变量:WF_API_URL、WF_DEV_AUTH_TOKEN(仅开发)、OIDC_ISSUER、OIDC_CLIENT_ID、可选 OIDC_CLIENT_SECRET、WF_SESSION_SECRET(至少 32 字符)、WF_PUBLIC_URL、WF_IDE_GATEWAY_URL、WF_IDE_PUBLIC_URL。
验证证据与边界
- 已通过 TypeScript 检查与 Next.js 生产构建。
- 5 个身份边界测试覆盖加密/篡改、生产禁止开发令牌、过期会话、重定向攻击、ID token 签名与 nonce。
- 内置浏览器调用返回
Browser is not available: iab,使用 Playwright 驱动已安装 Chrome 无头验证。 - 实际本地 PostgreSQL 控制面验证过:创建项目 → 请求 IDE 环境并显示 unconfigured → 提交愿望 → 读取阶段事件 → 证据空态 → 取消运行 → 登记 Compose 环境。
- 8 个主页面未出现应用控制台、页面异常或失败 HTTP 请求;11 个页面在 390 px 宽度下无页面级横向溢出,移动导航可操作。
- 视觉复核使用原生 1536×1024 概念及桌面/移动端截图,检查了导航、标题、配色、运行表格、时间线、空态和底部准备入口;修复了辅助表头造成的窄屏溢出。
这些结果证明本地 UI、代理与控制面交互可用。真实外部模型、企业 OIDC/HTTPS、生产发布需要相应环境配置并执行独立验收;真实本地 Keycloak、Theia 会话和多人编辑的最新结果见下文和需求追踪表,界面不会把未配置状态描述为成功。
2026-10-17 复验
已安装 Chrome + Playwright 使用全新的 desktop/mobile context,桌面 1536 px、 手机 390 px 的 8 个主路由通过;首页另测 320/375/768 px。无页面级横向溢出、 框架错误层或控制台错误。手机运行表的可视/内容宽度均为 352 px,搜索过滤、 清空搜索、打开详情、移动导航开合和跳转通过。最后一步交付路径的 flex 对齐已修复。 这不是 Safari 或真实手机验收。
本机系统代理曾使无头浏览器 localhost 导航超时,而 curl 和 API 正常;最小探针
确认后,仅在测试 Chrome 进程增加 --no-proxy-server。没有修改系统或用户浏览器
代理。旧脚本在同一桌面 context 立即切换 viewport 后 fullPage 截图出现重复拼接;
新建手机 context 后检查 DOM、滚动和截图,只有一个页首,已替换失真截图。
截图:/private/tmp/wishforge-console-final-20261017.png、
/private/tmp/wishforge-console-mobile-20261017.png、
/private/tmp/wishforge-runs-mobile-20261017.png;
报告:/private/tmp/wishforge-mobile-qa-20261017.json。
真实本地 Keycloak 登录时临时关闭开发令牌,完成授权码 + S256 PKCE、state/nonce、
加密 HttpOnly cookie、API audience/issuer/租户成员验证:成员 200,未登录 401,
回调重放 400,另一真实 Keycloak 账户没有平台 membership 返回 403;应用退出后
返回 401。临时账户已清理,管理台恢复本地开发模式。修复 realm 缺少 basic scope
导致 access token 无 sub,以及 tenant_id 的管理员写入配置。报告位于
/private/tmp/wishforge-oidc-acceptance/result.json。本地 HTTP 未验证生产 Secure
cookie;退出未终止整个 Keycloak SSO session,长会话 refresh 和企业 IdP 仍需验收。
项目设置新增“独立验收配置”:从真实 API 读取已安装 ID/版本,独立 POST 选择绑定,
与仓库补充测试分开保存。真实空列表已验证;非空选择、保存回显、403保留旧绑定使用
隔离的浏览器 API fixture 验证,不代表安装了实际验收脚本。证据:
/private/tmp/wishforge-verification-profile-ui-20261017.json。