使用本页说明的功能时，建议阅读以下内容：
重要
请确保你使用的是最新版本安装包，否则可能出现兼容性问题。
点此确认安装包最新版本点此确认代码最新版本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 超完整包已经包含离线环境资源，可以减少环境下载失败；代码同步和后续更新仍建议保持网络可用。
每个大类至少要有一个联通，如果都不通，尝试使用手机热点或其他方式。
代码源 GitHubGiteePIP源 官方pip源清华pip镜像源阿里云pip镜像源2.下载安装/运行
使用安装器安装/运行（推荐）提示
你可以在以下位置下载到一条龙最新的安装包：
GitHub 的 Release 页面（对网络有一定的特殊要求）Mirror酱 需要 Mirror CDK（不免费但是可以支持开发者的开发）官方频道获取安装包（网盘下载）下载：新手优先下载最新的 -Full-Environment.zip 超完整包，里面包含安装器、启动器、当前代码、识别模型和离线环境资源，可以减少网络环境导致的安装失败。发布页还可能提供 -Full.zip、-WithRuntime.zip、-Installer.exe、-Launcher.zip、-RuntimeLauncher.zip 等文件。首次安装优先使用 -Full-Environment.zip；Launcher / RuntimeLauncher 压缩包主要用于已安装后的启动器更新，不建议当作首次安装包。
download_zip解压：在某个固态磁盘的根目录创建一个全英文的空文件夹，并解压缩安装包到刚才创建的路径，例如：D:\ZZZ-OD不要放在非英文字符路径下。 例如 "C:\用户\你的名字..." 这种路径会导致python环境无法创建。或者 "D:\英文\one-dragon..."，也不可以。不要包含空格。 可能会导致路径解析错误。不要使用过长的路径名。 例如"C:\THISPATHISWAYTOOOOOOOOOOOOOOOOOOOOOOOOOOOOLONG..." 会导致路径解析错误。一定要使用固态硬盘。 用机械硬盘不是不能用，但是凹深渊总是少几千分的话...如果你没有D盘，那你就用C盘吧。还有一些其他的奇怪情况，无法穷举，请务必按照上述要求创建路径。
folder_overview准备安装：以管理员身份运行 OneDragon-Installer.exe，先在路径选择窗口中选择最终安装目录。
路径不能是磁盘根目录。路径需要全英文，且不能包含空格。目录不为空时，安装器会提示内容可能被覆盖；首次安装建议选择空目录。如果安装器所在目录和目标目录不同，安装器会按安装清单搬运文件，并显示复制和清理进度。open_installer配置下载源：
安装器会先进入 配置源 页面，可选择 中国 - Gitee、中国 - GitHub 代理 或 海外。如果你在本机使用代理软件，可以在高级配置中把代理类型改为 个人代理，并填写代理软件监听地址，例如 http://127.0.0.1:7890。如果不确定，国内网络优先使用 中国 - Gitee；GitHub 加速器或代理可用时再使用 中国 - GitHub 代理。开始安装：
一键安装 会依次执行代码同步、UV 配置、Python 虚拟环境配置、运行环境同步和启动器安装。自定义安装 会按 代码同步、环境配置、安装启动器 分步执行，适合排查某一步失败的问题。基础安装完成后，安装器会进入可选的 扩展安装 步骤。当前扩展项是 虚拟手柄，需要后台模式、虚拟手柄或相关战斗辅助能力时再安装；安装过程中可能会弹出驱动安装提示，按正常安装流程继续即可。安装失败时，安装器会自动打开排障文档，也可以手动查看：热门问题文档。use_installer提示
UV、Python 虚拟环境和运行依赖安装时文件较多较大，可能需要一定时间下载或解压，请耐心等待。
清理安装残留（可选）。.install 文件夹内残留的安装压缩包，在安装成功后可以删除。
启动！安装完成后可以点击安装器中的 启动程序，也可以在安装目录中运行 OneDragon-Launcher.exe。
启动失败请参考：常见问题 或 热门问题文档 安装完成后，请参照必要设置进行游戏和脚本的基础配置。 高级启动参数请参考启动参数。
使用源码运行（可选）高级玩家可以查看详情使用源码运行 我觉得没必要
安装 uv（如果你有 uv 可以跳过此步骤）
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"创建并进入指定目录（以 C:\ 为示例）
$targetDir = "C:\"; if (!(Test-Path $targetDir)) { New-Item -ItemType Directory -Path $targetDir -Force }; cd $targetDir在该目录下克隆仓库
git clone https://github.com/OneDragon-Anything/ZenlessZoneZero-OneDragon.git进入项目文件夹
cd ZenlessZoneZero-OneDragon同步环境（uv 会自动处理 Python 版本和依赖库）
uv sync设置临时路径变量
$env:PYTHONPATH=".\src"启动程序
uv run python .\src\zzz_od\gui\app.py提示
如果第一步运行后提示找不到 uv，请重启 PowerShell 窗口，然后从第 2 步重新开始。
3. 代理说明GitHub 代理：用于加速 GitHub 相关下载。安装器默认会填入一个免费代理地址，也可以改成你自己可用的 GitHub 代理地址。
个人代理：适用于拥有自己代理软件的用户，请填写代理软件对应的监听地址。
比如某代理软件默认监听地址为 http://127.0.0.1:7890
无：适用于海外网络、代理软件运行在上级路由器、或系统网络已经能直接访问所需下载源的情况。
提示
如果使用了个人代理或在其他设备上运行了代理软件，使用镜像站可能会被站点拉黑，此时请切换下载源为官方源。
4.脚本如何更新目前版本一条龙默认启用自动更新功能，使用 exe 启动时会自动检测并更新代码。主界面标题栏会显示启动器版本和当前代码版本。
一条龙包含三个主要部分：
安装器
用于安装一条龙安装成功后可以删除，后续需要重新安装或修复环境时再下载最新版运行代码
一条龙的核心部分会频繁更新更新方式： 使用 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 -cproperties_demonstration