@bettergi/types 0.1.18 → 0.1.19

package/package.json

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

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 =
+  | "根据提升指南选择秘境"
   | "铭记之谷"
   | "忘却之峡"
   | "仲夏庭园"
@@ -119,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,8 +215,6 @@ export interface AutoFightConfig_FightFinishDetectConfig
   extends
     Omit<
       CommunityToolkit.Mvvm.ComponentModel.ObservableObject,
-      | "battleEndProgressBarColor"
-      | "battleEndProgressBarColorTolerance"
       | "beforeDetectDelay"
       | "blockCheckBeforeBattleSeconds"
       | "checkAfterSwitchAvatar"
@@ -239,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
@@ -305,12 +288,12 @@ export interface AutoFightConfig_FightFinishDetectConfig
    */
   blockCheckBeforeBattleSeconds: number;
   /**
-   * 是否启用派蒙辅助检测；按 L 后当派蒙头像可见时提前跳出战斗结束检测
+   * 是否启用派蒙辅助检测；按 L 后当派蒙头像可见时提前跳出战斗结束检测，默认关闭
    * @since 0.64.0
    */
   paimonEndCheckEnabled: boolean;
   /**
-   * 派蒙辅助检测延时，单位秒
+   * 派蒙辅助检测延时，单位秒，默认 0.2
    * @since 0.64.0
    */
   paimonEndCheckDelay: number;

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,16 +201,6 @@ 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
@@ -288,6 +278,11 @@ declare global {
 }
 
 export interface AutoFightParamHostType extends HostType<AutoFightParam, ReferenceTypeTrait> {
+  /**
+   * 自动连招（LLM 行为树）策略的固定名称；不对应策略文件，命中时路由到自动连招任务
+   * @since 0.65.0
+   */
+  readonly comboStrategyName: "自动连招（实验）";
   /**
    * 使用指定策略路径与自动战斗配置构造参数
    * @param path 战斗策略文件或策略目录路径
@@ -311,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

@@ -11,11 +11,9 @@ import "../../../System/Collections/Generic/Dictionary";
 import "../../../System/Collections/Generic/List";
 import "../../../System/DateTime";
 import "../../../System/Threading/CancellationToken";
-import "../../../System/ValueTuple";
 import "../AutoPathing/Model/WaypointForTrack";
 import "../ISoloTask";
 import "./AutoFightParam";
-import "./Model/CombatScenes";
 
 /**
  * 自动战斗独立任务
@@ -29,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 取消令牌
@@ -124,16 +116,6 @@ export interface AutoFightTask_TaskFightFinishDetectConfig extends ClrHostValue
    * @since 0.64.0
    */
   paimonEndCheckDelayMs: number;
-  /**
-   * 判断战斗结束的进度条颜色，RGB 三元组
-   * @since 0.64.0
-   */
-  readonly battleEndProgressBarColor: System.ValueTuple<number, number, number>;
-  /**
-   * 战斗结束进度条颜色容差，RGB 三元组
-   * @since 0.64.0
-   */
-  readonly battleEndProgressBarColorTolerance: System.ValueTuple<number, number, number>;
 }
 
 export interface AutoFightTask_TaskFightFinishDetectConfigHostType extends HostType<

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";
@@ -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,8 +147,6 @@ export interface AutoLeyLineOutcropFightConfig_FightFinishDetectConfig
   extends
     Omit<
       CommunityToolkit.Mvvm.ComponentModel.ObservableObject,
-      | "battleEndProgressBarColor"
-      | "battleEndProgressBarColorTolerance"
       | "beforeDetectDelay"
       | "blockCheckBeforeBattleSeconds"
       | "checkAfterSwitchAvatar"
@@ -166,16 +164,6 @@ export interface AutoLeyLineOutcropFightConfig_FightFinishDetectConfig
     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

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