@teamix-evo/skills 0.12.1 → 0.13.0

package/src/teamix-evo-design-opentrek/pages/detail-page/patterns/comparison-detail.md

@@ -3,7 +3,7 @@
 > 路由自 `../SKILL.md`
 > 布局模式: 模式B
 > 核心组件: PageHeader(面包屑) + 双栏/多栏 DescriptionList
-> PageHeader 规范: `../../../rules/page-header-spec.md`
+> PageHeader 规范: `../../../rules/common-components.json` → PageHeader
 
 ---
 
@@ -20,11 +20,7 @@
 ## 3. 标准布局骨架
 
 ```
-PageContainer
-  ↓
-ContentWrapper
-  ↓
-Card(白卡容器)
+PageShell → OpSidebar + OpPageContainer
   ├─ PageHeader (面包屑模式)
   │  └─ 配置管理 > 版本对比
   │     [应用版本B] [返回]
@@ -94,7 +90,7 @@ Card(白卡容器)
 
 | 验证项 | 检查点 | 目标 |
 |--------|--------|------|
-| PageHeader | 面包屑模式合规（见 `rules/page-header-spec.md`） | 15 项全部通过 |
+| PageHeader | 面包屑模式合规（见 `common-components.json` → PageHeader.generationChecklist） | 16 项全部通过 |
 | 双栏对齐 | 两栏宽度相等，字段名对齐 | 正确 |
 | 差异高亮 | 变更项有明确视觉标识 | 正确 |
 | 仅差异视图 | Toggle 后隐藏相同项 | 正确 |

package/src/teamix-evo-design-opentrek/pages/detail-page/patterns/monitor-detail.md

@@ -3,7 +3,7 @@
 > 路由自 `../SKILL.md`
 > 布局模式: 模式B + C 组合
 > 核心组件: MetricCard + ChartPanel + AlertList + TimeRangeSelector
-> PageHeader 规范: `../../../rules/page-header-spec.md`
+> PageHeader 规范: `../../../rules/common-components.json` → PageHeader
 
 ---
 
@@ -22,11 +22,7 @@
 ## 3. 标准布局骨架
 
 ```
-PageContainer
-  ↓
-ContentWrapper
-  ↓
-Card(白卡容器)
+PageShell → OpSidebar + OpPageContainer
   ├─ PageHeader (面包屑模式)
   │  └─ 实例管理 > 实例详情 > 监控
   │     [TimeRangeSelector] [⟳ 刷新]
@@ -181,7 +177,7 @@ Card(白卡容器)
 
 | 验证项 | 检查点 | 目标 |
 |--------|--------|------|
-| PageHeader | 面包屑模式合规（见 `rules/page-header-spec.md`） | 15 项全部通过 |
+| PageHeader | 面包屑模式合规（见 `common-components.json` → PageHeader.generationChecklist） | 16 项全部通过 |
 | MetricCard 横排 | grid 4列布局，gap 12px | 正确 |
 | TimeRangeSelector | PageHeader 右侧，SegmentedControl 样式 | 正确 |
 | ChartPanel Grid | 2×2 网格，gap 16px | 正确 |

package/src/teamix-evo-design-opentrek/pages/detail-page/patterns/resource-detail.md

@@ -3,7 +3,7 @@
 > 路由自 `../SKILL.md`
 > 布局模式: 模式B + C 组合（Card 分组 + Tabs 分组）
 > 核心组件: PageHeader(面包屑) + InfoCard + DescriptionList + Tabs
-> PageHeader 规范: `../../../rules/page-header-spec.md`
+> PageHeader 规范: `../../../rules/common-components.json` → PageHeader
 
 ---
 
@@ -19,12 +19,12 @@
 - DescriptionList 结构化键值对展示
 - 操作按钮组（编辑/删除/续费/更多）
 
-## 3. 标准布局骨架（含 Sidebar）
+## 3. 标准布局骨架（含 OpSidebar）
 
 ```
 ┌──────────┬──────────────────────────────────────────────┐
-│          │  PageContainer                               │
-│  Sidebar │  ┌─ Card(白卡容器) ───────────────────────┐ │
+│          │  OpPageContainer                             │
+│ OpSidebar│  ┌─ 内置白卡 ──────────────────────────────┐ │
 │          │  │  PageHeader (仅面包屑，禁止标题)        │ │
 │          │  │  实例与镜像 > 实例列表 > 实例详情        │ │
 │          │  │            [创建镜像] [续费] [更多] [×]  │ │
@@ -48,11 +48,11 @@
 └──────────┴──────────────────────────────────────────────┘
 ```
 
-## 4. 简洁模式（无 Sidebar）
+## 4. 简洁模式（无 OpSidebar）
 
 ```
 ┌─────────────────────────────────────────────────────────┐
-│  ┌─ Card(白卡容器) ──────────────────────────────────┐  │
+│  ┌─ OpPageContainer ────────────────────────────────────┐  │
 │  │  PageHeader (仅面包屑，禁止标题)                    │  │
 │  │  用户列表 > 张三                  [编辑] [删除]    │  │
 │  │  DescriptionList (column: 2)                        │  │
@@ -123,15 +123,15 @@
 | Tabs → TabPane → DescriptionList | ✅ ALLOW | Tab 内展示详情 |
 | Tabs → TabPane → DataTable | ✅ ALLOW | Tab 内展示关联资源列表 |
 
-## 9. 与 PageContainer 模式对照
+## 9. 与 OpPageContainer 模式对照
 
 资源详情页使用 **模式B（Card 分组）+ 模式C（Tabs 分组）组合**：
 ```
-PageContainer → ContentWrapper → Card → PageHeader(面包屑模式) + InfoCard + Tabs → TabPane[DescriptionList]
+PageShell → OpSidebar + OpPageContainer → PageHeader(面包屑模式) + InfoCard + Tabs → TabPane[DescriptionList]
 ```
 简洁详情页退化为 **模式B**：
 ```
-PageContainer → ContentWrapper → Card → PageHeader(面包屑模式) + DescriptionList
+PageShell → OpSidebar + OpPageContainer → PageHeader(面包屑模式) + DescriptionList
 ```
 
 ## 10. 验证清单
@@ -140,7 +140,7 @@ PageContainer → ContentWrapper → Card → PageHeader(面包屑模式) + Desc
 
 | 验证项 | 检查点 | 目标 |
 |--------|--------|------|
-| PageHeader | 面包屑模式合规（见 `rules/page-header-spec.md`） | 15 项全部通过 |
+| PageHeader | 面包屑模式合规（见 `common-components.json` → PageHeader.generationChecklist） | 16 项全部通过 |
 | InfoCard 表面 | 独立 Card 模式跟随 v7.6；嵌入模式仅 padding + border-bottom | 正确 |
 | ChartPanel | 资源页嵌入监控图表时遵循 monitor-detail.md §9 规格 | 正确 |
 | DescriptionList | 列数(默认2)、字段截断+Tooltip、空值"-"占位 | 正确 |

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

@@ -42,12 +42,12 @@ description: >
 | 属性 | 值 | 说明 |
 |------|-----|------|
 | layout.type | SINGLE_COL / GRID | 简单表单 SINGLE_COL，多列表单 GRID |
-| layout.frame | L2 | 表单页为 L2 级页面，自动继承 Sidebar（含Logo+产品名），PageHeader 使用面包屑基础组件模式 |
+| layout.frame | L2 | 表单页为 L2 级页面，自动继承 OpSidebar（含Logo+产品名），PageHeader 使用面包屑基础组件模式 |
 | responsive | Desktop: 单列/多列, Tablet: 单列, Mobile: 不推荐 |
 | form.layout | SINGLE_COL(默认), TWO_COL(多字段), SECTION(分区) |
 | submit.position | bottom | flex 布局，所有行动点居右排列（justify-content: flex-end），按钮从左到右顺序：取消 → 上一步（如有）→ 下一步/提交 |
 
-> **框架组件自动继承**：Sidebar、Breadcrumb 由 `rules/page-frame.json` 统一管理，L2 级页面自动包含。弹窗表单（Dialog/FormPage）为 L0 级，无框架组件。
+> **框架组件自动继承**：OpSidebar、Breadcrumb 由 `rules/page-frame.json` 统一管理，L2 级页面自动包含。弹窗表单（Dialog/FormPage）为 L0 级，无框架组件。
 
 ## 4. 标准布局骨架
 
@@ -55,7 +55,7 @@ description: >
 
 ```
 ┌─────────────────────────────────────────────────────────┐
-│  ┌─ Card(白卡容器) ──────────────────────────────────┐  │
+│  ┌─ OpPageContainer ────────────────────────────────────┐  │
 │  │  PageHeader (面包屑模式)
 │  │   新建实例                                │  │
 │  │  Form (SINGLE_COL)                                   │  │
@@ -99,7 +99,7 @@ description: >
 
 ```
 ┌─────────────────────────────────────────────────────────┐
-│  ┌─ Card(白卡容器) ──────────────────────────────────┐  │
+│  ┌─ OpPageContainer ────────────────────────────────────┐  │
 │  │  PageHeader (面包屑模式)
 │  │   编辑用户                                │  │
 │  │  Form (TWO_COL)                                     │  │
@@ -122,7 +122,7 @@ description: >
 
 ```
 ┌─────────────────────────────────────────────────────────┐
-│  ┌─ Card(白卡容器) ──────────────────────────────────┐  │
+│  ┌─ OpPageContainer ────────────────────────────────────┐  │
 │  │  PageHeader (面包屑模式)
 │  │   创建数据库                              │  │
 │  │  Form (SECTION)                                     │  │
@@ -204,7 +204,7 @@ description: >
 | Form | FieldGroup | ORGANISM | center | 表单容器，替代 div + space-y-* |
 | SubmitBar | — | ORGANISM | bottom | 提交操作栏，底部固定 |
 
-> **框架级组件**（自动继承，无需在此声明）：Sidebar、Breadcrumb 由 `rules/page-frame.json` 统一管理，L2 级页面自动包含。弹窗表单（Dialog 内）为 L0 级，无框架组件。
+> **框架级组件**（自动继承，无需在此声明）：OpSidebar、Breadcrumb 由 `rules/page-frame.json` 统一管理，L2 级页面自动包含。弹窗表单（Dialog 内）为 L0 级，无框架组件。
 
 ### 可选组件
 
@@ -233,7 +233,7 @@ description: >
 |------|------|------|
 | DataTable | 禁止出现在表单页主内容区 | 如需选择关联数据，用 Dialog + DataTable |
 | Chart | 禁止出现在表单页 | 图表属于 Dashboard |
-| PageContainer | 禁止嵌套 | 见 `rules/layout-rules.json` |
+| PageContainer / OpPageContainer | 禁止嵌套 | 见 `rules/page-frame.json` |
 | ListPage | 禁止嵌套 | 表单页是页面级组件 |
 | 内联 Input | 禁止不在 Field 内 | 所有 Input 必须在 FieldGroup → Field 内(F1) |
 | 原始 div 表单布局 | 禁止 | 用 FieldGroup + Field 替代(F1) |
@@ -242,22 +242,21 @@ description: >
 
 | 父子关系 | 状态 | 说明 |
 |----------|------|------|
-| PageContainer → ContentWrapper | ALLOW | 右侧内容大容器（必需） |
-| ContentWrapper → Card(白卡容器) | ALLOW | 白色卡片容器，包裹所有业务内容（必需） |
-| Card(白卡容器) → Breadcrumb | ALLOW | 标准结构 |
-| Card(白卡容器) → PageHeader | ALLOW | 标准结构 |
-| Card(白卡容器) → FieldGroup | ALLOW | 表单容器 |
-| Card(白卡容器) → SubmitBar | ALLOW | 底部提交栏 |
-| ContentWrapper → PageHeader / Breadcrumb / FieldGroup / SubmitBar | FORBID | 业务组件必须经过白卡容器包裹 |
-| Card(白卡容器) → Card(白卡容器) | FORBID | 白卡容器为单例，禁止嵌套 |
+| PageShell → OpSidebar + OpPageContainer | ALLOW | OpenTrek 标准页面框架（必需） |
+| OpPageContainer → Breadcrumb | ALLOW | 标准结构 |
+| OpPageContainer → PageHeader | ALLOW | 标准结构 |
+| OpPageContainer → FieldGroup | ALLOW | 表单容器 |
+| OpPageContainer → SubmitBar | ALLOW | 底部提交栏 |
+| 跳过 OpPageContainer 直接挂载业务组件 | FORBID | 业务组件必须经过 OpPageContainer 包裹 |
+| OpPageContainer → OpPageContainer | FORBID | 页面容器为单例，禁止嵌套 |
 | FieldGroup → Field | ALLOW | 表单字段 |
 | Field → Input/Select/Switch | ALLOW | 表单控件 |
 | Field → ToggleGroup | ALLOW | 选项组控件 |
 | Field → Textarea | ALLOW | 多行文本 |
-| Card(白卡容器) → Card(分区) | ALLOW | 分区表单（内部卡片） |
+| OpPageContainer → Card(分区) | ALLOW | 分区表单（内部卡片） |
 | Card(分区) → FieldGroup | ALLOW | 分区内表单 |
-| Card(白卡容器) → Dialog | WARN | 取消确认弹窗由全局状态管理 |
-| Card(白卡容器) → Form | FORBID | Form 应在 FieldGroup 层级 |
+| OpPageContainer → Dialog | WARN | 取消确认弹窗由全局状态管理 |
+| OpPageContainer → Form | FORBID | Form 应在 FieldGroup 层级 |
 | Field → InputGroup | ALLOW | 输入框组（验证码等场景） |
 
 ## 6. 页面交互补充
@@ -322,18 +321,18 @@ description: >
 - **按钮在 input 内**: 用 `InputGroup` + `InputGroupAddon`(F3)
 - **Sonner 反馈**: `import { toast } from "sonner"`(C9)
 
-### 6.5 与 PageContainer 模式对照
+### 6.5 与 OpPageContainer 模式对照
 
-> 布局模式定义见 `rules/layout-rules.json`
+> 布局模式定义见 `rules/page-frame.json`
 
 表单页使用 **模式A（直接内容）或模式B（Card 分组）**：
 ```
-模式A: PageContainer → ContentWrapper → Breadcrumb + PageHeader + FieldGroup + SubmitBar
-模式B: PageContainer → ContentWrapper → Breadcrumb + PageHeader + Card[FieldGroup] + SubmitBar
+模式A: PageShell → OpSidebar + OpPageContainer → Breadcrumb + PageHeader + FieldGroup + SubmitBar
+模式B: PageShell → OpSidebar + OpPageContainer → Breadcrumb + PageHeader + Card[FieldGroup] + SubmitBar
 ```
 分区表单使用 **模式B 扩展**：
 ```
-PageContainer → ContentWrapper → Breadcrumb + PageHeader + Card[FieldGroup] + Separator + Card[FieldGroup] + SubmitBar
+PageShell → OpSidebar + OpPageContainer → Breadcrumb + PageHeader + Card[FieldGroup] + Separator + Card[FieldGroup] + SubmitBar
 ```
 
 ## 7. OpenTrek 表单容器模式
@@ -568,9 +567,9 @@ PageContainer → ContentWrapper → Breadcrumb + PageHeader + Card[FieldGroup]
 
 ```
 ┌─ PageShell ──────────────────────────────────────────────────────┐
-│ sidebar: Sidebar                                                  │
+│ sidebar: OpSidebar                                                │
 │ children:                                                         │
-│ ┌─ Card(白卡容器) ────────────────────────────────────────────┐  │
+│ ┌─ OpPageContainer ──────────────────────────────────────────┐  │
 │ │ Breadcrumb: 记忆体 > 空间共用                                │  │
 │ │ Tabs (variant='line'):                                       │  │
 │ │   [记忆总览 | 生成策略 | **整理策略** | 记忆动态]             │  │
@@ -722,7 +721,7 @@ PageContainer → ContentWrapper → Breadcrumb + PageHeader + Card[FieldGroup]
 
 - **读取路径**：见根技能 `../../SKILL.md` §4.5 三阶段读取决策树
   - 阶段①：`page-types.json` + `business-mapping.json`
-  - 阶段②：`page-frame.json` + `layout-rules.json` + `page-flow.json`
+  - 阶段②：`page-frame.json` + `page-flow.json`
   - 阶段③（生成 HTML 时）：`design-tokens.json` + `design-tokens.css` + `styling.json` + `../../boundaries.md` + `../../foundations.md`（表单布局精确规格见 `../../patterns/form-page.md` §8）
 
 > `rules/design-tokens.css` 是设计 Token 的唯一真相源（:root 变量定义）：生成 HTML 原型时需将 :root 变量块嵌入页面 `<style>` 标签；生成 React/TSX 需确保项目已通过 `@import` 引入该 CSS 文件。
@@ -734,7 +733,7 @@ PageContainer → ContentWrapper → Breadcrumb + PageHeader + Card[FieldGroup]
 | 检查项 | 检查点 | 目标 |
 |--------|--------|------|
 | 必需组件 | PageHeader、Form(FieldGroup)、SubmitBar | 100% |
-| 嵌套约束 | PageContainer → ContentWrapper → Breadcrumb + PageHeader + FieldGroup + SubmitBar | 无违规嵌套 |
+| 嵌套约束 | PageShell → OpSidebar + OpPageContainer → Breadcrumb + PageHeader + FieldGroup + SubmitBar | 无违规嵌套 |
 | 禁止组件 | 无 DataTable、Chart、内联 Input(不在 Field 内)、原始 div 布局 | 0 个 |
 | 表单布局 | 所有 Input 在 Field → FieldGroup 内(F1) | 正确 |
 | 字段校验 | 必填为空/格式错误/后端校验, data-invalid 正确 | 全部正确 |

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

@@ -27,11 +27,11 @@ description: >
 | 子类型ID | 识别关键词 | 路由到 | 布局模式 | 核心组件 |
 |----------|-----------|--------|----------|----------|
 | standard | "列表"/"表格"/"查询" | → `patterns/standard-list.md`；OpenTrek 业务规则 → `patterns/standard-list-opentrek.md` | 模式D | DataTable + Pagination |
-| l2-sidebar | "分类"/"分组"/"左侧树" | → 本文件 §8.1 | 模式D + Sidebar | Sidebar(240px) + DataTable |
+| l2-sidebar | "分类"/"分组"/"左侧树" | → 本文件 §8.1 | 模式D + OpSidebar | OpSidebar(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 |
+| **standard-card** | "卡片列表"/"分类卡片"/"资源卡片" | → `patterns/card-list.md` | 模式D-CARD (TWO_COL) | OpSidebar + CardGrid + ItemCard + CardActionBar |
 | **view-toggle** | "视图切换"/"列表卡片切换" | → `patterns/card-list.md` | 模式D + ViewToggle | ViewToggle + CardGrid/DataTable + ItemCard(tile) |
 | advanced-filter | "高级筛选"/"更多条件" | → 本文件 §8.4 | 模式D+ | AdvancedFilterPanel + DataTable |
 
@@ -56,11 +56,11 @@ description: >
 | 属性 | 值 | 说明 |
 |------|-----|------|
 | layout.type | TWO_COL / SINGLE_COL | 见 `rules/page-frame.json` layoutSelectionRules |
-| layout.frame | L1 | 列表页为 L1 级页面，自动继承 Sidebar（含Logo+产品名）。无面包屑。 |
+| layout.frame | L1 | 列表页为 L1 级页面，自动继承 OpSidebar（含Logo+产品名）。无面包屑。 |
 | responsive | Desktop ≥1200px(完整), Tablet 768-1199px(横滚), Mobile <768px(不推荐) |
 | pagination.default | 标准列表 10 条/页, 纯卡片 12 条/页 |
 
-> **框架组件自动继承**：Sidebar 的存在性由 `rules/page-frame.json` 统一管理，子技能只定义内容区组件。L1 级页面自动包含：Sidebar（顶部Logo+产品名），无面包屑。
+> **框架组件自动继承**：OpSidebar 的存在性由 `rules/page-frame.json` 统一管理，子技能只定义内容区组件。L1 级页面自动包含：OpSidebar（顶部Logo+产品名），无面包屑。
 
 ---
 
@@ -74,7 +74,7 @@ description: >
 | ActionToolbar | — | ORGANISM | top | 操作工具栏，单行 flex(flex-wrap:nowrap)，左侧创建按钮 + 右侧搜索工具 |
 | Pagination | — | MOLECULAR | bottom | 分页控件 |
 
-> **框架级组件**（自动继承，无需在此声明）：Sidebar 由 `rules/page-frame.json` 统一管理，L1 级页面自动包含。
+> **框架级组件**（自动继承，无需在此声明）：OpSidebar 由 `rules/page-frame.json` 统一管理，L1 级页面自动包含。
 > 注：DataTable 为 standard/l2/expandable/drawer/view-toggle 的必需组件；CardGrid 为 standard-card/pure-card/view-toggle 的必需组件。
 
 ### 禁止组件
@@ -83,7 +83,7 @@ description: >
 |------|------|------|
 | Form(ORGANISM) | 禁止直接出现在内容区 | 表单应通过 Dialog/Sheet/FormPage 触发 |
 | Chart(ORGANISM) | 禁止出现在标准列表页 | 图表属于 Dashboard |
-| PageContainer | 禁止嵌套 | 见 `rules/layout-rules.json` |
+| PageContainer / OpPageContainer | 禁止嵌套 | 见 `rules/page-frame.json` |
 | 内联编辑 | 禁止 | 编辑应通过 Sheet/Dialog/FormPage |
 | 拖拽排序 | 禁止 | 表格数据为服务端排序 |
 | 无限滚动 | 禁止 | B2B 管理场景需精确分页 |
@@ -104,7 +104,7 @@ description: >
 
 > 注意：Table 首列内容 X = Card 外缘 + 40px，与 PageHeader / ActionToolbar / Pagination 起始线**不对齐**（这是设计预期）。
 
-Card 白卡容器：`padding: 0 var(--card-padding-x)` （上下 0 / 左右 20px）。注意：`--card-padding-x` (20px) 独立于 `--page-container-padding` (16px)，后者为 PageContainer 外层间距。
+Card 白卡容器：`padding: 0 var(--card-padding-x)` （上下 0 / 左右 20px）。注意：`--card-padding-x` (20px) 独立于 OpPageContainer 外层间距（py-5 pr-5，各 20px）。OpenTrek 使用 `OpPageContainer`（`components/business/op-page-container`）内置白卡替代手动 Card 包裹。
 
 | 组件 | 水平 padding | 起始线 X 坐标 | 说明 |
 |------|---------------|-----------------|------|
@@ -159,9 +159,9 @@ Card 白卡容器：`padding: 0 var(--card-padding-x)` （上下 0 / 左右 20px
 
 ---
 
-## 5.2 ContentCard 表面规则 v7.6【硬约束】
+## 5.2 ContentCard / OpPageContainer 表面规则 v7.6【硬约束】
 
-内容区大卡片容器（ContentCard 作为白卡容器使用时）表面规则：
+内容区大卡片容器（OpPageContainer 内置白卡）表面规则：
 
 | 属性 | v7.5 及之前 | **v7.6（当前）** |
 |------|-------------|----------------|
@@ -205,24 +205,23 @@ Card 白卡容器：`padding: 0 var(--card-padding-x)` （上下 0 / 左右 20px
 
 | 父子关系 | 状态 | 说明 |
 |----------|------|------|
-| PageContainer → ContentWrapper | ALLOW | 右侧内容大容器（必需） |
-| ContentWrapper → Card(白卡容器) | ALLOW | 白色卡片容器，包裹所有业务内容（必需） |
-| Card(白卡容器) → PageHeader | ALLOW | 标准结构 |
-| Card(白卡容器) → ActionToolbar | ALLOW | 操作工具栏 |
-| Card(白卡容器) → DataTable | ALLOW | 核心组件 |
-| Card(白卡容器) → CardGrid | ALLOW | 卡片列表 |
-| Card(白卡容器) → ViewToggle | ALLOW | 视图切换 |
-| Card(白卡容器) → AdvancedFilterPanel | ALLOW | 高级筛选面板 |
-| Card(白卡容器) → Pagination | ALLOW | 分页控件 |
-| ContentWrapper → PageHeader / ActionToolbar / DataTable / CardGrid / Pagination | FORBID | 业务组件必须经过白卡容器包裹 |
-| Card(白卡容器) → Card(白卡容器) | FORBID | 白卡容器为单例，禁止嵌套 |
+| PageShell → OpSidebar + OpPageContainer | ALLOW | OpenTrek 标准页面框架（必需） |
+| OpPageContainer → PageHeader | ALLOW | 标准结构（header slot） |
+| OpPageContainer → ActionToolbar | ALLOW | 操作工具栏（children） |
+| OpPageContainer → DataTable | ALLOW | 核心组件 |
+| OpPageContainer → CardGrid | ALLOW | 卡片列表 |
+| OpPageContainer → ViewToggle | ALLOW | 视图切换 |
+| OpPageContainer → AdvancedFilterPanel | ALLOW | 高级筛选面板 |
+| OpPageContainer → Pagination | ALLOW | 分页控件 |
+| 跳过 OpPageContainer 直接挂载业务组件 | FORBID | 业务组件必须经过 OpPageContainer 包裹 |
+| OpPageContainer → OpPageContainer | FORBID | 页面容器为单例，禁止嵌套 |
 | ActionToolbar → SearchCombo | ALLOW | 搜索组合 |
 | CardGrid → ItemCard | ALLOW | 业务卡片（v7.3 起详见 `patterns/card-list.md` §9.1） |
 | ItemCard → CardActionBar | ALLOW | 卡片操作栏，三态：hover-slidebar / hover-fade / always-visible（v7.3 详见 `patterns/card-list.md` §9.3） |
 | DataTable → Pagination | ALLOW | 分页控件 |
 | DataTable → Dialog | WARN | 确认弹窗由全局状态管理 |
 | DataTable → Form | FORBID | 表格内不应直接嵌套完整表单 |
-| Sidebar → DescriptionList | FORBID | 描述列表不应嵌套在侧边栏 |
+| OpSidebar → DescriptionList | FORBID | 描述列表不应嵌套在侧边栏 |
 
 ---
 
@@ -342,14 +341,14 @@ pointer-events: none;
 
 ### 8.1 L2 导航列表 (l2-sidebar)
 
-> 布局模式: 模式D + Sidebar(TWO_COL) | 核心差异: 左侧 240px 分类导航 + 右侧标准列表
+> 布局模式: 模式D + OpSidebar(TWO_COL) | 核心差异: 左侧 240px 分类导航 + 右侧标准列表
 
 #### 布局骨架
 
 ```
 ┌──────────┬──────────────────────────────────────────────┤
 │          │  PageHeader + ActionToolbar + DataTable      │
-│  Sidebar │  + BulkActionBar + Pagination                │
+│  OpSidebar │  + BulkActionBar + Pagination                │
 │ (240px)  │  (同标准列表页完整结构)                        │
 │          │                                              │
 │ [分类A]  │                                              │
@@ -365,17 +364,17 @@ pointer-events: none;
 | 维度 | 标准列表 | L2 导航列表 |
 |------|----------|-------------|
 | 布局 | SINGLE_COL / TWO_COL | **TWO_COL** |
-| Sidebar | 可选 | **必需** |
+| OpSidebar | 可选 | **必需** |
 
-> Sidebar 收起/展开、交互规范、色彩全部引用 `rules/design-tokens.json` sidebarRules。
+> OpSidebar 收起/展开、交互规范、色彩全部引用 `rules/design-tokens.json` sidebarRules。
 
-#### Sidebar 交互规范
+#### OpSidebar 交互规范
 
 | 交互 | 行为 |
 |------|------|
 | 点击分类 | 刷新右侧列表数据，保持当前页码 |
 | 展开/收起 | 切换子分类列表，动画过渡 |
-| 收起 Sidebar | 宽度缩至 68px，仅显示图标 |
+| 收起 OpSidebar | 宽度缩至 68px，仅显示图标 |
 | 选中态 | 灰色背景 `var(--sidebar-active)` |
 | 手风琴 | 打开一个分组自动关闭其他分组 |
 | 收起态 Tooltip | Hover 显示节点名称 |
@@ -388,7 +387,7 @@ pointer-events: none;
 
 | 验证项 | 检查点 | 目标 |
 |--------|--------|------|
-| Sidebar 规格 | 展开240px / 收起68px | 正确 |
+| OpSidebar 规格 | 展开240px / 收起68px | 正确 |
 | 分类选中态 | 灰色背景 `var(--sidebar-active)` | 正确 |
 | 分类切换 | 右侧列表刷新 | 正确 |
 | 计数徽章 | 每项右侧灰色 12px | 正确 |
@@ -480,7 +479,7 @@ pointer-events: none;
 
 | 维度 | 标准列表 | 抽屉中列表 |
 |------|----------|-----------|
-| 容器 | PageContainer | **Sheet** |
+| 容器 | OpPageContainer | **Sheet** |
 | 触发方式 | 直接访问 URL | **点击按钮/链接打开 Sheet** |
 | 选择返回 | 跳转页面 | **选择后点击确定关闭 Sheet，返回选中数据** |
 | 宽度 | 全宽/自适应 | **固定宽度 (600-900px)** |
@@ -521,7 +520,7 @@ pointer-events: none;
 
 ```
 ┌──────────┬──────────────────────────────────────────────┤
-│  Sidebar │  PageHeader: 标题(18px/medium)                   │
+│  OpSidebar │  PageHeader: 标题(18px/medium)                   │
 │          │  ActionToolbar: [创建] + [搜索🔍] [高级筛选▾]    │
 │          │  ┌─── AdvancedFilterPanel ───────────────┐   │
 │          │  │ 条件1: [Select] [Input]               │   │
@@ -562,11 +561,11 @@ pointer-events: none;
 - 筛选条件清空后，FilterTag 区域隐藏（display: none）
 - 支持"清空全部"操作
 
-#### 与 PageContainer 模式对照
+#### 与 OpPageContainer 模式对照
 
 高级筛选列表使用 **模式D+**：
 ```
-PageContainer → ContentWrapper → PageHeader + ActionToolbar + AdvancedFilterPanel(可展开) + DataTable + BulkActionBar + Pagination
+PageShell → OpSidebar + OpPageContainer → PageHeader + ActionToolbar + AdvancedFilterPanel(可展开) + DataTable + BulkActionBar + Pagination
 ```
 
 #### 验证差异项
@@ -588,7 +587,7 @@ PageContainer → ContentWrapper → PageHeader + ActionToolbar + AdvancedFilter
 | 共享规则 | 路径 | 被引用子类型 |
 |----------|------|-------------|
 | 表格列元规则 | `_shared/column-meta-rules.md` | standard, l2-sidebar, expandable, drawer, view-toggle（列表视图） |
-| SearchCombo 规范 | `_shared/search-combo-spec.md` | 全部子类型 |
+| SearchCombo 规范 | `rules/common-components.json` → SearchCombo | 全部子类型 |
 | 业务卡片三件套规格 | `_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。
@@ -619,7 +618,7 @@ PageContainer → ContentWrapper → PageHeader + ActionToolbar + AdvancedFilter
 
 - **读取路径**：见根技能 `../../SKILL.md` §4.5 四阶段读取决策树
   - 阶段①：`page-types.json` + `business-mapping.json`
-  - 阶段②：`page-frame.json` + `layout-rules.json` + `page-flow.json` + `_shared/search-combo-spec.md`；卡片子类型追加读取 `patterns/card-list.md`；OpenTrek 标准列表追加读取 `patterns/standard-list-opentrek.md`
+  - 阶段②：`page-frame.json` + `page-flow.json` + `common-components.json`（SearchCombo）；卡片子类型追加读取 `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`
 
@@ -635,8 +634,8 @@ PageContainer → ContentWrapper → PageHeader + ActionToolbar + AdvancedFilter
 
 | 检查项 | 检查点 | 目标 |
 |--------|--------|------|
-| 嵌套结构 | PageContainer → ContentWrapper → Card(白卡容器) → PageHeader/ActionToolbar/DataTable/Pagination | 100% |
-| Card 内左右对齐 | 非 Table 组件 padding = 0（由 Card.paddingX 20px 提供）；Table 首末列 paddingX = 20px | 100% |
+| 嵌套结构 | PageShell → OpSidebar + OpPageContainer → PageHeader/ActionToolbar/DataTable/Pagination | 100% |
+| Card 内左右对齐 | 非 Table 组件 padding = 0（由 OpPageContainer 内白卡 p-6 提供）；Table 首末列 paddingX = 20px | 100% |
 | 必需组件 | PageHeader、ActionToolbar、Pagination + 子类型组件 | 100% |
 | 禁止组件 | 无内联编辑、拖拽排序、无限滚动、悬浮操作栏、右键菜单 | 0 个 |
 | 操作可用性 | 状态-操作矩阵匹配（§7） | 所有状态正确 |