# 兴邦预审 v2 UI Spec

状态：候选表面规格，生产UI尚未开发；Superdesign 原型单独见 [交互原型记录](12-prototype.md)，不以原型替代生产验收。输入：需求规格与详细设计草案。

## 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 和数据域/版本。用户新增要求在设计原型中展示概率及沙盘联动，因此仅演示域允许使用独立的演示值，紧邻“人工设定、未经校准”标识；不得填入真实 probability。具体语义、依据链和即时联动见 [概率与沙盘设计](13-probability-prototype.md)。真实概率仍须独立算法、数据与验收。

## 6. 文案与视觉

[DESIGN.md](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 阶段实施。

概率可视化增量：主结果使用概率环、六轴证据核验阶段雷达和维度追溯；具体阶段含义、假设联动、miniOpenClaw/Skills/Tools/Rules职责及P-14–17验收见[概率设计第6节](13-probability-prototype.md#6-概率环证据雷达与解释链2026-09-29增量)。演示数值不能转换为真实信用评分或概率贡献。

## 9. 三模块表面规格增量（0.2，未改原型）

深色导航＋浅色工作区方向不变；本轮只补交互规格，不宣称新页面已由Superdesign生成。业务首页显示历史经验加工、AI预审、轨迹复盘三个入口，保留项目上下文；具体路由在T00/T09定案，不恢复旧独立页。

| 表面 / 状态owner | 骨架与消费字段 | 动作与异常 |
|---|---|---|
| 材料集合 / ImportBatchPanel | 文件清单、逐项状态、解析结果和冲突；ImportBatch/FactConflict/SourceLocator | 材料编辑者可选文件/重试失败项/确认；E-16逐项说明，E-17保留冲突，切换项目清空选择 |
| 经验加工 / KnowledgeCandidateEditor | 左来源事件，中提炼要求与差异，右Skill/Rule草稿；KnowledgeCard | 提议者可生成/手工新增/编辑；发布人审核但不可自批；E-18缺依据不得硬规则发布 |
| 方案装配 / ReviewPlanEditor | 数据/Skills/Rules三类卡，依赖及核查维度预览；ReviewPlan/DimensionSpec | 编辑者保存草稿、提交审核；E-19/20定位不可用依赖/冲突；不显示Tools配置卡 |
| 预审与沙盘 / RunSummary、ScenarioPanel | 概率状态/建议→动态维度→证据→动作组合；ScreeningRun/ProbabilityView/Simulation | 等待新情景时保基线并显示计算中；只接受最新选择响应；失败不显示旧情景为新结果 |
| 轨迹复盘 / TrajectoryPanel | 左Agent步骤，右会议时间线，中间差异；TrajectoryStep/ReviewOutcome | 授权查看者展开来源；记录人可追加会议结果；E-23/26保留未对齐/未映射标识 |
| 改进对照 / ImprovementPanel | 偏差→候选修订→固定对照→审核/发布；ImprovementCandidate/Evaluation | 提议者提交，评测员锁定/揭示，发布人审核；E-24显示未完成门禁，不提供自动上线按钮 |

上述表面全部继承第3节idle/loading/ready/empty/error/submitting与stale附加状态；业务状态由03第9节决定。只读访客无编辑/发布按钮；后端对每次动作重验。载入失败显示请求编号，版本冲突保留草稿。切项目时取消或忽略旧请求，清空证据、卡片选择、沙盘和轨迹节点；不能把前项目片段带入后项目。

卡片来源采用独立视觉：history_derived=“历史提炼”+历史图标+origin-history样式；manual=“人工创建”+编辑图标+origin-manual样式；policy_import=“制度导入”+文件图标+origin-policy样式。另显示data_domain与status徽标。历史卡被人工编辑后仍显示历史提炼及人工修订记录。来源色与通过/阻断状态色分开，去色仍能区分（AC-25/42/43）。

动态维度遵守14第5节：同刻度3–8维用雷达，其他完整列表或分组，来源抽屉可追溯数据/Skill/Tool/Rule/经验版本。空维度显示“当前方案尚未配置核查维度”，不补六轴占位。硬规则单独突出（AC-29/44）。

轨迹使用可折叠的步骤流和时间轴，当前步骤高亮、失败/跳过用明确文字。缺少人工过程时只显示已知会议事件和“过程材料不完整”，不造装饰性成功节点。图旁提供等价列表；动画短时且可关闭，不以炫酷动效暗示模型隐藏推理已可见（AC-32/33）。

新增中文文案域：material.import.*、knowledge.origin.*、plan.validation.*、trajectory.step.*、outcome.mapping.*、improvement.status.*。P0语言范围只中文；统一文案模块的实际文件与token消费路径在T09前定案。视觉数值与对比度尚未验证，不以本文替代UI门禁。