@bettergi/types 0.1.17 → 0.1.19

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bettergi/types",
-  "version": "0.1.17",
+  "version": "0.1.19",
   "description": "BetterGI TypeScript 类型定义",
   "type": "module",
   "author": "Bread Grocery<https://github.com/breadgrocery>",

package/types/BetterGenshinImpact/Core/Recognition/SearchOptions.d.ts

@@ -1,20 +1,29 @@
 import type {
   ClrHostValue,
+  DoubleHost,
   EnumTypeTrait,
   HostType,
   PublicDefaultConstructorTrait,
-  ReferenceTypeTrait
+  ReferenceTypeTrait,
+  StrongNumeric,
+  ValueTypeTrait
 } from "../../../Microsoft/ClearScript/HostType";
+import type { HostVariableOut } from "../../../Microsoft/ClearScript/HostVariable";
+import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
+import "../../../OpenCvSharp/Rect";
 import "../../../OpenCvSharp/Size";
 import "../../../System/Enum";
 import "../../../System/IComparable";
 import "../../../System/IConvertible";
+import "../../../System/IEquatable";
 import "../../../System/IFormattable";
 import "../../../System/ISpanFormattable";
 import "../../../System/Nullable";
+import "../../../System/ValueType";
 
 /**
  * 参考搜索的锚定方式；元素在画布右/下侧时通常使用右/下锚定，在左/上侧时通常使用左/上锚定，居中元素使用中心锚定并按画布中心加偏移缩放
+ * Auto 按参考包围盒所在区域分别选择水平和垂直锚定，用于模拟游戏 UI 的响应式布局
  * @since 0.49.0
  */
 declare const searchAnchorModeBrand: unique symbol;
@@ -30,7 +39,7 @@ declare global {
 
 export interface SearchAnchorModeHostType extends HostType<SearchAnchorMode, EnumTypeTrait> {
   /**
-   * 自动选择锚定方式
+   * 按参考包围盒中心的 0.4/0.6 分区模拟游戏 UI 的响应式布局
    * @since 0.49.0
    */
   readonly auto: SearchAnchorMode;
@@ -74,10 +83,20 @@ export interface SearchOptions extends ClrHostValue {
    */
   anchorMode: BetterGenshinImpact.Core.Recognition.SearchAnchorMode;
   /**
-   * 在预测框外额外扩展的像素大小；未指定时默认四周各扩展 10px
+   * 参考画布坐标系中的独立搜索框；未指定时以 `RecognitionObject.referenceBoundingBox` 为基础搜索框，指定后与参考包围盒使用相同缩放和锚定规则转换到当前截图坐标系
+   * @since 0.64.0
+   */
+  referenceSearchBox: OpenCvSharp.Rect | null;
+  /**
+   * 在基础搜索框外额外扩展的像素大小，Width 用于左右，Height 用于上下；未指定时默认四周各扩展 10px；当 expandPercent 有值时不生效
    * @since 0.49.0
    */
   expandSize: OpenCvSharp.Size | null;
+  /**
+   * 按当前截图宽高计算的四边扩展比例；左右乘截图宽度，上下乘截图高度，例如 0.05 表示 5%；优先于 expandSize，显式设置全零比例可关闭默认的 10px 扩展
+   * @since 0.64.0
+   */
+  expandPercent: BetterGenshinImpact.Core.Recognition.SearchExpandRatio | null;
 }
 
 declare global {
@@ -97,4 +116,98 @@ export interface SearchOptionsHostType extends HostType<
   new (): SearchOptions;
 }
 
+/**
+ * 搜索区域四边的扩展比例，属性顺序与 XAML Thickness 的四参数顺序一致：Left、Top、Right、Bottom；值为直接参与计算的小数比例，例如 0.05 表示 5%
+ * @since 0.64.0
+ */
+declare const searchExpandRatioBrand: unique symbol;
+export interface SearchExpandRatio extends ClrHostValue {
+  readonly [searchExpandRatioBrand]: true;
+  /**
+   * 左侧扩展比例，以当前截图宽度为基准
+   * @since 0.64.0
+   */
+  left: number;
+  /**
+   * 上侧扩展比例，以当前截图高度为基准
+   * @since 0.64.0
+   */
+  top: number;
+  /**
+   * 右侧扩展比例，以当前截图宽度为基准
+   * @since 0.64.0
+   */
+  right: number;
+  /**
+   * 下侧扩展比例，以当前截图高度为基准
+   * @since 0.64.0
+   */
+  bottom: number;
+  /**
+   * 四边比例是否均为有限且非负的数字；大于 1 的比例合法，最终搜索区域会被裁剪到截图边界
+   * @since 0.64.0
+   */
+  readonly isValid: boolean;
+  /**
+   * 比较是否相等
+   * @param obj 比较对象
+   * @since 0.64.0
+   */
+  equals(obj: unknown | null): boolean;
+  /**
+   * 比较是否相等
+   * @param other 另一扩展比例
+   * @since 0.64.0
+   */
+  equals(other: BetterGenshinImpact.Core.Recognition.SearchExpandRatio): boolean;
+  /**
+   * 返回哈希码
+   * @since 0.64.0
+   */
+  getHashCode(): number;
+  /**
+   * 返回字符串表示
+   * @since 0.64.0
+   */
+  toString(): string;
+  /**
+   * 解构为左右上下四边比例
+   * @param left 左侧扩展比例
+   * @param top 上侧扩展比例
+   * @param right 右侧扩展比例
+   * @param bottom 下侧扩展比例
+   * @returns ClearScript 宿主空结果
+   * @since 0.64.0
+   */
+  deconstruct(
+    left: HostVariableOut<number>,
+    top: HostVariableOut<number>,
+    right: HostVariableOut<number>,
+    bottom: HostVariableOut<number>
+  ): VoidResult;
+}
+
+declare global {
+  namespace BetterGenshinImpact.Core.Recognition {
+    type SearchExpandRatio = import("./SearchOptions").SearchExpandRatio;
+  }
+}
+
+export interface SearchExpandRatioHostType extends HostType<SearchExpandRatio, ValueTypeTrait> {
+  /**
+   * 按左右上下四边比例构造
+   * @param left 左侧扩展比例，以当前截图宽度为基准
+   * @param top 上侧扩展比例，以当前截图高度为基准
+   * @param right 右侧扩展比例，以当前截图宽度为基准
+   * @param bottom 下侧扩展比例，以当前截图高度为基准
+   * @since 0.64.0
+   */
+  new (
+    left: number | StrongNumeric<DoubleHost>,
+    top: number | StrongNumeric<DoubleHost>,
+    right: number | StrongNumeric<DoubleHost>,
+    bottom: number | StrongNumeric<DoubleHost>
+  ): SearchExpandRatio;
+}
+
 export {};

package/types/BetterGenshinImpact/Core/Script/Dependence/Genshin.d.ts

@@ -282,7 +282,7 @@ export interface Genshin extends ClrHostValue {
   /**
    * 按槽位重组当前队伍角色
    * 未传入或空字符串的槽位跳过；重组队伍槽位角色，不是按数字键切换当前出战角色
-   * 示例：`await genshin.switchCharacter("胡桃", "夜兰", "", "钟离")`
+   * 默认按队伍物理槽位解释；物理槽位示例：`await genshin.switchCharacter("胡桃", "夜兰", "", "钟离")`
    * @param slot1 1 号位角色名，空字符串表示跳过
    * @param slot2 2 号位角色名，空字符串表示跳过
    * @param slot3 3 号位角色名，空字符串表示跳过
@@ -304,6 +304,25 @@ export interface Genshin extends ClrHostValue {
     slot3: "" | AvatarName,
     slot4: "" | AvatarName
   ): Promise<boolean>;
+  /**
+   * 按槽位重组当前队伍角色
+   * `usePhysicalSlots` 为 true 时按队伍物理槽位解释 slot1-slot4，为 false 时按当前玩家可控角色顺序解释
+   * 可控顺序示例：`await genshin.switchCharacter("胡桃", "夜兰", "", "", false)`
+   * @param slot1 1 号位角色名，空字符串表示跳过
+   * @param slot2 2 号位角色名，空字符串表示跳过
+   * @param slot3 3 号位角色名，空字符串表示跳过
+   * @param slot4 4 号位角色名，空字符串表示跳过
+   * @param usePhysicalSlots 是否按队伍物理槽位解释，默认 true
+   * @returns 在任务完成后兑现是否成功的 Promise；完成保存并返回主界面为 true，参数无效、目标角色未找到或流程失败为 false
+   * @since 0.64.0
+   */
+  switchCharacter(
+    slot1: "" | AvatarName,
+    slot2: "" | AvatarName,
+    slot3: "" | AvatarName,
+    slot4: "" | AvatarName,
+    usePhysicalSlots: boolean
+  ): Promise<boolean>;
   /**
    * 清除当前调度器的队伍缓存
    * @returns ClearScript 宿主空结果

package/types/BetterGenshinImpact/GameTask/AutoBoss/AutoBossConfig.d.ts

@@ -62,6 +62,9 @@ export type BossName =
   | "霜夜巡天灵主"
   | "蕴光月幻蝶"
   | "重拳出击鸭"
+  // 至冬
+  | "不灭衍生造物"
+  | "嵌合翼骏狮"
   | "" // 未指定
   | (string & {});
 

package/types/BetterGenshinImpact/GameTask/AutoDomain/AutoDomainParam.d.ts

@@ -56,7 +56,7 @@ export interface AutoDomainParam extends Omit<
    */
   partyName: string;
   /**
-   * 需要刷取的秘境名称；空字符串表示未指定
+   * 需要刷取的秘境名称；空字符串表示未指定，`根据提升指南选择秘境` 表示按冒险手册提升指南选择
    * @since 0.52.0
    */
   domainName: DomainName;

package/types/BetterGenshinImpact/GameTask/AutoDomain/AutoDomainTask.d.ts

@@ -27,10 +27,11 @@ export type ArtifactStar = "1" | "2" | "3" | "4" | (string & {});
 
 /**
  * 可自动刷取的秘境名称
- * 来源：`MapLazyAssets` 从 `tp.json` 提取的 BlessDomain / ForgeryDomain / MasteryDomain 点位名
+ * 来源：`MapLazyAssets` 从 `tp.json` 提取的 BlessDomain / ForgeryDomain / MasteryDomain 点位名；`根据提升指南选择秘境` 为 `AutoDomainTask.DevelopmentGuideOption` 固定选项
  * @since 0.52.0
  */
 export type DomainName =
+  | "根据提升指南选择秘境"
   | "铭记之谷"
   | "忘却之峡"
   | "仲夏庭园"
@@ -66,6 +67,9 @@ export type DomainName =
   | "失落的月庭"
   | "月童的库藏"
   | "山风的荆冕"
+  | "荒坠的圣迹"
+  | "逆悬的冰河"
+  | "妄念的创痕"
   | "" // 未指定
   | (string & {});
 
@@ -116,6 +120,11 @@ declare global {
 }
 
 export interface AutoDomainTaskHostType extends HostType<AutoDomainTask, ReferenceTypeTrait> {
+  /**
+   * 按提升指南选择秘境的固定选项名
+   * @since 0.65.0
+   */
+  readonly developmentGuideOption: "根据提升指南选择秘境";
   /**
    * 使用自动秘境参数创建任务
    * @param taskParam 自动秘境参数

package/types/BetterGenshinImpact/GameTask/AutoFight/AutoFightConfig.d.ts

@@ -25,19 +25,20 @@ export type OnlyPickEliteDropsMode =
   | (string & {});
 
 /**
- * 战斗策略名称；`根据队伍自动选择` 表示按当前队伍匹配策略目录，其余为 `User/AutoFight` 下策略文件名（不含扩展名）
+ * 战斗策略名称；`根据队伍自动选择` 表示按当前队伍匹配策略目录，`自动连招（实验）` 为 LLM 行为树固定名且不对应策略文件，其余为 `User/AutoFight` 下策略文件名（不含扩展名）
  * @since 0.52.0
  */
-export type CombatStrategyName = "根据队伍自动选择" | (string & {});
+export type CombatStrategyName = "根据队伍自动选择" | "自动连招（实验）" | (string & {});
 
 /**
  * 战斗策略文件种类标识
- * 与上游 `AutoFightParam.ResolveStrategyPath` 返回的第二项对齐：优先命中 `.json`，否则回退 `.txt`；自动选队目录亦标为 `txt`
+ * 与上游 `AutoFightParam.ResolveStrategyPath` 返回的第二项对齐：优先命中 `.json`，否则回退 `.txt`；自动选队目录亦标为 `txt`；`自动连招（实验）` 标为 `combo`
  * @since 0.52.0
  */
 export type StrategyFileKind =
   | "json" // JSON 战斗策略
   | "txt" // 文本 / 简易策略（含「根据队伍自动选择」目录）
+  | "combo" // 自动连招（LLM 行为树），不对应策略文件
   | (string & {});
 
 /**
@@ -74,7 +75,6 @@ export interface AutoFightConfig
       | "pickDropsAfterFightEnabled"
       | "pickDropsAfterFightSeconds"
       | "qinDoublePickUp"
-      | "skipModel"
       | "strategyName"
       | "swimmingEnabled"
       | "teamNames"
@@ -145,12 +145,12 @@ export interface AutoFightConfig
    */
   onlyPickEliteDropsMode: OnlyPickEliteDropsMode;
   /**
-   * 是否在战斗结束后拾取掉落物
+   * 是否在战斗结束后光柱扫描掉落物，默认开启
    * @since 0.52.0
    */
   pickDropsAfterFightEnabled: boolean;
   /**
-   * 战斗结束后拾取掉落物的等待时长，单位秒，默认 15
+   * 战斗结束后光柱扫描掉落物的持续时长，单位秒，默认 15
    * @since 0.52.0
    */
   pickDropsAfterFightSeconds: number;
@@ -160,12 +160,7 @@ export interface AutoFightConfig
    */
   qinDoublePickUp: boolean;
   /**
-   * 是否启用跳过模型
-   * @since 0.52.0
-   */
-  skipModel: boolean;
-  /**
-   * 战斗策略名称，`根据队伍自动选择` 表示按当前队伍匹配策略
+   * 战斗策略名称，`根据队伍自动选择` 表示按当前队伍匹配策略，`自动连招（实验）` 为 LLM 行为树固定名
    * @since 0.52.0
    */
   strategyName: CombatStrategyName;
@@ -220,14 +215,16 @@ export interface AutoFightConfig_FightFinishDetectConfig
   extends
     Omit<
       CommunityToolkit.Mvvm.ComponentModel.ObservableObject,
-      | "battleEndProgressBarColor"
-      | "battleEndProgressBarColorTolerance"
       | "beforeDetectDelay"
+      | "blockCheckBeforeBattleSeconds"
+      | "checkAfterSwitchAvatar"
       | "checkBeforeBurst"
       | "checkEndDelay"
       | "fastCheckEnabled"
       | "fastCheckParams"
       | "isFirstCheck"
+      | "paimonEndCheckDelay"
+      | "paimonEndCheckEnabled"
       | "rotaryFactor"
       | "rotateFindEnemyEnabled"
       | "skipFightEndCheckWhenEnemyVisible"
@@ -235,16 +232,6 @@ export interface AutoFightConfig_FightFinishDetectConfig
     System.ComponentModel.INotifyPropertyChangedInput,
     System.ComponentModel.INotifyPropertyChangingInput {
   readonly [autoFightConfig_FightFinishDetectConfigBrand]: true;
-  /**
-   * 战斗结束进度条颜色容差，`6` 表示三通道相同容差，`6,6,6` 可分别设置，格式为 RGB
-   * @since 0.52.0
-   */
-  battleEndProgressBarColorTolerance: string;
-  /**
-   * 判断战斗结束的进度条颜色，`RGB` 格式，默认 `95,235,255`
-   * @since 0.52.0
-   */
-  battleEndProgressBarColor: string;
   /**
    * 按下切换队伍后检测屏幕色块的延迟，单位秒，默认 `0.4`，频繁误判时可适当提高
    * @since 0.52.0
@@ -256,20 +243,25 @@ export interface AutoFightConfig_FightFinishDetectConfig
    */
   checkBeforeBurst: boolean;
   /**
-   * 检查战斗结束前的延时，单位秒，可指定角色，格式如 `2.5;白术,1.5;钟离,1.0;`
+   * 触发战斗结束检查前的延时，单位秒，确保动作后摇结束；也可为角色单独指定，格式如 `0.4` 或 `0.4;钟离,1.5`
    * @since 0.52.0
    */
   checkEndDelay: string;
   /**
-   * 是否启用快速检查战斗结束
+   * 是否启用快速检查战斗结束；完成一轮动作后若满足条件则触发一次检查，默认关闭
    * @since 0.52.0
    */
   fastCheckEnabled: boolean;
   /**
-   * 快速检查参数，数字为间隔秒数，人名为该角色执行一轮后检查，分号分隔，例如 `15,白术;钟离;`
+   * 快速检查参数；数字为距上次检查的间隔秒数，人名为对应角色动作后触发，多项用分号分隔，格式如 `5` 或 `5;白术;`
    * @since 0.52.0
    */
   fastCheckParams: string;
+  /**
+   * 是否在切人后再执行战斗结束检查；无需等待上一动作后摇，目前仅 JSON 策略下生效
+   * @since 0.64.0
+   */
+  checkAfterSwitchAvatar: boolean;
   /**
    * 是否在首次检查时进行面敌
    * @since 0.52.0
@@ -286,10 +278,25 @@ export interface AutoFightConfig_FightFinishDetectConfig
    */
   rotateFindEnemyEnabled: boolean;
   /**
-   * 是否在敌人可见时跳过战斗结束检查；与旋转寻找敌人互斥
+   * 是否在敌人可见时跳过战斗结束检查；检测到敌人血条时跳过，与旋转寻找敌人互斥
    * @since 0.63.0
    */
   skipFightEndCheckWhenEnemyVisible: boolean;
+  /**
+   * 开战后阻断战斗结束检查的时长，单位秒；默认 0 不阻断，大于 0 时该时间内的检查视为战斗未结束
+   * @since 0.64.0
+   */
+  blockCheckBeforeBattleSeconds: number;
+  /**
+   * 是否启用派蒙辅助检测；按 L 后当派蒙头像可见时提前跳出战斗结束检测，默认关闭
+   * @since 0.64.0
+   */
+  paimonEndCheckEnabled: boolean;
+  /**
+   * 派蒙辅助检测延时，单位秒，默认 0.2
+   * @since 0.64.0
+   */
+  paimonEndCheckDelay: number;
 }
 
 export interface AutoFightConfig_FightFinishDetectConfigHostType extends HostType<

package/types/BetterGenshinImpact/GameTask/AutoFight/AutoFightParam.d.ts

@@ -69,12 +69,12 @@ export interface AutoFightParam extends Omit<
    */
   fightFinishDetectEnabled: boolean;
   /**
-   * 是否在战斗结束后拾取掉落物
+   * 是否在战斗结束后光柱扫描掉落物，默认开启
    * @since 0.52.0
    */
   pickDropsAfterFightEnabled: boolean;
   /**
-   * 战斗结束后拾取掉落物的等待时长，单位秒，默认 15
+   * 战斗结束后光柱扫描掉落物的持续时长，单位秒，默认 15
    * @since 0.52.0
    */
   pickDropsAfterFightSeconds: number;
@@ -201,28 +201,23 @@ export interface AutoFightParam extends Omit<
 declare const autoFightParam_FightFinishDetectConfigBrand: unique symbol;
 export interface AutoFightParam_FightFinishDetectConfig extends ClrHostValue {
   readonly [autoFightParam_FightFinishDetectConfigBrand]: true;
-  /**
-   * 判断战斗结束的进度条颜色，`RGB` 格式，默认 `95,235,255`
-   * @since 0.52.0
-   */
-  battleEndProgressBarColor: string;
-  /**
-   * 战斗结束进度条颜色容差，`6` 表示三通道相同容差，`6,6,6` 可分别设置
-   * @since 0.52.0
-   */
-  battleEndProgressBarColorTolerance: string;
   /**
    * 是否启用快速检查战斗结束
    * @since 0.52.0
    */
   fastCheckEnabled: boolean;
   /**
-   * 快速检查参数，数字为间隔秒数，人名为该角色执行一轮后检查，分号分隔
+   * 快速检查参数；数字为距上次检查的间隔秒数，人名为对应角色动作后触发，多项用分号分隔
    * @since 0.52.0
    */
   fastCheckParams: string;
   /**
-   * 检查战斗结束前的延时，单位秒，可指定角色
+   * 是否在切人后再执行战斗结束检查；无需等待上一动作后摇，目前仅 JSON 策略下生效
+   * @since 0.64.0
+   */
+  checkAfterSwitchAvatar: boolean;
+  /**
+   * 触发战斗结束检查前的延时，单位秒，确保动作后摇结束；也可为角色单独指定
    * @since 0.52.0
    */
   checkEndDelay: string;
@@ -237,10 +232,25 @@ export interface AutoFightParam_FightFinishDetectConfig extends ClrHostValue {
    */
   rotateFindEnemyEnabled: boolean;
   /**
-   * 是否在敌人可见时跳过战斗结束检查
+   * 是否在敌人可见时跳过战斗结束检查；检测到敌人血条时跳过，与旋转寻找敌人互斥
    * @since 0.63.0
    */
   skipFightEndCheckWhenEnemyVisible: boolean;
+  /**
+   * 开战后阻断战斗结束检查的时长，单位秒；默认 0 不阻断，大于 0 时该时间内的检查视为战斗未结束
+   * @since 0.64.0
+   */
+  blockCheckBeforeBattleSeconds: number;
+  /**
+   * 是否启用派蒙辅助检测；按 L 后当派蒙头像可见时提前跳出战斗结束检测
+   * @since 0.64.0
+   */
+  paimonEndCheckEnabled: boolean;
+  /**
+   * 派蒙辅助检测延时，单位秒
+   * @since 0.64.0
+   */
+  paimonEndCheckDelay: number;
 }
 
 export interface AutoFightParam_FightFinishDetectConfigHostType extends HostType<
@@ -268,6 +278,11 @@ declare global {
 }
 
 export interface AutoFightParamHostType extends HostType<AutoFightParam, ReferenceTypeTrait> {
+  /**
+   * 自动连招（LLM 行为树）策略的固定名称；不对应策略文件，命中时路由到自动连招任务
+   * @since 0.65.0
+   */
+  readonly comboStrategyName: "自动连招（实验）";
   /**
    * 使用指定策略路径与自动战斗配置构造参数
    * @param path 战斗策略文件或策略目录路径
@@ -291,7 +306,7 @@ export interface AutoFightParamHostType extends HostType<AutoFightParam, Referen
    */
   swimmingEnabled: boolean;
   /**
-   * 解析策略文件路径，优先检测 `.json`，未命中则回退 `.txt`
+   * 解析策略文件路径，优先检测 `.json`，未命中则回退 `.txt`；`自动连招（实验）` 返回策略名本身且种类为 `combo`
    * @param strategyName 策略名称（不含扩展名）
    * @returns 完整路径与策略文件种类组成的元组
    * @since 0.52.0

package/types/BetterGenshinImpact/GameTask/AutoFight/AutoFightTask.d.ts

@@ -5,11 +5,15 @@ import type {
   ReferenceTypeTrait,
   StrongNumeric
 } from "../../../Microsoft/ClearScript/HostType";
+import type { HostVariableOut } from "../../../Microsoft/ClearScript/HostVariable";
+import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
+import "../../../System/Collections/Generic/Dictionary";
+import "../../../System/Collections/Generic/List";
+import "../../../System/DateTime";
 import "../../../System/Threading/CancellationToken";
 import "../AutoPathing/Model/WaypointForTrack";
 import "../ISoloTask";
 import "./AutoFightParam";
-import "./Model/CombatScenes";
 
 /**
  * 自动战斗独立任务
@@ -23,12 +27,6 @@ export interface AutoFightTask extends ClrHostValue, BetterGenshinImpact.GameTas
    * @since 0.52.0
    */
   readonly name: string;
-  /**
-   * 识别当前队伍战斗场景，失败时最多重试 5 次
-   * @returns 已初始化的战斗场景
-   * @since 0.52.0
-   */
-  getCombatScenesWithRetry(): BetterGenshinImpact.GameTask.AutoFight.Model.CombatScenes;
   /**
    * 启动自动战斗任务
    * @param ct 取消令牌
@@ -51,6 +49,122 @@ export interface AutoFightTask extends ClrHostValue, BetterGenshinImpact.GameTas
   ): Promise<boolean>;
 }
 
+/**
+ * 战斗结束检测的运行时配置，由自动战斗参数解析而来，供 TXT 与 JSON 策略共用
+ * @since 0.64.0
+ */
+declare const autoFightTask_TaskFightFinishDetectConfigBrand: unique symbol;
+export interface AutoFightTask_TaskFightFinishDetectConfig extends ClrHostValue {
+  readonly [autoFightTask_TaskFightFinishDetectConfigBrand]: true;
+  /**
+   * 检查战斗结束前的默认延时，单位毫秒，默认 1500
+   * @since 0.64.0
+   */
+  delayTime: number;
+  /**
+   * 按下切换队伍后检测色块的延时，单位毫秒，默认 450
+   * @since 0.64.0
+   */
+  detectDelayTime: number;
+  /**
+   * 按角色名覆盖的检查延时，单位毫秒
+   * @since 0.64.0
+   */
+  delayTimes: System.Collections.Generic.Dictionary<string, number>;
+  /**
+   * 快速检查间隔，单位秒，默认 5
+   * @since 0.64.0
+   */
+  checkTime: number;
+  /**
+   * 触发快速检查的角色名列表
+   * @since 0.64.0
+   */
+  checkNames: System.Collections.Generic.List<string>;
+  /**
+   * 是否启用快速检查战斗结束
+   * @since 0.64.0
+   */
+  fastCheckEnabled: boolean;
+  /**
+   * 是否在切人后再执行战斗结束检查；无需等待上一动作后摇，目前仅 JSON 策略下生效
+   * @since 0.64.0
+   */
+  checkAfterSwitchAvatar: boolean;
+  /**
+   * 是否启用旋转寻找敌人
+   * @since 0.64.0
+   */
+  rotateFindEnemyEnabled: boolean;
+  /**
+   * 是否在敌人可见时跳过战斗结束检查；检测到敌人血条时跳过，与旋转寻找敌人互斥
+   * @since 0.64.0
+   */
+  skipFightEndCheckWhenEnemyVisible: boolean;
+  /**
+   * 开战后阻断战斗结束检查的时长，单位秒；默认 0 不阻断，大于 0 时该时间内的检查视为战斗未结束
+   * @since 0.64.0
+   */
+  blockCheckBeforeBattleSeconds: number;
+  /**
+   * 是否启用派蒙辅助检测；按 L 后当派蒙头像可见时提前跳出战斗结束检测
+   * @since 0.64.0
+   */
+  paimonEndCheckEnabled: boolean;
+  /**
+   * 派蒙辅助检测延时，单位毫秒
+   * @since 0.64.0
+   */
+  paimonEndCheckDelayMs: number;
+}
+
+export interface AutoFightTask_TaskFightFinishDetectConfigHostType extends HostType<
+  AutoFightTask_TaskFightFinishDetectConfig,
+  ReferenceTypeTrait
+> {
+  /**
+   * 由自动战斗参数中的战斗结束检测配置构造运行时配置
+   * @param finishDetectConfig 自动战斗参数中的战斗结束检测配置
+   * @since 0.64.0
+   */
+  new (
+    finishDetectConfig: BetterGenshinImpact.GameTask.AutoFight.AutoFightParam.FightFinishDetectConfig
+  ): AutoFightTask_TaskFightFinishDetectConfig;
+  /**
+   * 解析快速检查参数字符串
+   * @param input 快速检查参数；数字为间隔秒数，人名为对应角色动作后触发，分号分隔
+   * @param checkTime 解析得到的检查间隔秒数
+   * @param names 解析得到的角色名列表，方法会追加去重后的人名
+   * @returns ClearScript 宿主空结果
+   * @since 0.64.0
+   */
+  parseCheckTimeString(
+    input: string,
+    checkTime: HostVariableOut<number>,
+    names: System.Collections.Generic.List<string>
+  ): VoidResult;
+  /**
+   * 解析检查结束延时字符串
+   * @param input 延时配置；纯数字为默认秒数，`名字,秒数` 为角色覆盖，分号分隔
+   * @param delayTime 解析得到的默认延时，单位毫秒
+   * @param nameDelayMap 角色名到延时毫秒的映射，方法会写入覆盖值
+   * @returns ClearScript 宿主空结果
+   * @since 0.64.0
+   */
+  parseFastCheckEndDelayString(
+    input: string,
+    delayTime: HostVariableOut<number>,
+    nameDelayMap: System.Collections.Generic.Dictionary<string, number>
+  ): VoidResult;
+}
+
+declare global {
+  namespace BetterGenshinImpact.GameTask.AutoFight.AutoFightTask {
+    type TaskFightFinishDetectConfig =
+      import("./AutoFightTask").AutoFightTask_TaskFightFinishDetectConfig;
+  }
+}
+
 declare global {
   namespace BetterGenshinImpact.GameTask.AutoFight {
     type AutoFightTask = import("./AutoFightTask").AutoFightTask;
@@ -64,6 +178,12 @@ export interface AutoFightTaskHostType extends HostType<AutoFightTask, Reference
    * @since 0.52.0
    */
   new (taskParam: BetterGenshinImpact.GameTask.AutoFight.AutoFightParam): AutoFightTask;
+  /**
+   * 重置「敌人可见时跳过战斗结束检查」的连续跳过计数；每场战斗开始时调用，TXT 与 JSON 策略共用
+   * @returns ClearScript 宿主空结果
+   * @since 0.64.0
+   */
+  resetSkipCheckCounter(): VoidResult;
   /**
    * 全局战斗进行中标志
    * @since 0.52.0
@@ -74,6 +194,41 @@ export interface AutoFightTaskHostType extends HostType<AutoFightTask, Reference
    * @since 0.52.0
    */
   fightWaypoint: BetterGenshinImpact.GameTask.AutoPathing.Model.WaypointForTrack;
+  /**
+   * 最近一次战斗结束检查的时间；TXT 与 JSON 策略共用，供更快触发检查判断间隔
+   * @since 0.64.0
+   */
+  lastFightFinishCheckTime: System.DateTime;
+  /**
+   * 本次战斗的开战时间；TXT 与 JSON 策略共用，供开战后一段时间阻断战斗结束检查
+   * @since 0.64.0
+   */
+  fightStartTime: System.DateTime;
+  /**
+   * 检查战斗是否已结束；TXT 与 JSON 策略共用的统一实现
+   * @param finishDetectConfig 战斗结束检测运行时配置
+   * @param ct 取消令牌
+   * @param delayTime 检查前延时，单位毫秒，默认 1500
+   * @param detectDelayTime 切换队伍后检测色块的延时，单位毫秒，默认 450
+   * @returns 在检测完成后兑现是否结束的 Promise
+   * @since 0.64.0
+   */
+  checkFightFinish(
+    finishDetectConfig: BetterGenshinImpact.GameTask.AutoFight.AutoFightTask.TaskFightFinishDetectConfig,
+    ct: System.Threading.CancellationToken
+  ): Promise<boolean>;
+  checkFightFinish(
+    finishDetectConfig: BetterGenshinImpact.GameTask.AutoFight.AutoFightTask.TaskFightFinishDetectConfig,
+    ct: System.Threading.CancellationToken,
+    delayTime: number | StrongNumeric<Int32Host>
+  ): Promise<boolean>;
+  checkFightFinish(
+    finishDetectConfig: BetterGenshinImpact.GameTask.AutoFight.AutoFightTask.TaskFightFinishDetectConfig,
+    ct: System.Threading.CancellationToken,
+    delayTime: number | StrongNumeric<Int32Host>,
+    detectDelayTime: number | StrongNumeric<Int32Host>
+  ): Promise<boolean>;
+  readonly TaskFightFinishDetectConfig: AutoFightTask_TaskFightFinishDetectConfigHostType;
 }
 
 export {};

package/types/BetterGenshinImpact/GameTask/AutoFight/Model/Avatar.d.ts

@@ -11,8 +11,8 @@ import "../../../../OpenCvSharp/Rect";
 import "../../../../System/DateTime";
 import "../../../../System/Nullable";
 import "../../../../System/Threading/CancellationToken";
-import "../../../../System/WebSocket";
 import type { KeyCode } from "../../../Helpers/User32Helper";
+import "../../AutoGeniusInvokation/Exception/RetryException";
 import "../../Model/Area/ImageRegion";
 import "../Config/CombatAvatar";
 import "./CombatScenes";
@@ -123,8 +123,8 @@ export type AvatarName =
   | "丝柯克"
   | "塔利雅"
   | "伊涅芙"
-  | "奇偶(男)"
-  | "奇偶(女)"
+  | "奇偶·男性"
+  | "奇偶·女性"
   | "菈乌玛"
   | "菲林斯"
   | "爱诺"
@@ -469,13 +469,16 @@ export interface AvatarHostType extends HostType<Avatar, ReferenceTypeTrait> {
     ct: System.Threading.CancellationToken
   ): VoidResult;
   /**
-   * 传送到七天神像恢复角色状态
+   * 传送到七天神像恢复角色状态；完成后抛出传入的重试异常
    * @param ct 取消令牌
-   * @param ex 触发恢复的异常
+   * @param retryException 触发恢复后用于重试当前任务的异常
    * @returns ClearScript 宿主空结果
    * @since 0.50.0
    */
-  tpForRecover(ct: System.Threading.CancellationToken, ex: System.Exception): VoidResult;
+  tpForRecover(
+    ct: System.Threading.CancellationToken,
+    retryException: BetterGenshinImpact.GameTask.AutoGeniusInvokation.Exception.RetryException
+  ): VoidResult;
   /**
    * 从配置字符串中查找角色冷却秒数
    * @param avatarName 角色名称

package/types/BetterGenshinImpact/GameTask/AutoFight/Model/CombatScenes.d.ts

@@ -246,6 +246,12 @@ export interface CombatScenesHostType extends HostType<CombatScenes, ReferenceTy
     logger: Microsoft.Extensions.Logging.ILogger | null,
     systemInfo: BetterGenshinImpact.GameTask.Model.ISystemInfo | null
   ): CombatScenes;
+  /**
+   * 截屏识别队伍角色并初始化战斗场景，失败时最多重试 5 次，间隔 1 秒
+   * @returns 已初始化的战斗场景
+   * @since 0.65.0
+   */
+  getCombatScenesWithRetry(): CombatScenes;
 }
 
 export {};

package/types/BetterGenshinImpact/GameTask/AutoGeniusInvokation/Exception/RetryException.d.ts

@@ -0,0 +1,42 @@
+import type {
+  HostType,
+  PublicDefaultConstructorTrait,
+  ReferenceTypeTrait
+} from "../../../../Microsoft/ClearScript/HostType";
+import "../../../../System/Runtime/Serialization/ISerializable";
+import "../../../../System/WebSocket";
+
+/**
+ * 需要重试当前任务时抛出的异常
+ * @since 0.65.0
+ */
+declare const retryExceptionBrand: unique symbol;
+export interface RetryException
+  extends System.Exception, System.Runtime.Serialization.ISerializableInput {
+  readonly [retryExceptionBrand]: true;
+}
+
+declare global {
+  namespace BetterGenshinImpact.GameTask.AutoGeniusInvokation.Exception {
+    type RetryException = import("./RetryException").RetryException;
+  }
+}
+
+export interface RetryExceptionHostType extends HostType<
+  RetryException,
+  ReferenceTypeTrait & PublicDefaultConstructorTrait
+> {
+  /**
+   * 构造实例
+   * @since 0.65.0
+   */
+  new (): RetryException;
+  /**
+   * 使用说明信息构造实例
+   * @param message 异常说明
+   * @since 0.65.0
+   */
+  new (message: string): RetryException;
+}
+
+export {};

package/types/BetterGenshinImpact/GameTask/AutoLeyLineOutcrop/AutoLeyLineOutcropConfig.d.ts

@@ -24,7 +24,6 @@ export interface AutoLeyLineOutcropConfig
       | "fightConfig"
       | "friendshipTeam"
       | "isGoToSynthesizer"
-      | "isNotification"
       | "isResinExhaustionMode"
       | "leyLineOutcropType"
       | "openModeCountMin"
@@ -32,7 +31,6 @@ export interface AutoLeyLineOutcropConfig
       | "scanDropsAfterRewardSeconds"
       | "team"
       | "timeout"
-      | "useAdventurerHandbook"
       | "useFragileResin"
       | "useTransientResin"
     >,
@@ -64,11 +62,6 @@ export interface AutoLeyLineOutcropConfig
    * @since 0.58.0
    */
   isGoToSynthesizer: boolean;
-  /**
-   * 是否通过 BetterGI 通知系统发送详细通知
-   * @since 0.58.0
-   */
-  isNotification: boolean;
   /**
    * 是否开启树脂耗尽模式
    * @since 0.58.0
@@ -104,11 +97,6 @@ export interface AutoLeyLineOutcropConfig
    * @since 0.58.0
    */
   timeout: number;
-  /**
-   * 是否使用冒险之证寻找地脉花
-   * @since 0.58.0
-   */
-  useAdventurerHandbook: boolean;
   /**
    * 是否允许使用脆弱树脂
    * @since 0.58.0

package/types/BetterGenshinImpact/GameTask/AutoLeyLineOutcrop/AutoLeyLineOutcropFightConfig.d.ts

@@ -147,30 +147,23 @@ export interface AutoLeyLineOutcropFightConfig_FightFinishDetectConfig
   extends
     Omit<
       CommunityToolkit.Mvvm.ComponentModel.ObservableObject,
-      | "battleEndProgressBarColor"
-      | "battleEndProgressBarColorTolerance"
       | "beforeDetectDelay"
+      | "blockCheckBeforeBattleSeconds"
+      | "checkAfterSwitchAvatar"
       | "checkBeforeBurst"
       | "checkEndDelay"
       | "fastCheckEnabled"
       | "fastCheckParams"
       | "isFirstCheck"
+      | "paimonEndCheckDelay"
+      | "paimonEndCheckEnabled"
       | "rotaryFactor"
       | "rotateFindEnemyEnabled"
+      | "skipFightEndCheckWhenEnemyVisible"
     >,
     System.ComponentModel.INotifyPropertyChangedInput,
     System.ComponentModel.INotifyPropertyChangingInput {
   readonly [autoLeyLineOutcropFightConfig_FightFinishDetectConfigBrand]: true;
-  /**
-   * 战斗结束进度条颜色容差，`6` 表示三通道相同容差，`6,6,6` 可分别设置
-   * @since 0.58.0
-   */
-  battleEndProgressBarColorTolerance: string;
-  /**
-   * 判断战斗结束的进度条颜色，`RGB` 格式
-   * @since 0.58.0
-   */
-  battleEndProgressBarColor: string;
   /**
    * 按下切换队伍后检测屏幕色块的延迟，单位秒
    * @since 0.58.0
@@ -196,6 +189,11 @@ export interface AutoLeyLineOutcropFightConfig_FightFinishDetectConfig
    * @since 0.58.0
    */
   fastCheckParams: string;
+  /**
+   * 是否在切人后再执行战斗结束检查；无需等待上一动作后摇，目前仅 JSON 策略下生效
+   * @since 0.64.0
+   */
+  checkAfterSwitchAvatar: boolean;
   /**
    * 是否在首次检查时进行面敌
    * @since 0.58.0
@@ -211,6 +209,26 @@ export interface AutoLeyLineOutcropFightConfig_FightFinishDetectConfig
    * @since 0.58.0
    */
   rotateFindEnemyEnabled: boolean;
+  /**
+   * 是否在敌人可见时跳过战斗结束检查；检测到敌人血条时跳过，与旋转寻找敌人互斥
+   * @since 0.64.0
+   */
+  skipFightEndCheckWhenEnemyVisible: boolean;
+  /**
+   * 开战后阻断战斗结束检查的时长，单位秒；默认 0 不阻断，大于 0 时该时间内的检查视为战斗未结束
+   * @since 0.64.0
+   */
+  blockCheckBeforeBattleSeconds: number;
+  /**
+   * 是否启用派蒙辅助检测；按 L 后当派蒙头像可见时提前跳出战斗结束检测
+   * @since 0.64.0
+   */
+  paimonEndCheckEnabled: boolean;
+  /**
+   * 派蒙辅助检测延时，单位秒
+   * @since 0.64.0
+   */
+  paimonEndCheckDelay: number;
 }
 
 export interface AutoLeyLineOutcropFightConfig_FightFinishDetectConfigHostType extends HostType<

package/types/BetterGenshinImpact/GameTask/AutoLeyLineOutcrop/AutoLeyLineOutcropParam.d.ts

@@ -30,7 +30,6 @@ export interface AutoLeyLineOutcropParam extends Omit<
   | "fightConfig"
   | "friendshipTeam"
   | "isGoToSynthesizer"
-  | "isNotification"
   | "isResinExhaustionMode"
   | "leyLineOutcropType"
   | "openModeCountMin"
@@ -40,7 +39,6 @@ export interface AutoLeyLineOutcropParam extends Omit<
   | "setDefault"
   | "team"
   | "timeout"
-  | "useAdventurerHandbook"
   | "useFragileResin"
   | "useTransientResin"
 > {
@@ -70,11 +68,6 @@ export interface AutoLeyLineOutcropParam extends Omit<
    * @since 0.58.0
    */
   isResinExhaustionMode: boolean;
-  /**
-   * 是否使用冒险之证寻找地脉花
-   * @since 0.58.0
-   */
-  useAdventurerHandbook: boolean;
   /**
    * 好感队名称
    * @since 0.58.0
@@ -110,11 +103,6 @@ export interface AutoLeyLineOutcropParam extends Omit<
    * @since 0.58.0
    */
   useTransientResin: boolean;
-  /**
-   * 是否通过 BetterGI 通知系统发送详细通知
-   * @since 0.58.0
-   */
-  isNotification: boolean;
   /**
    * 是否在领取奖励后扫描掉落物光柱
    * @since 0.59.0

package/types/BetterGenshinImpact/GameTask/AutoPathing/PathingScriptNames.d.ts

@@ -56,6 +56,8 @@ export type HurryOnAvatar =
   | "流浪者"
   | "伊法"
   | "希诺宁"
+  | "法尔伽"
+  | "夜兰"
   | (string & {});
 
 /**