@teamix-evo/skills 0.11.0 → 0.12.0

package/src/teamix-evo-design-opentrek/pages/list-page/SKILL.md

@@ -2,12 +2,14 @@
 name: page-rule-list
 parent: page-rule-system
 description: >
-  列表页(PageType: ListPage)路由规则。根据子类型识别关键词，路由到 patterns/ 目录下对应详细规则。
-  共享规则在 _shared/ 目录（表格列元规则 / 操作列规范 / 状态-操作模式）。
+  列表页(PageType: ListPage)完整规则。涵盖通用规则（padding/嵌套/操作列/状态-操作模式）+
+  DataTable 子类型变体（standard/l2-sidebar/expandable/drawer/advanced-filter 内联）+
+  卡片子类型路由到 patterns/card-list.md。
+  OpenTrek 标准列表业务规则路由到 patterns/standard-list-opentrek.md（Tab 导航/查询面板/列类型/操作列模式）。
   产品配置在 products/{产品}/ 目录（列定义 / 状态机 / 业务映射）。
   三层参数化架构（v7.0）：元规则（固化）+ 产品配置（灵活）+ 模式细节。
   触发：需要列表页规则、匹配列表页模板、生成列表页。
-  Version: 7.8.4
+  Version: 7.10
 ---
 
 # 列表页路由规则
@@ -24,16 +26,17 @@ description: >
 
 | 子类型ID | 识别关键词 | 路由到 | 布局模式 | 核心组件 |
 |----------|-----------|--------|----------|----------|
-| standard | "列表"/"表格"/"查询" | → `patterns/standard-list.md` | 模式D | DataTable + Pagination |
-| l2-sidebar | "分类"/"分组"/"左侧树" | → `patterns/l2-sidebar-list.md` | 模式D + Sidebar | Sidebar(240px) + DataTable |
-| expandable | "展开"/"子项"/"详情" | → `patterns/expandable-list.md` | 模式D | DataTable(行内展开) |
-| drawer | "弹窗列表"/"选择器" | → `patterns/drawer-list.md` | 模式D (Sheet内) | DataTable ⊂ Sheet |
+| standard | "列表"/"表格"/"查询" | → `patterns/standard-list.md`；OpenTrek 业务规则 → `patterns/standard-list-opentrek.md` | 模式D | DataTable + Pagination |
+| l2-sidebar | "分类"/"分组"/"左侧树" | → 本文件 §8.1 | 模式D + Sidebar | Sidebar(240px) + DataTable |
+| expandable | "展开"/"子项"/"详情" | → 本文件 §8.2 | 模式D | DataTable(行内展开) |
+| drawer | "弹窗列表"/"选择器" | → 本文件 §8.3 | 模式D (Sheet内) | DataTable ⊂ Sheet |
 | **pure-card** | "纯卡片"/"卡片管理"/"智能体列表" | → `patterns/card-list.md` | 模式A-CARD | CardGrid + ItemCard + CardActionBar |
 | **standard-card** | "卡片列表"/"分类卡片"/"资源卡片" | → `patterns/card-list.md` | 模式D-CARD (TWO_COL) | Sidebar + CardGrid + ItemCard + CardActionBar |
 | **view-toggle** | "视图切换"/"列表卡片切换" | → `patterns/card-list.md` | 模式D + ViewToggle | ViewToggle + CardGrid/DataTable + ItemCard(tile) |
-| advanced-filter | "高级筛选"/"更多条件" | → `patterns/advanced-filter-list.md` | 模式D+ | AdvancedFilterPanel + DataTable |
+| advanced-filter | "高级筛选"/"更多条件" | → 本文件 §8.4 | 模式D+ | AdvancedFilterPanel + DataTable |
 
 > **v7.2 合并**：原 `pure-card-list.md` / `standard-card-list.md` / `view-toggle-list.md` 三个 patterns 合并为单一 `patterns/card-list.md`，子类型差异在其 §1 差异矩阵中区分。
+> **v7.10 新增**：OpenTrek 标准列表业务规则 `patterns/standard-list-opentrek.md`，涵盖 Tab 导航/查询面板/列类型/操作列模式/状态驱动操作等 OpenTrek 平台特有规则。
 
 ### 路由判定优先级
 
@@ -223,20 +226,376 @@ Card 白卡容器：`padding: 0 var(--card-padding-x)` （上下 0 / 左右 20px
 
 ---
 
-## 6. 共享规则引用
+## 6. 操作列规范
 
-以下规范为多个子类型共用，提取到 `_shared/` 目录：
+> 适用于 standard / l2-sidebar / expandable / drawer / advanced-filter / view-toggle（列表视图）子类型。
+
+### 操作列结构
+
+操作列包含 3 个主要操作 + 1 个"更多"入口，以分隔线区分：
+
+| 元素 | 样式 | 条件 | 禁用样式 |
+|------|------|------|---------|
+| 主操作(管理/查看) | 链接样式 | 始终可用 | — |
+| 分隔线 | \| | — | — |
+| 次要操作(远程连接等) | 文字按钮 | 特定状态时 disabled | `opacity: 0.45; pointer-events: none` |
+| 分隔线 | \| | — | — |
+| 状态操作(实例状态▾) | 下拉按钮 | 特定状态时 disabled | `opacity: 0.45; pointer-events: none` |
+| 分隔线 | \| | — | — |
+| 更多操作 | "..."下拉菜单 | 始终可用 | — |
+
+### 操作列行为
+
+| 操作 | 触发方式 | 前置条件 | 二次确认 | 目标页面/组件 | 返回行为 |
+|------|----------|---------|---------|-------------|----------|
+| 查看/管理 | 点击链接 | 无 | 否 | DetailPage | 返回列表页, 保持筛选+分页状态 |
+| 编辑 | 点击按钮 | 无 | 否 | FormPage 或 Sheet | 保存后返回列表, Sonner "保存成功" |
+| 删除 | 点击按钮 | 实例已停止 | 是 (Dialog确认) | Dialog确认弹窗 | 确认后刷新列表, Sonner "删除成功" |
+| 更多 | Dropdown | 无 | 否 | 下拉菜单 | 选择操作 |
+
+### 禁用样式
+
+所有 disabled 元素统一样式：
+```css
+opacity: 0.45;
+pointer-events: none;
+```
+
+### 操作列水平对齐【硬约束】
+
+操作列位于表格末列，**表头与表体均需显式 `text-align: left`**：
+
+```css
+.data-table .col-action {
+  width: 140px;
+  text-align: left;
+  position: sticky; right: 0;
+  background: hsl(var(--card));
+}
+.data-table thead th.col-action { background: hsl(var(--gray-bg)); text-align: left; }
+.data-table tbody td.col-action { text-align: left; }
+```
+
+- ❌ 禁止只在 `.col-action` 上设 `text-align: left` 而不在 th/td 重复声明
+- ❌ 禁止操作列内容居中
+- **验证**：表头「操作」左边缘 X = 表体「详情」链接左边缘 X
+
+---
+
+## 7. 状态-操作模式
+
+> 适用于所有产品线的列表页。本产品特有状态机定义见 `products/{产品}/states.json`。
+
+### 元规则
+
+| 规则 | 说明 |
+|------|------|
+| 每个状态必须定义操作可用性 | 明确标注每个操作在该状态下是否可用 |
+| 禁用操作必须使用统一样式 | `opacity: 0.45; pointer-events: none` |
+| 混合状态时批量操作按钮禁用 | 不同状态的行选中时，hover 提示不可用原因 |
+| 异步操作必须提供反馈 | Sonner 提示 + 列表刷新机制 |
+| 操作确认按影响级别分级 | 一级(可逆直接执行) / 二级(影响状态Dialog确认) / 三级(不可逆输入确认) |
+
+### 异步操作处理
+
+| 操作类型 | 触发后行为 | 反馈方式 | 列表刷新 |
+|---------|-----------|---------|---------|
+| 状态变更操作 | 异步任务, 不阻塞 | Sonner "操作已提交" | 轮询状态或任务完成通知 |
+| 删除操作 | 异步任务 | Sonner "删除已提交" | 移除对应行或刷新列表 |
+| 批量操作 | 异步任务 | Sonner "批量操作已提交, 共N条" | 轮询状态 |
+| 创建操作 | 同步跳转 | 跳转 FormPage | 创建成功后返回列表 |
+
+### 操作确认规范
+
+| 确认级别 | 确认方式 | 适用操作 |
+|---------|---------|---------|
+| 一级 (可逆) | 无确认, 直接执行 | 查看、编辑、远程连接 |
+| 二级 (影响状态) | Dialog确认弹窗 | 启动、停止、重启等状态变更 |
+| 三级 (不可逆) | Dialog + 输入确认文本 | 删除 (需输入确认文本) |
+
+### 页面间导航交互
+
+| 来源操作 | 目标页面 | 导航方式 | 返回/交互约定 |
+|---------|---------|---------|-------------|
+| 操作列"管理/查看" | 详情页 (DetailPage) | 页面跳转 | Breadcrumb+PageHeader 返回入口; 保持筛选+分页 |
+| 操作列"编辑" | 表单页 (FormPage) 或 Sheet | 页面跳转/侧滑 | 保存后返回列表, Sonner 提示; 取消返回列表 |
+| 创建操作 | 创建页 (FormPage) | 页面跳转 | 创建成功/取消后返回列表 |
+| 搜索执行 | 当前列表页(刷新) | 数据刷新 | 保持分页在第1页 |
+| 筛选条件变更 | 当前列表页(刷新) | 数据刷新 | 重置到第1页, 保持筛选条件 |
+
+### 反馈机制
+
+| 场景 | 反馈类型 | 持续时间 | 说明 |
+|------|---------|---------|------|
+| 操作成功 | Sonner 成功提示 | 3s | "操作成功" |
+| 操作失败 | Sonner 错误提示 | 5s | 含错误原因 |
+| 异步任务 | 通知中心 + Sonner | 持久 | 任务完成时通知 |
+| 加载中 | 表格行 Skeleton / Spinner | 至加载完成 | 首次加载/筛选加载 |
+| 空数据 | Empty | 持久 | 含创建引导按钮 |
+
+---
+
+## 8. DataTable 子类型变体规则
+
+> 以下四种子类型均基于 `patterns/standard-list.md` 标准列表的完整结构（PageHeader + ActionToolbar + DataTable + BulkActionBar + Pagination），仅记录差异点。
+> DataTable、Pagination、ActionToolbar 等通用组件行为见 standard-list.md，不再重复。
+
+### 8.1 L2 导航列表 (l2-sidebar)
+
+> 布局模式: 模式D + Sidebar(TWO_COL) | 核心差异: 左侧 240px 分类导航 + 右侧标准列表
+
+#### 布局骨架
+
+```
+┌──────────┬──────────────────────────────────────────────┤
+│          │  PageHeader + ActionToolbar + DataTable      │
+│  Sidebar │  + BulkActionBar + Pagination                │
+│ (240px)  │  (同标准列表页完整结构)                        │
+│          │                                              │
+│ [分类A]  │                                              │
+│ [分类B]  │                                              │
+│ [分类C]  │                                              │
+│ ──       │                                              │
+│ [子分类] │                                              │
+└──────────┴──────────────────────────────────────────────┘
+```
+
+#### 核心差异
+
+| 维度 | 标准列表 | L2 导航列表 |
+|------|----------|-------------|
+| 布局 | SINGLE_COL / TWO_COL | **TWO_COL** |
+| Sidebar | 可选 | **必需** |
+
+> Sidebar 收起/展开、交互规范、色彩全部引用 `rules/design-tokens.json` sidebarRules。
+
+#### Sidebar 交互规范
+
+| 交互 | 行为 |
+|------|------|
+| 点击分类 | 刷新右侧列表数据，保持当前页码 |
+| 展开/收起 | 切换子分类列表，动画过渡 |
+| 收起 Sidebar | 宽度缩至 68px，仅显示图标 |
+| 选中态 | 灰色背景 `var(--sidebar-active)` |
+| 手风琴 | 打开一个分组自动关闭其他分组 |
+| 收起态 Tooltip | Hover 显示节点名称 |
+| 展开持久化 | 展开/收起状态持久化 |
+| 计数徽章 | 每项右侧显示数据量（灰色 12px） |
+| 状态指示灯 | 菜单项前圆点(8px)+文字，颜色对应状态 |
+| 约束 | 最大 20 项 / 最大 2 级嵌套 |
+
+#### 验证差异项
+
+| 验证项 | 检查点 | 目标 |
+|--------|--------|------|
+| Sidebar 规格 | 展开240px / 收起68px | 正确 |
+| 分类选中态 | 灰色背景 `var(--sidebar-active)` | 正确 |
+| 分类切换 | 右侧列表刷新 | 正确 |
+| 计数徽章 | 每项右侧灰色 12px | 正确 |
+| 状态指示灯 | 圆点(8px)+文字，颜色对应状态 | 正确 |
+
+---
+
+### 8.2 可展开列表 (expandable)
+
+> 布局模式: 模式D | 核心差异: DataTable 行内展开显示子数据/详情
+
+#### 布局骨架
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  PageHeader + ActionToolbar (同标准列表页)                             │
+│  ──┬──────────────────────────────────────────────────────────┬──│
+│     DataTable (行内展开)                                         │
+│  ☑|ID|名称|状态|标签|...|操作                                    │
+│  ▶|i-xxx|test|●运行中|🏷|...|管理|...                           │
+│    ┌─────────────────────────────────────────────────────┐      │
+│    │ 子项1: 详情A | 详情B | 详情C                          │      │
+│    │ 子项2: 详情D | 详情E                                 │      │
+│    └─────────────────────────────────────────────────────┘      │
+│  ▶|i-yyy|prod|●运行中|🏷|...|管理|...                           │
+│  ─────────────────────────────────────────────────────────────  │
+│  BulkActionBar + Pagination (同标准列表页)                            │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+#### 核心差异
+
+| 维度 | 标准列表 | 可展开列表 |
+|------|----------|-----------|
+| 行展开 | 不支持 | **支持** |
+| 展开触发 | — | **点击行首展开图标(▶) 或 点击行** |
+| 展开方式 | — | **行内展开，不弹出 Dialog/Sheet** |
+| 展开高度 | — | **自适应，最大高度 200px** |
+| 展开状态持久化 | — | **翻页后保持展开状态** |
+
+#### 行内展开交互规范
+
+| 交互 | 行为 |
+|------|------|
+| 点击展开图标(▶) | 展开/收起该行，展开图标变为 ▼ |
+| 点击行(非操作区) | 同展开图标，切换展开状态 |
+| 同时展开 | 支持多行同时展开 |
+| 展开内容 | 子数据表格 / 详情描述列表 / 关联信息 |
+| 收起所有 | 提供"收起全部"按钮(可选) |
+| 翻页行为 | 展开状态持久化，翻回原页时保持 |
+
+#### 验证差异项
+
+| 验证项 | 检查点 | 目标 |
+|--------|--------|------|
+| 展开图标 | ▶/▼ 切换正确 | 正确 |
+| 行内展开 | 不弹出新窗口/Dialog | 正确 |
+| 多行展开 | 支持同时展开多行 | 正确 |
+| 翻页持久化 | 翻回原页时展开状态保持 | 正确 |
+
+---
+
+### 8.3 抽屉中列表 (drawer)
+
+> 布局模式: 模式D (Sheet 内) | 核心差异: 列表嵌入 Sheet，用于选择关联数据
+
+#### 布局骨架
+
+```
+┌──────────────────────────────────────────────────────────────────┐
+│  主页面内容 (ListPage / FormPage / DetailPage)                        │
+│  ...                                                              │
+│  ┌───────────────────────────────────────────┐                    │
+│  │  Sheet (右侧滑出, 宽度 600-900px)         │                    │
+│  │  ┌───── SheetHeader ──────────────────┐ │                    │
+│  │  │ 选择关联实例              [× 关闭]    │ │                    │
+│  │  ├─────────────────────────────────────┤ │                    │
+│  │  │  ActionToolbar (SearchCombo 等)     │ │                    │
+│  │  │  DataTable (含选择框)                │ │                    │
+│  │  │  Pagination                         │ │                    │
+│  │  ├─────────────────────────────────────┤ │                    │
+│  │  │  [取消]  [确定] (底部操作栏)         │ │                    │
+│  │  └─────────────────────────────────────┘ │                    │
+│  └───────────────────────────────────────────┘                    │
+└──────────────────────────────────────────────────────────────────┘
+```
+
+#### 核心差异
+
+| 维度 | 标准列表 | 抽屉中列表 |
+|------|----------|-----------|
+| 容器 | PageContainer | **Sheet** |
+| 触发方式 | 直接访问 URL | **点击按钮/链接打开 Sheet** |
+| 选择返回 | 跳转页面 | **选择后点击确定关闭 Sheet，返回选中数据** |
+| 宽度 | 全宽/自适应 | **固定宽度 (600-900px)** |
+| 关闭方式 | 浏览器返回/面包屑 | **点击 × / 遮罩层 / Esc** |
+| 底部操作栏 | 无 | **必需 [取消] [确定]** |
+
+#### Sheet 交互规范
+
+| 交互 | 行为 |
+|------|------|
+| 打开 Sheet | 点击触发按钮，从右侧滑出，宽度 600-900px |
+| 选择数据 | 勾选选择框，支持单选/多选(由业务决定) |
+| 确认选择 | 点击"确定"关闭 Sheet，返回选中数据到主页面 |
+| 取消选择 | 点击"取消"关闭 Sheet，不返回数据 |
+| 关闭 Sheet | 点击 × / 遮罩层 / Esc，丢弃未确认的选择 |
+| 搜索/筛选 | 在 Sheet 内执行，不跳转页面 |
+| 分页 | 在 Sheet 内分页，不影响主页面 |
+
+> 操作列中"管理/查看"等页面跳转操作在抽屉中通常禁用或隐藏。
+
+#### 验证差异项
+
+| 验证项 | 检查点 | 目标 |
+|--------|--------|------|
+| Sheet 滑出 | 右侧滑出，宽度 600-900px | 正确 |
+| 遮罩层 | 半透明遮罩，点击关闭 | 正确 |
+| 选择反馈 | 选中行高亮 | 正确 |
+| 确定/取消 | 确定返回数据，取消丢弃 | 正确 |
+| Esc 关闭 | Esc 关闭 Sheet | 正确 |
+
+---
+
+### 8.4 高级筛选列表 (advanced-filter)
+
+> 布局模式: 模式D+ | 核心差异: 可展开的高级筛选面板 + 多条件组合
+
+#### 布局骨架
+
+```
+┌──────────┬──────────────────────────────────────────────┤
+│  Sidebar │  PageHeader: 标题(18px/medium)                   │
+│          │  ActionToolbar: [创建] + [搜索🔍] [高级筛选▾]    │
+│          │  ┌─── AdvancedFilterPanel ───────────────┐   │
+│          │  │ 条件1: [Select] [Input]               │   │
+│          │  │ 条件2: [Select] [Input]               │   │
+│          │  │ 条件3: [Select] [Input]               │   │
+│          │  │              [确认] [清空]              │   │
+│          │  └───────────────────────────────────────┘   │
+│          │  DataTable + BulkActionBar + Pagination       │
+└──────────┴──────────────────────────────────────────────┘
+```
+
+#### 核心差异
+
+| 维度 | 标准列表 | 高级筛选列表 |
+|------|----------|-------------|
+| 筛选方式 | SearchCombo | **SearchCombo + AdvancedFilterPanel** |
+| 筛选条件数 | 1个维度 | **多条件组合（通常2-5个）** |
+| AdvancedFilterPanel | 无 | **必需** |
+| FilterTag | 可选 | **必需**（展示已选条件） |
+
+#### AdvancedFilterPanel 交互规范
+
+| 交互 | 行为 |
+|------|------|
+| 打开面板 | 点击"高级筛选"按钮，展开面板 |
+| 关闭面板 | 收起面板，恢复基础 SearchCombo |
+| 添加条件 | 点击"添加条件"，新增一行筛选条件 |
+| 删除条件 | 点击条件行右侧 ×，移除该条件 |
+| 条件间关系 | **AND 关系**（所有条件同时生效） |
+| 确认筛选 | 点击"确认"，应用所有条件，刷新列表 |
+| 清空筛选 | 点击"清空"，清除所有条件 |
+| 面板位置 | ActionToolbar 下方，DataTable 上方 |
+
+#### FilterTag 管理
+
+- 已选筛选项以 **FilterTag** 形式展示在 ActionToolbar 区域
+- 每个 FilterTag 可单独移除（点击 ×）
+- 筛选条件清空后，FilterTag 区域隐藏（display: none）
+- 支持"清空全部"操作
+
+#### 与 PageContainer 模式对照
+
+高级筛选列表使用 **模式D+**：
+```
+PageContainer → ContentWrapper → PageHeader + ActionToolbar + AdvancedFilterPanel(可展开) + DataTable + BulkActionBar + Pagination
+```
+
+#### 验证差异项
+
+| 验证项 | 检查点 | 目标 |
+|--------|--------|------|
+| AdvancedFilterPanel | 展开/收起正常 | 正确 |
+| 多条件组合 | AND 关系 | 正确 |
+| 条件添加/删除 | 增删条件行正常 | 正确 |
+| 确认/清空 | 确认后刷新，清空后恢复 | 正确 |
+| FilterTag | 展示已选条件，可单独移除 | 正确 |
+
+---
+
+## 9. 共享规则引用
+
+以下规范为多个子类型共用，保持独立文件：
 
 | 共享规则 | 路径 | 被引用子类型 |
 |----------|------|-------------|
 | 表格列元规则 | `_shared/column-meta-rules.md` | standard, l2-sidebar, expandable, drawer, view-toggle（列表视图） |
-| 操作列规范 | `_shared/action-column-spec.md` | standard, l2-sidebar, expandable, drawer, view-toggle（列表视图） |
-| 状态-操作模式 | `_shared/state-action-pattern.md` | standard, l2-sidebar, expandable, drawer, pure-card, standard-card, view-toggle |
-| 业务卡片三件套规格（v7.3 下沉） | `patterns/card-list.md` §9（ItemCard/CardGrid/CardActionBar 完整规格） | pure-card, standard-card, view-toggle（均路由到 patterns/card-list.md） |
+| SearchCombo 规范 | `_shared/search-combo-spec.md` | 全部子类型 |
+| 业务卡片三件套规格 | `_shared/item-card-spec.md` | pure-card, standard-card, view-toggle |
 
-子类型文件按需要引用对应共享文件。
+> v7.9 变更：操作列规范（原 `_shared/action-column-spec.md`）和状态-操作模式（原 `_shared/state-action-pattern.md`）已合并到本文件 §6、§7。
 
-## 7. 产品配置引用
+---
+
+## 10. 产品配置引用
 
 > 具体列定义、状态机、业务场景按产品隔离，存放在 `products/{产品}/` 目录。
 > AI 读取时需根据目标产品加载对应配置文件。
@@ -246,13 +605,13 @@ Card 白卡容器：`padding: 0 var(--card-padding-x)` （上下 0 / 左右 20px
 | ECS | `products/ecs/columns.json` | `products/ecs/states.json` | `products/ecs/mapping.json` |
 | PolarDB | `products/polar-db/columns.json` | `products/polar-db/states.json` | `products/polar-db/mapping.json` |
 | Cloud-Catalog | `products/cloud-catalog/columns.json` | `products/cloud-catalog/states.json` | — |
-| AI Gateway | `products/ai-gateway/columns.json` | `products/ai-gateway/states.json` | `products/ai-gateway/mapping.json` + `cards.json`（v7.2 新增，卡片视图 slot 绑定） |
+| AI Gateway | `products/ai-gateway/columns.json` | `products/ai-gateway/states.json` | `products/ai-gateway/mapping.json` + `cards.json` |
 
 **读取规则**：
 1. 根技能确定页面类型 → Phase ①
 2. 子技能匹配子类型 → Phase ②
 3. 根据目标产品加载 `products/{产品}/` 下对应配置文件 → Phase ②.5
-4. 元规则（列应该有显隐规则/拖拽/排序） + 产品配置（具体列名/宽度/状态） → Phase ③ 生成 HTML
+4. 元规则 + 产品配置 → Phase ③ 生成 HTML
 
 ---
 
@@ -260,27 +619,39 @@ Card 白卡容器：`padding: 0 var(--card-padding-x)` （上下 0 / 左右 20px
 
 - **读取路径**：见根技能 `../../SKILL.md` §4.5 四阶段读取决策树
   - 阶段①：`page-types.json` + `business-mapping.json`
-  - 阶段②：`page-frame.json` + `layout-rules.json` + `page-flow.json` + `_shared/search-combo-spec.md`；卡片子类型 (pure-card / standard-card / view-toggle) 追加读取 `patterns/card-list.md`（v7.3 起为三件套唯一规范来源）
-  - 阶段②.5：`products/{产品}/columns.json` + `states.json`（v6.2 新增）
+  - 阶段②：`page-frame.json` + `layout-rules.json` + `page-flow.json` + `_shared/search-combo-spec.md`；卡片子类型追加读取 `patterns/card-list.md`；OpenTrek 标准列表追加读取 `patterns/standard-list-opentrek.md`
+  - 阶段②.5：`products/{产品}/columns.json` + `states.json`
   - 阶段③（生成 HTML 时）：`design-tokens.json` + `design-tokens.css` + `styling.json` + `../../boundaries.md` + `../../foundations.md`
 
-> `rules/design-tokens.css` 是设计 Token 的唯一真相源（:root 变量定义）：生成 HTML 原型时需将 :root 变量块嵌入页面 `<style>` 标签；生成 React/TSX 需确保项目已通过 `@import` 引入该 CSS 文件。
+> `rules/design-tokens.css` 是设计 Token 的唯一真相源（:root 变量定义）。
 
 ---
 
 ## 验证清单 (Validation Checklist)
 
-> **通用检查项**（布局分区/颜色Token/间距/字体/尺寸/禁用样式/异步操作/空数据/加载中）见根技能 `../../docs/validation-workflow.md` 验证清单。此处仅列出列表页特有检查项。
+> **通用检查项**（布局分区/颜色Token/间距/字体/尺寸/禁用样式/异步操作/空数据/加载中）见根技能 `../../docs/validation-workflow.md`。
+
+### 通用检查项（所有 DataTable 子类型）
 
 | 检查项 | 检查点 | 目标 |
 |--------|--------|------|
 | 嵌套结构 | PageContainer → ContentWrapper → Card(白卡容器) → PageHeader/ActionToolbar/DataTable/Pagination | 100% |
-| Card 内统一左右内边距 | PageHeader/ActionToolbar/DataTable/Pagination 在 Card 内左右 padding 均为 24px | 100% |
-| 必需组件 | PageHeader、ActionToolbar、Pagination + 子类型组件（DataTable/CardGrid） | 100% |
+| Card 内左右对齐 | 非 Table 组件 padding = 0（由 Card.paddingX 20px 提供）；Table 首末列 paddingX = 20px | 100% |
+| 必需组件 | PageHeader、ActionToolbar、Pagination + 子类型组件 | 100% |
 | 禁止组件 | 无内联编辑、拖拽排序、无限滚动、悬浮操作栏、右键菜单 | 0 个 |
-| 子类型组件 | 按子类型路由到正确组件（DataTable 或 CardGrid） | 正确 |
-| 操作可用性 | 状态-操作矩阵匹配 | 所有状态正确 |
+| 操作可用性 | 状态-操作矩阵匹配（§7） | 所有状态正确 |
 | 二次确认 | 启动/停止/重启 Dialog确认，删除需输入确认 | 正确 |
 | 批量操作 | 选中≥1行显示、混合状态禁用、异步处理 | 正确 |
 | 搜索交互 | 回车执行、下拉切换维度、FilterTag 展示 | 正确 |
 | 分页 | 默认条数、保持筛选、"共N条" | 正确 |
+| 操作列对齐 | 表头/表体均 `text-align: left`（§6） | 正确 |
+
+### 子类型差异验证（仅适用于对应子类型）
+
+| 子类型 | 额外验证项 |
+|--------|-----------|
+| l2-sidebar (§8.1) | Sidebar 240px/68px、分类选中态、计数徽章 |
+| expandable (§8.2) | ▶/▼ 展开图标、行内展开不弹窗、多行展开、翻页持久化 |
+| drawer (§8.3) | Sheet 600-900px、遮罩关闭、确定/取消返回数据、Esc 关闭 |
+| advanced-filter (§8.4) | 面板展开/收起、AND 条件、FilterTag 可移除 |
+