docs(v2): 第三批交付记录与交接(深色导航与三入口)
按 16 §4 的五项口径填第三批,状态记**部分完成**:深色导航、三个模块的独立入口、 轨迹回放界面已接通;界面仍未经浏览器点击验证(F11),录入属第四批。 记录里如实写明而不是含糊: - 对比度改为守卫内按 WCAG 实算(最低 8.37:1),并说明"配色达标 ≠ 实机版面已验收"; - `/` 默认路由由聊天页改为业务工作区,属**用户可见的行为变化**,列出需确认; - 工作台旧「评审经验」页签与第二批的知识卡片治理新旧并存,未擅自下线; - `AgentLoopFlow.tsx` 仍是零引用死代码,本批未复用也未删除; - 原型顶部演示提示条未实现。 15 §7 交接同步:新增 F20(新旧经验入口并存)、F21(首页路由变更)、 F22(轨迹/会议录入属第四批),F11 扩到三个模块,下一任务改为第四批。 验证:`test-evidence/20261001-005027-ae89462/`(verify.py 13/13 PASS,全量 567 项)。 Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
@@ -203,7 +203,71 @@ XINGBANG_LOCAL_MODEL_KEY=<你的 DeepSeek API Key>
|
||||
|
||||
## 第三批:按已确认原型完成新版界面
|
||||
|
||||
状态:**未开始**。
|
||||
状态:**部分完成**。深色导航、三个模块的独立入口、轨迹回放界面已接通并通过
|
||||
生产构建与源码守卫。**未闭合**:界面仍未经浏览器点击/截图验证(同 F11,本机无浏览器自动化);
|
||||
轨迹与会议结果的**录入**属第四批;工作台旧的「评审经验」页签未下线。
|
||||
|
||||
覆盖:AC-53/54/55、BR-50。
|
||||
|
||||
### 页面入口
|
||||
|
||||
| 入口 | 位置 |
|
||||
|---|---|
|
||||
| 业务工作区首页 | `/`(三个模块入口卡片;`?project=` 携带项目上下文) |
|
||||
| AI 预审 | 深色导航「AI 预审」→ `/prescreen-workbench` |
|
||||
| 历史经验加工 | 深色导航「历史经验加工」→ `/experience-center`(第二批交付) |
|
||||
| 轨迹复盘 | 深色导航「轨迹复盘」→ `/trajectory-center` |
|
||||
| 原落地页内容 | `/assistant`(保留,不再是默认首页) |
|
||||
|
||||
### 操作步骤(实现并按此核对)
|
||||
|
||||
1. 打开 `/` → 看到三个模块入口卡片与"当前项目上下文"提示。
|
||||
2. 进入任一模块 → 深色导航高亮当前模块;`?project=` 在模块之间保持。
|
||||
3. AI 预审:选项目 → 选方案 → 填本次要求 → 发起预审 → 下方结果面板给出
|
||||
概率状态与依据、动态维度、推进沙盘、每条"查看依据"。
|
||||
4. 轨迹复盘:选运行 → 步骤流(序号 / 类型 / `组件@版本` / 状态 / 错误码 / 证据数 / 成本 / 耗时)
|
||||
→ 加载更多 → 会议结果只读对照。
|
||||
|
||||
### 实际结果
|
||||
|
||||
- 导航为深色(`nav.bg #102B27`、选中 `#244D41`、`muted #B1C6BE`),工作区画布保持浅色
|
||||
`#f5f7f9`;导航内的身份选择器改用深色变体,避免深底白字不可读。
|
||||
- 三个模块各有独立路由并各自渲染**复用**的组件(`PrescreenPanel` / `ImportBatchPanel` /
|
||||
`ExperienceCenter` / `TrajectoryPanel`),路由里没有再写一份实现。
|
||||
- 已合并的旧页 `/trajectory`、`/review-workbench`、`/report-workbench`、`/collateral-workbench`
|
||||
**仍是重定向**,没有被复活(AC-55 的防重复页面)。
|
||||
- 轨迹面板:失败/跳过步骤照常列出并带错误码;成本缺失显示"未记录(不填 0)";
|
||||
展示服务端"不包含模型内部推理过程"的说明;无任何写操作。
|
||||
- 生产构建产物(实测):`/` 1.98 kB、`/prescreen-workbench` 2.36 kB、
|
||||
`/trajectory-center` 3.87 kB、`/experience-center` 7.48 kB、`/assistant` 6.08 kB。
|
||||
- 首页入口卡片沿用了既有的 `.xb-project-card`,但该类此前只用于 `<button>`;
|
||||
作为 `<a>` 会带上浏览器默认下划线,因此补 `display:block;text-decoration:none`
|
||||
(只影响该类,按钮用法不受影响)。
|
||||
- 现有 7 项界面守卫全部继续通过(可读性、S1 面板、预审面板、加工中心、评审工作台、身份恢复、助手访问)。
|
||||
|
||||
### 证据位置
|
||||
|
||||
| 内容 | 位置 |
|
||||
|---|---|
|
||||
| 模块壳与三入口源码守卫(新增) | `scripts/test_module_shell_ui.cjs`(已登记 `scripts/verify.py`,共 **13** 项检查) |
|
||||
| 全量验证 | `test-evidence/20261001-005027-ae89462/`(`scripts/verify.py` **13/13 PASS**,含 `backend-unit` 全量 567 项、`frontend-build`、新增 `module-shell-ui` 守卫) |
|
||||
|
||||
### 剩余缺口
|
||||
|
||||
- **界面仍未经浏览器验证(F11 未变)**:深色导航与三个模块都只有"源码守卫 + 生产构建 + 代码走查"
|
||||
三层证据,**没有浏览器点击或截图**;原型本身也没有视觉门禁(04-ui-spec §7 已声明不以原型替代验收)。
|
||||
深色导航的文字对比度已改为**机械断言**(守卫内按 WCAG 公式实算,阈值 AA 4.5:1):
|
||||
未选中 12.03:1、选中 9.49:1、muted 8.37:1、品牌 13.91:1,全部达标——但这证明的是配色可用,
|
||||
不等于版面在实机上的观感已验收。
|
||||
- **轨迹与会议结果的录入属第四批**:本批只做只读回放与只读对照,界面上写明了这一点。
|
||||
- **工作台仍保留旧「评审经验」页签**(走 `assistant_experiences`,与第二批的知识卡片治理不是同一套)。
|
||||
新旧并存会造成"哪里才是正门"的困惑;但删除是用户可见的破坏性动作,本批不擅自下线,留待确认。
|
||||
- **`AgentLoopFlow.tsx`(`src/components/trajectory/`)仍是零引用死代码**:本批没有复用它,
|
||||
也没有删除——它不挡事,清理不属于本批交付范围。
|
||||
- **原型顶部的演示提示条未实现**:原型有"原型演示 · 未连接真实数据与模型"横幅;
|
||||
本批只做了导航与工作区骨架,未加该横幅(各模块内部已有等价的域与来源标识)。
|
||||
- **首页默认路由发生变化**:`/` 由聊天页改为业务工作区,原内容移到 `/assistant`。
|
||||
这是**用户可见的行为变化**;若部署脚本、书签或外部链接依赖旧的 `/`,需另行确认。
|
||||
|
||||
## 第四批:接通评审反馈与改进发布
|
||||
|
||||
|
||||
Reference in New Issue
Block a user