BetterGI 只读状态总览：进程/窗口/关键配置/一条龙配置/最新日志尾部/进度文件。任何操作前先调用它确认状态。

启动原神与 BetterGI 截图器（等价于 BetterGI.exe start），会联动启动游戏并自动进游戏。注意：游戏真正进到可操作状态要 1-2 分钟，超出单次调用上限（本机 MCP 约 60 秒）时会返回「仍在启动中」——这不算失败，随后用 bgi_status 复查即可。

跑「一条龙」日常配置（本机配置名：日常 = 领取邮件→合成树脂→领取每日奖励→自动秘境）。要求 BetterGI 未在运行（单实例会吞掉参数）；干完就返回，成败用 bgi_watch 轮询。

按顺序执行一个或多个「配置组」（User\ScriptGroup<名>.json）——采集/锄地/自定义脚本编排都走这里。立即返回；执行过程与成败用 bgi_watch 轮询。

在当天 BetterGI 日志里定向检索（诊断"为什么失败"的取证工具）：按级别/正则/时间窗/任务关键字过滤，返回带行号、时间戳、类名与消息正文的命中行。比 bgi_status 的日志尾部强得多。

调度与运行一览（只读）：计划任务的触发时间/下次/上次/返回码/RunLevel、包装器日志尾部与今天是否已触发、一条龙配置与任务顺序、每个配置组是否已接进一条龙、最近几次运行的收尾时间。

从上次中断处续跑配置组（等价 BetterGI.exe --TaskProgress <组名|latest>）——采集/长任务被打断后用。要求 BetterGI 未在运行。

读写官方 JS 脚本的设置（它们不落盘到脚本目录，而是存在配置组项目的 jsScriptSettingsObject 里）。不带 set 时列出全部可配置项与当前值；带 set 时先按 settings.json 的 schema 校验（select 必须在 options 内、checkbox 转布尔）再写回配置组并自动备份。

改「一条龙」配置（User\OneDragon<名>.json）：秘境/队伍/每日奖励队伍/合成台地区/冒险家协会地区/收工动作/保留原粹/按星期换秘境/任务顺序与启停。要求 BetterGI 未运行（它会把文件回写覆盖）；自动备份并回显改动前后。dry_run=true 只预览。

等待日志出现某个里程碑（确认"真的跑起来了"，而不只是"已发起"）：capturer_ready（截图器就绪）/ dragon_started / group_started / task_started / domain_entered（真进秘境）/ combat_matched / script_finished / finished（整体收尾）/ any_error。单次最多等 50 秒，超时就再调一次。

「说一句就采集」的一步到位入口：确保路线与配置组就绪 → 检查/准备游戏窗口（最小化或不在前台时尝试还原并置前）→ 触发配置组 → 轮询到"真的开始跑了"（里程碑）。会真正启动 BetterGI 并接管游戏操作，需 confirm=true。dry_run=true 只做准备与汇报。

战果统计（只读）：某天/最近几天配置组里每条路线跑成没、各自花了多久、成功/失败计数与失败清单，并附刷取统计（FarmingPlan 小怪/精英数）与断点续跑进度（task_progress）。注意：一条龙不写执行记录，只有配置组任务 / --startGroups / --TaskProgress 会写。

关闭原神 / BetterGI（先优雅关闭、必要时强制），并如实报告是否真的关掉。改 User\config.json 或 User\OneDragon*.json 之前必须先退出 BetterGI（它运行中会整份回写覆盖）。BetterGI 若以管理员权限运行，普通权限关不掉——会明确报告权限不足并给出替代路径。需 confirm:true（或用 dry_run 预览）。

新建一个「一条龙」配置（复制现有配置或从空模板），并可选设置任务顺序。注意：命令行 startOneDragon <名> 按 JSON 里的 Name 字段匹配（Ordinal 精确比较），不是按文件名 → 本工具会同时把文件名与 Name 设成同一个名字，并在发现重名时拒绝（重名会让 BetterGI 随机命中其中一个）。

开跑前体检（只读，不启动任何进程）：安装与关键配置、进程/窗口就绪（可见+前台+16:9≥1080P）、显示分辨率与 DPI 能否容纳 1920×1080、安装包识别资源分辨率、路线资产、配置组里每个 Pathing 项目对应的文件是否真的存在（缺失会被静默跳过）、一条龙配置与收工动作、MCP/包装器等闭环件。跑采集或秘境前先调它。

跑自动化前的窗口准备（会改变你当前焦点）：把原神从最小化还原并尝试切到前台，回报客户区尺寸、是否 16:9、是否 ≥1080P、是否在前台。采集/秘境要求「可见 + 前台 + 16:9 ≥1920×1080」，不满足时自动化会失败或暂停。

观察并判定成败（只读，可反复调用）。默认立即返回当前判定；verdict=incomplete 表示还没收尾，隔一会儿再调一次（或用 wait_seconds 在单次调用内最多轮询 50 秒）。只把「本次运行」的 ERR 计入失败，更早运行的 ERR 单独列出。

安全修改 User\config.json（父.子=值）。要求 BetterGI 已退出；会自动备份并回读校验。dry_run=true 只预览。

列出本机战斗策略（User\AutoFight***.txt），并可按队伍预测「根据队伍自动选择」会选中哪一份。

列出所有配置组及其项目（名字/类型/状态）。

新建或向既有配置组追加项目。Pathing 项目的 target 用「子目录/文件名.json」或「文件名」。

列出本机已安装的地图追踪路径（User\AutoPathing***.json），可按关键词过滤。

在官方脚本仓库（babalae/bettergi-scripts-list）里检索地图追踪路线，例如「星螺」→ 5 条璃月路线。download=true 时下载到 User\AutoPathing。

浏览官方脚本仓库目录树（用于发现可用的路线/JS 脚本/战斗策略）。

列出官方仓库里的 JS 脚本（js/ 分区，本机 2026-10-16 实测有 144 个，例如 AutoCommission 自动每日委托、使用历练点完成每日委托、AutoRefinedCondensationResin 自动合成浓缩树脂）。detail=true 时会拉该脚本的 manifest.json 显示名称/说明/版本。

把官方仓库的一个 JS 脚本整目录安装到 User\JsScript<名字>\（含 manifest.json、main.js 与资源）。装完可用 bgi_run_js 建组执行，或用 bgi_add_group_to_onedragon 接进每日一条龙。

一键跑官方 JS 脚本：确保已安装 → 生成同名配置组（单个 Javascript 项目）→（run=true 时）触发执行。JS 脚本是 BetterGI 能力最强的扩展面（自动委托、树脂、纪行、尘歌壶、抽卡兑换等）。

把一个配置组接入「一条龙」每日流程（离线改 User\OneDragon<配置>.json：新增 GUID 条目到 TaskDefinitions/TaskEnabledList/TaskOrder）。会改变每日自动化内容，需 confirm=true；会自动备份。

一键采集材料（旗舰工具）：在官方仓库找到该材料的路线 → 缺则下载到 User\AutoPathing → 生成配置组「采集-<材料>」→（run=true 时）立即触发执行。