# 《原神角色经验计算脚本》使用说明
## 一、注意事项
* 联机状态无法运行
* ocr识别会小概率出现偏差，重新运行即可
* 脚本生成的报告文件仅供作为参考，实际请按游戏为准

## 二、脚本概述
1. 自动识别指定角色的当前等级和经验值
2. 计算升级到目标等级所需的总经验值
3. 可选：结合背包经验书进行统合计算
4. 自动生成经验计算报告并保存为文本文件

## 三、使用方法和配置参数说明
1. 需在调度器的配置组中点击 “+添加 → JS脚本” ，找到本JS脚本后加入配置组。
2. 加入配置组后鼠标右键脚本， 修改JS脚本自定义配置。
3. 脚本运行完成无异常后，会在脚本根目录下的 “test” 文件夹内创建文本文件，
文件名为exp_result_YYYYMMDD_HHMMDD，即exp_result_年月日_时分秒。

脚本的"js自定义配置"设置：

    1. 目标角色 (必填)：
        - 格式：单个角色名，或多个角色用逗号分隔（中英文皆可），支持使用别名
        - 示例："刻晴,甘雨,帝君"
    2. 目标等级 (必填)：
        - 格式：整数，表示目标等级
        - 示例：90 (范围：2-90)
    3. 结合当前背包拥有的经验书计算 (可选)：
        - 将扫描背包内经验书并统合计算

## 四、脚本文件结构
* main.js：主要的脚本文件
* manifest.json：脚本配置文件
* settings.json：用户配置文件
* test/：存放脚本运行后保存的文本文件
* lib/：存放脚本依赖的JS模板文件
* assets/：存放模板图片

## 五、关于脚本运行后保存的文本文件
以下是示例文本内容：

    === 原神角色升级所需的经验记录 [2026/1/1 16:05:06] ===

    ===【角色数据】===
    【雅珂达】
        当前等级：1级
        当前经验：0
        升级至90级所需经验：8362650
    
    ===【经验书数据】===
        大英雄的经验：
        数量：300
        总经验值：6000000
    
        冒险家的经验：
        数量：561
        总经验值：2805000
    
        流浪者的经验：
        数量：100
        总经验值：100000
    
    === 记录结束 ===
    总计角色数：1 | 所有角色升至90级总计所需经验：8362650
    背包经验书种类数：3 | 总计经验值：8905000
    经验盈余：542350（超出需求）
    
    当前世界等级：9
    单次启示之花奖励（20原粹树脂）：
     大英雄的经验：4~5本
     冒险家的经验：6~7本
    
    ================ 计算结果 ================
    当前背包内经验书已满足经验需求，无需刷取