会议要求「界面需补充明确的版本号标识」,且首个开源版本号定为 `0.0.1`。核对后发现在补显示之前,先得解决版本号没有唯一真源的问题。 ## 当前有四个互相矛盾的值 | 位置 | 值 | | --- | --- | | `README.md:17` / `README_ZH.md:11` | `0.3.0-dev` | | `CLAUDE.md:3` | `0.3.0-dev` | | `agents.lock.json:3` (`oneagent_version`) | `0.2.0-dev` | | `frontend/package.json:4` | `0.2.0-dev` | 会议又定了首版为 `0.0.1`,也就是第五个值。 ## 发布时的真源其实是第五处,且与上面全部无关 `.github/workflows/build-artifacts.yml:103` 用 ldflags 注入: ``` -X github.com/MaimoryLab/OneAgent/internal/version.Version=$RELEASE_VERSION ``` `RELEASE_VERSION` 来自 workflow 的手动输入,格式校验为 `^v[0-9]+\.[0-9]+\.[0-9]+$`(`:26`)。也就是说**发行包里的版本号完全由触发者手填**,仓库里那四个值一个都不参与,改它们不会影响产物。 注意校验要求带 `v` 前缀且**不接受预发布后缀**,所以 `0.3.0-dev` 这种值根本无法作为发布输入通过校验。 ## 界面里没有版本号 `grep` 全前端没有任何版本展示:`frontend/src/types/api.ts` 里的 `version` 字段全部是 **Agent** 的版本(`:84`、`:112` 的 `agent_version`),不是 OneAgent 自己的。侧栏、页脚、设置页都没有。 ## 建议 1. 以 `internal/version.Version` 为唯一真源,本地构建时给一个默认值(现在没有 ldflags 就是空字符串) 2. `StatusResponse` 增加一个字段把它带给前端,在侧栏或页脚展示 3. 删掉或改为引用 `agents.lock.json` 的 `oneagent_version` 与 `frontend/package.json` 的 `version`,避免继续分叉 4. README 与 CLAUDE.md 里的 `0.3.0-dev` 统一到实际要发的号 第 3 条要注意 `agents.lock.json` 是嵌入资源,`oneagent_version` 可能有消费方,改之前先确认。
Activity
Paulkm2006 commentedon Aug 6, 2026
fixed in 06b5357