hrbattle 0.1.0

package/README.md

@@ -0,0 +1,103 @@
+# 勇者再就业战斗系统（hrbattle）
+
+## 项目简介
+这是《勇者再就业》的核心战斗系统项目。  
+战斗采用回合制框架，并结合“走条”机制驱动行动顺序，整体体验参考阴阳师式速度条战斗：  
+- 角色并非严格按固定回合轮流出手  
+- 行动顺序由速度与行动条推进共同决定  
+- 战斗节奏可通过技能、增益、减益进行动态干预
+
+## 战斗机制概览
+### 1) 走条与行动顺序
+- 每个单位拥有独立行动条进度
+- 行动条随时间推进，推进速度与单位速度属性相关
+- 当行动条达到阈值后，单位获得行动权
+- 行动结束后清空或回退行动条，并重新进入推进循环
+
+### 2) 回合与单位行动
+- 系统层面以“单位行动”为最小回合单位
+- 单位行动通常包含：选择技能 → 目标判定 → 结算伤害/治疗/状态 → 触发被动
+- 支持普通攻击、主动技能、被动技能、连击、反击等战斗行为扩展
+
+### 3) 状态与效果系统
+- 支持增益、减益、控制、护盾、持续伤害、持续治疗等常见效果
+- 支持按时机触发：行动前、受击时、行动后、回合结束时
+- 支持持续回合数与叠层管理
+
+### 4) 胜负判定
+- 一方全灭判负
+- 支持拓展特殊条件：回合上限、守护目标存活、指定单位击杀等
+
+## 设计目标
+- 高可扩展：便于新增角色、技能、效果类型
+- 高可配置：尽量通过配置驱动战斗内容，而非硬编码
+- 易调试：关键流程可追踪、可回放、可复现
+- 易平衡：参数结构清晰，方便数值迭代
+
+## 推荐模块划分
+- `BattleCore`：战斗主循环与状态机
+- `TurnBarSystem`：行动条推进与行动权分配
+- `TurnBarSystem`：行动条推进与行动权分配
+- `SkillSystem`：技能释放流程与目标选择
+- `EffectSystem`：Buff/Debuff 生命周期与触发
+- `DamageSystem`：伤害、治疗、护盾等数值结算
+- `VictorySystem`：胜负条件判定与战斗结束流程
+- `BattleLogger`：战斗日志、事件流、回放数据输出
+
+## 开发建议
+### 配置驱动
+- 角色基础属性、技能参数、效果模板建议数据化
+- 战斗逻辑与表现层解耦，便于前后端或客户端模块协作
+
+### 测试与验证
+- 为关键流程建立最小可复现战斗样例
+- 覆盖关键场景：先手争夺、控制链、反击链、DOT 结算、死亡触发
+- 用固定随机种子验证战斗可复现性
+
+## 快速开始
+当前仓库为战斗系统项目骨架，后续可按以下步骤完善：
+1. 定义角色属性与战斗单位数据结构
+2. 实现行动条推进与行动权分配
+3. 接入技能与效果结算流程
+4. 完成胜负判定与战斗日志输出
+5. 建立自动化测试与关键战斗样例
+
+## 技能模板逐级数值配置
+- 支持在模板 step 上按等级配置独立数值：
+  - `ratioByLevel: number[]`
+  - `flatByLevel: number[]`
+  - `fixedProbByLevel: number[]`
+- 优先级：`*ByLevel` 高于单值字段（`ratio`、`flat`、`fixedProb`）。
+- 等级越界策略：当技能等级超过数组长度时，使用最后一个数组值。
+
+```json
+{
+  "id": "example.skill",
+  "steps": [
+    {
+      "kind": "damage",
+      "ratio": 0.5,
+      "ratioByLevel": [0.5, 0.62, 0.74, 0.86, 0.98],
+      "scaleStat": "Att"
+    },
+    {
+      "kind": "buff",
+      "ratio": 0,
+      "buffId": "slow",
+      "fixedProb": 6000,
+      "fixedProbByLevel": [6000, 7000, 8000, 9000, 10000]
+    }
+  ]
+}
+```
+
+## 贡献指南
+1. Fork 本仓库
+2. 新建分支（例如 `feature/turn-bar`）
+3. 提交改动并补充必要说明
+4. 发起 Pull Request
+
+## 版本规划建议
+- `v0.1`：最小可运行战斗闭环（走条 + 普攻 + 胜负判定）
+- `v0.2`：技能系统与常规状态效果
+- `v0.3`：复杂触发链、日志回放与测试体系完善

package/dist/battle/battleCore.d.ts

@@ -0,0 +1,83 @@
+import { BattleEventBus } from "./eventBus";
+import { EffectSystem } from "./effectSystem";
+import { BattleLogger } from "./logger";
+import { ConfigSkillEngine, ScriptSkillEngine } from "./skillEngine";
+import type { BattleConfig, BattleInitUnit, ISkillScript, SkillDefinition, TriggerContext, UnitId, UnitModel } from "./types";
+export interface BattleResult {
+    winner: 1 | 2 | 0;
+    totalTurns: number;
+    logs: BattleLogger;
+}
+type ChasePredicate = (ctx: TriggerContext, actor: UnitModel) => boolean;
+type ChaseSkillResolver = (actor: UnitModel) => SkillDefinition | undefined;
+export declare class BattleCore {
+    private readonly initUnits;
+    private readonly config;
+    private readonly units;
+    private readonly rng;
+    private readonly eventBus;
+    private readonly turnBar;
+    private readonly logger;
+    private readonly effectSystem;
+    private readonly configSkillEngine;
+    private readonly scriptSkillEngine;
+    private readonly skillExecutor;
+    private readonly skillSlots;
+    private readonly chasePredicates;
+    private readonly chaseSkillResolvers;
+    private readonly pendingImbalanceClear;
+    private readonly pendingReactiveCounters;
+    private scriptPassivesInitialized;
+    private activeSkillContext;
+    private turn;
+    private actionCount;
+    constructor(initUnits: BattleInitUnit[], config: BattleConfig);
+    getEventBus(): BattleEventBus;
+    getLogger(): BattleLogger;
+    getEffectSystem(): EffectSystem;
+    getConfigSkillEngine(): ConfigSkillEngine;
+    getScriptSkillEngine(): ScriptSkillEngine;
+    getUnitById(unitId: UnitId): UnitModel | undefined;
+    addBuffToUnit(sourceId: UnitId, targetId: UnitId, buffId: string): void;
+    /** 动态召唤一个新单位加入战斗 */
+    spawnUnit(initUnit: BattleInitUnit): UnitModel | null;
+    /** 延长目标单位所有主动技能的冷却回合数 */
+    extendCooldown(unitId: UnitId, delta: number): void;
+    /** 击杀指定单位 */
+    killUnit(unitId: UnitId): void;
+    grantActionProgress(unitId: UnitId, ratio: number): void;
+    registerSkillScript(scriptId: string, script: ISkillScript): void;
+    registerChase(predicate: ChasePredicate, resolver: ChaseSkillResolver): void;
+    private registerReactiveCounterRules;
+    private processPendingReactiveCounters;
+    private consumeBuffStack;
+    private registerConfiguredChaseRules;
+    run(): BattleResult;
+    private initializeScriptPassives;
+    private performAction;
+    private canCast;
+    private executeSkill;
+    private tryChaseAndAssist;
+    private applyDamage;
+    private applyHeal;
+    private applyShield;
+    private applyImbalanceDelta;
+    private computeImbalanceMax;
+    private accumulateStagger;
+    private onImbalanceBreak;
+    private applyBuff;
+    private applyTurnStart;
+    private applyTurnEnd;
+    private gainEnergy;
+    private gainEnergyToUnit;
+    private decrementAllCooldowns;
+    private getSlots;
+    private rearrangePositions;
+    private winner;
+    private resolveWinnerByRule;
+    private hpRatio;
+    private mustUnit;
+    private maxUltimateCost;
+    private snapshotBuffs;
+}
+export {};