@teamix-evo/skills 0.4.0 → 0.6.0

package/src/teamix-evo-design-uni-manager/generation-flow.md

@@ -1,6 +1,6 @@
 # 生成 / 翻新 / 验证流程
 
-> AI 在执行页面级任务时，按本文件的门控顺序执行。每一步都有明确的输入输出，跳步会导致结果不可控。
+> ⚠️ **本文件是页面级任务的唯一执行路径。每一步都有 GATE 门禁和 MUST READ 文件清单。** > **跳步 = 产出不合规。AI 不得凭"已有知识"省略任何文件读取。**
 
 ---
 
@@ -14,7 +14,11 @@ Step 1 需求确认 → Step 2 类型识别 → Step 3 子类型 + 布局
 Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 ```
 
-### Step 1 · 最小 quorum + 默认值
+> **每步必须产出明确输出后才能进入下一步（GATE 条件）。**
+
+## Step 1 · 最小 quorum + 默认值
+
+📖 **MUST READ**: [philosophy.md](./philosophy.md)（理解"为什么这么做" — 四大原则优先级）+ [brand.md](./brand.md)（视觉调性 + 文案语气基调）
 
 **只有两个信息缺一不可**（最小 quorum，缺则反问）：
 
@@ -39,7 +43,11 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 
 **输出**：页面类型 + 资源实体 + 一句话场景假设（"假设是平台管理员的实例 CRUD 列表，多云资源默认显示 cloud Badge，如有偏差请指正"）。
 
-### Step 2 · 页面类型识别
+## Step 2 · 页面类型识别
+
+🚧 **GATE**: Step 1 必须已产出"页面类型 + 资源实体 + 场景假设"
+
+📖 **MUST READ**: [patterns/page-types.md](./patterns/page-types.md) §决策树 + §Zone Map
 
 根据 [patterns/page-types.md](./patterns/page-types.md) §决策树匹配类型：
 
@@ -55,7 +63,11 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 
 **输出**：页面类型 ID（`ListPage` / `DetailPage` / `Console` / ...）。
 
-### Step 3 · 子类型识别 + 布局选择
+## Step 3 · 子类型识别 + 布局选择
+
+🚧 **GATE**: Step 2 必须已产出"页面类型 ID"
+
+📖 **MUST READ**: 对应的 `patterns/{type}-page.md` + [flows.md](./flows.md)（涉及租户/区域切换时）
 
 读对应 `patterns/{type}-page.md`：
 
@@ -66,19 +78,29 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 
 **输出**：子类型 ID + 区域骨架（参照 [patterns/page-types.md](./patterns/page-types.md) §Zone Map）。
 
-### Step 4 · 组件挑选
+## Step 4 · 组件挑选
+
+🚧 **GATE**: Step 3 必须已产出"子类型 ID + 区域骨架"
+
+📖 **MUST READ**: [components.md](./components.md) §0 兜底铁律 + §1 双层架构 + §3 决策树 + §5 拼装配方
 
 读 [components.md](./components.md) §选型决策树：
 
 1. 优先使用 `@teamix-evo/ui` 注册表中的稳定组件
 2. 通过 MCP `list_components(status: "stable")` 查可用列表
 3. 通过 MCP `get_component_meta(id)` 查具体 Props/Examples
+   - **Props**：确定必传 / 可选 / 默认值，明确接口契约
+   - **Examples**：作为实现参考（含组合用法、常见模式、边界处理），优先复用示例中的写法而非自由发挥
 4. 复合场景按 [components.md](./components.md) §5.2 拼装配方装配（SearchCombo / ContextSwitcher / CardGrid 等概念占位）
 5. um-topbar / um-side-nav 等实物业务组件位于 `@teamix-evo/biz-ui/uni-manager/*`
 
-**输出**：组件清单 + 每个组件的关键 Props。
+**输出**：组件清单 + 每个组件的关键 Props + 参考的 Example 片段（若有启发性写法）。
 
-### Step 5 · 视觉填充（Token 绑定）
+## Step 5 · 视觉填充（Token 绑定）
+
+🚧 **GATE**: Step 4 必须已产出"组件清单 + 每个组件的关键 Props"
+
+📖 **MUST READ**: [foundations.md](./foundations.md) 全文（§1 Token 优先级 + §4 色彩 + §5 圆角 + §6 阴影 + §7 动效）+ [brand.md](./brand.md) §1 视觉五维（圆角/配色/密度/阴影/焦点风格对齐）
 
 读 [foundations.md](./foundations.md)，所有色彩、间距、字号、圆角、阴影、动效**必须**使用 Token：
 
@@ -95,7 +117,11 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 
 **输出**：含 Token 引用的可执行代码 / HTML。
 
-### Step 6 · 自检
+## Step 6 · 自检
+
+🚧 **GATE**: Step 5 必须已产出"含 Token 引用的可执行代码"
+
+📖 **MUST READ**: [boundaries.md](./boundaries.md) 全文（41+ 条硬规则）+ [checklist.md](./checklist.md) 全文
 
 对照 [checklist.md](./checklist.md) 12+ 项逐项验证：
 
@@ -110,6 +136,12 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 
 适用关键词：**"改造 / 升级 / 翻新 / 对齐规范 / 重新生成"**。
 
+📖 **MUST READ** (全部必读，不得省略)：
+
+1. [boundaries.md](./boundaries.md) — 硬规则真值
+2. [foundations.md](./foundations.md) — Token 真值
+3. [components.md](./components.md) — 组件选型
+
 ```
 1. 读取目标页面源码
 2. 扫描违规项（按 boundaries.md F1-F10 + S1-S8 + UM1-UM3）
@@ -132,6 +164,12 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 
 适用关键词：**"检查 / 验证 / 评估 / 是否符合规范"**。
 
+📖 **MUST READ** (全部必读，不得省略)：
+
+1. [boundaries.md](./boundaries.md) — 41+ 条硬规则
+2. [checklist.md](./checklist.md) — 13 强制项 + 5 一致性 + 7 建议项
+3. [foundations.md](./foundations.md) — Token 真值（用于校验是否符合）
+
 ```
 1. 读取目标页面源码
 2. 逐条对照 boundaries.md

package/src/teamix-evo-design-uni-manager/patterns/dashboard.md

@@ -1,8 +1,10 @@
 # Dashboard — 控制台首页 / 数据概览页
 
+> ⚠️ **Prerequisites**: 你必须已在 [generation-flow.md](../generation-flow.md) Step 2 确认页面类型为 **Dashboard**，并由 Step 3 引导到这里。
+
 > AI 实操路径：Step 2（页面类型识别）判定为 Dashboard 后，本文档接管。
 >
-> uni-manager 中 Dashboard **同时承担"控制台 Home"** 角色（资源总览 / 待办 / 跨云态势），是用户登录后第一屏。
+> uni-manager 中 Dashboard **同时承担“控制台 Home”** 角色（资源总览 / 待办 / 跨云态势），是用户登录后第一屏。
 
 ---
 

package/src/teamix-evo-design-uni-manager/patterns/detail-page.md

@@ -1,6 +1,8 @@
 # Detail Page — 详情页模式（uni-manager）
 
-> **触发**：用户描述含"详情/查看/信息/概览（单资源）"。
+> ⚠️ **Prerequisites**: 你必须已在 [generation-flow.md](../generation-flow.md) Step 2 确认页面类型为 **DetailPage**，并由 Step 3 引导到这里。
+
+> **触发**：用户描述含“详情/查看/信息/概览（单资源）”。
 > **核心特征**：单条记录的只读展示 + DescriptionList + 操作按钮。
 > **页面级别**：L2（面包屑模式 PageHeader，自动继承 um-topbar + Sidebar）。
 
@@ -20,7 +22,34 @@
 
 ---
 
-## 2. 标准结构（资源详情 — uni-manager 跨云增强）
+## 2. Template 组件拼装
+
+> 源自 `packages/create/variants/uni-manager/src/templates/detail-page.tsx`
+
+```tsx
+<PageShell header={<UmTopbar />} sidebar={<Sidebar />}>
+  <UmPageContainer header={<PageHeader breadcrumb={...} title="XX 详情" actions={...} />}>
+    {children}  {/* InfoCard / Tabs / DescriptionList / Timeline */}
+  </UmPageContainer>
+</PageShell>
+```
+
+| Slot         | 注入内容                                             | 说明       |
+| ------------ | ---------------------------------------------------- | ---------- |
+| `topbar`     | UmTopbar                                             | 框架级吃顶 |
+| `sidebar`    | Sidebar + 业务菜单                                   | 左导       |
+| `pageHeader` | PageHeader（面包屑 + 标题 + actions + 可选数据概览） | L2 页面    |
+| `children`   | InfoCard / Tabs / DescriptionList / Timeline 等      | 详情主区   |
+
+**壳层特征**：
+
+- 结构最简洁 — 只有 4 个 slot，业务组件全部走 children
+- InfoCard 是局部信息卡（业务子区域级），不算“主区白卡”
+- Tabs 用于多维度信息分类（基本信息 / 监控 / 关联资源 / 操作日志）
+
+---
+
+## 3. 标准结构（资源详情 — uni-manager 跨云增强）
 
 ```
 ┌─────────────────────────────────────────────┐
@@ -65,7 +94,7 @@
 
 ---
 
-## 3. 必需组件
+## 4. 必需组件
 
 | 组件                | 位置 | 说明                            |
 | ------------------- | ---- | ------------------------------- |
@@ -87,7 +116,7 @@
 
 ---
 
-## 4. DescriptionItem 字段交互
+## 5. DescriptionItem 字段交互
 
 | 类型           | 触发       | 反馈                              |
 | -------------- | ---------- | --------------------------------- |
@@ -102,7 +131,7 @@
 
 ---
 
-## 5. 操作按钮规则
+## 6. 操作按钮规则
 
 ### 5.1 位置
 
@@ -129,7 +158,7 @@
 
 ---
 
-## 6. Tab 切换交互
+## 7. Tab 切换交互
 
 | 场景       | 行为                          |
 | ---------- | ----------------------------- |
@@ -143,7 +172,7 @@
 
 ---
 
-## 7. 信息分组
+## 8. 信息分组
 
 - DescriptionList 按 ListSection 分组（基本信息 / 配置信息 / 网络信息）
 - 每组可独立展开/收起（可选）
@@ -153,7 +182,7 @@
 
 ---
 
-## 8. 嵌套约束
+## 9. 嵌套约束
 
 | 父子关系                                                                                                 | 状态                                |
 | -------------------------------------------------------------------------------------------------------- | ----------------------------------- |
@@ -168,11 +197,11 @@
 
 ---
 
-## 9. 禁止项
+## 10. 禁止项
 
 | 禁项                       | 原因                                  |
 | -------------------------- | ------------------------------------- |
-| Form 直接在主内容区        | 编辑应通过 Drawer/Dialog/FormPage     |
+| Form 直接在主内容区        | 编辑应通过 Sheet/Dialog/FormPage      |
 | DataTable 在主内容区       | 关联数据应用 Tabs 子面板              |
 | Chart 替代 DescriptionList | 图表属 Dashboard，监控用 MonitorPanel |
 | QueryFilter                | 详情页无筛选需求                      |
@@ -182,7 +211,7 @@
 
 ---
 
-## 10. 边界情况
+## 11. 边界情况
 
 | 场景       | 处理                    |
 | ---------- | ----------------------- |
@@ -197,7 +226,7 @@
 
 ---
 
-## 11. 详情 → 列表返回约定
+## 12. 详情 → 列表返回约定
 
 - 面包屑父级项点击返回 ListPage
 - PageHeader 右侧可选 × 关闭按钮
@@ -208,7 +237,7 @@
 
 ---
 
-## 12. 详情页特有自检
+## 13. 详情页特有自检
 
 - [ ] PageHeader 用面包屑模式（L2 页面）
 - [ ] um-topbar 在框架层就位（UM1）

package/src/teamix-evo-design-uni-manager/patterns/form-page.md

@@ -1,6 +1,8 @@
 # Form Page — 表单页模式（uni-manager）
 
-> **触发**：用户描述含"新建/创建/编辑/修改/复制/填写"。
+> ⚠️ **Prerequisites**: 你必须已在 [generation-flow.md](../generation-flow.md) Step 2 确认页面类型为 **FormPage**，并由 Step 3 引导到这里。
+
+> **触发**：用户描述含“新建/创建/编辑/修改/复制/填写”。
 > **核心特征**：用户输入数据 + 字段校验 + 提交。
 > **页面级别**：L2（面包屑模式 PageHeader，自动继承 um-topbar + Sidebar）。弹窗表单 = L0。
 
@@ -8,26 +10,61 @@
 
 ## 1. 子类型识别
 
-| 子类型          | 关键词                | 差异特征                                                   |
-| --------------- | --------------------- | ---------------------------------------------------------- |
-| **新建表单**    | "新建"/"创建"/"新增"  | 字段为空，标题"新建 XX"，保存返回列表                      |
-| **编辑表单**    | "编辑"/"修改"         | 字段填充数据，标题"编辑 XX"，保存返回原页                  |
-| **复制新建**    | "复制"/"克隆"         | 字段预填源数据（ID 除外），标题"复制新建 XX"，保存返回列表 |
-| **Drawer 内联** | "侧滑编辑"/"快速编辑" | 在列表页右侧滑出 Drawer，无路由切换（uni-manager 高频）    |
+| 子类型         | 关键词                | 差异特征                                                       |
+| -------------- | --------------------- | -------------------------------------------------------------- |
+| **新建表单**   | "新建"/"创建"/"新增"  | 字段为空，标题"新建 XX"，保存返回列表                          |
+| **编辑表单**   | "编辑"/"修改"         | 字段填充数据，标题"编辑 XX"，保存返回原页                      |
+| **复制新建**   | "复制"/"克隆"         | 字段预填源数据（ID 除外），标题"复制新建 XX"，保存返回列表     |
+| **Sheet 内联** | "侧滑编辑"/"快速编辑" | 在列表页右侧滑出 Sheet（抽屉），无路由切换（uni-manager 高频） |
+
+### FormPage vs Wizard vs Sheet（抽屉）区分
+
+| 场景                       | 类型       | 判断依据                                     |
+| -------------------------- | ---------- | -------------------------------------------- |
+| 字段无顺序依赖，一次填写   | FormPage   | 单页表单                                     |
+| 步骤间有顺序依赖，逐步完成 | WizardPage | 多步流程，Steps                              |
+| 列表页快速编辑单条记录     | Sheet 内联 | 不切路由，保留列表上下文（uni-manager 默认） |
+
+> Wizard 是独立页面类型，不是 FormPage 子类型。Sheet 内联是**编辑表单**的视图变体。
+
+---
+
+## 2. Template 组件拼装
+
+> 源自 `packages/create/variants/uni-manager/src/templates/form-page.tsx`
+
+```tsx
+<PageShell header={<UmTopbar />} sidebar={<Sidebar />}>
+  <UmPageContainer header={<PageHeader breadcrumb={...} title="新建 XX" />}>
+    <div className="flex-1 min-h-0 overflow-auto">
+      {children}        {/* FieldGroup 们 / 分区 Card */}
+    </div>
+    {submitBar && (
+      <div className="sticky bottom-0 border-t bg-background">
+        {submitBar}     {/* [取消] [提交] */}
+      </div>
+    )}
+  </UmPageContainer>
+</PageShell>
+```
 
-### FormPage vs Wizard vs Drawer 区分
+| Slot         | 注入内容                                  | 说明       |
+| ------------ | ----------------------------------------- | ---------- |
+| `topbar`     | UmTopbar                                  | 框架级吃顶 |
+| `sidebar`    | Sidebar + 业务菜单                        | 左导       |
+| `pageHeader` | PageHeader（面包屑模式 — L2 页面）        | 含返回路径 |
+| `children`   | FieldGroup 们（可用分区 Card 切若干小节） | 滚动区     |
+| `submitBar`  | 取消 + 提交按钮（`justify-end`）          | 粘底悬浮   |
 
-| 场景                       | 类型        | 判断依据                                     |
-| -------------------------- | ----------- | -------------------------------------------- |
-| 字段无顺序依赖，一次填写   | FormPage    | 单页表单                                     |
-| 步骤间有顺序依赖，逐步完成 | WizardPage  | 多步流程，Steps                              |
-| 列表页快速编辑单条记录     | Drawer 内联 | 不切路由，保留列表上下文（uni-manager 默认） |
+**壳层特征**：
 
-> Wizard 是独立页面类型，不是 FormPage 子类型。Drawer 内联是**编辑表单**的视图变体。
+- 表单主区 `flex-1 overflow-auto` — 内容超出视口时内滚
+- SubmitBar 从滚动区移出，`sticky bottom-0` 粘底悬浮
+- SubmitBar 上方 `border-t` 分割线 + `bg-background` 防透
 
 ---
 
-## 2. 布局模式（三选一）
+## 3. 布局模式（三选一）
 
 ### 2.1 SINGLE_COL（默认）
 
@@ -78,10 +115,10 @@ SubmitBar  [取消] [创建]
 
 **何时分区**：字段 > 10 / 业务概念分组明显 / 含可选高级配置。
 
-### 2.4 Drawer 内联（uni-manager 编辑高频）
+### 2.4 Sheet 内联（uni-manager 编辑高频）
 
 ```text
-┌── 列表页（保持） ────────┐ ┌── Drawer (侧滑) ──┐
+┌── 列表页（保持） ────────┐ ┌── Sheet (侧滑) ──┐
 │ DataTable                │ │ Title: 编辑 实例   │
 │ ▢ i-001 [编辑]──────────►│ │                    │
 │ ▢ i-002                  │ │ FieldGroup         │
@@ -96,7 +133,7 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 3. 必需组件
+## 4. 必需组件
 
 | 组件                  | 位置   | 说明                                  |
 | --------------------- | ------ | ------------------------------------- |
@@ -108,7 +145,7 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 4. SubmitBar / Footer 规则
+## 5. SubmitBar / Footer 规则
 
 ### 4.1 智能定位
 
@@ -132,9 +169,9 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 5. 字段控件选型
+## 6. 字段控件选型
 
-> **枚举数量阈值规则（≤7 RadioGroup / 8-30 Select / >30 Combobox）见 [components.md §3.5 输入控件](../components.md#35-输入控件--input-vs-select-vs-combobox)**。本节只列表单页专属补充字段。
+> **枚举数量阈值规则（≤7 RadioGroup / 8-30 Select / >30 补搜索候选）见 [components.md §3.5 输入控件](../components.md#35-输入控件--input-vs-select-vs-autocomplete)**。本节只列表单页专属补充字段。
 
 | 字段类型       | 组件                         | 说明                                      |
 | -------------- | ---------------------------- | ----------------------------------------- |
@@ -151,7 +188,7 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 6. 字段校验规则
+## 7. 字段校验规则
 
 ### 6.1 触发时机
 
@@ -178,7 +215,7 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 7. 提交交互
+## 8. 提交交互
 
 ### 7.1 操作流
 
@@ -216,7 +253,7 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 8. shadcn 表单组合契约
+## 9. shadcn 表单组合契约
 
 > 表单**组合层面**的本地约定。视觉/全局规则参见 [boundaries.md FF1-FF4](../boundaries.md#ff1-ff4--表单专属硬约束)（色块、必填、Card 嵌套、错误文案）+ [boundaries.md S2](../boundaries.md#error-s2--不用-space-x---space-y--改用-flex--gap-)（gap 替代 space-y）+ [boundaries.md F8](../boundaries.md#error-f8--禁止在-dialogtitle-中加图标--scope-dialog)（DialogTitle 无图标）+ [boundaries.md F9](../boundaries.md#error-f9--弹窗确定按钮禁止加-disabled-禁用态--scope-dialog)（提交按钮无 disabled）。
 
@@ -230,7 +267,7 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 9. 嵌套约束
+## 10. 嵌套约束
 
 | 父子关系                                                                                      | 状态                        |
 | --------------------------------------------------------------------------------------------- | --------------------------- |
@@ -243,12 +280,12 @@ SubmitBar  [取消] [创建]
 | Field → Input / Select / Switch / ToggleGroup / Textarea                                      | ALLOW                       |
 | Field → InputGroup                                                                            | ALLOW                       |
 | Card → Form                                                                                   | **FORBID**（用 FieldGroup） |
-| Drawer → FieldGroup                                                                           | ALLOW（内联编辑）           |
+| Sheet → FieldGroup                                                                            | ALLOW（内联编辑）           |
 | 自建 topbar                                                                                   | **FORBID**（UM1）           |
 
 ---
 
-## 10. 禁止项
+## 11. 禁止项
 
 | 禁项                        | 原因                             |
 | --------------------------- | -------------------------------- |
@@ -262,7 +299,7 @@ SubmitBar  [取消] [创建]
 
 ---
 
-## 11. 表单页特有自检
+## 12. 表单页特有自检
 
 - [ ] PageHeader 用面包屑模式（L2 页面）
 - [ ] um-topbar 在框架层就位（UM1）
@@ -275,12 +312,12 @@ SubmitBar  [取消] [创建]
 - [ ] 取消时未保存内容 AlertDialog 确认
 - [ ] 编辑模式加载用 Skeleton
 - [ ] Toast 用 sonner（C9），不用自定义全局通知
-- [ ] 单字段 / ≤5 字段编辑优先用 Drawer 内联，不切路由
+- [ ] 单字段 / ≤5 字段编辑优先用 Sheet 内联，不切路由
 - [ ] 危险操作：标题陈述句 + 输入资源名称确认
 
 ---
 
-## 12. 《Teamix UI 表单设计规范》对齐 Checklist
+## 13. 《Teamix UI 表单设计规范》对齐 Checklist
 
 > 详细说明见 [`packages/ui/AGENTS.md` 第六节](../../../../ui/AGENTS.md#六表单族硬规则formfieldfilter-barlabelinput)。本节只列 AI 写表单时的 yes/no 自检项。
 

package/src/teamix-evo-design-uni-manager/patterns/list-page.md

@@ -1,6 +1,8 @@
 # List Page — 列表页模式（uni-manager）
 
-> **触发**：用户描述含"列表/表格/查询/检索/卡片管理"。
+> ⚠️ **Prerequisites**: 你必须已在 [generation-flow.md](../generation-flow.md) Step 2 确认页面类型为 **ListPage**，并由 Step 3 引导到这里。
+
+> **触发**：用户描述含“列表/表格/查询/检索/卡片管理”。
 > **核心特征**：多条结构化数据 + 搜索/筛选 + 分页。
 > **页面级别**：L1（标题模式 PageHeader，自动继承 um-topbar + Sidebar）。
 > **uni-manager 增强**：高密度行（36-40px）+ 跨云 CloudBadge 列 + 多租户 / 多区域筛选维度 + 批量操作高频。
@@ -14,7 +16,7 @@
 | **standard**        | "列表"/"表格"/"查询"               | TWO_COL                       | DataTable + Pagination              |
 | **l2-sidebar**      | "分类"/"分组"/"左侧树"             | TWO_COL + 内部 Sidebar(240px) | Sidebar + DataTable                 |
 | **expandable**      | "展开"/"子项"/"详情行"             | TWO_COL                       | DataTable（行内展开）               |
-| **drawer**          | "弹窗列表"/"选择器"                | Drawer 内                     | DataTable ⊂ Drawer                  |
+| **drawer**          | "弹窗列表"/"选择器"                | Sheet 内                      | DataTable ⊂ Sheet                   |
 | **pure-card**       | "纯卡片"/"卡片管理"/"资源卡片管理" | SINGLE_COL                    | CardGrid + ItemCard + CardActionBar |
 | **standard-card**   | "卡片列表"/"分类卡片"              | TWO_COL                       | Sidebar + CardGrid + ItemCard       |
 | **view-toggle**     | "视图切换"/"列表卡片切换"          | TWO_COL + ViewToggle          | ViewToggle + DataTable/CardGrid     |
@@ -35,7 +37,38 @@
 
 ---
 
-## 2. 标准结构
+## 2. Template 组件拼装
+
+> 源自 `packages/create/variants/uni-manager/src/templates/list-page.tsx`
+
+```tsx
+<PageShell header={<UmTopbar />} sidebar={<Sidebar />}>
+  <UmPageContainer header={<PageHeader title="..." actions={...} />}>
+    {toolbar}       {/* ActionToolbar / SearchCombo / 筛选按钮 */}
+    {children}      {/* DataTable / CardGrid 主内容区 */}
+    {footer}        {/* Pagination / BulkActionBar */}
+  </UmPageContainer>
+</PageShell>
+```
+
+| Slot         | 注入内容                                    | 说明                        |
+| ------------ | ------------------------------------------- | --------------------------- |
+| `topbar`     | UmTopbar                                    | 框架级吃顶（租户/区域切换） |
+| `sidebar`    | Sidebar + 业务菜单                          | 左导                        |
+| `pageHeader` | PageHeader（title + description + actions） | 标题模式 L1                 |
+| `toolbar`    | ActionToolbar / SearchCombo / 筛选行        | PageHeader 下方、主区上方   |
+| `children`   | DataTable / CardGrid                        | 主内容区（撑高）            |
+| `footer`     | Pagination + BulkActionBar                  | 紧贴表格底部                |
+
+**壳层特征**：
+
+- UmPageContainer **无白卡** — 业务组件直接坐在白底主区上
+- 与 OpenTrek 的“内嵌大白卡”对仗：um 主区无额外包裹层
+- footer 紧贴表格底部，页面整体溢出由父级 SidebarInset overflow 接管
+
+---
+
+## 3. 标准结构（设计线框）
 
 ```
 ┌────────────────────────────────────────────┐
@@ -57,7 +90,7 @@
 
 ---
 
-## 3. 必需组件
+## 4. 必需组件
 
 | 组件                          | 位置    | 说明                                                        |
 | ----------------------------- | ------- | ----------------------------------------------------------- |
@@ -70,7 +103,7 @@
 
 ---
 
-## 4. SearchCombo 规范
+## 5. SearchCombo 规范
 
 > ListPage 顶部搜索 + 筛选的标准复合组件。**禁止**用 Input + Select 散件拼装。
 
@@ -131,7 +164,7 @@
 
 ---
 
-## 5. DataTable 规则（核心）
+## 6. DataTable 规则（核心）
 
 ### 5.1 列元规则（每列必备）
 
@@ -205,7 +238,7 @@
 
 ---
 
-## 6. 操作列规范（硬约束）
+## 7. 操作列规范（硬约束）
 
 ### 6.1 结构
 
@@ -228,16 +261,16 @@
 
 ### 6.3 操作列行为映射
 
-| 操作      | 触发     | 前置       | 二次确认           | 目标              | 返回行为                             |
-| --------- | -------- | ---------- | ------------------ | ----------------- | ------------------------------------ |
-| 查看/管理 | 点链接   | —          | 否                 | DetailPage        | 返回列表保持筛选+分页                |
-| 编辑      | 点按钮   | —          | 否                 | FormPage / Drawer | 保存成功返回列表 + Toast「保存成功」 |
-| 删除      | 点按钮   | 资源已停止 | 是（输入资源名称） | Dialog 确认       | 确认后刷新 + Toast「删除成功」       |
-| 更多      | Dropdown | —          | 按操作分级         | Dropdown 菜单     | 选择子操作                           |
+| 操作      | 触发     | 前置       | 二次确认           | 目标             | 返回行为                             |
+| --------- | -------- | ---------- | ------------------ | ---------------- | ------------------------------------ |
+| 查看/管理 | 点链接   | —          | 否                 | DetailPage       | 返回列表保持筛选+分页                |
+| 编辑      | 点按钮   | —          | 否                 | FormPage / Sheet | 保存成功返回列表 + Toast「保存成功」 |
+| 删除      | 点按钮   | 资源已停止 | 是（输入资源名称） | Dialog 确认      | 确认后刷新 + Toast「删除成功」       |
+| 更多      | Dropdown | —          | 按操作分级         | Dropdown 菜单    | 选择子操作                           |
 
 ---
 
-## 7. Card 内对齐规则（硬约束）
+## 8. Card 内对齐规则（硬约束）
 
 水平 padding 分层模型：
 
@@ -270,7 +303,7 @@
 
 ---
 
-## 8. 状态-操作模式
+## 9. 状态-操作模式
 
 ### 8.1 元规则
 
@@ -298,7 +331,7 @@
 ### 8.4 页面间导航交互
 
 - **操作列「查看/管理」** → DetailPage（页面跳转）；面包屑返回，保持筛选+分页
-- **操作列「编辑」** → FormPage 或 Drawer（跳转/侧滑）；保存/取消返回列表，保存附 Toast
+- **操作列「编辑」** → FormPage 或 Sheet（跳转/侧滑）；保存/取消返回列表，保存附 Toast
 - **创建操作** → FormPage（页面跳转）；创建成功/取消返回列表
 - **搜索执行** → 当前列表（数据刷新）；重置到第 1 页
 - **筛选条件变更** → 当前列表（数据刷新）；重置到第 1 页，保持筛选条件
@@ -306,38 +339,38 @@
 
 ---
 
-## 9. 嵌套约束
+## 10. 嵌套约束
 
-| 父子关系                                                                                                    | 状态                         |
-| ----------------------------------------------------------------------------------------------------------- | ---------------------------- |
-| um-topbar → PageContainer → ContentWrapper → Card(白卡容器) → PageHeader/ActionToolbar/DataTable/Pagination | ALLOW                        |
-| ContentWrapper → 业务组件（无 Card 包裹）                                                                   | **FORBID**                   |
-| Card → Card                                                                                                 | **FORBID**（白卡单例）       |
-| ActionToolbar → SearchCombo                                                                                 | ALLOW                        |
-| CardGrid → ItemCard → CardActionBar                                                                         | ALLOW                        |
-| DataTable → Pagination                                                                                      | ALLOW                        |
-| DataTable → Form                                                                                            | **FORBID**（用 Drawer 触发） |
-| 自建 topbar                                                                                                 | **FORBID**（UM1）            |
+| 父子关系                                                                                                    | 状态                        |
+| ----------------------------------------------------------------------------------------------------------- | --------------------------- |
+| um-topbar → PageContainer → ContentWrapper → Card(白卡容器) → PageHeader/ActionToolbar/DataTable/Pagination | ALLOW                       |
+| ContentWrapper → 业务组件（无 Card 包裹）                                                                   | **FORBID**                  |
+| Card → Card                                                                                                 | **FORBID**（白卡单例）      |
+| ActionToolbar → SearchCombo                                                                                 | ALLOW                       |
+| CardGrid → ItemCard → CardActionBar                                                                         | ALLOW                       |
+| DataTable → Pagination                                                                                      | ALLOW                       |
+| DataTable → Form                                                                                            | **FORBID**（用 Sheet 触发） |
+| 自建 topbar                                                                                                 | **FORBID**（UM1）           |
 
 ---
 
-## 10. 禁止项
+## 11. 禁止项
 
-| 禁项                    | 原因                                |
-| ----------------------- | ----------------------------------- |
-| Form 直接出现在内容区   | 应通过 Dialog/Drawer/FormPage 触发  |
-| Chart 出现在标准列表    | 图表归属 Dashboard                  |
-| 内联编辑                | 编辑必须通过 Drawer/Dialog/FormPage |
-| 拖拽排序                | 表格数据为服务端排序                |
-| 无限滚动                | B2B 管理场景需精确分页              |
-| 悬浮操作栏              | 遮挡数据，可发现性差                |
-| 右键菜单                | 移动端不兼容                        |
-| `hr` / section-divider  | 间距通过 padding/margin 控制        |
-| 跨云资源不带 CloudBadge | 违反 UM3                            |
+| 禁项                    | 原因                               |
+| ----------------------- | ---------------------------------- |
+| Form 直接出现在内容区   | 应通过 Dialog/Sheet/FormPage 触发  |
+| Chart 出现在标准列表    | 图表归属 Dashboard                 |
+| 内联编辑                | 编辑必须通过 Sheet/Dialog/FormPage |
+| 拖拽排序                | 表格数据为服务端排序               |
+| 无限滚动                | B2B 管理场景需精确分页             |
+| 悬浮操作栏              | 遮挡数据，可发现性差               |
+| 右键菜单                | 移动端不兼容                       |
+| `hr` / section-divider  | 间距通过 padding/margin 控制       |
+| 跨云资源不带 CloudBadge | 违反 UM3                           |
 
 ---
 
-## 11. 列表页特有自检
+## 12. 列表页特有自检
 
 - [ ] PageHeader / ActionToolbar / DataTable / Pagination 嵌套结构正确
 - [ ] um-topbar 在框架层就位（UM1）