chore: 初始化仓库

This commit is contained in:
Lydanne
2026-02-15 22:02:21 +08:00
commit 08d011d63f
381 changed files with 87202 additions and 0 deletions

View File

@@ -0,0 +1,503 @@
# Changelog
## [0.21.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.20.0...@spaceflow/publish@0.21.0) (2026-02-15)
### 新特性
* **cli:** 新增 MCP Server 命令并集成 review 扩展的 MCP 工具 ([b794b36](https://git.bjxgj.com/xgj/spaceflow/commit/b794b36d90788c7eb4cbb253397413b4a080ae83))
* **cli:** 新增 MCP Server 导出类型支持 ([9568cbd](https://git.bjxgj.com/xgj/spaceflow/commit/9568cbd14d4cfbdedaf2218379c72337af6db271))
* **core:** 为所有命令添加 i18n 国际化支持 ([867c5d3](https://git.bjxgj.com/xgj/spaceflow/commit/867c5d3eccc285c8a68803b8aa2f0ffb86a94285))
* **core:** 新增 GitLab 平台适配器并完善配置支持 ([47be9ad](https://git.bjxgj.com/xgj/spaceflow/commit/47be9adfa90944a9cb183e03286a7a96fec747f1))
* **core:** 新增 Logger 全局日志工具并支持 plain/tui 双模式渲染 ([8baae7c](https://git.bjxgj.com/xgj/spaceflow/commit/8baae7c24139695a0e379e1c874023cd61dfc41b))
* **docs:** 新增 VitePress 文档站点并完善项目文档 ([a79d620](https://git.bjxgj.com/xgj/spaceflow/commit/a79d6208e60390a44fa4c94621eb41ae20159e98))
* **mcp:** 新增 MCP Inspector 交互式调试支持并优化工具日志输出 ([05fd2ee](https://git.bjxgj.com/xgj/spaceflow/commit/05fd2ee941c5f6088b769d1127cb7c0615626f8c))
* **review:** 为 MCP 服务添加 i18n 国际化支持 ([a749054](https://git.bjxgj.com/xgj/spaceflow/commit/a749054eb73b775a5f5973ab1b86c04f2b2ddfba))
* **review:** 新增规则级 includes 解析测试并修复文件级/规则级 includes 过滤逻辑 ([4baca71](https://git.bjxgj.com/xgj/spaceflow/commit/4baca71c17782fb92a95b3207f9c61e0b410b9ff))
### 修复BUG
* **actions:** 修正 pnpm setup 命令调用方式 ([8f014fa](https://git.bjxgj.com/xgj/spaceflow/commit/8f014fa90b74e20de4c353804d271b3ef6f1288f))
* **mcp:** 添加 -y 选项确保 Inspector 自动安装依赖 ([a9201f7](https://git.bjxgj.com/xgj/spaceflow/commit/a9201f74bd9ddc5eba92beaaa676f377842863e0))
### 代码重构
* **claude:** 移除 .claude 目录及其 .gitignore 配置文件 ([91916a9](https://git.bjxgj.com/xgj/spaceflow/commit/91916a99f65da31c1d34e6f75b5cbea1d331ba35))
* **cli:** 优化依赖安装流程并支持 .spaceflow 目录配置 ([5977631](https://git.bjxgj.com/xgj/spaceflow/commit/597763183eaa61bb024bba2703d75239650b54fb))
* **cli:** 拆分 CLI 为独立包并重构扩展加载机制 ([b385d28](https://git.bjxgj.com/xgj/spaceflow/commit/b385d281575f29b823bb6dc4229a396a29c0e226))
* **cli:** 移除 ExtensionModule 并优化扩展加载机制 ([8f7077d](https://git.bjxgj.com/xgj/spaceflow/commit/8f7077deaef4e5f4032662ff5ac925cd3c07fdb6))
* **cli:** 调整依赖顺序并格式化导入语句 ([32a9c1c](https://git.bjxgj.com/xgj/spaceflow/commit/32a9c1cf834725a20f93b1f8f60b52692841a3e5))
* **cli:** 重构 getPluginConfigFromPackageJson 方法以提高代码可读性 ([f5f6ed9](https://git.bjxgj.com/xgj/spaceflow/commit/f5f6ed9858cc4ca670e30fac469774bdc8f7b005))
* **cli:** 重构扩展配置格式,支持 flow/command/skill 三种导出类型 ([958dc13](https://git.bjxgj.com/xgj/spaceflow/commit/958dc130621f78bbcc260224da16a5f16ae0b2b1))
* **core:** 为 build/clear/commit 命令添加国际化支持 ([de82cb2](https://git.bjxgj.com/xgj/spaceflow/commit/de82cb2f1ed8cef0e446a2d42a1bf1f091e9c421))
* **core:** 优化 list 命令输出格式并修复 MCP Inspector 包管理器兼容性 ([a019829](https://git.bjxgj.com/xgj/spaceflow/commit/a019829d3055c083aeb86ed60ce6629d13012d91))
* **core:** 将 rspack 配置和工具函数中的 @spaceflow/cli 引用改为 @spaceflow/core ([3c301c6](https://git.bjxgj.com/xgj/spaceflow/commit/3c301c60f3e61b127db94481f5a19307f5ef00eb))
* **core:** 将扩展依赖从 @spaceflow/cli 迁移到 @spaceflow/core ([6f9ffd4](https://git.bjxgj.com/xgj/spaceflow/commit/6f9ffd4061cecae4faaf3d051e3ca98a0b42b01f))
* **core:** 提取 source 处理和包管理器工具函数到共享模块 ([ab3ff00](https://git.bjxgj.com/xgj/spaceflow/commit/ab3ff003d1cd586c0c4efc7841e6a93fe3477ace))
* **core:** 新增 getEnvFilePaths 工具函数统一管理 .env 文件路径优先级 ([809fa18](https://git.bjxgj.com/xgj/spaceflow/commit/809fa18f3d0b8eabcb068988bab53d548eaf03ea))
* **core:** 新增远程仓库规则拉取功能并支持 Git API 获取目录内容 ([69ade16](https://git.bjxgj.com/xgj/spaceflow/commit/69ade16c9069f9e1a90b3ef56dc834e33a3c0650))
* **core:** 统一 LogLevel 类型定义并支持字符串/数字双模式 ([557f6b0](https://git.bjxgj.com/xgj/spaceflow/commit/557f6b0bc39fcfb0e3f773836cbbf08c1a8790ae))
* **core:** 重构配置读取逻辑,新增 ConfigReaderService 并支持 .spaceflowrc 配置文件 ([72e88ce](https://git.bjxgj.com/xgj/spaceflow/commit/72e88ced63d03395923cdfb113addf4945162e54))
* **i18n:** 将 locales 导入从命令文件迁移至扩展入口文件 ([0da5d98](https://git.bjxgj.com/xgj/spaceflow/commit/0da5d9886296c4183b24ad8c56140763f5a870a4))
* **i18n:** 移除扩展元数据中的 locales 字段并改用 side-effect 自动注册 ([2c7d488](https://git.bjxgj.com/xgj/spaceflow/commit/2c7d488a9dfa59a99b95e40e3c449c28c2d433d8))
* **mcp:** 使用 DTO + Swagger 装饰器替代手动 JSON Schema 定义 ([87ec262](https://git.bjxgj.com/xgj/spaceflow/commit/87ec26252dd295536bb090ae8b7e418eec96e1bd))
* **mcp:** 升级 MCP SDK API 并优化 Inspector 调试配置 ([176d04a](https://git.bjxgj.com/xgj/spaceflow/commit/176d04a73fbbb8d115520d922f5fedb9a2961aa6))
* **mcp:** 将 MCP 元数据存储从 Reflect Metadata 改为静态属性以支持跨模块访问 ([cac0ea2](https://git.bjxgj.com/xgj/spaceflow/commit/cac0ea2029e1b504bc4278ce72b3aa87fff88c84))
* **test:** 迁移测试框架从 Jest 到 Vitest ([308f9d4](https://git.bjxgj.com/xgj/spaceflow/commit/308f9d49089019530588344a5e8880f5b6504a6a))
* 优化构建流程并调整 MCP/review 日志输出级别 ([74072c0](https://git.bjxgj.com/xgj/spaceflow/commit/74072c04be7a45bfc0ab53b636248fe5c0e1e42a))
* 将 .spaceflow/package.json 纳入版本控制并自动添加到根项目依赖 ([ab83d25](https://git.bjxgj.com/xgj/spaceflow/commit/ab83d2579cb5414ee3d78a9768fac2147a3d1ad9))
* 将 GiteaSdkModule/GiteaSdkService 重命名为 GitProviderModule/GitProviderService ([462f492](https://git.bjxgj.com/xgj/spaceflow/commit/462f492bc2607cf508c5011d181c599cf17e00c9))
* 恢复 pnpm catalog 配置并移除 .spaceflow 工作区导入器 ([217387e](https://git.bjxgj.com/xgj/spaceflow/commit/217387e2e8517a08162e9bcaf604893fd9bca736))
* 迁移扩展依赖到 .spaceflow 工作区并移除 pnpm catalog ([c457c0f](https://git.bjxgj.com/xgj/spaceflow/commit/c457c0f8918171f1856b88bc007921d76c508335))
* 重构 Extension 安装机制为 pnpm workspace 模式 ([469b12e](https://git.bjxgj.com/xgj/spaceflow/commit/469b12eac28f747b628e52a5125a3d5a538fba39))
* 重构插件加载改为扩展模式 ([0e6e140](https://git.bjxgj.com/xgj/spaceflow/commit/0e6e140b19ea2cf6084afc261c555d2083fe04f9))
### 文档更新
* **guide:** 更新编辑器集成文档,补充四种导出类型说明和 MCP 注册机制 ([19a7409](https://git.bjxgj.com/xgj/spaceflow/commit/19a7409092c89d002f11ee51ebcb6863118429bd))
* **guide:** 更新配置文件位置说明并补充 RC 文件支持 ([2214dc4](https://git.bjxgj.com/xgj/spaceflow/commit/2214dc4e197221971f5286b38ceaa6fcbcaa7884))
### 测试用例
* **core:** 新增 GiteaAdapter 完整单元测试并实现自动检测 provider 配置 ([c74f745](https://git.bjxgj.com/xgj/spaceflow/commit/c74f7458aed91ac7d12fb57ef1c24b3d2917c406))
* **review:** 新增 DeletionImpactService 测试覆盖并配置 coverage 工具 ([50bfbfe](https://git.bjxgj.com/xgj/spaceflow/commit/50bfbfe37192641f1170ade8f5eb00e0e382af67))
### 其他修改
* **ci-scripts:** released version 0.19.0 [no ci] ([9f747c6](https://git.bjxgj.com/xgj/spaceflow/commit/9f747c617b387e105e92b4a5dcd0f5d3cf51c26d))
* **ci-shell:** released version 0.19.0 [no ci] ([59ac30d](https://git.bjxgj.com/xgj/spaceflow/commit/59ac30da6802a9493c33e560ea9121d378597e89))
* **ci:** 迁移工作流从 Gitea 到 GitHub 并统一环境变量命名 ([57e3bae](https://git.bjxgj.com/xgj/spaceflow/commit/57e3bae635b324c8c4ea50a9fb667b6241fae0ef))
* **cli:** released version 0.19.0 [no ci] ([6b63149](https://git.bjxgj.com/xgj/spaceflow/commit/6b631499e2407a1822395d5f40cec2d725331b78))
* **config:** 将 git 推送白名单用户从 "Gitea Actions" 改为 "GiteaActions" ([fdbb865](https://git.bjxgj.com/xgj/spaceflow/commit/fdbb865341e6f02b26fca32b54a33b51bee11cad))
* **config:** 将 git 推送白名单用户从 github-actions[bot] 改为 Gitea Actions ([9c39819](https://git.bjxgj.com/xgj/spaceflow/commit/9c39819a9f95f415068f7f0333770b92bc98321b))
* **config:** 移除 review-spec 私有仓库依赖 ([8ae18f1](https://git.bjxgj.com/xgj/spaceflow/commit/8ae18f13c441b033d1cbc75119695a5cc5cb6a0b))
* **core:** released version 0.1.0 [no ci] ([170fa67](https://git.bjxgj.com/xgj/spaceflow/commit/170fa670e98473c2377120656d23aae835c51997))
* **core:** 禁用 i18next 初始化时的 locize.com 推广日志 ([a99fbb0](https://git.bjxgj.com/xgj/spaceflow/commit/a99fbb068441bc623efcf15a1dd7b6bd38c05f38))
* **deps:** 移除 pnpm catalog 配置并更新依赖锁定 ([753fb9e](https://git.bjxgj.com/xgj/spaceflow/commit/753fb9e3e43b28054c75158193dc39ab4bab1af5))
* **docs:** 统一文档脚本命名,为 VitePress 命令添加 docs: 前缀 ([3cc46ea](https://git.bjxgj.com/xgj/spaceflow/commit/3cc46eab3a600290f5064b8270902e586b9c5af4))
* **i18n:** 配置 i18n-ally-next 自动提取键名生成策略 ([753c3dc](https://git.bjxgj.com/xgj/spaceflow/commit/753c3dc3f24f3c03c837d1ec2c505e8e3ce08b11))
* **i18n:** 重构 i18n 配置并统一 locales 目录结构 ([3e94037](https://git.bjxgj.com/xgj/spaceflow/commit/3e94037fa6493b3b0e4a12ff6af9f4bea48ae217))
* **period-summary:** released version 0.19.0 [no ci] ([b833948](https://git.bjxgj.com/xgj/spaceflow/commit/b83394888ac47ae8d91bfd9317980f56bd322b34))
* **review:** released version 0.28.0 [no ci] ([a2d89ed](https://git.bjxgj.com/xgj/spaceflow/commit/a2d89ed5f386eb6dd299c0d0a208856ce267ab5e))
* **scripts:** 修正 setup 和 build 脚本的过滤条件,避免重复构建 cli 包 ([ffd2ffe](https://git.bjxgj.com/xgj/spaceflow/commit/ffd2ffedca08fd56cccb6a9fbd2b6bd106e367b6))
* **templates:** 新增 MCP 工具插件模板 ([5f6df60](https://git.bjxgj.com/xgj/spaceflow/commit/5f6df60b60553f025414fd102d8a279cde097485))
* **workflows:** 为所有 GitHub Actions 工作流添加 GIT_PROVIDER_TYPE 环境变量 ([a463574](https://git.bjxgj.com/xgj/spaceflow/commit/a463574de6755a0848a8d06267f029cb947132b0))
* **workflows:** 在发布流程中添加 GIT_PROVIDER_TYPE 环境变量 ([a4bb388](https://git.bjxgj.com/xgj/spaceflow/commit/a4bb3881f39ad351e06c5502df6895805b169a28))
* **workflows:** 在发布流程中添加扩展安装步骤 ([716be4d](https://git.bjxgj.com/xgj/spaceflow/commit/716be4d92641ccadb3eaf01af8a51189ec5e9ade))
* **workflows:** 将发布流程的 Git 和 NPM 配置从 GitHub 迁移到 Gitea ([6d9acff](https://git.bjxgj.com/xgj/spaceflow/commit/6d9acff06c9a202432eb3d3d5552e6ac972712f5))
* **workflows:** 将发布流程的 GITHUB_TOKEN 改为使用 CI_GITEA_TOKEN ([e7fe7b4](https://git.bjxgj.com/xgj/spaceflow/commit/e7fe7b4271802fcdbfc2553b180f710eed419335))
* 为所有 commands 包添加 @spaceflow/cli 开发依赖 ([d4e6c83](https://git.bjxgj.com/xgj/spaceflow/commit/d4e6c8344ca736f7e55d7db698482e8fa2445684))
* 优化依赖配置并移除 .spaceflow 包依赖 ([be5264e](https://git.bjxgj.com/xgj/spaceflow/commit/be5264e5e0fe1f53bbe3b44a9cb86dd94ab9d266))
* 修正 postinstall 脚本命令格式 ([3f0820f](https://git.bjxgj.com/xgj/spaceflow/commit/3f0820f85dee88808de921c3befe2d332f34cc36))
* 恢复 pnpm catalog 配置并更新依赖锁定 ([0b2295c](https://git.bjxgj.com/xgj/spaceflow/commit/0b2295c1f906d89ad3ba7a61b04c6e6b94f193ef))
* 新增 .spaceflow/pnpm-workspace.yaml 防止被父级 workspace 接管并移除根项目 devDependencies 自动添加逻辑 ([61de3a2](https://git.bjxgj.com/xgj/spaceflow/commit/61de3a2b75e8a19b28563d2a6476158d19f6c5be))
* 新增 postinstall 钩子自动执行 setup 脚本 ([64dae0c](https://git.bjxgj.com/xgj/spaceflow/commit/64dae0cb440bd5e777cb790f826ff2d9f8fe65ba))
* 移除 postinstall 钩子避免依赖安装时自动执行构建 ([ea1dc85](https://git.bjxgj.com/xgj/spaceflow/commit/ea1dc85ce7d6cf23a98c13e2c21e3c3bcdf7dd79))
## [0.20.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.19.0...@spaceflow/publish@0.20.0) (2026-02-04)
### 代码重构
* **verbose:** 扩展 verbose 级别支持至 3 ([c1a0808](https://git.bjxgj.com/xgj/spaceflow/commit/c1a080859e5d25ca1eb3dc7e00a67b32eb172635))
### 其他修改
* **ci-scripts:** released version 0.18.0 [no ci] ([e17894a](https://git.bjxgj.com/xgj/spaceflow/commit/e17894a5af53ff040a0a17bc602d232f78415e1b))
* **ci-shell:** released version 0.18.0 [no ci] ([f64fd80](https://git.bjxgj.com/xgj/spaceflow/commit/f64fd8009a6dd725f572c7e9fbf084d9320d5128))
* **core:** released version 0.18.0 [no ci] ([c5e973f](https://git.bjxgj.com/xgj/spaceflow/commit/c5e973fbe22c0fcd0d6d3af6e4020e2fbff9d31f))
* **period-summary:** released version 0.18.0 [no ci] ([f0df638](https://git.bjxgj.com/xgj/spaceflow/commit/f0df63804d06f8c75e04169ec98226d7a4f5d7f9))
* **review:** released version 0.27.0 [no ci] ([ac3fc5a](https://git.bjxgj.com/xgj/spaceflow/commit/ac3fc5a5d7317d537d0447e05a61bef15a1accbe))
## [0.19.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.18.0...@spaceflow/publish@0.19.0) (2026-02-04)
### 新特性
- **review:** 新增 override 作用域测试,验证 includes 对 override 过滤的影响 ([820e0cb](https://git.bjxgj.com/xgj/spaceflow/commit/820e0cb0f36783dc1c7e1683ad08501e91f094b2))
### 修复BUG
- **core:** 从 PR diff 填充缺失的 patch 字段 ([24bfaa7](https://git.bjxgj.com/xgj/spaceflow/commit/24bfaa76f3bd56c8ead307e73e0623a2221c69cf))
- **review:** 新增 getFileContents、getChangedFilesBetweenRefs 和 filterIssuesByValidCommits 方法的单元测试 ([7618c91](https://git.bjxgj.com/xgj/spaceflow/commit/7618c91bc075d218b9f51b862e5161d15a306bf8))
### 代码重构
- **config:** 降低并发数以优化 AI 审查性能 ([052dd72](https://git.bjxgj.com/xgj/spaceflow/commit/052dd728f759da0a31e86a0ad480e9bb35052781))
- **review:** 优化 Markdown 格式化器的代码风格和 JSON 数据输出逻辑 ([ca1b0c9](https://git.bjxgj.com/xgj/spaceflow/commit/ca1b0c96d9d0663a8b8dc93b4a9f63d4e5590df0))
- **review:** 优化 override 和变更行过滤的日志输出,增强调试信息的可读性 ([9a7c6f5](https://git.bjxgj.com/xgj/spaceflow/commit/9a7c6f5b4ef2b8ae733fa499a0e5ec82feebc1d2))
- **review:** 使用 Base64 编码存储审查数据,避免 JSON 格式在 Markdown 中被转义 ([fb91e30](https://git.bjxgj.com/xgj/spaceflow/commit/fb91e30d0979cfe63ed8e7657c578db618b5e783))
- **review:** 基于 fileContents 实际 commit hash 验证问题归属,替代依赖 LLM 填写的 commit 字段 ([de3e377](https://git.bjxgj.com/xgj/spaceflow/commit/de3e3771eb85ff93200c63fa9feb38941914a07d))
- **review:** 新增测试方法用于验证 PR 审查功能 ([5c57833](https://git.bjxgj.com/xgj/spaceflow/commit/5c578332cedffb7fa7e5ad753a788bcd55595c68))
- **review:** 移除 filterNoCommit 配置项,统一使用基于 commit hash 的问题过滤逻辑 ([82429b1](https://git.bjxgj.com/xgj/spaceflow/commit/82429b1072affb4f2b14d52f99887e12184d8218))
- **review:** 移除测试方法 testMethod ([21e9938](https://git.bjxgj.com/xgj/spaceflow/commit/21e9938100c5dd7d4eada022441c565b5c41a55a))
- **review:** 统一使用 parseLineRange 方法解析行号,避免重复的正则匹配逻辑 ([c64f96a](https://git.bjxgj.com/xgj/spaceflow/commit/c64f96aa2e1a8e22dcd3e31e1a2acc1bb338a1a8))
- **review:** 调整 filterIssuesByValidCommits 逻辑,保留无 commit 的 issue 交由 filterNoCommit 配置处理 ([e9c5d47](https://git.bjxgj.com/xgj/spaceflow/commit/e9c5d47aebef42507fd9fcd67e5eab624437e81a))
- **review:** 过滤 merge commits,避免在代码审查中处理合并提交 ([d7c647c](https://git.bjxgj.com/xgj/spaceflow/commit/d7c647c33156a58b42bfb45a67417723b75328c6))
- **review:** 过滤非 PR commits 的问题,避免 merge commit 引入的代码被审查 ([9e20f54](https://git.bjxgj.com/xgj/spaceflow/commit/9e20f54d57e71725432dfb9e7c943946aa6677d4))
### 测试用例
- **review:** 新增新增文件无 patch 时的测试用例,优化变更行标记逻辑 ([a593f0d](https://git.bjxgj.com/xgj/spaceflow/commit/a593f0d4a641b348f7c9d30b14f639b24c12dcfa))
### 其他修改
- **ci-scripts:** released version 0.17.0 [no ci] ([31abd3d](https://git.bjxgj.com/xgj/spaceflow/commit/31abd3dcb48e2ddea5175552c0a87c1eaa1e7a41))
- **ci-shell:** released version 0.17.0 [no ci] ([a53508b](https://git.bjxgj.com/xgj/spaceflow/commit/a53508b15e4020e3399bae9cc04e730f1539ad8e))
- **core:** released version 0.17.0 [no ci] ([c85a8ed](https://git.bjxgj.com/xgj/spaceflow/commit/c85a8ed88929d867d2d460a44d08d8b7bc4866a2))
- **period-summary:** released version 0.17.0 [no ci] ([ac4e5b6](https://git.bjxgj.com/xgj/spaceflow/commit/ac4e5b6083773146ac840548a69006f6c4fbac1d))
- **review:** released version 0.20.0 [no ci] ([8b0f82f](https://git.bjxgj.com/xgj/spaceflow/commit/8b0f82f94813c79d579dbae8decb471b20e45e9d))
- **review:** released version 0.21.0 [no ci] ([b51a1dd](https://git.bjxgj.com/xgj/spaceflow/commit/b51a1ddcba3e6a4b3b3eb947864e731d8f87d62b))
- **review:** released version 0.22.0 [no ci] ([fca3bfc](https://git.bjxgj.com/xgj/spaceflow/commit/fca3bfc0c53253ac78566e88c7e5d31020a3896b))
- **review:** released version 0.23.0 [no ci] ([ed5bf22](https://git.bjxgj.com/xgj/spaceflow/commit/ed5bf22819094df070708c2724669d0b5f7b9008))
- **review:** released version 0.24.0 [no ci] ([5f1f94e](https://git.bjxgj.com/xgj/spaceflow/commit/5f1f94ee02123baa05802fb2bb038ccf9d50a0cc))
- **review:** released version 0.25.0 [no ci] ([69cfeaf](https://git.bjxgj.com/xgj/spaceflow/commit/69cfeaf768e4bf7b2aaba6f089064469338a1ac0))
- **review:** released version 0.26.0 [no ci] ([dec9c7e](https://git.bjxgj.com/xgj/spaceflow/commit/dec9c7ec66455cf83588368c930d12510ada6c0f))
## [0.18.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.17.0...@spaceflow/publish@0.18.0) (2026-02-02)
### 新特性
- **core:** 新增 Git diff 行号映射工具并优化 Claude 配置 ([88ef340](https://git.bjxgj.com/xgj/spaceflow/commit/88ef3400127fac3ad52fc326ad79fdc7bd058e98))
- **review:** 为 execute 方法添加文档注释 ([a21f582](https://git.bjxgj.com/xgj/spaceflow/commit/a21f58290c873fb07789e70c8c5ded2b5874a29d))
- **review:** 为 getPrNumberFromEvent 方法添加文档注释 ([54d1586](https://git.bjxgj.com/xgj/spaceflow/commit/54d1586f4558b5bfde81b926c7b513a32e5caf89))
- **review:** 优化行号更新统计,分别统计更新和标记无效的问题数量 ([892b8be](https://git.bjxgj.com/xgj/spaceflow/commit/892b8bed8913531a9440579f777b1965fec772e5))
### 代码重构
- **review:** 优化历史 issue commit 匹配逻辑,支持短 SHA 与完整 SHA 的前缀匹配 ([e30c6dd](https://git.bjxgj.com/xgj/spaceflow/commit/e30c6ddefb14ec6631ce341f1d45c59786e94a46))
- **review:** 简化历史问题处理策略,将行号更新改为标记变更文件问题为无效 ([5df7f00](https://git.bjxgj.com/xgj/spaceflow/commit/5df7f0087c493e104fe0dc054fd0b6c19ebe3500))
- **review:** 简化行号更新逻辑,使用最新 commit diff 替代增量 diff ([6de7529](https://git.bjxgj.com/xgj/spaceflow/commit/6de7529c90ecbcee82149233fc01c393c5c4e7f7))
- **review:** 重构行号更新逻辑,使用增量 diff 替代全量 diff ([d4f4304](https://git.bjxgj.com/xgj/spaceflow/commit/d4f4304e1e41614f7be8946d457eea1cf4e202fb))
### 测试用例
- **review:** 添加单元测试以覆盖行号更新逻辑 ([ebf33e4](https://git.bjxgj.com/xgj/spaceflow/commit/ebf33e45c18c910b88b106cdd4cfeb516b3fb656))
### 其他修改
- **actions:** 增强命令执行日志,输出原始 command 和 args 参数 ([0f0c238](https://git.bjxgj.com/xgj/spaceflow/commit/0f0c238de7d6f10875022f364746cefa56631b7f))
- **ci-scripts:** released version 0.16.0 [no ci] ([9ab007d](https://git.bjxgj.com/xgj/spaceflow/commit/9ab007db178878e093ba93ea27c4f05ca813a65d))
- **ci-shell:** released version 0.16.0 [no ci] ([87fd703](https://git.bjxgj.com/xgj/spaceflow/commit/87fd7030b54d2f614f23e092499c5c51bfc33788))
- **core:** released version 0.16.0 [no ci] ([871f981](https://git.bjxgj.com/xgj/spaceflow/commit/871f981b0b908c981aaef366f2382ec6ca2e2269))
- **period-summary:** released version 0.16.0 [no ci] ([b214e31](https://git.bjxgj.com/xgj/spaceflow/commit/b214e31221d5afa04481c48d9ddb878644a22ae7))
- **review:** released version 0.19.0 [no ci] ([0ba5c0a](https://git.bjxgj.com/xgj/spaceflow/commit/0ba5c0a39879b598da2d774acc0834c590ef6d4c))
- 在 PR 审查工作流中启用 --filter-no-commit 参数 ([e0024ad](https://git.bjxgj.com/xgj/spaceflow/commit/e0024ad5cb29250b452a841db2ce6ebf84016a2c))
- 禁用删除代码分析功能 ([988e3f1](https://git.bjxgj.com/xgj/spaceflow/commit/988e3f156f2ca4e92413bf7a455eba1760ad9eba))
## [0.17.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.16.0...@spaceflow/publish@0.17.0) (2026-02-02)
### 新特性
- **core:** 在 Gitea SDK 中新增编辑 Pull Request 的方法 ([a586bf1](https://git.bjxgj.com/xgj/spaceflow/commit/a586bf110789578f23b39d64511229a1e5635dc4))
- **core:** 在 Gitea SDK 中新增获取 reactions 的方法 ([9324cf2](https://git.bjxgj.com/xgj/spaceflow/commit/9324cf2550709b8302171e5522d0792c08bc1415))
- **review:** 优化 commit author 获取逻辑,支持 committer 作为备选 ([b75b613](https://git.bjxgj.com/xgj/spaceflow/commit/b75b6133e5b8c95580516480315bc979fc6eb59b))
- **review:** 优化 commit author 获取逻辑,支持从 Git 原始作者信息中提取 ([10ac821](https://git.bjxgj.com/xgj/spaceflow/commit/10ac8210a4457e0356c3bc1645f54f6f3d8c904c))
- **review:** 优化 commit author 获取逻辑,通过 Gitea API 搜索用户以关联 Git 原始作者 ([daa274b](https://git.bjxgj.com/xgj/spaceflow/commit/daa274bba2255e92d1e9a6e049e20846a69e8df7))
- **review:** 优化 PR 标题生成的格式要求 ([a4d807d](https://git.bjxgj.com/xgj/spaceflow/commit/a4d807d0a4feee4ccc88c6096e069c6dbb650a03))
- **review:** 优化 verbose 参数支持多级别累加,将日志级别扩展为 0-3 级 ([fe4c830](https://git.bjxgj.com/xgj/spaceflow/commit/fe4c830cac137c5502d700d2cd5f22b52a629e5f))
- **review:** 优化历史问题的 author 信息填充逻辑 ([b18d171](https://git.bjxgj.com/xgj/spaceflow/commit/b18d171c9352fe5815262d43ffd9cd7751f03a4e))
- **review:** 优化审查报告中回复消息的格式显示 ([f478c8d](https://git.bjxgj.com/xgj/spaceflow/commit/f478c8da4c1d7494819672006e3230dbc8e0924d))
- **review:** 优化审查报告中的消息展示格式 ([0996c2b](https://git.bjxgj.com/xgj/spaceflow/commit/0996c2b45c9502c84308f8a7f9186e4dbd4164fb))
- **review:** 优化问题 author 信息填充时机,统一在所有问题合并后填充 ([ea8c586](https://git.bjxgj.com/xgj/spaceflow/commit/ea8c586fc60061ffd339e85c6c298b905bdfdcd8))
- **review:** 优化问题展示和无效标记逻辑 ([e2b45e1](https://git.bjxgj.com/xgj/spaceflow/commit/e2b45e1ec594488bb79f528911fd6009a3213eca))
- **review:** 在 fillIssueAuthors 方法中添加详细的调试日志 ([42ab288](https://git.bjxgj.com/xgj/spaceflow/commit/42ab288933296abdeeb3dbbedbb2aecedbea2251))
- **review:** 在 syncReactionsToIssues 中添加详细日志并修复团队成员获取逻辑 ([91f166a](https://git.bjxgj.com/xgj/spaceflow/commit/91f166a07c2e43dabd4dd4ac186ec7b5f03dfc71))
- **review:** 在审查报告的回复中为用户名添加 @ 前缀 ([bc6186b](https://git.bjxgj.com/xgj/spaceflow/commit/bc6186b97f0764f6335690eca1f8af665f9b7629))
- **review:** 在审查问题中添加作者信息填充功能 ([8332dba](https://git.bjxgj.com/xgj/spaceflow/commit/8332dba4bb826cd358dc96db5f9b9406fb23df9b))
- **review:** 将审查命令的详细日志参数从 --verbose 简化为 -vv ([5eb320b](https://git.bjxgj.com/xgj/spaceflow/commit/5eb320b92d1f7165052730b2e90eee52367391dd))
- **review:** 扩展评审人收集逻辑,支持从 PR 指定的评审人和团队中获取 ([bbd61af](https://git.bjxgj.com/xgj/spaceflow/commit/bbd61af9d3e2b9e1dcf28c5e3867645fdda52e6f))
- **review:** 支持 AI 自动生成和更新 PR 标题 ([e02fb02](https://git.bjxgj.com/xgj/spaceflow/commit/e02fb027d525dd3e794d649e6dbc53c99a3a9a59))
- **review:** 支持 PR 关闭事件触发审查并自动传递事件类型参数 ([03967d9](https://git.bjxgj.com/xgj/spaceflow/commit/03967d9e860af7da06e3c04539f16c7bb31557ff))
- **review:** 支持在审查报告中展示评论的 reactions 和回复记录 ([f4da31a](https://git.bjxgj.com/xgj/spaceflow/commit/f4da31adf6ce412cb0ce27bfe7a1e87e5350e915))
- **review:** 移除 handleReview 中的重复 author 填充逻辑 ([e458bfd](https://git.bjxgj.com/xgj/spaceflow/commit/e458bfd0d21724c37fdd4023265d6a2dd1700404))
- **review:** 限制 PR 标题自动更新仅在第一轮审查时执行 ([1891cbc](https://git.bjxgj.com/xgj/spaceflow/commit/1891cbc8d85f6eaef9e7107a7f1003bdc654d3a3))
- **review:** 默认启用 PR 标题自动更新功能 ([fda6656](https://git.bjxgj.com/xgj/spaceflow/commit/fda6656efaf6479bb398ddc5cb1955142f31f369))
### 修复BUG
- **actions:** 修复日志输出中的 emoji 显示问题,将 <20> 替换为 ([d3cd94a](https://git.bjxgj.com/xgj/spaceflow/commit/d3cd94afa9c6893b923d316fdcb5904f42ded632))
- **review:** 修复审查完成日志中的乱码 emoji ([36c1c48](https://git.bjxgj.com/xgj/spaceflow/commit/36c1c48faecda3cc02b9e0b097aebba0a85ea5f8))
- **review:** 将 UserInfo 的 id 字段类型从 number 改为 string ([505e019](https://git.bjxgj.com/xgj/spaceflow/commit/505e019c85d559ce1def1350599c1de218f7516a))
### 其他修改
- **ci-scripts:** released version 0.15.0 [no ci] ([e314fb1](https://git.bjxgj.com/xgj/spaceflow/commit/e314fb11e7425b27c337d3650857cf3b737051fd))
- **ci-shell:** released version 0.15.0 [no ci] ([5c0dc0b](https://git.bjxgj.com/xgj/spaceflow/commit/5c0dc0b5482366ccfd7854868d1eb5f306c24810))
- **core:** released version 0.15.0 [no ci] ([48f3875](https://git.bjxgj.com/xgj/spaceflow/commit/48f38754dee382548bab968c57dd0f40f2343981))
- **period-summary:** released version 0.15.0 [no ci] ([3dd72cb](https://git.bjxgj.com/xgj/spaceflow/commit/3dd72cb65a422b5b008a83820e799b810a6d53eb))
- **review:** released version 0.18.0 [no ci] ([d366e3f](https://git.bjxgj.com/xgj/spaceflow/commit/d366e3fa9c1b32369a3d98e56fc873e033d71d00))
## [0.16.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.15.0...@spaceflow/publish@0.16.0) (2026-01-31)
### 修复BUG
- **core:** 统一所有命令的错误处理,添加堆栈信息输出 ([31224a1](https://git.bjxgj.com/xgj/spaceflow/commit/31224a16ce7155402504bd8d3e386e59e47949df))
- **review:** 增强错误处理,添加堆栈信息输出 ([e0fb5de](https://git.bjxgj.com/xgj/spaceflow/commit/e0fb5de6bc877d8f0b3dc3c03f8d614320427bf3))
### 其他修改
- **ci-scripts:** released version 0.14.0 [no ci] ([c536208](https://git.bjxgj.com/xgj/spaceflow/commit/c536208e352baa82e5b56c490ea9df0aff116cb2))
- **ci-shell:** released version 0.14.0 [no ci] ([c6e4bdc](https://git.bjxgj.com/xgj/spaceflow/commit/c6e4bdca44874739694e3e46998e376779503e53))
- **core:** released version 0.14.0 [no ci] ([996dbc6](https://git.bjxgj.com/xgj/spaceflow/commit/996dbc6f80b0d3fb8049df9a9a31bd1e5b5d4b92))
- **period-summary:** released version 0.14.0 [no ci] ([55a72f2](https://git.bjxgj.com/xgj/spaceflow/commit/55a72f2b481e5ded1d9207a5a8d6a6864328d5a0))
- **review:** released version 0.17.0 [no ci] ([9f25412](https://git.bjxgj.com/xgj/spaceflow/commit/9f254121557ae238e32f4093b0c8b5dd8a4b9a72))
## [0.15.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.14.0...@spaceflow/publish@0.15.0) (2026-01-31)
### 新特性
- **review:** 为删除影响分析添加文件过滤功能 ([7304293](https://git.bjxgj.com/xgj/spaceflow/commit/73042937c5271ff4b0dcb6cd6d823e5aa0c03e7b))
- **review:** 新增过滤无commit问题的选项 ([7a4c458](https://git.bjxgj.com/xgj/spaceflow/commit/7a4c458da03ae4a4646abca7e5f03abc849dc405))
### 修复BUG
- **core:** 修复 resolveRef 方法未处理空 ref 参数的问题 ([0824c83](https://git.bjxgj.com/xgj/spaceflow/commit/0824c8392482263036888b2fec95935371d67d4d))
- **review:** 修复参数空值检查,增强代码健壮性 ([792a192](https://git.bjxgj.com/xgj/spaceflow/commit/792a192fd5dd80ed1e6d85cd61f6ce997bcc9dd9))
- **review:** 修复按指定提交过滤时未处理空值导致的潜在问题 ([5d4d3e0](https://git.bjxgj.com/xgj/spaceflow/commit/5d4d3e0390a50c01309bb09e01c7328b211271b8))
### 其他修改
- **ci-scripts:** released version 0.13.0 [no ci] ([021eefd](https://git.bjxgj.com/xgj/spaceflow/commit/021eefdf2ff72d16b36123335548df2d3ad1d6b7))
- **ci-shell:** released version 0.13.0 [no ci] ([81e7582](https://git.bjxgj.com/xgj/spaceflow/commit/81e75820eb69ca188155e33945111e2b1f6b3012))
- **core:** released version 0.13.0 [no ci] ([e3edde3](https://git.bjxgj.com/xgj/spaceflow/commit/e3edde3e670c79544af9a7249d566961740a2284))
- **period-summary:** released version 0.13.0 [no ci] ([1d47460](https://git.bjxgj.com/xgj/spaceflow/commit/1d47460e40ba422a32865ccddd353e089eb91c6a))
- **review:** released version 0.13.0 [no ci] ([4214c44](https://git.bjxgj.com/xgj/spaceflow/commit/4214c4406ab5482b151ec3c00da376b1d3d50887))
- **review:** released version 0.14.0 [no ci] ([4165b05](https://git.bjxgj.com/xgj/spaceflow/commit/4165b05f8aab90d753193f3c1c2800e7f03ea4de))
- **review:** released version 0.15.0 [no ci] ([a2ab86d](https://git.bjxgj.com/xgj/spaceflow/commit/a2ab86d097943924749876769f0a144926178783))
- **review:** released version 0.16.0 [no ci] ([64c8866](https://git.bjxgj.com/xgj/spaceflow/commit/64c88666fc7e84ced013198d3a53a8c75c7889eb))
## [0.14.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.13.0...@spaceflow/publish@0.14.0) (2026-01-31)
### 新特性
- **core:** 为 CLI 入口文件添加 Node shebang 支持 ([0d787d3](https://git.bjxgj.com/xgj/spaceflow/commit/0d787d329e69f2b53d26ba04720d60625ca51efd))
### 其他修改
- **ci-scripts:** released version 0.12.0 [no ci] ([097863f](https://git.bjxgj.com/xgj/spaceflow/commit/097863f0c5cc46cb5cb930f14a6f379f60a13f08))
- **ci-shell:** released version 0.12.0 [no ci] ([274216f](https://git.bjxgj.com/xgj/spaceflow/commit/274216fc930dfbf8390d02e25c06efcb44980fed))
- **core:** released version 0.12.0 [no ci] ([1ce5034](https://git.bjxgj.com/xgj/spaceflow/commit/1ce50346d73a1914836333415f5ead9fbfa27be7))
- **period-summary:** released version 0.12.0 [no ci] ([38490aa](https://git.bjxgj.com/xgj/spaceflow/commit/38490aa75ab20789c5495a5d8d009867f954af4f))
- **review:** released version 0.12.0 [no ci] ([3da605e](https://git.bjxgj.com/xgj/spaceflow/commit/3da605ea103192070f1c63112ad896a33fbc4312))
## [0.13.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.12.0...@spaceflow/publish@0.13.0) (2026-01-29)
### 新特性
- **core:** 优化 commit message 的 scope 处理逻辑 ([42869dd](https://git.bjxgj.com/xgj/spaceflow/commit/42869dd4bde0a3c9bf8ffb827182775e2877a57b))
- **core:** 重构 commit 服务并添加结构化 commit message 支持 ([22b4db8](https://git.bjxgj.com/xgj/spaceflow/commit/22b4db8619b0ce038667ab42dea1362706887fc9))
### 其他修改
- **ci-scripts:** released version 0.11.0 [no ci] ([d4f5bba](https://git.bjxgj.com/xgj/spaceflow/commit/d4f5bba6f89e9e051dde8d313b6e102c6dadfa41))
- **ci-shell:** released version 0.11.0 [no ci] ([cf9e486](https://git.bjxgj.com/xgj/spaceflow/commit/cf9e48666197295f118396693abc08b680b3ddee))
- **core:** released version 0.11.0 [no ci] ([f0025c7](https://git.bjxgj.com/xgj/spaceflow/commit/f0025c792e332e8b8752597a27f654c0197c36eb))
- **period-summary:** released version 0.11.0 [no ci] ([b518887](https://git.bjxgj.com/xgj/spaceflow/commit/b518887bddd5a452c91148bac64d61ec64b0b509))
- **review:** released version 0.11.0 [no ci] ([150cd9d](https://git.bjxgj.com/xgj/spaceflow/commit/150cd9df7d380c26e6f3f7f0dfd027022f610e6e))
## [0.12.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.11.0...@spaceflow/publish@0.12.0) (2026-01-29)
### 新特性
- **core:** 优化 npm 包名处理逻辑 ([ae23ebd](https://git.bjxgj.com/xgj/spaceflow/commit/ae23ebdc3144b611e1aa8c4e66bf0db074d09798))
- **core:** 添加依赖更新功能 ([1a544eb](https://git.bjxgj.com/xgj/spaceflow/commit/1a544eb5e2b64396a0187d4518595e9dcb51d73e))
- **review:** 支持绝对路径转换为相对路径 ([9050f64](https://git.bjxgj.com/xgj/spaceflow/commit/9050f64b8ef67cb2c8df9663711a209523ae9d18))
### 其他修改
- **ci-scripts:** released version 0.10.0 [no ci] ([ca2daad](https://git.bjxgj.com/xgj/spaceflow/commit/ca2daada8b04bbe809e69a3d5bd9373e897c6f40))
- **ci-shell:** released version 0.10.0 [no ci] ([53864b8](https://git.bjxgj.com/xgj/spaceflow/commit/53864b8c2534cae265b8fbb98173a5b909682d4e))
- **core:** released version 0.10.0 [no ci] ([a80d34f](https://git.bjxgj.com/xgj/spaceflow/commit/a80d34fb647e107343a07a8793363b3b76320e81))
- **period-summary:** released version 0.10.0 [no ci] ([c1ca3bb](https://git.bjxgj.com/xgj/spaceflow/commit/c1ca3bb67fa7f9dbb4de152f0461d644f3044946))
- **review:** released version 0.10.0 [no ci] ([6465de8](https://git.bjxgj.com/xgj/spaceflow/commit/6465de8751028787efb509670988c62b4dbbdf2a))
- **review:** released version 0.9.0 [no ci] ([13dd62c](https://git.bjxgj.com/xgj/spaceflow/commit/13dd62c6f307aa6d3b78c34f485393434036fe59))
## [0.11.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.10.0...@spaceflow/publish@0.11.0) (2026-01-28)
### 新特性
- **core:** 为 npm 包添加 npx 直接执行支持 ([e67a7da](https://git.bjxgj.com/xgj/spaceflow/commit/e67a7da34c4e41408760da4de3a499495ce0df2f))
### 其他修改
- **ci-scripts:** released version 0.9.0 [no ci] ([1b9e816](https://git.bjxgj.com/xgj/spaceflow/commit/1b9e8167bb8fc67fcc439b2ef82e7a63dc323e6d))
- **ci-shell:** released version 0.9.0 [no ci] ([accdda7](https://git.bjxgj.com/xgj/spaceflow/commit/accdda7ee4628dc8447e9a89da6c8101c572cb90))
- **core:** released version 0.9.0 [no ci] ([8127211](https://git.bjxgj.com/xgj/spaceflow/commit/812721136828e8c38adf0855fb292b0da89daf1a))
- **period-summary:** released version 0.9.0 [no ci] ([ac03f9b](https://git.bjxgj.com/xgj/spaceflow/commit/ac03f9bcff742d669c6e8b2f94e40153b6c298f5))
- **review:** released version 0.8.0 [no ci] ([ec6e7e5](https://git.bjxgj.com/xgj/spaceflow/commit/ec6e7e5defd2a5a6349d3530f3b0f4732dd5bb62))
## [0.10.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.9.0...@spaceflow/publish@0.10.0) (2026-01-28)
### 新特性
- **core:** 优化 commit 消息生成器中的 scope 处理逻辑 ([1592079](https://git.bjxgj.com/xgj/spaceflow/commit/1592079edde659fe94a02bb6e2dea555c80d3b6b))
### 其他修改
- **ci-scripts:** released version 0.8.0 [no ci] ([be6273d](https://git.bjxgj.com/xgj/spaceflow/commit/be6273dab7f1c80c58abdb8de6f0eeb986997e28))
- **ci-shell:** released version 0.8.0 [no ci] ([3102178](https://git.bjxgj.com/xgj/spaceflow/commit/310217827c6ec29294dee5689b2dbb1b66492728))
- **core:** released version 0.8.0 [no ci] ([625dbc0](https://git.bjxgj.com/xgj/spaceflow/commit/625dbc0206747b21a893ae43032f55d0a068c6fd))
- **period-summary:** released version 0.8.0 [no ci] ([44ff3c5](https://git.bjxgj.com/xgj/spaceflow/commit/44ff3c505b243e1291565e354e239ce893e5e47c))
- **review:** released version 0.7.0 [no ci] ([1d195d7](https://git.bjxgj.com/xgj/spaceflow/commit/1d195d74685f12edf3b1f4e13b58ccc3d221fd94))
## [0.9.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.8.0...@spaceflow/publish@0.9.0) (2026-01-28)
### 代码重构
- **core:** 重构安装服务目录结构和命名 ([50cc900](https://git.bjxgj.com/xgj/spaceflow/commit/50cc900eb864b23f20c5f48dec20d1a754238286))
### 其他修改
- **ci-scripts:** released version 0.7.0 [no ci] ([ea294e1](https://git.bjxgj.com/xgj/spaceflow/commit/ea294e138c6b15033af85819629727915dfcbf4b))
- **ci-shell:** released version 0.7.0 [no ci] ([247967b](https://git.bjxgj.com/xgj/spaceflow/commit/247967b30876aae78cfb1f9c706431b5bb9fb57e))
- **core:** released version 0.7.0 [no ci] ([000c53e](https://git.bjxgj.com/xgj/spaceflow/commit/000c53eff80899dbadad8d668a2227921373daad))
- **period-summary:** released version 0.7.0 [no ci] ([8869d58](https://git.bjxgj.com/xgj/spaceflow/commit/8869d5876e86ebe83ae65c3259cd9a7e402257cf))
- **review:** released version 0.6.0 [no ci] ([48a90b2](https://git.bjxgj.com/xgj/spaceflow/commit/48a90b253dbe03f46d26bb88f3e0158193aa1dba))
## [0.8.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.7.0...@spaceflow/publish@0.8.0) (2026-01-28)
### 新特性
- **core:** 优化pnpm包安装逻辑检测是否为workspace ([6555daf](https://git.bjxgj.com/xgj/spaceflow/commit/6555dafe1f08a244525be3a0345cc585f2552086))
### 其他修改
- **ci-scripts:** released version 0.6.0 [no ci] ([d485758](https://git.bjxgj.com/xgj/spaceflow/commit/d48575827941cae6ffc7ae6ba911e5d4cf3bd7fa))
- **ci-shell:** released version 0.6.0 [no ci] ([a2d1239](https://git.bjxgj.com/xgj/spaceflow/commit/a2d12397997b309062a9d93af57a5588cdb82a79))
- **core:** released version 0.6.0 [no ci] ([21e1ec6](https://git.bjxgj.com/xgj/spaceflow/commit/21e1ec61a2de542e065034f32a259092dd7c0e0d))
- **period-summary:** released version 0.6.0 [no ci] ([6648dfb](https://git.bjxgj.com/xgj/spaceflow/commit/6648dfb31b459e8c4522cff342dfa87a4bdaab4b))
- **review:** released version 0.5.0 [no ci] ([93c3088](https://git.bjxgj.com/xgj/spaceflow/commit/93c308887040f39047766a789a37d24ac6146359))
## [0.7.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.6.0...@spaceflow/publish@0.7.0) (2026-01-28)
### 新特性
- **core:** 优化包管理器检测与 npm 包处理逻辑 ([63f7fa4](https://git.bjxgj.com/xgj/spaceflow/commit/63f7fa4f55cb41583009b2ea313b5ad327615e52))
### 代码重构
- **core:** 优化配置合并逻辑,添加字段覆盖策略 ([18680e6](https://git.bjxgj.com/xgj/spaceflow/commit/18680e69b0d6e9e05c843ed3f07766830955d658))
### 其他修改
- **ci-scripts:** released version 0.5.0 [no ci] ([a87a1da](https://git.bjxgj.com/xgj/spaceflow/commit/a87a1da0490986c46c2a527cda5e7d0df9df6d03))
- **ci-shell:** released version 0.5.0 [no ci] ([920d9a8](https://git.bjxgj.com/xgj/spaceflow/commit/920d9a8165fe6eabf7a074eb65762f4693883438))
- **core:** released version 0.5.0 [no ci] ([ad20098](https://git.bjxgj.com/xgj/spaceflow/commit/ad20098ef954283dd6d9867a4d2535769cbb8377))
- **period-summary:** released version 0.5.0 [no ci] ([8e547e9](https://git.bjxgj.com/xgj/spaceflow/commit/8e547e9e6a6496a8c314c06cf6e88c97e623bc2d))
- **review:** released version 0.4.0 [no ci] ([3b5f8a9](https://git.bjxgj.com/xgj/spaceflow/commit/3b5f8a934de5ba4f59e232e1dcbccbdff1b8b17c))
- 更新项目依赖锁定文件 ([19d2d1d](https://git.bjxgj.com/xgj/spaceflow/commit/19d2d1d86bb35b8ee5d3ad20be51b7aa68e83eff))
- 移除 npm registry 配置文件 ([2d9fac6](https://git.bjxgj.com/xgj/spaceflow/commit/2d9fac6db79e81a09ca8e031190d0ebb2781cc31))
- 调整依赖配置并添加npm registry配置 ([a754db1](https://git.bjxgj.com/xgj/spaceflow/commit/a754db1bad1bafcea50b8d2825aaf19457778f2e))
## [0.6.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.5.0...@spaceflow/publish@0.6.0) (2026-01-28)
### 代码重构
- **publish:** 调整zod依赖的导入来源 ([574eef1](https://git.bjxgj.com/xgj/spaceflow/commit/574eef1910809a72a4b13acd4cb070e12dc42ce8))
- **review:** 调整zod依赖的导入路径 ([02014cd](https://git.bjxgj.com/xgj/spaceflow/commit/02014cdab9829df583f0f621150573b8c45a3ad7))
### 其他修改
- **ci-scripts:** released version 0.4.0 [no ci] ([364f696](https://git.bjxgj.com/xgj/spaceflow/commit/364f696d0df5d84be915cfaa9202a592073d9b46))
- **ci-shell:** released version 0.4.0 [no ci] ([7e6bf1d](https://git.bjxgj.com/xgj/spaceflow/commit/7e6bf1dabffc6250b918b89bb850d478d3f4b875))
- **core:** released version 0.4.0 [no ci] ([bc4cd89](https://git.bjxgj.com/xgj/spaceflow/commit/bc4cd89af70dce052e7e00fe413708790f65be61))
- **core:** 调整核心依赖与配置新增Zod类型系统支持 ([def0751](https://git.bjxgj.com/xgj/spaceflow/commit/def0751577d9f3350494ca3c7bb4a4b087dab05e))
- **period-summary:** released version 0.4.0 [no ci] ([ca89a9b](https://git.bjxgj.com/xgj/spaceflow/commit/ca89a9b9436761e210dedfc38fb3c16ef39b0718))
- **review:** released version 0.3.0 [no ci] ([865c6fd](https://git.bjxgj.com/xgj/spaceflow/commit/865c6fdee167df187d1bc107867f842fe25c1098))
- 调整项目依赖配置 ([6802386](https://git.bjxgj.com/xgj/spaceflow/commit/6802386f38f4081a3b5d5c47ddc49e9ec2e4f28d))
## [0.5.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.4.0...@spaceflow/publish@0.5.0) (2026-01-28)
### 其他修改
- **ci-scripts:** released version 0.3.0 [no ci] ([9292b52](https://git.bjxgj.com/xgj/spaceflow/commit/9292b524f2b8171f8774fab4e4ef4b32991f5d3d))
- **ci-shell:** released version 0.3.0 [no ci] ([7b25e55](https://git.bjxgj.com/xgj/spaceflow/commit/7b25e557b628fdfa66d7a0be4ee21267906ac15f))
- **core:** released version 0.3.0 [no ci] ([bf8b005](https://git.bjxgj.com/xgj/spaceflow/commit/bf8b005ccbfcdd2061c18ae4ecdd476584ecbb53))
- **core:** 调整依赖配置 ([c86534a](https://git.bjxgj.com/xgj/spaceflow/commit/c86534ad213293ee2557ba5568549e8fbcb74ba5))
- **period-summary:** released version 0.3.0 [no ci] ([7e74c59](https://git.bjxgj.com/xgj/spaceflow/commit/7e74c59d90d88e061e693829f8196834d9858307))
- 调整项目依赖配置 ([f4009cb](https://git.bjxgj.com/xgj/spaceflow/commit/f4009cb0c369b225c356584afb28a7ff5a1a89ec))
## [0.4.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.3.0...@spaceflow/publish@0.4.0) (2026-01-28)
### 代码重构
- **publish:** 调整包变更检测的日志输出格式 ([df35e92](https://git.bjxgj.com/xgj/spaceflow/commit/df35e92d614ce59e202643cf34a0fef2803412a1))
### 其他修改
- **review:** released version 0.2.0 [no ci] ([d0bd3ed](https://git.bjxgj.com/xgj/spaceflow/commit/d0bd3edf364dedc7c077d95801b402d41c3fdd9c))
## [0.3.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.2.0...@spaceflow/publish@0.3.0) (2026-01-28)
### 文档更新
- **core:** 更新核心框架README文档 ([0d98658](https://git.bjxgj.com/xgj/spaceflow/commit/0d98658f6ab01f119f98d3387fb5651d4d4351a8))
### 其他修改
- **ci-scripts:** released version 0.2.0 [no ci] ([716e9ad](https://git.bjxgj.com/xgj/spaceflow/commit/716e9ad0f32bde09c608143da78f0a4299017797))
- **ci-shell:** released version 0.2.0 [no ci] ([4f5314b](https://git.bjxgj.com/xgj/spaceflow/commit/4f5314b1002b90d7775a5ef51e618a3f227ae5a9))
- **core:** released version 0.2.0 [no ci] ([5a96529](https://git.bjxgj.com/xgj/spaceflow/commit/5a96529cabdce4fb150732b34c55e668c33cb50c))
- **period-summary:** released version 0.2.0 [no ci] ([66a4e20](https://git.bjxgj.com/xgj/spaceflow/commit/66a4e209519b64d946ec21b1d1695105fb9de106))
## [0.2.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.1.2...@spaceflow/publish@0.2.0) (2026-01-28)
### 新特性
- **publish:** 增强包变更检测的日志输出 ([b89c5cc](https://git.bjxgj.com/xgj/spaceflow/commit/b89c5cc0654713b6482ee591325d4f92ad773600))
### 修复BUG
- **publish:** 修复分支锁定时未捕获异常处理器的资源泄漏问题 ([ae326e9](https://git.bjxgj.com/xgj/spaceflow/commit/ae326e95c0cea033893cf084cbf7413fb252bd33))
### 其他修改
- **review:** released version 0.1.2 [no ci] ([9689d3e](https://git.bjxgj.com/xgj/spaceflow/commit/9689d3e37781ca9ae6cb14d7b12717c061f2919d))
- 优化CI工作流的代码检出配置 ([d9740dd](https://git.bjxgj.com/xgj/spaceflow/commit/d9740dd6d1294068ffdcd7a12b61149773866a2a))
## [0.1.2](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.1.1...@spaceflow/publish@0.1.2) (2026-01-28)
### 修复BUG
- **publish:** 修复预演模式下的交互式提示问题 ([0b785bf](https://git.bjxgj.com/xgj/spaceflow/commit/0b785bfddb9f35e844989bd3891817dc502302f8))
### 其他修改
- **ci-scripts:** released version 0.1.2 [no ci] ([ab9c100](https://git.bjxgj.com/xgj/spaceflow/commit/ab9c1000bcbe64d8a99ffa6bebb974c024b14325))
- **ci-shell:** released version 0.1.2 [no ci] ([bf7977b](https://git.bjxgj.com/xgj/spaceflow/commit/bf7977bed684b557555861b9dc0359eda3c5d476))
- **core:** released version 0.1.2 [no ci] ([8292dbe](https://git.bjxgj.com/xgj/spaceflow/commit/8292dbe59a200cc640a95b86afb6451ec0c044ce))
- **period-summary:** released version 0.1.2 [no ci] ([eaf41a0](https://git.bjxgj.com/xgj/spaceflow/commit/eaf41a0149ee4306361ccab0b3878bded79677df))
## [0.1.1](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.1.0...@spaceflow/publish@0.1.1) (2026-01-28)
### 文档更新
- **publish:** 完善发布插件README文档 ([faa57b0](https://git.bjxgj.com/xgj/spaceflow/commit/faa57b095453c00fb3c9a7704bc31b63953c0ac5))
### 其他修改
- **ci-scripts:** released version 0.1.1 [no ci] ([19ca0d8](https://git.bjxgj.com/xgj/spaceflow/commit/19ca0d8461f9537f4318b772cad3ea395d2b3264))
- **ci-shell:** released version 0.1.1 [no ci] ([488a686](https://git.bjxgj.com/xgj/spaceflow/commit/488a6869240151e7d1cf37a3b177897c2b5d5c1e))
- **core:** released version 0.1.1 [no ci] ([0cf3a4d](https://git.bjxgj.com/xgj/spaceflow/commit/0cf3a4d37d7d1460e232dd30bc7ab8dc015ed11f))
- **period-summary:** released version 0.1.1 [no ci] ([b77e96b](https://git.bjxgj.com/xgj/spaceflow/commit/b77e96b1b768efa81d37143101057224fc3cef0f))
## [0.1.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/publish@0.0.1...@spaceflow/publish@0.1.0) (2026-01-28)
### 新特性
- **core:** 添加同步解锁分支方法用于进程退出清理 ([cbec480](https://git.bjxgj.com/xgj/spaceflow/commit/cbec480511e074de3ccdc61226f3baa317cff907))
### 其他修改
- **ci-scripts:** released version 0.1.0 [no ci] ([57b3a1c](https://git.bjxgj.com/xgj/spaceflow/commit/57b3a1c826dafd5ec51d68b7471266efd5cc32b2))
- **ci-shell:** released version 0.1.0 [no ci] ([2283d9d](https://git.bjxgj.com/xgj/spaceflow/commit/2283d9d69ada1c071bef6c548dc756fe062893bd))
- **core:** released version 0.1.0 [no ci] ([f455607](https://git.bjxgj.com/xgj/spaceflow/commit/f45560735082840410e08e0d8113f366732a1243))
- **period-summary:** released version 0.1.0 [no ci] ([36fb7a4](https://git.bjxgj.com/xgj/spaceflow/commit/36fb7a486da82e1d8e4b0574c68b4473cd86b28e))
## 0.0.1 (2026-01-28)
### 其他修改
- **ci-scripts:** released version 0.0.1 [no ci] ([b38fb9b](https://git.bjxgj.com/xgj/spaceflow/commit/b38fb9ba56200ced1baf563b097faa8717693783))
- **ci-shell:** released version 0.0.1 [no ci] ([ec2a84b](https://git.bjxgj.com/xgj/spaceflow/commit/ec2a84b298c5fb989951caf42e2b016b3336f6a0))
- **core:** released version 0.0.1 [no ci] ([66497d6](https://git.bjxgj.com/xgj/spaceflow/commit/66497d60be04b4756a3362dbec4652177910165c))
- **period-summary:** released version 0.0.1 [no ci] ([7ab3504](https://git.bjxgj.com/xgj/spaceflow/commit/7ab3504750191b88643fe5db6b92bb08acc9ab5d))
- 重置所有包版本至 0.0.0 并清理 CHANGELOG 文件 ([f7efaf9](https://git.bjxgj.com/xgj/spaceflow/commit/f7efaf967467f1272e05d645720ee63941fe79be))

237
commands/publish/README.md Normal file
View File

@@ -0,0 +1,237 @@
# @spaceflow/publish
Spaceflow CI 发布插件,基于 [release-it](https://github.com/release-it/release-it) 实现自动化版本发布。
## 功能特性
- **Monorepo 支持**:自动检测变更包,按依赖拓扑顺序发布
- **分支保护**:发布期间自动锁定分支,防止其他推送干扰
- **Conventional Changelog**:基于 conventional commits 自动生成 CHANGELOG
- **GitHub Release**:自动创建 GitHub Release 并上传资产文件
- **预发布支持**:支持 rc、beta、alpha 等预发布版本
- **进程退出保护**:即使发布失败也能自动解锁分支
## 安装
`@spaceflow/publish``@spaceflow/cli` 的内置命令,安装 CLI 后即可使用:
```bash
# 使用 pnpm
pnpm add -D @spaceflow/cli
pnpm spaceflow install @spaceflow/publish
```
然后在项目根目录创建 `spaceflow.json` 配置文件:
```json
{
"publish": {
"monorepo": {
"enabled": true
},
"git": {
"lockBranch": true,
"pushWhitelistUsernames": ["github-actions[bot]"]
}
}
}
```
## 命令行参数
```bash
# 发布
spaceflow publish [options]
# 预演
spaceflow publish --rehearsal
```
| 参数 | 说明 |
| ------------------------ | ----------------------------------------------- |
| `-d, --dry-run` | 仅打印将要执行的操作,不实际执行 |
| `-c, --ci` | 在 CI 环境中运行(自动 fetch tags |
| `-p, --prerelease <tag>` | 预发布标签,如 `rc``beta``alpha``nightly` |
| `-r, --rehearsal` | 预演模式:执行 hooks 但不修改文件/git |
## 配置
`spaceflow.config.ts` 中配置 `publish` 插件:
```typescript
export default {
plugins: {
publish: {
// Monorepo 发布模式配置
monorepo: {
enabled: true, // 启用 monorepo 模式
propagateDeps: true, // 依赖的包变更时,依赖方也发布
},
// Changelog 配置
changelog: {
infileDir: ".", // CHANGELOG 文件输出目录
preset: {
name: "conventionalcommits",
type: [
{ type: "feat", section: "新功能" },
{ type: "fix", section: "Bug 修复" },
{ type: "refactor", section: "代码重构" },
{ type: "perf", section: "性能优化" },
{ type: "docs", section: "文档更新" },
],
},
},
// NPM 发布配置
npm: {
publish: true, // 是否发布到 npm registry
packageManager: "pnpm", // 包管理器npm 或 pnpm
registry: "https://registry.npmjs.org",
tag: "latest", // npm tag
ignoreVersion: true, // 忽略 package.json 中的版本号
versionArgs: ["--workspaces false"],
publishArgs: [],
},
// GitHub Release 配置
release: {
host: "https://github.com",
assets: [{ path: "dist/*.zip", name: "dist.zip", type: "zip" }],
},
// Git 配置
git: {
requireBranch: ["main", "dev", "develop"], // 允许发布的分支
lockBranch: true, // 发布时锁定分支
pushWhitelistUsernames: ["github-actions[bot]"], // 锁定期间允许推送的用户
},
// release-it hooks
hooks: {
"before:bump": "echo 'Before bump'",
"after:bump": ["pnpm build", "pnpm test"],
},
},
},
};
```
## 配置项说明
### monorepo
| 配置项 | 类型 | 默认值 | 说明 |
| --------------- | --------- | ------- | -------------------------------- |
| `enabled` | `boolean` | `false` | 是否启用 monorepo 发布模式 |
| `propagateDeps` | `boolean` | `true` | 依赖的包变更时,依赖方是否也发布 |
### changelog
| 配置项 | 类型 | 默认值 | 说明 |
| ------------- | -------- | ----------------------- | ----------------------------- |
| `infileDir` | `string` | `"."` | CHANGELOG 文件输出目录 |
| `preset.name` | `string` | `"conventionalcommits"` | Changelog preset 名称 |
| `preset.type` | `array` | `[]` | Commit type 到 section 的映射 |
### npm
| 配置项 | 类型 | 默认值 | 说明 |
| ---------------- | ----------------- | ------------------------ | -------------------------------- |
| `publish` | `boolean` | `false` | 是否发布到 npm registry |
| `packageManager` | `"npm" \| "pnpm"` | `"npm"` | 包管理器 |
| `registry` | `string` | - | npm registry 地址 |
| `tag` | `string` | `"latest"` | npm tag |
| `ignoreVersion` | `boolean` | `true` | 是否忽略 package.json 中的版本号 |
| `versionArgs` | `string[]` | `["--workspaces false"]` | npm version 命令额外参数 |
| `publishArgs` | `string[]` | `[]` | npm/pnpm publish 命令额外参数 |
### release
| 配置项 | 类型 | 默认值 | 说明 |
| ---------------- | -------- | ------------- | -------------------- |
| `host` | `string` | `"localhost"` | Git 服务器地址 |
| `assets` | `array` | `[]` | Release 资产文件列表 |
| `assetSourcemap` | `object` | - | Sourcemap 资产配置 |
### git
| 配置项 | 类型 | 默认值 | 说明 |
| ------------------------ | ---------- | ---------------------------- | ------------------------ |
| `requireBranch` | `string[]` | `["main", "dev", "develop"]` | 允许发布的分支列表 |
| `lockBranch` | `boolean` | `true` | 发布时是否锁定分支 |
| `pushWhitelistUsernames` | `string[]` | `[]` | 锁定期间允许推送的用户名 |
### hooks
支持 release-it 的所有 hooks
- `before:init` / `after:init`
- `before:bump` / `after:bump`
- `before:release` / `after:release`
## 环境变量
| 变量 | 说明 |
| ------------------- | ----------------------------------------- |
| `GITHUB_TOKEN` | GitHub API Token |
| `GITHUB_REPOSITORY` | 仓库名称(格式:`owner/repo` |
| `GITHUB_REF_NAME` | 当前分支名称 |
| `PUBLISH_REHEARSAL` | 预演模式标志(由 `--rehearsal` 自动设置) |
## CI 工作流示例
```yaml
name: Publish
on:
push:
branches: [main]
jobs:
publish:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
fetch-depth: 0
fetch-tags: true
- uses: pnpm/action-setup@v4
- run: pnpm install --frozen-lockfile
- run: pnpm build
- run: pnpm spaceflow publish --ci
```
## 版本计算
版本号基于 [Conventional Commits](https://www.conventionalcommits.org/) 自动计算:
| Commit 类型 | 版本变更 |
| ----------------- | ------------- |
| `feat` | Minor (0.x.0) |
| `fix` | Patch (0.0.x) |
| `BREAKING CHANGE` | Major (x.0.0) |
| 其他 | Patch (0.0.x) |
## Monorepo 模式
启用 `monorepo.enabled: true` 后:
1. **变更检测**:基于 git diff 检测哪些包有变更
2. **依赖传递**:如果包 A 依赖包 B且 B 有变更A 也会被标记为需要发布
3. **拓扑排序**:被依赖的包先发布,确保依赖关系正确
4. **独立版本**:每个包有独立的版本号和 CHANGELOG
5. **Tag 格式**`@scope/package@version`(如 `@spaceflow/cli@1.0.0`
## 分支保护机制
发布期间会自动锁定分支,防止其他推送干扰发布流程:
1. **锁定**:创建分支保护规则,仅允许白名单用户推送
2. **发布**执行版本更新、CHANGELOG 生成、git tag、npm publish
3. **解锁**:删除分支保护规则,恢复正常状态
即使发布过程中发生错误,也会通过 `process.on('exit')` 确保分支被解锁。

View File

@@ -0,0 +1,30 @@
{
"name": "@spaceflow/publish",
"version": "0.21.0",
"description": "Spaceflow CI 发布插件,用于在发布流程中锁定/解锁分支",
"type": "module",
"main": "./dist/index.js",
"scripts": {
"build": "spaceflow build",
"dev": "spaceflow dev"
},
"dependencies": {
"@release-it/conventional-changelog": "^10.0.4",
"release-it": "^19.2.2",
"release-it-gitea": "^1.8.0"
},
"devDependencies": {
"@spaceflow/cli": "workspace:*",
"@types/node": "catalog:"
},
"peerDependencies": {
"@nestjs/common": "catalog:",
"@nestjs/config": "catalog:",
"@spaceflow/core": "workspace:*",
"nest-commander": "catalog:"
},
"spaceflow": {
"type": "flow",
"entry": "."
}
}

View File

@@ -0,0 +1,30 @@
import "./locales";
import { SpaceflowExtension, SpaceflowExtensionMetadata, t } from "@spaceflow/core";
import { PublishModule } from "./publish.module";
import { publishSchema } from "./publish.config";
/** publish Extension 元数据 */
export const publishMetadata: SpaceflowExtensionMetadata = {
name: "publish",
commands: ["publish"],
configKey: "publish",
configSchema: () => publishSchema,
version: "1.0.0",
description: t("publish:extensionDescription"),
};
export class PublishExtension implements SpaceflowExtension {
getMetadata(): SpaceflowExtensionMetadata {
return publishMetadata;
}
getModule() {
return PublishModule;
}
}
export default PublishExtension;
export * from "./publish.command";
export * from "./publish.service";
export * from "./publish.module";
export * from "./monorepo.service";

View File

@@ -0,0 +1,8 @@
{
"description": "CI publish command for branch lock/unlock during release",
"options.prerelease": "Prerelease tag, e.g. rc, beta, alpha, nightly",
"options.rehearsal": "Rehearsal mode: execute hooks but no file/git changes, sets PUBLISH_REHEARSAL=true",
"rehearsalMode": "🎭 REHEARSAL mode: hooks will execute, but no file/git changes",
"dryRunMode": "🔍 DRY-RUN mode: no actual execution",
"extensionDescription": "CI publish command for branch lock/unlock during release"
}

View File

@@ -0,0 +1,11 @@
import { addLocaleResources } from "@spaceflow/core";
import zhCN from "./zh-cn/publish.json";
import en from "./en/publish.json";
/** publish 命令 i18n 资源 */
export const publishLocales: Record<string, Record<string, string>> = {
"zh-CN": zhCN,
en,
};
addLocaleResources("publish", publishLocales);

View File

@@ -0,0 +1,8 @@
{
"description": "CI 发布命令,用于在发布流程中锁定/解锁分支",
"options.prerelease": "预发布标签,如 rc、beta、alpha、nightly 等",
"options.rehearsal": "预演模式:执行 hooks 但不修改文件/git设置 PUBLISH_REHEARSAL=true 环境变量",
"rehearsalMode": "🎭 REHEARSAL mode: hooks will execute, but no file/git changes",
"dryRunMode": "🔍 DRY-RUN mode: no actual execution",
"extensionDescription": "CI 发布命令,用于在发布流程中锁定/解锁分支"
}

View File

@@ -0,0 +1,376 @@
import { Injectable } from "@nestjs/common";
import { execSync } from "child_process";
import { existsSync, readFileSync } from "fs";
import { join } from "path";
export interface PackageInfo {
/** 包目录路径(相对于项目根目录) */
dir: string;
/** 包名称(从 package.json 读取) */
name: string;
/** 包版本 */
version: string;
/** workspace 依赖的包名列表 */
workspaceDeps: string[];
}
export interface MonorepoAnalysisResult {
/** 所有变更的包 */
changedPackages: PackageInfo[];
/** 需要发布的包(包含依赖变更的包),按拓扑排序 */
packagesToPublish: PackageInfo[];
}
@Injectable()
export class MonorepoService {
private readonly cwd: string;
constructor() {
this.cwd = process.cwd();
}
/**
* 分析 monorepo 变更,返回需要发布的包列表(拓扑排序后)
* @param dryRun 是否为 dry-run 模式
* @param propagateDeps 是否传递依赖变更(依赖的包变更时,依赖方也发布)
*/
async analyze(dryRun: boolean, propagateDeps = true): Promise<MonorepoAnalysisResult> {
const workspacePackages = this.getWorkspacePackages();
const allPackages = this.getAllPackageInfos(workspacePackages);
// 为每个包单独检测变更(基于各自的最新 tag
const changedPackages = this.getChangedPackages(allPackages, dryRun);
if (dryRun) {
console.log(`📦 直接变更的包: ${changedPackages.map((p) => p.name).join(", ") || "无"}`);
}
// 计算依赖传递,找出所有需要发布的包
const packagesToPublish = propagateDeps
? this.calculateAffectedPackages(changedPackages, allPackages)
: changedPackages;
if (dryRun) {
console.log(
`🔄 需要发布的包(含依赖传递): ${packagesToPublish.map((p) => p.name).join(", ") || "无"}`,
);
}
// 拓扑排序
const sortedPackages = this.topologicalSort(packagesToPublish, allPackages);
if (dryRun) {
console.log(`📋 发布顺序: ${sortedPackages.map((p) => p.name).join(" -> ") || "无"}`);
}
return {
changedPackages,
packagesToPublish: sortedPackages,
};
}
/**
* 简单解析 pnpm-workspace.yaml只提取 packages 数组)
*/
private parseSimpleYaml(content: string): { packages?: string[] } {
const packages: string[] = [];
const lines = content.split("\n");
let inPackages = false;
for (const line of lines) {
const trimmed = line.trim();
if (trimmed === "packages:") {
inPackages = true;
continue;
}
if (inPackages) {
if (trimmed.startsWith("- ")) {
// 提取包路径,去除引号
let pkg = trimmed.slice(2).trim();
pkg = pkg.replace(/^["']|["']$/g, "");
packages.push(pkg);
} else if (trimmed && !trimmed.startsWith("#") && !trimmed.startsWith("-")) {
// 遇到新的顶级 key停止解析
break;
}
}
}
return { packages: packages.length > 0 ? packages : undefined };
}
/**
* 从 pnpm-workspace.yaml 读取 workspace 包配置
*/
private getWorkspacePackages(): string[] {
const workspaceFile = join(this.cwd, "pnpm-workspace.yaml");
if (!existsSync(workspaceFile)) {
throw new Error("未找到 pnpm-workspace.yaml 文件");
}
const content = readFileSync(workspaceFile, "utf-8");
const config = this.parseSimpleYaml(content);
if (!config.packages || !Array.isArray(config.packages)) {
throw new Error("pnpm-workspace.yaml 中未配置 packages");
}
return config.packages;
}
/**
* 展开 workspace 包配置,获取所有实际的包目录
*/
private expandWorkspacePatterns(patterns: string[]): string[] {
const dirs: string[] = [];
for (const pattern of patterns) {
if (pattern.includes("*")) {
// 使用 glob 展开,这里简化处理,只支持 commands/* 这种模式
const baseDir = pattern.replace("/*", "");
const basePath = join(this.cwd, baseDir);
if (existsSync(basePath)) {
const { readdirSync, statSync } = require("fs");
const entries = readdirSync(basePath) as string[];
for (const entry of entries) {
const entryPath = join(basePath, entry);
if (statSync(entryPath).isDirectory()) {
const pkgJson = join(entryPath, "package.json");
if (existsSync(pkgJson)) {
dirs.push(join(baseDir, entry));
}
}
}
}
} else {
// 直接目录
const pkgJson = join(this.cwd, pattern, "package.json");
if (existsSync(pkgJson)) {
dirs.push(pattern);
}
}
}
return dirs;
}
/**
* 获取所有包的详细信息(排除私有包)
*/
private getAllPackageInfos(patterns: string[]): PackageInfo[] {
const dirs = this.expandWorkspacePatterns(patterns);
const packages: PackageInfo[] = [];
for (const dir of dirs) {
const pkgJsonPath = join(this.cwd, dir, "package.json");
if (!existsSync(pkgJsonPath)) continue;
const pkgJson = JSON.parse(readFileSync(pkgJsonPath, "utf-8"));
// 跳过私有包
if (pkgJson.private === true) continue;
const workspaceDeps = this.extractWorkspaceDeps(pkgJson);
packages.push({
dir,
name: pkgJson.name,
version: pkgJson.version,
workspaceDeps,
});
}
return packages;
}
/**
* 提取包的 workspace 依赖
*/
private extractWorkspaceDeps(pkgJson: Record<string, unknown>): string[] {
const deps: string[] = [];
const allDeps = {
...(pkgJson.dependencies as Record<string, string> | undefined),
...(pkgJson.devDependencies as Record<string, string> | undefined),
...(pkgJson.peerDependencies as Record<string, string> | undefined),
};
for (const [name, version] of Object.entries(allDeps)) {
if (version && (version.startsWith("workspace:") || version === "*")) {
deps.push(name);
}
}
return deps;
}
/**
* 检测每个包的变更(基于各自的最新 tag
*/
private getChangedPackages(allPackages: PackageInfo[], dryRun: boolean): PackageInfo[] {
const changedPackages: PackageInfo[] = [];
for (const pkg of allPackages) {
const hasChanges = this.hasPackageChanges(pkg);
if (hasChanges) {
changedPackages.push(pkg);
}
if (dryRun) {
console.log(` ${hasChanges ? "✅" : "⭕"} ${pkg.name}`);
}
}
return changedPackages;
}
/**
* 检测单个包是否有变更(基于该包的最新 tag
*/
private hasPackageChanges(pkg: PackageInfo): boolean {
try {
// 获取该包的最新 tag格式: @scope/pkg@version 或 pkg@version
const tagPattern = `${pkg.name}@*`;
const latestTag = execSync(
`git describe --tags --abbrev=0 --match "${tagPattern}" 2>/dev/null || echo ''`,
{ cwd: this.cwd, encoding: "utf-8" },
).trim();
if (!latestTag) {
// 没有 tag说明是新包需要发布
console.log(`📌 ${pkg.name}: 无 tag需要发布`);
return true;
}
// 检测从该 tag 到 HEAD该包目录下是否有变更
const diffOutput = execSync(`git diff --name-only "${latestTag}"..HEAD -- "${pkg.dir}"`, {
cwd: this.cwd,
encoding: "utf-8",
}).trim();
const hasChanges = diffOutput.length > 0;
if (hasChanges) {
console.log(`📌 ${pkg.name}: ${latestTag} -> HEAD 有变更`);
console.log(
` 变更文件: ${diffOutput.split("\n").slice(0, 3).join(", ")}${diffOutput.split("\n").length > 3 ? "..." : ""}`,
);
}
return hasChanges;
} catch (error) {
// 出错时保守处理,认为有变更
console.log(`📌 ${pkg.name}: 检测出错,保守处理为有变更`);
console.log(` 错误: ${error instanceof Error ? error.message : error}`);
return true;
}
}
/**
* 将变更文件映射到包目录
*/
private mapFilesToPackages(files: string[], patterns: string[]): Set<string> {
const packageDirs = this.expandWorkspacePatterns(patterns);
const changedPackages = new Set<string>();
for (const file of files) {
for (const dir of packageDirs) {
if (file.startsWith(dir + "/") || file === dir) {
changedPackages.add(dir);
break;
}
}
}
return changedPackages;
}
/**
* 计算受影响的包(包含依赖传递)
*/
private calculateAffectedPackages(
changedPackages: PackageInfo[],
allPackages: PackageInfo[],
): PackageInfo[] {
const changedNames = new Set(changedPackages.map((p) => p.name));
const affectedNames = new Set(changedNames);
// 构建反向依赖图:谁依赖了我
const reverseDeps = new Map<string, Set<string>>();
for (const pkg of allPackages) {
for (const dep of pkg.workspaceDeps) {
if (!reverseDeps.has(dep)) {
reverseDeps.set(dep, new Set());
}
reverseDeps.get(dep)!.add(pkg.name);
}
}
// BFS 传递依赖
const queue = [...changedNames];
while (queue.length > 0) {
const current = queue.shift()!;
const dependents = reverseDeps.get(current);
if (dependents) {
for (const dependent of dependents) {
if (!affectedNames.has(dependent)) {
affectedNames.add(dependent);
queue.push(dependent);
}
}
}
}
return allPackages.filter((p) => affectedNames.has(p.name));
}
/**
* 拓扑排序:被依赖的包先发布
*/
private topologicalSort(packages: PackageInfo[], _allPackages: PackageInfo[]): PackageInfo[] {
const packageNames = new Set(packages.map((p) => p.name));
const nameToPackage = new Map(packages.map((p) => [p.name, p]));
// 构建依赖图(只考虑待发布包之间的依赖)
const inDegree = new Map<string, number>();
const graph = new Map<string, string[]>();
for (const pkg of packages) {
inDegree.set(pkg.name, 0);
graph.set(pkg.name, []);
}
for (const pkg of packages) {
for (const dep of pkg.workspaceDeps) {
if (packageNames.has(dep)) {
graph.get(dep)!.push(pkg.name);
inDegree.set(pkg.name, (inDegree.get(pkg.name) || 0) + 1);
}
}
}
// Kahn's algorithm
const queue: string[] = [];
for (const [name, degree] of inDegree) {
if (degree === 0) {
queue.push(name);
}
}
const sorted: PackageInfo[] = [];
while (queue.length > 0) {
const current = queue.shift()!;
sorted.push(nameToPackage.get(current)!);
for (const neighbor of graph.get(current) || []) {
const newDegree = (inDegree.get(neighbor) || 0) - 1;
inDegree.set(neighbor, newDegree);
if (newDegree === 0) {
queue.push(neighbor);
}
}
}
if (sorted.length !== packages.length) {
throw new Error("检测到循环依赖,无法确定发布顺序");
}
return sorted;
}
}

View File

@@ -0,0 +1,71 @@
import { Command, CommandRunner, Option } from "nest-commander";
import { t } from "@spaceflow/core";
import { PublishService } from "./publish.service";
export interface PublishOptions {
dryRun: boolean;
ci: boolean;
prerelease?: string;
/** 预演模式:执行 hooks 但不修改文件/git */
rehearsal: boolean;
}
@Command({
name: "publish",
description: t("publish:description"),
})
export class PublishCommand extends CommandRunner {
constructor(protected readonly publishService: PublishService) {
super();
}
async run(_passedParams: string[], options: PublishOptions): Promise<void> {
if (options.rehearsal) {
console.log(t("publish:rehearsalMode"));
} else if (options.dryRun) {
console.log(t("publish:dryRunMode"));
}
try {
const context = this.publishService.getContextFromEnv(options);
await this.publishService.execute(context);
} catch (error) {
console.error(
t("common.executionFailed", { error: error instanceof Error ? error.message : error }),
);
process.exit(1);
}
}
@Option({
flags: "-d, --dry-run",
description: t("common.options.dryRun"),
})
parseDryRun(val: boolean): boolean {
return val;
}
@Option({
flags: "-c, --ci",
description: t("common.options.ci"),
})
parseCi(val: boolean): boolean {
return val;
}
@Option({
flags: "-p, --prerelease <tag>",
description: t("publish:options.prerelease"),
})
parsePrerelease(val: string): string {
return val;
}
@Option({
flags: "-r, --rehearsal",
description: t("publish:options.rehearsal"),
})
parseRehearsal(val: boolean): boolean {
return val;
}
}

View File

@@ -0,0 +1,90 @@
import { z } from "@spaceflow/core";
/** publish 命令配置 schema */
export const publishSchema = z.object({
/** monorepo 发布模式配置 */
monorepo: z
.object({
/** 是否启用 monorepo 发布模式 */
enabled: z.boolean().default(false),
/** 是否传递依赖变更(依赖的包变更时,依赖方也发布) */
propagateDeps: z.boolean().default(true),
})
.optional(),
changelog: z
.object({
/** changelog 文件输出目录 */
infileDir: z.string().default(".").optional(),
preset: z
.object({
/** preset 名称,默认 conventionalcommits */
name: z.string().default("conventionalcommits").optional(),
/** commit type 到 section 的映射 */
type: z
.array(
z.object({
type: z.string(),
section: z.string(),
}),
)
.default([]),
})
.optional(),
})
.optional(),
/** npm 发布配置 */
npm: z
.object({
/** 是否发布到 npm registry */
publish: z.boolean().default(false),
/** 包管理器npm 或 pnpm */
packageManager: z.enum(["npm", "pnpm"]).default("npm"),
/** npm registry 地址 */
registry: z.string().optional(),
/** npm tag如 latest、beta、next */
tag: z.string().default("latest"),
/** 是否忽略 package.json 中的版本号 */
ignoreVersion: z.boolean().default(true),
/** npm version 命令额外参数 */
versionArgs: z.array(z.string()).default(["--workspaces false"]),
/** npm/pnpm publish 命令额外参数 */
publishArgs: z.array(z.string()).default([]),
})
.optional(),
release: z
.object({
host: z.string().default("localhost"),
assetSourcemap: z
.object({
path: z.string(),
name: z.string(),
})
.optional(),
assets: z
.array(
z.object({
path: z.string(),
name: z.string(),
type: z.string(),
}),
)
.default([]),
})
.optional(),
/** git 配置 */
git: z
.object({
/** 允许发布的分支列表 */
requireBranch: z.array(z.string()).default(["main", "dev", "develop"]),
/** 分支锁定时允许推送的用户名白名单(如 CI 机器人) */
pushWhitelistUsernames: z.array(z.string()).default([]),
/** 是否在发布时锁定分支 */
lockBranch: z.boolean().default(true),
})
.optional(),
/** release-it hooks 配置,如 before:bump, after:bump 等 */
hooks: z.record(z.string(), z.union([z.string(), z.array(z.string())])).optional(),
});
/** publish 配置类型(从 schema 推导) */
export type PublishConfig = z.infer<typeof publishSchema>;

View File

@@ -0,0 +1,12 @@
import { Module } from "@nestjs/common";
import { ConfigModule } from "@nestjs/config";
import { GitProviderModule, ConfigReaderModule, ciConfig } from "@spaceflow/core";
import { PublishCommand } from "./publish.command";
import { PublishService } from "./publish.service";
import { MonorepoService } from "./monorepo.service";
@Module({
imports: [ConfigModule.forFeature(ciConfig), GitProviderModule.forFeature(), ConfigReaderModule],
providers: [PublishCommand, PublishService, MonorepoService],
})
export class PublishModule {}

View File

@@ -0,0 +1,602 @@
import { Injectable } from "@nestjs/common";
import { ConfigService } from "@nestjs/config";
import {
GitProviderService,
ConfigReaderService,
type BranchProtection,
type CiConfig,
} from "@spaceflow/core";
import { type PublishConfig } from "./publish.config";
import { MonorepoService, type PackageInfo } from "./monorepo.service";
import type { Config } from "release-it";
import { join } from "path";
import { execSync } from "child_process";
// eslint-disable-next-line @typescript-eslint/no-require-imports
const releaseItModule = require("release-it") as
| { default: (opts: Config & Record<string, unknown>) => Promise<void> }
| ((opts: Config & Record<string, unknown>) => Promise<void>);
const releaseIt = typeof releaseItModule === "function" ? releaseItModule : releaseItModule.default;
import type { PublishOptions } from "./publish.command";
export interface PublishContext extends PublishOptions {
owner: string;
repo: string;
branch: string;
}
export interface PublishResult {
success: boolean;
message: string;
protection?: BranchProtection | null;
}
interface ReleaseItConfigOptions {
dryRun: boolean;
prerelease?: string;
ci: boolean;
/** 预演模式:执行 hooks 但不修改文件/git */
rehearsal: boolean;
/** 包目录monorepo 模式)或 "."(单包模式) */
pkgDir: string;
/** 包名称monorepo 模式)或 undefined单包模式 */
pkgName?: string;
/** package.json 所在目录的名称,只有最后一节 */
pkgBase: string;
publishConf: PublishConfig;
}
@Injectable()
export class PublishService {
private cleanupOnExit: (() => void) | null = null;
private uncaughtExceptionHandler: ((err: Error) => void) | null = null;
private branchUnlocked = false;
constructor(
protected readonly gitProvider: GitProviderService,
protected readonly configService: ConfigService,
protected readonly configReader: ConfigReaderService,
protected readonly monorepoService: MonorepoService,
) {}
getContextFromEnv(options: PublishOptions): PublishContext {
this.gitProvider.validateConfig();
const ciConf = this.configService.get<CiConfig>("ci");
const repository = ciConf?.repository;
const branch = ciConf?.refName;
if (!repository) {
throw new Error("缺少配置 ci.repository (环境变量 GITHUB_REPOSITORY)");
}
if (!branch) {
throw new Error("缺少配置 ci.refName (环境变量 GITHUB_REF_NAME)");
}
const [owner, repo] = repository.split("/");
if (!owner || !repo) {
throw new Error(`ci.repository 格式不正确,期望 "owner/repo",实际: "${repository}"`);
}
return {
owner,
repo,
branch,
dryRun: options.dryRun ?? false,
prerelease: options.prerelease,
ci: options.ci,
rehearsal: options.rehearsal ?? false,
};
}
async execute(context: PublishContext): Promise<PublishResult> {
const publishConf = this.configReader.getPluginConfig<PublishConfig>("publish");
const monorepoConf = publishConf.monorepo;
// CI 环境下自动 fetch tags确保 release-it 能正确计算版本
if (context.ci) {
await this.ensureTagsFetched();
}
// 检查是否启用 monorepo 模式
if (monorepoConf?.enabled) {
return this.executeMonorepo(context, publishConf);
}
// 单包发布模式
return this.executeSinglePackage(context, publishConf);
}
/**
* Monorepo 发布模式:扫描变更包,按依赖顺序发布
*/
private async executeMonorepo(
context: PublishContext,
publishConf: PublishConfig,
): Promise<PublishResult> {
const { dryRun } = context;
console.log("\n📦 Monorepo 发布模式");
console.log("=".repeat(50));
const propagateDeps = publishConf.monorepo?.propagateDeps ?? true;
// 分析变更包
const analysis = await this.monorepoService.analyze(dryRun, propagateDeps);
if (analysis.packagesToPublish.length === 0) {
console.log("\n✅ 没有需要发布的包");
return { success: true, message: "没有需要发布的包" };
}
console.log(`\n🚀 将发布 ${analysis.packagesToPublish.length} 个包`);
await this.handleBegin(context, publishConf);
try {
// 按顺序发布每个包
for (let i = 0; i < analysis.packagesToPublish.length; i++) {
const pkg = analysis.packagesToPublish[i];
console.log(`\n[${i + 1}/${analysis.packagesToPublish.length}] 发布 ${pkg.name}`);
console.log("-".repeat(40));
await this.executePackageRelease(context, publishConf, pkg);
}
await this.handleEnd(context, publishConf);
return {
success: true,
message: `成功发布 ${analysis.packagesToPublish.length} 个包`,
};
} catch (error) {
console.error("\n❌ Monorepo 发布失败:", error instanceof Error ? error.message : error);
try {
await this.handleEnd(context, publishConf);
} catch (unlockError) {
console.error(
"⚠️ 解锁分支失败:",
unlockError instanceof Error ? unlockError.message : unlockError,
);
}
return { success: false, message: "Monorepo 发布失败" };
}
}
/**
* 发布单个包monorepo 模式)
*/
private async executePackageRelease(
context: PublishContext,
publishConf: PublishConfig,
pkg: PackageInfo,
): Promise<void> {
const { dryRun, prerelease, ci, rehearsal } = context;
if (rehearsal) {
console.log(`🎭 [REHEARSAL] 将发布包: ${pkg.name} (${pkg.dir})`);
} else if (dryRun) {
console.log(`🔍 [DRY-RUN] 将发布包: ${pkg.name} (${pkg.dir})`);
}
const pkgDir = join(process.cwd(), pkg.dir);
const originalCwd = process.cwd();
const config = this.buildReleaseItConfig({
dryRun,
prerelease,
ci,
rehearsal,
pkgDir,
pkgName: pkg.name,
pkgBase: pkg.dir.split("/").pop() || pkg.dir,
publishConf,
});
// 切换到包目录运行 release-it确保读取正确的 package.json
process.chdir(pkgDir);
try {
await releaseIt(config);
console.log(`${pkg.name} 发布完成`);
} finally {
// 恢复原工作目录
process.chdir(originalCwd);
}
}
/**
* 单包发布模式
*/
private async executeSinglePackage(
context: PublishContext,
publishConf: PublishConfig,
): Promise<PublishResult> {
const { dryRun, prerelease, ci, rehearsal } = context;
await this.handleBegin(context, publishConf);
try {
const config = this.buildReleaseItConfig({
dryRun,
prerelease,
ci,
rehearsal,
pkgDir: process.cwd(),
pkgBase: process.cwd().split("/").pop() || ".",
publishConf,
});
await releaseIt(config);
} catch (error) {
console.error("执行失败:", error instanceof Error ? error.message : error);
try {
await this.handleEnd(context, publishConf);
} catch (unlockError) {
console.error(
"⚠️ 解锁分支失败:",
unlockError instanceof Error ? unlockError.message : unlockError,
);
}
return { success: false, message: "执行失败" };
}
await this.handleEnd(context, publishConf);
return { success: true, message: "执行完成", protection: null };
}
/**
* 构建 release-it 配置(公共方法)
*/
private buildReleaseItConfig(opts: ReleaseItConfigOptions): Config & Record<string, unknown> {
const { dryRun, prerelease, ci, rehearsal, pkgName, pkgBase, publishConf } = opts;
const changelogConf = publishConf.changelog;
const releaseConf = publishConf.release;
const npmConf = publishConf.npm;
const gitConf = publishConf.git;
// 预演模式设置环境变量hooks 可以通过它判断当前模式
if (rehearsal) {
process.env.PUBLISH_REHEARSAL = "true";
}
const isMonorepo = !!pkgName;
const tagMatchOpts = !prerelease ? { tagExclude: `*[-]*` } : {};
// monorepo: @scope/pkg@1.0.0, 单包: v1.0.0
const tagPrefix = isMonorepo ? `${pkgName}@` : "v";
const tagName = isMonorepo ? `${pkgName}@\${version}` : "v${version}";
const releaseName = isMonorepo ? `${pkgName}@\${version}` : "v${version}";
const releaseTitle = isMonorepo ? `🎉 ${pkgName}@\${version}` : "🎉 v${version}";
// monorepo 模式下在包目录运行git commitsPath 为 "."
const commitsPath = ".";
const commitMessage = isMonorepo
? `chore(${pkgBase}): released version \${version} [no ci]`
: "chore: released version v${version} [no ci]";
// 预演模式:禁用文件/git 修改,但保留 hooks
// dryRun 模式:完全跳过所有操作(包括 hooks
const skipWrite = dryRun || rehearsal;
return {
"dry-run": dryRun,
d: dryRun,
ci: ci || dryRun, // dry-run 模式也启用 ci 模式,避免交互式提示
plugins: {
// 预演模式下禁用 changelog 写入
...(!skipWrite && changelogConf
? {
"@release-it/conventional-changelog": {
// 现在在包目录下运行,使用相对路径
infile: join(
changelogConf.infileDir || ".",
`CHANGELOG${!prerelease ? "" : "-" + prerelease.toUpperCase()}.md`,
),
preset: {
name: changelogConf.preset?.name || "conventionalcommits",
types: changelogConf.preset?.type || [],
},
},
}
: {}),
// 预演模式下禁用 release 创建
...(!skipWrite && releaseConf
? {
"release-it-gitea": {
releaseTitle,
releaseNotes: this.formatReleaseNotes,
assets: this.buildReleaseAssets(releaseConf),
},
}
: {}),
},
git: {
// 预演模式:禁用 push/commit/tag
push: !skipWrite,
commit: !skipWrite,
tag: !skipWrite,
tagName,
commitsPath,
commitMessage,
requireCommits: false,
requireCommitsFail: false,
getLatestTagFromAllRefs: true,
requireBranch: (gitConf?.requireBranch ?? ["main", "dev", "develop"]) as any,
requireCleanWorkingDir: !skipWrite,
...(isMonorepo ? { tagMatch: `${tagPrefix}*` } : {}),
...tagMatchOpts,
},
// 预演模式:禁用 npm
// 如果使用 pnpm禁用内置 npm 发布,但保留版本更新功能
npm: skipWrite
? (false as any)
: {
// pnpm 模式:禁用 publish通过 hooks 实现),但保留版本更新
publish: npmConf?.packageManager === "pnpm" ? false : (npmConf?.publish ?? false),
ignoreVersion: npmConf?.ignoreVersion ?? true,
tag: prerelease || npmConf?.tag || "latest",
versionArgs: npmConf?.versionArgs ?? ["--workspaces false"],
publishArgs: npmConf?.publishArgs ?? [],
...(npmConf?.registry ? { publishConfig: { registry: npmConf.registry } } : {}),
},
github: {
release: false,
releaseName: `Release ${releaseName}`,
autoGenerate: true,
skipChecks: true,
host: releaseConf?.host || "localhost",
},
// 合并用户 hooks 和内部 pnpm 发布 hook
hooks: this.buildHooks({
userHooks: publishConf.hooks,
npmConf,
prerelease,
skipWrite,
dryRun,
rehearsal,
}),
};
}
/**
* 格式化 release notes
*/
private formatReleaseNotes(t: { changelog: string }): string {
const lines = t.changelog.split("\n");
const cateLines = lines.filter(
(line: string) => line.startsWith("###") || line.startsWith("* "),
);
const cateMap: Record<string, string[]> = {};
let currentCate = "";
cateLines.forEach((line: string) => {
if (line.startsWith("###")) {
currentCate = line;
cateMap[currentCate] = cateMap[currentCate] || [];
} else {
cateMap[currentCate].push(line);
}
});
return Object.entries(cateMap)
.map(([cate, catLines]) => `${cate}\n\n${catLines.join("\n")}\n`)
.join("\n");
}
/**
* 构建 release assets 配置
*/
private buildReleaseAssets(releaseConf: NonNullable<PublishConfig["release"]>) {
const assets = releaseConf.assetSourcemap
? [
{
path: releaseConf.assetSourcemap.path,
name: releaseConf.assetSourcemap.name,
type: "zip",
},
]
: [];
return assets.concat(releaseConf.assets || []);
}
/**
* 构建 hooks 配置,合并用户 hooks 和内部 pnpm 发布逻辑
*/
private buildHooks(opts: {
userHooks?: Record<string, string | string[]>;
npmConf?: PublishConfig["npm"];
prerelease?: string;
skipWrite: boolean;
dryRun: boolean;
rehearsal: boolean;
}): Record<string, string | string[]> | undefined {
const { userHooks, npmConf, prerelease, skipWrite, dryRun, rehearsal } = opts;
// dryRun 模式下不执行任何 hooks
if (dryRun && !rehearsal) {
return undefined;
}
// 复制用户 hooks
let hooks: Record<string, string | string[]> = { ...userHooks };
// rehearsal 模式下过滤 after 前缀的 hooks不执行实际的发布后操作
if (rehearsal) {
hooks = Object.fromEntries(
Object.entries(hooks).filter(([key]) => !key.startsWith("after:")),
);
// rehearsal 模式下也不添加 pnpm publish
return Object.keys(hooks).length > 0 ? hooks : undefined;
}
// 如果使用 pnpm 且需要发布
if (npmConf?.packageManager === "pnpm" && npmConf?.publish && !skipWrite) {
const tag = prerelease || npmConf.tag || "latest";
const publishArgs = npmConf.publishArgs ?? [];
const registry = npmConf.registry;
// 构建 pnpm publish 命令
// monorepo 模式下已切换到包目录,不需要 -C 参数
let publishCmd = `pnpm publish --tag ${tag} --no-git-checks`;
if (registry) {
publishCmd += ` --registry ${registry}`;
}
if (publishArgs.length > 0) {
publishCmd += ` ${publishArgs.join(" ")}`;
}
// 合并到 after:bump hook
const existingAfterBump = hooks["after:bump"];
if (existingAfterBump) {
hooks["after:bump"] = Array.isArray(existingAfterBump)
? [...existingAfterBump, publishCmd]
: [existingAfterBump, publishCmd];
} else {
hooks["after:bump"] = publishCmd;
}
}
return Object.keys(hooks).length > 0 ? hooks : undefined;
}
protected async handleBegin(
context: PublishContext,
publishConf: PublishConfig,
): Promise<PublishResult> {
const { owner, repo, branch, dryRun } = context;
const shouldLockBranch = publishConf.git?.lockBranch ?? true;
if (!shouldLockBranch) {
console.log(`⏭️ 跳过分支锁定(已禁用)`);
return { success: true, message: "分支锁定已禁用", protection: null };
}
const pushWhitelistUsernames = [...(publishConf.git?.pushWhitelistUsernames ?? [])];
if (dryRun) {
console.log(`🔍 [DRY-RUN] 将锁定分支: ${owner}/${repo}#${branch}`);
return { success: true, message: "DRY-RUN: 分支锁定已跳过", protection: null };
}
console.log(`🔒 正在锁定分支: ${owner}/${repo}#${branch}`);
const protection = await this.gitProvider.lockBranch(owner, repo, branch, {
pushWhitelistUsernames,
});
console.log(`✅ 分支已锁定`);
console.log(` 规则名称: ${protection.rule_name || protection.branch_name}`);
if (pushWhitelistUsernames?.length) {
console.log(` 允许推送用户: ${pushWhitelistUsernames.join(", ")}`);
} else {
console.log(` 允许推送: ${protection.enable_push ? "是" : "否"}`);
}
// 注册进程退出时的清理函数,确保即使 release-it 调用 process.exit() 也能解锁分支
this.branchUnlocked = false;
this.cleanupOnExit = () => {
if (this.branchUnlocked) return;
this.branchUnlocked = true;
console.log("\n🔓 进程退出,正在同步解锁分支...");
try {
this.unlockBranchSync(context, publishConf);
} catch (e) {
console.error("⚠️ 同步解锁分支失败:", e instanceof Error ? e.message : e);
}
};
this.uncaughtExceptionHandler = (err: Error) => {
console.error("\n❌ 未捕获的异常:", err.message);
if (this.cleanupOnExit) this.cleanupOnExit();
process.exit(1);
};
process.on("exit", this.cleanupOnExit);
process.on("SIGINT", this.cleanupOnExit);
process.on("SIGTERM", this.cleanupOnExit);
process.on("uncaughtException", this.uncaughtExceptionHandler);
return { success: true, message: "分支锁定完成", protection };
}
protected async handleEnd(
context: PublishContext,
publishConf: PublishConfig,
): Promise<PublishResult> {
const { owner, repo, branch, dryRun } = context;
const shouldLockBranch = publishConf.git?.lockBranch ?? true;
if (!shouldLockBranch) {
return { success: true, message: "分支锁定已禁用,无需解锁", protection: null };
}
if (dryRun) {
console.log(`🔍 [DRY-RUN] 将解锁分支: ${owner}/${repo}#${branch}`);
return { success: true, message: "DRY-RUN: 分支解锁已跳过", protection: null };
}
console.log(`🔓 正在解锁分支: ${owner}/${repo}#${branch}`);
const protection = await this.gitProvider.unlockBranch(owner, repo, branch);
// 标记已解锁,防止清理函数重复执行
this.branchUnlocked = true;
// 移除事件监听器
if (this.cleanupOnExit) {
process.removeListener("exit", this.cleanupOnExit);
process.removeListener("SIGINT", this.cleanupOnExit);
process.removeListener("SIGTERM", this.cleanupOnExit);
this.cleanupOnExit = null;
}
if (this.uncaughtExceptionHandler) {
process.removeListener("uncaughtException", this.uncaughtExceptionHandler);
this.uncaughtExceptionHandler = null;
}
if (protection) {
console.log(`✅ 分支已解锁`);
console.log(` 规则名称: ${protection.rule_name || protection.branch_name}`);
console.log(` 允许推送: ${protection.enable_push ? "是" : "否"}`);
return { success: true, message: "分支解锁完成", protection };
} else {
console.log(`✅ 分支本身没有保护规则,无需解锁`);
return { success: true, message: "分支本身没有保护规则,无需解锁", protection: null };
}
}
/**
* 同步解锁分支(用于进程退出时的清理)
*/
private unlockBranchSync(context: PublishContext, publishConf: PublishConfig): void {
const { owner, repo, branch, dryRun } = context;
const shouldLockBranch = publishConf.git?.lockBranch ?? true;
if (!shouldLockBranch || dryRun) {
return;
}
this.gitProvider.unlockBranchSync(owner, repo, branch);
}
/**
* 确保 git tags 已获取CI 环境中 shallow clone 可能缺失 tags
* 这对于 release-it 正确计算版本号至关重要
*/
private async ensureTagsFetched(): Promise<void> {
try {
// 检查是否有 tags
const existingTags = execSync("git tag --list 2>/dev/null || echo ''", {
encoding: "utf-8",
}).trim();
if (!existingTags) {
console.log("🏷️ 正在获取 git tags...");
execSync("git fetch --tags --force", { stdio: "inherit" });
console.log("✅ Git tags 已获取");
}
} catch (error) {
console.warn("⚠️ 获取 git tags 失败:", error instanceof Error ? error.message : error);
console.warn(
" 版本计算可能不准确,建议在 CI checkout 时添加 fetch-depth: 0 和 fetch-tags: true",
);
}
}
}

View File

@@ -0,0 +1,5 @@
{
"extends": "../../core/tsconfig.skill.json",
"include": ["src/**/*"],
"exclude": ["node_modules", "dist"]
}