docs(v2): 记录浏览器验证第二篇与 F11 剩余部分的收口
17 新增「浏览器验证(第二篇):AI 预审 / 历史经验加工」:覆盖的交互、 点通过程中发现并修掉的 2 个缺陷(预审面板不刷新、候选行同 id 连开多行)、 写演示库的副作用清单,以及本数据集下仍点不到的 3 处(沙盘勾选联动、 来源事件勾选、reviewer 视角的审核发布)与 2 处口径待确认项。 15 第 7 节改为本轮交接:F11 三个表面均已由真实 Chrome 走过;F27/F29/F30 与新证据路径;下一任务只剩需要用户或外部输入的部分。 Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
@@ -105,23 +105,24 @@ docs/project-process/README.md、XINGBANG-ADAPTATION.md,执行 git status --sh
|
||||
> 交付定义与四批顺序以 [16 交付纠偏规格](16-delivery-corrections.md) 为准;
|
||||
> 下表的"已交付"只表示该任务包的代码与测试存在,不再表示产品功能可用。
|
||||
|
||||
- 日期:2026-10-01(**纠偏第四批实施轮**;第三批见 `ae89462`/`3e15bda`,
|
||||
第二批见 `2e7e194`/`01c88af`,第一批见更早提交)。
|
||||
- 日期:2026-10-01(**F11 剩余部分实施轮**;纠偏第四批见 `f775c6c`/`4720d72`,
|
||||
第三批见 `ae89462`/`3e15bda`,第二批见 `2e7e194`/`01c88af`,第一批见更早提交)。
|
||||
- 仓库:`F:/mini-OpenClaw-v2`;远程 `http://192.168.10.111:3000/qiaoqichao/mini-openclaw-v2.git`
|
||||
(OQ-06 Q2 的远程归属已定案;端口/资源/CI 三问仍 open;**本轮未推送**)。
|
||||
- 完成范围:**纠偏第四批「接通评审反馈与改进发布」**——会议结果从页面录入并与材料版本对照;
|
||||
改进候选接上**真实知识发布入口**,发布后新运行用新版本、旧运行仍可回放。
|
||||
界面并入「轨迹复盘」模块(`/trajectory-center`),**不新增第四个导航入口**。
|
||||
本轮另**首次做了真实浏览器端到端验证**(新增可选脚本 `scripts/browser-e2e.cjs`),
|
||||
并因此发现并修掉 5 个源码守卫与生产构建都看不出的缺陷——其中一个是**三个模块页
|
||||
在浏览器里根本渲染不出面板**(`/projects` 读错字段),见 17「浏览器验证发现的问题」。
|
||||
`scripts/verify.py` **14 项检查**全通过(新增 `improvement-panel-ui` 源码守卫)。
|
||||
- 完成范围:把 **F11 剩下的两个表面**在真实 Chrome 里逐项点完——`/prescreen-workbench`
|
||||
(点「开始 AI 预审」走完真实执行链、依据抽屉与焦点回位、概率口径、沙盘空态)与
|
||||
`/experience-center`(重建时间线、请求提炼的拒绝与失败路径、候选卡与修订入口、身份门禁)。
|
||||
新增可选脚本 `scripts/browser-e2e-modules.cjs`(**42 项检查全通过** + 4 张截图)。
|
||||
点通过程中发现并修掉 **2 个源码守卫与生产构建都看不见的缺陷**:
|
||||
① 发起预审后结果面板不重载(新运行与结果都读不到,而徽标写着"结果会自动刷新");
|
||||
② 候选行只用 `card.id` 作 key 与展开标记(React key 冲突,点一行连开 4 行面板)。
|
||||
见 [17 四批交付记录](17-batch-delivery-records.md)「浏览器验证(第二篇)」。
|
||||
- 验证入口:`cd F:/mini-OpenClaw-v2 && backend/venv/Scripts/python.exe scripts/verify.py`;
|
||||
本轮证据:`test-evidence/20261001-030127-ff59d7e/`(14/14 PASS,backend-unit 572 项)。
|
||||
浏览器验证证据:`node scripts/browser-e2e.cjs` → `test-evidence/e2e-batch4/`(19/19 PASS + 截图)。
|
||||
**该脚本刻意不接入 verify.py**(verify 不应依赖浏览器),需手动跑。
|
||||
- 测试规模:全量 **572 项** unittest 无回归(新增 `test_improvement_release.py` 4 项 +
|
||||
`test_improvements.py` 1 项)。
|
||||
本轮证据:`test-evidence/20261001-093541-c880f40/`(**14/14 PASS**,`backend-unit` 全量 572 项,
|
||||
证据绑定代码提交 `c880f40`)。
|
||||
浏览器验证证据:`node scripts/browser-e2e-modules.cjs` → `test-evidence/browser-e2e-modules/`
|
||||
(42/42 PASS + 截图);`node scripts/browser-e2e.cjs` 仍走轨迹复盘表面。
|
||||
**两个脚本都刻意不接入 verify.py**(verify 不应依赖浏览器),需手动跑。
|
||||
- 卡片验收对照(详见 [17 四批交付记录](17-batch-delivery-records.md) 第四批):
|
||||
- **AC-57**:端点把 `_knowledge_publisher` 注入 `improvements.transition`;publisher 用候选声明的
|
||||
`proposed_revision_ref` **精确**定位草稿(`组件id@版本`),调 `knowledge_cards.publish`
|
||||
@@ -136,20 +137,33 @@ docs/project-process/README.md、XINGBANG-ADAPTATION.md,执行 git status --sh
|
||||
需端点后按 17 的操作步骤补一次真实调用;在此之前不得宣称"真实提炼已跑通"。
|
||||
- **F18** 例外边界未进入可求值条件语言;**F19** 卡片适用条件不参与运行内逐项判定。
|
||||
(同第二批,本批未动。)
|
||||
- **F11 部分关闭**:`/trajectory-center`(含本批的会议结果录入与改进面板)已在**真实 Chrome**
|
||||
里端到端走过并通过(`scripts/browser-e2e.cjs`,19/19,有截图)。**仍开放的部分**:
|
||||
① `/experience-center`、`/prescreen-workbench` 只验到"能渲染",交互没有逐项点过;
|
||||
② 该脚本不在 `verify.py` 里,需手动跑(本机 Chrome + 一次性 `--no-save puppeteer-core`);
|
||||
③ 无视觉基线比对、无多分辨率、无键盘/读屏检查。
|
||||
- **F11 更新(本轮)**:三个模块表面现在都在**真实 Chrome** 里走过——
|
||||
`/trajectory-center`(第四批,`browser-e2e.cjs` 19/19)、`/prescreen-workbench` 与
|
||||
`/experience-center`(本轮,`browser-e2e-modules.cjs` 42/42)。**仍开放的部分**:
|
||||
① **推进沙盘的勾选联动**:演示方案的维度不含假设动作目标维度(`DC-CASH`/`DC-TITLE`),
|
||||
服务端返回 0 个动作,界面按设计给诚实空态(基线演示值 42% 已渲染并断言);
|
||||
② **来源事件勾选**:演示项目没有结构化问询/决定记录,时间线为 0 个事件;
|
||||
③ **reviewer 视角的「审核发布」**:reviewer 的 `/projects` 只授权到 DEMO-C,
|
||||
而 DEMO-C 没有知识候选,已用 admin 作对照(有「隔离评测」、无「审核发布」);
|
||||
④ 该脚本不在 `verify.py` 里,需手动跑(本机 Chrome + 一次性 `--no-save puppeteer-core`);
|
||||
⑤ 无视觉基线比对、无多分辨率、无键盘/读屏检查。
|
||||
深色底对比度仍是守卫内按 WCAG 实算,不是实测。
|
||||
- **F27(新)浏览器验证暴露的缺陷已修但防线不全**:本批靠浏览器发现并修了 5 个缺陷
|
||||
(见 17「浏览器验证发现的问题」)。其中只有"导航名折行"补进了源码守卫;
|
||||
其余 4 个(读错 `/projects` 字段、漏传 `identity`、重复 React key、JSX 里的字面量 `**`)
|
||||
目前只有 `browser-e2e.cjs` 覆盖,而它不在强制门禁里——**这类回归没有自动防线**。
|
||||
是否把浏览器 E2E 接进 `verify.py`、是否把 `puppeteer-core` 写进 `package.json`,需人决策。
|
||||
- **F28(新)模拟/演示数据随验证累积**:`scripts/xingbang_batch4_smoke.py` 与
|
||||
`scripts/browser-e2e.cjs` 都**真的写演示库**(新建卡片、会议结果),重复运行会累积脏数据。
|
||||
两者都在脚本头注明了这一点。
|
||||
- **F28(新)模拟/演示数据随验证累积**:`scripts/xingbang_batch4_smoke.py`、
|
||||
`scripts/browser-e2e.cjs` 与 `scripts/browser-e2e-modules.cjs` 都**真的写演示库**
|
||||
(新建卡片、会议结果、预审运行、时间线、失败提炼记录),重复运行会累积脏数据。
|
||||
三者都在脚本头注明了这一点;本轮新增 6 条 DEMO-B 预审运行与 3 条失败提炼记录。
|
||||
- **F29(新)候选列表把同一卡片的多个版本行都按"已发布"列出**:
|
||||
`knowledge_cards.list_cards` 同时返回 `component_draft` 与 `component_version` 行,
|
||||
同一 `card.id` 出现 3–4 行(v1.0.0 与 v1.0.1 都标"已发布"),界面不显示 `release`
|
||||
指针当前指向哪一版。"一行 = 一个存储记录"还是"一行 = 一张卡片的当前状态"需产品确认后再改。
|
||||
- **F30(新)「请求提炼」在"没有来源也没有要求"时按钮仍可点**:服务端按契约 422 并给出理由、
|
||||
界面如实显示;但同文件里「形成草稿修订」「保存样本到草稿」都按必填项禁用,口径不一致。
|
||||
按最小改动只验证未改。
|
||||
- **F20** 新旧经验入口并存(工作台旧「评审经验」页签);**F21** 首页默认路由已变更
|
||||
`/` → `/assistant`。两者都需确认后处理。
|
||||
- **F23(新)改进端点仍无角色门禁**:既有候选/方案端点对评测与发布有 `role()` 门禁,
|
||||
@@ -167,17 +181,15 @@ docs/project-process/README.md、XINGBANG-ADAPTATION.md,执行 git status --sh
|
||||
- **F8** Docker 运行时冒烟未实测(本机 Docker Desktop 守护进程不可达)。
|
||||
- **F6** OQ-06 Q3–Q5:端口冲突核验、运行资源、Gitea CI 是否启用仍 open。
|
||||
- **F12/F14/F16** 仍有效;**F13** 已由第一批关闭。
|
||||
- 下一任务:四批纠偏已全部有交付(均记**部分完成**)。**F11 已可自行推进**
|
||||
(本机有 Chrome,脚本已入库,无需外部环境);继续推进前需你定的两件事:
|
||||
① 是否把浏览器 E2E 接进 `verify.py` / 写进 `package.json`(F27);
|
||||
② 是否继续用真实浏览器把 `/experience-center`、`/prescreen-workbench` 也逐项点完(F11 剩余部分)。
|
||||
补 **F17** 仍需要你提供模型端点与调用时机。不要为了推进而把演示当验收。
|
||||
- 下一任务:四批纠偏已全部有交付(均记**部分完成**),F11 的可自行推进部分**本轮已做完**。
|
||||
剩下的都需要你或外部输入:① 是否把浏览器 E2E 接进 `verify.py` / 写进 `package.json`(F27);
|
||||
② F29/F30 的产品口径;③ F17 的模型端点与调用时机。
|
||||
不要为了推进而把演示当验收。
|
||||
- 待输入:模型端点与调用时机(F17);真实数据/制度/会议标签映射与客户身份权限(M5/M6);
|
||||
Laya 硬件与中文效果需实机探测;Jev 端点与凭据。
|
||||
- Git:本轮在 `codex/xingbang-v2-model-field-fix` 分支有 **3 个提交**,**均未推送**:
|
||||
- `f775c6c` —— `feat(v2): 纠偏第四批——会议结果录入与改进发布接真实知识发布入口`
|
||||
- `ff59d7e` —— `docs(v2): 第四批交接记录补记本轮提交号`
|
||||
- `4720d72` —— `fix(v2): 浏览器端到端验证——修掉模块页在浏览器里渲染不出内容的缺陷`
|
||||
核对命令 `git log --oneline -6`。**不在这里写死 HEAD**:交接文档自身的提交会成为新的
|
||||
HEAD,写死必然过期;以上三个是本轮的实质提交,其后可能还有仅改文档的提交。
|
||||
- Git:本轮在 `codex/xingbang-v2-model-field-fix` 分支的实质提交是
|
||||
**`c880f40`(fix:面板不刷新 + 候选行同 id 连开多行,含新脚本与 2 组源码断言)**,
|
||||
其后还有仅改文档的提交(本文件与 17)。**本轮与之前各轮一样均未推送**。
|
||||
第四批的提交仍为 `f775c6c`/`ff59d7e`/`4720d72`。核对命令 `git log --oneline -12`。
|
||||
**不在这里写死 HEAD**:交接文档自身的提交会成为新的 HEAD,写死必然过期。
|
||||
不得从旧恢复点 4d5a420 推断最新版本已备份。
|
||||
|
||||
Reference in New Issue
Block a user