From d53c4d3ca976901304f373366c664dc6c9b12360 Mon Sep 17 00:00:00 2001
From: Simon <simon@doorcome.cn>
Date: Fri, 2 Oct 2026 12:09:31 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20AGENT=20=C2=A727.3=20=E5=AE=BD=E8=A1=A8?=
 =?UTF-8?q?=E7=BA=A6=E5=AE=9A=EF=BC=88=E4=B8=A4=E7=AB=AF=E5=9B=BA=E5=AE=9A?=
 =?UTF-8?q?=20+=20=E6=8C=89=E9=9C=80=E6=8F=90=E7=A4=BA=20+=20=E5=88=97?=
 =?UTF-8?q?=E5=AE=BD=E5=AE=9E=E6=B5=8B=EF=BC=89?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 AGENT.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/AGENT.md b/AGENT.md
index 4e028f6..47c51af 100644
--- a/AGENT.md
+++ b/AGENT.md
@@ -849,6 +849,22 @@ factor_exposure
 - 同步接口（如 `POST /api/signals`）**没有**作业号与阶段时，如实说明「同步请求、无阶段、
   不可取消」，**禁止**合成假作业号或假进度喂给反馈组件。
 
+## 27.3 宽表：两端固定 + 按需提示，绝不"右侧被切掉"
+
+用户原话：「experiments 页面右侧内容溢出了」。实测原因不是整页溢出，而是**卡片内的横向滚动**：
+在 macOS 上覆盖式滚动条不滚动就不显示，于是看起来就是内容被切掉、也没有滚动条可拉。因此宽表：
+
+- 列数 ≥ 9 或列宽会随数据增长的表（实验列表 `.tbl--wide`、对比表 `.tbl--pin-first`、
+  月度收益表 `.tbl--monthly`）必须**固定首列**；操作列在右端时用 `.tbl--wide` 固定右端，
+  保证任何窗口宽度下「看的是哪一行」和「能点哪里」都在视野内；
+- 固定列必须有不透明底色（卡片是渐变，取近似纯色）并覆盖 `:hover` / `.row-active`，
+  否则中间列会从下面透出来、整行高亮在两端断开；
+- 列宽按**实测单行内容宽度**定（用 CDP 量 `scrollWidth` 与单元格内容宽度），不要凭感觉写，
+  并且**不要在 JSX 里写行内 `width`**——它会盖掉 CSS（曾让「操作」列多占 88px，整表放不下）；
+- 「可横向滚动」提示只在实测 `scrollWidth > clientWidth` 时出现（`useTableScrollHint`），
+  窗口够宽时不显示废话；
+- 门禁：`python3 scripts/verify_ui_alignment.py`（160 项）必须 0 失败，含 375px 与 1500px 两档。
+
 ---
 
 # 28. AI Agent 约束