绝区零一条龙快速开始

DoctorReid2024年9月1日大约 6 分钟

重要

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

1.环境检查/准备

1.1.硬件

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

基于绝区零官方公告，公测要求支持配置最低为：

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

且本脚本需要额外的算力以支持OCR/推理，因此本项目运行基本配置为：

台式机
- 第八代英特尔酷睿i5及以上
- 8G内存及以上
- 英伟达GeForce GTX1060及以上
笔记本
- 第十二代英特尔酷睿i5及以上
- 8G内存及以上
- 英伟达GeForce GTX1060及以上

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

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

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

如果你发现了新的兼容硬件不在上述清单中，欢迎分享

1.2.操作系统

打开你的windows update，确认升级到最新版本。
运行较新的Windows 10/11 64位系统。

1.3.网络

你可以先跳过这个步骤，运行失败的时候，再通过下方详情中链接确认连通性。

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

代码源
- Github
- Gitee
PIP源

2.下载

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

GitHub 的 Release 页面
Mirror酱需要 Mirror CDK（不免费但是可以支持开发者的开发）
我们的官方频道
或前往频道关联群聊

推荐下载带有 -Full-Environment 的超完整包来避免网络环境导致的安装失败。
Mirror源默认下载的就是这个包。

源码下载，仅适用高级玩家。

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

3.安装

在某个固态磁盘的根目录创建一个全英文的空文件夹，然后再开始我们的安装过程，例如：

D:\ZZZ-OD

不要放在非英文字符路径下。
- 例如 "C:\用户\你的名字..." 这种路径会导致python环境无法创建。
- 或者 "D:\英文\one-dragon..."，也不可以。
不要包含空格。
- 可能会导致路径解析错误。
不要使用过长的路径名。
- 例如"C:\THISPATHISWAYTOOOOOOOOOOOOOOOOOOOOOOOOOOOOLONG..." 会导致路径解析错误。
一定要使用固态硬盘。
- 用机械硬盘不是不能用，但是凹深渊总是少几千分的话...
如果你没有D盘，那你就用C盘吧。

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

使用安装器安装（推荐）

此处教程以 2.1.1-beta1 版本的 Full-Environment 的完整包为基准。

解压缩安装包到刚才创建的路径。
运行安装器。

以管理员身份运行安装器，等待安装器界面打开。
点击浏览选择路径，默认选择当前解压的文件夹。
选择合适的下载源，Full-Environment 包默认已经包含了需要下载的工具，仅需要下载代码。
默认预设了三个配置好的源，如果开加速器/代理软件，请选择海外源并参考下文代理说明进行配置。
点击一键安装或自定义安装，按步骤点击下一步，等待配置完成。

提示

UV和Python环境安装这一步文件较多较大，可能需要一定时间下载，请耐心等待下载。

清理安装残留（可选）。

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

启动一条龙。

安装完成后使用 OneDragon-Launcher.exe 即可启动。

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

高级手动安装（可选）

高级玩家废话少说。

git clone https://github.com/OneDragon-Anything/ZenlessZoneZero-OneDragon.git
cd ZenlessZoneZero-OneDragon
pip install -r requirements-prod.txt
pip install -r requirements-gamepad.txt
# 启动游戏
./OneDragon-Launcher.exe

代理说明

Github 免费代理，可以加速所有 Github 下载相关步骤（代码同步，环境下载，Python下载）可以在网络上找到很多免费提供加速的服务商。
个人代理，适用于拥有自己代理软件的用户，请填写代理软件对应的监听地址。
比如某代理软件默认监听地址为 http://127.0.0.1:7890
无，一般不推荐使用，代理软件使用了 pac 模式、代理软件运行在上级路由器和海外的用户可以直接使用此项。

提示

tip：如果使用了个人代理或在其他设备上运行了代理软件，使用镜像站可能会被站点拉黑，此时请切换下载源为官方源。
tip2：免费的github代理地址推荐。

https://github.moeyy.xyz/
https://ghfast.top/
https://ghfile.geekertao.top/ https://gh.dpik.top/

4.脚本如何更新

目前版本一条龙默认启用自动更新功能，在你启动 OneDragon-Launcher.exe 时会尝试一次自动更新。启动器右上角会显示当前代码版本的哈希值。可在启动器左下角点击 代码同步 功能进行代码的手动更新。 一条龙是基于图像识别，所以及时更新识别模型非常重要。可以通过 设置-资源下载 进行模型的选择和更新，模型后面的数字为日期，一般来说越新越好。

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

绝区零 一条龙 快速开始

绝区零一条龙快速开始