Files
mini-openclaw/docs/v2/04-ui-spec.md
T
2026-09-28 17:24:03 +08:00

6.3 KiB
Raw Blame History

兴邦预审 v2 UI Spec

状态:候选表面规格,未开发、未做浏览器验收;不把本文件当作可点击原型。输入:需求规格与详细设计草案。

1. 交付面与骨架

表面 区域 / 信息层级 消费契约
预审总览 项目与数据域→意见及缺证状态→主要问题→经验对照→证据抽屉 ScreeningRun、Finding、Evidence
历史过程 左:来源材料;中:争议/补件时间线;右:经验卡草稿与审核记录 CaseTimeline、DecisionEvent、ExperienceCard
推进沙盘 左:证据→动作→问题变化图;右:假设动作;底:真实与模拟差异 Simulation、ScreeningRun
验证看板 数据集版本/保留状态→对照指标→分歧案例→人工复盘 Evaluation

拟集成至 xingbang-workbench / review-workbench 的项目上下文,实际路由与组件拆分在 UI 实现前定案,不恢复已合并的旧页面。

2. 组件所有权

ProjectContext 拥有 project_id、data_domain 和当前 run_id;RunSummary 只展示运行结果;CaseTimelinePanel 拥有选中事件;EvidenceDrawer 拥有证据展开状态;ExperienceEditor 拥有草稿和 expected_revision;ScenarioPanel 拥有 assumptions,不能写真实项目事实;EvaluationPanel 拥有数据集选择,不能提前获得保留标签。

组件名为提案,尚未创建。URL 仅保存 project_id/run_id/tab 等非敏感可分享状态;身份令牌、材料文本和假设正文不放 URL。切换项目清空选中证据与模拟动作。

3. 状态机

状态 可见内容 允许动作 / 禁用动作
idle 项目说明与启动入口 有权限可发起;无项目不发请求
loading 对应区域骨架与加载文案 可退出;禁重复提交
ready 已获数据与版本信息 按权限操作
empty “尚无历史经验”或“尚无运行”及下一步 可导入/发起;不能绘制虚构节点
error 错误码映射的文案、请求编号和恢复入口 仅可恢复错误显示重试
submitting 保留原内容,显示提交中 禁二次提交;不清除草稿
stale(ready 附加标识) “项目已有新版本,当前为历史结果” 可查看/新运行;禁止覆写旧结果

业务运行 queued/running/awaiting_input/completed/partial/failed/cancelled 单独展示;partial 必须突出未完成项。更新失败时回 ready/error 且保留草稿,版本冲突提示刷新后合并。

4. 动作与权限

动作 客户经理 评审员/发布人 管理员 只读访客
查看项目结果和证据 授权项目 授权范围 授权范围,非默认全量 仅指定演示项目
确认材料、发起预审 项目授权 项目授权 不自动继承业务权限 隐藏
模拟动作 项目授权 项目授权 项目授权 仅演示授权
编辑经验候选 提议权限 编辑权限 不自动继承 隐藏
审核发布/撤回 隐藏 独立发布资格且不可自批 治理授权后 隐藏
修改模型出口与数据域 隐藏 隐藏 策略管理资格 隐藏
揭示保留集结果 隐藏 指定验证负责人且预测已锁定 不因管理员身份自动开放 隐藏

后端始终重验权限。无权限动作不显示控件;有权限但条件未满足显示禁用原因。经验发布前展示范围、例外、有效期和变更差异;撤回说明新运行不再使用、历史引用保留。

5. 沙盘视觉规则

证据→动作→受影响问题→预审意见;线宽最多三档,对应已定义影响等级,不能直接代表概率提升。未验证假设使用虚线和“模拟”文字;真实核验使用实线及来源。通过点击/键盘打开依据,颜色不单独传意。

一次只突出当前选中问题的关联路径,其他弱化;未知项不伪装为否定。补件可能发现新风险,允许意见变得更谨慎。图旁提供等价列表,缩小窗口时改纵向排列,不依赖复杂图才能理解结果。

P0 顶部不显示百分比“通过率”。展示 recommendation、missing_inputs、degradations 和数据域/版本;不凭空生成完整度或置信度数字。评分若后续加入,须另有明确算法和契约。

6. 文案与视觉

DESIGN.md 管理语义 token 候选。新增文案拟 key 化:prescreen.result., prescreen.error., experience.status., simulation., evaluation.;每个错误 key 对应规格 E-,中英文范围在 UI 门禁前确定。当前无对应 i18n 实现,不伪称可用。

正文按现有 16px 基线,主动作可键盘访问;可见 focus、表单 label、错误定位、减少动效、文本与图的等价表达。长标题换行,证据抽屉不截断关键原文。产品页面默认不暴露 question_version 等实现细节,只在“依据与版本”展开。

7. 验收映射与未决

来源点击与权限 AC-01/08;未知时间 AC-02;经验审核 AC-03/04;降级 AC-07/09;模拟隔离 AC-11;无伪概率 AC-12;盲测标签 AC-15。

UI 门禁尚未通过:路由位置、统一 token 实现、i18n 文件、视觉稿、键盘和对比度验收待完成。截图自评不能单独算通过,应有可复现的 DOM/行为断言及独立评审记录。

8. 专项判断选项(候选)

预审发起表单增加“专项核查”:关闭 / 本地模型 / Jev 官方服务;实际选项来自后端授权配置(JudgmentProfile),不能只按品牌静态显示可用。用户看到模型名称、提供方和可用状态;配置 ID/修订和供应商指标放“依据与版本”。管理员在部署配置中管理端点和凭据,P0 不新增在线编辑密钥页面。

无 Jev Key 时 Jev 配置不进入可选列表;本地可用则可选择本地。没有可用配置时仅保留关闭并说明未配置。业务请求只传 judgment_profile_id,不传 URL 或 Key;后端重新校验,失败按 E-13 显示。提交中禁改本次选择,运行结束或排队后修改选择均需发起新运行。

结果展示本次实际提供方、未完成题目和拒答/unknown;关闭显示“专项核查已关闭”。失效/超时不把选中项悄悄变为另一个模型,不展示占位高分。对应 AC-17/18/19/20/21;页面路由及真实交互待 UI 阶段实施。