用途：按 DeepChat 仓库既定流程准备和发布版本，避免在 main 上使用合并提交。
主要能力：先检查 git 状态（当前分支、工作区、release/<version> 与 v<version> 是否已存在）；选择发布模式，包括准备元数据、切出发布分支、更新已有发布分支、正式发布；更新 package.json 版本号并在 CHANGELOG.md 顶部新增条目，条目按英文在前、中文在后的顺序排列，日期用本地 YYYY-MM-DD；从最近提交或与上一标签的差异中提炼面向用户的变更。
必要用法：编辑元数据后运行 pnpm run format、pnpm run i18n、pnpm run lint，切分支前建议运行 pnpm run typecheck；发布需在 PR 获批后执行 pnpm run release:ff -- release/<version> --tag v<version>，随后删除临时发布分支。release/<version> 视为一次性分支，与 dev 上某提交一致，禁止用 GitHub 合并按钮或“Update branch”。
适用场景：准备发布、继续未完成的发布、按流程推送 release 分支、检查发布还差哪些步骤。
限制：具体命令以仓库 references/release-checklist.md 与 docs/release-flow.md 为准；纯发布元数据工作不创建 SDD 文件夹；若标签已存在于错误提交上需先询问；测试仅在用户要求、涉及行为变更或风险不明时运行，并需区分既有失败与本次阻塞失败。