二次开发规范:让外快项目也能长期维护
大多数「源码改烂」的事故,源于没有在一开始设计 **升级通道**。推荐做法: ## 1. 分支策略 - `upstream`:卖方原始代码,**永不直接修改** - `main`:团队二开主线,通过 cherry-pick 吸收上游更新 - `feature/*`:功能分支,保护性合并 ## 2. 代码隔离 - 用「插件/模块」方式承载二开功能,避免侵入核心文件 - 确需改动核心:加统一注释标记 `// @custom <date> <who>`,全局可检索 ## 3. 依赖治理 二开引入的第三方包在 `DEPENDS.md` 登记名称、版本、用途与协议,防止许可证传染。 ## 4. 数据库变更 每次变更写增量 SQL 并按版本号归档,保证「任意旧库 + 增量脚本 = 最新结构」。 ## 5. 环境一致性 第一时间补 Docker Compose,本地/测试/生产同一镜像,杜绝「我机器上是好的」。