feat(changelog): 更新日志改为 changelog.d 碎片，发版 PR 统一编译与推进版本号

[qiyinxi]

• 更新日志改为每个 PR 在 changelog.d/ 放一个碎片（<PR 号或分支名>.<feat|fix|change|breaking|…>.md，一句话），普通 PR 不再改 CHANGELOG.md 与五处版本号，PR 之间不再有可冲突的共享文件；说明见 changelog.d/README.md。
• 新增「准备发版」工作流：按最新 tag 推出版本号（beta N+1 / 转正同号 / 补丁 Z+1），把碎片编译进 CHANGELOG.md、写五处版本号、开 Release vX.Y.Z PR；合并后照旧手动跑「构建并发布应用程序」，构建前先守门（版本号已比最新 tag 新、碎片已清空），Release 正文只写本版增量、转正时汇总整个 beta 周期。
• 「检查更新日志」改为：改了用户可见代码必须恰好一个碎片（skip-changelog 豁免），普通 PR 碰 CHANGELOG.md / 版本号即红，仓库版本号小于最新 tag 即红（今天 WIP: 支持MaaEnd v2.28的新字段 #643 那种回退会当场发现），目标 release/* 的 PR 不得带入 dev 独有提交（fix(BetterGI): 修复自动秘境只刷一轮就提前结束 #673 那种事故）。
• 删除 append-version-contributor.yml：署名改在发版时按碎片首次进入仓库的提交作者补，不再靠文本 diff 猜。

合并后需要在 main 上做两件事（pull_request_target 与 workflow_dispatch 都从默认分支取文件），随下一次 dev→main 合并或单独提 PR 均可，但必须在第一次运行「准备发版」之前完成：

1. 删除 main 上的 .github/workflows/append-version-contributor.yml，否则它会把发版 PR 的每一条都再签一次 PR 作者。「准备发版」开始前会检查这一点并拒绝运行。
2. 让 .github/workflows/prepare-release.yml 出现在 main 上，Actions 页面才会有它的「Run workflow」按钮；运行时用的是所选分支上的文件。

其他说明：已开着的 PR 需要把 CHANGELOG.md 里那一行改成碎片；本 PR 因为改了 CHANGELOG.md 头部说明而打了 changelog-maintenance 标签；文档站开发者页另行同步。本地验证：tests/tools/test_changelog_script.py 70 项通过，全量 1011 通过 / 4 跳过，release --kind beta|stable 与 release-note 在克隆里实跑过。

🤖 Generated with Claude Code

Sourcery 摘要

采用基于片段的变更日志，并在发布工作流中集中管理版本控制、发布说明生成和发布验证。

新功能：

• 在 changelog.d/ 下添加变更日志片段，并新增发布准备工作流，用于编译变更日志、推进版本号以及创建发布 PR。
• 添加发布说明生成以及版本和片段状态的预发布构建保护。

Bug 修复：

• 验证拉取请求是否存在版本回退，并防止仅用于开发的提交泄漏到发布分支。
• 将基于提交差异的贡献者归属方式替换为基于引入变更日志片段的提交进行归属。

改进：

• 强制每个面向用户的拉取请求对应一个变更日志片段，同时防止普通 PR 修改生成的变更日志和版本字段。
• 在贡献者指南和代理技能文档中记录基于片段的变更日志及修订后的发布流程。

CI：

• 更新变更日志验证，将 PR 分为普通、发布和同步类型，并加入由标签触发的检查及发布分支保护。

部署：

• 允许从发布分支构建和发布应用，同时要求版本号已推进且变更日志片段已清空后才能发布。

文档：

• 添加变更日志片段使用说明和发布流程文档。

测试：

• 扩展变更日志脚本测试范围，涵盖片段、版本推进、发布编译、发布说明、贡献者归属、PR 验证和发布保护。

杂项：

• 移除旧版版本贡献者工作流。

Original summary in English

Sourcery 总结

采用基于片段的变更日志，并在发布工作流中集中管理版本控制、发布说明生成和发布验证。

新功能：

• 在 changelog.d/ 中引入变更日志片段，并新增工作流，将其编译为发布说明、推进版本号并创建发布 PR。
• 添加发布说明生成和预发布构建保护，验证版本及片段状态。

错误修复：

• 检测相对于最新标签的版本回退，并防止仅用于开发的提交泄漏到发布分支。
• 根据引入变更日志片段的提交来标注贡献者，而不是从文本变更中推断贡献者。

增强功能：

• 要求面向用户的 PR 正好添加一个变更日志片段，同时防止普通 PR 修改生成的变更日志和版本字段。
• 为维护者和贡献者编写基于片段的变更日志及修订后的发布流程文档。

CI：

• 更新变更日志验证逻辑，以区分普通 PR、发布 PR 和同步 PR，包括由标签触发的检查及发布分支保护。

部署：

• 允许从发布分支构建和发布应用，同时要求版本号已提前更新且变更日志片段目录为空。

文档：

• 添加贡献者指南，以及基于片段的变更日志和发布工作流文档。

测试：

• 扩展变更日志脚本测试覆盖范围，包括片段、版本推进、发布编译、发布说明、贡献者归属、PR 验证和发布保护。

杂项：

• 移除旧版版本贡献者工作流。

Original summary in English

Sourcery 总结

采用基于变更日志片段的管理方式，并在发布工作流中集中处理版本管理、发布说明生成和发布验证。

新功能：

• 为每个拉取请求引入一个变更日志片段，并添加一个工作流，用于编译片段、推进版本号以及创建发布拉取请求。
• 生成包含贡献者署名的发布说明，并支持 beta、stable、patch 以及显式发布版本。

错误修复：

• 检测相对于已发布标签的版本回退，并防止仅用于开发的提交泄漏到发布分支。
• 使用引入每个变更日志片段的提交进行署名，替代旧版的版本贡献者工作流。
• 添加构建时保护措施，要求版本号必须更新，并且发布前变更日志片段目录必须为空。

增强功能：

• 强制要求面向用户的变更提供变更日志片段，同时防止普通拉取请求修改生成的变更日志或版本字段。
• 扩展变更日志验证，以区分普通、发布和同步拉取请求，并支持变更日志豁免。

构建：

• 允许从发布分支构建和发布应用。

CI：

• 更新变更日志检查和拉取请求触发器，以验证片段、版本、发布分支和发布保护措施。

文档：

• 记录变更日志片段规范、发布准备、版本管理和贡献者工作流。

测试：

• 扩展变更日志脚本测试覆盖范围，包括片段、版本推进、发布编译、发布说明、署名、拉取请求验证和发布保护。

杂项：

• 移除旧版的追加版本贡献者工作流。

Original summary in English

Sourcery 总结

采用基于片段的变更日志管理方式，并在发布工作流中集中处理版本管理、发布说明生成、贡献者署名和发布验证。

新功能：

• 在 changelog.d/ 下引入单句变更日志片段，并添加工作流，将其编译为发布说明、推进版本号并创建发布 PR。
• 支持 beta、stable、patch 和显式发布处理，并根据引入片段的提交生成发布说明和贡献者署名。

错误修复：

• 防止版本号回退到已发布的标签之前，并阻止仅用于开发的提交泄漏到发布分支。
• 添加构建时保护措施：发布前必须使用更高版本号，且变更日志片段目录必须为空。

增强功能：

• 对面向用户的变更要求恰好包含一个片段，同时禁止普通 PR 修改生成的变更日志或版本字段。
• 对普通 PR、发布 PR 和同步 PR 进行分类验证，包括变更日志豁免规则和发布分支保护。

CI：

• 更新变更日志验证的触发条件和规则，涵盖片段、版本号、PR 类型和发布分支检查。

部署：

• 允许从发布分支构建和发布应用，但须满足版本号和变更日志保护条件。

文档：

• 记录变更日志片段规范、贡献者指南以及修订后的发布流程。

测试：

• 扩展变更日志工具测试，覆盖片段、版本推进、发布编译、发布说明、署名、PR 验证和发布保护。

杂项：

• 移除旧版版本贡献者工作流。

Original summary in English

Summary by Sourcery

Adopt fragment-based changelog management and centralize versioning, release-note generation, contributor attribution, and release validation in the release workflow.

New Features:

• Introduce one-sentence changelog fragments under changelog.d/ and a workflow that compiles them into release notes, advances versions, and opens release PRs.
• Add beta, stable, patch, and explicit release handling with generated release notes and contributor attribution from fragment-introducing commits.

Bug Fixes:

• Prevent version regressions relative to published tags and block development-only commits from leaking into release branches.
• Add build-time safeguards that require a newer version and an empty changelog fragment directory before publishing.

Enhancements:

• Require exactly one fragment for user-visible changes while preventing normal PRs from modifying generated changelogs or version fields.
• Classify PR validation for normal, release, and synchronization PRs, including changelog exemptions and release-branch protections.

CI:

• Update changelog validation triggers and rules for fragment, version, PR-type, and release-branch checks.

Deployment:

• Allow application builds and releases from release branches subject to version and changelog guards.

Documentation:

• Document changelog fragment conventions, contributor guidance, and the revised release process.

Tests:

• Expand changelog tooling tests for fragments, version progression, release compilation, release notes, attribution, PR validation, and publishing guards.

Chores:

• Remove the legacy version-contributor workflow.

[sourcery-ai]

Sorry @qiyinxi, you've used your own review budget of 250,000 diff characters for the last 7 days.

You can request another review in 1 day and 15 hours by commenting @sourcery-ai review. Upgrade to get a review now.

[sourcery-ai]

审查者指南

本 PR 将更新日志和版本管理改为碎片驱动的集中式发版流程：普通 PR 只提交一个 changelog.d/ 碎片，CI 负责严格校验，准备发版工作流统一编译 CHANGELOG.md、推进版本号、补充署名并创建 Release PR，构建发布阶段再执行版本与碎片守门。

基于更新日志碎片的发版流程时序图

sequenceDiagram
    actor Maintainer
    participant PrepareRelease as prepare-release.yml
    participant Script as scripts/changelog.py
    participant GitHub as GitHub
    participant ReleasePR as Release PR
    participant Build as build-app.yml

    Maintainer->>PrepareRelease: workflow_dispatch(kind)
    PrepareRelease->>Script: release(--kind)
    Script->>Script: latest_version()
    Script->>Script: compile_release()
    Script->>Script: sync_generated()
    Script->>Script: fragment_author()
    Script-->>PrepareRelease: version and PR body
    PrepareRelease->>GitHub: create-pull-request
    GitHub-->>ReleasePR: Release vX.Y.Z
    Maintainer->>ReleasePR: merge
    Maintainer->>Build: workflow_dispatch
    Build->>Script: guard
    Script->>Script: current() and list_fragments()
    Script-->>Build: release allowed
    Build->>Script: release-note
    Script-->>Build: incremental release note

Loading

更新日志碎片校验流程图

flowchart TD
    A[PR opened or updated] --> B[check-changelog.yml]
    B --> C{PR type}
    C -->|normal| D{User-visible code changed?}
    D -->|yes| E{Exactly one new changelog.d fragment?}
    D -->|no| F[Skip fragment requirement]
    E -->|no| G[Fail check]
    E -->|yes| H[Reject CHANGELOG.md or version edits]
    H --> I[Check version floor and fragment format]
    F --> I
    C -->|release| J[Require fragments empty and version newer than latest tag]
    C -->|sync| K[Check generated files and format]
    I --> L{All checks pass?}
    J --> L
    K --> L
    L -->|yes| M[Pass]
    L -->|no| G

Loading

文件级变更

变更	详情	文件
将更新日志流程从共享的 CHANGELOG.md 手工维护改为 changelog.d/ 碎片驱动，并集中由发版流程生成版本相关文件。	新增碎片命名、分类、格式、署名和使用说明。 更新开发规范，要求用户可见 PR 恰好包含一个碎片且禁止普通 PR 修改 CHANGELOG.md、生成物和版本号。 保留并扩展生成物同步逻辑，支持从碎片编译版本段、清空碎片并推进五处版本号。	.agents/skills/mas-code-standards/SKILL.md .agents/skills/mas-skills/SKILL.md AGENTS.md CHANGELOG.md changelog.d/README.md changelog.d/release-flow.dev.md scripts/changelog.py
实现自动化发版工作流，根据最新 tag 计算 beta、stable、patch 或显式版本，创建统一的 Release PR。	新增 workflow_dispatch 发版入口及默认分支旧署名机器人检查。 编译碎片、生成 CHANGELOG.md 和版本文件、渲染 Release PR 正文并创建发版 PR。 支持转正时合并整个 beta 周期，并按碎片首次提交作者补充贡献者署名。	.github/workflows/prepare-release.yml scripts/changelog.py
重构更新日志 CI 检查和发布前构建守门，覆盖 PR 类型、版本回退和 release 分支提交污染。	普通 PR 校验用户可见代码与碎片数量、受保护文件和版本号变更，并支持 skip-changelog 与维护标签。 发版 PR 校验碎片已清空且版本号高于最新 tag；同步 PR 执行生成物一致性检查。 构建流程仅允许 main、dev 和 release/，发布前验证版本已推进且没有遗留碎片。 release/ PR 检查是否混入 dev 独有提交。	.github/workflows/check-changelog.yml .github/workflows/build-app.yml scripts/changelog.py
移除按文本 diff 自动补署名的旧机器人，改为发版时从碎片提交历史解析贡献者。	删除 append-version-contributor 工作流。 支持 noreply 邮箱、GitHub API 和 author 覆盖三种署名解析路径，并避免将 Co-authored-by 误记为贡献者。	.github/workflows/append-version-contributor.yml scripts/changelog.py
为碎片解析、版本推进、发版编译、Release 正文和 PR 检查补充全面测试。	覆盖碎片格式、分类、署名、版本排序与版本推进规则。 覆盖 beta/stable 编译、周期汇总、版本回退、Release 正文选择和比较链接。 通过临时 git 仓库测试 PR 规则、版本下限、作者解析和漏写碎片检测。	tests/tools/test_changelog_script.py

可能关联的问题

• #新的changelog书写规范提议：PR 直接实现该提案的 changelog.d 片段机制及配套 CI、发版和迁移流程。
• refactor(changelog): 更新日志与版本号收敛到 CHANGELOG.md，并重做应用内展示 #622：PR 直接删除问题中的旧署名机器人，阻止其继续造成 CHANGELOG.md 与生成物不一致。

---

提示与命令

与 Sourcery 交互

• 触发新的审查： 在 pull request 中评论 @sourcery-ai review。
• 继续讨论： 直接回复 Sourcery 的审查评论。
• 根据审查评论生成 GitHub issue： 回复审查评论，请 Sourcery 根据该评论创建 issue。你也可以使用 @sourcery-ai issue 回复审查评论，以便根据该评论创建 issue。
• 生成 pull request 标题： 在 pull request 标题的任意位置写入 @sourcery-ai，即可随时生成标题。你也可以在 pull request 中评论 @sourcery-ai title，随时（重新）生成标题。
• 生成 pull request 摘要： 在 pull request 正文中想要插入摘要的位置写入 @sourcery-ai summary，即可随时生成 PR 摘要。你也可以在 pull request 中评论 @sourcery-ai summary，随时（重新）生成摘要。
• 生成审查者指南： 在 pull request 中评论 @sourcery-ai guide，即可随时（重新）生成审查者指南。
• 解决所有 Sourcery 评论： 在 pull request 中评论 @sourcery-ai resolve，即可解决所有 Sourcery 评论。如果你已经处理完所有评论并且不想再看到它们，这会非常有用。
• 忽略所有 Sourcery 审查： 在 pull request 中评论 @sourcery-ai dismiss，即可忽略所有现有的 Sourcery 审查。如果你想从全新的审查开始，这一功能尤其有用——别忘了评论 @sourcery-ai review 来触发新的审查！

自定义使用体验

访问你的控制面板以便：

• 启用或禁用审查功能，例如 Sourcery 生成的 pull request 摘要、审查者指南等。
• 更改审查语言。
• 添加、移除或编辑自定义审查说明。
• 调整其他审查设置。

获取帮助

• 如有疑问或反馈，请联系我们的支持团队。
• 访问我们的文档获取详细指南和信息。
• 在 X/Twitter、LinkedIn 或 GitHub 上关注我们，与 Sourcery 团队保持联系。

Original review guide in English

Reviewer's Guide

本 PR 将更新日志和版本管理改为碎片驱动的集中式发版流程：普通 PR 只提交一个 changelog.d/ 碎片，CI 负责严格校验，准备发版工作流统一编译 CHANGELOG.md、推进版本号、补充署名并创建 Release PR，构建发布阶段再执行版本与碎片守门。

Sequence diagram for the changelog-driven release process

sequenceDiagram
    actor Maintainer
    participant PrepareRelease as prepare-release.yml
    participant Script as scripts/changelog.py
    participant GitHub as GitHub
    participant ReleasePR as Release PR
    participant Build as build-app.yml

    Maintainer->>PrepareRelease: workflow_dispatch(kind)
    PrepareRelease->>Script: release(--kind)
    Script->>Script: latest_version()
    Script->>Script: compile_release()
    Script->>Script: sync_generated()
    Script->>Script: fragment_author()
    Script-->>PrepareRelease: version and PR body
    PrepareRelease->>GitHub: create-pull-request
    GitHub-->>ReleasePR: Release vX.Y.Z
    Maintainer->>ReleasePR: merge
    Maintainer->>Build: workflow_dispatch
    Build->>Script: guard
    Script->>Script: current() and list_fragments()
    Script-->>Build: release allowed
    Build->>Script: release-note
    Script-->>Build: incremental release note

Loading

Flow diagram for changelog fragment validation

flowchart TD
    A[PR opened or updated] --> B[check-changelog.yml]
    B --> C{PR type}
    C -->|normal| D{User-visible code changed?}
    D -->|yes| E{Exactly one new changelog.d fragment?}
    D -->|no| F[Skip fragment requirement]
    E -->|no| G[Fail check]
    E -->|yes| H[Reject CHANGELOG.md or version edits]
    H --> I[Check version floor and fragment format]
    F --> I
    C -->|release| J[Require fragments empty and version newer than latest tag]
    C -->|sync| K[Check generated files and format]
    I --> L{All checks pass?}
    J --> L
    K --> L
    L -->|yes| M[Pass]
    L -->|no| G

Loading

File-Level Changes

Change	Details	Files
将更新日志流程从共享的 CHANGELOG.md 手工维护改为 changelog.d/ 碎片驱动，并集中由发版流程生成版本相关文件。	新增碎片命名、分类、格式、署名和使用说明。 更新开发规范，要求用户可见 PR 恰好包含一个碎片且禁止普通 PR 修改 CHANGELOG.md、生成物和版本号。 保留并扩展生成物同步逻辑，支持从碎片编译版本段、清空碎片并推进五处版本号。	.agents/skills/mas-code-standards/SKILL.md .agents/skills/mas-skills/SKILL.md AGENTS.md CHANGELOG.md changelog.d/README.md changelog.d/release-flow.dev.md scripts/changelog.py
实现自动化发版工作流，根据最新 tag 计算 beta、stable、patch 或显式版本，创建统一的 Release PR。	新增 workflow_dispatch 发版入口及默认分支旧署名机器人检查。 编译碎片、生成 CHANGELOG.md 和版本文件、渲染 Release PR 正文并创建发版 PR。 支持转正时合并整个 beta 周期，并按碎片首次提交作者补充贡献者署名。	.github/workflows/prepare-release.yml scripts/changelog.py
重构更新日志 CI 检查和发布前构建守门，覆盖 PR 类型、版本回退和 release 分支提交污染。	普通 PR 校验用户可见代码与碎片数量、受保护文件和版本号变更，并支持 skip-changelog 与维护标签。 发版 PR 校验碎片已清空且版本号高于最新 tag；同步 PR 执行生成物一致性检查。 构建流程仅允许 main、dev 和 release/，发布前验证版本已推进且没有遗留碎片。 release/ PR 检查是否混入 dev 独有提交。	.github/workflows/check-changelog.yml .github/workflows/build-app.yml scripts/changelog.py
移除按文本 diff 自动补署名的旧机器人，改为发版时从碎片提交历史解析贡献者。	删除 append-version-contributor 工作流。 支持 noreply 邮箱、GitHub API 和 author 覆盖三种署名解析路径，并避免将 Co-authored-by 误记为贡献者。	.github/workflows/append-version-contributor.yml scripts/changelog.py
为碎片解析、版本推进、发版编译、Release 正文和 PR 检查补充全面测试。	覆盖碎片格式、分类、署名、版本排序与版本推进规则。 覆盖 beta/stable 编译、周期汇总、版本回退、Release 正文选择和比较链接。 通过临时 git 仓库测试 PR 规则、版本下限、作者解析和漏写碎片检测。	tests/tools/test_changelog_script.py

Possibly linked issues

• #新的changelog书写规范提议: PR 直接实现该提案的 changelog.d 片段机制及配套 CI、发版和迁移流程。
• refactor(changelog): 更新日志与版本号收敛到 CHANGELOG.md，并重做应用内展示 #622: PR 直接删除问题中的旧署名机器人，阻止其继续造成 CHANGELOG.md 与生成物不一致。

---

Tips and commands

Interacting with Sourcery

• Trigger a new review: Comment @sourcery-ai review on the pull request.
• Continue discussions: Reply directly to Sourcery's review comments.
• Generate a GitHub issue from a review comment: Ask Sourcery to create an
  issue from a review comment by replying to it. You can also reply to a
  review comment with @sourcery-ai issue to create an issue from it.
• Generate a pull request title: Write @sourcery-ai anywhere in the pull
  request title to generate a title at any time. You can also comment
  @sourcery-ai title on the pull request to (re-)generate the title at any time.
• Generate a pull request summary: Write @sourcery-ai summary anywhere in
  the pull request body to generate a PR summary at any time exactly where you
  want it. You can also comment @sourcery-ai summary on the pull request to
  (re-)generate the summary at any time.
• Generate reviewer's guide: Comment @sourcery-ai guide on the pull
  request to (re-)generate the reviewer's guide at any time.
• Resolve all Sourcery comments: Comment @sourcery-ai resolve on the
  pull request to resolve all Sourcery comments. Useful if you've already
  addressed all the comments and don't want to see them anymore.
• Dismiss all Sourcery reviews: Comment @sourcery-ai dismiss on the pull
  request to dismiss all existing Sourcery reviews. Especially useful if you
  want to start fresh with a new review - don't forget to comment
  @sourcery-ai review to trigger a new review!

Customizing Your Experience

Access your dashboard to:

• Enable or disable review features such as the Sourcery-generated pull request
  summary, the reviewer's guide, and others.
• Change the review language.
• Add, remove or edit custom review instructions.
• Adjust other review settings.

Getting Help

• Contact our support team for questions or feedback.
• Visit our documentation for detailed guides and information.
• Keep in touch with the Sourcery team by following us on X/Twitter, LinkedIn or GitHub.

[qiyinxi]

审核基于 27498afb856ee382b5d51af1bf9ba9a8714d1b5f。发现以下 4 项 P2，建议修复后合并。

1. [P2] 不同目标分支会复用同一个发版分支。 prepare-release.yml:105–107 只用版本号生成 head 分支名。目前 dev 和 release/v5.5.0-beta.5 的最新可达 tag 都是 v5.5.0-beta.5，实算 beta 均得到 v5.5.0-beta.6。当新工作流部署到这两个受支持分支后，如果两边在打 tag 前分别准备该版本，就都会操作 chore/release-v5.5.0-beta.6；第二次运行会用另一个 base 的内容更新第一个 PR 的 head。create-pull-request v8 源码 确认已有同名分支会被更新。顺序执行也存在此问题，仅调整 concurrency 不够；建议把 base 纳入分支名，或拒绝复用其他 base 正在准备的同版本分支。ci: 同步发版流程工作流到 main（删除署名机器人，新增「准备发版」） #714 的同一份工作流也需要同步修正。

2. [P2] 发版类 PR 会跳过 dev 提交混入 release 的检查。 changelog.py:906 在 kind == "release" 分支提前返回，后面的 dev_ref 检查不会运行。例如从 dev 准备的 Release v… PR 被误改目标为 release/*，只要版本号合规且碎片清空，就会放过随 PR 带入的 dev 独有提交。在独立临时仓复现：同一提交图按 normal 检查能报出混入的提交，按 check --pr-base release/v1.0.0-beta.1 --pr-kind release --dev-ref dev 检查却退出 0。建议把该检查放到类型分流前，让所有目标为 release 的 PR 都执行。

3. [P2] 上一正式周期有补丁时，更新弹窗会漏掉历史说明。 changelog.py:1351–1358 只保留一个 previous_final，但补丁段只含自身增量。用 v5.5.0 汇总、v5.5.1/v5.5.2 补丁及 v5.6.0[-beta.1] 复现，首行 JSON 只剩当前版与 v5.5.2，v5.5.0 的破坏性变更和 v5.5.1 修复均丢失。客户端只过滤这份 JSON，无法补回缺失段；从旧版跳升或切换通道的用户因此看不全更新说明。建议携带上一正式周期的补丁链及 X.Y.0 汇总，并增加检查内容完整性的用例。

4. [P2] 同名碎片再次使用时会署上旧作者。 changelog.py:721–722 从整条路径历史中取最早新增记录。碎片在发版后会被删除，后续 PR 可以再次使用同一分支名生成的文件名。实际复现 Alice 新增 → 发版删除 → Bob 新增同名碎片，fragment_author() 仍返回 alice，导致条目及贡献者列表署名错误。建议取最近一次新增记录，同时仍忽略该次新增之后的编辑。

验证：在该 HEAD 所在工作树自己的 Python 3.12.13 / pytest 9.1.1 环境运行，python -m pytest tests/tools/test_changelog_script.py -q -p no:cacheprovider --basetemp <全新临时目录> 68 passed；python -m pytest tests --collect-only -q -p no:cacheprovider 1013 tests collected，退出 0。第 2–4 项另用独立临时 Git 仓/纯函数实际复现。第 1 项核验了现有分支的版本计算和 action 源码，未实际触发远端发版工作流或创建发布 PR。初次测试遇到的日志及 pytest 临时目录 ACL 问题已通过适当权限和全新临时目录排除。