# 落地交付文档：天巫集群掠食 - 空投拦截系统

## 1. 目标与结论
- 目标：实现“敌方空投袭击可被天巫种拦截”的完整闭环（开关控制、拦截逻辑、视觉反馈、通知、持久化）。
- 结论：核心功能已完成并通过编译，已具备交由 planer 进行方案审阅与验收测试的条件。

## 2. 实现范围（按 plan.md 对齐）

### 2.1 GameComponent 全局状态与拦截逻辑
- 新增文件：`Source/ArachnaeSwarm/Flyover/GameComponent_DropPodInterceptor.cs`
- 已实现：
  - `bool interceptEnabled` 持久化（`ExposeData` + `Scribe_Values.Look`）。
  - `ToggleIntercept()` 开关切换与日志。
  - `HasAirborneTianwu()` 检查 `WorldComponent_AircraftManager.GetAvailableAircraftCount(...) > 0`。
  - `TryInterceptDropPods(...)`：
    - 前置检查：开关、敌对派系、可用天巫、至少保留 1 名袭击者。
    - 随机拦截 1-3 名（上限由 `pawns.Count - 1` 约束）。
    - 拦截对象执行 `Pawn.Kill(DamageInfo)`，收集 `Corpse`。
    - 用 `DropPodUtility.DropThingsNear(...)` 以空投仓形式落尸。
    - 触发 FlyOver（复用 `ARA_HiveCorvette_Fake`）与信件通知。

### 2.2 Harmony 补丁
- 新增文件：`Source/ArachnaeSwarm/HarmonyPatches/Patch_DropPodIntercept.cs`
- 已实现：
  - Prefix 挂钩：
    - `PawnsArrivalModeWorker_EdgeDrop.Arrive`
    - `PawnsArrivalModeWorker_CenterDrop.Arrive`
  - 两个入口共用 `InterceptPrefix(...)`。
  - **不跳过原方法**（`return true`），原方法继续处理剩余 `pawns`。

### 2.3 引航种能力（开关）
- 新增文件：`Source/ArachnaeSwarm/Abilities/CompAbilityEffect_ToggleDropPodIntercept.cs`
- 已实现：
  - `CompProperties_ToggleDropPodIntercept`
  - `CompAbilityEffect_ToggleDropPodIntercept`
    - `Apply`：切换全局开关 + 消息提示。
    - `Valid`：无可用天巫时拒绝施放并提示。
    - `ExtraLabelMouseAttachment`：显示“开启/关闭”状态文本。

### 2.4 Ability Def
- 新增文件：`1.6/1.6/Defs/AbilityDefs/Ability_DropPodIntercept.xml`
- 已实现：
  - 新能力 `ARA_ToggleDropPodIntercept`
  - 自施放、`targetRequired=false`、`targetable=false`、无冷却切换。

### 2.5 挂载到 Skyraider
- 修改文件：`1.6/1.6/Defs/PawnKindDef/ARA_PawnKinds.xml`
- 已实现：
  - 在 `ArachnaeNode_Race_Skyraider` 的 `abilities` 中追加：`ARA_ToggleDropPodIntercept`

### 2.6 本地化
- 修改文件：`1.6/1.6/Languages/ChineseSimplified (简体中文)/Keyed/AirStrike_Keys.xml`
- 已实现 key：
  - `ARA_ToggleDropPodIntercept_Label`
  - `ARA_ToggleDropPodIntercept_Desc`
  - `ARA_InterceptDropPod_Enabled`
  - `ARA_InterceptDropPod_Disabled`
  - `ARA_InterceptDropPod_NoAircraft`
  - `ARA_InterceptDropPod_Status`
  - `ARA_InterceptDropPod_StatusOn`
  - `ARA_InterceptDropPod_StatusOff`
  - `ARA_InterceptDropPod_LetterLabel`
  - `ARA_InterceptDropPod_LetterText`

### 2.7 工程文件同步
- 修改文件：`Source/ArachnaeSwarm/ArachnaeSwarm.csproj`
- 已实现：新增 3 个 C# 文件的 `<Compile Include="..." />`。

## 3. 与 plan.md 的差异说明（供 planer 决策）
- FlyOver Def：按 plan 的“优先复用”策略，当前复用 `ARA_HiveCorvette_Fake`，**未新增** `ARA_HiveCorvette_Intercept` ThingDef。
- `CompAbilityEffect_ToggleDropPodIntercept.Valid` 使用单目标签名（与现项目其他 Ability 风格一致），未采用数组签名版本。
- 能力 label/description 当前写在 AbilityDef 内，key 已补全；若需严格 DefInjected 化，可由 planer 决定是否二次整理。

## 4. 构建与验证
- 构建命令（已执行）：
  - `MSBuild ArachnaeSwarm.csproj -p:Configuration=Release -verbosity:minimal`
- 结果：通过。
- 输出：
  - `1.6/1.6/Assemblies/ArachnaeSwarm.dll`
  - `1.6/1.6/Assemblies/ArachnaeSwarm.pdb`

## 5. 建议的审阅清单（给 planer）
- 逻辑正确性：
  - 是否接受“至少保留 1 名袭击者”的平衡策略。
  - 是否接受“仅敌对派系 + EdgeDrop/CenterDrop 生效”的作用域。
- 体验反馈：
  - FlyOver 速度、出现时机、信件文案是否符合预期。
- 兼容性：
  - 与其他修改袭击到场逻辑的 Harmony 补丁是否可能冲突。
- 本地化策略：
  - 是否要求将 AbilityDef `label/description` 进一步改为 DefInjected。

## 6. 建议测试用例（未在本轮自动化执行）
- Dev 触发 `Raid (EdgeDrop)`：验证拦截 1-3，尸体空投、FlyOver、信件。
- Dev 触发 `Raid (CenterDrop)`：同上。
- 关闭拦截后再触发空投：验证不拦截。
- 触发 `EdgeWalkIn`：验证不拦截。
- 触发友军空投：验证不拦截。
- 存档/读档：验证 `interceptEnabled` 状态持久化。

## 7. 当前改动文件清单
- `Source/ArachnaeSwarm/Flyover/GameComponent_DropPodInterceptor.cs`（新增）
- `Source/ArachnaeSwarm/HarmonyPatches/Patch_DropPodIntercept.cs`（新增）
- `Source/ArachnaeSwarm/Abilities/CompAbilityEffect_ToggleDropPodIntercept.cs`（新增）
- `1.6/1.6/Defs/AbilityDefs/Ability_DropPodIntercept.xml`（新增）
- `1.6/1.6/Defs/PawnKindDef/ARA_PawnKinds.xml`（修改）
- `1.6/1.6/Languages/ChineseSimplified (简体中文)/Keyed/AirStrike_Keys.xml`（修改）
- `Source/ArachnaeSwarm/ArachnaeSwarm.csproj`（修改）

---

如需我继续，可下一步直接输出“planer审阅意见处理版”补丁（按审阅结论二改）。