Initial import of BardFrontline

REFERENCES.md

@@ -0,0 +1,26 @@
+# 实现参考
+
+独立实现，未链接或随包分发 RSR / Dalamud / FFXIVClientStructs 程序集。
+
+本地 RotationSolverReborn 参考点：
+
+- `RotationSolver/RebornRotations/PVPRotations/Ranged/BRD_Default.PVP.cs`：诗人技能优先级。
+- `RotationSolver.Basic/Rotations/Basic/BardRotation.cs`：技能状态要求和 PVP 技能设置。
+- `RotationSolver.Basic/Rotations/CustomRotation_Actions.cs`：共通技能、职能技能、复活保护与补给条件。
+- `RotationSolver.Basic/Helpers/StatusHelper.cs`：控制列表及无敌状态图标判断。
+- `RotationSolver.Basic/Actions/ActionTargetInfo.cs`、`Helpers/TargetHelper.cs`：目标排序、Guard 过滤与原生目标检查。
+- `RotationSolver.SourceGenerators/Properties/ActionId.resx`、`Status.resx`、`Rotation.resx`：技能/状态 ID 和变换说明。
+
+当前工作区内的 Dalamud、FFXIVClientStructs 和 Lumina.Excel schema 仅用于查阅接口与数据字段。实际编译引用用户提供的 Hooks/dev 成品 DLL，引用设为 `Private=false`。
+
+技能说明的公开参考：[官方吟游诗人 PVP 指南](https://na.finalfantasyxiv.com/jobguide/bard/#pvp)。本插件使用本地 RSR 优先级和客户端实际可用性，不以网页版本号作运行门禁。
+
+与 RSR 优先级的有意差异：鹰眼增加可配置收割优先分支且只对普通玩家使用；玩家优先、无可用玩家攻击时回退到战场目标；优先消耗即将过期的攻击状态；安可优先于普通输出且不受额外穿插预留限制；自身生存高于队友解控；安全补给读条保护；单请求确认与失败退避；只在纷争前线和烈羽争锋运行，驾驶机甲时暂停。
+
+和弦箭允许的客户端变体 41464 / 41465 / 41466 / 41964 均来自本地 `ActionId.resx` 的 Harmonic Arrow PVP 条目；不会仅凭技能名字接受任意 ID。
+
+烈羽争锋参考：本地 FFXIVClientStructs `TerritoryIntendedUse.RivalWings = 39`、`PlayerState.GetContentValue(1)`（ManeuversArmor）、本地 RSR `Mounted = 1420` 状态条目；模式和单位机制参照[官方烈羽争锋指南](https://actff1.web.sdo.com/project/160810event/page5_2.html)。
+
+0.2.0 目标分类参考本地 `BNpcName.resx`：6857–6862 核心 / 防御塔，6863–6868 机甲，6869–6872、7889–7890、14252–14253 兵线，7891–7892、7906 佣兵；4822–4837、4840–4845 冰块。未知 ID 不按显示名猜测，归入其他。
+
+范围估算使用客户端 `Action.EffectRange` / `XAxisModifier` 和演员位置 / 碰撞半径，直线宽度计算参考 RSR `ActionTargetInfo.cs`。稳定选敌、爆发保留、集火阈值和自适应预算是本插件的可配置策略，不宣称为游戏的精确伤害或命中预测。