跳转到主要内容

​
发布清单（GitHub release + 可选 macOS appcast）

从仓库根目录使用 pnpm（Node 22+）。在打标签/发布前保持工作树干净。

​
操作员触发

当操作员说”release”时，立即执行此预检（除非遇到阻碍否则不要额外提问）：
  • 阅读本文档和 docs/platforms/mac/release.md。
  • 从 ~/.profile 加载环境变量并确认 SPARKLE_PRIVATE_KEY_FILE + App Store Connect 变量已设置（SPARKLE_PRIVATE_KEY_FILE 应位于 ~/.profile 中）。
  • 如需要，使用 ~/Library/CloudStorage/Dropbox/Backup/Sparkle 中的 Sparkle 密钥。
  1. 版本和元数据
  • 更新 package.json 版本（例如 2026.1.29）。
  • 运行 pnpm plugins:sync 以对齐扩展包版本和变更日志。
  • 更新 CLI/版本字符串：src/cli/program.ts 和 src/provider-web.ts 中的 Baileys user agent。
  • 确认包元数据（name、description、repository、keywords、license）以及 bin 映射指向 fased.mjs 作为 fased。
  • 如果依赖项有变化，运行 pnpm install 确保 pnpm-lock.yaml 是最新的。
  1. 构建和产物
  • 如果 A2UI 输入有变化，运行 pnpm canvas:a2ui:bundle 并提交更新后的 src/canvas-host/a2ui/a2ui.bundle.js。
  • pnpm run build（重新生成 dist/）。
  • 验证 npm 包的 files 包含所有必需的 dist/* 文件夹（特别是用于 headless node + ACP CLI 的 dist/node-host/** 和 dist/acp/**）。
  • 确认 dist/build-info.json 存在并包含预期的 commit 哈希（CLI 横幅在 npm 安装时使用此信息）。
  • 可选：构建后运行 npm pack --pack-destination /tmp；检查 tarball 内容并保留以备 GitHub 发布使用（不要提交它）。
  1. 变更日志和文档
  • 更新 CHANGELOG.md，添加面向用户的亮点（如果文件不存在则创建）；按版本严格降序排列条目。
  • 确保 README 示例/标志与当前 CLI 行为匹配（特别是新命令或选项）。
  1. 验证
  • pnpm build
  • pnpm check
  • pnpm test（如需覆盖率输出则使用 pnpm test:coverage）
  • pnpm release:check（验证 npm pack 内容）
  • FASED_INSTALL_SMOKE_SKIP_NONROOT=1 pnpm test:install:smoke（Docker 安装冒烟测试，快速路径；发布前必需）
    • 如果已知上一个 npm 发布版本有问题，为预安装步骤设置 FASED_INSTALL_SMOKE_PREVIOUS=<last-good-version> 或 FASED_INSTALL_SMOKE_SKIP_PREVIOUS=1。
  • [ ]（可选）完整安装程序冒烟测试（添加非 root + CLI 覆盖）：pnpm test:install:smoke
  • [ ]（可选）安装程序 E2E（Docker，克隆仓库并运行 ./install.sh，完成新手引导，然后运行真实工具调用）：
    • pnpm test:install:e2e:openai（需要 OPENAI_API_KEY）
    • pnpm test:install:e2e:anthropic（需要 ANTHROPIC_API_KEY）
    • pnpm test:install:e2e（需要两个密钥；运行两个提供商）
  • [ ]（可选）如果你的更改影响发送/接收路径，抽查 Web Gateway 网关。
  1. macOS 应用（Sparkle）
  • 构建并签名 macOS 应用，然后压缩以供分发。
  • 生成 Sparkle appcast（通过 scripts/make_appcast.sh 生成 HTML 注释）并更新 appcast.xml。
  • 保留应用 zip（和可选的 dSYM zip）以便附加到 GitHub 发布。
  • 按照 macOS 发布 获取确切命令和所需环境变量。
    • APP_BUILD 必须是数字且单调递增（不带 -beta），以便 Sparkle 正确比较版本。
    • 如果进行公证，使用从 App Store Connect API 环境变量创建的 fased-notary 钥匙串配置文件（参见 macOS 发布）。
  1. GitHub 发布
  • 为 vX.Y.Z 创建 GitHub release
  • 只附加真实产物
  • 将整理过的发布说明粘贴进 release 正文
  • 不要宣称当前并不存在或尚不可支持的包管理器安装路径
  1. 公开仓库后的加固
  • 仓库公开后，或组织套餐支持私有仓库保护后，启用 main 分支保护
  • 禁止 force push 和删除分支
  • 等公开仓库 CI 稳定后再添加必需状态检查
  • 只允许负责发布的维护者保留紧急管理员绕过权限
  1. 可选：macOS app + appcast
如果你要发布已签名的 macOS 桌面构建：
  • 构建并签名 app bundle
  • 打包 zip 供分发
  • 生成 appcast.xml
  • 确认 feed URL 指向真实的原始仓库路径：
    • https://raw.githubusercontent.com/fased-ai/fased/main/appcast.xml
  • 发布 appcast 指向的 release 产物
参见 macOS 发布 获取确切命令。

​
不会自动发生的事情

这些都是维护者要单独执行的动作：
  • 更新 package.json 不会自动创建 GitHub release
  • 合并 PR 不会自动改写 CHANGELOG.md
  • 打 tag 本身不会生成 appcast 产物
  • appcast 只对 macOS Sparkle 更新路径有意义

​
相关文件

发布说明还必须标注默认未启用的新可选内置插件（例如：tlon）。