@bettergi/types 0.1.15 → 0.1.17

package/types/BetterGenshinImpact/Core/BgiVision/BvPage.d.ts

@@ -10,11 +10,13 @@ import type {
 } from "../../../Microsoft/ClearScript/HostType";
 import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
 import "../../../OpenCvSharp/Rect";
+import "../../../System/Collections/Generic/IEnumerable";
 import "../../../System/Collections/Generic/List";
 import "../../../System/Threading/CancellationToken";
 import "../../GameTask/Model/Area/ImageRegion";
 import "../../GameTask/Model/Area/Region";
 import "../Recognition/RecognitionObject";
+import "./BvFlow";
 import "./BvImage";
 import "./BvLocator";
 
@@ -45,6 +47,12 @@ export interface BvPage extends ClrHostValue {
    * @since 0.57.0
    */
   defaultRetryInterval: number;
+  /**
+   * 创建使用当前超时与重试间隔的链式流程
+   * @returns 新的空流程
+   * @since 0.63.0
+   */
+  flow(): BetterGenshinImpact.Core.BgiVision.BvFlow;
   /**
    * 截取当前游戏画面为图像区域
    * @returns 当前游戏画面的图像区域
@@ -97,6 +105,20 @@ export interface BvPage extends ClrHostValue {
   getByText(): BetterGenshinImpact.Core.BgiVision.BvLocator;
   getByText(text: string): BetterGenshinImpact.Core.BgiVision.BvLocator;
   getByText(text: string, rect: OpenCvSharp.Rect): BetterGenshinImpact.Core.BgiVision.BvLocator;
+  /**
+   * 按任一指定文本创建定位器
+   * @param texts 字符串集合或 ClearScript JS Array
+   * @param rect 感兴趣区域；省略时搜索整幅画面
+   * @returns 对应目标的定位器
+   * @since 0.63.0
+   */
+  getByAnyText(
+    texts: readonly string[] | System.Collections.Generic.IEnumerableInput<string>
+  ): BetterGenshinImpact.Core.BgiVision.BvLocator;
+  getByAnyText(
+    texts: readonly string[] | System.Collections.Generic.IEnumerableInput<string>,
+    rect: OpenCvSharp.Rect
+  ): BetterGenshinImpact.Core.BgiVision.BvLocator;
   /**
    * 按图像创建定位器
    * @param image BgiVision 模板图像

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

@@ -46,17 +46,17 @@ export interface RecognitionObject extends ClrHostValue {
   name: string;
   /**
    * 模板图或识别区域所在捕获画布的尺寸，例如 1920×1080、3840×2160，对应模板截取来源图像大小
-   * @since unreleased
+   * @since 0.63.0
    */
   referenceImageSize: OpenCvSharp.Size | null;
   /**
    * 模板图或识别区域在截取来源图像中的位置与大小；模板匹配时宽高通常等于模板图尺寸，语义接近 bbox
-   * @since unreleased
+   * @since 0.63.0
    */
   referenceBoundingBox: OpenCvSharp.Rect | null;
   /**
    * 查找位置时的搜索选项；未指定时使用默认机制
-   * @since unreleased
+   * @since 0.63.0
    */
   searchOptions: BetterGenshinImpact.Core.Recognition.SearchOptions;
   /**

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

@@ -67,7 +67,7 @@ export interface AutoPathingScript extends ClrHostValue {
    * 读取 AutoPathing 目录下指定文件的文本内容
    * @param subPath 相对于 User\AutoPathing 的文件路径
    * @returns 文件文本内容，读取失败时返回空字符串
-   * @since unreleased
+   * @since 0.63.0
    */
   readTextSync(subPath: string): string;
 }

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

@@ -11,10 +11,11 @@ import "../../../../System/Threading/CancellationTokenSource";
 import "../../../GameTask/AutoBoss/AutoBossParam";
 import "../../../GameTask/AutoDomain/AutoDomainParam";
 import "../../../GameTask/AutoFight/AutoFightParam";
+import type { AvatarName } from "../../../GameTask/AutoFight/Model/Avatar";
 import "../../../GameTask/AutoLeyLineOutcrop/AutoLeyLineOutcropParam";
 import "../../../GameTask/AutoStygianOnslaught/AutoStygianOnslaughtParam";
 import "../../../GameTask/Common/Job/CountInventoryItemParam";
-import "./Model/RealTimeTimer";
+import "./Model/RealtimeTimer";
 import "./Model/SoloTask";
 
 /**
@@ -132,13 +133,13 @@ export interface Dispatcher extends ClrHostValue {
    * @param avatarName 指定操作的角色名，省略时操作当前角色
    * @param customCt 自定义取消令牌
    * @returns 在任务完成后兑现的 Promise
-   * @since unreleased
+   * @since 0.63.0
    */
   runCombatScript(script: string): Promise<void>;
-  runCombatScript(script: string, avatarName: string | null): Promise<void>;
+  runCombatScript(script: string, avatarName: AvatarName | null): Promise<void>;
   runCombatScript(
     script: string,
-    avatarName: string | null,
+    avatarName: AvatarName | null,
     customCt: System.Threading.CancellationToken | null | null
   ): Promise<void>;
   /**

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

@@ -12,8 +12,10 @@ import type { VoidResult } from "../../../../Microsoft/ClearScript/VoidResult";
 import "../../../../OpenCvSharp/Point2f";
 import "../../../../System/Lazy";
 import "../../../../System/Nullable";
+import type { AvatarName } from "../../../GameTask/AutoFight/Model/Avatar";
 import "../../../GameTask/AutoPathing/NavigationInstance";
 import "../../../GameTask/Common/Job/CraftMaterialTask";
+import type { CraftMaterialType } from "../../../GameTask/Common/Job/CraftMaterialTask";
 import type {
   Area,
   CountryName,
@@ -138,7 +140,7 @@ export interface Genshin extends ClrHostValue {
    * @param y 目标 Y 坐标
    * @param forceCountry 强制先切换的大地图区域（`SwitchArea` OCR 文案），默认为 null
    * @returns 在任务完成后兑现的 Promise
-   * @since unreleased
+   * @since 0.63.0
    */
   clickMapPoint(
     x: number | StrongNumeric<DoubleHost>,
@@ -281,18 +283,27 @@ export interface Genshin extends ClrHostValue {
    * 按槽位重组当前队伍角色
    * 未传入或空字符串的槽位跳过；重组队伍槽位角色，不是按数字键切换当前出战角色
    * 示例：`await genshin.switchCharacter("胡桃", "夜兰", "", "钟离")`
-   * @param slot1 1 号位角色名
-   * @param slot2 2 号位角色名
-   * @param slot3 3 号位角色名
-   * @param slot4 4 号位角色名
+   * @param slot1 1 号位角色名，空字符串表示跳过
+   * @param slot2 2 号位角色名，空字符串表示跳过
+   * @param slot3 3 号位角色名，空字符串表示跳过
+   * @param slot4 4 号位角色名，空字符串表示跳过
    * @returns 在任务完成后兑现是否成功的 Promise；完成保存并返回主界面为 true，参数无效、目标角色未找到或流程失败为 false
-   * @since unreleased
+   * @since 0.63.0
    */
   switchCharacter(): Promise<boolean>;
-  switchCharacter(slot1: string): Promise<boolean>;
-  switchCharacter(slot1: string, slot2: string): Promise<boolean>;
-  switchCharacter(slot1: string, slot2: string, slot3: string): Promise<boolean>;
-  switchCharacter(slot1: string, slot2: string, slot3: string, slot4: string): Promise<boolean>;
+  switchCharacter(slot1: "" | AvatarName): Promise<boolean>;
+  switchCharacter(slot1: "" | AvatarName, slot2: "" | AvatarName): Promise<boolean>;
+  switchCharacter(
+    slot1: "" | AvatarName,
+    slot2: "" | AvatarName,
+    slot3: "" | AvatarName
+  ): Promise<boolean>;
+  switchCharacter(
+    slot1: "" | AvatarName,
+    slot2: "" | AvatarName,
+    slot3: "" | AvatarName,
+    slot4: "" | AvatarName
+  ): Promise<boolean>;
   /**
    * 清除当前调度器的队伍缓存
    * @returns ClearScript 宿主空结果
@@ -346,6 +357,13 @@ export interface Genshin extends ClrHostValue {
    * @since 0.43.1
    */
   goToCraftingBench(country: CountryName): Promise<void>;
+  /**
+   * 前往合成台并合成浓缩树脂
+   * @param country 国家名称
+   * @returns 在任务完成后兑现的 Promise
+   * @since 0.63.0
+   */
+  goCraftResin(country: CountryName): Promise<void>;
   /**
    * 在当前已打开的合成界面中合成指定材料
    * @param materialName 目标成品材料名
@@ -361,7 +379,7 @@ export interface Genshin extends ClrHostValue {
   craftMaterial(
     materialName: string,
     quantity: number | StrongNumeric<Int32Host>,
-    materialType: string | null
+    materialType: CraftMaterialType | null
   ): Promise<BetterGenshinImpact.GameTask.Common.Job.CraftMaterialResult>;
   /**
    * 返回主界面

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

@@ -84,6 +84,7 @@ declare global {
 declare global {
   namespace BetterGenshinImpact.Core.Script.Dependence {
     type Http = import("./Http").Http;
+    type HttpMethod = import("./Http").HttpMethod;
   }
 }
 

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

@@ -100,6 +100,7 @@ export interface KeyMouseHook extends ClrHostValue, System.IDisposableInput {
 declare global {
   namespace BetterGenshinImpact.Core.Script.Dependence {
     type KeyMouseHook = import("./KeyMouseHook").KeyMouseHook;
+    type MouseButton = import("./KeyMouseHook").MouseButton;
   }
 }
 

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

@@ -64,11 +64,14 @@ export interface LimitedFile extends ClrHostValue {
    * 异步读取文件全部文本
    * 读取失败时通过回调传入错误并返回空字符串
    * @param path 相对工作区的文件路径
-   * @param callbackFunc 回调函数，签名为 (error, text)
+   * @param callbackFunc 脚本回调 `(error, text)`；成功时 `error` 为 null，失败时 `text` 为 null
    * @returns 在任务完成后兑现文件文本的 Promise
    * @since 0.43.1
    */
-  readText(path: string, callbackFunc: unknown): Promise<string>;
+  readText(
+    path: string,
+    callbackFunc: (error: string | null, text: string | null) => void
+  ): Promise<string>;
   /**
    * 异步读取文件全部文本
    * 读取失败时返回空字符串
@@ -130,17 +133,21 @@ export interface LimitedFile extends ClrHostValue {
    * 异步写入文本到文件并触发回调
    * @param path 相对工作区的文件路径
    * @param content 要写入的内容
-   * @param callbackFunc 回调函数，签名为 (error, success)
+   * @param callbackFunc 脚本回调 `(error, success)`；成功时 `error` 为 null，失败时 `success` 为 null
    * @param append 是否追加到文件末尾，默认为 false（覆盖）
    * @returns 在任务完成后兑现是否写入成功的 Promise
    * @since 0.44.4
    */
-  writeText(path: string, content: string, callbackFunc: unknown): Promise<boolean>;
+  writeText(
+    path: string,
+    content: string,
+    callbackFunc: (error: string | null, success: boolean | null) => void
+  ): Promise<boolean>;
   writeText(path: string, content: string, append: boolean): Promise<boolean>;
   writeText(
     path: string,
     content: string,
-    callbackFunc: unknown,
+    callbackFunc: (error: string | null, success: boolean | null) => void,
     append: boolean
   ): Promise<boolean>;
   /**

package/types/BetterGenshinImpact/Core/Script/Dependence/Model/RealtimeTimer.d.ts

@@ -4,6 +4,48 @@ import type {
   PublicDefaultConstructorTrait,
   ReferenceTypeTrait
 } from "../../../../../Microsoft/ClearScript/HostType";
+import "../../../../GameTask/AutoSkip/AutoSkipConfig";
+
+/**
+ * 实时触发器名 → RealtimeTimer.Config（唯一真源；配置一律 inline，无额外 type 名）
+ * 与 `GameTaskManager.AddTrigger` / `RealtimeTimer` 构造对齐
+ * @since 0.43.1
+ */
+export type RealtimeTriggerConfigMap = {
+  /**
+   * 自动拾取
+   * 对应上游 `AutoPickExternalConfig`
+   */
+  AutoPick: {
+    /** 需要 F 的文本（对话、拾取） */
+    textList?: string[];
+    /** 无视文本和图标，遇到 F 就点击；默认 false */
+    forceInteraction?: boolean;
+  };
+  /**
+   * 自动跳过剧情
+   * 构造侧要求传入 `AutoSkipConfig` 实例
+   */
+  AutoSkip: BetterGenshinImpact.GameTask.AutoSkip.AutoSkipConfig;
+  /**
+   * 自动吃药；`AddTrigger` 可按名添加，构造不解析专用 config
+   */
+  AutoEat: void;
+};
+
+/**
+ * 实时触发器注册名 = map key；`(string & {})` 保留未知扩展
+ * @see GameTaskManager.AddTrigger
+ * @since 0.43.1
+ */
+export type RealtimeTriggerName = keyof RealtimeTriggerConfigMap | (string & {});
+
+export type RealtimeTriggerConfigForName<TName extends RealtimeTriggerName> =
+  TName extends keyof RealtimeTriggerConfigMap
+    ? RealtimeTriggerConfigMap[TName] extends void
+      ? undefined
+      : RealtimeTriggerConfigMap[TName]
+    : Record<string, unknown>;
 
 /**
  * 实时任务触发器
@@ -16,22 +58,30 @@ export interface RealtimeTimer extends ClrHostValue {
    * 实时任务触发器名称
    * @since 0.43.1
    */
-  name: string;
+  name: RealtimeTriggerName;
   /**
    * 实时任务触发间隔，单位毫秒，默认 50
    * @since 0.43.1
    */
   interval: number;
   /**
-   * 实时任务配置
+   * 实时任务配置（CLR 存 `object?`，JS 侧 plain object 或宿主配置实例）
    * @since 0.43.1
    */
-  config: unknown;
+  config:
+    | Exclude<RealtimeTriggerConfigMap[keyof RealtimeTriggerConfigMap], void>
+    | Record<string, unknown>
+    | null
+    | undefined;
 }
 
 declare global {
   namespace BetterGenshinImpact.Core.Script.Dependence.Model {
-    type RealtimeTimer = import("./RealTimeTimer").RealtimeTimer;
+    type RealtimeTimer = import("./RealtimeTimer").RealtimeTimer;
+    type RealtimeTriggerConfigForName<TName extends RealtimeTriggerName> =
+      import("./RealtimeTimer").RealtimeTriggerConfigForName<TName>;
+    type RealtimeTriggerConfigMap = import("./RealtimeTimer").RealtimeTriggerConfigMap;
+    type RealtimeTriggerName = import("./RealtimeTimer").RealtimeTriggerName;
   }
 }
 
@@ -45,18 +95,23 @@ export interface RealtimeTimerHostType extends HostType<
    */
   new (): RealtimeTimer;
   /**
-   * 构造实例
+   * 仅名称
    * @param name 实时任务触发器名称
    * @since 0.43.1
    */
-  new (name: string): RealtimeTimer;
+  new (name: RealtimeTriggerName): RealtimeTimer;
   /**
-   * 构造实例
+   * 名称 + 配置（按触发器名收窄）
    * @param name 实时任务触发器名称
    * @param config 实时任务配置
    * @since 0.43.1
    */
-  new (name: string, config: unknown): RealtimeTimer;
+  new <TName extends RealtimeTriggerName>(
+    name: TName,
+    config: RealtimeTriggerConfigForName<TName> extends undefined
+      ? Record<string, unknown> | undefined
+      : RealtimeTriggerConfigForName<TName>
+  ): RealtimeTimer;
 }
 
 export {};

package/types/BetterGenshinImpact/Core/Script/Dependence/Model/SoloTask.d.ts

@@ -3,7 +3,6 @@ import type {
   HostType,
   ReferenceTypeTrait
 } from "../../../../../Microsoft/ClearScript/HostType";
-import "../../../../../Microsoft/ClearScript/ScriptObject";
 import "../../../../GameTask/Common/Job/CountInventoryItemParam";
 import "../../../../GameTask/Model/GameUI/GridScreenName";
 
@@ -109,6 +108,10 @@ export interface SoloTask extends ClrHostValue {
 declare global {
   namespace BetterGenshinImpact.Core.Script.Dependence.Model {
     type SoloTask = import("./SoloTask").SoloTask;
+    type SoloTaskConfigForName<TName extends SoloTaskName> =
+      import("./SoloTask").SoloTaskConfigForName<TName>;
+    type SoloTaskConfigMap = import("./SoloTask").SoloTaskConfigMap;
+    type SoloTaskName = import("./SoloTask").SoloTaskName;
   }
 }
 

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

@@ -6,6 +6,64 @@ import type {
 } from "../../../Microsoft/ClearScript/HostType";
 import "../../../System/ComponentModel/INotifyPropertyChanged";
 import "../../../System/ComponentModel/INotifyPropertyChanging";
+import type { CombatStrategyName } from "../AutoFight/AutoFightConfig";
+
+/**
+ * 自动首领讨伐支持的 Boss 名称
+ * 来源：上游 `AutoBossData.CountryToBosses` 扁平列表（启动时 `IsSupportedBoss` 校验）
+ * @since 0.62.0
+ */
+export type BossName =
+  // 蒙德
+  | "急冻树"
+  | "无相之雷"
+  | "守望者·堕天"
+  // 璃月
+  | "爆炎树"
+  | "纯水精灵"
+  | "古岩龙蜥"
+  | "无相之岩"
+  | "遗迹巨蛇"
+  | "隐山猊兽"
+  // 稻妻
+  | "无相之火"
+  | "恒常机关阵列"
+  | "雷音权现"
+  | "魔偶剑鬼"
+  | "无相之水"
+  // 须弥
+  | "掣电树"
+  | "半永恒统辖矩阵"
+  | "翠翎恐蕈"
+  | "风蚀沙虫"
+  | "无相之草"
+  | "深罪浸礼者"
+  | "兆载永劫龙兽"
+  // 枫丹
+  | "歌裴莉娅的葬送"
+  | "科培琉司的劫罚"
+  | "实验性场力发生装置"
+  | "魔像督军"
+  | "千年珍珠骏麟"
+  | "水形幻人"
+  | "铁甲熔火帝皇"
+  // 纳塔
+  | "金焰绒翼龙暴君"
+  | "灵觉隐修的迷者"
+  | "秘源机兵·构型械"
+  | "秘源机兵·统御械"
+  | "熔岩辉龙像"
+  | "深邃摹结株"
+  | "贪食匿叶龙山王"
+  // 挪德卡莱
+  | "蕴光月守宫"
+  | "深黯魇语之主"
+  | "超重型陆巡舰·机动战垒"
+  | "霜夜巡天灵主"
+  | "蕴光月幻蝶"
+  | "重拳出击鸭"
+  | "" // 未指定
+  | (string & {});
 
 /**
  * 自动首领讨伐的持久化配置，由独立任务页使用
@@ -24,6 +82,7 @@ export interface AutoBossConfig
       | "specifyRunCount"
       | "strategyName"
       | "teamName"
+      | "timeout"
       | "useFragileResin"
       | "useTransientResin"
     >,
@@ -31,10 +90,10 @@ export interface AutoBossConfig
     System.ComponentModel.INotifyPropertyChangingInput {
   readonly [autoBossConfigBrand]: true;
   /**
-   * 需要讨伐的 Boss 名称
+   * 需要讨伐的 Boss 名称；空字符串表示未指定，启动前须为受支持名单内名称
    * @since 0.62.0
    */
-  bossName: string;
+  bossName: BossName;
   /**
    * 每轮领奖后是否先返回七天神像，再重新前往 Boss
    * @since 0.62.0
@@ -50,6 +109,11 @@ export interface AutoBossConfig
    * @since 0.62.0
    */
   rewardRecognitionEnabled: boolean;
+  /**
+   * 战斗超时时长，单位秒，默认 240
+   * @since 0.63.0
+   */
+  timeout: number;
   /**
    * 指定模式下成功领取奖励的目标次数
    * @since 0.62.0
@@ -64,7 +128,7 @@ export interface AutoBossConfig
    * 战斗策略名称，`根据队伍自动选择` 表示按当前队伍匹配策略
    * @since 0.62.0
    */
-  strategyName: string;
+  strategyName: CombatStrategyName;
   /**
    * 讨伐前需要切换到的队伍名称，为空时保持当前队伍
    * @since 0.62.0
@@ -85,6 +149,7 @@ export interface AutoBossConfig
 declare global {
   namespace BetterGenshinImpact.GameTask.AutoBoss {
     type AutoBossConfig = import("./AutoBossConfig").AutoBossConfig;
+    type BossName = import("./AutoBossConfig").BossName;
   }
 }
 

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

@@ -4,7 +4,9 @@ import type {
   ReferenceTypeTrait
 } from "../../../Microsoft/ClearScript/HostType";
 import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
+import type { CombatStrategyName } from "../AutoFight/AutoFightConfig";
 import "../Model/BaseTaskParam";
+import type { BossName } from "./AutoBossConfig";
 import "./AutoBossConfig";
 import "./AutoBossTask";
 
@@ -27,20 +29,21 @@ export interface AutoBossParam extends Omit<
   | "specifyRunCount"
   | "strategyName"
   | "teamName"
+  | "timeout"
   | "useFragileResin"
   | "useTransientResin"
 > {
   readonly [autoBossParamBrand]: true;
   /**
-   * 需要讨伐的 Boss 名称
+   * 需要讨伐的 Boss 名称；空字符串表示未指定，启动前须为受支持名单内名称
    * @since 0.62.0
    */
-  bossName: string;
+  bossName: BossName;
   /**
    * 界面中选择的战斗策略名称；无自定义策略路径时会同步更新实际策略路径
    * @since 0.62.0
    */
-  strategyName: string;
+  strategyName: CombatStrategyName;
   /**
    * 实际用于解析自动战斗脚本的路径，脚本可直接设置该路径以覆盖界面选择
    * @since 0.62.0
@@ -86,6 +89,11 @@ export interface AutoBossParam extends Omit<
    * @since 0.62.0
    */
   rewardRecognitionEnabled: boolean;
+  /**
+   * 战斗超时时长，单位秒，默认 240
+   * @since 0.63.0
+   */
+  timeout: number;
   /**
    * 从当前全局自动首领讨伐配置填充默认参数
    * @returns ClearScript 宿主空结果
@@ -106,7 +114,7 @@ export interface AutoBossParam extends Omit<
    * @since 0.62.0
    */
   setCombatStrategyPath(): VoidResult;
-  setCombatStrategyPath(strategyName: string | null): VoidResult;
+  setCombatStrategyPath(strategyName: CombatStrategyName | null): VoidResult;
 }
 
 declare global {

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

@@ -7,7 +7,9 @@ import type {
 } from "../../../Microsoft/ClearScript/HostType";
 import type { VoidResult } from "../../../Microsoft/ClearScript/VoidResult";
 import "../../../System/Collections/Generic/List";
+import type { CombatStrategyName } from "../AutoFight/AutoFightConfig";
 import "../Model/BaseTaskParam";
+import type { ArtifactStar, DomainName, ResinName, SundaySelectedValue } from "./AutoDomainTask";
 import "./AutoDomainTask";
 
 /**
@@ -54,15 +56,15 @@ export interface AutoDomainParam extends Omit<
    */
   partyName: string;
   /**
-   * 需要刷取的秘境名称
+   * 需要刷取的秘境名称；空字符串表示未指定
    * @since 0.52.0
    */
-  domainName: string;
+  domainName: DomainName;
   /**
-   * 周日秘境奖励选项
+   * 周日 / 限时全开秘境奖励选项序号；空字符串表示不指定
    * @since 0.52.0
    */
-  sundaySelectedValue: string;
+  sundaySelectedValue: SundaySelectedValue;
   /**
    * 是否在结束后自动分解圣遗物
    * @since 0.52.0
@@ -72,7 +74,7 @@ export interface AutoDomainParam extends Omit<
    * 分解圣遗物的最大星级，取值 1–4，默认 `4`
    * @since 0.52.0
    */
-  maxArtifactStar: string;
+  maxArtifactStar: ArtifactStar;
   /**
    * 是否启用指定树脂使用次数模式
    * @since 0.52.0
@@ -82,7 +84,7 @@ export interface AutoDomainParam extends Omit<
    * 使用树脂的优先级列表，默认浓缩树脂优先于原粹树脂
    * @since 0.52.0
    */
-  resinPriorityList: System.Collections.Generic.List<string>;
+  resinPriorityList: System.Collections.Generic.List<ResinName>;
   /**
    * 使用原粹树脂刷取副本的次数
    * @since 0.52.0
@@ -131,15 +133,15 @@ export interface AutoDomainParam extends Omit<
    * @since 0.52.0
    */
   setCombatStrategyPath(): string;
-  setCombatStrategyPath(strategyName: string | null): string;
+  setCombatStrategyPath(strategyName: CombatStrategyName | null): string;
   /**
    * 设置使用树脂的优先级列表
    * @param priorities 树脂名称数组，顺序即优先级
    * @returns ClearScript 宿主空结果
    * @since 0.52.0
    */
-  setResinPriorityList(priorities: HostArray<string>): VoidResult;
-  setResinPriorityList(...priorities: string[]): VoidResult;
+  setResinPriorityList(priorities: HostArray<ResinName>): VoidResult;
+  setResinPriorityList(...priorities: ResinName[]): VoidResult;
 }
 
 declare global {