bettergi-scripts-list/repo/js/FullyAutoAndSemiAutoTools

FullyAutoAndSemiAutoTools

全自动 + 半自动路径任务工具箱

项目概述

FullyAutoAndSemiAutoTools 是一套高度模块化、可高度自定义的自动化路径执行工具箱。

支持全自动与半自动两种运行模式，核心目标包括：

• 智能扫描 & 多层级管理大量路径文件（支持任意深度目录结构）
• 精细的冷却时间控制（小时制 + Cron，需要外部解析服务）根据路径的CD
• 根据路径特性自动切换战斗/元素队伍
• 集成丰富的实时辅助功能
• 执行记录防重复 + 择优优先未完成路径
• 支持黑白名单、多 UID 隔离记录与路径缓存

快捷使用

• 1.(首次/刷新存储)账号刷新 设置刷新层级 运行一次 (自动识别uid存储) 先获取版本密钥
  
  
• 2.执行 选择 全自动
  
  CD算法需要部署 bettergi-scripts-tools 并启用http
  也可以开启择优模式(择优模式不依赖bettergi-scripts-tools)
  
  
  日常选择 全自动
  
  配置队伍
  配置默认 行走队
  队伍配置 实例语法对应映射: 矿物,火,水,风,雷,草,冰,岩
  队伍配置 实例语法: 矿采集,水火风雷,水火风雷,水火风雷,元素,矿采集
  没有可留空 如 矿采集,,,,,矿采集
  锄地队伍配置
  实例语法: 敌人与魔物->发条机关=速通,..... (还不清楚的看锄地队伍配置图映射)
  
  锄地队伍配置图映射

选中执行组
  多选项 为或关系
  如选中 地方特产的璃月 和 璃月的石珀 会执行 地方特产的璃月下所有的路径
  如需要指定 请勿选中上级目录 璃月的石珀(3级路径)->地方特产的璃月(2级路径)
  如图选中下3级路径时不要选中对应的2级路径
  
  
  
• 3.高级配置请继续查看文档后续

核心亮点（最新版）

• 路径扫描全面重构：支持任意层级目录，父子关系清晰，性能稳定
• 按 UID 缓存路径列表（path-json-by-uid.json），多账号切换极快
• 小时制 & Cron 双冷却系统（需搭配 bettergi-scripts-tools）
• 智能队伍切换（战斗/七元素）
• 实时任务：自动对话跳过、自动拾取、自动战斗
• 择优执行 + 执行记录 + 错误路径追踪
• 半自动快捷键干预（继续/跳过）
• 开发者模式 + 详细日志 + UID自动识别

文件结构一览

FullyAutoAndSemiAutoTools/
├── config/
│   ├── SevenElement.json           # 七元素路径→队伍映射
│   ├── cd-pathing.json             # 路径冷却规则（hours/cron）
│   ├── record.json                 # 本次执行记录
│   ├── PathRecord.json             # 历史路径执行记录
│   ├── uidSettings.json            # 用户配置快照（多UID支持）
│   ├── path-json-by-uid.json       # 按UID缓存的路径JSON列表
│   └── RefreshSettings.json        # 刷新配置缓存（可选）
├── utils/
│   ├── SwitchTeam.js               # 队伍切换核心
│   ├── cron.js                     # Cron 解析工具
│   └── uid.js                      # UID 识别模块
├── pathing/                        # ★ 所有路径文件目录（需符号链接）
├── SymLink.bat                     # 一键创建 pathing 链接
├── main.js                         # 主程序入口（已重构路径扫描）
├── manifest.json                   # 脚本元信息 & 版本标识
└── settings.json                   # 配置模板（用户界面依据）

核心流程图

1. 整体流程图（graph TD 风格，适合看结构与分支）

graph TD
  A[启动脚本] --> B[读取 config_run]

  B --> C{config_run ?}

%% ────────────── 刷新模式 ──────────────
  C -->|刷新| Refresh[刷新模式]

  Refresh --> Scan[扫描 pathing 目录<br>readPaths 递归读取所有文件/文件夹]

  Scan --> Depth[应用 loading_level<br>限制最大递归深度]

  Depth --> BlackWhite[应用黑白名单过滤<br>config_white_list / config_black_list<br>（优先级高于其他过滤）]

BlackWhite --> Generate[生成 multi-checkbox 配置项<br>写入 uidSettings.json<br>写入 path-json-by-uid.json<br>（此时黑白名单已生效）]

Generate --> RefreshEnd[刷新结束<br>黑白名单已固化到缓存中]

%% ────────────── 加载模式 ──────────────
C -->|加载| Load[加载模式]

Load --> ReadCache[读取上次缓存<br>path-json-by-uid.json + uidSettings.json<br>（已包含刷新时的黑白名单过滤结果）]

ReadCache --> LoadFilter{二次过滤项}

LoadFilter --> TheLayer[the_layer = true ?<br>只保留指定层级]

LoadFilter --> HighFilter[high_level_filtering 有值 ?<br>路径字符串匹配过滤]

LoadFilter --> BlackWhiteLoad[黑白名单输入框显示<br>但修改无效<br>（不重新过滤缓存）]

TheLayer & HighFilter --> ShowOptions[显示最终过滤后的选项列表<br>供用户勾选]

BlackWhiteLoad -.-> ShowOptions[黑白名单修改不生效]

ShowOptions --> LoadEnd[加载结束<br>黑白名单不参与二次过滤]

%% ────────────── 执行模式 ──────────────
C -->|执行| Exec[执行模式<br>不显示黑白名单 / 层级 / 高阶过滤项<br>直接使用已勾选路径]

Exec --> Run[读取 CD + 记录<br>构建 needRunMap → 执行]

%% 样式
classDef refresh fill:#e8f5e9,stroke:#2e7d32
classDef load    fill:#e3f2fd,stroke:#1976d2
classDef exec    fill:#f3e5f5,stroke:#7b1fa2
classDef filter  fill:#fff3e0,stroke:#ef6c00,stroke-width:2px

class Refresh,Scan,Depth,BlackWhite,Generate refresh
class Load,ReadCache,TheLayer,HighFilter,BlackWhiteLoad,ShowOptions load
class Exec,Run exec
class BlackWhite,TheLayer,HighFilter filter

2. 执行时序图（sequenceDiagram 风格，适合看交互顺序）

sequenceDiagram
  participant U as 用户
  participant UI as 设置界面
  participant S as 扫描 & 缓存模块
  participant F as 过滤逻辑
  participant R as 记录/缓存文件<br>(uidSettings.json + path-json-by-uid.json)
  participant CD as 冷却检查
  participant E as 执行引擎
  participant T as 队伍切换
  participant P as 路径执行

  U->>UI: 选择 config_run 并保存

  alt config_run = 刷新
    UI->>S: 开始刷新（重新扫描 pathing 目录）
    S->>F: 读取 loading_level
    F-->>S: 限制递归深度
    S->>F: 读取黑白名单
    F-->>S: 过滤掉黑名单文件夹，保留白名单优先
    Note over S,F: the_layer 与 high_level_filtering<br>在本模式不参与过滤
    S->>R: 写入完整过滤后的路径列表 & 配置快照
    R-->>UI: 刷新完成，显示新生成的选项列表
  else config_run = 加载
    UI->>R: 请求读取上次缓存
    R-->>UI: 返回已缓存的路径列表<br>（已包含刷新时的黑白名单结果）
    UI->>F: 显示 the_layer / high_level_filtering / loading_level 输入框
    Note over UI,F: 黑白名单输入框显示，但修改无效
    alt 用户修改了 the_layer 或 high_level_filtering
      F->>F: 对缓存列表进行二次过滤
      F-->>UI: 显示过滤后的选项列表
    else 未修改或修改了黑白名单
      F-->>UI: 沿用原缓存列表<br>（黑白名单修改被忽略）
    end
    UI-->>U: 显示可勾选的路径组
  else config_run = 执行
    UI->>R: 读取用户已勾选的路径组 & 配置
    R-->>UI: 返回最终待执行列表
    Note over UI,R: 此时所有层级/过滤/黑白名单配置已固化<br>不再受任何影响
    UI->>CD: 检查冷却规则（hours / cron）
    CD-->>UI: 过滤掉仍在CD的路径组
    UI->>E: 开始执行（needRunMap）
    loop 遍历每个路径组
      E->>T: 根据路径特性决定队伍
      alt 需要战斗 / 元素 / 锄地特化
        T->>T: switchTeamByName / switchTeamByIndex
      end
      T-->>E: 队伍就位
      alt 半自动模式
        E->>U: 等待快捷键（继续/跳过）
        U-->>E: 按键响应
      end
      E->>P: pathingScript.runFile(路径)
      P-->>E: 执行完成 / 异常
      E->>R: 记录执行结果（成功/失败/时间戳）
    end
    R-->>UI: 保存最终记录
    UI-->>U: 执行完成
  end

重要配置项一览（settings.json）

配置项	类型	主要作用	推荐默认/示例
config_uid	复选框	当前配置uid:{无}(仅仅显示配置uid无其他作用)	xxx
key	文本	脚本密钥	xxx
config_run	下拉	运行模式：刷新 / 加载 / 执行	刷新 → 首次，加载 → 日常
refresh_record	复选框	配置模式-刷新-清空运行记录
refresh_record_mode	下拉	清空运行记录模式 全部	UID
high_level_filtering	文本	高阶过滤
loading_level	文本	路径层级深度（≥1，实际支持更高深度）	2 或 3
the_layer	复选框	只加载指定层级
order_rules	文本	执行顺序规则（可留空） 语法：父文件夹名称->文件夹名称=顺序整数,... 示例：食材与炼金->晶蝶=1,	""（默认按扫描顺序）或 "食材与炼金->晶蝶=1,pathing->地方特产=2"
open_limit_max	复选框	开启执行组最大路径数配置
limit_max_group	文本	配置执行组最大路径数（可留空） 语法：父文件夹名称->文件夹名称=最大路径数,... 示例：食材与炼金->晶蝶=50,	""（默认按扫描顺序）或 "食材与炼金->晶蝶=50,pathing->地方特产=50"
config_white_list	文本	白名单（逗号分隔）	晶蝶,特产
config_black_list	文本	黑名单（优先级更高）	其他,锄地专区,周本
open_cd	复选框	启用冷却控制	建议开启
http_api	文本	Cron 解析服务地址	http://127.0.0.1:8081/...
real_time_missions	多选	实时辅助（对话/战斗/拾取）	至少开「自动拾取」
choose_best	复选框	择优模式（优先未跑/最久未跑路径）	推荐开启
mode	下拉	全自动 / 半自动	全自动（日常）
auto_semi_key_mode	下拉	半自动快捷键行为（继续/跳过）	继续运行
auto_key	文本	半自动干预快捷键	F10 / F11（避免冲突）
team_fight	文本	通用行走队伍名称	必须填写
team_hoe_ground	文本	锄地特化队伍配置（语法：父文件夹->子文件夹=队伍名,...）	敌人与魔物->蕈兽=蕈兽队
team_seven_elements	文本	七元素队伍（矿物,火,水,风,雷,草,冰,岩）	按顺序填写
is_debug	复选框	开发者模式（详细日志）	调试时开启

语法说明

• high_level_filtering 高阶过滤

语法：xxx->xxx-> ..... 无限制               

实例：pathing\地方特产\
语法：地方特产
实例：pathing\地方特产\枫丹\
语法：地方特产->枫丹
实例：pathing\地方特产\枫丹\幽光星星\
语法：地方特产->枫丹->幽光星星
实例：pathing\地方特产\枫丹\幽光星星\幽光星星@jbcaaa\
语法：地方特产->枫丹->幽光星星->幽光星星@jbcaaa

• 以下语法风格请保持一致 ，否则会导致路径会出现异常运行 如使用 地产->nam=1 同时保持 地产->nam=队伍名1 则路径会出现异常运行
• order_rules 执行顺序规则
  1. rootName 根目录下层文件夹名称，parentName 父目录名称，name 文件夹名称
  2. 建议语法：rootName->parentName->name=1,rootName->parentName->name2=2
  3. rootName=parentName时 语法rootName->parentName->name=1不可用， 请使用 parentName->name=1 语法
  4. rootName->name=1 语法不支持
  5. 匹配精度：rootName->parentName->name > parentName->name > 默认顺序
• team_hoe_ground 锄地特化队伍配置
  1. rootName 根目录下层文件夹名称，parentName 父目录名称，name 文件夹名称
  2. 建议语法：rootName->parentName->name=队伍名,rootName->parentName->name2=队伍名
  3. rootName=parentName时 语法rootName->parentName->name=队伍名不可用， 请使用 parentName->name=队伍名 语法
  4. rootName->name=队伍名 语法不支持
  5. 匹配精度：rootName->parentName->name > parentName->name > 默认顺序
• limit_max_group 配置执行组最大路径数
  1. parentName 父目录名称，name 文件夹名称
  2. 建议语法：parentName->name=50,parentName->name2=50
  3. 匹配精度： parentName->name > 默认顺序

(可选)额外json配置

配置项order_rules

路径:config/PathOrder.json order值越大优先级越高 公共配置 锄地模块排序未配置 希望好心人完善 预留order 900~700

[
  {
    "uid": "",
    //账号UID
    "is_common": false,
    //是否为公共配置
    "root_name": "",
    //根文件夹下对应的文件夹名称
    "parent_name": "",
    //父文件夹名称
    "name": "",
    //文件夹名称
    "order": 0
    //顺序
  }
]

配置项team_hoe_ground

路径:config/HoeGround.json

[
  {
    "uid": "",
    //账号UID
    "is_common": false,
    //是否为公共配置
    "root_name": "",
    //根文件夹下对应的文件夹名称
    "parent_name": "",
    //父文件夹名称
    "name": "",
    //文件夹名称
    "team_name": ""
    //队伍名称
  }
]

CD 规则示例（cd-pathing.json）

level值越大优先级越高

[
  {
    "name": "晶蝶",
    "type": "hours",
    "level": 2,
    "value": 12
  },
  {
    "name": "地方特产",
    "type": "hours",
    "level": 1,
    "value": 46
  },
  {
    "name": "矿物",
    "type": "cron",
    "level": 1,
    "value": "0 0 0 1/3 * ?"
  }
]

运行实例部分日志

实例==>运行矿物 大类 虹滴晶 运行完成 再次运行 日志截图展示：

Cron 解析服务部署（必须）

bettergi-scripts-tools 是 Cron 解析的必要依赖，请至少选择一种方式部署：

bettergi-scripts-tools 版本需要 v0.0.3

1. Windows 一键运行

下载 release 中的 windows zip 包 → 解压 → 双击 .exe 运行

2. Java 运行

下载 jar 包 → 执行：

java -jar bettergi-scripts-tools-xxxx.jar

3. Docker 部署

docker pull ghcr.io/kirito520asuna/bettergi-scripts-tools:latest
docker run -d -p 8081:8081 --name bettergi-scripts-tools ghcr.io/kirito520asuna/bettergi-scripts-tools:latest

默认 API 地址：http://127.0.0.1:8081/bgi/cron/next-timestamp/all

推荐使用流程

1. 双击 SymLink.bat 创建 pathing 链接
2. 首次运行强烈建议先「刷新」一次（生成 path-json-by-uid.json 缓存）
3. 日常使用「加载」模式 → 快速恢复配置 & 路径列表
4. 微调路径组 → 切换「执行」模式 → 一键启动

多账号特别友好：每个 UID 都有独立路径缓存，切换账号无需重复扫描

小技巧与实用建议

• 最省事组合：全自动 + 择优模式 + 自动拾取 + 冷却控制
• 最安全组合：半自动 + 自动拾取 + 详细日志 + 大量黑名单
• 路径目录再深也没关系，扫描已支持任意层级
• 错误路径反复出现？查看 record.json 加黑名单或修复
• 多UID用户：首次每个号都「刷新」一次，建立独立缓存

注意事项

• 首次使用或升级后建议删除旧 path-json-by-uid.json 重新生成
• 半自动模式请确保快捷键不与 BetterGI 冲突
• Cron 模式必须部署解析服务，否则冷却检查无效
• 最低兼容版本：BetterGI 0.54.3+

版本密钥

版本	密钥
0.0.1	PGCSBY37NJA

版本历史（简要）

0.0.1 2026.01.30

基本功能完成

作者：云端客 (Kirito520Asuna)

祝你使用愉快，素材永远收不完～✨