用途
Lovstudio App 生成器用于创建或升级达到 Lovstudio 标准的应用。它不会强制进行桌面打包,而是根据需求简报选择应用类型:当工作流是浏览器原生时使用纯 Web,当需要原生桌面能力或桌面分发时使用 Tauri。
主要能力
- 支持常见技术栈:React + TypeScript + Vite、Next.js,或 Tauri + React。
- 集成 shadcn/ui、Lovstudio 品牌资产、Warm Academic UI、CI/CD 或部署接线,以及 lovinsp 点击即代码支持。
- 提供项目审计脚本,用于检查目标项目缺失的部分并生成实现清单。
- 支持新应用创建和现有应用升级两种模式。
使用方式
该技能要求按顺序执行以下步骤:
- 澄清应用简报:收集应用名称、项目 slug、品牌范围、目标模式、应用类型、平台、核心屏幕、后端/API、分发方式等字段。
- 读取本地上下文:检查目标项目中的 AGENTS.md、CLAUDE.md、package.json、vite.config.ts、next.config.ts、tauri.conf.json、Cargo.toml 等文件。
- 运行 Lovstudio 应用审计:从目标项目根目录运行
python3 "$SKILL_DIR/scripts/audit_app_project.py" --root . --app-type auto --format markdown。 - 选择实现路径:根据简报选择纯 Web、PWA 或 Tauri 桌面应用,并选择 Vite React、Next.js 或静态 HTML。
- 应用品牌与 UI 标准:使用 lovstudio-gen-logo 生成目标专属应用 logo,应用 Warm Academic UI 和 shadcn/ui,使用语义化 Tailwind 类。
- Tauri 应用基线:仅针对 Tauri 桌面应用检查 tauri.conf、Cargo.toml、Rust 命令、前端 API、文件系统/原生 API、图标、开发服务器等。
- CI/CD、部署与自动更新:为 Web 应用配置 check.yml 和部署接线;为 Tauri 应用配置 check.yml、release.yml 和 Tauri updater。
- Lovinsp:集成 lovinsp 用于前端开发,确认 Vite 配置中注册了 lovinspPlugin。
- 验证:运行类型检查、构建,必要时启动开发服务器并提供本地 URL。
适用场景
- 用户要求生成新的 Lovstudio 应用、Web 应用、PWA、桌面应用或跨平台应用。
- 用户已有前端/Tauri 项目,希望将其提升到 Lovstudio 应用标准。
- 用户在应用设置中提及 web-only、Vite、Next.js、PWA、Tauri、shadcn、React Query / TanStack Query、deploy、auto update、CI/CD、app logo、Lovstudio logo、Warm Academic UI 或 lovinsp。
- 项目属于 LovStudio、Lovpen、Lovcode、Lovmind、Lovshot、Lovsider、Lovsigil 或 Lovtarot 应用。
限制
- 新应用不得使用标准 Lovstudio logo 作为应用/产品图标。
- 不应仅因为该技能历史上默认使用 Tauri 就添加 Tauri;如果用户说“只创建 web”或需求不需要原生桌面能力,应创建 Web 应用。
- 升级现有应用时不应从零重建,应修补最小表面。
- 不得编造密钥,应使用占位符名称并记录用户需要设置的位置。
- Tauri v2 中 plugins.updater.pubkey 在运行时是必需的,即使早期脚手架阶段也不能省略。
- 审计脚本不需要 Python 包。
用户配置
可使用以下环境变量而非硬编码个人路径:
- LOVSTUDIO_APP_GENERATOR_SKILL_DIR:已安装的 lovstudio-app-generator 技能目录。
- LOVSTUDIO_SKILLS_DESIGN_GUIDE:Warm Academic 设计指南路径。
- LOVSTUDIO_SKILLS_BRAND_PROFILE:Lovstudio 品牌资产根目录或配置文件。
CLI 参考
- --root:默认 .,要检查的目标应用根目录。
- --app-type:默认 auto,可选 auto、web 或 tauri,控制应用哪些检查。
- --format:默认 markdown,可选 markdown 或 json。
- --output:默认 stdout,可选写入报告的文件路径。