@bettergi/types 0.1.15 → 0.1.16

package/bindings/RealtimeTimer.d.ts

@@ -1,4 +1,4 @@
-import type { RealtimeTimerHostType } from "../types/BetterGenshinImpact/Core/Script/Dependence/Model/RealTimeTimer";
+import type { RealtimeTimerHostType } from "../types/BetterGenshinImpact/Core/Script/Dependence/Model/RealtimeTimer";
 
 declare global {
   /**

package/bindings/getAvatars.d.ts

@@ -1,8 +1,9 @@
+import type { AvatarName } from "../types/BetterGenshinImpact/GameTask/AutoFight/Model/Avatar";
 import type { HostArray, HostDelegate } from "../types/Microsoft/ClearScript/HostType";
 
 interface getAvatarsHostDelegate extends HostDelegate {
-  (): HostArray<string>;
-  invoke(): HostArray<string>;
+  (): HostArray<AvatarName>;
+  invoke(): HostArray<AvatarName>;
 }
 
 declare global {

package/package.json

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

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

@@ -6,14 +6,20 @@ import type {
   StrongNumeric
 } from "../../../Microsoft/ClearScript/HostType";
 import "../../../OpenCvSharp/Rect";
-import "../../../System/Action";
 import "../../../System/Collections/Generic/List";
-import "../../../System/Func";
 import "../../../System/Nullable";
 import "../../../System/Threading/CancellationToken";
 import "../../GameTask/Model/Area/Region";
 import "../Recognition/RecognitionObject";
 
+/**
+ * 重试前回调：收到当前匹配区域列表；可为同步或返回 Promise 的异步脚本函数
+ * @since 0.61.0
+ */
+export type BvLocatorRetryAction = (
+  regions: System.Collections.Generic.List<BetterGenshinImpact.GameTask.Model.Area.Region>
+) => void | Promise<void>;
+
 /**
  * BgiVision 定位器，按识别配置查找并操作匹配区域
  * @since 0.57.0
@@ -27,13 +33,10 @@ export interface BvLocator extends ClrHostValue {
    */
   readonly recognitionObject: BetterGenshinImpact.Core.Recognition.RecognitionObject;
   /**
-   * 每次重试前执行的回调
+   * 每次重试前执行的回调；脚本侧可直接赋函数，`null` 清除
    * @since 0.57.0
    */
-  retryAction: System.Func<
-    System.Collections.Generic.List<BetterGenshinImpact.GameTask.Model.Area.Region>,
-    Promise<void>
-  >;
+  retryAction: BvLocatorRetryAction | null;
   /**
    * 按当前识别配置查找全部匹配区域；不建议脚本直接调用
    * @returns 匹配到的区域列表
@@ -118,12 +121,12 @@ export interface BvLocator extends ClrHostValue {
   tryWaitForDisappear(timeout: number | StrongNumeric<Int32Host> | null | null): Promise<void>;
   /**
    * 设置感兴趣区域（ROI），覆盖识别配置中的 RegionOfInterest
-   * @param deltaFunc 由当前最大 1080P 捕获矩形计算 ROI 的回调
+   * @param deltaFunc 由当前最大 1080P 捕获矩形计算 ROI 的脚本回调
    * @returns 当前定位器，便于链式调用
    * @since 0.57.0
    */
   withRoi(
-    deltaFunc: System.Func<OpenCvSharp.Rect, OpenCvSharp.Rect>
+    deltaFunc: (captureRect: OpenCvSharp.Rect) => OpenCvSharp.Rect
   ): BetterGenshinImpact.Core.BgiVision.BvLocator;
   /**
    * 设置感兴趣区域（ROI），覆盖识别配置中的 RegionOfInterest
@@ -151,28 +154,20 @@ export interface BvLocator extends ClrHostValue {
     retryInterval: number | StrongNumeric<Int32Host>
   ): BetterGenshinImpact.Core.BgiVision.BvLocator;
   /**
-   * 设置每次重试前执行的回调；支持同步与异步脚本函数
-   * @param action 收到当前匹配区域列表时调用的回调；传入 null 清除回调
+   * 设置每次重试前执行的回调；支持同步与异步脚本函数（对应上游 `Action` 与 `dynamic` 重载）
+   * @param action 收到当前匹配区域列表时调用的脚本回调；传入 null 清除回调
    * @returns 当前定位器，便于链式调用
    * @since 0.61.0
    */
   withRetryAction(
-    action: System.Action<
-      System.Collections.Generic.List<BetterGenshinImpact.GameTask.Model.Area.Region>
-    > | null
+    action: BvLocatorRetryAction | null
   ): BetterGenshinImpact.Core.BgiVision.BvLocator;
-  /**
-   * 设置每次重试前执行的回调；供脚本传入无法隐式转为 Action 的函数
-   * @param action 脚本回调；可为同步函数或返回 Promise 的异步函数
-   * @returns 当前定位器，便于链式调用
-   * @since 0.61.0
-   */
-  withRetryAction(action: unknown): BetterGenshinImpact.Core.BgiVision.BvLocator;
 }
 
 declare global {
   namespace BetterGenshinImpact.Core.BgiVision {
     type BvLocator = import("./BvLocator").BvLocator;
+    type BvLocatorRetryAction = import("./BvLocator").BvLocatorRetryAction;
   }
 }
 

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";
 
 /**
@@ -135,10 +136,10 @@ export interface Dispatcher extends ClrHostValue {
    * @since unreleased
    */
   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,
@@ -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
    */
   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 宿主空结果
@@ -361,7 +372,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 & {});
 
 /**
  * 自动首领讨伐的持久化配置，由独立任务页使用
@@ -31,10 +89,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
@@ -64,7 +122,7 @@ export interface AutoBossConfig
    * 战斗策略名称，`根据队伍自动选择` 表示按当前队伍匹配策略
    * @since 0.62.0
    */
-  strategyName: string;
+  strategyName: CombatStrategyName;
   /**
    * 讨伐前需要切换到的队伍名称，为空时保持当前队伍
    * @since 0.62.0
@@ -85,6 +143,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";
 
@@ -32,15 +34,15 @@ export interface AutoBossParam extends Omit<
 > {
   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
@@ -106,7 +108,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 {

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

@@ -19,6 +19,63 @@ import "./AutoDomainParam";
 export type ResinName =
   "浓缩树脂" | "原粹树脂" | "原粹树脂20" | "原粹树脂40" | "须臾树脂" | "脆弱树脂" | (string & {});
 
+/**
+ * 分解圣遗物最大星级（字符串）；上游 `int.TryParse` 后按 1–4 使用
+ * @since 0.52.0
+ */
+export type ArtifactStar = "1" | "2" | "3" | "4" | (string & {});
+
+/**
+ * 可自动刷取的秘境名称
+ * 来源：`MapLazyAssets` 从 `tp.json` 提取的 BlessDomain / ForgeryDomain / MasteryDomain 点位名
+ * @since 0.52.0
+ */
+export type DomainName =
+  | "铭记之谷"
+  | "忘却之峡"
+  | "仲夏庭园"
+  | "塞西莉亚苗圃"
+  | "无妄引咎密宫"
+  | "太山府"
+  | "震雷连山密宫"
+  | "孤云凌霄之处"
+  | "华池岩岫"
+  | "芬德尼尔之顶"
+  | "山脊守望"
+  | "菫色之庭"
+  | "椛染之庭"
+  | "砂流之庭"
+  | "沉眠之庭"
+  | "昏识塔"
+  | "缘觉塔"
+  | "有顶塔"
+  | "岩中幽谷"
+  | "赤金的城墟"
+  | "熔铁的孤塞"
+  | "深潮的余响"
+  | "苍白的遗荣"
+  | "罪祸的终末"
+  | "临瀑之城"
+  | "褪色的剧场"
+  | "蕴火的幽墟"
+  | "深古瞭望所"
+  | "虹灵的净土"
+  | "荒废砌造坞"
+  | "无光的深都"
+  | "霜凝的机枢"
+  | "失落的月庭"
+  | "月童的库藏"
+  | "山风的荆冕"
+  | "" // 未指定
+  | (string & {});
+
+/**
+ * 周日 / 限时全开秘境奖励选项序号
+ * UI 列表为 `""` / `1` / `2` / `3`；任务内 `switch` 仅处理 1–3
+ * @since 0.52.0
+ */
+export type SundaySelectedValue = "" | "1" | "2" | "3" | (string & {});
+
 /**
  * 自动秘境独立任务
  * @since 0.52.0
@@ -51,6 +108,10 @@ export interface AutoDomainTask
 declare global {
   namespace BetterGenshinImpact.GameTask.AutoDomain {
     type AutoDomainTask = import("./AutoDomainTask").AutoDomainTask;
+    type ArtifactStar = import("./AutoDomainTask").ArtifactStar;
+    type DomainName = import("./AutoDomainTask").DomainName;
+    type ResinName = import("./AutoDomainTask").ResinName;
+    type SundaySelectedValue = import("./AutoDomainTask").SundaySelectedValue;
   }
 }