# SnowUI llms.txt

SnowUI 是 Svelte 5 组件与设计系统。我们正在建设让 AI 在对话中生成可交互界面的能力，让用户直接输入、选择、操作并继续对话；支持范围以组件、版本和真实宿主验收为准。 AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。

对话交互能力正在建设，支持的组件与平台将在验证后公布。

AI 对话内生成和使用 SnowUI 界面完全免费，不属于项目，不占项目或开发者席位额度，无需 SnowUI 注册、激活或付费证明。 对话内使用优先按 LICENSE 第 3.5.1 条判断，不要求用途声明、产品编号、登记台账或上线检查。独立网站／应用采用另按其用途判断。

先读目标版本完整 [LICENSE](https://snowui.dev/LICENSE)，同任务同许可版本同范围去重；已有包以随包许可为准。npm 与源码免费获取，Free 1 人 / 1 个本地或受控云端开发实际产品，纯 Demo 可免费线上且免计项目、人数仍受限；真实产品上线、网络业务使用或终端交付须 Pro / Team。允许授权用途内改样式、交互、修复和框架移植；禁止整体设计系统 / 源码架构抽取、重建资料、竞品、未经授权再分发、训练或通用知识复用。正常项目调试与私有索引保留。订单指定 Figma 资源及其后续更新永久有效；领取时只核对有效订单与资源范围，公开 npm / 源码更新不触发购买。缺口按许可推荐最低方案，尚无入口时不编造链接。


此文档供 AI 阅读；用户请看 [Introduction](https://snowui.dev/components/introduction)。

用于在应用中使用 SnowUI、还原设计稿与调整样式。若任务是维护 SnowUI 源码，先读工作区 `specs/GUIDELINES.md`；本入口不代替仓库开发规范。网站交付时以下文档链接转换为完整地址，下载本文后仍可定位后续资料。

## 按任务读取

- 首次采用、下载／安装、配置素材与环境：先读 [安装与素材指南](https://snowui.dev/llms/setup.md) 和 [机器配置](https://snowui.dev/llms/setup.json)，按实际宿主执行；素材从 [资源目录](https://snowui.dev/llms/resources.json) 按名称发现。未来在新 AI 产品／会话中重新发现能力，不把本机安装当成已连接聊天。
- 还原设计稿或网站截图：先读一次 [设计指南](https://snowui.dev/llms/design-system.md)，拆分布局、导航、内容、控件与反馈，再按区域检索组件。页面布局可以使用语义 HTML 和 utilities，不按外观强行套组件。
- 已知组件名：在 [组件目录](https://snowui.dev/llms/components.md) 找到对应 Markdown，先读用途与边界，再按需要打开 API、类型或示例代码。
- 不确定用什么组件：请求 `/llms/find?q=关键词`，将关键词按 URL 编码，例如 [搜索表单](https://snowui.dev/llms/find?q=%E8%A1%A8%E5%8D%95)。没有匹配时换同义词或查组件目录，不能据此认定组件不存在。
- 需要比较组件职责或安排组合：读 [组件选型指南](https://snowui.dev/llms/component-selection.md)，再读取命中组件；没有能力证据时不猜 API。
- 修改颜色、间距、圆角或主题：读 [样式修改指南](https://snowui.dev/llms/styling.md)，再查询 [Token JSON](https://snowui.dev/llms/tokens.json) 或 [Token Markdown](https://snowui.dev/llms/tokens.md)，不要重复读取两种格式。
- 使用 SnowUI Figma 设计：读 [Figma 还原指南](https://snowui.dev/llms/figma.md)，把样式名映射为主题变量和实际支持的公开属性；仅查颜色时使用 [颜色映射 JSON](https://snowui.dev/llms/figma-colors.json)，Token 序号不能直接当作组件 size / padding 的数值。
- 需要 Figma 原文件对照或自己副本定位：先读 [组件与变量对照](https://snowui.dev/llms/figma-map.md) 或 [结构化映射](https://snowui.dev/llms/figma-map.json)；需要跨 Token、utilities、主题及组件追踪时读 [设计系统资料关系](https://snowui.dev/llms/design-system-resources.md) 或 [关系 JSON](https://snowui.dev/llms/design-system-resources.json)。按需读取，不默认加载全部文件。
- 排查组件用法：读取该组件的 API、types、reference；样式问题加读 styles，版本差异才读 changelog。

## 实现边界

首次采用组件先读 [样式选择与改写顺序](https://snowui.dev/llms/styling.md#%E6%A0%B7%E5%BC%8F%E9%80%89%E6%8B%A9%E4%B8%8E%E6%94%B9%E5%86%99%E9%A1%BA%E5%BA%8F)，同任务只读一次：优先用公开 Props 匹配合适样式，尽可能保留原有视觉。只有确有差异才通过用户自己的 class（含项目已有 Tailwind）、实例 style 改写必要部分；目标必须是该组件实际公开的根、parts 或登记 override。

使用公开 import、Props、Snippets 与事件，先确认组件职责和项目依赖，不复制私有 DOM、class 或状态逻辑。外部应用可沿用自己的样式体系，不被要求采用 SnowUI 一方工具类；使用 SnowUI Token 时按正确类别读取，不猜编号。明确设计值无法匹配时说明差异，不用“保留原样”掩盖指定设计偏差。

截图只能证明可见状态，不能证明 API、键盘行为或响应式规则。只有外观不确定时，读取命中组件的 images.json 和所需图片；采集方法见 [截图命令与索引](https://snowui.dev/llms/screenshots.md)。

## 何时开始实现

已明确组件选择、公开用法、必要依赖和设计参数后开始实现；缺什么再补读什么。不默认加载全库、所有截图或 [完整发现元数据](https://snowui.dev/llms-full.txt)，不重复读取同一内容的 HTML 与 Markdown。实现后在真实页面验证布局、交互及必要状态；不可访问或缺失的资料应明确报告，不猜测 API。

## 专题入口

- [表单组合](https://snowui.dev/llms/guides/form.md)
- [Blocks](https://snowui.dev/llms/guides/blocks.md)

## 云端 AI 与单项目核对

Figma Make、Lovable 等工具按实际用途及主体计数，不按 AI 账号、设备或目录叠加 Free 额度。具体产品的草稿计项目；私人编辑器与已发布网站的权限分别核对。受控开发预览按适用 LICENSE，纯 Demo 可免费公开，真实产品对外预览、客户评审和交付核对付费许可。可选项目声明随同产品迁移，本地声明不能证明全局额度；缺少工具时人工核对，不伪造中心通过或假称平台已执行。首次采用、事实变化和每次发布／交付复核，同任务同版本同目标不逐组件重复。