csh/playbook
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

📦 deps(thirdparty): update snapshots

Browse Source
This commit is contained in:
ci[bot]
2026-08-14 17:16:04 +08:00
parent ad5eeaaf5b
commit 14e7209e78
283 changed files with 201717 additions and 13469 deletions
Download Patch File Download Diff File Expand all files Collapse all files
ui-ux-pro-max/README.zh.md
+113 -103
View File
@@ -7,8 +7,8 @@
<p align="center">
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/releases"><img src="https://img.shields.io/github/v/release/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=blue" alt="GitHub Release"></a>
<img src="https://img.shields.io/badge/reasoning_rules-161-green?style=for-the-badge" alt="161 条推理规则">
<img src="https://img.shields.io/badge/UI_styles-67-purple?style=for-the-badge" alt="67 种 UI 风格">
<img src="https://img.shields.io/badge/reasoning_rules-192-green?style=for-the-badge" alt="192 条推理规则">
<img src="https://img.shields.io/badge/UI_styles-79_searchable-purple?style=for-the-badge" alt="79 种可搜索 UI 风格">
<img src="https://img.shields.io/badge/python-3.x-yellow?style=for-the-badge&logo=python&logoColor=white" alt="Python 3.x">
<a href="https://github.com/nextlevelbuilder/ui-ux-pro-max-skill/blob/main/LICENSE"><img src="https://img.shields.io/github/license/nextlevelbuilder/ui-ux-pro-max-skill?style=for-the-badge&color=green" alt="License"></a>
</p>
@@ -62,7 +62,7 @@ v2.0 的旗舰特性是**设计系统生成器**——一个 AI 驱动的推理
| 风格：柔和 UI 进化版 (Soft UI Evolution) |
| 关键词：柔和阴影、微妙深度、 calming、高级质感、有机形状 |
| 适用：健康、美容、生活方式品牌、高端服务 |
| 性能：优秀 | 无障碍：WCAG AA |
| 性能：cost:low | 无障碍：risk:conditional；需验证具体要求 |
| |
| 配色： |
| 主色： #E8B4B8 (柔和粉) |
@@ -78,7 +78,7 @@ v2.0 的旗舰特性是**设计系统生成器**——一个 AI 驱动的推理
| Google Fonts: https://fonts.google.com/share?selection.family=... |
| |
| 关键效果： |
| 柔和阴影 + 平滑过渡 (200-300ms) + 细腻悬停状态 |
| 柔和阴影 + 符合平台与组件语境的过渡 + 细腻悬停状态 |
| |
| 避免 (反模式)： |
| 亮霓虹色 + 生硬动画 + 深色模式 + AI 紫/粉渐变 (银行业) |
@@ -86,10 +86,11 @@ v2.0 的旗舰特性是**设计系统生成器**——一个 AI 驱动的推理
| 交付前检查清单： |
| [ ] 不使用表情符号作为图标 (使用 SVG: Heroicons/Lucide) |
| [ ] 所有可点击元素有 cursor-pointer |
| [ ] 悬停状态带平滑过渡 (150-300ms) |
| [ ] 交互时长符合平台、组件和用户偏好 |
| [ ] 浅色模式：文字对比度至少 4.5:1 |
| [ ] Focus 状态对键盘导航可见 |
| [ ] 尊重 prefers-reduced-motion 偏好 |
| [ ] 文字、chip 与 badge 能重排，不裁切或破坏标签 |
| [ ] 响应式：375px、768px、1024px、1440px |
| |
+----------------------------------------------------------------------------------------+
@@ -106,11 +107,11 @@ v2.0 的旗舰特性是**设计系统生成器**——一个 AI 驱动的推理
▼
┌─────────────────────────────────────────────────────────────────┐
│ 2. 多域搜索 (5 个并行搜索) │
│ • 产品类型匹配 (161 个分类) │
│ • 风格推荐 (67 种风格) │
│ • 配色方案选择 (161 套配色) │
│ • 落地页模式 (24 种模式) │
│ • 字体配对 (57 种组合) │
│ • 产品类型匹配 (192 个分类) │
│ • 风格推荐 (79 种可搜索；50 种 active) │
│ • 配色方案选择 (192 套配色) │
│ • 落地页模式 (34 种模式) │
│ • 字体配对 (74 种组合) │
└─────────────────────────────────────────────────────────────────┘
│
▼
@@ -130,7 +131,7 @@ v2.0 的旗舰特性是**设计系统生成器**——一个 AI 驱动的推理
└─────────────────────────────────────────────────────────────────┘
```
### 161 条行业特定推理规则
### 192 条行业特定推理规则
推理引擎包含针对以下领域的专门规则：
@@ -155,106 +156,42 @@ v2.0 的旗舰特性是**设计系统生成器**——一个 AI 驱动的推理
## 功能特性
- **67 种 UI 风格** - 玻璃拟态、粘土拟态、极简主义、粗野主义、新拟态、便当盒网格、深色模式、AI 原生 UI 等
- **161 套配色方案** - 与 161 种产品类型 1:1 对齐的行业专属调色板
- **57 种字体配对** - 精选字体组合，含 Google Fonts 导入
- **79 种可搜索 UI 风格（50 种 active）** - 玻璃拟态、粘土拟态、极简主义、粗野主义、新拟态、便当盒网格、深色模式、AI 原生 UI 等
- **192 套配色方案** - 与 192 种产品类型 1:1 对齐的行业专属调色板
- **74 种字体配对** - 精选字体组合，含 Google Fonts 导入
- **25 种图表类型** - 适用于仪表板和分析场景的推荐
- **22 种技术栈** - React、Next.js、Astro、Vue、Nuxt.js、Nuxt UI、Svelte、SwiftUI、React Native、Flutter、HTML+Tailwind、shadcn/ui、Jetpack Compose、Angular、Laravel、Three.js、JavaFX、WPF、WinUI 3、UWP、Avalonia、Uno Platform
- **99 条 UX 指南** - 最佳实践、反模式与无障碍规则
- **161 条推理规则** - 行业特定的设计系统生成（v2.0 新增）
- **119 条 UX 指南** - 最佳实践、反模式、无障碍规则、弹性文字布局、紧凑标签与可取消交互
- **192 条推理规则** - 行业特定的设计系统生成（v2.0 新增）
### 可用风格 (67)
### 弹性文字与紧凑型 UI
<details>
<summary><b>通用风格 (49)</b></summary>
指南现在覆盖标题、长 token、chip、badge 以及微交互被中断时常见的生产问题：
| # | 风格 | 最适用于 |
|---|------|---------|
| 1 | 极简主义 & 瑞士风格 | 企业应用、仪表板、文档 |
| 2 | 新拟态 (Neumorphism) | 健康/养生应用、冥想平台 |
| 3 | 玻璃拟态 (Glassmorphism) | 现代 SaaS、金融仪表板 |
| 4 | 粗野主义 (Brutalism) | 设计作品集、艺术项目 |
| 5 | 3D & 超写实主义 | 游戏、产品展示、沉浸式体验 |
| 6 | 活力 & 块状 | 创业公司、创意机构、游戏 |
| 7 | 深色模式 (OLED) | 夜间模式应用、编程平台 |
| 8 | 无障碍 & 伦理设计 | 政府、医疗、教育 |
| 9 | 粘土拟态 (Claymorphism) | 教育应用、儿童应用、SaaS |
| 10 | 极光 UI (Aurora UI) | 现代 SaaS、创意机构 |
| 11 | 复古未来主义 | 游戏、娱乐、音乐平台 |
| 12 | 扁平设计 | Web 应用、移动应用、初创 MVP |
| 13 | 拟物化 | 传统应用、游戏、高端产品 |
| 14 | 液态玻璃 | 高端 SaaS、高端电商 |
| 15 | 动效驱动 | 作品集网站、叙事平台 |
| 16 | 微交互 | 移动应用、触摸屏 UI |
| 17 | 包容性设计 | 公共服务、教育、医疗 |
| 18 | 零界面 | 语音助手、AI 平台 |
| 19 | 柔和 UI 进化版 | 现代企业应用、SaaS |
| 20 | 新粗野主义 | Z 世代品牌、创业公司、Figma 风格 |
| 21 | 便当盒网格 | 仪表板、产品页面、作品集 |
| 22 | Y2K 美学 | 时尚品牌、音乐、Z 世代 |
| 23 | 赛博朋克 UI | 游戏、科技产品、加密货币应用 |
| 24 | 有机亲生物 | 健康应用、可持续品牌 |
| 25 | AI 原生 UI | AI 产品、聊天机器人、Copilot |
| 26 | 孟菲斯设计 | 创意机构、音乐、年轻品牌 |
| 27 | 蒸汽波 | 音乐平台、游戏、作品集 |
| 28 | 维度分层 | 仪表板、卡片布局、模态框 |
| 29 | 夸张极简主义 | 时尚、建筑、作品集 |
| 30 | 动态字体 | 主视觉区、营销网站 |
| 31 | 视差叙事 | 品牌故事、产品发布 |
| 32 | 瑞士现代主义 2.0 | 企业网站、建筑、编辑类 |
| 33 | HUD / 科幻 FUI | 科幻游戏、太空科技、网络安全 |
| 34 | 像素艺术 | 独立游戏、复古工具、创意 |
| 35 | 便当网格 | 产品特性、仪表板、个人 |
| 36 | 空间 UI (VisionOS) | 空间计算应用、VR/AR |
| 37 | 电子墨水 / 纸张 | 阅读应用、数字报纸 |
| 38 | Z 世代混沌 / 极繁主义 | Z 世代生活方式、音乐艺术家 |
| 39 | 仿生 / 有机 2.0 | 可持续科技、生物科技、健康 |
| 40 | 反精致 / 原始美学 | 创意作品集、艺术家网站 |
| 41 | 触感数字 / 可变形 UI | 现代移动应用、趣味品牌 |
| 42 | 自然提炼 | 健康品牌、可持续产品 |
| 43 | 交互式光标设计 | 创意作品集、交互式 |
| 44 | 语音优先多模态 | 语音助手、无障碍应用 |
| 45 | 3D 产品预览 | 电商、家具、时尚 |
| 46 | 渐变网格 / 极光进化 | 主视觉区、背景、创意 |
| 47 | 编辑网格 / 杂志 | 新闻网站、博客、杂志 |
| 48 | 色差 / RGB 分离 | 音乐平台、游戏、科技 |
| 49 | 复古模拟 / 胶片 | 摄影、音乐/黑胶品牌 |
- 标题平衡换行属于 progressive enhancement，不能保证某个单词一定留在最后一行。
设计仍须在不同宽度、字体和 locale 下支持自然换行。
- 关键文字在窄屏、浏览器缩放、文字缩放和用户文字间距覆盖下必须完整 reflow，
不得裁切；长 URL 和 identifier 应能安全换行。
- Chip 与 tag 集合应换行，或提供可操作的 `+n` 展开入口。紧凑标签应尽量保持
单行；不可避免的截断必须让键盘、pointer 和 touch 用户都能查看完整值。
- Badge 的含义不能只依赖颜色。交互式 chip 需要原生 semantics、可见 Focus 和
programmatic state；动态计数需要有意义的上下文。
- 快速交互可以取消 animation，但最终 semantic state、Focus 与内容必须正确。
Timing 应按平台和组件选择，并尊重 reduced-motion 偏好。
</details>
### 风格分类
<details>
<summary><b>落地页风格 (8)</b></summary>
数据库包含 **79 种可搜索风格**，并使用稳定 ID 和别名关联：
| # | 风格 | 最适用于 |
|---|------|---------|
| 1 | 主视觉中心设计 | 具有强烈视觉识别度的产品 |
| 2 | 转化优化型 | 潜在客户生成、销售页面 |
| 3 | 功能丰富展示 | SaaS、复杂产品 |
| 4 | 极简直接型 | 简单产品、应用 |
| 5 | 社交证明聚焦 | 服务、B2C 产品 |
| 6 | 交互产品演示 | 软件、工具 |
| 7 | 信任与权威型 | B2B、企业、咨询 |
| 8 | 叙事驱动型 | 品牌、代理公司、非营利 |
| 状态 | 数量 | 搜索行为 |
|------|-----:|----------|
| Active | 50 | 参与常规推荐，并默认显示在 Gallery 中 |
| Supplemental | 29 | 仅在精确名称或明确的变体/设计系统意图下返回；可通过 Gallery 状态筛选查看 |
| Deprecated | 9 | 不参与常规排序；旧名称会重定向到规范风格或落地页模式 |
</details>
Active 集合包括 43 个通用视觉家族、2 个移动端专用风格、3 个官方平台/设计系统、1 个平台材质，以及 1 个核心分析风格。当前官方系统包括 Fluent 2、Shopify Polaris 和 Adobe Spectrum；Liquid Glass 被限定为 Apple 平台材质，Material 3 Expressive 保留为 Material 移动端变体，Spectrum 2 为 Supplemental。落地页结构位于独立的 34 条模式数据集中，不再与视觉风格竞争 BM25 排名。
<details>
<summary><b>BI/分析仪表板风格 (10)</b></summary>
| # | 风格 | 最适用于 |
|---|------|---------|
| 1 | 密集数据仪表板 | 复杂数据分析 |
| 2 | 热力图风格 | 地理/行为数据 |
| 3 | 高管仪表板 | 高管摘要 |
| 4 | 实时监控 | 运维、DevOps |
| 5 | 钻取分析 | 详细探索 |
| 6 | 对比分析仪表板 | 并排对比 |
| 7 | 预测分析 | 预测、ML 洞察 |
| 8 | 用户行为分析 | UX 研究、产品分析 |
| 9 | 财务仪表板 | 财务、会计 |
| 10 | 销售智能仪表板 | 销售团队、CRM |
</details>
完整分类及 provenance 元数据见 [`styles.csv`](src/ui-ux-pro-max/data/styles.csv)。
## 💎 基础版与高级版对比
@@ -262,9 +199,9 @@ v2.0 的旗舰特性是**设计系统生成器**——一个 AI 驱动的推理
### 🟢 基础版（本仓库）
* **完全开源：** 适合个人开发者、爱好者及标准项目。
* **核心 UI/UX 智能：** 完整支持 67 种 UI 风格、161 种产品类型、配色方案和精选字体配对。
* **核心 UI/UX 智能：** 完整支持 79 种可搜索 UI 风格（50 种 active）、192 种产品类型、配色方案和精选字体配对。
* **智能推荐：** 内置 BM25 搜索引擎，提供高精度的设计匹配。
* **跨平台支持：** 提供针对 13+ 主流框架（React、Vue、Tailwind、iOS、Android 等）的技术栈专属指南。
* **跨平台支持：** 提供针对 22 个主流技术栈（React、Vue、Tailwind、iOS、Android 等）的专属指南。
* **设计系统生成：** 通过 CLI 即时生成定制化的 UI 规则、模式与逻辑。
### 🟡 高级版
@@ -434,15 +371,27 @@ python3 .claude/skills/ui-ux-pro-max/scripts/search.py "fintech banking" --desig
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "glassmorphism" --domain style
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "elegant serif" --domain typography
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "dashboard" --domain chart
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "error summary validation" --domain ux
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "decorative icon aria hidden" --domain icons
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "icon button accessible label" --domain icons
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "orphan heading line balance" --domain ux
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "badge chip label wraps to second line" --domain ux
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "rapid chip animation interrupted" --domain ux
# 特定技术栈指南
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "form validation" --stack react
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "responsive layout" --stack html-tailwind
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "chip badge overflow nowrap" --stack html-tailwind
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "tableview binding" --stack javafx
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "atlantafx primer enterprise theme" --stack javafx
python3 .claude/skills/ui-ux-pro-max/scripts/search.py "enterprise tableview density permission" --stack javafx
```
Web 技术栈搜索支持版本感知。未指定旧主版本时，只返回当前 active 指南；明确使用
legacy 关键词或旧主版本（例如 `Svelte 4`、`Next.js 15`）时，只返回经过整理的
legacy 条目，并通过 `Status` 和 `Applies To` 标识。若没有对应的 legacy 指南，
搜索会返回空结果，不会混合不同框架世代的内容。
### 持久化设计系统 (主配置 + 覆盖模式)
将设计系统保存到文件，实现**跨会话的层级检索**：
@@ -517,6 +466,8 @@ cli/ # CLI 安装器 (从模板生成文件)
cd cli
npm run sync:assets
npm run check:assets
npm run verify:data
npm run typecheck
# 5. 构建并测试 CLI
bun run build
@@ -531,6 +482,65 @@ gh pr create
详细的开发指南请参见 [CLAUDE.md](CLAUDE.md)。
### Catalog provenance 与刷新流程
当前提交的 catalog summary 记录了 **1,934 个已批准的 Google Fonts**，
以及 **8 个待审核的排除项**；在缺少匹配的官方 license 元数据时，这些排除项
不会被提升。图标指导仍有 **105 条精选记录**（其中 100 条是直接的
Phosphor web imports，其余为 React Native/fallback 指导）；独立的
**1,512-icon Phosphor upstream manifest** 用于验证名称、weights 以及
React/SSR imports，而不会把整个 upstream package 塞进搜索结果。
日常开发和 pull-request CI 完全离线，不依赖网络。可用以下命令运行完整
offline gate，其中包含 snapshot hash 和生成计数校验：
```bash
npm --prefix cli run verify:data
# 或仅检查生成的 catalog summary：
npm --prefix cli run validate:catalog-summary
```
也可以使用已提交的 fixtures 完全离线执行 refresh normalization。输出只写入
临时 candidate 目录，绝不会替换 canonical data：
```bash
candidate_dir="$(mktemp -d)"
python3 scripts/refresh-google-fonts.py \
--api-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-api.json \
--metadata-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-metadata.json \
--existing-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-existing.csv \
--overrides src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/google-overrides.json \
--output-csv "$candidate_dir/google-fonts.csv" \
--license-output "$candidate_dir/google-font-licenses.json" \
--metadata-revision fixture-catalogs-v1 \
--verified-at 2026-08-13 --expected-count 2 --approve-changes
python3 scripts/refresh-icon-catalog.py \
--input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-core.json \
--package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-package.json \
--react-package-json src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-package.json \
--react-exports-input src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/phosphor-react-exports.json \
--curated-csv src/ui-ux-pro-max/scripts/tests/fixtures/catalogs/icons-curated.csv \
--output "$candidate_dir/phosphor-icons-upstream.json" \
--verified-at 2026-08-13 --expected-count 2
```
Live upstream refresh 被有意隔离在 `refresh-catalogs.yml` workflow 中；它会在
每周一 03:17 UTC 定时运行，也可以手动触发。将 `GOOGLE_FONTS_API_KEY` 配置为
GitHub Actions secret，然后运行并下载审核 artifact：
```bash
gh workflow run refresh-catalogs.yml
run_id="$(gh run list --workflow refresh-catalogs.yml --limit 1 --json databaseId --jq '.[0].databaseId')"
gh run watch "$run_id"
gh run download "$run_id" --name "catalog-refresh-review-$run_id"
```
该 workflow 读取 Google Fonts Developer API 和固定版本的官方 Phosphor
packages，只把 candidates 与 unified diffs 写入 artifact，并且仅有只读仓库权限。
它不会 commit、push、创建 PR 或 merge。必须先审核 change reports、排除项、
licenses、relevance metrics 和 offline gate，之后才能手动把 candidate files
提升到 `src/ui-ux-pro-max/data/`。
## 自动化发布
本仓库使用 semantic-release 配合约定式提交 (Conventional Commits) 自动创建 GitHub 发布：