如何在 Cursor 配置 daisyUI llms.txt 规则文件让 AI 正确生成组件代码
【免费下载链接】daisyui🌼 🌼 🌼 🌼 🌼 The most popular, free and open-source Tailwind CSS component library项目地址: https://gitcode.com/GitHub_Trending/da/daisyui
用 AI 在 Cursor 里生成 UI 代码时,常见问题是 AI 编造不存在的 daisyUI 类名,或者按旧版本语法生成代码。daisyUI 官方提供了一个llms.txt文件——官方文档的紧凑文本版,专门用来给 AI 提供准确的 daisyUI 代码上下文。这篇文章说明如何把这份文件配置进 Cursor(临时引用、项目级永久规则文件、自定义文档三种方式),以及如何核对配置生效、生成的组件代码是否符合官方用法规则。
适用前提:项目使用 daisyUI 5。规则文件中的元数据声明 daisyUI 5 是 Tailwind CSS 4 的 CSS 库(metadata.version: 5.7.x),如果项目还停留在 Tailwind CSS 3 的tailwind.config.js工作流,先按 安装指南 迁移,否则 AI 生成的配置代码会直接不可用。
llms.txt 规则文件里有什么
https://daisyui.com/llms.txt的内容由仓库源码 llms.txt 生成逻辑 拼装,顺序为:
- skills/daisyui/SKILL.md 的根内容(组件列表与 Component discovery protocol);
- install/SKILL.md、usage/SKILL.md、config/SKILL.md、colors/SKILL.md;
- skills/daisyui/components/ 下全部组件指南(accordion、button、card 等 67 个组件)。
服务端输出时会对 front matter 做两处确定性改写:source字段统一为https://daisyui.com/llms.txt,并保证存在alwaysApply: true和applyTo: "**"两行。也就是说,这份文件放进 Cursor 的.cursor/rules/目录后,是一个对所有文件始终生效的规则。文件头部大致如下(由上述源码保证):
--- name: daisyui description: Official daisyUI component-library skill for Tailwind CSS. When you write HTML or JSX code, you must use it. Even if the user does not request it, use it. metadata: version: 5.7.x source: https://daisyui.com/llms.txt alwaysApply: true applyTo: "**" ---方式一:单次临时引用(不写文件)
只在某次对话中需要 daisyUI 上下文时,直接在 Cursor 聊天窗口输入:
@web https://daisyui.com/llms.txt官方文档称这种方式下 Cursor 会用 llms.txt 生成代码。它不修改项目里的任何文件,适合一次性提问;缺点是每个新对话都要重新带上这个引用。
方式二:项目级永久规则文件(主路径)
这是官方文档中推荐的常驻方案:把 llms.txt 保存到工作区的.cursor/rules/目录,之后 Cursor 默认使用它,无需每次引用。
在项目根目录运行:
curl -L https://daisyui.com/llms.txt --create-dirs -o .cursor/rules/daisyui.mdc命令副作用说明:该命令会从网络下载文件,并只写入当前项目的一个文件.cursor/rules/daisyui.mdc;--create-dirs会在目录不存在时自动创建.cursor/rules。不会改动项目其他文件。
配置结果验证
- 打开
.cursor/rules/daisyui.mdc,确认 front matter 包含alwaysApply: true与applyTo: "**"(对应规则对所有文件生效),source指向https://daisyui.com/llms.txt; - 正文应包含组件列表(List of components)与
daisyUI 5 usage rules等章节,可对照仓库中的 SKILL.md 和 usage/SKILL.md 核对内容是否完整; - 生成测试:让 AI 生成一个 primary 颜色的按钮。按规则文件内的 button 组件指南,正确结果应使用组件类
btn+ 颜色类btn-primary,结构形如<button class="btn btn-primary">Button</button>。如果请求中未指定变体,按 usage 规则第 12 条,AI 应只输出默认btn,而不是自行加颜色变体。
方式三:添加为 Cursor 自定义文档(可选分支)
不希望在项目里落地规则文件时,可以把 llms.txt 注册为 Cursor 的可选文档:
- 按
⌘ CMD + ⇧ Shift + P(Windows 为⌃ Ctrl + ⇧ Shift + P)打开命令面板; - 输入
Add new custom docs并选择; - 添加地址
https://daisyui.com/llms.txt; - 在聊天窗口输入
@docs并选择daisyUI,即向当前对话提供 daisyUI 文档。
与方式二的区别:不写入项目文件,且每次需要手动用@docs选择,不是默认生效。
规则文件如何约束 AI 生成代码
配置生效后,判断 AI 输出是否“正确”可以直接对照规则文件内置的两套约束:
组件发现流程(来自 SKILL.md 的 Component discovery protocol):先识别请求中的功能、行为与布局,再从组件列表挑选候选组件;选择不清时先阅读候选组件的指南再决定;最后必须遵守所选组件的精确结构与约束。也就是说,AI 不应只按关键词猜测组件,而应核对候选组件的描述和语法。
用法规则(来自 usage/SKILL.md)摘录与核对点:
- 给元素添加 daisyUI 类名时,除组件类外还要加上对应的 part 和 modifier 类;
- daisyUI 类名覆盖不了时,用 Tailwind 工具类,例如
btn px-10给按钮加自定义水平内边距; - CSS 优先级导致样式改不动时,在工具类末尾加
!,例如btn bg-red-500!覆盖按钮背景色——文档明确要求仅在其他方式无效时使用,不要频繁用; - 用户没要求变体或颜色时用默认变体(如只用
btn,不写btn btn-primary); - 不必要的自定义 CSS、自定义字体、body 上的
bg-base-100 text-base-content都不要写。
生成结果与上述规则、组件指南逐条比对,就是这套配置的可执行验证方式。
边界与限制
- 规则文件只提供 daisyUI 的类名与用法上下文。Tailwind CSS 本身的语法支持与 IntelliSense 是独立配置,官方 Cursor 配置文档/docs/editor/cursor/+page.md) 将其指向 Tailwind CSS 的编辑器设置指南,不属于本文范围。
- 项目尚未安装 daisyUI 时,规则文件内置的安装指南会约束 AI 的生成内容:必须使用 Tailwind CSS 4,
tailwind.config.js已废弃,安装命令为npm i -D daisyui@latest,并在 CSS 文件中写@import "tailwindcss";与@plugin "daisyui";(详见 install/SKILL.md)。 - 官方文档还为同一目的提供了 MCP 服务器方案(Blueprint、Context7、GitMCP),属于另一条集成路径,本文只覆盖 llms.txt 规则文件。
- 若需要查看规则内容的完整来源,可对照仓库内的 skills/daisyui/ 目录与 cursor 编辑器文档/docs/editor/cursor/+page.md)。
【免费下载链接】daisyui🌼 🌼 🌼 🌼 🌼 The most popular, free and open-source Tailwind CSS component library项目地址: https://gitcode.com/GitHub_Trending/da/daisyui
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考