Peach: Local-first video metadata scraper and media manager.
docs(release): 将依赖升级纳入定版前批次
longmeidao699a954ee866
diff --git a/.claude/skills/peach-worktree/SKILL.md b/.claude/skills/peach-worktree/SKILL.mdindex d1093b158..a391f76eb 100644--- a/.claude/skills/peach-worktree/SKILL.md+++ b/.claude/skills/peach-worktree/SKILL.md@@ -24,7 +24,7 @@ description: Peach 代码任务开工,以及创建、提交、集成或回收4. `ready` 前纳入当前 `master` 并验证最终内容。提交、声明与记录齐全后取得 `ready` 的实际结果。5. 协调者执行 `integrate --branch <分支>`,等成功退出并核对主线提交,再做适用重启和运行核验。锁忙交入口等待,不手工 merge 绕过,不把分支交接当成验收完成。-主检出 master 的直接提交与手工 merge 由 hook 拒收。版本推进、标签与发布只走 `scripts/release_tag.py`,发布核对按运行文档与 `docs/TESTING.md`;发布时机采用 `release_due.py` 及集成入口的同一判据,不额外重复检查。+主检出 master 的直接提交与手工 merge 由 hook 拒收。发布先完成 `docs/TESTING.md`「每次发版检查」的依赖升级批次,再通过 `scripts/release_tag.py` 定版、打标签与发布;更新清单不代表升级完成。发布时机采用 `release_due.py` 及集成入口的同一判据,不额外重复检查。## 修复的升级生效范围diff --git a/docs/OPERATIONS.md b/docs/OPERATIONS.mdindex 9cbabd0e9..8da5b814b 100644--- a/docs/OPERATIONS.md+++ b/docs/OPERATIONS.md@@ -709,6 +709,7 @@ Windows 托盘在取得单实例锁后启动独立监视器。监视器用 Win32- 版本号只在 `src/peach/__init__.py::__version__` 里定义,采用 pre-1.0 SemVer。Git 提交是构建标识,`vX.Y.Z` 标签是发布点,推到 GitHub 就触发 Release 工作流(见「桌面入口与发布」)。- 版本号在发布时才动,一次发布加一格,所以每个 `X.Y.Z` 都有一份能下载的制品。+- **依赖升级**:定版前完成[每次发版检查](TESTING.md#每次发版检查)的依赖升级批次,包括适用的兼容修改、派生产物、完整验证与本地集成;暂不能升级的保留具体原因和失败证据。定版后发现需要改依赖时,先保存发行说明草稿,撤回本轮尚未提交的版本修改,完成升级后重新定版。- **定版**:在干净的 master 主检出上运行 `python scripts/release_tag.py --bump auto --apply`。它按上一个版本标签到 HEAD 的区间定档(`bump_part_for()`:主题以 `feat` 开头、带破坏性标记 `!`,或 `migrations/` 有新文件时推 minor,其余推 patch;1.0 要手工 `--bump major` 并另立 ADR,见 ADR-0012),写入 `__version__`,并把 `CHANGELOG.md` 的未发布一节定成这个版本号。区间只改了文档、技能和测试时直接拒绝,因为那样打出的包和上一个标签完全相同。`--bump` 只写文件不提交,并打印定版的那一节供人检查;不带 `--apply` 只打印计划。- **发布**:确认之后运行 `python scripts/release_tag.py --ship --apply`,一次完成剩下四步:提交 `src/peach/__init__.py` 与 `CHANGELOG.md`(消息 `chore(release): 版本 <新版本>`)、推送 master、每 30 秒查一次这个提交的 Test 工作流、变绿后创建并推送 annotated tag。默认最多等 30 分钟,用 `--timeout` 修改。不带 `--apply` 只打印步骤。- `--ship` 在动手前检查:不在 master、变更日志缺这一节、标签已被占用、工作区除了那两份定版文件还有别的改动,任何一条成立就拒绝(标签指向发布提交,夹带什么就等于发布什么)。Test 结束不是绿色就立刻停,这时标签还没打。diff --git a/docs/TESTING.md b/docs/TESTING.mdindex b8148ffea..b5435b2c2 100644--- a/docs/TESTING.md+++ b/docs/TESTING.md@@ -53,9 +53,16 @@ Dependabot 的 PR 一律在本地接管,不在网页上合:### 每次发版检查-`release_tag.py --bump auto --apply` 在写版本前调用 `release_review.py`,检查两份 Python 锁、两份 npm 清单的可用更新、Dependabot 待处理 PR、sha 固定的运行依赖及其最新稳定发布,以及登记表中全部非 manual 参考来源。独立检查入口为 `scripts/release_review.py`;报告存于 `build/release-review.json`,含提交、时间、差异与逐项错误。Docker 与 GitHub Actions 的更新以 Dependabot PR 为线索,不据空 PR 列表断言全部最新。+依赖升级是定版前的固定批次。发版授权包含检查、适用升级、兼容修改、派生产物、验证和集成,不能只列出可用更新就进入定版。-网络失败记为「未取得」,其余检查继续;检查不全时版本文件保持原样。发现更新只报告,由智能体对照真实消费者、字段语义与许可证判断采用范围;升级依赖沿用隔离工作树与完整验证。原文证据按 `peach-reference-evidence` 审阅后接受,人工笔记不被网页覆盖。+1. 核对两份 Python 清单与锁、两份 npm 清单、Docker 镜像、GitHub Actions 和 SHA 固定的运行依赖。优先接管 Dependabot 已有 PR,保留编号和来源;同时核对稳定版本,过时的 PR 目标和未被 PR 覆盖的更新一并处理。运行时遵守项目的平台范围及官方支持周期。+2. 在依赖升级隔离工作树中审阅大版本迁移、真实消费者、字段语义、许可证和平台兼容性,更新精确版本与锁文件,重算 vendor 和前端产物。SHA 固定的运行依赖按清单注释审阅上游差集;参考文档变化只作为证据,不自动覆盖实现。+3. 行为变化跑对应定向回归;按界面技能完成适用预览确认后,代码冻结运行正式全量验证,取得 Windows、macOS 及适用制品证据,再走 ready / integrate。不能升级的逐项记录新旧版本、具体兼容问题、失败证据和恢复条件;其余独立升级继续完成,不用笼统的「留待以后」跳过整批。+4. 在升级已合入的干净 master 上运行 `release_tag.py --bump auto --apply`,复核当前提交的审计与上游报告并起草发行说明。确认措辞后继续 `--ship --apply`;定版与标签阶段不另行改变依赖。++`release_tag.py --bump auto --apply` 在写版本前调用 `release_review.py`,检查两份 Python 锁、两份 npm 清单的可用更新、Dependabot 待处理 PR、SHA 固定的运行依赖及其最新稳定发布,以及登记表中全部非 manual 参考来源。独立检查入口为 `scripts/release_review.py`;报告存于 `build/release-review.json`,含提交、时间、差异与逐项错误。Docker 与 GitHub Actions 的更新以 Dependabot PR 为线索,不据空 PR 列表断言全部最新。++网络失败记为「未取得」,其余检查继续;检查不全时版本文件保持原样。审计门槛仍由发布入口执行,不能用暂缓升级的说明放过高危漏洞。原文证据按 `peach-reference-evidence` 审阅后接受,人工笔记不被网页覆盖。升级批次是发布工作流程;现有 `release_tag.py` 不自动改依赖或创建升级分支。用户手动提供的公开参考正文可通过 `--reference-evidence SOURCE=FILE` 明确用于本次检查。报告记录用户取证渠道、原始 URL 与正文 SHA-256,直接网络取证仍标为「未取得」;参数不修改来源登记、快照或后续发版的默认检查。