PT-Plugin-Plus项目版本号生成机制的优化探讨

在开源浏览器插件PT-Plugin-Plus的开发过程中，版本号生成机制是一个值得深入探讨的技术话题。当前项目采用基于Git提交计数的版本号生成方式，这一机制在实际使用中暴露出了一些值得改进的问题。

现有机制分析

目前PT-Plugin-Plus使用git rev-list --all --count命令获取所有分支的总提交数，然后对65535取模作为版本号的第四位（构建号）。这种设计存在两个主要问题：

1. 多分支干扰问题：当开发者本地存在多个分支时，即使基于相同的commit，不同分支环境也会计算出不同的版本号数字，导致构建结果不一致。

2. PR版本号异常：在Pull Request构建过程中，产生的版本号可能会大于主开发分支的版本号，导致部分用户误安装PR版本。

技术改进方案

针对上述问题，开发团队提出了几种技术改进方案：

方案一：Git描述标签法

建议使用git describe --tag命令替代现有方案，该方法会生成类似v1.6.1.2657-7-g6f07eb1a的版本描述。这种方式的优势在于：

• 基于最近标签计算提交数，不受其他分支干扰
• 包含Git哈希值，便于精确定位代码版本

不过该方案存在兼容性问题，因为WebExtensions规范要求版本号必须符合特定格式，完整的Git描述无法直接使用。

方案二：当前分支提交计数法

通过git rev-list HEAD --count命令仅计算当前分支的提交数，可以避免多分支干扰。这种方法实现简单，且能保持版本号格式合规。

方案三：PR构建特殊处理

对于Pull Request构建，可以采用特殊处理策略：

• 在GitHub Actions中，通过判断事件类型为pull_request时，设置浅克隆（fetch-depth:1）
• 使PR构建固定生成1.6.1.1这样的版本号
• 正常开发构建则保持递增的版本号

这种方案能有效防止用户误安装PR版本，同时保持主分支版本号的连续性。

技术决策与实现

经过团队讨论，最终决定采用组合方案：

1. 对于正式构建，保持现有机制但优化为仅计算当前分支提交数
2. 对PR构建采用特殊版本号处理
3. 本地构建则依赖开发者自行处理版本号问题

这种折中方案既解决了主要问题，又保持了实现的简洁性。对于高级用户，项目文档中应明确说明版本号生成机制，以便开发者根据需要进行调整。

版本控制系统与构建系统的协同设计是开源项目中的重要环节，合理的版本号策略不仅能提高开发效率，也能改善最终用户体验。PT-Plugin-Plus项目的这一优化过程，为类似项目提供了有价值的参考案例。