@teamix-evo/skills 0.5.0 → 0.6.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@teamix-evo/skills",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Skills (AI IDE capabilities) for Teamix Evo",
   "type": "module",
   "files": [
@@ -12,7 +12,7 @@
   "devDependencies": {
     "@clack/prompts": "^0.8.0",
     "tsx": "^4.0.0",
-    "@teamix-evo/registry": "0.6.0"
+    "@teamix-evo/registry": "0.7.0"
   },
   "publishConfig": {
     "access": "public",

package/src/teamix-evo-design-opentrek/SKILL.md

@@ -7,58 +7,226 @@ description: |
   Coordinates with: teamix-evo-code-opentrek (run alongside when the screen also creates new files).
 ---
 
-# teamix-evo-design-opentrek
+# 页面规则系统 v7.8.4
 
-> OpenTrek 设计体系 — 面向云控制台与企业级 B2B 产品的现代设计语言。
-> 沉稳、克制、可预期，强调高密度信息下的清晰与效率。
->
-> 本技能是 **完整自包含** 的 OpenTrek 设计规则（非 overlay）。
-> Token 具体值请参照 `tokens/theme.css` 中的 CSS 变量，组件详细 API 通过 MCP `get_component_meta` 按需查询。
+> 本文件是**入口索引**：只负责意图路由 + 文件角色索引。
+> 生成 / 翻新 / 验证的详细执行步骤、GATE 门禁、MUST READ 清单一律在 [generation-flow.md](./generation-flow.md)。
+> 页面类型决策树、子类型识别在 [patterns/page-types.md](./patterns/page-types.md)。
 
-<!-- teamix-evo:managed:start id="core" -->
+路由分发架构 — 根技能负责意图识别和索引路由，详细规则在子技能和 `./rules/` 目录。
+三层参数化架构：元规则（固化）+ 产品配置（灵活）+ 模式细节。
 
-## ⚠️ 执行协议（MANDATORY — 跳步即失败）
+---
+
+## 1. 意图路由
+
+根据用户输入自动判断执行路径，无需用户指定：
+
+| 意图     | 识别关键词                                                           | 路由路径             | 详细流程                                                               |
+| -------- | -------------------------------------------------------------------- | -------------------- | ---------------------------------------------------------------------- |
+| **翻新** | "改造"/"升级"/"替换"/"刷新规范"/"翻新"/"对齐规范"/"重新生成这个页面" | 翻新路径             | 详见 [generation-flow.md §2](./generation-flow.md)                     |
+| **生成** | "生成"/"创建"/"新建"/"设计一个"                                      | 生成路径（六步门控） | 详见 [generation-flow.md §1](./generation-flow.md)                     |
+| **验证** | "检查"/"验证"/"评估"/"合规"/"是否符合规范"                           | 验证路径             | 详见 [generation-flow.md §3](./generation-flow.md)                     |
+| **查询** | "token"/"色值"/"间距"/"字体"/"圆角"/"阴影"/"组件尺寸"                | 查询路径             | 直接读取 `./rules/design-tokens.json` / `./rules/component-specs.json` |
+| **规则** | 其他通用问题（"列表页怎么设计"/"弹窗宽度"/"用什么颜色"）             | 根技能               | 读取对应 `./rules/` 文件回答                                           |
+
+---
+
+## 2. 页面类型索引
+
+| 类型 ID                                                                                           | 中文名 | 核心特征                               | 子技能目录             | 状态   |
+| ------------------------------------------------------------------------------------------------- | ------ | -------------------------------------- | ---------------------- | ------ |
+| ListPage                                                                                          | 列表页 | 多条结构化数据 + 搜索/筛选 + 分页      | `./pages/list-page/`   | 已就绪 |
+| DetailPage                                                                                        | 详情页 | 单条记录只读展示 + 描述列表 + 操作按钮 | `./pages/detail-page/` | 已就绪 |
+| FormPage                                                                                          | 表单页 | 用户输入数据 + 字段校验 + 提交         | `./pages/form-page/`   | 已就绪 |
+| Dashboard                                                                                         | 仪表板 | 数据可视化 / 统计聚合                  | —                      | 待开发 |
+| WizardPage / ResultPage / ExceptionPage / WorkspacePage / KanbanPage / WelcomePage / OverviewPage | —      | 见 patterns/page-types.md              | —                      | 待开发 |
+
+> 决策树、Zone Map、易混点速查、子类型识别详见 [patterns/page-types.md](./patterns/page-types.md)。
+
+---
+
+## 3. 子技能索引
+
+> 📖 **读取顺序**：生成/翻新页面时，**主入口 = `./pages/{type}-page/`**（完整规范与布局硬约束）；`./patterns/{type}-page.md` 仅作为**索引概览**用于快速判断子类型。
+
+| 子技能 ID   | 名称       | 子类型数 | 入口文件                                                                                                                                      |
+| ----------- | ---------- | -------- | --------------------------------------------------------------------------------------------------------------------------------------------- |
+| list-page   | 列表页技能 | 6        | **生成入口**：[`./pages/list-page/`](./pages/list-page/) ← 完整规范 ｜ 索引概览：[`./patterns/list-page.md`](./patterns/list-page.md)         |
+| detail-page | 详情页技能 | 2        | **生成入口**：[`./pages/detail-page/`](./pages/detail-page/) ← 完整规范 ｜ 索引概览：[`./patterns/detail-page.md`](./patterns/detail-page.md) |
+| form-page   | 表单页技能 | 3        | **生成入口**：[`./pages/form-page/`](./pages/form-page/) ← 完整规范 ｜ 索引概览：[`./patterns/form-page.md`](./patterns/form-page.md)         |
+
+### 关键词 → 子技能路由
+
+| 关键词                                 | 路由到                                                                     |
+| -------------------------------------- | -------------------------------------------------------------------------- |
+| "列表"/"表格"/"查询"/"检索"/"数据列表" | → `./pages/list-page/`                                                     |
+| "详情"/"查看"/"信息"/"配置详情"        | → `./pages/detail-page/`                                                   |
+| "表单"/"创建"/"编辑"/"填写"/"新建"     | → `./pages/form-page/`                                                     |
+| "仪表板"/"统计"/"分析"/"指标"          | → [`./patterns/dashboard.md`](./patterns/dashboard.md)（完整子技能待开发） |
+| 其他通用问题                           | 根技能 + `./rules/` 索引                                                   |
+
+### 高频业务场景速查
+
+完整 16 种业务场景映射见 `./rules/business-mapping.json`。核心 6 类：
+
+| 业务场景 | 关键词              | 页面类型       | 返回行为       |
+| -------- | ------------------- | -------------- | -------------- |
+| 查看列表 | 列表/表格/查询/检索 | ListPage       | 带分页和筛选   |
+| 查看详情 | 详情/查看/信息      | DetailPage     | 可返回列表     |
+| 新建记录 | 新建/创建/新增      | FormPage(新建) | 保存后返回列表 |
+| 编辑记录 | 编辑/修改           | FormPage(编辑) | 保存后返回原页 |
+| 删除记录 | 删除/移除           | Dialog         | 确认后刷新列表 |
+| 复制新建 | 复制/克隆           | FormPage(复制) | 保存后返回列表 |
+
+> 完整 CRUD 流转规则见 [flows.md](./flows.md) §3。
+
+---
+
+## 4. 文件角色简表
+
+> 一句话说明每个文件的职责。详细 MUST READ 时机见 [generation-flow.md](./generation-flow.md) 各 Step。
+
+### 4.1 流程与认知文档
+
+| 文件                                       | 作用                                                                                                 |
+| ------------------------------------------ | ---------------------------------------------------------------------------------------------------- |
+| [generation-flow.md](./generation-flow.md) | 生成 / 翻新 / 验证三大路径的完整执行步骤与 GATE 门禁（**唯一执行路径**）                             |
+| [philosophy.md](./philosophy.md)           | 设计哲学四大原则（理解"为什么这么做"）                                                               |
+| [brand.md](./brand.md)                     | 视觉调性 + 文案语气基调 + 视觉五维（圆角/配色/密度/阴影/焦点）                                       |
+| [foundations.md](./foundations.md)         | Token 真值：色彩 / 间距 / 字号 / 圆角 / 阴影 / 动效                                                  |
+| [boundaries.md](./boundaries.md)           | 38 条硬规则：F1-F10 禁止项 + S1-S8 样式规则 + C1-C12 结构 + I1-I4 图标 + FF1-FF4 表单 + Overlay 选型 |
+| [components.md](./components.md)           | 组件双层架构 + 选型决策树 + 拼装配方                                                                 |
+| [checklist.md](./checklist.md)             | 10 项自检清单（Step 7 必读）                                                                         |
+| [flows.md](./flows.md)                     | **页间流转唯一真值源**：四条用户旅程 + 主流转图 + CRUD 速查 + 资源生命周期 + 流转设计规则            |
+
+### 4.2 模式文档（patterns/）
+
+| 文件                                                     | 作用                                                                                             |
+| -------------------------------------------------------- | ------------------------------------------------------------------------------------------------ |
+| [patterns/page-types.md](./patterns/page-types.md)       | 页面类型决策树 + Zone Map + 易混点判定                                                           |
+| [patterns/list-page.md](./patterns/list-page.md)         | 列表页 6 种子类型规格（standard / pure-card / standard-card / drawer / expandable / l2-sidebar） |
+| [patterns/detail-page.md](./patterns/detail-page.md)     | 详情页 2 种子类型规格（tabbed / single-section）                                                 |
+| [patterns/form-page.md](./patterns/form-page.md)         | 表单页 3 种子类型规格（single-page / wizard / drawer-form）                                      |
+| [patterns/dashboard.md](./patterns/dashboard.md)         | 仪表板模式（待开发）                                                                             |
+| [patterns/color-mapping.md](./patterns/color-mapping.md) | 语义色映射表（Step 6 必读）                                                                      |
+
+### 4.3 规则文件（rules/）
 
-收到页面相关请求时，**必须先识别意图，再进入对应的唯一执行路径**。不允许跳过路径中的任何步骤。
+按读取层次分组，需要时按需读取：
 
-### 意图路由
+**① 基础定义层**（"有什么"）
 
-| 意图     | 识别关键词                                         | 唯一执行路径                                                            |
-| -------- | -------------------------------------------------- | ----------------------------------------------------------------------- |
-| **生成** | "生成" / "创建" / "新建" / "设计一个" / "做一个"   | **必须完整执行** [generation-flow.md](./generation-flow.md) §1 七步门控 |
-| **翻新** | "改造" / "升级" / "翻新" / "对齐规范" / "重新生成" | **必须完整执行** [generation-flow.md](./generation-flow.md) §2 翻新路径 |
-| **验证** | "检查" / "验证" / "评估" / "是否符合规范"          | **必须完整执行** [generation-flow.md](./generation-flow.md) §3 验证路径 |
-| **查询** | "token" / "色值" / "间距" / "组件尺寸" / "圆角"    | → [foundations.md](./foundations.md)（MCP `tokens_*` 工具规划中）       |
+| 文件                             | 作用                                                       |
+| -------------------------------- | ---------------------------------------------------------- |
+| `./rules/page-frame.json`        | L0/L1/L2 页面框架规范 + 框架组件继承 + 响应式规则          |
+| `./rules/page-types.json`        | 12 种页面类型 JSON 定义                                    |
+| `./rules/business-mapping.json`  | 16 个业务场景映射（含关键词数组 / 子技能目录 / CRUD 映射） |
+| `./rules/common-components.json` | 40 个业务组件索引（v4.0，以组件名为唯一标识）              |
 
-### 不可跳过的前置读取
+**② 布局规则层**（"怎么排"）
 
-无论哪种意图，进入 generation-flow.md 后**每个 Step 都有明确的 MUST READ 文件清单**。AI 不得凭"已有知识"跳过任何文件读取 — 每次任务必须重新读取，因为文件内容可能已更新。
+| 文件                        | 作用                                            |
+| --------------------------- | ----------------------------------------------- |
+| `./rules/layout-rules.json` | 4 种布局模式（A/B/C/D）+ PageContainer 嵌套约束 |
+| `./rules/page-flow.json`    | CRUD 页面流转 + 导航 + 操作确认三级规范         |
 
-### 禁止行为
+**③ 视觉规范层**（"长什么样"）
+
+| 文件                         | 作用                                                             |
+| ---------------------------- | ---------------------------------------------------------------- |
+| `./rules/design-tokens.json` | 语义化色值 / 间距 / 字体 / 尺寸 / 断点（锚定 TrekClaw v4.1 CSS） |
+| `./rules/design-tokens.css`  | 完整 CSS 变量定义（:root 变量块），HTML 内联 / TSX `@import`     |
+
+**④ 实现约束层**（"怎么写"）
+
+| 文件                           | 作用                                                                                          |
+| ------------------------------ | --------------------------------------------------------------------------------------------- |
+| `./rules/component-specs.json` | 26 条组件精确尺寸约束 C1-C26（Button / Input / Dialog / Table / Select / DescriptionList 等） |
+| `./rules/styling.json`         | S1-S8 样式规则 + F1-F10 禁止项                                                                |
+
+### 4.4 范例文档（examples/）
+
+| 文件                                  | 作用                                               |
+| ------------------------------------- | -------------------------------------------------- |
+| `./examples/standard-table-list.html` | 标准表格列表参考范例（表格列规范 / 操作列 / 分页） |
+| `./examples/standard-card-list.html`  | 卡片列表参考范例（CardGrid / ItemCard 结构）       |
+| `./examples/detail-page.html`         | 详情页参考范例（L2 框架 / Tabs / DescriptionList） |
+| `./examples/wizard-form-page.html`    | 向导表单参考范例（Steps / 动态底栏 / 校验）        |
+
+---
+
+## 5. 通用组件分层（速查）
+
+子技能通过**组件名**引用，通过 `shadcnComponent` 字段定位 @teamix-evo/ui 实现。完整索引见 `./rules/common-components.json` v4.0。
+
+- **核心业务组件**：TopNavigation / Sidebar / PageHeader / Breadcrumb / Pagination / Dialog / Sheet / Button / Tag / Badge / Select / Input / Tooltip / Separator / Empty / Spinner / Alert / Sonner
+- **业务扩展组件**：SearchCombo / ContextSwitcher / Steps / ItemCard / CardGrid / CardActionBar
+- **详情页组件**：DescriptionList / DescriptionItem / InfoCard（component-specs.json C26）
+
+---
+
+## 6. 全局执行约束
+
+> 所有路径共享的硬约束。生成代码时强制遵守，违反即不合规。Step 级 Token 用法详见 [generation-flow.md](./generation-flow.md) Step 6。
+
+### 6.1 组件选用优先级（不得跳级）
+
+```
+优先级 1：./rules/ 中已定义的规范组件
+         → common-components.json / component-specs.json / boundaries.md
+优先级 2：@teamix-evo/ui 原子组件合理拼装
+         → 遵循 styling.json 的 S1-S8 + F1-F10
+优先级 3：自定义实现（仅当以上均无法满足）
+         → 必须 <!-- CUSTOM: 原因 --> 标注 + 在 common-components.json 注册 shadcnComponent
+```
+
+### 6.2 Token 引用格式（速查）
+
+所有视觉属性必须引用 Token，禁止硬编码。完整 Token 定义见 [foundations.md](./foundations.md)。
+
+| 属性类别 | 正确写法                                    | 禁止写法                           |
+| -------- | ------------------------------------------- | ---------------------------------- |
+| 颜色     | `hsl(var(--token-name))`                    | `#0055EE`、`rgb(0,85,238)`、`blue` |
+| 间距     | Token 变量或 Tailwind spacing class         | 裸写 `16px`、`1rem`                |
+| 字号     | `var(--font-size-*)` 四级（base/lg/xl/2xl） | 裸写 `14px`、`0.875rem`            |
+| 圆角     | `var(--radius-*)` 层级（sm/md/lg）          | 裸写 `8px`、`0.5rem`               |
+| 阴影     | `var(--shadow-*)`                           | 裸写 `0 1px 3px rgba(...)`         |
+| 字体族   | `var(--font-sans)` / `var(--font-mono)`     | 裸写 `Inter, sans-serif`           |
+
+### 6.3 标准范例引用
+
+生成页面前**必须**参考对应类型的标准范例（见 §4.4 examples/），作为输出质量基准。
+
+### 6.4 设计语言一致性
+
+| 维度     | 约束                                                                 | 依据                                   |
+| -------- | -------------------------------------------------------------------- | -------------------------------------- |
+| 间距模型 | v7.5 分层 padding：Card.paddingX = 20px，Table 首末列 padding = 20px | `design-tokens.json` §componentSpacing |
+| 品牌主色 | #0055EE（HSL 218.6° 100% 46.7%），通过 `var(--primary)` 引用         | `design-tokens.css`                    |
+| 页面框架 | 遵循 `page-frame.json` 的 L0/L1/L2 层级继承                          | `./rules/page-frame.json`              |
+| 布局模式 | 遵循 `layout-rules.json` 的 A/B/C/D 四种模式 + 扩展模式              | `./rules/layout-rules.json`            |
+| 页面流转 | 遵循 `page-flow.json` 的 CRUD 路径与导航规范                         | `./rules/page-flow.json`               |
+| 表面规则 | v7.6 ContentCard：去 border，使用 shadow-sm                          | `styling.json`                         |
+| 设计原则 | 优先使用已有组件 → 组合而非重写 → 优先内置 variant → 使用语义色值    | `foundations.md`                       |
+
+### 6.5 降级拼装规则
+
+当规范中未定义某组件需求时，使用 @teamix-evo/ui 拼装须满足：
+
+1. **结构合规**：通过 `boundaries.md` C1-C12 校验
+2. **样式合规**：通过 `styling.json` F1-F10 自检
+3. **Token 合规**：所有视觉属性引用 Token，无硬编码
+4. **语义清晰**：使用 @teamix-evo/ui 的 variant 体系
+5. **可追溯**：HTML 注释中标注拼装来源和决策原因
+
+---
 
-- ❌ 跳过 generation-flow.md 直接写代码
-- ❌ 只读 patterns/\*.md 不读 philosophy.md / boundaries.md / foundations.md
-- ❌ 选择性读取（"这个文件我已经知道内容了"）
-- ❌ 把 SKILL.md 文件索引当作"我可以只挑一个读"的菜单
+## 7. 与 code-opentrek skill 协作
 
-## 文件索引
+页面级任务通常 design + code 两个 skill 同时触发。冲突时按 ADR 0018：
 
-| 文件                                                     | 职责                                                                  |
-| -------------------------------------------------------- | --------------------------------------------------------------------- |
-| [philosophy.md](./philosophy.md)                         | 设计哲学 + 四大原则 + 方法论                                          |
-| [generation-flow.md](./generation-flow.md)               | AI 六步生成/翻新/验证流程                                             |
-| [boundaries.md](./boundaries.md)                         | 硬约束：F/FF/S/C/I 五组共 38 条规则([ERROR]/[WARN])                   |
-| [checklist.md](./checklist.md)                           | 10 项自检清单                                                         |
-| [foundations.md](./foundations.md)                       | Token 用法 + 排版 + 间距 + 色彩 + 圆角 + 阴影 + 动效                  |
-| [components.md](./components.md)                         | 组件选型决策树 + 双层架构索引 + 组合规则                              |
-| [patterns/page-types.md](./patterns/page-types.md)       | 5 种页面类型 + 识别决策树 + Zone Map + 页间流转(§6)                   |
-| [patterns/list-page.md](./patterns/list-page.md)         | 列表页模式 (6 种子类型)                                               |
-| [patterns/detail-page.md](./patterns/detail-page.md)     | 详情页模式                                                            |
-| [patterns/form-page.md](./patterns/form-page.md)         | 表单页模式 (含 wizard)                                                |
-| [patterns/dashboard.md](./patterns/dashboard.md)         | Dashboard 数据概览(StatCard / Chart 标准结构)                         |
-| [patterns/sidebar.md](./patterns/sidebar.md)             | 侧边栏统一规范（3 级 / 2 级结构、收起态、品牌色槽位、禁止清单）       |
-| [patterns/color-mapping.md](./patterns/color-mapping.md) | v4.1 语义色映射表（主色 / 状态 5 档 / gray 8 / accent 10 / chart 10） |
-| [flows.md](./flows.md)                                   | 4 条核心用户旅程 + 流转自检                                           |
-| [brand.md](./brand.md)                                   | OpenTrek 品牌调性 + 文案语气 + 正反例                                 |
+- **design 决定"做什么"**：页面骨架 / Zone 划分 / 组件选型 / Token 绑定 / 视觉规则
+- **code 决定"怎么做"**：文件放置 / import 路径 / API 层 / 表单实现细节
 
-<!-- teamix-evo:managed:end -->
+> 完整分工矩阵见 [generation-flow.md §5](./generation-flow.md)。

package/src/teamix-evo-design-opentrek/boundaries.md

@@ -279,7 +279,7 @@ CSS 变量已在 dark 模式下自动切换。手动 `dark:` 会绕过主题系
 + <Dialog><DialogContent>
 ```
 
-适用：`Dialog / Sheet / Drawer / Popover / Tooltip / DropdownMenu / HoverCard`。组件自带层级管理。
+适用：`Dialog / Sheet / Popover / Tooltip / DropdownMenu / HoverCard`。组件自带层级管理。
 
 > 检查: 无 lint (运行时 / 评审,可由 reviewer subagent 抽检)
 
@@ -326,7 +326,7 @@ CSS 变量已在 dark 模式下自动切换。手动 `dark:` 会绕过主题系
 
 > 检查: 无 lint (后续可加 ESLint JSX 结构规则,目前由 reviewer subagent 抽检)
 
-### [ERROR] C2 · Dialog / Sheet / Drawer 必须有 Title
+### [ERROR] C2 · Dialog / Sheet 必须有 Title
 
 ```diff
 - <DialogContent>...</DialogContent>
@@ -516,7 +516,7 @@ CSS 变量已在 dark 模式下自动切换。手动 `dark:` 会绕过主题系
 | 需要输入的任务         | `Dialog`                            |
 | 危险操作确认           | `AlertDialog variant="destructive"` |
 | 侧面板（详情 / 筛选）  | `Sheet`                             |
-| 移动端底部面板         | `Drawer`                            |
+| 移动端底部面板         | `Sheet side="bottom"`               |
 | 悬浮信息（hover 触发） | `HoverCard`                         |
 | 点击弹出小内容         | `Popover`                           |
 

package/src/teamix-evo-design-opentrek/components.md

@@ -63,41 +63,41 @@ ui 多原子最小拼装（万不得已，注释声明）
    - `navigation`：Breadcrumb / Pagination / DropdownMenu / Steps / NavigationMenu / Tabs
    - `data-entry`：参见 §3.6 输入控件
    - `data-display`：参见 §3.4 / §3.5；含 Accordion / Tooltip / Table / DataTable / Badge / Tag / Avatar / Descriptions / Statistic
-   - `feedback`：Alert / Dialog / Drawer / Sheet / Popover / Progress / Spinner / Empty / Skeleton / Toast
+   - `feedback`：Alert / Dialog / Sheet（抽屉） / Popover / Progress / Spinner / Empty / Skeleton / Sonner
    - `deprecated`：不出现在 `list_components` 默认结果，无视
 3. **能力边界核对**：候选单体用 `get_component_meta(name)` 确认 Props 是否承载所需语义，避免"看名字像"实际不通
 
 **典型语义近似映射**（仅示例，使用前仍需 MCP 实查）：
 
-| 找不到的概念       | 优先尝试单体（语义近似）               | 万不得已的拼装兜底                |
-| ------------------ | -------------------------------------- | --------------------------------- |
-| `ItemCard`         | `card`（直接用）                       | CardHeader + CardContent + Footer |
-| `SearchCombo`      | `filter-bar`（直接用）                 | Input + Select + Button           |
-| `ContextSwitcher`  | `combobox` / `dropdown-menu`（直接用） | command + popover + avatar        |
-| `Empty` / `NoData` | `empty`（直接用）                      | div + Icon + Text                 |
-| `Loading`          | `spinner` / `skeleton`（直接用）       | div + animate-spin                |
-| `ConfirmDialog`    | `alert-dialog`（直接用）               | dialog + button + text            |
-| `StatusTag`        | `badge` / `tag`（按 §3.3）             | div + dot + text                  |
+| 找不到的概念       | 优先尝试单体（语义近似）                        | 万不得已的拼装兜底                |
+| ------------------ | ----------------------------------------------- | --------------------------------- |
+| `ItemCard`         | `card`（直接用）                                | CardHeader + CardContent + Footer |
+| `SearchCombo`      | `filter-bar`（直接用）                          | Input + Select + Button           |
+| `ContextSwitcher`  | `dropdown-menu` / `command` + `popover`（拼装） | command + popover + avatar        |
+| `Empty` / `NoData` | `empty`（直接用）                               | div + Icon + Text                 |
+| `Loading`          | `spinner` / `skeleton`（直接用）                | div + animate-spin                |
+| `ConfirmDialog`    | `alert-dialog`（直接用）                        | dialog + button + text            |
+| `StatusTag`        | `badge` / `tag`（按 §3.3）                      | div + dot + text                  |
 
 **严禁反模式**：
 
 - 单体语义等价时仍按概念名拼装（例：明明有 `empty` 偏写 `<div className="flex flex-col items-center"><Icon><span>暂无数据</span></div>`）
-- 把"最小拼装"理解为"多原子捆绑就行"，而不是先**穷尽 89 件单体**
+- 把"最小拼装"理解为"多原子捆绑就行"，而不是先**穷尽 88 件单体**
 
 ---
 
 ## 1. 双层组件架构（实物归属）
 
-| 层级                                       | 来源                          | 实物清单（截至当前 variant）                                                                                                                                                                                                                                    |
-| ------------------------------------------ | ----------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **业务扩展层（biz-ui，opentrek variant）** | `@teamix-evo/biz-ui/opentrek` | 仅 2 个实物：`list-card`、`op-sidebar`。其余 `business/` 目录为文档草稿，**不可 import**。                                                                                                                                                                      |
-| **ui 实现层（shadcn 原子）**               | `@teamix-evo/ui`              | ≈ 89 个原子/复合组件。包含 **PageHeader / Pagination / Steps / Tabs / Tooltip / DataTable / FilterBar / Combobox(=command) / AutoComplete / DatePicker / Drawer / Sheet / Dialog / AlertDialog / Card / Badge / Tag / Alert / Toast(sonner) / Form** 等高频件。 |
+| 层级                                       | 来源                          | 实物清单（截至当前 variant）                                                                                                                                                                                                     |
+| ------------------------------------------ | ----------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **业务扩展层（biz-ui，opentrek variant）** | `@teamix-evo/biz-ui/opentrek` | 3 个实物：`list-card`、`op-sidebar`、`op-page-container`。其余 `business/` 目录为文档草稿，**不可 import**。                                                                                                                     |
+| **ui 实现层（shadcn 原子）**               | `@teamix-evo/ui`              | ≈ 76 个原子/复合组件。包含 **PageHeader / Pagination / Steps / Tabs / Tooltip / DataTable / FilterBar / Command / Combobox / DatePicker / Sheet / Dialog / AlertDialog / Card / Badge / Tag / Alert / Sonner / Form** 等高频件。 |
 
 ### 1.1 选型铁律
 
-1. **优先 biz-ui 实物层** — 已封装变体 + 文案规范，但**注意 opentrek 当前仅 2 个实物**。
+1. **优先 biz-ui 实物层** — 已封装变体 + 文案规范，但**注意 opentrek 当前仅 3 个实物**。
 2. **biz-ui 无实物 → ui 单体精确名匹配** — 按组件名 / 显式语义直查 `find_components`。
-3. **精确名未命中 → ui 单体语义近似扫描**（见 §0.4） — 在 89 件里找等价单体直接用，**这一步不可跳**。
+3. **精确名未命中 → ui 单体语义近似扫描**（见 §0.4） — 在 88 件里找等价单体直接用，**这一步不可跳**。
 4. **单体彻底无等价 → §5 多原子最小拼装** — 仅作为单体穷尽后的兜底。
 5. **禁止**自造同名组件（违反 reuse-first，详见 §0）。
 
@@ -121,7 +121,7 @@ ui 多原子最小拼装（万不得已，注释声明）
 
 ## 3. 选型决策树
 
-### 3.1 反馈与确认 — Dialog vs Sheet vs Drawer vs Popover
+### 3.1 反馈与确认 — Dialog vs Sheet vs Popover
 
 ```text
 需要用户做出决定 / 阻塞主流程？
@@ -130,7 +130,7 @@ ui 多原子最小拼装（万不得已，注释声明）
 │   └─ 复杂表单（< 8 字段）→ Dialog
 └─ 否
     ├─ 临时编辑/筛选（侧边滑出）→ Sheet
-    ├─ 多级下探查看（侧边可叠层）→ Drawer
+    ├─ 多级下探查看（侧边可叠层）→ Sheet（多层叠加模式）
     ├─ 内容预览/上下文操作（小气泡）→ Popover
     └─ 仅展示信息（鼠标悬浮）→ Tooltip
 ```
@@ -146,17 +146,17 @@ ui 多原子最小拼装（万不得已，注释声明）
 
 > 来源：Teamix-UI 容器规范。
 
-| 类别       | 容器                                            | 何时使用                                         |
-| ---------- | ----------------------------------------------- | ------------------------------------------------ |
-| **操作型** | 全页面（FormPage）                              | 字段多 / 步骤多 / 需要持久 URL                   |
-| **操作型** | 弹窗模态（Dialog）                              | 阻塞主流程的简短确认或表单；最多 2 级，不再深入  |
-| **操作型** | 气泡（Popconfirm）                              | 二次确认（删除/解绑），轻量提示                  |
-| **展示型** | 全页面（DetailPage）                            | 完整信息查看，路由可分享                         |
-| **展示型** | 抽屉非模态（Sheet）                             | 不阻塞主流程，可保留上下文（如侧栏 Detail）      |
-| **展示型** | 抽屉模态（Drawer）                              | 多级下探查看（如资源 → 子资源 → 配置），逐层推出 |
-| **展示型** | 弹窗模态（Dialog）                              | 一次性展示重要信息                               |
-| **展示型** | 卡片（Card）                                    | 同级信息分组；卡片之间间距 16px                  |
-| **展示型** | 通知反馈（Toast/Sonner / Alert / Notification） | 瞬时反馈 / 页面级横幅 / 系统通知                 |
+| 类别       | 容器                       | 何时使用                                         |
+| ---------- | -------------------------- | ------------------------------------------------ |
+| **操作型** | 全页面（FormPage）         | 字段多 / 步骤多 / 需要持久 URL                   |
+| **操作型** | 弹窗模态（Dialog）         | 阻塞主流程的简短确认或表单；最多 2 级，不再深入  |
+| **操作型** | 气泡（Popconfirm）         | 二次确认（删除/解绑），轻量提示                  |
+| **展示型** | 全页面（DetailPage）       | 完整信息查看，路由可分享                         |
+| **展示型** | 抽屉非模态（Sheet）        | 不阻塞主流程，可保留上下文（如侧栏 Detail）      |
+| **展示型** | 抽屉模态（Sheet 多层叠加） | 多级下探查看（如资源 → 子资源 → 配置），逐层推出 |
+| **展示型** | 弹窗模态（Dialog）         | 一次性展示重要信息                               |
+| **展示型** | 卡片（Card）               | 同级信息分组；卡片之间间距 16px                  |
+| **展示型** | 通知反馈（Sonner / Alert） | 瞬时反馈 / 页面级横幅 / 系统通知                 |
 
 ### 3.3 状态展示 — Badge vs Tag vs Alert
 
@@ -195,14 +195,14 @@ ui 多原子最小拼装（万不得已，注释声明）
 ```text
 枚举值 ≤ 7 → RadioGroup（一屏可见）
 枚举值 8~30 → Select
-枚举值 > 30 / 需搜索 → Combobox（= ui command）
-多选 → MultiSelect / Checkbox
+枚举值 > 30 / 需搜索 → Combobox（输入即建议，支持 multiple 多选）或 Command + Popover 拼装
+多选 → Combobox (multiple={true}) / Checkbox
 数值（整数/小数/金额）→ InputNumber（带 min/max/step/precision）
 数值范围可视化 → Slider（仅用于资源配比/阈值的拖拽式选择）
 日期 → DatePicker / DateRangePicker
-富文本 → Textarea / RichEditor
+富文本 → Textarea
 文件 → Upload
-自动补全 → AutoComplete
+自动补全 → Combobox
 ```
 
 ---
@@ -224,15 +224,16 @@ ui 多原子最小拼装（万不得已，注释声明）
 
 ## 5. 业务扩展层（候补）— 实物 vs 概念 + 拼凑配方
 
-> opentrek variant 当前**只有 2 个**实物业务组件：`list-card`、`op-sidebar`。
+> opentrek variant 当前有 **3 个**实物业务组件：`list-card`、`op-sidebar`、`op-page-container`。
 > 以下表格区分"已实物化"与"概念占位（用 ui 拼装）"。
 
 ### 5.1 已实物化（直接使用）
 
-| 组件           | 用途                              | 归属            |
-| -------------- | --------------------------------- | --------------- |
-| **list-card**  | 列表页卡片化展示（替代 ItemCard） | biz-ui/opentrek |
-| **op-sidebar** | 主导航侧栏                        | biz-ui/opentrek |
+| 组件                  | 用途                                      | 归属            |
+| --------------------- | ----------------------------------------- | --------------- |
+| **list-card**         | 列表页卡片化展示（替代 ItemCard）         | biz-ui/opentrek |
+| **op-sidebar**        | 主导航侧栏                                | biz-ui/opentrek |
+| **op-page-container** | 页面容器（白卡 + 间距 + PageHeader 插槽） | biz-ui/opentrek |
 
 ### 5.2 概念占位（按配方拼装）
 
@@ -287,7 +288,7 @@ ui 多原子最小拼装（万不得已，注释声明）
 - [ ] 已先用 `find_components` 验证组件存在性（不靠默认）
 - [ ] biz-ui 命中失败 → **先按 §0.4 扫所有 ui 单体找语义近似替代**，单体覆盖时直接采用，未直接跳到 §5 拼装
 - [ ] 单体彻底无等价时 → §5 拼装代码必加注释 `// 已扫尽 89 件 ui 单体无语义等价 → 拼装`
-- [ ] 反馈 / 确认场景按容量选 Dialog / Sheet / Drawer / Popover
+- [ ] 反馈 / 确认场景按容量选 Dialog / Sheet / Popover
 - [ ] 容器层级 ≤ 3，弹窗最多 2 级，超过则跳转全页面
 - [ ] 卡片列表优先 biz-ui `list-card`，否则用 `card[] + grid` 拼
 - [ ] 表格 ≤ 6 列，超过改 DataTable + 列控制