开始使用
从真实产品中沉淀，让下一个项目从一致、完整的界面开始。
Kitseed 是从 Subtic Web 提炼的 React 组件与界面规范。它保留细腻的内容层级、紧凑的工作区密度和完整的交互状态，通过 shadcn Registry 把源码安装到你的项目。
这里既是组件查看手册，也是做产品时的判断依据：什么时候使用、如何组合、哪些状态需要补全，以及哪些职责应留在业务中。
从一个完整界面开始
先尝试切换、输入和保存，再查看示例代码。每个预览运行在独立画布中，可切换主题和宽度；组件源码与预览使用同一套实现。
找到需要的层级
| 层级 | 解决的问题 | 起点 |
|---|---|---|
| 设计基础 | 颜色、字体、尺寸、焦点与动态效果如何一致 | 设计基础 |
| 基础组件 | 一个操作、一个字段或一个反馈如何工作 | Button、Field |
| 结构组件 | 页面、设置、内容集合如何组织 | Page、Settings、Collection |
| 组合模式 | 一组组件如何完成真实任务 | 设置工作区、编辑表单 |
源码属于使用它的项目
安装后，你会在自己的代码库中得到组件和依赖。可以阅读、组合与修改；升级需要主动审查差异，已安装代码不会被远程静默替换。
Kitseed 的职责是呈现和交互。权限判断、请求、路由、翻译字典、数据持久化与桌面桥接由应用提供，组件通过 props、回调和插槽接入。
先理解，再使用
- 按安装指南注册当前文档站的版本化 Registry，并安装基础主题。
- 查看设计基础，统一语义 tokens 与布局节奏。
- 选一个组件，阅读用途、API 和键盘行为，在项目中验证。
- 需要组合时使用模式页；接入真实业务时保留原有语义和状态。
这次提炼的边界
当前版本为 0.3.0 本地候选，聚焦 React Web 与共用前端的 Desktop；Subtic 已通过固定版本源码接入基础组件与图片预览。本仓库记录组件来源与改造边界，详见提炼审查。原生 Apple 界面与线上发布不属于本次本地交付。