# ui-ux-pro-max 查询菜谱

ui-ux-pro-max 是本机的插件技能:一个 BM25 检索的本地设计库(84 风格 / 192 配色 /
74 字体对 / 98 UX 守则 / 104 图标 / 25 图表)。**我们只用它的查询脚本拿设计方向,
不装载它的整套工作流**——它的持久化步骤会往仓库写文件,字体/动效建议也与 JCAI
契约相抵,见下面的过滤表。

## 定位与调用

```bash
UIPM=$(ls -d ~/.claude/plugins/cache/ui-ux-pro-max-skill/ui-ux-pro-max/*/.claude/skills/ui-ux-pro-max 2>/dev/null | sort -V | tail -1)
python3 "$UIPM/scripts/search.py" "<query>" --design-system -p "<件名>" --density 7
```

**缺席兜底**:`$UIPM` 为空(插件没装/被移除)时不装死——按「A1 版面语言 + 中高密度」
的默认继续走,并在交付说明里写一句「设计库缺席,走了默认」。

## 查询配方

| 场景 | query 建议 | 旋钮 |
|---|---|---|
| 执行页(密表核对) | `enterprise b2b workflow document review data table form` | `--density 7`(仪表密度,信息多) |
| 验收/归档页(仪式感) | `invoice quotation official document archive certificate` | `--density 5 --variance 4` |
| 汇报/对比 slide | `executive summary comparison dashboard presentation` | `--density 6 --variance 6` |
| 单域深挖 UX | `--domain ux` + `form table dense data review` | `-n 5` |
| 单域深挖版面风格 | `--domain style` + `editorial minimal document swiss` | `-n 5` |

0 结果:换一次关键词;仍空就走默认并明说,不编造「数据库推荐」。

## 三不用(命令行层面)

- `--persist` / `--output-dir`:会往仓库写 `design-system/<slug>/MASTER.md` —— 污染仓库
- `--motion`:产出 GSAP JS 片段,而目标件零脚本
- `--stack`:我们不是在选框架,产物是纯 HTML/CSS

## 五不取 · 四要取(结果层面)

| 它给的 | 取舍 | 为什么 |
|---|---|---|
| 字体对 + Google Fonts 外链 | **不取** | 目标件零外链;字体族固定 PRD_CSS 系统栈(Inter…PingFang SC) |
| 配色替换 | **不取** | JCAI 家族令牌零改动(--brand #3370ff 等);`v-*` 语义色承载判定语义 |
| GSAP/JS 动效 | **不取** | 零脚本。可译成纯 CSS 的意图(时长/缓动)可参考,且已有 reduced-motion 守卫 |
| 图标库引用 | **不取** | 一律 PRD_SPRITE 内联 symbol(见 block-catalog) |
| 任何 CDN/外部资源 | **不取** | 安装门与自检都拦 |
| 版面构图(分栏/bento/层级) | **取** | 这正是要它出的「精美组件布局突出结构」 |
| 组件形制(卡/带/表头/徽章的形) | **取** | 译成 JCAI 令牌下的 CSS |
| 密度/留白档 | **取** | 执行页密、归档页缓 |
| UX 守则(对比度/触达面积/反馈位置) | **取** | 出稿前对照检查 |

**取的东西只进脑子,不落盘**——查询结果不存文件,消化成设计决定写进件里。