docs(wiki): apply Codex review fixes to main-figure design

This commit is contained in:
2026-07-09 00:46:08 -04:00
parent 8cb1158a2d
commit 86573735aa
@@ -4,7 +4,7 @@
## 1. 目标与定位
- **用途**:论文EMNLP 2026 方向)主图,展示推理训练部分的自进化闭环;不含建树与新题生成(建树已有独立图,位于同一 Figma 文件)。
- **用途**:论文主图(目标会议存在文档分歧:CLAUDE.md=AAAI 2026ARCHITECTURE.md 与记忆=EMNLP 2026,以用户最终决定为准,不影响本图设计),展示推理训练部分的自进化闭环;不含建树与新题生成(建树已有独立图,位于同一 Figma 文件)。
- **核心叙事**:搜索 Agent 通过 推理→诊断→进化→门控 闭环自我改进;**Frozen LLM, trainable harness**——被"训练"的不是模型权重,而是版本化的 Skills+Prompts。
- **差异化**:AVP/DVD 等相关工作画的是推理期内环(agent 怎么搜视频);本图内环只是一个面板,**训练期外环是主角**。
- **审稿人一句话记忆点**:这是一个不动模型权重的 PyTorch 式训练循环。
@@ -24,6 +24,8 @@
## 3. 布局
> 下方 ASCII 草图为中文说明稿,仅示意区域关系;最终图层文字一律采用 §4/§5 的英文术语。
```
┌──────────────────────────────────────────────────────────────────┐
│ [输入] ┌──────────────┐ ┌───────────┐ ┌──────────┐ ┌──────┐ │
@@ -50,7 +52,7 @@
### 4.2 ① INFERENCEagent-controlled,图上唯一画成循环的面板)
- 树环境迷你版:L1/L2/L3 三层色带(绿/蓝/黄,复用建树图配色与缩略图)。
- Agent 内环轨迹:Thought → `search_similar``view_node``observe_frame``submit_answer`;侧边 read-skill 箭头(来自 ⑤)。
- Agent 内环轨迹:Thought → `search_similar``view_node``observe_frame``submit_answer`;侧边 `read_skill` 箭头(来自 ⑤,工具名与 `app/search/tools.py:56-58` 一致)。
- 示例结局:answer ✗(答错),输出 trace 流向 ②。
- 面板角标:*agent-controlled*;其余面板角标 *code-controlled*
@@ -66,11 +68,12 @@
- 示例 patch 片段:*"+ verify event boundary via L2 card before observe_frame"*。
- momentum 机制不单独出现(用户确认),仅隐含于锁条带。
### 4.5 ④ CE-GATE
- 菱形门 + e-process 小曲线(e 值随题数爬升,越过 `e_confirm` 虚线)
### 4.5 ④ Validation · CE-GATE
- 面板标题 **Validation · CE-Gate**:块顺序验证(`validate.py` 配对翻转 W/L)作为输入喂 e-process——图上画为"candidate vs baseline 配对小图 → e 曲线"
- e-process 小曲线:e 值随题数爬升,越过 `e_confirm` 虚线。
- 四出口:**accept (confirmed) / accept (provisional) / reject / continue**(代码中三种 reject 在图上合并,用户确认)。
- 侧挂小组件:信息阶梯(2:1 交错题序图标,标注 *info-max question ladder*)。
- accept → 写入 Store 新版本;reject → 保基线(细灰箭头)
- 侧挂小组件:信息阶梯(2:1 交错题序图标,标注 *info-max question ladder*,尺寸压小避免抢焦点
- 视觉层级:accept 主路径线最粗;reject/continue 细灰次级线
### 4.6 ⑤ Skills+Prompts Store
- v1…vN 卡片堆叠(复用建树图 Event Card 堆叠画法)+ 版本号 badge。
@@ -86,7 +89,7 @@
| ① | `model.forward()` |
| ② | `loss.backward()` |
| ③ | `optimizer.step()` |
| ④ | `grad clipping` |
| ④ | `grad clipping (validate)`(对应 CLAUDE.md 类比表中"进化 validation = grad clipping";④ 面板同时含 validate 配对翻转与 CE-Gate 判定) |
| ⑤ | `nn.Parameter` |
条带一侧放记忆点标语:*Frozen LLM, trainable harness*。
@@ -98,7 +101,7 @@
| 面板样式 | 白底、细虚线外框、顶部居中标题(沿用建树图) |
| ① | 淡绿系 · ② 淡橙红系(新增,饱和度对齐现有 pastel) · ③ 淡紫系(复用 VLM 紫) · ④ 淡蓝系 · ⑤ 白卡+badge |
| 直接复用 | 视频缩略图(candidate_a_t*)、L1/L2/L3 badge、Scene/Event/Frame Card 组件、VLM 紫块、箭头/chevron 样式 |
| 字体 | 与建树图一致(Inter);标题 22px / 正文 15-16px / 标注 12px 灰 |
| 字体 | 与建树图一致(Inter);标题 24px / 正文 16-18px / 标注最小 15px 灰(2400px 画布缩印 180mm 后 15px ≈ 1.1mm12px 过小已弃用) |
| 图层组织 | 顶层 Frame 命名 `Main Figure — Self-Evolving Loop`,五区域各一个子 Group,便于后续人工微调 |
## 7. 术语出处(代码核实)
@@ -107,11 +110,12 @@
|---|---|
| gate 四出口 accept_confirmed / accept_provisional / reject×3 / continue | `core/evolution/gate.py:57-110` |
| 归因瀑布 extraction/search/reasoning/mixeddefect vs lapse | `core/evolution/diagnose.py:910-997` |
| D1-D5 五维聚合 | `core/evolution/diagnose.py:1095-1307` |
| D1-D5 五维聚合 | `core/evolution/diagnose.py:1095-1307`D2-D5)、`1551-1563` + `2230` + `2293-2296`D1 attribution distribution |
| 信息阶梯冷启动 2:1、信息量排序 | `app/harness/gate_ladder.py:57-117` |
| rank-and-clip、protected spans、appendix/momentum 区 | `core/evolution/evolve.py:186-594``patch.py` |
| agent 工具五件套 | `app/search/tools.py:33-73` |
| 版本目录 workspace/skills/v{N} | `app/harness/store.py:28-136` |
| 块顺序验证配对翻转 W/L | `core/evolution/validate.py:12-69` |
| rank-and-clip、protected spans、appendix/momentum 区 | `core/evolution/evolve.py:186-594``core/evolution/patch.py:11-56` |
| agent 工具五件套(含 `read_skill` | `app/search/tools.py:33-73` |
| 版本目录 Store `store/skills/v{N}` / workspace 本地拷贝 | `app/harness/store.py:28-136``app/harness/workspace.py:103-108,150-152` |
## 8. 验收标准