构建与发布

开发模式

pnpm install
pnpm tauri dev         # Vite + Tauri 热重载
pnpm dev               # 仅 Vite 前端

生产构建

当前平台

pnpm tauri build

跨平台

pnpm tauri build --target x86_64-pc-windows-msvc   # Windows
pnpm tauri build --target aarch64-apple-darwin     # macOS Apple Silicon
pnpm tauri build --target x86_64-apple-darwin      # macOS Intel
pnpm tauri build --target x86_64-unknown-linux-gnu # Linux

CI/CD

GitHub Actions 工作流位于 .github/workflows/：

文件	用途
main.yml	主 CI（type-check + lint + test + verify:all）
release.yml	多平台构建与发布
deploy-docs.yml	文档站部署

Release 流程

1. 更新 package.json 版本号
2. 更新 src-tauri/Cargo.toml 版本号
3. 更新 docs/CHANGELOG.md
4. 推送 tag（仅从 main 分支）：

   git tag v2.1.0   # 仅从 main
   git push origin v2.1.0

5. CI 自动构建三平台安装包
6. 草稿 Release 由 maintainer 发布

签名

平台	状态
macOS	未签名（个人证书年费 $99）
Windows	未签名（企业证书年费 $400+）
Linux	不需要

后续版本接入签名，详见 Issues · enhancement。

Bundle 检查

CI 用 tauri-action 自动构建，所有产物上传到 Release：

• StoryFab_*_x64-setup.exe
• StoryFab_*_aarch64.dmg / StoryFab_*_x64.dmg
• StoryFab_*_amd64.AppImage / StoryFab_*_amd64.deb

验证

pnpm test             # 单元测试
pnpm test:coverage    # 覆盖率
pnpm build            # 前端构建
pnpm build:ci         # 前端构建 + bundle 预算

文档站

pnpm docs:dev         # 本地开发
pnpm docs:build       # 构建静态站
pnpm docs:preview     # 预览

自动部署到 https://agions.github.io/story-fab/。