跳至主要內容

快速开始

DoctorReid2026/4/25大约 8 分钟

使用本页说明的功能时，建议阅读以下内容：

重要

请确保你使用的是最新版本安装包，否则可能出现兼容性问题。

1.环境检查/准备

1.1.硬件

建议使用较新的电脑，我们的软件基于AI运行，依赖较新的硬件支持。

基于绝区零官方公告，正式开服的机型推荐配置为：

PC端：第十代英特尔酷睿i5，8G内存，英伟达GeForce GTX1660及以上

AMD请参考各家天梯图等效换算。

且本脚本需要额外的算力以支持OCR/推理。

E3等更低的配置 算力不够/缺少指令集 无法保证逻辑流畅运行，请优先考虑升级硬件。

有社区案例表明可以在插入VR眼镜后的 运行windows系统的Steam Deck 上运行。

但是请注意，Steam Deck 并非完美支持，可能存在一些兼容性问题。

如果你发现了新的兼容硬件不在上述清单中，欢迎前往官方频道分享。

1.2.系统

使用较新的Windows 10 64位及以上操作系统。

1.3.网络

运行失败的时候，可通过下方详情中链接确认连通性。

Full-Environment 超完整包已经包含离线环境资源，可以减少环境下载失败；代码同步和后续更新仍建议保持网络可用。

每个大类至少要有一个联通，如果都不通，尝试使用手机热点或其他方式。

2.下载安装/运行

使用安装器安装/运行（推荐）

提示

你可以在以下位置下载到一条龙最新的安装包：

  • 下载：新手优先下载最新的 -Full-Environment.zip 超完整包，里面包含安装器、启动器、当前代码、识别模型和离线环境资源，可以减少网络环境导致的安装失败。

发布页还可能提供 -Full.zip、-WithRuntime.zip、-Installer.exe、-Launcher.zip、-RuntimeLauncher.zip 等文件。首次安装优先使用 -Full-Environment.zip；Launcher / RuntimeLauncher 压缩包主要用于已安装后的启动器更新，不建议当作首次安装包。

download_zip
download_zip
  • 解压：在某个固态磁盘的根目录创建一个全英文的空文件夹，并解压缩安装包到刚才创建的路径，例如：
D:\ZZZ-OD
  1. 不要放在非英文字符路径下。
    • 例如 "C:\用户\你的名字..." 这种路径会导致python环境无法创建。
    • 或者 "D:\英文\one-dragon..."，也不可以。
  2. 不要包含空格。
    • 可能会导致路径解析错误。
  3. 不要使用过长的路径名。
    • 例如"C:\THISPATHISWAYTOOOOOOOOOOOOOOOOOOOOOOOOOOOOLONG..." 会导致路径解析错误。
  4. 一定要使用固态硬盘。
    • 用机械硬盘不是不能用，但是凹深渊总是少几千分的话...
  5. 如果你没有D盘，那你就用C盘吧。

还有一些其他的奇怪情况，无法穷举，请务必按照上述要求创建路径。

folder_overview
folder_overview

  • 准备安装：以管理员身份运行 OneDragon-Installer.exe，先在路径选择窗口中选择最终安装目录。

    • 路径不能是磁盘根目录。
    • 路径需要全英文，且不能包含空格。
    • 目录不为空时，安装器会提示内容可能被覆盖；首次安装建议选择空目录。
    • 如果安装器所在目录和目标目录不同，安装器会按安装清单搬运文件，并显示复制和清理进度。
    open_installer
    open_installer

  • 配置下载源：

    • 安装器会先进入 配置源 页面，可选择 中国 - Gitee、中国 - GitHub 代理 或 海外。
    • 如果你在本机使用代理软件，可以在高级配置中把代理类型改为 个人代理，并填写代理软件监听地址，例如 http://127.0.0.1:7890。
    • 如果不确定，国内网络优先使用 中国 - Gitee；GitHub 加速器或代理可用时再使用 中国 - GitHub 代理。

  • 开始安装：

    • 一键安装 会依次执行代码同步、UV 配置、Python 虚拟环境配置、运行环境同步和启动器安装。
    • 自定义安装 会按 代码同步、环境配置、安装启动器 分步执行，适合排查某一步失败的问题。
    • 基础安装完成后，安装器会进入可选的 扩展安装 步骤。当前扩展项是 虚拟手柄，需要后台模式、虚拟手柄或相关战斗辅助能力时再安装；安装过程中可能会弹出驱动安装提示，按正常安装流程继续即可。
    • 安装失败时，安装器会自动打开排障文档，也可以手动查看：热门问题文档。
    use_installer
    use_installer

提示

UV、Python 虚拟环境和运行依赖安装时文件较多较大，可能需要一定时间下载或解压，请耐心等待。

  • 清理安装残留（可选）。

.install 文件夹内残留的安装压缩包，在安装成功后可以删除。

  • 启动！

安装完成后可以点击安装器中的 启动程序，也可以在安装目录中运行 OneDragon-Launcher.exe。

启动失败请参考：常见问题 或 热门问题文档 安装完成后，请参照必要设置进行游戏和脚本的基础配置。 高级启动参数请参考启动参数。

使用源码运行（可选）

高级玩家可以查看详情使用源码运行 我觉得没必要

  1. 安装 uv（如果你有 uv 可以跳过此步骤）

    powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

  2. 创建并进入指定目录（以 C:\ 为示例）

    $targetDir = "C:\"; if (!(Test-Path $targetDir)) { New-Item -ItemType Directory -Path $targetDir -Force }; cd $targetDir

  3. 在该目录下克隆仓库

    git clone https://github.com/OneDragon-Anything/ZenlessZoneZero-OneDragon.git

  4. 进入项目文件夹

    cd ZenlessZoneZero-OneDragon

  5. 同步环境（uv 会自动处理 Python 版本和依赖库）

    uv sync

  6. 设置临时路径变量

    $env:PYTHONPATH=".\src"

  7. 启动程序

    uv run python .\src\zzz_od\gui\app.py

提示

如果第一步运行后提示找不到 uv，请重启 PowerShell 窗口，然后从第 2 步重新开始。

3. 代理说明

  • GitHub 代理：用于加速 GitHub 相关下载。安装器默认会填入一个免费代理地址，也可以改成你自己可用的 GitHub 代理地址。

  • 个人代理：适用于拥有自己代理软件的用户，请填写代理软件对应的监听地址。

    比如某代理软件默认监听地址为 http://127.0.0.1:7890

  • 无：适用于海外网络、代理软件运行在上级路由器、或系统网络已经能直接访问所需下载源的情况。

提示

如果使用了个人代理或在其他设备上运行了代理软件，使用镜像站可能会被站点拉黑，此时请切换下载源为官方源。

4.脚本如何更新

目前版本一条龙默认启用自动更新功能，使用 exe 启动时会自动检测并更新代码。主界面标题栏会显示启动器版本和当前代码版本。

一条龙包含三个主要部分：

  1. 安装器

    • 用于安装一条龙
    • 安装成功后可以删除，后续需要重新安装或修复环境时再下载最新版

  2. 运行代码

    • 一条龙的核心部分
    • 会频繁更新
    • 更新方式：
      • 使用 exe 启动时自动检测并更新
      • 点击左侧 `代码同步` 可手动更新，也可以切换分支或强制更新

  3. 识别模型和启动器

    • 一条龙基于图像识别，及时更新识别模型非常重要
    • 更新方式：
      • 通过 设置-资源下载 进行模型选择、模型更新和启动器更新
      • 模型后的数字表示日期，通常越新越好

5.高级启动参数

你可以使用纯命令行来启动OneDragon-Launcher.exe并添加参数以获取一些更加便捷的功能。

  • OneDragon 不支持自动启动运行，启动参数可完成 OneDragon 启动后自动运行。
  • OneDragon 自带拉起对应游戏的功能，请特别注意在 OneDragon 本体内选择好对应游戏的路径，否则无法拉起对应游戏启动。
  • OneDragon 参数也可自行在任务计划程序等填写善用，意图完成 OneDragon 自动启动运行。
usage: OneDragon-Launcher.exe [-h] [-v] [-o] [-c] [-s [SHUTDOWN]] [-i INSTANCE]

绝区零 一条龙 启动器

options:
  -h, --help            显示帮助信息
  -v, --version         显示版本号
  -o, --onedragon       一条龙运行
  -c, --close-game      运行后关闭游戏
  -s [SHUTDOWN], --shutdown [SHUTDOWN]
                        运行后关机，可指定延迟秒数，默认60秒
  -i INSTANCE, --instance INSTANCE
                        指定运行的账号实例，多个用英文逗号分隔，如：1,2

启动参数推荐示例（一条龙运行+运行完关游戏）：

OneDragon-Launcher.exe -o -c
properties_demonstration
properties_demonstration
最近更新:
贡献者: DoctorReid,idk500,Paper-white,Qian23333,Roy,wusaqi,Usagi-wusaqi,Mo-Qiong