🌿 Vine

面向 SwiftUI 三端项目的脚手架、规范和命令行工具仓库，重点服务 iPhone、iPad、macOS 的统一开发与团队交付。

📦 仓库现在包含什么

• Templates/VineScaffold 当前主模板，已经具备：
  • 可运行首页、内容流、设置、诊断、交付页
  • 本地会话、启动引导、环境切换
  • 自动生成新功能模块骨架
  • 发布前检查和交付材料脚本
• VineCLI 统一命令行工具，命令入口是 vine
• docs/standards 三份正式规范文档，覆盖结构、编码协作、液态玻璃边界
• docs/distribution 团队安装和分发说明

🚀 现在最推荐怎么用

1. 先看规范

• 🧭 脚手架规范
• 🛠️ 编码与协作规范
• 🫧 液态玻璃使用规范

2. 再看模板

• 📘 模板总说明
• 🧭 脚手架迁移蓝图

3. 最后看 CLI

• 🧰 Vine CLI 说明
• 📦 团队安装说明
• 🚚 发布流程

🧰 CLI 现在能做什么

你可以直接在仓库根目录运行：

swift run vine --help

常用命令：

swift run vine env doctor
swift run vine env update
swift run vine project create MyProduct --app-name 我的产品 --bundle-prefix com.company.myproduct
swift run vine project feature FeatureInbox --project /path/to/project
swift run vine project generate --project /path/to/project
swift run vine release checks --project /path/to/project
swift run vine release prepare v1.0.0 --project /path/to/project

如果你懒得一次写全参数，也可以直接运行：

swift run vine project create

它会按顺序问你项目名、显示名、Bundle 前缀和模板类型。

⬇️ 最省事的安装方式

直接拉 GitHub 最新版安装：

curl -fsSL https://github.com/FruitsAI/Vine/releases/latest/download/install-vine-latest.sh | zsh
vine env doctor

装好以后，更新直接运行：

vine env update

🚚 第一次发版怎么做

最省事的一条准备命令：

./scripts/prepare-vine-cli-release.sh <new-version>

例如：

./scripts/prepare-vine-cli-release.sh 0.2.5

然后按顺序执行：

git add VERSION
git commit -m "chore: release vine v<new-version>"
git tag vine-v<new-version>
git push origin <当前分支>
git push origin vine-v<new-version>

🏗️ 这套东西适合拿来做什么

• 作为团队统一的 SwiftUI 三端起步模板
• 作为新项目的快速产品底座
• 作为内部脚手架工具分发给其他同事
• 作为规范示例，统一结构、命名、交付和检查方式

📐 默认基线

• 语言：Swift 6.3
• 工具：Xcode 26
• 平台：iOS 26+、macOS 26+
• 架构：SPM 模块化
• 策略：iPhone / iPad 共用移动壳层，macOS 独立壳层

✅ 当前状态

现在这套仓库已经具备：

• 模板本体
• CLI 工具
• 安装脚本
• 发布包构建脚本
• 发布前检查脚本
• 交付材料脚本
• 文档和规范

如果你下一步想继续往前推，最自然的方向就是开始做“模板案例”，比如 SaaS、内容产品或 AI 工具产品的成品示例。