ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

ZenlessZoneZero-OneDragon 多仓库协作布局与发布链路指南

ZenlessZoneZero-OneDragon 多仓库协作布局与发布链路指南 桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载本文以项目开发文档 相关仓库 为骨架系统梳理「绝区零 一条龙」项目ZenlessZoneZero-OneDragon的多仓库协作全景主仓、CNB 国内镜像、独立测试仓、YOLO 模型训练仓、ModelScope 数据集与官网博客各司其职、如何联动发布。读完本文你将掌握各仓库的落点与职责边界、GitHub→CNB 的双向发布链路、测试仓与训练仓的 clone 布局约定、以及开发者和 AI Agent 在此布局下的正确协作姿势。一、总览六个仓库/载体各司其职本项目不是单仓开发而是多仓库协作主仓承载业务代码测试、模型训练、数据集与官网分开维护。开发文档在 repositories.md 中用一张表给出全貌是开发者与 AI Agent 理解「各自落点」的第一份索引项类型位置用途何时去动主仓gitOneDragon-Anything/ZenlessZoneZero-OneDragon业务代码、GUI、文档日常开发CNB 镜像gitOneDragon-Anything/ZenlessZoneZero-OneDragoncnb.cool国内代码镜像、Release 附件镜像发布链路维护测试仓gitOneDragon-Anything/zzz-od-test测试代码 画面截图存档跑/改测试、加截图yolo 训练仓gitOneDragon-Anything/OneDragon-YOLOYOLO 模型训练 release 发布训练/发模型数据集非 gitModelScope见下文YOLO 训练数据训练时拉取官网 bloggitonedragon-anything.github.io官网 / 用户向文档站Pages改官网内容两个值得提前记住的本地布局约定测试仓必须 clone 到主仓根目录内同名目录zzz-od-test/详见下文第三节yolo 训练仓 / 数据集 / 官网建议放在与主仓同一父目录如../OneDragon-YOLO、../dataset、../onedragon-anything.github.io彼此平级、互不嵌套。贡献者身份也会影响协作方式组织/项目成员有主仓 push 权可直接 clone外部贡献者需 fork 后 clone再提 PR 回主仓具体命令见 quickstart §①。二、主仓与 CNB 镜像GitHub → CNB 的完整同步链路主仓同时维护在 GitHub 与 CNB国内代码托管平台两侧代码分支/Tag 与 Release 附件分别由两条自动化链路同步共同构成发布链路的骨架。1. 分支与 Tag 镜像sync-cnb.yml工作流 .github/workflows/sync-cnb.yml 负责把 GitHub 的分支与 Tag镜像到 CNB。其触发条件有三push常规推送workflow_dispatch手动触发workflow_run监听Build Test Branch工作流成功完成后再补一次同步。最后一条是关键补丁Build Test Branch使用GITHUB_TOKEN推送 test 分支而 token 推送不会触发push事件导致镜像缺失因此需要靠workflow_run事件兜底补齐。镜像动作本身在 ubuntu 上执行git clone --bare主仓后添加 CNB remote再以--force --prune方式整体推送refs/heads/*与refs/tags/*实现两侧分支、Tag 的完全一致。2. Release 附件同步build-release.yml→ CNB OpenAPI →.cnb.ymlRelease 附件安装包、启动器等的同步链路更长分为三段触发GitHub Release 创建成功后.github/workflows/build-release.yml 末段Trigger CNB Release sync步骤使用仓库 SecretCNB_TOKEN调用 CNB OpenAPIhttps://api.cnb.cool/.../-/build/start提交一个event api_trigger_release、env.RELEASE_TAG指定版本的流水线构建。该 Token 需要目标仓库的repo-cnb-trigger:rw权限触发失败只标记该步骤异常continue-on-error: true不阻断 GitHub Release 本身与其他发布渠道。流水线执行CNB 按根目录 .cnb.yml 的api_trigger_release阶段执行python tools/ci/sync_github_release_to_cnb.py --release-tag $RELEASE_TAG使用流水线内置的临时CNB_TOKEN。同步实现tools/ci/sync_github_release_to_cnb.py 的ReleaseSynchronizer完成「拉取 GitHub Release 元数据与附件 → 在 CNB 创建或更新同 Tag Release → 逐个下载 GitHub 附件再上传到 CNB」的完整动作。要点已有同 Tag Release 时走 PATCH 更新ensure_cnb_release先 GET 404 则创建、否则更新同名附件会覆盖upload_asset携带overwrite: True因此流水线可以安全重跑附件上传使用自定义ProgressReader按 64 MiB 间隔输出进度日志避免大文件上传期间流水线无日志输出附件下载有 3 次重试且校验下载大小与 GitHub 声明的size一致防止传输截断。3. 手动兜底web_trigger_release除 API 触发外CNB 页面上还保留了web_trigger_release入口执行 .cnb.yml 中的「同步最新 GitHub Release」阶段不带--release-tag参数用于手动把 GitHub 最新正式版同步到 CNB。而 API 触发时通过环境变量RELEASE_TAG指定具体版本两者配合即可覆盖「最新版」与「指定历史版本」两类场景。三、测试仓zzz-od-test独立仓的协作约定与提交坑测试代码与画面截图存档独立成仓zzz-od-test测试方法论入口见 docs/develop/testing/README.md。围绕它有四条硬性约定1. 位置必须 clone 到主仓根目录git clone https://github.com/OneDragon-Anything/zzz-od-test.git zzz-od-test主仓根目录 .gitignore 第 4 行zzz-od-test/显式忽略该目录因此它不会被主仓误跟踪IDE 中应把zzz-od-test/设为Test Sources Root跑测试、改测试、画面截图存档screens/都在这个目录里完成。2. ⚠️ 提交坑主仓git add会被静默跳过主仓执行git add zzz-od-test/...会被.gitignore静默跳过不报错但文件根本没加入暂存区。正确做法是在测试仓内部提交git -C zzz-od-test add test/ git -C zzz-od-test commit -m ...这一约束在 docs/develop/testing/README.md 第 7 节有明确提醒也是协作中最容易踩的坑之一。3. fork 后 clone 同分支名提 PR外部贡献者同样需要fork 后 clone测试仓测试改动要随主仓 PR使用同分支名一起提交——CI 按分支名匹配来 clone 测试仓因此两侧分支名必须一致。4. AI Agent 注意Grep/Glob 默认看不到测试仓由于.gitignore的存在Grep/Glob 等工具默认尊重忽略规则不会自动搜索zzz-od-test/。AI Agent 查/改测试时必须用Read/grep等工具显式指定路径否则会漏掉测试代码。四、yolo 训练仓OneDragon-YOLO模型训练、发布与主仓消费链路yolo 训练仓OneDragon-Anything/OneDragon-YOLO负责训练游戏内 YOLO 目标检测模型迷失之地交互入口、闪光分类、枯壤境界等玩法训练代码在src/one_dragon_yolo/zzz/玩法/下。发布规范训练完成的模型打包成模型名.zip以 release tagzzz_model发布到OneDragon-Anything/OneDragon-YOLO主仓按需下载消费。训练流程的详细文档目前标注待补充各玩法模型文档如 迷失之地检测模型则记录其在主仓的来源与消费链路。以迷失之地检测模型为例可以看清这条链路的主仓侧实现配置src/zzz_od/config/model_config.py中的_DEFAULT_LOST_VOID_DET/_BACKUP_LOST_VOID_DET新模型下载失败时回退 backup 模型业务封装LostVoidDetectorsrc/zzz_od/application/hollow_zero/lost_void/context/lost_void_detector.py继承Yolov8Detector提供「感叹号 / 距离 / 入口」等业务判断下载解压OnnxModelLoadersrc/one_dragon/yolo/onnx_model_loader.py从zzz_modelrelease 下载模型名.zip并解压到assets/models/lost_void_det/模型名/。该文档还给出了 zip 发布规范与两个踩坑点供训练仓发布者参考zip 内必须平铺labels.csvmodel.onnx于根目录框架用extractall解压多一层目录会找不到模型且标签文件只认labels.csv首行idx,label不认训练侧常见的model_label.txt。五、数据集非 git 托管于 ModelScope训练数据不是 git 仓库托管在 ModelScope模型社区平台按玩法-Dataset命名。已知的数据集包括SR-ObjectDetZZZ-FlashClassifyZZZ-LostVoidDetZZZ-WitheredDomainDet本地使用时按数据集名建目录如dataset/ZZZ-LostVoidDet-Dataset/。文档明确说明完整清单与托管入口以训练仓为准主仓文档不逐一维护清单避免随数据集新增而过时——这也是多仓库协作下「单一事实来源」的典型处理方式。六、官网 blogonedragon-anything.github.io官网与用户向文档站GitHub Pages org 站单独成仓onedragon-anything.github.io。新手入门指南、公告、致谢名单等用户向内容在此维护与面向开发者的 docs/ 目录职责互补。本地建议 clone 到与主仓同一父目录../onedragon-anything.github.io与 yolo 训练仓、数据集平级。七、贡献者落地指南内部成员 vs 外部贡献者结合 quickstart.md 的实操步骤不同身份在不同仓库的操作方式汇总如下仓库组织/项目成员外部贡献者主仓git clone https://github.com/OneDragon-Anything/ZenlessZoneZero-OneDragon.git先 Fork 再 clone 自己的 fork提 PR 回主仓测试仓git clone ...zzz-od-test.git zzz-od-test主仓根目录内同样 fork 后 clone测试改动随主仓 PR 同分支名提交yolo 训练仓 / 数据集 / 官网与主仓同一父目录平级存放训练仓与数据集主要在训练/发模型与拉取数据时使用外部贡献者建议额外配置 upstream remote 以便同步主仓更新git clone默认只设origingit remote add upstream https://github.com/OneDragon-Anything/ZenlessZoneZero-OneDragon.git八、小结理解这套布局的收益把握本项目的多仓库布局对开发者与 AI Agent 有三层实际收益职责边界清晰业务代码主仓、测试zzz-od-test、模型训练OneDragon-YOLO、训练数据ModelScope 数据集、用户文档官网 blog各归其位改动哪个仓库只影响对应链路发布链路可追踪GitHub 分支/Tag 由 sync-cnb.yml 镜像Release 附件由 build-release.yml .cnb.yml sync_github_release_to_cnb.py 三段接力同步且失败不互相阻断具备可安全重跑的特性协作约定可执行测试仓的 clone 位置、.gitignore静默跳过、同分支名 PR、AI Agent 显式路径搜索等约定都是为了在 CI 与多仓协作下减少「改了没生效」「提交了没进包」的隐性故障。相关文档入口相关仓库本文源文档 · 快速开始 · 测试方法论 · 开发文档索引 · 迷失之地检测模型消费链路赞分享桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载相关推荐adk-samples 仓库的 Agent 协作规范Recipe 术语、仓库布局与 Python 工具链实操指南adk samples 仓库的 Agent 协作规范Recipe 术语、仓库布局与 Python 工具链实操指南 导读 AGENTS.md https://l示例工程Astron Agent 仓库开发协作指南多语言模块架构、通信链路与端到端发布验收工作流Astron Agent 仓库开发协作指南多语言模块架构、通信链路与端到端发布验收工作流 本篇技术指南基于开源仓库 AGENTS.md https://lin人工智能AI AgentAgent 编排RPA后端前端企业应用Moby 仓库的 IDE 配置指南GoLand 接入、GOPATH 布局与开发容器协作流程Moby 仓库的 IDE 配置指南GoLand 接入、GOPATH 布局与开发容器协作流程 本篇基于 Mobymoby官方贡献文档 set up ide.云原生容器运行时虚拟化容器编排上一篇天龙八部GM工具终极指南如何快速掌握单机版游戏数据管理技巧下一篇如何用GoQt5打造个人离线音频库喜马拉雅FM下载器实战指南创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表