后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载AutoBangumi 是一个全自动追番下载工具其核心逻辑由 Python 后端FastAPI与 Vue 3 WebUI 构成。本文基于仓库的英文贡献指南 docs/en/dev/index.md中文版见 docs/dev/index.md展开系统讲解外部贡献者如何参与 AutoBangumi 的开发从项目路线图与 RFC 提案机制到「分支开发、主干发布」的 Git 策略、PR 规范再到标签触发的自动发布流程。读完本文你将掌握为该仓库提交正确分支的 bug 修复与功能 PR 的完整方法并理解其版本号与 CI 发布链路背后的实现细节。项目路线图从哪里了解开发计划与参与机会AutoBangumi 开发团队使用 GitHub Project 看板管理计划中的开发任务、进行中的修复及其进度。在看板中除了常规的[Feature Request]、[BUG]与一些小优化项之外还有一类专门的[RFC]条目。查阅路线图的价值在于三点了解开发团队正在做什么找到与你想要的贡献方向一致、可以直接参与实现与优化的任务识别已经有人在做的内容避免重复劳动。仓库中已按类型配置了对应的 Issue 模板见 .github/ISSUE_TEMPLATE 目录从模板就能看出三类议题的边界议题类型Issue 模板适用场景RFC 功能提案rfc.yml较大功能/重构需要先讨论「怎么做」Feature Requestfeature_request.yml仅讨论「是否添加或改进某个功能」Bug Report 等bug_report.yml 等报告具体缺陷RFC大改动先写「技术设计文档」再动手对于小优化或 bug 修复可以直接改代码并提交 Pull Request但如果是一项较大的功能重构改动范围大、涉及的模块多贡献指南要求先通过 RFC 提案Issue 标签为RFC阐述「你打算怎么做」的简短方案寻求开发者讨论与共识。RFC 提案的定位是「在某功能/重构的具体开发之前供开发者之间 review 技术设计/方案的文档」其核心目的包括让协作的开发者清晰知道「要做什么」和「具体会怎么做」让所有开发者都能公开透明地参与讨论提前评估影响面遗漏的考虑、向后兼容性、与现有功能的冲突避免某些方案与开发团队已做出的决策相悖从而浪费大量精力。因此RFC 的重点是描述解决问题的方案、设计与步骤而非仅仅提出愿望。仓库中的 rfc.yml 模板也印证了这一点它要求依次填写「背景或问题」「目标 方案简述」「方案设计 实现步骤」「替代方案 对比」四个区块其中「方案设计 实现步骤」明确指出创建提案后仍可继续编辑补充体现出设计文档的迭代属性。若你只是想讨论「是否应该添加/改进某个功能」本身而非「如何实现」应使用[Feature Request]模板而不是 RFC。从仓库的规划文档也可以看出 RFC 机制的实际产出形态例如 docs/plans 目录下积累了2026-07-09-architecture-auth-modernization-design.md、2026-07-12-parser-engine-preview-design.md等设计文档它们正是「先设计、后开发」流程的落地证据。版本号规则SemVer 三位版本的含义AutoBangumi 的 Git 分支与发布版本规则紧密相关因此理解版本规范是选择分支的前提。项目遵循 语义化版本 SemVer 的Major.Minor.Patch三位格式Major主版本大版本更新很可能包含不兼容的配置/API 修改Minor次版本向下兼容的功能性新增Patch修订号向下兼容的 bug 修复与小优化修正。仓库的实际版本演进完全符合这一规则。例如 backend/pyproject.toml 当前声明version 3.3.6而 CHANGELOG.md 中可以看到3.3.6是「问题修复版本」修复了 RSS 匹配、网络、解析与部署问题属于典型的 Patch 发布3.3.4则引入了认证多用户会话、Parser Preview 等新功能属于 Minor 发布。版本号还会被写入module/__version__.py由构建流程生成仓库中不存在原始文件。分支开发主干发布main 与 X.Y-dev 的分工AutoBangumi 采用「分支开发主干发布」trunk-based release模式main分支是稳定版本的主干分支只用于发布版本不直接用于开发新功能或修复每一个 Minor 版本都有一个对应的开发分支用于开发新功能以及发布后的维护修复开发分支的命名规则为Major.Minor-dev例如3.1-dev、3.0-dev、2.6-dev。这种「主干只接收合并、不承载日常提交」的做法与 CI 发布链路完全对应。在 .github/workflows/build.yml 中Docker 构建工作流的 PR 触发分支明确限定为main与3.*-dev稳定版 tag 必须打在main的提交上才会触发正式发布。分支生命周期从开发、首发到维护与归档以一个 Minor 开发分支3.1-dev为例其完整生命周期如下3.1-dev完成新功能开发首次合入main分支发布 Minor 版本如3.1.0同时拉出下一个Minor 开发分支3.2-dev用于下一版本的新功能开发上一个版本开发分支3.0-dev进入归档不再维护当前 Minor 分支3.1-dev进入维护阶段——不再增加新功能/重构只维护 bug 修复维护分支上的 bug 修复合并到main后发布 Patch 版本。贡献者如何选择正确的基准分支根据上述生命周期贡献者选择 Git 分支的规则非常明确修复 Bug基于当前已发布版本的 Minor 维护分支开发修复并 PR 到该分支「当前已发布版本」即 Releases 页面上的最新版本添加新功能/重构基于还未发布的下一个版本的 Minor 开发分支开发并 PR 到该分支。这一规则在 CI 层面也有支撑发布分类逻辑只依据 event/ref/tag稳定 tag 必须位于main而 dev/测试分支只允许 alpha/beta 预发布 tag见 scripts/classify_release.py 中的STABLE_TAG与PRERELEASE_TAG正则及「稳定 tag 必须指向 main 上的提交否则拒绝发布」的校验。Git 工作流程一览贡献指南用一张提交时间线示意图展示整个流程即文首的 branch.png提交时间线从左到右。中文版 CONTRIBUTING.md 中还有对应的 Mermaid 图其关键节点如下main上先合入3.0-dev并打 tag3.0.9拉出3.1-dev开发新功能feat 4、feat 5、feat 6期间3.0-dev持续接收 fix 并合入main打3.0.103.1-dev首次合入main打 tag3.1.0同时拉出3.2-dev3.1-dev进入维护期fix 合入后main打3.1.13.2-dev继续开发 feat 7、feat 8 并接收 PR merge。可以看到main上交替出现「功能首发 tag」与「维护 fix tag」这正是「分支开发、主干发布」模式最直观的体现。Pull Request 规范让 Review 聚焦单一问题提交 PR 前请先按上文的分支管理章节确认目标分支修复 Bug→ PR 到当前发布版本的 Minor 维护分支添加新功能/重构→ PR 到下一版本的 Minor 开发分支。除此之外贡献指南还提出了四条核心要求一个 PR 只对应一件事不引入无关更改不同的事项拆分多个 PR让每次 Review 只专注一个问题在标题与描述中简要说明修改内容包括原因和意图若有相关 issue 或 RFC应链接到 PR 描述中帮助 Review 时最快了解上下文勾选「允许维护者编辑」Allow edits from maintainers便于维护者直接进行较小的编辑/重构节省大量时间确保本地通过单元测试与代码风格检查Lint这些也会在 PR 的 GitHub CI 中检查对于 bug fix 和新功能通常还会要求添加对应的单元测试覆盖。本地质量门禁测试、Lint 与类型检查的工具链「本地通过测试与 Lint」并非一句空话仓库为此配置了完整的 Python 工具链见 backend/pyproject.tomlpytest测试路径为src/testasyncio_mode auto并定义了e2emarker标注需要 Docker 的端到端测试pythonpath [src]保证测试可直接导入模块ruff行宽 88select [E, F, I]错误、未定义名、导入排序并忽略E501、F401black格式化器同样 88 列mypy类型检查check_untyped_defs true以捕获协程未 await 等真实 bug同时为module.__version__、httpx_socks、aiohttp等特殊模块配置了忽略规则pre-commit在开发依赖组中用于提交前自动执行钩子。backend/dev.sh 展示了本地开发环境的标准搭建方式创建 venv → 安装依赖 →pre-commit install安装 git-hooks→ 生成config/目录与module/__version__.py若缺失则写入VERSIONDEV_VERSION→ 用 uvicorn 以--reload --port 7892启动后端。如果你想快速启动一整套开发环境qBittorrent mock RSS 后端 WebUI还可以使用仓库根目录的 scripts/dev.sh./scripts/dev.sh up会拉起容器与前后端并自动完成初始化播种。这些门禁也会在 CI 中强制执行.github/workflows/build.yml 的testjob 会依次运行uv sync --group dev、ruff check src、mypy src以及pytest src/test -v -m not e2e排除需要 Docker 的 e2e 测试WebUI 侧则运行pnpm lint、pnpm test与构建测试。发布流程合并发布 PR 后自动触发版本发布目前由开发组手动合并特定的「发布 PR」后自动触发打包与发布这一机制在仓库中可以得到完整的源码级印证触发分类发布只由手动推送的 tag 触发合并 PR 不再触发发布防止 PR 标题被当作版本号见 CHANGELOG 中 #1065 的修复记录。分类逻辑由 scripts/classify_release.py 实现稳定版 tag如3.3.2必须指向main上的提交否则拒绝发布预发布 tag如3.4.0-beta.1允许在 dev 分支上打出镜像构建build-dockerjob 针对 release/dev 分别打latest与dev-latest标签跨linux/amd64、linux/arm64平台推送在线更新包发布时会生成update-bundle-version.zip内含 module 源码树、pyproject.toml/uv.lock、前端 dist 与manifest.json并附.sha256校验文件还会用UPDATE_SIGNING_KEY对 bundle 做 ed25519 签名.sig客户端更新器在应用前验签相关实现见 backend/src/update 与 backend/boot_overlay.py 的说明Changelog 自动挂载发布版本号按Major.Minor定位到 docs/changelog 下对应的 changelog 文件如3.3.md作为 GitHub Release 的正文发布节奏Bug 修复 PR 合并后通常会很快发版一般不到一周新功能发版时间更长且不确定以 GitHub Project 看板的开发进度为准——一个版本规划的新功能全部开发完备后才会发版。对于 beta 预发布版本仓库还提供了 scripts/generate-beta-notes.sh 用于自动生成 Release Notes它按feat/fix/perf/docs前缀对git log进行归类并自动探测上一个 beta tag 作为对比基准首次 beta 会输出 Initial Beta Release 提示。贡献文档的附加约定若你的贡献目标是文档本身中文版贡献指南 CONTRIBUTING.md 还有额外的约定文档更新请在独立的docs-update分支上进行修改PR 标题与描述中必须说明修改的目的和意图撰写文档尽量使用规范的书面化用语遵循 Markdown 语法与中文文案排版规范。这与主分支策略形成呼应文档改动同样是「单一关注点」的 PR便于 Review 快速理解上下文。文档本身也遵循多语言组织方式英文文档位于 docs/en日文文档位于 docs/ja中文文档位于 docs 根目录下。总结一次合规贡献的完整路径综合全文向 AutoBangumi 提交一次合规贡献的完整路径是查阅看板确认目标方向是否已有人在做避免重复工作规模判断小修复/新功能直接动手大重构先提交 RFC 提案寻求共识选择分支bug 修复基于当前已发布版本的X.Y-dev维护分支新功能基于下一版本的X.Y-dev开发分支本地验证pre-commit install后确保 pytest、ruff、black、mypy 全部通过并补齐单元测试覆盖提交 PR单一关注点、说明意图、链接相关 issue/RFC、勾选允许维护者编辑等待发布维护分支的修复通常一周内随 Patch 版本发布新功能则等待对应 Minor 开发分支整体完成开发后随 Minor 版本发布。这套「RFC 先设计 → 分支开发 → 主干发布 → 标签自动发布」的流程配合源码级的分支校验与签名更新包机制既保证了外部贡献的质量门槛也保证了稳定主干与快速迭代之间的平衡。赞分享后端前端音视频【免费下载链接】Auto_BangumiAutoBangumi - 全自动追番工具项目地址https://gitcode.com/gh_mirrors/au/Auto_Bangumi点击查看免费下载相关推荐AutoBangumi 贡献指南全解RFC 提案、Git 分支模型与 PR 协作流程AutoBangumi 贡献指南全解RFC 提案、Git 分支模型与 PR 协作流程 AutoBangumi 是一个全自动追番工具其仓库在持续演进中沉淀出了后端前端音视频AutoBangumi 贡献指南RFC 提案、分支管理与发布流程全解析AutoBangumi 贡献指南RFC 提案、分支管理与发布流程全解析 AutoBangumi全自动追番工具是一套由「后端Python/FastAPI后端前端音视频Dogecoin Core 贡献指南从分支策略到合并决策的完整协作流程解析Dogecoin Core 贡献指南从分支策略到合并决策的完整协作流程解析 本指南以 Dogecoin Core 仓库根目录下的 CONTRIBUTING.m区块链上一篇三步配置法国家中小学智慧教育平台电子课本批量下载方案下一篇Zotero Citation让Word文献引用效率提升90%的全攻略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考