遇事不决！先看文档！

大部分常见问题会记录在问题排查文档，你可以通过文档内的大纲来快速定位问题！

重要

👉👉👉👉问题排查文档👈👈👈👈

如何寻求帮助？

说明

• 点击「此页内容」可以打开目录栏快速查找部分问题
• 优先阅读问题排查文档，尝试自行解决
• 如果查看了本文档仍旧无法解决你的问题，可以：
  1. 在 Issues 查阅是否有相似问题
  2. 如无相似问题，可以通过 Issues 提问
  3. 或前往官方频道
  4. 或前往频道关联群聊
• 提问前请先阅读下方 如何有效提问？ ，按清单准备信息

如何有效提问？

提问前请确保已仔细阅读问题排查文档，文档里已有的问题可能不会得到回复，提问时提供以下必要信息：

• 脚本截图：比如脚本配置

  • 确保脚本代码版本是最新版本
  • 确保脚本配置正确

• 游戏截图：在一条龙已启动的情况下，按下 F11，得到游戏画面截图

  • 截图会自动保存到剪贴板
  • 截图同时会保存在 .debug/images 文件夹内

• 日志：关键截图或文件均可

  • 脚本运行时会实时输出日志
  • 日志文件位于 .log/log.txt

下载与更新

软件下载

软件下载请点击前往

如何更新软件

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

1. 安装器

   • 用于安装一条龙
   • 安装成功后可以删除

2. 运行代码

   • 一条龙的核心部分
   • 会频繁更新
   • 更新方式：
     • 每次启动脚本时自动尝试更新
     • 点击左下角「代码同步」手动更新

3. 模型文件

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

神秘带锁功能

请前往官方频道寻找密码！

常见问题快速解答

我们推荐您前往 官方文档 查阅更多问题解答。 在 官方频道 导航栏中也有相关信息， 欢迎您留下宝贵的经验和建议！ 以下内容将在 2025-08-31 后冻结， 不再主动维护， 感谢您的支持与厚爱~

常见错误解决方案

403 错误

• 原因：被镜像站临时屏蔽
• 解决方案：
  • 切换其他下载源
  • 如无法启动，使用安装器切换源

404 错误

• 解决方案：
  • 检查安装器版本
  • 如果是 2.0 或更早版本，请更新到新版本

item 错误

• 解决方案：
  1. 打开设置 > 脚本环境 > OCR缓存
  2. 关闭 OCR 缓存

no attribute data 错误

• 解决方案：重启脚本

程序已退出（状态码：1）

• 解决方案：使用最新版本安装器重新执行安装流程

onnxruntime 错误

• 解决方案：
  1. 下载群文件中的 debug.bat 脚本
  2. 运行脚本修复

os error 3

• 解决方案：
  1. 检查报错的文件路径
  2. 确保路径纯英文且无空格
  3. 如有问题，请重新安装

Pyside6 错误

• 解决方案：
  1. 删除 .env 文件夹
  2. 重新安装

Python 路径错误

• 注意：脚本安装后不可更换文件夹
• 解决方案：如已更换，需要重新安装

Scheduler 被删除

• 说明：此文件已弃用
• 解决方案：运行 OneDragon-Launcher.exe 时添加 -o 参数

启动参数说明

• 查看所有参数：运行时添加 -h 参数
• 常用参数：
  • -o：启动时运行一条龙
  • -c：一条龙运行后关闭游戏

SSL 证书错误

• 解决方案：
  1. 下载群文件中的 debug.bat 脚本
  2. 运行脚本修复

WinError 系列错误

WinError 2

请查看常见问题文档寻求帮助

WinError 87

• 原因：Python 文件损坏
• 解决方案：
  1. 关闭杀毒软件后重新安装
  2. 如果问题持续，请检查：
     • 系统是否为 Win10 或更高版本
     • 是否有足够的权限

WinError 10060

• 原因：连接超时
• 解决方案：重新安装时选择自定义安装

WinError 10061

• 原因：服务器拒绝连接
• 解决方案：
  1. 使用管理员权限运行安装程序
  2. 关闭个人代理（如加速器）

其他常见问题

文件路径过长

• 问题：too long 错误，无法读取
• 解决方案：选择更短的安装路径

体力计划相关

体力计划执行错误

• 解决方案：配置后重启脚本

体力计划燃竭模式不执行

• 说明：体力计划会自动关闭燃竭模式
• 解决方案：如需使用，请手动刷取

委托助手报错

• 原因：组件不能同时运行
• 解决方案：
  1. 检查其他组件是否已关闭
  2. 建议使用 F10 快捷键或重启

安装相关问题

安装或启动失败（文档未涉及）

• 可能原因：缺少驱动或组件
• 解决方案：
  • 可申请付费远程协助
  • 注意：Win10 以前版本或 Mac 系统可能无法使用

安装启动器失败

• 解决方案：
  1. 从 Github 下载最新版启动器
  2. 放置于目标文件夹根目录

安装脚本失败

• 解决方案：
  1. 关闭所有个人网络代理
  2. 更换配置源
  3. 使用自定义安装，定位问题步骤

安装 Python 失败

• 解决方案：
  1. 检查安装器版本
  2. 2.0 或更早版本需更新
  3. 2.0 或更新版本请更换配置源

基本使用问题

日志文件位置

在游戏根目录下的 .log/log.txt

如何卸载脚本

直接删除脚本文件夹即可，不会残留大文件

如何安装脚本

1. 下载 FullEnvironment 包
2. 解压到目标文件夹
3. 使用安装器安装

后台运行

不支持后台运行，脚本需要鼠标交互

游戏路径配置

1. 打开米哈游启动器
2. 点击《绝区零》旁的按钮 > 游戏设置
3. 查看游戏目录路径
4. 注意：每个账户都需要配置

启动卡住

• 解决方案：
  1. 检查并更新脚本版本
  2. 首次运行可能需要 2-3 分钟(生成缓存或更新或其他)
  3. 启动失败时查看日志文件

特殊问题

什么是"拿命验收"

这是一个刷丁尼的副本

版本更新相关

2.0 之前版本更新

1. 删除原脚本文件夹
2. 下载并安装最新版脚本

2.0 之后版本更新

• 自动更新：运行启动器时自动进行
• 手动更新：如强制更新失败，使用
  • 启动器中的代码同步
  • 启动器下载功能

前往 问题排查文档 可查阅更多常见错误