magicbox-30

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

蓝鲸 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: 参考模版生成代码

基础结构

<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 导入

// ✅ 正确
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 规则判断是否需要加载