feat: GeneralAI 디버그 상태 추가 및 예약 턴 핸들러에 AI 상태 전달 기능 구현

2026-01-24 10:57:30 +00:00
parent 9b867e99a4
commit 9c8f901f7b
3 changed files with 76 additions and 18 deletions
@@ -141,6 +141,28 @@ export interface GeneralAIOptions {
    nationFallback: GeneralActionDefinition;
 }

+export type GeneralAiDebugState = {
+    generalId: number;
+    nationId: number | null;
+    cityId: number | null;
+    yearMonth: number;
+    startYear: number;
+    startYearMonth: number;
+    dipState: number;
+    attackable: boolean;
+    warTargetNation: Record<number, number>;
+    genType: number;
+    lastAttackable: number;
+    frontCities: Array<{ id: number; frontState: number; supplyState: number }>;
+    supplyCities: Array<{ id: number; frontState: number; supplyState: number }>;
+    policy: {
+        minAvailableRecruitPop: number;
+        minNpcWarLeadership: number;
+        minWarCrew: number;
+        cureThreshold: number;
+    };
+};
+
 export class GeneralAI {
    public readonly general: TurnGeneral;
    public readonly city?: City;
@@ -423,6 +445,45 @@ export class GeneralAI {
        return neutral ?? this.buildGeneralCandidate(ACTION_REST, {}, 'neutral');
    }

+    getDebugState(): GeneralAiDebugState {
+        this.updateInstance();
+        this.categorizeNationCities();
+        const yearMonth = joinYearMonth(this.world.currentYear, this.world.currentMonth);
+        const startYearMonth = joinYearMonth(this.startYear + 2, 5);
+        const meta = asRecord(this.nation?.meta ?? {});
+        const lastAttackable = readMetaNumber(meta, 'last_attackable', 0);
+
+        return {
+            generalId: this.general.id,
+            nationId: this.nation?.id ?? null,
+            cityId: this.city?.id ?? null,
+            yearMonth,
+            startYear: this.startYear,
+            startYearMonth,
+            dipState: this.dipState,
+            attackable: this.attackable,
+            warTargetNation: { ...this.warTargetNation },
+            genType: this.genType,
+            lastAttackable,
+            frontCities: Object.values(this.frontCities).map((city) => ({
+                id: city.id,
+                frontState: city.frontState,
+                supplyState: city.supplyState,
+            })),
+            supplyCities: Object.values(this.supplyCities).map((city) => ({
+                id: city.id,
+                frontState: city.frontState,
+                supplyState: city.supplyState,
+            })),
+            policy: {
+                minAvailableRecruitPop: this.aiConst.minAvailableRecruitPop,
+                minNpcWarLeadership: this.nationPolicy.minNpcWarLeadership,
+                minWarCrew: this.nationPolicy.minWarCrew,
+                cureThreshold: this.nationPolicy.cureThreshold,
+            },
+        };
+    }
+
    buildGeneralCandidate(action: string, args: Record<string, unknown>, reason: string): AiCommandCandidate | null {
        return this.buildCandidate(this.generalDefinitions, this.generalFallback, action, args, reason);
    }