自定义 UI-UX-Pro-Max 的 CSV 知识库，把 AI 生成的后台拉回行业该有的样子

让 AI 生成审批后台，十个里有八个是玻璃拟态卡片叠紫粉渐变。页面能跑，可放进严肃行业系统里，一眼就是 AI 糊的，规范不对。工业 HMI、车企后台也有同样的问题，配色和排版跟行业合规完全两套逻辑。

我第一反应是加 prompt，不许玻璃拟态，不许渐变，配色要严肃，动效全关。写了三版，prompt 越来越长，换一个页面描述它又忘一半，等于每次重新教育一遍模型。UI-UX-Pro-Max 这种工具根本不靠模型记规则，全部设计知识存在 data/*.csv，用 BM25 本地检索，离线就能跑。想扩展知识库，直接修改 CSV 就行，Python 检索脚本一行都不用动。

一、先把它的知识库拆开看

ui-ux-pro-max 是运行在 Cursor / Claude Code / Windsurf 的 AI Skill，v2.0 的核心亮点是行业驱动的 Design System Generator。装好之后我没急着写 prompt，先去翻它装在哪儿，知识存在哪。核心设计就三层，不依赖大模型记忆，全部设计知识结构化保存在 CSV，Python 脚本做 BM25 检索。检索命中给出一整套完整设计系统，页面模式、配色、字体、动效、反模式、交付检查清单一次给全。

真实目录长这样，所有知识都在 data/ 下面，这也是全文唯一需要你动手的目录。

.claude/skills/ui-ux-pro-max
├── data/                 # 全部知识库 CSV 在这里
│   ├── products.csv      # ✅【重点】行业/产品推理规则，192 条行业规则在这里
│   ├── styles.csv        # UI 风格库：玻璃拟态、Bento 网格等 79 种样式
│   ├── colors.csv        # 行业配色库
│   ├── typography.csv    # 字体配对
│   ├── landing.csv       # 落地页布局模式
│   ├── ux-guidelines.csv # UX 反模式、无障碍规范
│   └── stacks/           # React / Vue / Flutter 各技术栈专属规则
├── scripts/
│   └── search.py         # BM25 检索入口脚本
└── SKILL.md

安装这里有个坑。我用 uipro cli 全局装，一开始想当然去翻了 npm 缓存，找了半天没找到 CSV。不要修改 npm 缓存，要去改实际 skill 目录下面的 data/ 文件夹。执行 uipro update 会覆盖本地修改，自定义之后要么关掉自动更新，要么先把 CSV 备份好。这条我是被覆盖过一次才记住的。

接着看 products.csv，它装的就是那 192 条行业推理规则，一行一条，把「这个行业该怎么设计」拆成八个字段。Keywords 是产品/行业关键词，Pattern 是推荐页面模式，StylePriority 是 UI 样式优先级，ColorPalette 是推荐配色，Typography 是字体组合，KeyEffects 是关键交互动效，AntiPatterns 是反模式，禁止做什么，比如银行业直接禁掉 AI 紫粉渐变，PreDeliveryChecklist 是交付检查清单。我盯了很久才看懂 Keywords 是 BM25 的检索入口，这条理解决定了我后面第一次改规则成不成。

二、拿审批后台练手

翻完知识结构，我决定拿最典型的垂直行业开刀。审批后台，强制高对比度，禁用花哨动效，严肃配色，不允许玻璃拟态。没备份就动手，这是我犯的第一个错。正确第一步是先到 data 目录给原文件留个底，我当时跳过了。

cd .claude/skills/ui-ux-pro-max/data
cp products.csv products.csv.bak

八字段顺序固定，一个都不能错位。

Keywords、Pattern、StylePriority、ColorPalette、Typography、KeyEffects、AntiPatterns、PreDeliveryChecklist

我第一版没管「复制一条现有条目作为模板」，从零手敲了一行，字段顺序直接错位，检索结果当然不对。第二版学乖了，打开 products.csv 复制一条现有条目作为模板，删掉内容重填，把 Keywords 换成审批的多组关键词，把 AntiPatterns 写成禁止项。填的时候又踩一个坑，字段内部含有逗号时，内容必须用英文双引号包裹，不然一列会被拆成两列。改完这一行长这样。

"审批后台,approval admin,approval backend","Dashboard-Centric","Minimalism,Fluent 2","approval-blue","Microsoft YaHei,Noto Sans SC","subtle transition,reduced-motion first","No glassmorphism,No neon gradient,No fancy hover animation","☐ 文本对比度≥4.5:1；☐ 禁用装饰性动效；☐ 表单布局符合审批后台规范；☐ 键盘全操作支持"

第一列 Keywords 是这次能不能成事的关键，把「审批后台」「approval admin」「approval backend」都写进去，AI 无论说中文还是英文都能命中。AntiPatterns 里的三条，No glassmorphism / No neon gradient / No fancy hover animation，正好对应开头说的严肃行业红线。最后一项 PreDeliveryChecklist 是交付前自检清单，AI 生成完页面会逐条对照。

存文件的时候我又翻了一次车，用 WPS 默认保存，存成了 GBK，脚本读出来全是乱码。四件事记牢，都是我交过学费的。

• CSV 编码用 UTF-8，别用 WPS 默认的 GBK 保存，脚本读出来全是乱码。
• 字段内部有逗号，内容必须用英文双引号包裹。
• 改完不用重启编辑器，脚本每次执行都读磁盘上最新的 CSV。
• 再次强调，uipro update 会覆盖自定义 CSV，升级前务必备份你自己的 products.csv。

改完验证，直接调 search.py 输出设计系统，看新增规则有没有命中。

python3 .claude/skills/ui-ux-pro-max/scripts/search.py "审批后台" --design-system -f markdown

看到输出的 Design System 真的读到我写的审批配色、反模式、checklist，我才第一次看懂这个工具在管什么。它管的是生成前那套「这个行业该长什么样」的规则，页面只是最后落下来的东西。

三、学会以后我贪心了

第一条规则跑通之后，我膨胀了，想把整套自家设计语言都喂进去。翻完 data/ 发现能改的不止 products.csv，一共五种，各管一块。

• styles.csv 新增公司自研 UI 风格，让 AI 的输出贴合自家设计语言。
• colors.csv 导入团队品牌色板，主色、辅助色、强调色一次定义清楚。
• typography.csv 写入团队固定字体搭配，不用每次在 prompt 里手敲字体名。
• ux-guidelines.csv 添加团队专属 UX 禁忌，把「我们项目不允许 X」直接写进规则。
• stacks/react.csv 针对 React 项目补充团队组件库的约束规则，比如要求优先使用 ant-design 的组件而不是从零手写。

这里我差点走错一步，想把手里的私有规则直接往上游仓库提 PR。业务规范是团队的，别往上游开源仓库提交 PR。正确做法是本地维护一份自定义 CSV，用 Git 做版本管理，升级 skill 之后覆盖回去，你的规则永远只属于你的团队。

四、团队想共享规范

规则在个人机器上跑通只是第一步。想让整个团队都用上这套规范，我一开始的想法是人人都改一遍 CSV，结果同步一次痛一次。这时才认真看了官方给的第二条路，项目级 Design-System Master + Override。

方案 A 直接修改 skill 目录下的 CSV。适合个人用，简单直接，改完即生效。缺点也明确，更新 skill 会被覆盖，必须备份，我自己就被覆盖过一次。

方案 B 走项目级 Design-System Master + Override，官方原生支持。UI-UX-Pro-Max 可以把设计规范输出保存到项目目录，页面再单独写 override 覆盖。生成并保存主设计系统。

python3 .claude/skills/ui-ux-pro-max/scripts/search.py "审批后台" --design-system --persist -p "ApprovalAdmin"

项目目录会产出 design-system/MASTER.md（全局设计规范）和 design-system/pages/approval.md（审批页面单独覆盖规则）。

design-system/
├── MASTER.md        # 全局设计规范
└── pages/
    └── approval.md  # 审批页面单独覆盖规则

用的时候在 prompt 里让 AI 读项目本地的 MASTER.md，优先项目内规则，不需要修改 skill 安装目录，升级不受影响。我一开始以为方案 B 能顶替方案 A，后来被边界教育了。方案 B 适合团队项目级别的约束，不能新增行业推理规则，只能输出结果覆盖。想靠 AI 自动识别行业关键词、自动触发你的规则，必须改 products.csv。这是两条路线的根本分界，我在这上面绕了快一天。

五、交过学费的坑

把最近几天的翻车集中复盘一遍，六条，全是真金白银。

1. uipro update 会覆盖 data 文件夹，自定义 CSV 务必备份，这是翻车率最高的一条，我唯一一次被覆盖就是它。
2. CSV 编码必须是 UTF-8，WPS 编辑过务必另存为 UTF-8，存成 GBK 脚本直接乱码。
3. 字段内含有逗号，内容必须用英文双引号包裹，不然一列变两列。
4. 磁盘文件修改立刻生效，脚本不缓存，改完不用重启、不用重新安装。我之前为「改了没生效」折腾了半天，其实改完直接重跑就行。
5. BM25 靠 Keywords 关键词检索，关键词写太少匹配不到你的自定义条目，中文英文别名都写上，这是最隐蔽的一条。
6. 私有自定义规则不建议提交上游开源仓库，业务规范放本地 Git 维护。

输出也有个坑。规则一多，markdown 输出容易被截断，只看得到后半段，规则明明写进去了，界面却只显示前面一部分。这种时候用 --json 参数拿完整原始数据，截断的问题就绕过去了。

python3 scripts/search.py "审批后台" --design-system --json

六、我现在第一眼先盯哪儿

回头看这趟，我得到一条能用的规则，也看清了一件事。UI-UX-Pro-Max 最值钱的地方在它是 CSV 驱动的可扩展知识层，不用做大模型微调，不用复杂向量数据库，维护一张 CSV 表格，就能把行业规范、团队规范喂给 AI 编码助手。它为什么不用向量库。垂直行业规则这种小规模结构化知识，用 CSV + BM25 比向量库可控，规则可读、可版本管理、可离线运行，还不会因为语义漂移把相近行业的关键词误判命中。代价是要靠人工维护，规则写少了就命中不到。写规则比调 prompt 便宜，一次写好，处处生效。

现在再碰到「AI 生成的东西不贴行业」的页面，我第一眼先盯三件事。要不要新增行业自动推理，要就改 products.csv，还是只做单个项目约束，用 --persist 输出 MASTER.md。改之前备份了没有。Keywords 中文英文别名给够了没有。编码、引号这类低级错，吃过一次就不会再犯。反倒是「判断该改哪一层」这件事，我还在补。

你最近给 AI 编程助手喂过自己的行业规则吗？你最想先改的是 products.csv、styles.csv 还是 colors.csv？评论区聊聊你的 CSV 改造经验，比如踩过的编码坑、命中不了的 Keywords，或者已经跑通的行业规则。