从下载开始，
跑通你的第一个任务。
不用先研究所有设置。跟着这份图文教程，先下载并启动客户端，再完成账号注册、卡密充值、资源更新、添加功能，最后保存并运行。
从首页下载开始：以诛仙世界为例
本教程仅以诛仙世界为例，首页中的对应入口叫“诛仙小黑盒”。先下载所用游戏的下载器，由下载器取得完整客户端，再启动盒子。
请在首页选择你实际使用的游戏对应的下载入口。本教程只是以诛仙世界举例，不代表所有人都要下载“诛仙小黑盒”。使用其他游戏时，请下载对应游戏的客户端，再参考后续流程操作。
第一步：在首页点击“诛仙小黑盒”
- 回到首页，找到“诛仙小黑盒”卡片
点击下图红箭头指向的“诛仙小黑盒”卡片开始下载。还没打开首页，可以先点返回首页，在游戏卡片中选择“诛仙小黑盒”。
返回首页，在页面底部找到“教程首页”按钮，点击它右侧的“不会下载? 点击查看下载教程”，按下载教程中的说明操作。也可以直接打开下载教程。
第二步：找到并双击下载器，等待客户端下载好
- 在浏览器下载列表中找到下载器
等待浏览器下载完成，找到 诛仙小黑盒下载器.exe，如图1。文件可能在“下载”文件夹，也可能在你选择的保存位置；图1演示的是放在桌面上的文件。
- 双击图1的下载器
下载器会继续下载客户端安装包。此时先等待下载和解压完成，不要只看到下载器文件就以为已经安装好盒子。
- 等待自动解压并打开文件夹
下载器会把客户端解压到桌面的对应文件夹，并自动打开文件目录。下载器完成后退出，接下来使用文件夹中的盒子主程序。
下载器会清理桌面同名的旧客户端文件夹后重新解压。需要保留的旧文件、日志等，请先备份到其他位置。
第三步：打开客户端目录，右键管理员运行主程序
- 看到图2的完整目录，就可以继续
如果没有自动打开，去桌面找到刚解压的客户端文件夹。保留里面的全部文件；不要把主程序单独拖出文件夹运行。
- 找到“小黑盒(右键管理员运行).exe”
图2最下方这一项才是盒子主程序。上面的 data、log 文件夹和说明文件都保留在原目录中。
- 右键点击主程序，选择“以管理员身份运行”
这里是右键鼠标打开菜单。如果菜单中没有直接显示，可以点“显示更多选项”再找到“以管理员身份运行”。
- 确认 Windows 的权限提示，等待盒子打开
如果出现用户账户控制窗口，确认要运行的是这个客户端，点击“是”。随后查看是否出现下面的键鼠安装提示，处理完成后继续“注册与登录”。
查看关闭杀毒软件与安全中心教程，按 Win10、Win11 的实际界面检查相关设置，尤其留意应用阻止与内核隔离。
第四步：首次初始化键鼠，出现安装提示时必须安装
盒子启动时会初始化宏键鼠（DV 键鼠）。登录后，键鼠模式会按当前游戏的默认值或已保存的设置恢复，界面中可能显示“宏键鼠”“驱动键鼠”或“消息键鼠”。首次使用先保持默认设置。
如果初始化时出现下图的“Windows 安全中心”设备软件安装窗口，请按下面两步完成安装。没有出现这个窗口，就跳过本步，继续注册与登录；无需专门寻找这个安装窗口。
- 勾选“始终信任来自……的软件”
在盒子初始化弹出的窗口中，核对设备名称与发布者对应下图（Envoy Corp 人机接口设备 / Shenzhen Evision Semiconductor Technology），勾选左下方的“始终信任来自……的软件”。
- 点击“安装”，等待安装完成
点击右侧的“安装(I)”，不要点击“不安装(N)”。这是 DV 键鼠正常使用所需的设备软件，跳过或拒绝安装可能导致键鼠初始化失败、任务无法正常操作。
- 安装完成后，继续注册与登录
等待盒子继续初始化。若仍提示宏键鼠载入失败，先确认刚才已经完成安装，再重新以管理员身份运行盒子并查看提示。
首页下载 → 打开下载器 → 等待解压 → 右键管理员运行主程序 → 键鼠初始化（出现安装提示就安装，无提示跳过） → 注册并登录 → 卡密充值绑定游戏 → 自动重启 → 检查与更新游戏资源 → 添加并运行任务。
第一次打开，没有保存的登录信息时，会进入登录面板。新账号注册并登录后，先充值绑定游戏；充值成功重启后，程序才会检查该游戏的资源，有更新时自动下载并应用。如果以前已经登录且绑定了游戏，程序会恢复登录后检查资源，通常无需再手动登录。
继续前，准备好充值卡密
还没有卡密，可以在淘宝店或代理处购买。游戏会根据充值卡密自动绑定，充值后盒子会加载该游戏的功能和资源，按后续步骤完成充值即可。
了解盒子：它怎样操作游戏？（可选阅读）
盒子是一个模拟按键的自动化流程工具，通过图形识别、OCR 文字识别、YOLO 目标检测及 AI 模型等技术识别画面，再模拟键盘、鼠标操作，按你配置的流程执行任务。盒子不会读取或写入游戏内存，而是通过画面识别和模拟操作完成流程。
游戏与盒子的登录先后没有固定要求。点击“开始”启动任务时，有一个可以让盒子操作的游戏目标即可。例如目标游戏窗口已经打开，并处于该功能要求的画面或状态；具体要求按功能说明准备。
三个词先分清，就不会填错
用于登录 BOX-PC、充值和保存配置。不是游戏账号。
一套任务方案，包含要执行的功能、参数及相关账号信息。
任务里的一个执行步骤。把需要的功能按顺序加入“执行”列表。
注册一个盒子账号
按上一节右键以管理员身份启动主程序后，在“请登录盒子”面板进入注册。
- 点击“注册”
登录面板会切换为“注册盒子账号”。已有盒子账号则直接输入账号、密码，点击“登录”。
- 填写账号、密码、确认密码
账号和密码都必须是 5–16 位英文字母或数字，不支持中文、空格或符号。确认密码再输入一次，必须与密码一致。
- 点击“注册并登录”
成功后程序会自动登录并加载工作台，无需再次注册。如果注册已成功但自动登录失败，使用刚注册的账号重新登录。
新账号还需要卡密充值。继续下一步即可，暂时无法添加或运行游戏任务属于正常情况。
充值：先预览，再确认
点击工作台底部的“充值”，打开“卡密充值”面板。
- 先看“当前登录”是否正确
卡密会充值到这里显示的盒子账号。发现账号不对，先取消，在“设置”里退出登录并换成正确账号。
- 粘贴完整卡密，点击“预览卡密”
预览会查询卡的信息，不会消费卡密。预览成功后，“确认充值”才可以点击。
- 查看卡密信息和预计到期时间
游戏由卡密自动绑定。预览后查看充值时长（旧卡转入时显示剩余时长）、当前到期和预计到期，确认后继续充值。
- 点击“确认充值”，等待程序重启
充值成功后客户端会自动重启。重新打开后进入“设置”，核对账号到期时间，并等待游戏资源加载完成。
确认成功后，卡密不能再次充值。请妥善保存激活卡密；当前充值界面说明，密码找回或账号交易争议时，平台以激活卡密作为账号归属凭证。
先点“预览卡密”，并确保预览成功。修改了卡密后，必须重新预览。充值结果不明确时，先重新打开客户端核对到期时间。
充值后，等待游戏资源准备完成
- 重启后，让客户端自动检查资源
程序恢复登录，确认绑定游戏后会检查该游戏的资源。没有更新时直接加载工作台；有更新时显示下载与应用进度。
- 等待资源更新及重启处理完成
更新应用时程序可能退出并重新打开。等待自动处理完成，再查看功能菜单；不要在更新中途添加或开始任务。
- 资源就绪后，继续新建配置
看到日志提示“游戏资源已就绪，可以配置并执行任务。”，更新窗口已结束，并且“功能”列表中已出现当前游戏的功能，就可以继续新建配置。若仍显示下载或应用更新，请继续等待；若提示资源升级失败或功能加载失败，先处理提示的问题，再继续。
认识界面，只看六个位置
任务流程页从左到右：配置 → 功能 → 执行 → 功能参数。运行状态看下方日志。
- 1最左侧：配置列表新建和选择任务方案；“完成后”决定当前配置结束后做什么。
- 2功能（双击添加）这里是当前游戏可用的全部功能。展开分类后，双击具体功能名称，将它添加到中间的执行列表。
- 3执行（双击删除）这里是本次任务要做的步骤。从选中的功能开始向下执行；想从头运行，先选第一项。双击名称删除，右键可删除或清空，按住前面的点状手柄可上下排序。
- 4功能参数单击执行列表中的某项功能，这里就显示它的说明和参数。按提示填写，不懂时点击旁边的问号查看说明。
- 5运行日志这里只显示程序运行的基本进度、状态和提示。技术排查需要导出的详细日志，不能只用这块界面日志。
- 6底部操作按钮开始、停止、充值、设置、保存配置。
功能目录由绑定游戏决定。“多账号”“多窗口”也只在对应游戏支持时显示。配图以诛仙世界为例，使用其他游戏时，请在自己的功能列表中选择对应功能。
新建“我的第一个任务”
配置就是保存任务步骤的容器，先有配置，再添加功能。
- 点击左上角“+ 新建配置”
在弹出的“新建配置”面板中输入一个好认的名称，例如“我的第一个任务”。
- 点击“创建配置”
新配置会出现在左侧列表中。确认当前选择的是你刚创建的配置。
- “完成后”先保持“结束任务”
这样当前配置执行完就结束。以后需要接着执行另一套配置，再设置跳转。
也可以直接选中它来添加功能，不必重复新建。多个配置互相独立，编辑前先确认左侧选中了哪一个。
把要做的功能，加入执行列表
先选左侧的配置，再照着下面的配图操作。可以把“功能列表”理解为可选菜单，把“执行列表”理解为你安排好的任务步骤。本节按当前登录的一个游戏账号演示。
- 在功能列表中，找到你要做的事
进入“任务流程”，在“功能（双击添加）”列表中展开分类。这里列出当前游戏可用的全部功能；只需要把本次要用的功能加入任务，不用全部添加。
- 双击具体功能名称，添加到执行列表
双击分类里的具体功能，中间“执行”列表就会新增这一项。新增后，检查它是否出现在列表中，再继续添加下一项。双击分类标题只是展开或收起分类。
- 单击执行列表中的功能，查看说明并填写参数
单击你刚添加的功能，右侧就会显示它对应的功能说明、教程和参数项。先读说明，确认游戏需要处于什么状态，再按每个参数的提示填写或选择。不懂某个参数，就点击它旁边的问号（?）查看说明；有教程链接时，也可以点开学习。参数较多时，向下滚动右侧区域，检查下面是否还有需要填写的内容。
- 按住功能前面的点状手柄，上下拖动排序
执行列表就是本次任务需要执行的功能列表，通常按排列顺序从上往下执行。需要调整先后顺序时，把鼠标放到功能名称前面的点状手柄上，按住鼠标左键，上下拖到目标位置后松开。例如想先做 A、再做 B，就把 A 放在 B 上面。
- 添加错了，可以删除；需要重做，可以清空
删除一项：双击执行列表里的功能名称，或右键该功能选择“删除”。清空全部：在执行列表中打开右键菜单，选择“清空”，确认后会移除当前配置的所有执行功能。删除或清空后，需要的功能可以从左边重新添加，并重新填写参数。
- 逐项检查参数，点击“保存配置”
把执行列表里的功能逐个单击一遍，确认对应参数已按要求填写。点击底部“保存配置”，在运行日志中确认出现“配置已保存。”。
左边功能列表：双击添加。中间执行列表：单击看参数，双击名称删除。调整顺序：按住名称前面的点状手柄上下拖动。编辑参数时只需单击，避免双击把功能删掉。
照着做一次：添加一个功能并保存
以配图中选中的第二项功能为例，这里先完成添加、填写参数和保存。你使用其他游戏时，选择自己要用的功能，并按该功能的说明准备游戏和参数。
- 选配置，双击添加需要的功能
选中“我的第一个任务”，在左边展开分类，双击目标功能名称，确认它已经出现在中间的执行列表中。
- 单击它，读说明并填写参数
看右侧的功能说明，按要求准备游戏状态。配图中有“押镖次数”，单次练习可填写 1；其余选项按说明选择，向下滚动检查完整参数。其他功能的参数不同，不能照搬这里的字段。
- 保存这个配置
点击“保存配置”，确认日志提示“配置已保存。”。这个功能就准备好了，接下来按下一节启动任务。
左侧选中了正确配置，中间列出了你要运行的功能，单击后右侧能显示对应说明和参数，日志提示“配置已保存。”。接着看下一节“运行任务”，启动刚才保存的配置。
运行任务：选好起点，再点击开始
在“任务流程”页点击“开始”，执行任务的是游戏里当前登录的账号：游戏登录哪个账号，就操作哪个账号，不会因为你登录了盒子而替你切换游戏账号。盒子账号用于登录和充值，当前游戏才是任务操作的对象。需要批量多账号或多窗口运行，请看后面的多账号 / 多窗口进阶教程。
沿用上一节刚保存的配置，下面开始运行这个任务，无需重新添加功能。先确认起点，再按开始；任务有没有执行，看日志和游戏中的实际结果。
- 确认游戏资源和到期时间
确认盒子账号授权未到期、游戏资源已就绪，并且有可以让盒子操作的游戏目标。先读功能说明，把游戏放到对应画面或状态；键鼠模式先保持默认值。
- 回到“任务流程”，选中第一项功能
普通任务从当前选中的执行项开始。如果刚才正在填写最后一项参数，必须先点击第一项，才能从头执行。
- 确认已保存，点击“开始”执行任务
出现“配置已保存。”后，点击“开始”，或使用默认快捷键 F11。快捷键可在“设置”里更改，以按钮上的提示为准。
- 观察运行日志；需要时点击“停止”
停止的默认快捷键为 F12。出现“停止中…”时等待停止完成，再修改任务或充值。正常结束会显示“任务已完成。”；异常会显示“任务失败：”及原因。
运行日志看进度，详细日志交给技术排查
界面下方的“运行日志”用于告诉你程序正在做什么、是否就绪、是否完成或出现了什么提示，是方便日常查看的基本日志。它只是粗略的进度和状态提示，不能作为技术排查问题的详细依据。
查看导出详细日志教程，按步骤找到对应日志文件，再把导出的日志文件和问题发生时的操作步骤提供给技术人员。不要只发送界面日志的截图或几行文字；技术需要详细日志才能进一步排查。
开始前，照着勾选一次
勾选框仅帮助自查，不会连接客户端或替你执行任务。
设置：这些选项分别做什么？
点击底部“设置”打开设置页。第一次使用按默认值即可；需要调整时，先停止任务，修改后点击“保存配置”，便于下次打开时恢复。
账号信息与退出登录
这里显示当前盒子账号和授权到期时间，方便确认登录的是哪个账号、是否还能使用。需要换盒子账号时，点击“退出登录”，再登录另一个账号。
新手先记住这三点
- 键鼠模式先保持游戏默认值
不同游戏支持的模式不同，以实际下拉列表为准，不需要每一种都试。
- “开启调试”不要勾选
这是开发者调试脚本使用的选项，普通用户使用任务功能时保持关闭。
- 不需要预约，就不勾“定时启动”
日常使用直接回到“任务流程”，选好起点后点击“开始”。
键鼠模式：三种方式有什么区别？
它决定盒子用哪种方式模拟键盘、鼠标操作，不影响你在执行列表中安排功能的方式。
通过 DV 键鼠组件模拟按键和鼠标操作。新电脑首次使用若出现设备软件安装提示，必须完成安装；具体步骤见前面的“首次初始化键鼠”。
通过驱动方式模拟键盘、鼠标输入。宏键鼠无法正常使用时，可以按客户端提示，在当前游戏支持的情况下尝试此模式。
通过普通键鼠接口及窗口绑定方式进行操作；支持后台或多窗口的功能会按脚本要求使用对应的后台输入方式。是否支持后台操作取决于游戏和功能，选择此模式并不代表所有功能都能后台运行。
三种模式的适用情况不同，没有对所有游戏都更好的固定选择。能正常执行任务时保持默认即可；出现初始化失败或按键无响应时，先按客户端提示处理，再在该游戏支持的模式中调整，不要反复随意切换。
提示音：用声音提醒任务状态
勾选后，开始、停止任务时会播放提示声音，也会在任务完成或失败时播放相应提示音。不需要声音时取消勾选即可。
开启调试：开发者专用，普通用户不要勾选
这个选项用于开发者调试和测试脚本。日常添加、运行任务不需要开启，保持未勾选即可。
定时启动：到预约时间自动开始一次任务
- 先准备好要运行的配置和游戏
确认已登录、资源就绪，任务参数和游戏目标已准备好。在“任务流程”中选好配置与起始功能。
- 先选择时刻，再勾选“定时启动”
设置小时和分钟，勾选后查看旁边显示的完整预约日期。若所选时刻今天已经过去，会安排到次日。需要改时间时，先取消勾选，再调整时间并重新勾选。
- 保存设置，保持盒子和游戏可操作
点击“保存配置”，等待预约时间。到点会尝试触发底部“开始”按钮；如果未登录或任务尚未就绪，本次预约会取消，不会补跑。程序关闭时不会执行定时任务。
触发后会取消“定时启动”的勾选；下次需要预约时重新设置。已保存但已经过期的预约在恢复时会被取消。多窗口任务仍按窗口卡片的运行方式操作。
开始 / 停止快捷键：不用切回盒子也能控制任务
默认开始为 F11，停止为 F12，也可以在下拉列表中选择其他按键。开始和停止不能设置成同一个键，尽量避免与游戏常用键冲突。修改后，底部按钮会显示新的快捷键；点击“保存配置”保留设置，后续以按钮上的提示为准。
熟悉后，再用多账号和多窗口
前面是在“任务流程”页操作当前登录游戏账号的单账号教程。需要批量处理多个游戏账号或多个窗口，再学习本节；这两项是可选入口，看不到对应标签，说明当前绑定游戏没有提供该能力。
多账号：按列表切换目标，再执行同一套任务
在“任务流程”页开始，是操作当前游戏账号；在“多账号”页开始，会按账号列表逐个切换目标，再执行配置中的任务。先把单账号任务跑通，再学习批量运行。
这些操作在独立的多账号教程中详细说明，配有诛仙世界的实际界面截图。
多窗口：给不同游戏窗口安排各自的任务
支持最多 8 个窗口位，所用功能必须支持后台操作。每张卡片分别选择配置、账号方式、功能起点和游戏窗口，再使用卡片自己的“开始”“停止”。先熟悉单账号和多账号，再学习这项进阶用法。
先分别准备好 A、B 的功能和参数并保存。选中配置 A，在左下方“完成后”选择 B，再点击“保存配置”；选中 B，把“完成后”设为“结束任务”并保存。最后回到 A 开始，程序会按 A → B → 结束 执行，无需手动再次开始。
第一次使用保持“结束任务”即可。如果 B 又切回 A，就会循环运行；多账号的衔接规则见多账号详细教程。
卡住了，先看这里
先读界面提示和运行日志，按对应问题处理。
注册失败，提示账号或密码格式不对
账号和密码都要 5–16 位，只能用英文字母和数字。检查空格、中文、标点，并确认两次密码一致。账号已被占用时，更换账号名称。
注册成功了，但没有自动进入工作台
检查网络后，使用刚注册的账号和密码点击“登录”。不要因为自动登录失败就重复注册同一个账号。
充值预览失败，或者“确认充值”不能点击
确认盒子账号已登录、卡密完整、网络正常。以面板错误提示为准；先成功预览才能确认。卡密有改动时，重新点“预览卡密”。
充值显示成功，但程序没有自动重启
手动重新打开客户端，在“设置”中核对到期时间。若结果不明确，先核对到账状态，再处理卡密，避免仅凭界面暂时没有变化判断充值失败。
功能目录是空的，或者“开始”是灰色的
检查登录状态、是否已充值绑定游戏、资源是否准备完成，以及当前是否选中配置。若日志提示功能加载失败，按错误处理网络或资源问题后重新登录。多窗口页使用卡片里的开始按钮。
双击后没添加，或者原来的任务不见了
添加时双击左边功能分类里的具体功能。中间执行列表双击是删除，编辑参数只需单击。误删后从左边重新添加，并重新填写参数、保存。
为什么只跑了后半段，前面的功能没执行？
普通任务从当前选中的执行功能起跑。停止后回到任务流程，选中第一项，再开始。多账号检查“首次开始功能”；多窗口检查卡片里的功能起点。
提示功能“过时”，或者保存失败
过时功能需要移除后，从左侧菜单重新添加最新版本，再检查参数并保存。保存失败时编辑内容会保留，按错误提示修正；不要退出前就把失败当成保存成功。
任务失败，或游戏没有按预期操作
先停止并查看“任务失败：”后面的原因，再检查游戏窗口、功能所需状态、参数、授权和组件提示。把问题缩小到单个功能试跑；不要同时更改多项设置。需要技术排查时，查看导出详细日志教程，按步骤找到对应日志文件，并提供问题发生时的操作步骤。界面日志只是粗略的进度和状态提示，不能替代详细日志。反馈时遮住账号密码及卡密。
下次打开还能继续用吗？
客户端会保存登录凭据；已成功保存的配置会在登录后加载。需要切换盒子账号时，在“设置”中点击“退出登录”。任务修改后记得再次保存。
下次使用，只记住这条顺序。
打开客户端 → 选择配置 → 检查参数 → 选第一项 → 保存 → 开始。
停止用 F12，不明白的参数先点 ?，运行是否成功看日志和实际结果。