build: 发版时同步 uv.lock 版本,流程补 uv lock

现象:v0.0.8 发版后 uv.lock 里 study-tool 的 version 仍停在 0.0.1,与 metadata.yaml /
pyproject.toml 的 0.0.8 不一致,需要单独补一次提交。

根因:bumpversion 只配置了 metadata.yaml 和 pyproject.toml 两个文件。另外原有的两处正则
search 有两个坑:一是没开 regex = true(bump-my-version 默认按字面量搜索),二是仓库文件是
CRLF,`^...$` 锚点匹配不到行尾——真跑会直接报「Did not find」而不是改版本。

边界:只改发版配置和流程说明;不动业务代码、不改当前版本号、不打 tag。

运行了什么:`uv tool run bump-my-version bump patch --dry-run --allow-dirty -vv`,确认
metadata.yaml / pyproject.toml / uv.lock 三处都会被改、且 dry-run 没写盘(文件仍是 0.0.8)
没跑什么:没真跑 bump(会改版本号并自动提交、打 tag,留给你发版时执行);没跑测试、没构建
This commit is contained in:
study-tool
2026-11-01 20:50:16 +08:00
parent 4784ac0dcd
commit ecadae581e
2 changed files with 11 additions and 3 deletions
+2 -1
View File
@@ -69,7 +69,8 @@
## 发版本流程
- 发版本时,先把 `CHANGELOG.md` 的 `Unreleased` 变更整理成新的版本记录,并保留空的 `Unreleased` 标题。
- **只在发版提交时提升版本号**:`metadata.yaml` 的 `version` 与 `pyproject.toml` 的 `version` 一起改(bumpversion);普通提交不动版本号。
- **只在发版提交时提升版本号**:`metadata.yaml`、`pyproject.toml`、`uv.lock` 三处 `version` 一起改(bumpversion 已配置这三处);普通提交不动版本号。
- 发版提交前跑一次 `uv lock`,确认 `uv.lock` 里的依赖与 `study-tool` 版本跟 `pyproject.toml` 一致;有变化就一起提交。
- 提交范围:只提交本次任务的文件(`git add <具体路径>`)。提交前 `git status` 必须只剩本次任务的文件;出现别人的或无关的改动 → 停下问,不顺手提交。
- 提交完成后,给当前提交打最新版本号对应的 tag(如 `v0.0.8`)。打之前 `git tag -l` 查重、`git rev-parse HEAD` 确认,不覆盖已有 tag。
- 发版本流程中不要执行编译、测试或构建,除非用户明确要求;前端改动仍需 `pnpm build` 并把 `static/` 一起提交。