Files
mini-openclaw/docs/v2/12-prototype.md
T

8.8 KiB
Raw Blame History

兴邦智审 v2 · Superdesign 交互原型

日期:2026-09-28。目标:验证视觉风格、信息层级与核心操作,不代表新版业务功能已实现。

用户已选方向

深色导航+浅色工作区;高端大气、直观易用、有科技感。以深绿导航、白色证据面板和精确的关系图呈现金融评审工作台。首屏先回答“当前建议是什么、依据是什么、下一步做什么”。

原型范围

一个连通的项目工作台:综合预审、历史经验、推进沙盘通过页签切换。证据抽屉展示原文与缺证,补件清单弹窗说明具体材料。模型选项展示本地开源模型(演示)、Jev(未配置)和关闭。正式审批不纳入原型操作。

虚构企业与项目:恒远精密设备有限公司 / DEMO-026;3,000万元、36个月及全部材料数量均为演示数据。主审意见为“补充材料后再判断”,不展示未经校准的真实通过概率;按用户新增要求,原型可展示明确标记且与真实结果字段隔离的演示概率,见 概率与沙盘设计。

状态与交互约束

  • 综合页:结论、两项重点问题、证据关系和下一步;来源节点可展开,关闭抽屉返回原位置。
  • 历史经验:问询→补件→证据变化→历史意见,显示适用条件与例外;相似不直接导出相同结论。
  • 推进沙盘:选择假设补件→即时比较概率、原因与待核实事项;持续标记假设条件,返回真实预审后原意见不变。
  • 模型选择:本地仅演示,Jev未配置不可调用,关闭保留主审意见及缺失专项提示;切换不能伪称已连接模型。
  • 补件清单:打开/关闭、可复制内容;不提供伪造的报告下载。
  • 验证入口:只展示待开展的对照方案,不展示虚构准确率。

原型验收(与生产验收分开)

ID Given / When / Then 需求关联
P-01 Given 演示项目,When 打开首页,Then 首屏显示预审意见、关键依据、下一步及演示标识 AC-05/07/12
P-02 Given 一条问题,When 点击证据,Then 可读原文、定位和缺失项,关闭后回到原页面 AC-08
P-03 Given 历史案例,When 切换历史经验,Then 看到问询/补件/判断变化与适用例外 AC-02/04
P-04 Given 模拟补件,When 勾选假设并返回真实预审,Then 原意见未变,模拟结果有持续标识 AC-11
P-05 Given 模型选项,When 选择关闭,Then 显示未执行专项核查;Jev未配置不可调用 AC-17/21
P-06 Given 补件需求,When 生成清单,Then 可查看具体材料要求,无虚假的后端完成状态 AC-07
P-07 Given 桌面/窄屏和键盘操作,When 阅读及展开界面,Then 正文无裁切、可见焦点、可退出弹层 NFR-04

新增原型验收(用户新增概率可视化要求):

ID Given / When / Then 需求关联
P-08 Given 未校准的演示项目,When 看首页,Then 42%紧邻演示标识和人为设定说明,真实probability仍为空 AC-12
P-09 Given 四种复选框组合,When 勾选/取消,Then 无需运行按钮即可得到42/58/51/64及0/16/9/22个百分点 概率与沙盘设计第2节
P-10 Given 多选与再次取消,When 比较,Then 组合结果不作简单相加,原因与剩余事项同步更新 AC-11
P-11 Given 概率展示,When 查看依据,Then 看到数据卡/Skills/经验/规则及示例标识,并知道数字来自演示表 AC-08/12
P-12 Given 模拟或关闭专项核查,When 返回综合预审,Then 基线42%与原意见不变;模型选项不会伪造概率变化 AC-11/21
P-13 Given 窄屏,When 查看概率和比较,Then 数字/演示提示/原因完整可读,无横向裁切 NFR-04

设计工具与数据边界

使用用户指定的 Superdesign,设计模型 Gemini 3.1 Pro。仅上传本轮独立编写的概念说明与虚构内容;上传现有前端源码的操作被自动审批拒绝,随后改用不含源码的概念设计。原项目源码不作为本次生成载荷。六份源码分析文件仅留本地供设计人员理解,不声称外部设计已与现有组件逐像素一致。

持久设计上下文及原型标识放 .superdesign/resume.json;临时生成日志/HTML在 .superdesign/tmp/,验证证据在 test-evidence/20260928-superdesign-prototype/。不修改现有应用路由、业务逻辑或部署。

实施边界

原型页面上的交互使用演示状态。源代码实现仍按 M3/M4 和项目流程落地;设计稿存在不证明接口、模型调用、权限或效果成立。视觉审阅与实际业务验收分别记录,不将作者目测称为独立验收。

已交付原型与检查

首轮草稿 7484f5c4-0415-4a87-a772-c42339680737 保存为版本2(历史记录)。初稿由 Superdesign Gemini 3.1 Pro 生成,随后在同稿内直接补齐确定的交互、响应式和文案缺口;未额外生成视觉变体。云端回读HTML与本地已验文件一致;入库HTML仅清理3处行尾空白,内容与行为保持一致。

导出原型的20项行为检查通过:证据抽屉/关闭焦点、历史经验、空模拟守卫、假设结果与真实基线隔离、Jev禁用、本地/关闭切换、补件与验证弹窗、1440/1024/390三种宽度无文档横向溢出、移动导航及无运行脚本错误。首轮移动导航关闭失败,原因与修复留在fix-record.md,复验保留独立截图。同样20项检查在Superdesign线上预览再次通过,证据在remote-check-03/interaction-checks.json。

检查边界:使用独立无头浏览器验证演示状态;内置浏览器连接因本机环境故障未成功。作者截图自查不等于独立视觉评审;未完成全量无障碍审计,未连接业务接口或真实模型。首轮为设计文档交付,未重跑旧版套件;本次概率交互增量另按行为改动运行统一验证,结果见后续记录。

2026-09-29 概率沙盘增量交付

同一草稿更新为版本4。综合页显示42%演示基线;沙盘勾选与取消立即更新42/58/51/64、百分点、变化原因和待核实事项。依据抽屉串联数据卡、Skills、历史经验和规则,并明确概率数字来自人工情景表。缺证的规则状态为待核实,不视为通过。模型选择与模拟均不修改原项目结论。

  • 概率首页截图 / 沙盘对照截图。首轮截图保留,不覆盖。
  • 浏览器回归脚本:需要Playwright与Chromium;可通过CHROMIUM_PATH指定浏览器,通过PROTOTYPE_URL选择线上预览,通过EVIDENCE_DIR指定新证据目录。默认检查旁边的HTML,不调用业务API。
  • 本地与Superdesign实际预览分别通过74项断言,覆盖P-01–13的本次相关交互:四种组合、正反选择顺序、取消还原、即时原因、人工概率来源、基线隔离、提供方切换、原有弹窗/经验/导航,以及1440/1024/390宽度。
  • 完整计划、交互日志及截图:test-evidence/20260929-probability-prototype/。浏览器检查不等于独立视觉验收或真实概率效果验证。
  • 使用backend/venv运行scripts/verify.py,9项检查全部通过:后端单测、4项UI守卫、前端构建、2项Compose配置与diff。证据:test-evidence/20260929-003310-e2883bb/REPORT.md。运行基于e2883bb及本次未提交原型;最终HTML哈希与绑定说明见本次证据manifest.json。
  • 云端回读版本4与入库HTML仅CRLF/LF换行不同;两端行为测试通过。中断前生成稿缺失即时原因更新、将缺证规则误写为通过,两项均在导入版本4前修正。

本次按原型交互轻量路径记录,沿用AC-08/11/12/21和P-01–13,补充设计与测试;没有越过业务实现门禁。交付为原型及文档备份,没有修改现有src/backend业务代码、没有合并main、没有发布镜像。真实概率仍待审批事件定义、历史数据验证与校准。

远程备份状态(2026-09-29):已配置origin在SSH握手阶段关闭连接,重试与只读诊断均复现。本次增量先保存本地提交,Gitea远端SHA未核验,不能标记本次已远程备份。此前已核验的备份不受本地提交影响。日志在test-evidence/20260929-probability-prototype/gitea-connection.log。