UI 处理器
使用说明
1. 安装标准组件(原子组件)
使用 Shadcn MCP 获取基础 UI 元素(按钮、输入框、对话框)。
- 操作:请求 Shadcn MCP 添加组件。
"使用 Shadcn MCP 添加按钮和对话框组件。"
- 手动备选方案:
pnpm dlx shadcn@latest add {component}
2. 生成复杂区块(块)
使用 21st.dev Magic MCP 生成高级页面区块(落地页、标题区、仪表盘)。
- 操作:向 21st.dev MCP 描述需求。
"生成一个现代 SaaS 标题区,包含深色渐变背景和邮件采集表单。"
- 存放位置:将生成的文件放在
src/components/sections/或src/components/website/中。 - 集成:在
page.tsx中导入并使用。
3. 主题与样式
使用 Shadcn MCP 或直接编辑 src/app/globals.css。
- 主题更新:请求 Shadcn MCP 应用特定主题或调色板。
"将应用主题更新为使用 'zinc' 中性基础色和 'blue' 主色调。"
- CSS 变量:我们在
src/app/globals.css中使用 CSS 变量(通常是 OKLCH)。确保任何新样式使用这些变量(例如bg-background、text-primary)。
4. 创建布局
- 识别:页头、侧边栏、内容区域。
- 组合:使用来自
@/components/ui的原子组件和来自@/components/sections的区块。 - 就近放置:如果某个组件仅用于一个页面,将其放在该页面旁边的
_components/目录中。
参考
有关详细的架构和最佳实践,请参阅 reference.md。