diff --git a/docs/v2/15-development-handoff.md b/docs/v2/15-development-handoff.md index b484848..f27b98b 100644 --- a/docs/v2/15-development-handoff.md +++ b/docs/v2/15-development-handoff.md @@ -105,24 +105,25 @@ docs/project-process/README.md、XINGBANG-ADAPTATION.md，执行 git status --sh > 交付定义与四批顺序以 [16 交付纠偏规格](16-delivery-corrections.md) 为准； > 下表的"已交付"只表示该任务包的代码与测试存在，不再表示产品功能可用。 -- 日期：2026-10-01（**纠偏第二批实施轮**；第一批见 git 历史，T08–T11 见更早提交）。 +- 日期：2026-10-01（**纠偏第三批实施轮**；第二批见 `2e7e194`/`01c88af`，第一批见更早提交）。 - 仓库：`F:/mini-OpenClaw-v2`；远程 `http://192.168.10.111:3000/qiaoqichao/mini-openclaw-v2.git` （OQ-06 Q2 的远程归属已定案；端口/资源/CI 三问仍 open；**本轮未推送**）。 -- 完成范围：**纠偏第二批「历史经验加工」**——真实提炼入口、候选治理、 - 卡片进方案并影响运行，加本模块独立页面入口。`scripts/verify.py` **12 项检查**全通过 - （新增 `experience-center-ui` 源码守卫）。 +- 完成范围：**纠偏第三批「按原型完成界面」**——深色导航＋浅色工作区、 + 三个模块的独立入口（AI 预审 / 历史经验加工 / 轨迹复盘）、轨迹回放界面。 + `scripts/verify.py` **13 项检查**全通过（新增 `module-shell-ui` 源码守卫）。 - 验证入口：`cd F:/mini-OpenClaw-v2 && backend/venv/Scripts/python.exe scripts/verify.py`； - 本轮证据：`test-evidence/20261001-003148-2e7e194/`（12/12 PASS）。 -- 测试规模：全量 **567 项** unittest（本批新增 36 项：提炼 15 / 候选治理 15 / 卡片到运行 6），既有测试无回归。 -- 本轮提交：`2e7e194` —— `feat(v2): 纠偏第二批——接通历史经验加工闭环`。 -- 卡片验收对照（详见 [17 四批交付记录](17-batch-delivery-records.md) 第二批）： - - AC-50：真的调用模型才产候选；模型不可用 → E-28 且**候选数为 0** - （提炼跑完后复查库，而不是只看返回值）。 - - AC-51：自然语言修订真的发起一次模型调用；修订只产草稿、保留 origin 与来源、不自批； - 模型不可用时拒绝且卡片一字未改。 - - AC-52：同一项目两次运行对照——基座方案无该核查项，含卡片的方案有 1 条， - `basis_ids=[卡片id@1.0.0]`，`component_versions` 含卡片版本。 - - BR-50（部分）：历史经验加工获得独立入口 `/experience-center`；另两个入口与深色导航属第三批。 + 本轮证据：`test-evidence/20261001-005027-ae89462/`（13/13 PASS）。 +- 测试规模：全量 **567 项** unittest 无回归（第二批已含新增 36 项；本批为界面改动， + 证据是源码守卫 + 生产构建，未新增后端单测）。 +- 本轮提交：`ae89462` —— `feat(v2): 纠偏第三批——深色导航、三模块独立入口与轨迹复盘`。 +- 卡片验收对照（详见 [17 四批交付记录](17-batch-delivery-records.md) 第三批）： + - AC-53：`/` 呈现三个模块入口；导航为深色（`#102B27`/选中 `#244D41`），画布保持浅色； + 原落地页内容保留在 `/assistant`，不再"只保留旧版布局"。 + - AC-54：概率状态与依据、动态维度、推进沙盘在 `PrescreenPanel`； + 可回放轨迹由新增 `TrajectoryPanel` 消费既有只读端点（失败保留、成本缺失留空、不渲染推理字段）。 + - AC-55：新路由与样式通过守卫——已合并旧页仍为重定向、导航按角色裁剪、 + 模块以 `?project=` 为上下文且不硬编码项目 id、前后端路径一致。 + - BR-50：三个模块各有独立路由与入口，均在**复用**既有组件而不是在新页里重写一份。 - 未决项（阻塞后续）： - **F17（新）真实模型提炼未实测**：本机未设置 `XINGBANG_LOCAL_MODEL_*`， AC-50 前半句目前只有"不可用路径 + 假传输成功路径"两类证据。 @@ -131,17 +132,26 @@ docs/project-process/README.md、XINGBANG-ADAPTATION.md，执行 git status --sh （`present/absent` 被既有断言锁定拒绝），模型给出的例外保存为文本 `exception_note`。 - **F19（新）卡片适用条件不参与运行内逐项判定**：只用于域/范围/有效期过滤 （`knowledge_cards.effective()`）；运行内条件求值需独立设计。 - - **F11** 界面仍未经浏览器验证：新增的 `/experience-center` 同样只有源码守卫与 - 生产构建两层证据（本机无 playwright/puppeteer/chromium）。 + - **F11** 界面仍未经浏览器验证：`/experience-center`、`/prescreen-workbench`、 + `/trajectory-center` 与深色导航都只有"源码守卫 + 生产构建 + 代码走查"三层证据 + （本机无 playwright/puppeteer/chromium）。深色底对比度已改为守卫内按 WCAG 实算 + （最低 8.37:1），但配色达标 ≠ 实机版面已验收。 + - **F20（新）新旧经验入口并存**：工作台仍保留旧「评审经验」页签（走 + `assistant_experiences`），与第二批的知识卡片治理不是同一套。删除是用户可见的 + 破坏性动作，本批未擅自下线，需确认后处理。 + - **F21（新）首页默认路由变更**：`/` 由聊天页改为业务工作区，原内容移到 `/assistant`。 + 若部署脚本、书签或外部链接依赖旧的 `/`，需另行确认。 + - **F22（新）轨迹/会议结果的录入属第四批**：本批只做只读回放与只读对照。 - **F7** 各卡门禁仍 `proposed`，审阅者未指派——用户授权不等于评审通过。 - **F8** Docker 运行时冒烟未实测（本机 Docker Desktop 守护进程不可达）。 - **F6** OQ-06 Q3–Q5：端口冲突核验、运行资源、Gitea CI 是否启用仍 open。 - - **F12/F13/F14/F16** 仍有效（F13 已由第一批关闭：运行视图改由执行链出口产生）。 - - **F15** 改进发布仍未接真实知识发布入口，属**第三/四批**范围。 -- 下一任务：**第三批「按已确认原型完成新版界面」**（深色导航 + 三入口 + AC-53/54/55）； - 或先补 **F17**（需要你提供模型端点与调用时机）。不要为了推进而把演示当验收。 + - **F12/F14/F16** 仍有效；**F13** 已由第一批关闭（运行视图改由执行链出口产生）。 + - **F15** 改进发布仍未接真实知识发布入口——属第四批。 +- 下一任务：**第四批「评审反馈与改进发布」**（AC-56/57，含会议结果录入与 + 改进候选的真实知识发布接线）；或先补 **F17**（需要你提供模型端点与调用时机）。 + 不要为了推进而把演示当验收。 - 待输入：模型端点与调用时机（F17）；真实数据/制度/会议标签映射与客户身份权限（M5/M6）； Laya 硬件与中文效果需实机探测；Jev 端点与凭据。 - Git：本轮提交在 `codex/xingbang-v2-model-field-fix` 分支，**尚未推送**； - 核对命令 `git log --oneline -3`（当前 HEAD `2e7e194`）。 + 核对命令 `git log --oneline -3`（当前 HEAD `ae89462`）。 不得从旧恢复点 4d5a420 推断最新版本已备份。 diff --git a/docs/v2/17-batch-delivery-records.md b/docs/v2/17-batch-delivery-records.md index 638e368..327d924 100644 --- a/docs/v2/17-batch-delivery-records.md +++ b/docs/v2/17-batch-delivery-records.md @@ -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`，但该类此前只用于 `