starwind-pro

Starwind Pro

Starwind Pro 基于 Starwind UI v3 构建。其公开区块仍是安装到应用中并在本地自定义的 Astro 组件。

规则

• 选择 Pro 区块前，确认目标是 Astro。
• 将 starwind.config.json 视为 V3 中框架、组件目标目录、注册表、Tailwind 和 Pro 授权设置的权威配置。
• 若缺少 Starwind UI，请使用 starwind init --framework astro --pro 初始化；对于现有项目，请使用 starwind setup。
• 指定区块前，先搜索最新的 MCP、CLI 或 Pro 元数据。
• 使用返回的准确安装命令；保留声明的组件依赖项。
• 替换演示内容时，保留区块的响应式布局、容器查询、动效与减少动效行为、无障碍支持，以及浅色／深色主题约定。
• 区分免费区块和高级区块。高级区块需要访问权限；可用性以元数据为准。
• 将 STARWIND_LICENSE_KEY 保存在 .env.local 或密钥管理器中，不要将其放入代码、日志、聊天内容或交接文本。

上下文

在推荐或安装区块前，检查以下内容：

1. package.json、锁文件、astro.config.*，以及正在修改的路由／布局。
2. starwind.config.json、配置的组件目录、已安装记录和本地导出。
3. 配置中指定的活动 Starwind CSS 文件及现有主题约定。
4. 如果设置可能会创建或更新 .env.local，请检查 .gitignore。

旧版 components.json 可能包含过时的 Pro 注册表设置；当前设置可以导入这些设置，但如果两者不一致，以 starwind.config.json 为准。

查找、安装与适配

1. 对于新项目，使用 starwind init --framework astro --pro 初始化；对于已初始化的 Starwind 项目，如果缺少 Pro 配置，请运行一次 starwind setup。
2. 通过当前 MCP starwind_search 或 starwind search <query> --json，按意图／类别／套餐搜索。
3. 选择套餐和依赖项符合项目要求的结果。
4. 在项目根目录运行其准确的安装命令。
5. 阅读所有新增的区块和组件文件。
6. 使用本地别名，将其接入目标 Astro 路由。
7. 替换占位内容、链接、数据和图片，同时保留响应式、容器查询、动画、无障碍和主题行为。
8. 运行相关的格式检查、类型检查、构建和页面／浏览器检查。

当区块源文件和依赖项已安装到配置的位置、占位内容已处理、导入可成功构建，且访问要求已准确说明时，区块任务即告完成。

参考资料

• setup.md：V3 Pro 配置、许可证边界和故障排查
• blocks.md：搜索、安装命令和适配