chore: 初始化仓库

2026-03-11 19:52:45 +08:00 · 2026-02-15 22:02:21 +08:00
commit 08d011d63f
381 changed files with 87202 additions and 0 deletions
--- a/commands/period-summary/CHANGELOG.md
+++ b/commands/period-summary/CHANGELOG.md
@@ -0,0 +1,491 @@
+# Changelog
+
+## [0.19.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.18.0...@spaceflow/period-summary@0.19.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))
+* **publish:** released version 0.20.0 [no ci] ([d347e3b](https://git.bjxgj.com/xgj/spaceflow/commit/d347e3b2041157d8dc6e3ade69b05a481b2ab371))
+* **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.18.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.17.0...@spaceflow/period-summary@0.18.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))
+* **publish:** released version 0.19.0 [no ci] ([7a96bca](https://git.bjxgj.com/xgj/spaceflow/commit/7a96bca945434a99f7d051a38cb31adfd2ade5d2))
+* **review:** released version 0.27.0 [no ci] ([ac3fc5a](https://git.bjxgj.com/xgj/spaceflow/commit/ac3fc5a5d7317d537d0447e05a61bef15a1accbe))
+
+## [0.17.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.16.0...@spaceflow/period-summary@0.17.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))
+- **publish:** released version 0.18.0 [no ci] ([2f2ce01](https://git.bjxgj.com/xgj/spaceflow/commit/2f2ce01726f7b3e4387e23a17974b58acd3e6929))
+- **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.16.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.15.0...@spaceflow/period-summary@0.16.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))
+- **publish:** released version 0.17.0 [no ci] ([8e0d065](https://git.bjxgj.com/xgj/spaceflow/commit/8e0d0654040d6af7e99fa013a8255aa93acbcc3a))
+- **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.15.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.14.0...@spaceflow/period-summary@0.15.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))
+- **publish:** released version 0.16.0 [no ci] ([e31e46d](https://git.bjxgj.com/xgj/spaceflow/commit/e31e46d08fccb10a42b6579fa042aa6c57d79c8a))
+- **review:** released version 0.18.0 [no ci] ([d366e3f](https://git.bjxgj.com/xgj/spaceflow/commit/d366e3fa9c1b32369a3d98e56fc873e033d71d00))
+
+## [0.14.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.13.0...@spaceflow/period-summary@0.14.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))
+- **publish:** released version 0.15.0 [no ci] ([4b09122](https://git.bjxgj.com/xgj/spaceflow/commit/4b091227265a57f0a05488749eb4852fb421a06e))
+- **review:** released version 0.17.0 [no ci] ([9f25412](https://git.bjxgj.com/xgj/spaceflow/commit/9f254121557ae238e32f4093b0c8b5dd8a4b9a72))
+
+## [0.13.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.12.0...@spaceflow/period-summary@0.13.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))
+- **publish:** released version 0.14.0 [no ci] ([fe0e140](https://git.bjxgj.com/xgj/spaceflow/commit/fe0e14058a364362d7d218da9b34dbb5d8fb8f42))
+- **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.12.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.11.0...@spaceflow/period-summary@0.12.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))
+- **publish:** released version 0.13.0 [no ci] ([1d308d9](https://git.bjxgj.com/xgj/spaceflow/commit/1d308d9e32c50902dd881144ff541204d368006f))
+- **review:** released version 0.12.0 [no ci] ([3da605e](https://git.bjxgj.com/xgj/spaceflow/commit/3da605ea103192070f1c63112ad896a33fbc4312))
+
+## [0.11.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.10.0...@spaceflow/period-summary@0.11.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))
+- **publish:** released version 0.12.0 [no ci] ([50e209e](https://git.bjxgj.com/xgj/spaceflow/commit/50e209ebc57504462ed192a0fe22f6f944165fa3))
+- **review:** released version 0.11.0 [no ci] ([150cd9d](https://git.bjxgj.com/xgj/spaceflow/commit/150cd9df7d380c26e6f3f7f0dfd027022f610e6e))
+
+## [0.10.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.9.0...@spaceflow/period-summary@0.10.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))
+- **publish:** released version 0.11.0 [no ci] ([df17cd1](https://git.bjxgj.com/xgj/spaceflow/commit/df17cd1250c8fd8a035eb073d292885a4b1e3322))
+- **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.9.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.8.0...@spaceflow/period-summary@0.9.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))
+- **publish:** released version 0.10.0 [no ci] ([8722ba9](https://git.bjxgj.com/xgj/spaceflow/commit/8722ba9eddb03c2f73539f4e09c504ed9491a5eb))
+- **review:** released version 0.8.0 [no ci] ([ec6e7e5](https://git.bjxgj.com/xgj/spaceflow/commit/ec6e7e5defd2a5a6349d3530f3b0f4732dd5bb62))
+
+## [0.8.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.7.0...@spaceflow/period-summary@0.8.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))
+- **publish:** released version 0.9.0 [no ci] ([b404930](https://git.bjxgj.com/xgj/spaceflow/commit/b40493049877c1fd3554d77a14e9bd9ab318e15a))
+- **review:** released version 0.7.0 [no ci] ([1d195d7](https://git.bjxgj.com/xgj/spaceflow/commit/1d195d74685f12edf3b1f4e13b58ccc3d221fd94))
+
+## [0.7.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.6.0...@spaceflow/period-summary@0.7.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))
+- **publish:** released version 0.8.0 [no ci] ([d7cd2e9](https://git.bjxgj.com/xgj/spaceflow/commit/d7cd2e9a7af178acdf91f16ae299c82e915db6e6))
+- **review:** released version 0.6.0 [no ci] ([48a90b2](https://git.bjxgj.com/xgj/spaceflow/commit/48a90b253dbe03f46d26bb88f3e0158193aa1dba))
+
+## [0.6.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.5.0...@spaceflow/period-summary@0.6.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))
+- **publish:** released version 0.7.0 [no ci] ([7124435](https://git.bjxgj.com/xgj/spaceflow/commit/712443516845f5bbc097af16ec6e90bb57b69fa3))
+- **review:** released version 0.5.0 [no ci] ([93c3088](https://git.bjxgj.com/xgj/spaceflow/commit/93c308887040f39047766a789a37d24ac6146359))
+
+## [0.5.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.4.0...@spaceflow/period-summary@0.5.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))
+- **publish:** released version 0.6.0 [no ci] ([b6d8d09](https://git.bjxgj.com/xgj/spaceflow/commit/b6d8d099fc439ce67f802d56e30dadaa28afed0e))
+- **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.4.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.3.0...@spaceflow/period-summary@0.4.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))
+- **publish:** released version 0.5.0 [no ci] ([8eecd19](https://git.bjxgj.com/xgj/spaceflow/commit/8eecd19c4dd3fbaa27187a9b24234e753fff5efe))
+- **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.3.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.2.0...@spaceflow/period-summary@0.3.0) (2026-01-28)
+
+### 代码重构
+
+- **publish:** 调整包变更检测的日志输出格式 ([df35e92](https://git.bjxgj.com/xgj/spaceflow/commit/df35e92d614ce59e202643cf34a0fef2803412a1))
+
+### 其他修改
+
+- **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))
+- **publish:** released version 0.3.0 [no ci] ([972eca4](https://git.bjxgj.com/xgj/spaceflow/commit/972eca440dd333e8c5380124497c16fe6e3eea6c))
+- **publish:** released version 0.4.0 [no ci] ([be66220](https://git.bjxgj.com/xgj/spaceflow/commit/be662202c1e9e509368eb683a0d6df3afd876ff8))
+- **review:** released version 0.2.0 [no ci] ([d0bd3ed](https://git.bjxgj.com/xgj/spaceflow/commit/d0bd3edf364dedc7c077d95801b402d41c3fdd9c))
+- 调整项目依赖配置 ([f4009cb](https://git.bjxgj.com/xgj/spaceflow/commit/f4009cb0c369b225c356584afb28a7ff5a1a89ec))
+
+## [0.2.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.1.2...@spaceflow/period-summary@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))
+
+### 文档更新
+
+- **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))
+- **publish:** released version 0.1.2 [no ci] ([4786731](https://git.bjxgj.com/xgj/spaceflow/commit/4786731da7a21982dc1e912b1a5002f5ebba9104))
+- **publish:** released version 0.2.0 [no ci] ([bc30a82](https://git.bjxgj.com/xgj/spaceflow/commit/bc30a82082bba4cc1a66c74c11dc0ad9deef4692))
+- **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/period-summary@0.1.1...@spaceflow/period-summary@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))
+
+## [0.1.1](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.1.0...@spaceflow/period-summary@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))
+
+## [0.1.0](https://git.bjxgj.com/xgj/spaceflow/compare/@spaceflow/period-summary@0.0.1...@spaceflow/period-summary@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))
+
+## 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))
+- 重置所有包版本至 0.0.0 并清理 CHANGELOG 文件 ([f7efaf9](https://git.bjxgj.com/xgj/spaceflow/commit/f7efaf967467f1272e05d645720ee63941fe79be))
--- a/commands/period-summary/README.md
+++ b/commands/period-summary/README.md
@@ -0,0 +1,27 @@
+# @spaceflow/period-summary
+
+Spaceflow 周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序。
+
+## 功能特性
+
+- **时间范围统计**：支持自定义日期范围或预设时间段
+- **多维度统计**：PR 数量、代码行数、变更文件数、问题数量
+- **综合评分**：根据代码量和问题数量权衡计算分数
+- **按人员排序**：按综合分数降序排列贡献者
+- **多种输出方式**：控制台、GitHub Issue、Markdown 文件
+
+## 使用方法
+
+```bash
+# 使用时间预设 - 统计本周
+spaceflow period-summary -p this-week
+
+# 使用时间预设 - 统计上月
+spaceflow period-summary -p last-month
+
+# 自定义日期范围
+spaceflow period-summary -s 2026-01-01 -u 2026-01-18
+
+# 输出到 GitHub Issue
+spaceflow period-summary -p last-week -o issue -c
+```
--- a/commands/period-summary/package.json
+++ b/commands/period-summary/package.json
@@ -0,0 +1,25 @@
+{
+  "name": "@spaceflow/period-summary",
+  "version": "0.19.0",
+  "description": "Spaceflow 周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序",
+  "type": "module",
+  "main": "./dist/index.js",
+  "scripts": {
+    "build": "spaceflow build",
+    "dev": "spaceflow dev"
+  },
+  "devDependencies": {
+    "@spaceflow/cli": "workspace:*",
+    "@types/node": "catalog:"
+  },
+  "peerDependencies": {
+    "@nestjs/common": "catalog:",
+    "@nestjs/config": "catalog:",
+    "@spaceflow/core": "workspace:*",
+    "nest-commander": "catalog:"
+  },
+  "spaceflow": {
+    "type": "flow",
+    "entry": "."
+  }
+}
--- a/commands/period-summary/src/index.ts
+++ b/commands/period-summary/src/index.ts
@@ -0,0 +1,25 @@
+import "./locales";
+import { SpaceflowExtension, SpaceflowExtensionMetadata, t } from "@spaceflow/core";
+import { PeriodSummaryModule } from "./period-summary.module";
+export class PeriodSummaryExtension implements SpaceflowExtension {
+  getMetadata(): SpaceflowExtensionMetadata {
+    return {
+      name: "period-summary",
+      commands: ["period-summary"],
+      configKey: "period-summary",
+      version: "1.0.0",
+      description: t("period-summary:extensionDescription"),
+    };
+  }
+
+  getModule() {
+    return PeriodSummaryModule;
+  }
+}
+
+export default PeriodSummaryExtension;
+
+export * from "./period-summary.command";
+export * from "./period-summary.service";
+export * from "./period-summary.module";
+export * from "./types";
--- a/commands/period-summary/src/locales/en/period-summary.json
+++ b/commands/period-summary/src/locales/en/period-summary.json
@@ -0,0 +1,13 @@
+{
+  "description": "Period summary - aggregate PR contributions by time range, grouped by author",
+  "options.preset": "Time preset: this-week, last-week, this-month, last-month, last-7-days, last-15-days, last-30-days",
+  "options.since": "Start date (YYYY-MM-DD format), alternative to --preset",
+  "options.until": "End date (YYYY-MM-DD format), defaults to today",
+  "options.repository": "Repository path (owner/repo format), auto-detected from env by default",
+  "options.format": "Output format: table, json, markdown",
+  "options.output": "Output target: console, issue (create GitHub Issue), file (Markdown file)",
+  "options.outputFile": "Output file path (used when --output is file)",
+  "options.verbose": "Verbose log level (1: process logs, 2: detailed logs)",
+  "reportOutput": "✅ Report output to: {{location}}",
+  "extensionDescription": "Period summary - aggregate PR contributions by time range, grouped by author"
+}
--- a/commands/period-summary/src/locales/index.ts
+++ b/commands/period-summary/src/locales/index.ts
@@ -0,0 +1,11 @@
+import { addLocaleResources } from "@spaceflow/core";
+import zhCN from "./zh-cn/period-summary.json";
+import en from "./en/period-summary.json";
+
+/** period-summary 命令 i18n 资源 */
+export const periodSummaryLocales: Record<string, Record<string, string>> = {
+  "zh-CN": zhCN,
+  en,
+};
+
+addLocaleResources("period-summary", periodSummaryLocales);
--- a/commands/period-summary/src/locales/zh-cn/period-summary.json
+++ b/commands/period-summary/src/locales/zh-cn/period-summary.json
@@ -0,0 +1,13 @@
+{
+  "description": "周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序",
+  "options.preset": "时间预设: this-week(本周), last-week(上周), this-month(本月), last-month(上月), last-7-days, last-15-days, last-30-days",
+  "options.since": "开始日期 (YYYY-MM-DD 格式)，与 --preset 二选一",
+  "options.until": "结束日期 (YYYY-MM-DD 格式)，默认为今天",
+  "options.repository": "仓库路径 (owner/repo 格式)，默认从环境变量获取",
+  "options.format": "输出格式: table, json, markdown",
+  "options.output": "输出目标: console(控制台), issue(创建 GitHub Issue), file(Markdown 文件)",
+  "options.outputFile": "输出文件路径（当 --output 为 file 时使用）",
+  "options.verbose": "详细日志级别 (1: 过程日志, 2: 详细日志)",
+  "reportOutput": "✅ 报告已输出到: {{location}}",
+  "extensionDescription": "周期统计命令，根据时间范围统计 PR 贡献情况，按人员汇总并排序"
+}
--- a/commands/period-summary/src/period-summary.command.ts
+++ b/commands/period-summary/src/period-summary.command.ts
@@ -0,0 +1,128 @@
+import { Command, CommandRunner, Option } from "nest-commander";
+import { t, normalizeVerbose } from "@spaceflow/core";
+import { PeriodSummaryService } from "./period-summary.service";
+import type { PeriodSummaryOptions, OutputTarget, TimePreset } from "./types";
+import type { VerboseLevel } from "@spaceflow/core";
+
+/**
+ * 周期统计命令
+ *
+ * 根据时间范围统计 PR 贡献情况，按人员汇总并排序
+ *
+ * 环境变量：
+ * - GITHUB_TOKEN: GitHub API Token
+ * - GITHUB_REPOSITORY: 仓库名称 (owner/repo 格式)
+ */
+@Command({
+  name: "period-summary",
+  description: t("period-summary:description"),
+})
+export class PeriodSummaryCommand extends CommandRunner {
+  constructor(protected readonly periodSummaryService: PeriodSummaryService) {
+    super();
+  }
+
+  async run(_passedParams: string[], options: PeriodSummaryOptions): Promise<void> {
+    try {
+      const context = this.periodSummaryService.getContextFromOptions(options);
+      const result = await this.periodSummaryService.execute(context);
+      const outputResult = await this.periodSummaryService.outputReport(context, result);
+      if (outputResult.type !== "console" && outputResult.location) {
+        console.log(t("period-summary:reportOutput", { location: outputResult.location }));
+      }
+    } catch (error) {
+      console.error(
+        t("common.executionFailed", { error: error instanceof Error ? error.message : error }),
+      );
+      process.exit(1);
+    }
+  }
+
+  @Option({
+    flags: "-p, --preset <preset>",
+    description: t("period-summary:options.preset"),
+    choices: [
+      "this-week",
+      "last-week",
+      "this-month",
+      "last-month",
+      "last-7-days",
+      "last-15-days",
+      "last-30-days",
+    ],
+  })
+  parsePreset(val: string): TimePreset {
+    return val as TimePreset;
+  }
+
+  @Option({
+    flags: "-s, --since <date>",
+    description: t("period-summary:options.since"),
+  })
+  parseSince(val: string): string {
+    return val;
+  }
+
+  @Option({
+    flags: "-u, --until <date>",
+    description: t("period-summary:options.until"),
+  })
+  parseUntil(val: string): string {
+    return val;
+  }
+
+  @Option({
+    flags: "-r, --repository <repo>",
+    description: t("period-summary:options.repository"),
+  })
+  parseRepository(val: string): string {
+    return val;
+  }
+
+  @Option({
+    flags: "-c, --ci",
+    description: t("common.options.ci"),
+  })
+  parseCi(val: boolean): boolean {
+    return val;
+  }
+
+  @Option({
+    flags: "-f, --format <format>",
+    description: t("period-summary:options.format"),
+    choices: ["table", "json", "markdown"],
+  })
+  parseFormat(val: string): "table" | "json" | "markdown" {
+    return val as "table" | "json" | "markdown";
+  }
+
+  @Option({
+    flags: "-o, --output <target>",
+    description: t("period-summary:options.output"),
+    choices: ["console", "issue", "file"],
+    defaultValue: "console",
+  })
+  parseOutput(val: string): OutputTarget {
+    return val as OutputTarget;
+  }
+
+  @Option({
+    flags: "--output-file <path>",
+    description: t("period-summary:options.outputFile"),
+  })
+  parseOutputFile(val: string): string {
+    return val;
+  }
+
+  @Option({
+    flags: "-v, --verbose [level]",
+    description: t("period-summary:options.verbose"),
+  })
+  parseVerbose(val: string | boolean): VerboseLevel {
+    if (val === true || val === "") {
+      return 1;
+    }
+    const level = parseInt(val as string, 10);
+    return normalizeVerbose(level as VerboseLevel);
+  }
+}
--- a/commands/period-summary/src/period-summary.module.ts
+++ b/commands/period-summary/src/period-summary.module.ts
@@ -0,0 +1,11 @@
+import { Module } from "@nestjs/common";
+import { ConfigModule } from "@nestjs/config";
+import { GitProviderModule, ciConfig } from "@spaceflow/core";
+import { PeriodSummaryCommand } from "./period-summary.command";
+import { PeriodSummaryService } from "./period-summary.service";
+
+@Module({
+  imports: [ConfigModule.forFeature(ciConfig), GitProviderModule.forFeature()],
+  providers: [PeriodSummaryCommand, PeriodSummaryService],
+})
+export class PeriodSummaryModule {}
--- a/commands/period-summary/src/period-summary.service.ts
+++ b/commands/period-summary/src/period-summary.service.ts
@@ -0,0 +1,530 @@
+import { Injectable } from "@nestjs/common";
+import { ConfigService } from "@nestjs/config";
+import { writeFileSync } from "fs";
+import { join } from "path";
+import { GitProviderService, shouldLog, normalizeVerbose } from "@spaceflow/core";
+import type { PullRequest, Issue, CiConfig } from "@spaceflow/core";
+import type {
+  PeriodSummaryOptions,
+  PeriodSummaryContext,
+  PeriodSummaryResult,
+  PrStats,
+  UserStats,
+  OutputTarget,
+  TimePreset,
+} from "./types";
+
+/** 分数权重配置 */
+const SCORE_WEIGHTS = {
+  /** 每个 PR 的基础分 */
+  prBase: 10,
+  /** 每 100 行新增代码的分数 */
+  additionsPer100: 2,
+  /** 每 100 行删除代码的分数 */
+  deletionsPer100: 1,
+  /** 每个变更文件的分数 */
+  changedFile: 0.5,
+  /** 每个未修复问题的扣分 */
+  issueDeduction: 3,
+  /** 每个已修复问题的加分 */
+  fixedBonus: 1,
+};
+
+/**
+ * 周期统计服务
+ */
+@Injectable()
+export class PeriodSummaryService {
+  constructor(
+    protected readonly gitProvider: GitProviderService,
+    protected readonly configService: ConfigService,
+  ) {}
+
+  /**
+   * 从配置和选项获取执行上下文
+   */
+  getContextFromOptions(options: PeriodSummaryOptions): PeriodSummaryContext {
+    let owner: string;
+    let repo: string;
+    if (options.repository) {
+      const parts = options.repository.split("/");
+      if (parts.length !== 2) {
+        throw new Error(`仓库格式不正确，期望 "owner/repo"，实际: "${options.repository}"`);
+      }
+      owner = parts[0];
+      repo = parts[1];
+    } else {
+      const ciConf = this.configService.get<CiConfig>("ci");
+      const repository = ciConf?.repository;
+      if (!repository) {
+        throw new Error("缺少仓库配置，请通过 --repository 参数或环境变量 GITHUB_REPOSITORY 指定");
+      }
+      const parts = repository.split("/");
+      owner = parts[0];
+      repo = parts[1];
+    }
+    if (options.ci) {
+      this.gitProvider.validateConfig();
+    }
+    const { since, until } = this.resolveDateRange(options);
+    if (since > until) {
+      throw new Error("开始日期不能晚于结束日期");
+    }
+    const output: OutputTarget = options.output ?? "console";
+    if (output === "issue" && !options.ci) {
+      this.gitProvider.validateConfig();
+    }
+    return {
+      owner,
+      repo,
+      since,
+      until,
+      format: options.format ?? (output === "console" ? "table" : "markdown"),
+      output,
+      outputFile: options.outputFile,
+      verbose: normalizeVerbose(options.verbose),
+    };
+  }
+
+  /**
+   * 执行周期统计
+   */
+  async execute(context: PeriodSummaryContext): Promise<PeriodSummaryResult> {
+    const { owner, repo, since, until, verbose } = context;
+    if (shouldLog(verbose, 1)) {
+      console.log(`📊 开始统计 ${owner}/${repo} 的 PR 数据...`);
+      console.log(`📅 时间范围: ${this.formatDate(since)} ~ ${this.formatDate(until)}`);
+    }
+    const allPrs = await this.gitProvider.listAllPullRequests(owner, repo, { state: "closed" });
+    const mergedPrs = allPrs.filter((pr) => {
+      if (!pr.merged_at) return false;
+      const mergedAt = new Date(pr.merged_at);
+      return mergedAt >= since && mergedAt <= until;
+    });
+    if (shouldLog(verbose, 1)) {
+      console.log(`📝 找到 ${mergedPrs.length} 个已合并的 PR`);
+    }
+    const prStatsList: PrStats[] = [];
+    for (const pr of mergedPrs) {
+      if (shouldLog(verbose, 1)) {
+        console.log(`   处理 PR #${pr.number}: ${pr.title}`);
+      }
+      const stats = await this.collectPrStats(owner, repo, pr);
+      prStatsList.push(stats);
+    }
+    const userStatsMap = this.aggregateByUser(prStatsList);
+    const sortedUserStats = this.sortUserStats(userStatsMap);
+    return {
+      period: {
+        since: this.formatDate(since),
+        until: this.formatDate(until),
+      },
+      repository: `${owner}/${repo}`,
+      totalPrs: mergedPrs.length,
+      userStats: sortedUserStats,
+    };
+  }
+
+  /**
+   * 收集单个 PR 的统计数据
+   */
+  protected async collectPrStats(owner: string, repo: string, pr: PullRequest): Promise<PrStats> {
+    let additions = 0;
+    let deletions = 0;
+    let changedFiles = 0;
+    try {
+      const files = await this.gitProvider.getPullRequestFiles(owner, repo, pr.number!);
+      changedFiles = files.length;
+      for (const file of files) {
+        additions += file.additions ?? 0;
+        deletions += file.deletions ?? 0;
+      }
+    } catch {
+      // 如果获取文件失败，使用默认值
+    }
+    const { issueCount, fixedCount } = await this.extractIssueStats(owner, repo, pr.number!);
+    return {
+      number: pr.number!,
+      title: pr.title ?? "",
+      author: pr.user?.login ?? "unknown",
+      mergedAt: pr.merged_at ?? "",
+      additions,
+      deletions,
+      changedFiles,
+      issueCount,
+      fixedCount,
+      description: this.extractDescription(pr),
+    };
+  }
+
+  /**
+   * 从 PR 评论中提取问题统计
+   */
+  protected async extractIssueStats(
+    owner: string,
+    repo: string,
+    prNumber: number,
+  ): Promise<{ issueCount: number; fixedCount: number }> {
+    try {
+      const comments = await this.gitProvider.listIssueComments(owner, repo, prNumber);
+      let issueCount = 0;
+      let fixedCount = 0;
+      for (const comment of comments) {
+        const body = comment.body ?? "";
+        const issueMatch = body.match(/发现\s*(\d+)\s*个问题/);
+        if (issueMatch) {
+          issueCount = Math.max(issueCount, parseInt(issueMatch[1], 10));
+        }
+        const fixedMatch = body.match(/已修复[：:]\s*(\d+)/);
+        if (fixedMatch) {
+          fixedCount = Math.max(fixedCount, parseInt(fixedMatch[1], 10));
+        }
+        const statsMatch = body.match(/🔴\s*(\d+).*🟡\s*(\d+)/);
+        if (statsMatch) {
+          const errorCount = parseInt(statsMatch[1], 10);
+          const warnCount = parseInt(statsMatch[2], 10);
+          issueCount = Math.max(issueCount, errorCount + warnCount);
+        }
+      }
+      return { issueCount, fixedCount };
+    } catch {
+      return { issueCount: 0, fixedCount: 0 };
+    }
+  }
+
+  /**
+   * 从 PR 提取功能描述
+   */
+  protected extractDescription(pr: PullRequest): string {
+    if (pr.title) {
+      return pr.title.replace(/^\[.*?\]\s*/, "").trim();
+    }
+    return "";
+  }
+
+  /**
+   * 按用户聚合统计数据
+   */
+  protected aggregateByUser(prStatsList: PrStats[]): Map<string, UserStats> {
+    const userMap = new Map<string, UserStats>();
+    for (const pr of prStatsList) {
+      let userStats = userMap.get(pr.author);
+      if (!userStats) {
+        userStats = {
+          username: pr.author,
+          prCount: 0,
+          totalAdditions: 0,
+          totalDeletions: 0,
+          totalChangedFiles: 0,
+          totalIssues: 0,
+          totalFixed: 0,
+          score: 0,
+          features: [],
+          prs: [],
+        };
+        userMap.set(pr.author, userStats);
+      }
+      userStats.prCount++;
+      userStats.totalAdditions += pr.additions;
+      userStats.totalDeletions += pr.deletions;
+      userStats.totalChangedFiles += pr.changedFiles;
+      userStats.totalIssues += pr.issueCount;
+      userStats.totalFixed += pr.fixedCount;
+      if (pr.description) {
+        userStats.features.push(pr.description);
+      }
+      userStats.prs.push(pr);
+    }
+    for (const userStats of userMap.values()) {
+      userStats.score = this.calculateScore(userStats);
+    }
+    return userMap;
+  }
+
+  /**
+   * 计算用户综合分数
+   */
+  protected calculateScore(stats: UserStats): number {
+    const prScore = stats.prCount * SCORE_WEIGHTS.prBase;
+    const additionsScore = (stats.totalAdditions / 100) * SCORE_WEIGHTS.additionsPer100;
+    const deletionsScore = (stats.totalDeletions / 100) * SCORE_WEIGHTS.deletionsPer100;
+    const filesScore = stats.totalChangedFiles * SCORE_WEIGHTS.changedFile;
+    const unfixedIssues = stats.totalIssues - stats.totalFixed;
+    const issueDeduction = unfixedIssues * SCORE_WEIGHTS.issueDeduction;
+    const fixedBonus = stats.totalFixed * SCORE_WEIGHTS.fixedBonus;
+    const totalScore =
+      prScore + additionsScore + deletionsScore + filesScore - issueDeduction + fixedBonus;
+    return Math.max(0, Math.round(totalScore * 10) / 10);
+  }
+
+  /**
+   * 按分数排序用户统计
+   */
+  protected sortUserStats(userMap: Map<string, UserStats>): UserStats[] {
+    return Array.from(userMap.values()).sort((a, b) => b.score - a.score);
+  }
+
+  /**
+   * 解析日期字符串
+   */
+  protected parseDate(dateStr: string, fieldName: string): Date {
+    const date = new Date(dateStr);
+    if (isNaN(date.getTime())) {
+      throw new Error(`${fieldName}格式不正确: "${dateStr}"，请使用 YYYY-MM-DD 格式`);
+    }
+    return date;
+  }
+
+  /**
+   * 根据预设或手动输入解析日期范围
+   */
+  protected resolveDateRange(options: PeriodSummaryOptions): { since: Date; until: Date } {
+    if (options.preset) {
+      return this.resolvePresetDateRange(options.preset);
+    }
+    if (!options.since) {
+      throw new Error("请指定 --since 参数或使用 --preset 预设时间范围");
+    }
+    const since = this.parseDate(options.since, "开始日期");
+    const until = options.until ? this.parseDate(options.until, "结束日期") : new Date();
+    until.setHours(23, 59, 59, 999);
+    return { since, until };
+  }
+
+  /**
+   * 根据预设解析日期范围
+   */
+  protected resolvePresetDateRange(preset: TimePreset): { since: Date; until: Date } {
+    const now = new Date();
+    const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+    let since: Date;
+    let until: Date;
+    switch (preset) {
+      case "this-week": {
+        const dayOfWeek = today.getDay();
+        const mondayOffset = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+        since = new Date(today);
+        since.setDate(today.getDate() + mondayOffset);
+        until = new Date(today);
+        until.setHours(23, 59, 59, 999);
+        break;
+      }
+      case "last-week": {
+        const dayOfWeek = today.getDay();
+        const mondayOffset = dayOfWeek === 0 ? -6 : 1 - dayOfWeek;
+        until = new Date(today);
+        until.setDate(today.getDate() + mondayOffset - 1);
+        until.setHours(23, 59, 59, 999);
+        since = new Date(until);
+        since.setDate(until.getDate() - 6);
+        since.setHours(0, 0, 0, 0);
+        break;
+      }
+      case "this-month": {
+        since = new Date(today.getFullYear(), today.getMonth(), 1);
+        until = new Date(today);
+        until.setHours(23, 59, 59, 999);
+        break;
+      }
+      case "last-month": {
+        since = new Date(today.getFullYear(), today.getMonth() - 1, 1);
+        until = new Date(today.getFullYear(), today.getMonth(), 0);
+        until.setHours(23, 59, 59, 999);
+        break;
+      }
+      case "last-7-days": {
+        since = new Date(today);
+        since.setDate(today.getDate() - 6);
+        until = new Date(today);
+        until.setHours(23, 59, 59, 999);
+        break;
+      }
+      case "last-15-days": {
+        since = new Date(today);
+        since.setDate(today.getDate() - 14);
+        until = new Date(today);
+        until.setHours(23, 59, 59, 999);
+        break;
+      }
+      case "last-30-days": {
+        since = new Date(today);
+        since.setDate(today.getDate() - 29);
+        until = new Date(today);
+        until.setHours(23, 59, 59, 999);
+        break;
+      }
+      default:
+        throw new Error(`未知的时间预设: ${preset}`);
+    }
+    return { since, until };
+  }
+
+  /**
+   * 格式化日期为 YYYY-MM-DD
+   */
+  protected formatDate(date: Date): string {
+    return date.toISOString().split("T")[0];
+  }
+
+  /**
+   * 格式化输出结果
+   */
+  formatOutput(result: PeriodSummaryResult, format: "table" | "json" | "markdown"): string {
+    switch (format) {
+      case "json":
+        return JSON.stringify(result, null, 2);
+      case "markdown":
+        return this.formatMarkdown(result);
+      case "table":
+      default:
+        return this.formatTable(result);
+    }
+  }
+
+  /**
+   * 格式化为表格输出
+   */
+  protected formatTable(result: PeriodSummaryResult): string {
+    const lines: string[] = [];
+    lines.push("");
+    lines.push(`📊 周期统计报告`);
+    lines.push(`${"─".repeat(60)}`);
+    lines.push(`📦 仓库: ${result.repository}`);
+    lines.push(`📅 周期: ${result.period.since} ~ ${result.period.until}`);
+    lines.push(`📝 合并 PR 数: ${result.totalPrs}`);
+    lines.push("");
+    lines.push(`🏆 贡献者排名`);
+    lines.push(`${"─".repeat(60)}`);
+    const header = [
+      "排名".padEnd(4),
+      "用户".padEnd(15),
+      "PR数".padStart(5),
+      "新增".padStart(8),
+      "删除".padStart(8),
+      "问题".padStart(5),
+      "分数".padStart(8),
+    ].join(" │ ");
+    lines.push(header);
+    lines.push("─".repeat(60));
+    result.userStats.forEach((user, index) => {
+      const row = [
+        `#${index + 1}`.padEnd(4),
+        user.username.slice(0, 15).padEnd(15),
+        String(user.prCount).padStart(5),
+        `+${user.totalAdditions}`.padStart(8),
+        `-${user.totalDeletions}`.padStart(8),
+        String(user.totalIssues).padStart(5),
+        user.score.toFixed(1).padStart(8),
+      ].join(" │ ");
+      lines.push(row);
+    });
+    lines.push("─".repeat(60));
+    lines.push("");
+    lines.push(`📋 功能摘要`);
+    lines.push(`${"─".repeat(60)}`);
+    for (const user of result.userStats) {
+      if (user.features.length > 0) {
+        lines.push(`\n👤 ${user.username}:`);
+        for (const feature of user.features) {
+          lines.push(`   • ${feature}`);
+        }
+      }
+    }
+    lines.push("");
+    return lines.join("\n");
+  }
+
+  /**
+   * 格式化为 Markdown 输出
+   */
+  protected formatMarkdown(result: PeriodSummaryResult): string {
+    const lines: string[] = [];
+    lines.push(`# 📊 周期统计报告`);
+    lines.push("");
+    lines.push(`- **仓库**: ${result.repository}`);
+    lines.push(`- **周期**: ${result.period.since} ~ ${result.period.until}`);
+    lines.push(`- **合并 PR 数**: ${result.totalPrs}`);
+    lines.push("");
+    lines.push(`## 🏆 贡献者排名`);
+    lines.push("");
+    lines.push(`| 排名 | 用户 | PR数 | 新增 | 删除 | 问题 | 分数 |`);
+    lines.push(`|------|------|------|------|------|------|------|`);
+    result.userStats.forEach((user, index) => {
+      lines.push(
+        `| #${index + 1} | ${user.username} | ${user.prCount} | +${user.totalAdditions} | -${user.totalDeletions} | ${user.totalIssues} | ${user.score.toFixed(1)} |`,
+      );
+    });
+    lines.push("");
+    lines.push(`## 📋 功能摘要`);
+    lines.push("");
+    for (const user of result.userStats) {
+      if (user.features.length > 0) {
+        lines.push(`### 👤 ${user.username}`);
+        lines.push("");
+        for (const feature of user.features) {
+          lines.push(`- ${feature}`);
+        }
+        lines.push("");
+      }
+    }
+    return lines.join("\n");
+  }
+
+  /**
+   * 输出报告到指定目标
+   */
+  async outputReport(
+    context: PeriodSummaryContext,
+    result: PeriodSummaryResult,
+  ): Promise<{ type: OutputTarget; location?: string }> {
+    const content = this.formatOutput(result, context.format);
+    switch (context.output) {
+      case "issue":
+        return this.outputToIssue(context, result, content);
+      case "file":
+        return this.outputToFile(context, result, content);
+      case "console":
+      default:
+        console.log(content);
+        return { type: "console" };
+    }
+  }
+
+  /**
+   * 输出报告到 GitHub Issue
+   */
+  protected async outputToIssue(
+    context: PeriodSummaryContext,
+    result: PeriodSummaryResult,
+    content: string,
+  ): Promise<{ type: OutputTarget; location: string }> {
+    const title = `📊 周期统计报告: ${result.period.since} ~ ${result.period.until}`;
+    const issue: Issue = await this.gitProvider.createIssue(context.owner, context.repo, {
+      title,
+      body: content,
+    });
+    const location = issue.html_url ?? `#${issue.number}`;
+    if (shouldLog(context.verbose, 1)) {
+      console.log(`✅ 已创建 Issue: ${location}`);
+    }
+    return { type: "issue", location };
+  }
+
+  /**
+   * 输出报告到 Markdown 文件
+   */
+  protected outputToFile(
+    context: PeriodSummaryContext,
+    result: PeriodSummaryResult,
+    content: string,
+  ): { type: OutputTarget; location: string } {
+    const filename =
+      context.outputFile ?? `period-summary-${result.period.since}-${result.period.until}.md`;
+    const filepath = join(process.cwd(), filename);
+    writeFileSync(filepath, content, "utf-8");
+    if (shouldLog(context.verbose, 1)) {
+      console.log(`✅ 已保存到文件: ${filepath}`);
+    }
+    return { type: "file", location: filepath };
+  }
+}
--- a/commands/period-summary/src/types.ts
+++ b/commands/period-summary/src/types.ts
@@ -0,0 +1,115 @@
+/**
+ * 周期统计命令类型定义
+ */
+
+import type { VerboseLevel } from "@spaceflow/core";
+
+/** 输出目标类型 */
+export type OutputTarget = "console" | "issue" | "file";
+
+/** 时间预设类型 */
+export type TimePreset =
+  | "this-week"
+  | "last-week"
+  | "this-month"
+  | "last-month"
+  | "last-7-days"
+  | "last-15-days"
+  | "last-30-days";
+
+/** 命令选项 */
+export interface PeriodSummaryOptions {
+  /** 开始日期 (YYYY-MM-DD) */
+  since?: string;
+  /** 结束日期 (YYYY-MM-DD)，默认为今天 */
+  until?: string;
+  /** 时间预设，优先级高于 since/until */
+  preset?: TimePreset;
+  /** 仓库路径 owner/repo，默认从环境变量获取 */
+  repository?: string;
+  /** 是否在 CI 环境中运行 */
+  ci?: boolean;
+  /** 输出格式 */
+  format?: "table" | "json" | "markdown";
+  /** 输出目标：console（控制台）、issue（创建 GitHub Issue）、file（Markdown 文件） */
+  output?: OutputTarget;
+  /** 输出文件路径（当 output 为 file 时使用） */
+  outputFile?: string;
+  /** 详细日志级别 (0: 静默, 1: 过程日志, 2: 详细日志) */
+  verbose?: VerboseLevel;
+}
+
+/** 命令执行上下文 */
+export interface PeriodSummaryContext {
+  owner: string;
+  repo: string;
+  since: Date;
+  until: Date;
+  format: "table" | "json" | "markdown";
+  output: OutputTarget;
+  outputFile?: string;
+  verbose: VerboseLevel;
+}
+
+/** 单个 PR 的统计数据 */
+export interface PrStats {
+  /** PR 编号 */
+  number: number;
+  /** PR 标题 */
+  title: string;
+  /** 作者用户名 */
+  author: string;
+  /** 合并时间 */
+  mergedAt: string;
+  /** 新增行数 */
+  additions: number;
+  /** 删除行数 */
+  deletions: number;
+  /** 变更文件数 */
+  changedFiles: number;
+  /** 扫描发现的问题数 */
+  issueCount: number;
+  /** 已修复的问题数 */
+  fixedCount: number;
+  /** PR 描述/功能摘要 */
+  description: string;
+}
+
+/** 单个用户的统计数据 */
+export interface UserStats {
+  /** 用户名 */
+  username: string;
+  /** PR 数量 */
+  prCount: number;
+  /** 总新增行数 */
+  totalAdditions: number;
+  /** 总删除行数 */
+  totalDeletions: number;
+  /** 总变更文件数 */
+  totalChangedFiles: number;
+  /** 总问题数 */
+  totalIssues: number;
+  /** 总已修复问题数 */
+  totalFixed: number;
+  /** 综合分数 */
+  score: number;
+  /** 功能摘要列表 */
+  features: string[];
+  /** 该用户的 PR 列表 */
+  prs: PrStats[];
+}
+
+/** 周期统计结果 */
+export interface PeriodSummaryResult {
+  /** 统计周期 */
+  period: {
+    since: string;
+    until: string;
+  };
+  /** 仓库信息 */
+  repository: string;
+  /** 总 PR 数 */
+  totalPrs: number;
+  /** 按用户统计（已排序） */
+  userStats: UserStats[];
+}
--- a/commands/period-summary/tsconfig.json
+++ b/commands/period-summary/tsconfig.json
@@ -0,0 +1,5 @@
+{
+  "extends": "../../core/tsconfig.skill.json",
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}