nianov-alpha/ai-ux-patterns

# ai-ux — AI 原生界面模式 一个免费、开源、**可搜索的 AI 产品 100 个 UX 模式数据库** — 涵盖了经典设计系统（如 Material、HIG）从未涉及的界面部分：流式响应、工具调用可视化、引用、幻觉处理、记忆透明度、语音轮次、提示词注入防御、多智能体交接等。 每个模式都包含**问题**、具体的**做法 / 禁忌**、**可直接粘贴的代码片段**，以及*信任影响*和*严重程度*评级。 - **100 个模式 · 24 个类别** - **零依赖** — 纯 Python 3.x 标准库 - 附带 **CLI**、**MCP server** 和 **交互式画廊** - **MIT 许可证** 存在的理由：构建 AI 产品的团队总在不断重复发明相同的界面决策（我该如何展示 agent 正在工作？我该如何标记低置信度的回答？我该如何让用户打断数据流？）。这些知识散落在各类博客文章中；本项目将其转化为可查询且开箱即用的代码。 ## 快速开始 ``` git clone https://github.com//ai-ux-patterns.git cd ai-ux-patterns # 搜索 python search.py "how do I show the agent is calling a tool" python search.py "stop button while streaming" -n 5 # 列出 categories python search.py --categories ``` 无需安装，无需 `pip` — Python 3.x 是唯一的要求。 ## 交互式画廊 在任何浏览器中打开 [`gallery.html`](gallery.html) 即可直观地浏览、搜索和过滤全部 100 个模式。它是完全独立的（无需网络，无需构建）。 编辑数据后，使用以下命令重新构建： ``` python scripts/build_gallery.py ``` ## 在你的 AI 工具中使用它 (MCP) [MCP](https://modelcontextprotocol.io) server 允许 Claude Desktop、Cursor、Windsurf、Cline 及其他 MCP client 直接查询数据库。详见 [`mcp/README.md`](mcp/README.md)。最小配置如下： ``` { "mcpServers": { "ai-ux": { "command": "python", "args": ["/ABSOLUTE/PATH/TO/ai-ux-patterns/mcp/server.py"] } } } ``` 提供的工具：`search_ai_ux_patterns`、`list_ai_ux_categories`。 ## 类别 流式 · 提示词输入 · 工具使用 · 信任与安全 · 反馈 · 记忆 · 延迟 · 错误 · 成本 · 引导 · 语音 · 安全 · 评估 · 引导控制 · 协作 · 可访问性 · 检索 · 多智能体 · 生成 · 个性化 · 授权 · 异步 · 发现 · 移动端 ## 数据格式 `data/ai-ux-patterns.csv` — 每行一个模式： | 列名 | 含义 | |--------|---------| | Pattern Category / Pattern Name | 分组和标题 | | Keywords | 搜索词 | | Problem / Solution | 用户痛点与 UX 方案 | | Do / Don't | 具体指导 | | Code Example / Anti-Pattern | 可直接粘贴的代码片段 vs 错误做法 | | When to Use | 应用场景 | | Trust Impact / Severity | Low · Medium · High | ## 贡献 模式只是 CSV 中的一行 —— 添加一个并提交 PR 即可。请保持*问题 → 方案 → 做法 → 禁忌 → 代码*的结构，并优先提供与框架无关的代码片段。 ## 许可证 MIT © 2026 Azka。其中的 BM25 搜索引擎改编自 [ui-ux-pro-max](https://github.com/nextlevelbuilder/ui-ux-pro-max-skill) (© Next Level Builder, MIT) — 详见 [`NOTICE.md`](NOTICE.md)。

标签：MCP, Python, Ruby, UI/UX设计, 人工智能, 后端开发, 无后门, 用户模式Hook绕过, 知识库, 设计模式, 调试辅助, 逆向工具