公开发布仓

这份说明解释的是：VILab 的源码继续保留在私有仓库，但对外发布统一收口到一个公开仓库。

公开仓库负责什么

• GitHub Releases：安装包、校验文件、签名文件、latest.json
• GitHub Pages：官网静态页
• 版本更新日志：由 .github/releases/*.md 自动生成
• 公共文档：固定挂在 /docs/

也就是说，开发过程继续在私有仓里，公开用户只接触公开站点和公开 release。

推荐的公开仓结构

• 仓库名：VILab-public
• 默认分支：main
• GitHub Pages：从 main 分支根目录发布
• 自定义域名：app.<你的域名>

私有仓里必须配置的 secrets

• PUBLIC_RELEASE_REPO：公开仓 slug，例如 Ro-In-AI/VILab-public
• PUBLIC_RELEASE_PAT：对公开仓有写权限的 token
• PUBLIC_SITE_DOMAIN：公开站点域名，例如 app.example.com

现在这些 workflow 会做什么

• Sync Public Site
  • 构建 docs
  • 生成官网首页、下载页、changelog 页面
  • 把静态产物同步到公开仓
• Windows Release
  • 构建 Windows 安装包
  • 生成 latest.json
  • 把 release assets 和版本说明上传到公开仓
• macOS Release
  • 构建并校验 macOS dmg
  • 把 release assets 和版本说明上传到公开仓

第一次接通时的检查清单

1. 新建公开仓库。
2. 在 main 分支放一个初始提交。
3. 在公开仓设置里把 GitHub Pages 指向 main 分支根目录。
4. 在 Pages 设置里绑定你的自定义域名。
5. 在 DNS 提供商处把这个子域名指向 GitHub Pages。
6. 在私有源码仓里配置上面那三个 secrets。
7. 手动运行一次 Sync Public Site，把公开站点内容先推上去。
8. 再打一版 tag，检查 release assets 是否真的发布到公开仓。

本地可用命令

• 构建公开站点产物：npm run public:site:build
• 把站点同步到公开仓：npm run public:repo:sync
• 发布 Windows 版本：npm run release:windows
• 发布 macOS 版本：npm run release:mac

额外说明

• 桌面应用发布构建时，最好设置 VITE_PUBLIC_SITE_URL，这样应用里的文档入口会直接打开公开站点的 /docs/。
• Tauri updater 现在已经指向公开发布仓。
• 现有 .github/releases/*.md 仍然是版本说明的单一来源，不需要改写你现在的 release notes 习惯。