Bkui Builder

---
id: engineering/bkui-builder
name: 蓝鲸 MagicBox 3.0 组件专家规则
category: engineering
description: 设计稿还原规则。先输出布局分析报告，再按需加载模版
tags: [vue3, bkui-vue, rules, template, expert]
updated_at: 2026-01-19
---

# 蓝鲸 MagicBox 3.0 组件专家规则

## ⚠️ 绝对禁令

1. **禁止手写布局**: 严禁用 `div` 自创 sidebar/header/menu
2. **强制组件化**: 页面骨架 **必须** 用 `<bk-navigation>`
3. **禁止原生标签**: 严禁 `<table>`, `<button>`，必须用 bk-table, bk-button

## 🔥 还原流程

**Step 1: 分析设计稿** - 判断：主题深/浅色？表格/表单页？菜单有图标？

**Step 2: 加载模版** (FetchMcpResource, server: user-BKUI-Knowledge)

| 判断结果 | URI |
|---------|-----|
| 深色侧边栏 | `skill://bkui-builder/assets/layouts/admin-layout-dark.vue` |
| 浅色侧边栏 | `skill://bkui-builder/assets/layouts/admin-layout-left.vue` |
| 表格页+Tab | `skill://bkui-builder/assets/pages/table-page.vue` |
| 有图标 | `skill://bkui-builder/references/visual-mapping.md` |

**Step 3: 参考模版生成代码**

## 基础结构

```html
<bk-navigation navigation-type="left-right" need-menu default-open>
  <template #menu>
    <bk-menu :active-key="activeMenu" :opened-keys="['group-1']">
      <bk-menu-item key="home">首页</bk-menu-item>
    </bk-menu>
  </template>
</bk-navigation>
```
> ⚠️ 属性名是 `opened-keys`，不是 `default-open-keys`

## Icon 导入

```typescript
// ✅ 正确
import { Search, Plus, Close } from 'bkui-vue/lib/icon';
// ❌ 错误: import { Search } from '@bkui-vue/icon';
```

## 📦 更多资源

- `skill://bkui-builder/references/code-snippets.md` - 代码片段
- `skill://bkui-builder/references/checklist.md` - 质量检查


---
## 📦 可用资源

- `skill://bkui-builder/references/checklist.md`
- `skill://bkui-builder/references/code-snippets.md`
- `skill://bkui-builder/references/visual-mapping.md`
- `skill://bkui-builder/assets/layouts/admin-layout-dark.vue`
- `skill://bkui-builder/assets/layouts/admin-layout-left.vue`
- `skill://bkui-builder/assets/layouts/admin-layout-top.vue`
- `skill://bkui-builder/assets/pages/dashboard-page.vue`
- `skill://bkui-builder/assets/pages/detail-page.vue`
- `skill://bkui-builder/assets/pages/table-page.vue`
- `skill://bkui-builder/assets/pages/wizard-form.vue`

> 根据 SKILL.md 中的 IF-THEN 规则判断是否需要加载