Secretmakewomenwomen/auric-ui

AuricUI 是一个面向 AI 界面的 React 组件库：它把基础控件、聊天与工具调用组件，以及编辑器用的时间轴、图层和属性面板放进同一套视觉系统，并提供深浅主题。已经在用 React 开发 AI 助手或 Agent 工作台的团队，是最直接的适用对象。

提供什么

组件按场景拆成多个入口：auricui 提供按钮、表单、表格、抽屉和主题 Provider；auricui/agent 提供消息、引用、工具执行、操作确认和记忆；auricui/chat 提供富文本输入、Markdown 和模型菜单；auricui/studio 提供时间轴、图层、素材、项目和编辑器组件。另有 demo 入口提供本地模拟数据，auricui/styles.css 自带编译好的样式、字体和动画，不需要额外配置 Tailwind（组件入口）。

典型接入流程

在已有项目中安装后，在应用入口导入样式，并在根部挂载一次 AuricUIProvider 并传入主题；Provider 负责驱动 --bg、--text 等 CSS 变量。在初始 HTML 中设置 <html data-theme="dark"> 可以让首屏配色保持一致。基础组件和 Agent 组件通过 props 与回调连接业务逻辑。部分 Chat / Studio 组合组件需要应用提供模型调用、项目持久化和媒体处理等服务适配器；文档中的完整场景对这些服务行为使用本地模拟，因此不能把演示当作可用后端（接入示例）。

一个有特点的部分是可选的编程 Agent Skill：用 npx auricui-skill@latest 安装到 .agents/skills/auricui，或加 --global 全局安装。它按需读取——Agent 先搜索组件，再查询单个组件的参数，而不是一次性加载整个索引；参数优先来自项目实际安装的版本。Skill 只安装指南和工具，组件库仍需通过 npm 安装，其依赖与 API 查询脚本需要 Python 3（Skill 说明）。

要求与限制

组件库面向 React 19 + React DOM 19 项目。安装使用 npm 的 next 预览渠道，README 说明它可能落后于仓库源码，因此实际安装版本以项目锁文件为准。源码开发需要 Node.js 22.12+、npm 和 tar，推荐使用 .nvmrc 指定的 Node 22；完整验证还需要 Python 3。构建与检查命令覆盖类型声明、ESM 导入、SSR、浏览器构建和文档示例编译，但 README 明确指出界面交互仍需在浏览器中验证（运行文档）。

许可

项目采用 MIT 许可证，但部分 Chat / Studio UI 与浏览器算法来自 OpenFilm，保留其单独的 MIT 许可证；字体、服务商图标及其他依赖也有各自的声明，再分发时应一并保留（第三方声明）。