必要设置

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

重要

• 不同标签页功能不可同时启用
• 请务必确保你的游戏和脚本根据此页面进行过基础设置，否则可能造成脚本运行失败等问题

首次使用检查清单

按照以下顺序逐项确认，全部通过后即可开始使用一条龙。

不熟悉左侧各入口用途时，可先查看界面导航。

1. 安装与启动

• 已选择一种方式完成安装，没有混用其他安装方式的文件
• 程序位于固态硬盘的纯英文、无空格路径（如 D:\ZZZ-OD）
• 已能按照所选方式正常启动 GUI
  • 集成启动器：运行 OneDragon-RuntimeLauncher.exe
  • 原始启动器：以管理员身份完成安装后，运行 OneDragon-Launcher.exe
  • 源码运行：完成 uv sync 后，运行 uv run python .\src\zzz_od\gui\app.py

安装细节请参考快速开始。

2. 游戏内设置（必须）

打开游戏，进入设置，逐项确认：

1. • 「设置」-「画面」-「显示模式」 设为 1920x1080 窗口
     • 游戏分辨率需要是 16:9 比例，如 1920x1080，其他分辨率若存在问题请尝试切换
     • 如果使用 全屏模式 ，则需要保证显示器分辨率为 16:9，否则请使用窗口模式
     • 使用过程中请保证游戏图像画面完整，不被任何 窗口/悬浮加速球/任务栏/FPS显示工具 所遮挡
2. • 「设置」-「画面」-「帧率」 建议限制在 30帧，正常配置电脑建议限制在 60帧
     • 请不要开启 无限帧率，过低帧数、画面卡顿或截图频率不足都可能导致识别出错
     • 画质不需要盲目拉高，以游戏画面稳定、脚本截图流畅为准
3. • 请不要开启任何可能改变显示器颜色的驱动或软件，包括但不限于
     • HDR（通过一条龙启动会自动禁用游戏HDR）
     • 护眼模式/夜间模式
     • N 卡滤镜（快捷键为 ALT+Z ）
     • XBOX 滤镜（快捷键为 WIN+G ）
4. • 「设置」-「输入」-「镜头灵敏度」 设为 2 或 3 可以保证脚本转视角时不会幅度过大错过识别点位；首次使用、切换鼠标/手柄或发现转向异常时，请运行 「一条龙」-「灵敏度校准」
5. • 「设置」-「输入」-「镜头自动跟随转动」 设为 关闭，功能拿命验收模拟按键以此为基础编写
6. • 「设置」-「其他」-「战斗伤害跳字显示」 设为 关闭 或 伤害跳字整合 可以避免部分情况下伤害数字遮挡画面
7. • 「设置」-「其他」-「字体选项」 选择 全局细体 可以有效避免文本识别不准的问题

警告

游戏内默认预设的「显示模式」、「镜头自动跟随转动」、「战斗伤害跳字显示」和「字体选项」，不太符合一条龙运行要求，请务必按照本页面进行设置，否则可能导致脚本无法正常运行，如识别失败、任务无法完成等问题。

3. 脚本设置（必须）

在一条龙 GUI 中逐项配置：

1. • 「账户管理」-「多账户管理」-「账户列表」 如果你拥有多个账号，请在这里添加不同的一条龙实例，不同实例之间设置会区分开需要分别填写
2. • 「账户管理」-「多账户管理」-「当前账户设置」-「游戏路径」 指向游戏本体（games\ZenlessZoneZero Game\ZenlessZoneZero.exe），而非启动器
3. • 「账户管理」-「多账户管理」-「当前账户设置」-「游戏区服」 选择你的区服，切换过区服需要重启一条龙
4. • 「代码同步」 已执行一次更新（或确认已是最新版本）
5. • 「设置」-「游戏设置」-「输入方式」 推荐选 剪贴板，避免输入法冲突
6. • 「设置」-「游戏设置」-「按键设置」 与游戏内实际按键一致（如果没改过游戏默认键位则不用动）
7. • 「设置」-「资源下载」 OCR 识别和需要用到的识别模型已下载（数字为日期，越新越好）

4. 预备编队

• 在游戏内设置好预备编队
• 在「一条龙 → 预备编队」点击「开始」自动识别
• 确认识别结果与游戏内编队名称一致
• 编队名称建议用中文，避免纯数字（OCR 容易识别错）

5. 一条龙运行

• 按需配置好一条龙运行的功能
• 回到「仪表盘」首页，确认就绪状态显示正常
• 点击「启动一条龙」或切换到「一条龙 → 一条龙运行」点击开始
• 观察右侧日志区域，确认脚本正常运行

提示

首次运行建议先不勾选全部功能，只选 2~3 个简单的（如邮件、活跃度奖励）测试一下，确认流程通畅后再全量运行。