桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载导读本文是一份面向开源贡献者的技术入门指南基于项目官方招募文档docs/develop/RECRUITING.md并结合仓库源码、配置与开发文档编写。你将了解绝区零一条龙ZenlessZoneZero-OneDragon这套完整产品级自动化工具的架构技术栈看到从「修一个 good first issue」到「独立设计架构模块」的三条参与路径并通过 Fork、环境搭建、跑通 GUI 与测试、提第一个 PR 的完整步骤在本机把开发环境真正跑起来。一、项目概况这不是一个简单的脚本项目绝区零一条龙是面向 Windows 的《绝区零》全自动辅助工具核心功能涵盖自动战斗、自动闪避、日常一条龙、空洞零号含迷失之地、多账号管理等。从 pyproject.toml 可以看到它的工程定位Python 3.11requires-python 3.11.9,3.12、uv 包管理、src-layout布局、仅支持win32平台。项目采用严格的源码分层见 AGENTS.md目录职责src/one_dragon/通用基础框架配置、环境、工具、YOLO 能力、条件操作框架src/one_dragon_qt/通用 Qt GUI 框架与公共组件src/onnxocr/自研 OCR 推理引擎PaddleOCR 移植src/zzz_od/绝区零业务代码application、operation、context、gui、auto_battle 等config/运行时 YAML 配置战斗模板、路线、挑战配置等assets/截图、模板、游戏数据等资源docs/develop/面向开发者的完整文档体系官方招募文档强调「这不是一个简单的脚本项目。你会接触到完整的产品级技术栈。」下面逐项展开每条都对应仓库中的真实代码与配置。二、核心技术栈全景你能接触到的六类技术1. 桌面应用开发PySide6 Fluent Design 组件库GUI 基于PySide6 6.11.1与pyside6-fluent-widgets 1.11.2见 pyproject.toml采用 Fluent Design 风格。从源码结构看公共组件集中在 src/one_dragon_qt/widgets/顶层已有40 个组件文件如navigation_button.py、setting_card/、combo_box.py、log_display_card.py、pip_window.py等另有app_setting/、download_card/、install_card/等子包与文档所述「46 自定义组件」相互印证。新功能的设置界面并非从零画控件而是复用现有模式设置卡片、YamlConfigAdapter、AdapterInitMixinsrc/one_dragon_qt/widgets/adapter_init_mixin.py。这正是 AGENTS.md 中「功能开发优先路径」的要求——新界面沿用现有 setting card 模式配置改动优先落到 YAML 与对应YamlConfig子类。2. 机器学习部署ONNX Runtime DirectML YOLO 音频分析推理引擎依赖onnxruntime-directml1.24.4DirectML GPU 推理模型加载与推理封装在 src/one_dragon/yolo/onnx_model_loader.py。目标检测src/one_dragon/yolo/ 提供yolov8_onnx_det.py检测与yolov8_onnx_cls.py分类两个封装用于画面中的敌人、角色、界面元素识别。音频特征分析依赖soundcard与librosa见 pyproject.toml服务于自动闪避等对音效敏感的检测场景配合 assets/template/dodge_audio/ 中的音频模板。异步推理调度gpu_executor负责 GPU/ONNX session 的异步调用AGENTS.md 明确要求「必须通过gpu_executor.submit不要并发直调多个 session」核心实现在 src/one_dragon/utils/gpu_executor.py调用方包括 src/one_dragon/yolo/onnx_model_loader.py 与 src/onnxocr/predict_base.py。3. OCR 引擎自研 onnxocrPaddleOCR 移植src/onnxocr/ 是基于 PaddleOCR 移植的自研引擎包含完整推理管线predict_det.py文字检测、predict_rec.py文字识别、predict_cls.py方向分类、db_postprocess.py/rec_postprocess.py后处理、onnx_paddleocr.py系统集成。引擎按「端到端优化」思路维护是理解 OCR 部署、调参与优化的最佳入口。4. 游戏自动化截图、输入模拟、模板匹配、多线程输入模拟pyautogui键鼠与pynput监听手柄支持通过可选依赖vgamepad提供pyproject.toml。图像处理opencv-python 4.13.0.92做模板匹配与图像分析模板资源在 assets/template/角色状态、战斗按钮、各界面元素图像分析流水线定义在 assets/image_analysis_pipelines/。条件操作框架所有自动化行为由「条件 → 操作」节点编排文档见 docs/develop/one_dragon/modules/conditional_operation.md节点实现在 src/one_dragon/base/operation/。多线程架构截图、推理、操作分别跑在不同线程gpu_executor统一调度 GPU 推理任务。5. 工程化实践uv、PyInstaller、多仓库协作、遥测uv 包管理pyproject.toml 中[tool.uv]配置了cache-dir与environmentsdev 依赖组ruff、pytest、mcp、pyright 等与运行依赖分离。打包PyInstaller 集成运行时spec 文件在 deploy/OneDragon-Installer / Launcher / RuntimeLauncher 三份 spec配合module_manifest.py生成模块清单。多仓库协作主仓功能实现与测试仓zzz-od-test测试代码分离YOLO 训练仓、数据集、官网 blog 各自独立全貌见 docs/develop/setup/repositories.md。主仓不保留测试测试统一在zzz-od-test/test/须 clone 到仓库根目录。遥测与通知通知系统支持多渠道文档见 docs/develop/one_dragon/modules/notify.md。6. 架构设计插件化应用系统与异步任务调度插件化应用系统新功能优先做成Application通过ApplicationFactory接入见 AGENTS.md业务应用集中在 src/zzz_od/application/架构文档见 docs/develop/one_dragon/modules/application_plugin_system.md 与 docs/develop/guides/application_plugin_guide.md。异步任务调度应用以异步任务方式调度多应用可并行运行相关设计见 docs/develop/one_dragon/modules/application.md。三、社区贡献者的真实成长四种典型路线招募文档记录了几位贡献者真实发生的成长轨迹这也勾勒出项目的协作风格——社区给方向、项目给场景贡献者在真实任务中逐级深入起点成长路径规模更新 README 与兑换码独立负责锄大地路线 → 迷失之地、恶名狩猎、体力计划等全模块7 个月内 58 个 commit修复 lock 文件与依赖管理GUI 组件开发代码编辑器、通知渠道卡片→ 独立设计通知系统整体架构92 个 commit单个角色战斗模板配置掌握自动战斗全架构角色状态识别、闪避时机判定、多角色协作策略7 个月 73 个 commit覆盖 40 角色游戏内商店功能开发转向代码质量与工程化OCR GPU 修复、自动战斗时间戳 bug、引入 Copilot/CodeRabbit 规则15 个 commit方向比数量更重要这些故事揭示了一个共性从小而具体的任务进入文档、配置、单角色模板在真实业务场景中逐步触达架构层。项目对 PR 的评审关注逻辑错误、运行时崩溃、死循环与资源泄漏而非风格洁癖降低了新人的进入门槛。四、三条参与路径按你的基础选择切入点入门路径适合刚学 Python修复带good first issue标签的 issue从社区维护者筛选好的小任务开始改动面小、反馈快。编写新角色的战斗模板配置目录为 config/auto_battle_state_handler/。该目录已包含 100 个*.sample.yml模板速切、站场、连携、支援攻击、闪A、轮换、快速支援等是「照葫芦画瓢」式的低门槛入口。开发锄大地路线目录为 config/world_patrol_route/含system/系统路线与路线列表 config/world_patrol_route_list/玩法文档见 docs/develop/zzz/application/world_patrol.md。以战斗模板为例看一份真实配置的结构节选自 config/auto_battle_state_handler/速切模板-艾莲.sample.ymltemplate_name: 速切模板-艾莲 handlers: - states: [前台-艾莲] # 触发条件角色在前台 interrupt_states: [前台-能量, 0, 0.1] ![前台-艾莲] sub_handlers: # 黄光操作 - states: [自定义-黄光切人, 0, 1] operations: - operation_template: 艾莲-支援攻击 # 红光操作 - states: [自定义-红光闪避, 0, 1] operations: - op_name: 设置状态 # 内建操作 state: [自定义-艾莲-快速蓄力] - operation_template: 艾莲-闪A # 复用操作模板可以看到模板的编排逻辑handlers按**状态条件states**分组条件命中后执行operations内建op_name操作或复用operation_template模板并可嵌套sub_handlers处理更细粒度的分支终结技可用、失衡期间、非失衡站场等。理解这套「条件 → 操作」结构就能为任意角色编写自己的模板。进阶路径有 Python 基础想做更多开发新的游戏自动化应用先读 docs/develop/guides/application_plugin_guide.md了解Application的接入方式与生命周期框架侧整体架构见 docs/develop/one_dragon/one_dragon_architecture.md。改进 GUI 组件与用户体验组件集中在 src/one_dragon_qt/widgets/注意遵循 Fluent Design 风格并复用现有组件。编写和补充测试用例测试统一在独立测试仓zzz-od-testclone 到仓库根目录方法论见 docs/develop/testing/README.mdFixtureController流程测试基建见 docs/develop/testing/fixture_controller.md。高级路径想挑战架构与算法ML 模型训练与部署src/one_dragon/yolo/ 的模型加载与推理封装训练仓与数据集见 docs/develop/setup/repositories.md迷失之地检测模型设计见 docs/develop/zzz/application/lost_void/det_model.md。OCR 引擎优化src/onnxocr/ 的检测/识别/分类与后处理管线。GUI 框架扩展基于 pyside6-fluent-widgets 扩展 Fluent Design 组件库。多线程架构优化gpu_executor异步推理src/one_dragon/utils/gpu_executor.py涉及并发调度与性能调优。五、快速开始把项目在本机跑起来以下步骤与 docs/develop/setup/quickstart.md 一致分三阶段按需推进——只想先把 GUI 跑起来完成阶段 ① 即可。阶段 ①跑起来核心1. 获取代码Windows PowerShell 环境外部贡献者先 Fork 再 clone 自己的 fork并可选添加 upstream 方便同步主仓更新git clone https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon.git cd ZenlessZoneZero-OneDragon git remote add upstream https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon.git2. 安装 uvwinget install --idastral-sh.uv -e # 或irm https://astral.sh/uv/install.ps1 | iex装完重开终端uv --version能输出版本即成功。3. 初始化 Python 环境并安装依赖uv sync --group devuv 会按requires-python 3.11.9,3.12自动准备 Python 3.11.x无需手动安装 Python。--group dev必须带项目default-groups []不带只会装运行依赖漏掉 ruff / pytest / mcp / uvicorn 等 dev 工具。成功判据生成.venv/命令无报错退出。4. 让src/进入模块搜索路径src-layout 前提项目是src-layoutpackage false源码不会自动进sys.path二选一IDE推荐把src/设为 Sources RootPyCharm或 VS Code 设置PYTHONPATHsrc。命令行每个新 PowerShell 会话先$env:PYTHONPATH src会话级或setx PYTHONPATH src永久需重开终端。5. 跑起来验证uv run src/zzz_od/gui/app.py主窗口弹出即阶段 ① 完成app 本身不读任何环境变量。阶段 ②跑测试可选测试代码在独立仓zzz-od-testclone 到本项目根目录下外部贡献者先 fork 再 clone 自己的 forkgit clone https://github.com/OneDragon-Anything/zzz-od-test.git zzz-od-testIDE 里将zzz-od-test/设为 Test Sources Root运行方式含所需环境变量见 docs/develop/README.md。测试改动随主仓 PR 以同分支名一起提交CI 按分支名匹配 clone 测试仓。阶段 ③配 AI 工具可选项目把游戏感知/操作窗口状态、截图、OCR、进游戏通过 MCP 暴露给 Agent辅助开发与调试# 1) 起后端 server:23001项目根目录另起常驻终端 uv run python -m zzz_od.backend.entry.server # 2) 注册到 Claude Code再另开终端 claude mcp add --transport http zzz_od http://127.0.0.1:23001/mcpMCP 工具清单见 docs/develop/zzz/backend/mcp.md。项目还提供开发类 skillzzz-od-dev-*位于 skills/叠加在 superpowers 开发流程方法论之上。六、贡献流程与协作规范提第一个 PR 前必须知道的事AGENTS.md 定义了完整的协作约束这里提炼对新贡献者最关键的四点测试在独立仓提交主仓git add zzz-od-test/...会被.gitignore静默跳过必须git -C zzz-od-test add test/ git -C zzz-od-test commit单独提交否则 PR 会丢测试。两仓协同测试仓建同名分支feat/xxx↔feat/xxx主仓 commit 与测试仓 commit 配对推进开主仓 PR 时同开测试仓 PR跨仓链接用OneDragon-Anything/repo#N完整写法禁止裸#N合并顺序为测试仓先、主仓后。PR 规范PR title 遵循type(scope): subject≤50 字符、祈使句、无句号type ∈ feat/fix/docs/refactor/test/chore/perf/build/ci/stylePR description 写「为什么改why1-3 句 改动要点what分行 bullet 关联Closes #N」不展开实现细节。开发硬约束所有函数签名与类成员变量都要有类型注解list[str]、X | Y注释与 docstring 用中文禁止相对导入路径操作使用pathlib字符串格式化使用 f-stringGUI 优先复用 pyside6-fluent-widgets 与现有组件1080p 坐标是项目既有前提文档与文字用大白话不造自造黑话。涉及游戏流程的改动遵循「先理解玩法 画面再动手」的开发链路画面建档zzz-od-dev-screen-onboardingskill→ 开发为 Application Operation → 用留档截图在测试仓补流程测试 → 提 PRassign DoctorReid / ShadowLemoon→ 按需配套模型或使用说明。完整流程见 docs/develop/development_workflow.md。七、统一的文档入口与求助渠道建议按以下顺序消化项目知识项目级 AI 协作入口AGENTS.md先读只保留直接影响实现落点与提交流程的约束开发文档索引docs/develop/README.md详细编码规范docs/develop/spec/agent_guidelines.md知识分层与上下文工程docs/develop/harness/README.md理解「方法进 skill、具体进 doc」的文档组织原则框架与模块架构docs/develop/one_dragon/ 及其modules/子目录游戏业务设计docs/develop/zzz/。遇到问题时可以在项目的 GitHub Discussions 或社区频道提问入口见仓库 README也可以带着「我看了哪个文档、改了哪个文件、期望什么行为、实际发生了什么」的描述直接找维护者社区乐于帮助新人完成第一个 PR。结语从一张战斗模板、一条锄大地路线到 OCR 引擎优化与通知系统架构设计绝区零一条龙为不同基础的贡献者提供了完整的技术成长阶梯。本文的每一步——技术栈对应、参与路径选择、环境搭建命令、PR 协作规范——都可在仓库源码与开发文档中逐一验证。选择适合你当前水平的入口按 docs/develop/setup/quickstart.md 把环境跑起来然后去挑一个good first issue开始你的第一个 commit。赞分享桌面应用RPA计算机视觉【免费下载链接】ZenlessZoneZero-OneDragon绝区零 一条龙 | 全自动 | 自动闪避 | 自动每日 | 自动空洞 | 支持手柄项目地址https://gitcode.com/gh_mirrors/ze/ZenlessZoneZero-OneDragon点击查看免费下载相关推荐DS2API Ollama兼容接口指南3个接口让Ollama客户端直连DeepSeek模型DS2API Ollama兼容接口指南3个接口让Ollama客户端直连DeepSeek模型 DS2API 是一款 DeepSeek 兼容中间件接口通过 Ol桌面应用RPA计算机视觉绝区零一条龙新手零基础快速上手指南绝区零一条龙新手零基础快速上手指南 绝区零一条龙是一款专为《绝区零》玩家设计的全自动辅助工具支持自动战斗、日常任务清理等核心功能。无论你是游戏新手还是希望提桌面应用RPA计算机视觉绝区零一条龙零基础快速上手完整指南绝区零一条龙零基础快速上手完整指南 绝区零一条龙是一款专为《绝区零》玩家设计的全自动辅助工具能够帮助新手和普通用户轻松实现自动战斗、日常任务清理等核心功能。桌面应用RPA计算机视觉上一篇Chrome二维码插件的完整技术指南高效实现跨设备内容同步下一篇5分钟掌握Chrome二维码插件快速安装与终极使用指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考