Registry架构
说明源码管理位置、生成端点、依赖关系与安装边界。
源码管理位置
| 路径 | 负责内容 |
|---|---|
registry/src/components/ui | 可安装的UI基础组件 |
registry/src/components/blocks | 模板、工作界面与图表示例 |
registry/src/lib | 共享工具与分析数据模型 |
registry/src/theme.ts | 预设数据与令牌计算 |
registry/catalog.json | 条目元数据与依赖声明 |
生成产物
registry/registry.json · registry/public/r— 从注册表源码生成。docs/public/r— 为文档复制相同的安装端点。docs/src/registry— 同步的构建输入，不纳入Git管理，并非第二份原始源码。- 生成的CSS与主题初始化脚本来自同一个主题引擎。
安装流程
@neumorphism-ui — 命名空间通过一个URL模板解析。shadcn会安装各条目声明的注册表依赖。添加组件前，请先安装一次共享基础主题。
https://neumorphism-ui.andongmin.com/r/{name}.jsonnpx shadcn@latest add @neumorphism-ui/button完整独立安装检查在本地或手动完整验证工作流中执行。模板在全新Next.js项目中构建，其他包含文件的条目在Next.js与Vite中分别构建。默认CI检查代表性的使用方项目。
目录元数据
registry/directory-entry.json — 保存命名空间、主页、端点模板、描述与内联标志。文件存在不代表已经提交目录或获得批准。
责任边界
- 注册表不负责应用的认证、授权、持久化、路由或业务数据。
- 安装组件不得覆盖应用自有CSS、修改过的源码、别名或路由。
- 废弃路径直接删除，不保留兼容别名。