用途:在用户仓库中把发布工具从 @changesets/cli 迁移到 Tegami,适用于存在 .changeset/ 目录且 devDependencies 含 @changesets/cli 的项目,npm、Cargo 和混合 monorepo 均可,示例假设 pnpm 工作区。
主要步骤与能力:先调研现有配置(config.json 的 access、baseBranch、ignore、fixed、linked、privatePackages,待转换 changeset、发布工作流、自定义脚本)。用 pnpm add -D -w tegami 安装(需 Node.js 24+);Tegami 用 Node 脚本配置,复制模板为 scripts/tegami.mts 并加 npm script;将 config.json 选项映射为 tegami() 选项(access 对应 publishConfig.access 等);把未发布 changeset 改写为 .tegami/*.md;如需统一版本可用 group 的 syncBump;替换 CI 为 release.yml(tegami ci),可选 PR 预览;用 pnpm tegami version、publish --dry-run 验证并回滚,再移除 Changesets。
限制与注意:Tegami 无全局 version --dry-run,需手动备份并还原;syncBump 只对齐 bump 幅度、不等于 Changesets linked;仅成员版本已一致时才可靠;私有包默认会被 version,需加 ignore;OIDC 受信发布绑定工作流文件名,改名需同步更新 npmjs.com;release tag 格式为 <pkg-name>@<version>;需卸载 changeset-bot GitHub App 以停止 PR 评论;Bun 可运行,需设 npm: { client: 'bun' }。