@teamix-evo/skills 0.5.0 → 0.7.0

package/src/teamix-evo-design-opentrek/rules/token-mapping.md

@@ -0,0 +1,284 @@
+# Token Mapping — TrekClaw v4.1 → teamix-evo
+
+> **目标**：建立 `rules/design-tokens.{json,css}` 中 TrekClaw v4.1 token 命名 → `@teamix-evo/tokens/variants/opentrek/theme.css` Tailwind v4 `@theme` 命名 的对照关系。
+>
+> **背景**：本目录下的 `design-tokens.json` / `design-tokens.css` 来自 teamixDsgSys 仓库的 TrekClaw v4.1 token 体系，作为 OpenTrek skill 的参考规则；已按本文件迁移为 teamix-evo 命名。
+>
+> **使用提示**：AI 生成代码时优先使用 Tailwind v4 utility（`bg-primary` / `text-foreground` / `rounded-md` 等），底层即映射到 `--color-*` / `--radius-*`。仅在需要原生 CSS 时引用 `var(--color-token-name)`。
+
+---
+
+## 1. 映射策略总览
+
+| 类别                                                      | 命名变化                                              | 数量    | 备注                                              |
+| --------------------------------------------------------- | ----------------------------------------------------- | ------- | ------------------------------------------------- |
+| **颜色 token**                                            | `--xxx` → `--color-xxx`                               | 105     | 对齐 Tailwind v4 `@theme { --color-* }` 命名      |
+| **状态语义重命名**                                        | `--primary-click` → `--color-primary-pressed`         | 1       | teamix-evo 用 `pressed` 命名按下态                |
+| **Shadow 命名空间统一**                                   | `--dialog-shadow` → `--shadow-dialog`                 | 1       | teamix-evo 命名空间为 `--shadow-*`                |
+| **非颜色 token**（spacing / radius / font / duration 等） | 保持原名                                              | 60+     | 已与 teamix-evo 一致，无需重命名                  |
+| **legacy 别名 / 无对应 token**                            | 保留原名，标记 TODO                                   | 28      | 见下表「无 teamix-evo 对应的 token (TODO)」       |
+
+迁移规则总数：**107 项**（颜色 105 + 显式重命名 2）。
+
+---
+
+## 2. 颜色 Token 完整对照表
+
+### 2.1 Brand / 主色
+
+| TrekClaw v4.1            | teamix-evo                       | 备注                              |
+| ------------------------ | -------------------------------- | --------------------------------- |
+| `--primary`              | `--color-primary`                | #0055EE                           |
+| `--primary-foreground`   | `--color-primary-foreground`     |                                   |
+| `--primary-hover`        | `--color-primary-hover`          |                                   |
+| `--primary-click`        | `--color-primary-pressed`        | **重命名**：click → pressed       |
+| `--primary-glow`         | `--color-primary-glow`           |                                   |
+
+### 2.2 Accent 10 色
+
+| TrekClaw v4.1         | teamix-evo                  |
+| --------------------- | --------------------------- |
+| `--accent-blue`       | `--color-accent-blue`       |
+| `--accent-violet`     | `--color-accent-violet`     |
+| `--accent-apricot`    | `--color-accent-apricot`    |
+| `--accent-indigo`     | `--color-accent-indigo`     |
+| `--accent-green`      | `--color-accent-green`      |
+| `--accent-magenta`    | `--color-accent-magenta`    |
+| `--accent-turquoise`  | `--color-accent-turquoise`  |
+| `--accent-orange`     | `--color-accent-orange`     |
+| `--accent-berry`      | `--color-accent-berry`      |
+| `--accent-olive`      | `--color-accent-olive`      |
+
+### 2.3 Gray 8 级语义
+
+| TrekClaw v4.1                    | teamix-evo                              |
+| -------------------------------- | --------------------------------------- |
+| `--gray-primary`                 | `--color-gray-primary`                  |
+| `--gray-primary-foreground`      | `--color-gray-primary-foreground`       |
+| `--gray-secondary-foreground`    | `--color-gray-secondary-foreground`     |
+| `--muted-foreground`             | `--color-muted-foreground`              |
+| `--gray-disabled`                | `--color-gray-disabled`                 |
+| `--gray-line`                    | `--color-gray-line`                     |
+| `--gray-sidebar-accent`          | `--color-gray-sidebar-accent`           |
+| `--gray-muted`                   | `--color-gray-muted`                    |
+| `--gray-white`                   | `--color-gray-white`                    |
+
+### 2.4 shadcn 标准语义
+
+| TrekClaw v4.1            | teamix-evo                     |
+| ------------------------ | ------------------------------ |
+| `--foreground`           | `--color-foreground`           |
+| `--border`               | `--color-border`               |
+| `--input`                | `--color-input`                |
+| `--ring`                 | `--color-ring`                 |
+| `--card`                 | `--color-card`                 |
+| `--card-foreground`      | `--color-card-foreground`      |
+| `--popover`              | `--color-popover`              |
+| `--popover-foreground`   | `--color-popover-foreground`   |
+| `--secondary`            | `--color-secondary`            |
+| `--secondary-foreground` | `--color-secondary-foreground` |
+| `--muted`                | `--color-muted`                |
+| `--accent`               | `--color-accent`               |
+| `--accent-foreground`    | `--color-accent-foreground`    |
+
+### 2.5 Background
+
+| TrekClaw v4.1          | teamix-evo                   |
+| ---------------------- | ---------------------------- |
+| `--background`         | `--color-background`         |
+| `--background-dark`    | `--color-background-dark`    |
+| `--background-panel`   | `--color-background-panel`   |
+
+### 2.6 状态色（Success / Destructive / Warning / Info）
+
+| TrekClaw v4.1               | teamix-evo                          |
+| --------------------------- | ----------------------------------- |
+| `--success`                 | `--color-success`                   |
+| `--success-foreground`      | `--color-success-foreground`        |
+| `--success-hover`           | `--color-success-hover`             |
+| `--success-pressed`         | `--color-success-pressed`           |
+| `--success-bg`              | `--color-success-bg`                |
+| `--success-border`          | `--color-success-border`            |
+| `--destructive`             | `--color-destructive`               |
+| `--destructive-foreground`  | `--color-destructive-foreground`    |
+| `--destructive-hover`       | `--color-destructive-hover`         |
+| `--destructive-pressed`     | `--color-destructive-pressed`       |
+| `--destructive-bg`          | `--color-destructive-bg`            |
+| `--destructive-border`      | `--color-destructive-border`        |
+| `--warning`                 | `--color-warning`                   |
+| `--warning-foreground`      | `--color-warning-foreground`        |
+| `--warning-hover`           | `--color-warning-hover`             |
+| `--warning-pressed`         | `--color-warning-pressed`           |
+| `--warning-bg`              | `--color-warning-bg`                |
+| `--warning-border`          | `--color-warning-border`            |
+| `--info`                    | `--color-info`                      |
+| `--info-foreground`         | `--color-info-foreground`           |
+| `--info-hover`              | `--color-info-hover`                |
+| `--info-pressed`            | `--color-info-pressed`              |
+| `--info-bg`                 | `--color-info-bg`                   |
+| `--info-border`             | `--color-info-border`               |
+| `--info-light`              | `--color-info-light`                |
+
+> teamix-evo 额外提供 `--color-success-subtle` / `--color-warning-subtle` / `--color-info-subtle`（`*-bg` 的 legacy 别名），TrekClaw 无对应别名，AI 生成时直接使用 `--color-*-bg` 即可。
+>
+> teamix-evo 额外提供 Help 档（黄色 `--color-help` / `--color-help-foreground` / `--color-help-bg` / `--color-help-border`，色相 45°），用于 Tag 的 `status='help'` 档位；TrekClaw v4.1 无此档，AI 在 OpenTrek 业务页中暂不需要使用。
+
+### 2.7 Charts 10 色
+
+| TrekClaw v4.1   | teamix-evo            |
+| --------------- | --------------------- |
+| `--chart-1`     | `--color-chart-1`     |
+| `--chart-2`     | `--color-chart-2`     |
+| `--chart-3`     | `--color-chart-3`     |
+| `--chart-4`     | `--color-chart-4`     |
+| `--chart-5`     | `--color-chart-5`     |
+| `--chart-6`     | `--color-chart-6`     |
+| `--chart-7`     | `--color-chart-7`     |
+| `--chart-8`     | `--color-chart-8`     |
+| `--chart-9`     | `--color-chart-9`     |
+| `--chart-10`    | `--color-chart-10`    |
+
+### 2.8 Topbar / Sidebar / 类型标识 / 状态点 / 终端
+
+| TrekClaw v4.1                       | teamix-evo                                  |
+| ----------------------------------- | ------------------------------------------- |
+| `--topbar`                          | `--color-topbar`                            |
+| `--topbar-foreground`               | `--color-topbar-foreground`                 |
+| `--topbar-divider`                  | `--color-topbar-divider`                    |
+| `--sidebar`                         | `--color-sidebar`                           |
+| `--sidebar-foreground`              | `--color-sidebar-foreground`                |
+| `--sidebar-active`                  | `--color-sidebar-active`                    |
+| `--sidebar-active-foreground`       | `--color-sidebar-active-foreground`         |
+| `--sidebar-hover`                   | `--color-sidebar-hover`                     |
+| `--sidebar-title`                   | `--color-sidebar-title`                     |
+| `--sidebar-group`                   | `--color-sidebar-group`                     |
+| `--sidebar-item`                    | `--color-sidebar-item`                      |
+| `--sidebar-item-muted`              | `--color-sidebar-item-muted`                |
+| `--sidebar-accent`                  | `--color-sidebar-accent`                    |
+| `--sidebar-accent-foreground`       | `--color-sidebar-accent-foreground`         |
+| `--sidebar-border`                  | `--color-sidebar-border`                    |
+| `--sidebar-ring`                    | `--color-sidebar-ring`                      |
+| `--sidebar-primary`                 | `--color-sidebar-primary`                   |
+| `--sidebar-primary-foreground`      | `--color-sidebar-primary-foreground`        |
+| `--avatar-bg`                       | `--color-avatar-bg`                         |
+| `--type-api`                        | `--color-type-api`                          |
+| `--type-api-light`                  | `--color-type-api-light`                    |
+| `--type-api-border`                 | `--color-type-api-border`                   |
+| `--type-mcp`                        | `--color-type-mcp`                          |
+| `--type-mcp-light`                  | `--color-type-mcp-light`                    |
+| `--type-mcp-border`                 | `--color-type-mcp-border`                   |
+| `--status-running`                  | `--color-status-running`                    |
+| `--status-stopped`                  | `--color-status-stopped`                    |
+| `--status-error`                    | `--color-status-error`                      |
+| `--terminal`                        | `--color-terminal`                          |
+| `--terminal-foreground`             | `--color-terminal-foreground`               |
+| `--input-placeholder`               | `--color-input-placeholder`                 |
+
+---
+
+## 3. 非颜色 Token（保持原名，已对齐）
+
+以下 token 在 TrekClaw v4.1 与 `@teamix-evo/tokens/variants/opentrek/theme.css` 中**命名一致**，迁移不需重命名：
+
+| 类别              | Token 列表                                                                                                                                                                                                                          |
+| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| **Font Family**   | `--font-sans`, `--font-mono`                                                                                                                                                                                                      |
+| **Font Size**     | `--font-size-base`/`-lg`/`-xl`/`-2xl`, `--font-size-page-header`*                                                                                                                                                                 |
+| **Font Weight**   | `--font-weight-normal`/`-medium`/`-black`                                                                                                                                                                                         |
+| **Line Height**   | `--line-height-input`/`-normal`/`-dialog-title`                                                                                                                                                                                   |
+| **Letter Spacing**| `--letter-spacing-tight`/`-normal`                                                                                                                                                                                                |
+| **Spacing**       | `--gap-xs`, `--btn-padding-x`/`-sm`, `--button-gap`, `--tabs-gap`, `--card-gap`, `--page-container-gap`/`-padding`/`-padding-left`, `--card-padding-x`, `--action-toolbar-search-combo-gap`                                       |
+| **Layout**        | `--layout-sidebar-width`, `--page-header-height`, `--breadcrumb-height`, `--sidebar-collapsed-width`, `--sidebar-menu-item-height`, `--sidebar-menu-item-size-collapsed`/`-gap-collapsed`, `--sidebar-header-padding-collapsed`, `--sidebar-footer-padding-collapsed`, `--sidebar-flyout-z-index`/`-min-width`/`-item-height`, `--sidebar-centered-axis`, `--sidebar-expand-icon-size`, `--topbar-height` |
+| **Table**         | `--table-cell-padding-x`, `--table-first-cell-padding-left`, `--table-last-cell-padding-right`                                                                                                                                    |
+| **Card Grid**     | `--card-grid-min-compact`/`-standard`/`-comfortable`/`-feature`                                                                                                                                                                   |
+| **Radius**        | `--radius`, `--radius-sm`/`-md`/`-lg`/`-xl`/`-full`, `--card-radius`, `--input-radius`                                                                                                                                            |
+| **Input**         | `--input-height`, `--input-font-size`, `--text-font-size`, `--input-line-height`, `--input-padding-x`/`-y`, `--input-icon-size`                                                                                                   |
+| **Dialog**        | `--dialog-width-s`/`-m`/`-l`/`-xl`, `--dialog-header-height`, `--dialog-footer-height`, `--dialog-body-padding-x`/`-y`                                                                                                            |
+| **Drawer**        | `--drawer-width-s`/`-m`/`-l`/`-xl`                                                                                                                                                                                                |
+| **Shadow**        | `--shadow-none`/`-sm`/`-DEFAULT`/`-md`/`-lg`/`-xl`/`-2xl`, `--shadow-dialog`*, `--shadow-select-content`                                                                                                                          |
+| **Animation**     | `--duration-fast`/`-normal`/`-slow`/`-slower`, `--easing-linear`/`-ease`/`-ease-in`/`-ease-out`/`-ease-in-out`                                                                                                                    |
+| **Z-index**       | `--z-base`/`-dropdown`/`-sticky`/`-overlay`/`-modal`/`-tooltip`                                                                                                                                                                   |
+| **Form**          | `--form-label-width`, `--form-control-max-width`, `--form-row-gap`, `--form-row-padding-y`, `--form-description-font-size`, `--form-required-indicator-margin-left`                                                               |
+| **Pagination**    | `--pagination-button-size`, `--pagination-arrow-icon-size`, `--pagination-ellipsis-icon-size`, `--button-sm-height`                                                                                                               |
+| **Stepper**       | `--stepper-button-width`/`-height`, `--stepper-input-width`/`-height`                                                                                                                                                             |
+
+> ⚠ **shadow 命名空间重命名**：TrekClaw 的 `--dialog-shadow` 已重命名为 `--shadow-dialog`（统一 `--shadow-*` 命名空间，与 teamix-evo 一致）。
+>
+> ℹ️ **font-size-* 注意事项**：teamix-evo 主推 Tailwind utility（`text-xs`/`text-sm`/`text-base`/`text-lg`），但 `--font-size-page-header` 等业务专用 token 与 TrekClaw 完全一致；`--font-size-base`/`-lg`/`-xl`/`-2xl` 名称在 teamix-evo theme.css 中没有显式声明，但作为 OpenTrek 设计规则的命名约定保留，AI 在生成原生 CSS 时仍可使用，建议优先用 Tailwind utility。
+
+---
+
+## 4. 无 teamix-evo 对应的 Token（TODO，保留原名）
+
+以下 28 个 token 是 TrekClaw v4.1 的 **legacy 别名 / 衍生态 / 项目专用**，teamix-evo `theme.css` 中暂无对应声明。**保留原名**写入 `design-tokens.{json,css}`，AI 生成代码时**不应使用这些 token**，应使用括号中的现役替代：
+
+### 4.1 Gray Legacy 别名（v7.4 起合并）
+
+| TrekClaw 旧名         | 现役替代（teamix-evo）                | TODO 原因                              |
+| --------------------- | ------------------------------------- | -------------------------------------- |
+| `--gray-title`        | `--color-gray-primary`                | v7.4 已合并为 gray-primary             |
+| `--gray-secondary`    | `--color-gray-secondary-foreground`   | v7.4 已重命名为 secondary-foreground   |
+| `--gray-tertiary`     | `--color-muted-foreground`            | v7.4 已重命名为 muted-foreground       |
+| `--gray-border`       | `--color-gray-line`                   | v7.4 已合并为 gray-line                |
+| `--gray-fill`         | `--color-gray-muted`                  | v7.4 已合并为 gray-muted               |
+| `--gray-bg-dark`      | `--color-gray-muted`                  | v7.4 已合并为 gray-muted               |
+| `--gray-bg`           | `--color-gray-muted`                  | v7.4 已合并为 gray-muted               |
+
+### 4.2 Semantic / Background Legacy
+
+| TrekClaw 旧名         | 现役替代（teamix-evo）                | TODO 原因                              |
+| --------------------- | ------------------------------------- | -------------------------------------- |
+| `--page-title`        | `--color-foreground`                  | v7.4 已合并为 foreground               |
+| `--background-end`    | `--color-background`                  | 与 background 同值，无渐变需求时用 background |
+
+### 4.3 状态色 Legacy 衍生态（v4.1 已废弃）
+
+| TrekClaw 旧名         | 现役替代（teamix-evo）                | TODO 原因                              |
+| --------------------- | ------------------------------------- | -------------------------------------- |
+| `--success-dark`      | `--color-success-hover`               | dark 改用 hover 槽位                   |
+| `--success-medium`    | `--color-success-border`              | medium 改用 border 槽位                |
+| `--success-light`     | `--color-success-bg`                  | light 改用 bg 槽位                     |
+| `--success-aura`      | _无替代_                              | box-shadow 光晕（teamix-evo 暂未声明） |
+| `--destructive-dark`  | `--color-destructive-hover`           | dark 改用 hover 槽位                   |
+| `--destructive-light` | `--color-destructive-bg`              | light 改用 bg 槽位                     |
+| `--destructive-aura`  | _无替代_                              | box-shadow 光晕（teamix-evo 暂未声明） |
+| `--warning-dark`      | `--color-warning-hover`               | dark 改用 hover 槽位                   |
+| `--warning-light`     | `--color-warning-bg`                  | light 改用 bg 槽位                     |
+| `--warning-aura`      | _无替代_                              | box-shadow 光晕（teamix-evo 暂未声明） |
+| `--info-aura`         | _无替代_                              | box-shadow 光晕（teamix-evo 暂未声明） |
+
+### 4.4 图表 Legacy 别名（v4.1 已废弃）
+
+| TrekClaw 旧名         | 现役替代（teamix-evo）         |
+| --------------------- | ------------------------------ |
+| `--data-1` ~ `--data-10` | `--color-chart-1` ~ `--color-chart-10`（10 项） |
+
+> **TODO 处理建议**：当 teamix-evo `@teamix-evo/tokens/variants/opentrek/theme.css` 后续版本补齐这些别名时，可统一删除本文件 legacy 别名段，由消费方根 tokens/ 提供。当前阶段 AI 生成代码请避免使用上述 28 项 token。
+
+---
+
+## 5. 值格式差异（important）
+
+| 维度          | TrekClaw v4.1（本文件）                         | teamix-evo `theme.css`                      |
+| ------------- | ----------------------------------------------- | ------------------------------------------- |
+| 颜色值格式    | HSL 三元组裸值：`218.6 100% 46.7%`              | hsl() 包裹：`hsl(218.6 100% 46.7%)`         |
+| 使用方式      | `color: hsl(var(--color-primary))`              | `color: var(--color-primary)` 或 Tailwind utility |
+| 适用场景      | Skill 参考文档（保留 TrekClaw 原始色值供 AI 查询） | 运行时 CSS（消费方根 tokens/tokens.theme.css） |
+
+**实际开发中**：
+- **首选** Tailwind v4 utility：`bg-primary` / `text-foreground` / `border-border`，自动从 teamix-evo `@theme` 块解析。
+- **次选** 原生 CSS 引用：`background-color: var(--color-primary)`（teamix-evo 已带 hsl() 包裹，**无需再嵌套 hsl()**）。
+- **本文件 `design-tokens.{json,css}` 仅作为 OpenTrek skill 设计规则的 AI 参考文档**，不参与运行时构建。生成页面代码时遵循上面两条即可。
+
+---
+
+## 6. 维护规则
+
+1. **新增 token**：先在 `@teamix-evo/tokens/variants/opentrek/theme.css` 加 `--color-xxx`，再同步本目录 `design-tokens.json`/`.css`；保持本文件对照表更新。
+2. **TODO 收敛**：当 teamix-evo theme.css 补齐 §4 列出的 token 时，删除本目录对应 legacy 别名行，并从本文件 §4 移到 §2 对照表。
+3. **值变更**：色值只在 `@teamix-evo/tokens/variants/opentrek/{theme.css, base.tokens.json}` 修改；本目录 design-tokens.{json,css} 同步更新作为 skill 参考。
+4. **冲突裁决**：teamix-evo `@teamix-evo/tokens` 是运行时唯一真相源；本文件与 teamix-evo theme.css 不一致时，**以 teamix-evo 为准**，本文件需同步修正。
+
+---
+
+_最后更新：2026-06-09（teamix-evo 对齐迁移）_

package/src/teamix-evo-design-uni-manager/SKILL.md

@@ -54,7 +54,7 @@ description: |
 | [patterns/page-types.md](./patterns/page-types.md)           | 5 种页面类型 + Console Home + 一致性三件套                                   |
 | [patterns/list-page.md](./patterns/list-page.md)             | 列表页模式（多租户 / 多区域筛选）                                            |
 | [patterns/detail-page.md](./patterns/detail-page.md)         | 详情页模式（资源详情 / 跨云资源关联）                                        |
-| [patterns/form-page.md](./patterns/form-page.md)             | 表单页模式（含 wizard / Drawer 内联表单）                                    |
+| [patterns/form-page.md](./patterns/form-page.md)             | 表单页模式（含 wizard / Sheet 内联表单）                                     |
 | [patterns/dashboard.md](./patterns/dashboard.md)             | Dashboard / Console Home（StatCard / Chart 标准结构）                        |
 | [flows.md](./flows.md)                                       | 5 条核心用户旅程 + 上下文切换（租户/项目/区域）                              |
 | [brand.md](./brand.md)                                       | Uni-Manager 品牌调性 + 文案语气 + 正反例（B50 + 锐利风）                     |

package/src/teamix-evo-design-uni-manager/boundaries.md

@@ -259,7 +259,7 @@ CSS 变量已在 dark 模式下自动切换（uni-manager `theme.css` 内置）
 + <Dialog><DialogContent>
 ```
 
-适用：`Dialog / Sheet / Drawer / Popover / Tooltip / DropdownMenu / HoverCard`。
+适用：`Dialog / Sheet / Popover / Tooltip / DropdownMenu / HoverCard`。
 
 > 检查: 无 lint (运行时 / 评审)
 
@@ -304,7 +304,7 @@ CSS 变量已在 dark 模式下自动切换（uni-manager `theme.css` 内置）
 
 > 检查: 无 lint (后续可加 ESLint JSX 结构规则)
 
-### [ERROR] C2 · Dialog / Sheet / Drawer 必须有 Title
+### [ERROR] C2 · Dialog / Sheet 必须有 Title
 
 ```diff
 - <DialogContent>...</DialogContent>
@@ -550,7 +550,7 @@ CSS 变量已在 dark 模式下自动切换（uni-manager `theme.css` 内置）
 | 需要输入的任务         | `Dialog`                            |
 | 危险操作确认           | `AlertDialog variant="destructive"` |
 | 侧面板（详情 / 筛选）  | `Sheet`                             |
-| 移动端底部面板         | `Drawer`                            |
+| 移动端底部面板         | `Sheet side="bottom"`               |
 | 悬浮信息（hover 触发） | `HoverCard`                         |
 | 点击弹出小内容         | `Popover`                           |
 

package/src/teamix-evo-design-uni-manager/brand.md

@@ -40,7 +40,7 @@
 - 表格行高默认 36px（OpenTrek 默认 40-44）
 - 字段标签字号 12px（`text-xs`）— 而非 OpenTrek 14px
 - DescriptionList 默认 `column: 2`，宽屏可至 4
-- Drawer 内表单字段 gap = 12px（详情页 `density="detail"`）
+- Sheet（抽屉）内表单字段 gap = 12px（详情页 `density="detail"`）
 
 ### 3.2 一致性三件套（uni-manager 专有约束）
 

package/src/teamix-evo-design-uni-manager/components.md

@@ -46,15 +46,15 @@ ui 原子组件最小拼装 (兜底)
 
 ## 1. 双层组件架构（实物归属）
 
-| 层级                                          | 来源                             | 实物清单（截至当前 variant）                                                                                                                                                                                                                                    |
-| --------------------------------------------- | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| **业务扩展层（biz-ui，uni-manager variant）** | `@teamix-evo/biz-ui/uni-manager` | 当前 1 个实物：`um-topbar`（含 ContextSwitcher + Logo + 用户菜单 + 通知中心）。其余 `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，uni-manager variant）** | `@teamix-evo/biz-ui/uni-manager` | 3 个实物：`um-topbar`（含 ContextSwitcher + Logo + 用户菜单 + 通知中心）、`um-sidebar`、`um-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/uni-manager 实物层** — 已封装变体 + 文案规范，但**注意 uni-manager 当前仅 1 个实物**。
-2. **biz-ui 无实物 → ui 实现层** — 89 个原子件覆盖绝大部分场景。
+1. **优先 biz-ui/uni-manager 实物层** — 已封装变体 + 文案规范，但**注意 uni-manager 当前有 3 个实物**。
+2. **biz-ui 无实物 → ui 实现层** — 76 个原子件覆盖绝大部分场景。
 3. **ui 仍无 → §5 拼凑配方** — 用 ui 多个原子件最小组合（不私造）。
 4. **禁止**自造同名组件（违反 reuse-first，详见 §0）。
 
@@ -79,7 +79,7 @@ ui 原子组件最小拼装 (兜底)
 
 ## 3. 选型决策树
 
-### 3.1 反馈与确认 — Dialog vs Sheet vs Drawer vs Popover
+### 3.1 反馈与确认 — Dialog vs Sheet vs Popover
 
 ```text
 需要用户做出决定 / 阻塞主流程？
@@ -88,7 +88,7 @@ ui 原子组件最小拼装 (兜底)
 │   └─ 复杂表单（< 8 字段）→ Dialog
 └─ 否
     ├─ 临时编辑/筛选（侧边滑出）→ Sheet
-    ├─ 多级下探查看（侧边可叠层）→ Drawer
+    ├─ 多级下探查看（侧边可叠层）→ Sheet（多层叠加模式）
     ├─ 内容预览/上下文操作（小气泡）→ Popover
     └─ 仅展示信息（鼠标悬浮）→ Tooltip
 ```
@@ -104,17 +104,17 @@ ui 原子组件最小拼装 (兜底)
 
 > 来源：Teamix-UI 容器规范（doc 10）。
 
-| 类别       | 容器                                     | 何时使用                                         |
-| ---------- | ---------------------------------------- | ------------------------------------------------ |
-| **操作型** | 全页面（FormPage）                       | 字段多 / 步骤多 / 需要持久 URL                   |
-| **操作型** | 弹窗模态（Dialog）                       | 阻塞主流程的简短确认或表单；最多 2 级，不再深入  |
-| **操作型** | 气泡（Popconfirm）                       | 二次确认（删除/解绑），轻量提示                  |
-| **展示型** | 全页面（DetailPage）                     | 完整信息查看，路由可分享                         |
-| **展示型** | 抽屉非模态（Sheet）                      | 不阻塞主流程，可保留上下文（如侧栏 Detail）      |
-| **展示型** | 抽屉模态（Drawer）                       | 多级下探查看（如资源 → 子资源 → 配置），逐层推出 |
-| **展示型** | 弹窗模态（Dialog）                       | 一次性展示重要信息                               |
-| **展示型** | 卡片（Card）                             | 同级信息分组；卡片之间间距 16px                  |
-| **展示型** | 通知反馈（Toast / Alert / Notification） | 瞬时反馈 / 页面级横幅 / 系统通知                 |
+| 类别       | 容器                       | 何时使用                                         |
+| ---------- | -------------------------- | ------------------------------------------------ |
+| **操作型** | 全页面（FormPage）         | 字段多 / 步骤多 / 需要持久 URL                   |
+| **操作型** | 弹窗模态（Dialog）         | 阻塞主流程的简短确认或表单；最多 2 级，不再深入  |
+| **操作型** | 气泡（Popconfirm）         | 二次确认（删除/解绑），轻量提示                  |
+| **展示型** | 全页面（DetailPage）       | 完整信息查看，路由可分享                         |
+| **展示型** | 抽屉非模态（Sheet）        | 不阻塞主流程，可保留上下文（如侧栏 Detail）      |
+| **展示型** | 抽屉模态（Sheet 多层叠加） | 多级下探查看（如资源 → 子资源 → 配置），逐层推出 |
+| **展示型** | 弹窗模态（Dialog）         | 一次性展示重要信息                               |
+| **展示型** | 卡片（Card）               | 同级信息分组；卡片之间间距 16px                  |
+| **展示型** | 通知反馈（Sonner / Alert） | 瞬时反馈 / 页面级横幅 / 系统通知                 |
 
 ### 3.3 状态展示 — Badge vs Tag vs Alert
 
@@ -155,12 +155,12 @@ ui 原子组件最小拼装 (兜底)
 ```text
 枚举值 ≤ 7 → RadioGroup（一屏可见）
 枚举值 8~30 → Select
-枚举值 > 30 / 需搜索 → Combobox（= ui command）
-多选 → MultiSelect / Checkbox
+枚举值 > 30 / 需搜索 → Combobox（输入即建议，支持 multiple 多选）或 Command + Popover 拼装
+多选 → Combobox (multiple={true}) / Checkbox
 日期 → DatePicker / DateRangePicker
-富文本 → Textarea / RichEditor
+富文本 → Textarea
 文件 → Upload
-自动补全 → AutoComplete
+自动补全 → Combobox
 ```
 
 ---
@@ -182,14 +182,16 @@ ui 原子组件最小拼装 (兜底)
 
 ## 5. 业务扩展层（候补）— 实物 vs 概念 + 拼凑配方
 
-> uni-manager variant 当前**只有 1 个**实物业务组件：`um-topbar`。
+> uni-manager variant 当前有 **3 个**实物业务组件：`um-topbar`、`um-sidebar`、`um-page-container`。
 > 以下表格区分"已实物化"与"概念占位（用 ui 拼装）"。
 
 ### 5.1 已实物化（直接使用）
 
-| 组件          | 用途                                                              | 归属               |
-| ------------- | ----------------------------------------------------------------- | ------------------ |
-| **um-topbar** | 全局顶部壳层（ContextSwitcher + Logo + UserMenu + Notifications） | biz-ui/uni-manager |
+| 组件                  | 用途                                                              | 归属               |
+| --------------------- | ----------------------------------------------------------------- | ------------------ |
+| **um-topbar**         | 全局顶部壳层（ContextSwitcher + Logo + UserMenu + Notifications） | biz-ui/uni-manager |
+| **um-sidebar**        | 左侧导航侧栏                                                      | biz-ui/uni-manager |
+| **um-page-container** | 页面容器（白卡 + 间距 + PageHeader 插槽）                         | biz-ui/uni-manager |
 
 ### 5.2 概念占位（按配方拼装）
 
@@ -249,7 +251,7 @@ ui 原子组件最小拼装 (兜底)
 
 - [ ] 已先用 `find_components` 验证组件存在性（不靠默认）
 - [ ] biz-ui/uni-manager 命中失败 → 改用 ui 原子件，按 §5.2 配方拼装并加注释
-- [ ] 反馈 / 确认场景按容量选 Dialog / Sheet / Drawer / Popover
+- [ ] 反馈 / 确认场景按容量选 Dialog / Sheet / Popover
 - [ ] 容器层级 ≤ 3，弹窗最多 2 级，超过则跳转全页面
 - [ ] 全局壳层使用 `um-topbar`（boundaries.md UM1）
 - [ ] 跨云资源列表必含 cloud Badge 列（boundaries.md UM3）

package/src/teamix-evo-design-uni-manager/foundations.md

@@ -94,11 +94,11 @@ hardcoded 数值                                ← 仅限 token 真空地带，
 
 ### 3.2 信息密度 3 档（来自 doc 04）
 
-| 密度 | 行间距 / 区间距 | 适用                     |
-| ---- | --------------- | ------------------------ |
-| 高   | 32 / 48         | Dashboard / 运营首页     |
-| 中   | 16 / 24         | 列表页 / 详情页（默认）  |
-| 低   | 8 / 12          | 紧凑表格 / Drawer 内表单 |
+| 密度 | 行间距 / 区间距 | 适用                           |
+| ---- | --------------- | ------------------------------ |
+| 高   | 32 / 48         | Dashboard / 运营首页           |
+| 中   | 16 / 24         | 列表页 / 详情页（默认）        |
+| 低   | 8 / 12          | 紧凑表格 / Sheet（抽屉）内表单 |
 
 ### 3.3 Form 间距三档（hardcode token，禁手写）
 
@@ -187,7 +187,7 @@ hardcoded 数值                                ← 仅限 token 真空地带，
 | `rounded-none` | 0      | 表格行 / 全屏 banner                                |
 | `rounded-sm`   | 0px    | ✱ 输入控件 / 表格 / Tag 边角（uni-manager 默认）    |
 | `rounded-md`   | 2px    | ✱ 按钮 / Card 默认 / Dialog（与 OpenTrek 6px 不同） |
-| `rounded-lg`   | 4px    | ✱ Card 强调 / Drawer / 弹层                         |
+| `rounded-lg`   | 4px    | ✱ Card 强调 / Sheet / 弹层                          |
 | `rounded-xl`   | 8px    | ✱ 大型 Card / 营销卡                                |
 | `rounded-2xl`  | 12px   | ✱ 营销 / 大屏数据卡                                 |
 | `rounded-full` | 9999px | Avatar / Badge dot / 圆形按钮                       |
@@ -214,19 +214,19 @@ hardcoded 数值                                ← 仅限 token 真空地带，
 | `shadow-2xs`/`xs`/`sm` | 0 1px 2px rgba(0,0,0,0.04~0.05) | base                | 微弱浮起（罕用）             |
 | `shadow-md`            | 0 3px 8px rgba(0,0,0,0.06)      | hybridcloud S1.down | Card / Form hover            |
 | `shadow-lg`            | 0 3px 8px rgba(0,0,0,0.18)      | hybridcloud S2.down | Dropdown / Popover / Tooltip |
-| `shadow-xl`            | 0 6px 24px rgba(0,0,0,0.10)     | hybridcloud S3.down | Sheet / Drawer / Dialog      |
+| `shadow-xl`            | 0 6px 24px rgba(0,0,0,0.10)     | hybridcloud S3.down | Sheet / Dialog               |
 | `shadow-2xl`           | 0 12px 48px rgba(0,0,0,0.20)    | 顶层模态            | AlertDialog / 全屏 modal     |
 
 ### 6.1 圆角 × 阴影对应表（不可乱配）
 
-| 容器         | radius                               | shadow                            | 备注                 |
-| ------------ | ------------------------------------ | --------------------------------- | -------------------- |
-| 表单输入     | `rounded-sm`                         | `shadow-none` (hover `shadow-md`) | scoped CSS 自动接管  |
-| 表格行       | `rounded-none`                       | `shadow-none`                     | —                    |
-| Card         | `rounded-md`                         | `shadow-md`                       | hybridcloud 默认浮起 |
-| Dropdown     | `rounded-md`                         | `shadow-lg`                       | —                    |
-| Sheet/Drawer | `rounded-lg`                         | `shadow-xl`                       | 大尺寸弹层           |
-| Dialog       | `rounded-md`(`--radius-dialog: 2px`) | `shadow-xl`                       | cd hybridcloud 锐利  |
+| 容器     | radius                               | shadow                            | 备注                 |
+| -------- | ------------------------------------ | --------------------------------- | -------------------- |
+| 表单输入 | `rounded-sm`                         | `shadow-none` (hover `shadow-md`) | scoped CSS 自动接管  |
+| 表格行   | `rounded-none`                       | `shadow-none`                     | —                    |
+| Card     | `rounded-md`                         | `shadow-md`                       | hybridcloud 默认浮起 |
+| Dropdown | `rounded-md`                         | `shadow-lg`                       | —                    |
+| Sheet    | `rounded-lg`                         | `shadow-xl`                       | 大尺寸弹层           |
+| Dialog   | `rounded-md`(`--radius-dialog: 2px`) | `shadow-xl`                       | cd hybridcloud 锐利  |
 
 ### 6.2 Form 控件特殊行为
 
@@ -242,12 +242,12 @@ AI 生成时 **不要** 写 `focus:ring-2 focus:ring-primary`，否则与 scoped
 
 ## 7. 动效（Motion）
 
-| 时长           | 用途                         |
-| -------------- | ---------------------------- |
-| `duration-75`  | 微交互（hover 色变）         |
-| `duration-150` | 默认（按钮 / 输入态）        |
-| `duration-200` | 中等（折叠 / 展开）          |
-| `duration-300` | 较慢（Drawer / Dialog 进出） |
+| 时长           | 用途                        |
+| -------------- | --------------------------- |
+| `duration-75`  | 微交互（hover 色变）        |
+| `duration-150` | 默认（按钮 / 输入态）       |
+| `duration-200` | 中等（折叠 / 展开）         |
+| `duration-300` | 较慢（Sheet / Dialog 进出） |
 
 缓动统一 `ease-out`（进场）/ `ease-in`（退场）。**禁止** 自定义 `cubic-bezier(...)` 字面量。
 

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

@@ -89,10 +89,12 @@ Step 6 自检    ← Step 5 视觉填充  ← Step 4 组件挑选
 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 绑定）
 

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

@@ -201,7 +201,7 @@
 
 | 禁项                       | 原因                                  |
 | -------------------------- | ------------------------------------- |
-| Form 直接在主内容区        | 编辑应通过 Drawer/Dialog/FormPage     |
+| Form 直接在主内容区        | 编辑应通过 Sheet/Dialog/FormPage      |
 | DataTable 在主内容区       | 关联数据应用 Tabs 子面板              |
 | Chart 替代 DescriptionList | 图表属 Dashboard，监控用 MonitorPanel |
 | QueryFilter                | 详情页无筛选需求                      |