@playcraft/skills 0.0.2

package/skills/knife_hit.aigameplay/SKILL.md

@@ -0,0 +1,103 @@
+---
+name: knife_hit.aigameplay
+description: 飞刀投掷核心玩法封包 - 旋转木桩、飞刀碰撞检测、苹果收集的 PGS 实现
+triggers: 飞刀,knife,刀,投掷,throw,旋转,rotation,碰撞,collision,木桩,target,苹果,apple,timing,计时
+---
+
+# knife_hit.aigameplay
+
+飞刀投掷核心玩法封包。实现飞刀投掷玩法的 PGS (PlayCraft Gameplay Schema, 玩法定义规范) JSON 和 reducer。旋转的圆形木桩/水果不断旋转，玩家点击投出飞刀，需避开已插入的刀，碰撞则游戏结束。收集苹果可额外得分，投完指定数量飞刀则过关。
+
+## Recipe
+
+- **玩法类型**：knife_hit（飞刀投掷）
+- **参考文件**：
+  - `ref/pgs-schema.json`：PGS 规则骨架（entities、rules、algorithm、testCases）
+  - `ref/reducer.template.ts`：reducer 接口约束模板
+- **核心规则**：
+  - `minSeparationAngle`: 15（已插入飞刀之间最小角度差，度数）
+  - `baseRotationSpeed`: 90（基础旋转速度，度/秒）
+  - `appleBonusScore`: 50（苹果额外分数）
+  - `knifeScorePerHit`: 10（每刀成功插入得分）
+- **PGS Agent 操作流程**：
+  1. 读取 `ref/pgs-schema.json` 作为规则骨架起点
+  2. 读取 `ref/reducer.template.ts` 了解接口约束
+  3. 实现 `reducer.ts`，导出 `init(config)`、`dispatch(state, action)`、`getState(state)` 以及**全部分步函数**
+  4. 碰撞检测：新飞刀插入角度与所有已插入飞刀角度的最小差 < `minSeparationAngle` → 碰撞
+  5. 苹果检测：新飞刀插入角度与苹果位置角度差 < 苹果半径角度 → 收集苹果
+  6. 运行 `ref/pgs-schema.json` 中的所有 `testCases`，全部通过后才算完成
+- **旋转方向**：`clockwise`（顺时针）或 `counter_clockwise`（逆时针），部分关卡会反向旋转
+- **角度归一化**：所有角度统一用 `[0, 360)` 度表示，差值取最小角（`min(|a-b|, 360-|a-b|)`）
+- **可 fork 变体**：
+  - 多层木桩：同时有多个不同旋转速度的圆形目标
+  - 爆炸刀：特殊飞刀命中后爆炸，清除周围已插入的刀
+  - Boss 阶段：部分关卡木桩不规则运动
+
+## Result
+
+- **产物文件**：`reducer.ts`
+- **格式**：TypeScript，导出 `init(config)`、`dispatch(action)`、`getState()` + 分步函数接口
+- **验证**：所有 testCases 必须通过
+
+## 渲染集成（⚠️ 场景层必读）
+
+### 设计原则：每帧更新旋转 + 点击时投刀
+
+```ts
+// ✅ 正确做法：每帧更新旋转
+function update(deltaMs: number) {
+  // Step 1: 更新木桩旋转角度（每帧调用）
+  state = updateRotation(state, deltaMs);
+  rotateSpriteGroup(state.target.currentAngle);  // 旋转木桩精灵组
+
+  // 玩家点击时：
+  if (playerTapped) {
+    // Step 2: 检测碰撞
+    const collision = checkCollision(state, state.target.currentAngle);
+    if (collision) {
+      await playCollisionAnimation();
+      dispatch(state, { type: 'game_over' });
+      return;
+    }
+
+    // Step 3: 飞刀飞行动画
+    await playKnifeThrowAnimation(state.target.currentAngle);
+
+    // Step 4: 投刀（可能收集苹果）
+    state = throwKnife(state);
+    if (state.lastAppleCollected) {
+      await playAppleCollectAnimation();
+    }
+
+    // Step 5: 检测过关
+    const levelResult = checkLevelComplete(state);
+    if (levelResult.complete) {
+      await playLevelCompleteAnimation();
+    }
+  }
+}
+```
+
+## Binding
+
+- **Binding Role**：`gameplayRule`
+- **挂载目标**：`game/gameplay/knife_hit/reducer.ts`
+- **引用类型**：`gameplay-module-reference`
+- **接口契约**：`init(config)` / `dispatch(action)` / `getState()` / `throwKnife()` / `checkCollision()` / `collectApple()` / `updateRotation()` / `checkLevelComplete()`
+
+## Skill Definition
+
+tools:
+  - bash
+  - write
+  - read
+prompt_extension: |
+  You are implementing a knife hit gameplay module following the PGS specification.
+  Write the PGS JSON with entities, rules, algorithm, and testCases.
+  Implement the reducer.ts with:
+    - init/dispatch/getState (一体化接口，用于测试)
+    - throwKnife/checkCollision/collectApple/updateRotation/checkLevelComplete (分步函数，用于渲染层)
+  Collision detection: angular distance between new knife and all existing knives < minSeparationAngle → collision.
+  Apple collection: knife hits within apple's angular radius → collect, remove apple, add bonus score.
+  Rotation: currentAngle += rotationSpeed * direction * (deltaMs/1000), normalized to [0, 360).
+  Run the testCases to verify the logic before finalizing.

package/skills/knife_hit.aigameplay/manifest.json

@@ -0,0 +1,151 @@
+{
+  "schemaVersion": 1,
+  "atomId": "knife_hit.aigameplay",
+  "bundleType": "aigameplay",
+  "category": "gameplay",
+  "mode": "fixed",
+  "label": {
+    "zh": "飞刀投掷玩法",
+    "en": "Knife hit gameplay"
+  },
+  "tags": [
+    "gameplay",
+    "knife",
+    "throw",
+    "rotation",
+    "timing",
+    "casual"
+  ],
+  "bindingRoles": [
+    "gameplayRule"
+  ],
+  "imports": [
+    {
+      "slot": "engine",
+      "pinAtomId": "phaser.aicomponent",
+      "edgeKind": "requires",
+      "bindAs": "engine"
+    },
+    {
+      "slot": "bgMusic",
+      "description": "背景循环音乐",
+      "bindAs": "bgm",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "bgMusic"
+      ],
+      "allowedBundleTypes": [
+        "aiaudio"
+      ],
+      "constraints": {
+        "loop": true
+      }
+    },
+    {
+      "slot": "background",
+      "description": "游戏背景图",
+      "bindAs": "bg",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "backgroundTexture"
+      ],
+      "allowedBundleTypes": [
+        "aiimage"
+      ]
+    },
+    {
+      "slot": "tutorial",
+      "description": "新手引导浮层",
+      "bindAs": "tutorial",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "tutorialOverlay"
+      ],
+      "allowedBundleTypes": [
+        "aicomponent"
+      ]
+    },
+    {
+      "slot": "winPanel",
+      "description": "通关反馈面板视觉",
+      "bindAs": "winPanel",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "successFeedbackPanel"
+      ],
+      "allowedBundleTypes": [
+        "aiimage"
+      ]
+    },
+    {
+      "slot": "losePanel",
+      "description": "失败反馈面板视觉",
+      "bindAs": "losePanel",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "failFeedbackPanel"
+      ],
+      "allowedBundleTypes": [
+        "aiimage"
+      ]
+    },
+    {
+      "slot": "endScreen",
+      "description": "可玩广告结算屏（含 CTA 按钮）",
+      "bindAs": "endScreen",
+      "required": false,
+      "edgeKind": "compatibleWith",
+      "matchBindingRoles": [
+        "playableEndScreenLayout"
+      ],
+      "allowedBundleTypes": [
+        "aicomponent"
+      ]
+    }
+  ],
+  "generation": {
+    "kind": "pgs",
+    "pgsVersion": "1.0",
+    "gameplayType": "knife_hit",
+    "rules": {
+      "minSeparationAngle": 15,
+      "baseRotationSpeed": 90,
+      "appleBonusScore": 50,
+      "knifeScorePerHit": 10
+    }
+  },
+  "result": {
+    "outputFile": "reducer.ts",
+    "format": "typescript",
+    "constraints": {
+      "testCasesMustPass": true
+    }
+  },
+  "binding": {
+    "role": "gameplayRule",
+    "target": "game/gameplay/knife_hit/reducer.ts",
+    "type": "gameplay-module-reference",
+    "constraints": {
+      "interface": [
+        "init(config)",
+        "dispatch(action)",
+        "getState()",
+        "throwKnife(state)",
+        "checkCollision(state, newAngle)",
+        "collectApple(state, angle)",
+        "updateRotation(state, deltaMs)",
+        "checkLevelComplete(state)"
+      ]
+    }
+  },
+  "files": {
+    "skill": "SKILL.md",
+    "pgsSchema": "ref/pgs-schema.json",
+    "reducerTemplate": "ref/reducer.template.ts"
+  }
+}

package/skills/knife_hit.aigameplay/ref/pgs-schema.json

@@ -0,0 +1,202 @@
+{
+  "_comment": "PGS (PlayCraft Gameplay Schema) 参考骨架 - 飞刀投掷玩法。Agent 以此为起点编写或 fork 玩法规则。",
+  "version": "1.0",
+  "gameplayType": "knife_hit",
+  "entities": {
+    "target": {
+      "type": "rotating-object",
+      "description": "旋转的圆形木桩/水果，飞刀插入其中",
+      "fields": {
+        "radius":             { "type": "number",  "value": 120, "description": "木桩半径（像素）" },
+        "rotation_speed":     { "type": "number",  "description": "当前旋转速度（度/秒），正=顺时针，负=逆时针" },
+        "rotation_direction": { "type": "number",  "values": [1, -1], "description": "1=顺时针，-1=逆时针" },
+        "current_angle":      { "type": "number",  "range": [0, 360], "description": "当前旋转角度（度）" },
+        "inserted_knives":    { "type": "array",   "description": "已插入飞刀的角度列表 number[]" }
+      }
+    },
+    "knives_queue": {
+      "type": "counter",
+      "description": "当前关卡剩余可投飞刀数量",
+      "fields": {
+        "remaining_count": { "type": "integer", "description": "剩余飞刀数" },
+        "total_count":     { "type": "integer", "description": "本关总飞刀数" }
+      }
+    },
+    "score": {
+      "type": "counter",
+      "initial": 0,
+      "description": "当前得分"
+    },
+    "apples": {
+      "type": "collectibles",
+      "description": "木桩上的苹果/水果，可被飞刀收集",
+      "fields": {
+        "id":              { "type": "integer" },
+        "angle":           { "type": "number",  "description": "苹果在木桩上的固定角度（相对于木桩，度）" },
+        "angular_radius":  { "type": "number",  "value": 8, "description": "收集判定角度半径（度）" },
+        "collected":       { "type": "boolean", "default": false }
+      }
+    },
+    "level": {
+      "type": "level-config",
+      "description": "关卡配置",
+      "fields": {
+        "level_number":   { "type": "integer" },
+        "knives_required": { "type": "integer", "description": "本关需要成功投出的飞刀数" },
+        "rotation_speed": { "type": "number",   "description": "本关旋转速度（度/秒）" },
+        "phase_changes":  { "type": "array",    "description": "旋转方向变化阶段 [{at_knife: number, new_direction: 1|-1}]" }
+      }
+    }
+  },
+  "rules": {
+    "throw_knife": {
+      "description": "玩家点击投出飞刀：飞刀以当前木桩旋转角度插入",
+      "trigger": "player_tap",
+      "effect": [
+        "新飞刀插入角度 = target.current_angle",
+        "检测碰撞：若与任何已插飞刀角度差 < minSeparationAngle → 游戏结束",
+        "检测苹果：若命中苹果角度范围内 → 收集苹果，加苹果分",
+        "成功：target.inserted_knives.push(current_angle)；knives_queue.remaining_count--；score += knifeScore"
+      ],
+      "minSeparationAngle": 15,
+      "knifeScore": 10
+    },
+    "collision_check": {
+      "description": "碰撞检测：新飞刀角度与所有已插飞刀的最小角距 < minSeparationAngle",
+      "formula": "angularDistance(a, b) = min(|a-b|, 360-|a-b|)",
+      "collision_condition": "min(angularDistance(newAngle, knife) for knife in inserted_knives) < minSeparationAngle",
+      "result_on_collision": "gameOver = true"
+    },
+    "apple_collect": {
+      "description": "苹果收集：飞刀插入角度与苹果角度的角距 < apple.angular_radius",
+      "effect": "apple.collected = true; score += appleBonusScore",
+      "appleBonusScore": 50
+    },
+    "rotation_update": {
+      "description": "每帧更新木桩旋转角度",
+      "formula": "current_angle = (current_angle + rotation_speed × rotation_direction × dt) mod 360"
+    },
+    "level_advance": {
+      "description": "所有飞刀成功投出（remaining_count == 0）且无碰撞，过关",
+      "trigger": "knives_queue.remaining_count == 0"
+    }
+  },
+  "algorithm": {
+    "description": "主循环：rotate → player_tap → collision_check → insert → apple_check → level_check",
+    "steps": [
+      "1. 每帧更新木桩旋转角度：current_angle += rotation_speed × direction × dt",
+      "2. 玩家点击：捕获当前木桩角度作为插入角度",
+      "3. 碰撞检测：检查新角度与所有已插飞刀的角距，任意 < minSeparationAngle → 游戏结束",
+      "4. 苹果检测：检查新角度是否命中任意未收集苹果",
+      "5. 插入飞刀：插入成功，remaining_count--，score += knifeScore",
+      "6. 检查旋转方向变化：根据 phase_changes 配置切换方向",
+      "7. 检查过关：remaining_count == 0 → 显示过关",
+      "8. 进入下一关或显示最终结果"
+    ]
+  },
+  "winCondition": {
+    "type": "all_knives_thrown",
+    "description": "成功投出关卡要求的所有飞刀（remaining_count == 0）且无碰撞"
+  },
+  "loseCondition": {
+    "type": "knife_collision",
+    "description": "新投出的飞刀与已插入的飞刀发生碰撞（角距 < minSeparationAngle）"
+  },
+  "testCases": [
+    {
+      "id": "tc_successful_throw",
+      "description": "成功投刀：新飞刀插入角度与已有飞刀角距 > minSeparationAngle",
+      "initialState": {
+        "target": {
+          "current_angle": 90,
+          "rotation_speed": 90,
+          "rotation_direction": 1,
+          "inserted_knives": [0, 180]
+        },
+        "knives_queue": { "remaining_count": 5, "total_count": 5 },
+        "score": 10,
+        "apples": []
+      },
+      "actions": [
+        { "type": "throw_knife" }
+      ],
+      "expectedState": {
+        "target.inserted_knives": [0, 90, 180],
+        "knives_queue.remaining_count": 4,
+        "score": 20,
+        "gameOver": false
+      }
+    },
+    {
+      "id": "tc_collision_game_over",
+      "description": "碰撞失败：新飞刀角度与已有飞刀角距 < 15度",
+      "initialState": {
+        "target": {
+          "current_angle": 5,
+          "rotation_speed": 90,
+          "rotation_direction": 1,
+          "inserted_knives": [0, 90, 180, 270]
+        },
+        "knives_queue": { "remaining_count": 3, "total_count": 5 },
+        "score": 20,
+        "apples": []
+      },
+      "actions": [
+        { "type": "throw_knife" }
+      ],
+      "expectedState": {
+        "gameOver": true,
+        "win": false,
+        "loseReason": "knife_collision"
+      }
+    },
+    {
+      "id": "tc_apple_bonus",
+      "description": "收集苹果：飞刀命中苹果位置，获得额外分数",
+      "initialState": {
+        "target": {
+          "current_angle": 135,
+          "rotation_speed": 45,
+          "rotation_direction": 1,
+          "inserted_knives": [0, 180]
+        },
+        "knives_queue": { "remaining_count": 3, "total_count": 5 },
+        "score": 20,
+        "apples": [
+          { "id": 1, "angle": 135, "angular_radius": 8, "collected": false }
+        ]
+      },
+      "actions": [
+        { "type": "throw_knife" }
+      ],
+      "expectedState": {
+        "score": 80,
+        "apples[0].collected": true,
+        "score_gained": 60
+      }
+    },
+    {
+      "id": "tc_level_complete",
+      "description": "关卡通过：成功投出最后一刀",
+      "initialState": {
+        "target": {
+          "current_angle": 45,
+          "rotation_speed": 90,
+          "rotation_direction": 1,
+          "inserted_knives": [90, 180, 270]
+        },
+        "knives_queue": { "remaining_count": 1, "total_count": 4 },
+        "score": 30,
+        "apples": []
+      },
+      "actions": [
+        { "type": "throw_knife" }
+      ],
+      "expectedState": {
+        "knives_queue.remaining_count": 0,
+        "gameOver": true,
+        "win": true
+      }
+    }
+  ]
+}

package/skills/knife_hit.aigameplay/ref/reducer.template.ts

@@ -0,0 +1,196 @@
+/**
+ * knife_hit.aigameplay — reducer 接口模板
+ *
+ * Agent 生成实际 reducer 时，必须导出以下函数。
+ * 此文件是接口约束模板，不是可执行代码。
+ *
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ * ⚠️ 重要：渲染层（GameScene）不应直接调用 dispatch()
+ *
+ * 游戏的核心循环是「每帧旋转 + 玩家点击投刀」，
+ * 渲染层必须每帧调用 updateRotation 更新木桩旋转角度，
+ * 并根据 state.target.current_angle 旋转木桩精灵组。
+ *
+ * 玩家点击时，先调用 checkCollision，再调用 throwKnife，
+ * 在飞刀飞行动画播放期间保持逻辑状态不变，动画结束后再更新。
+ *
+ * dispatch() 的用途：无头测试、AI 模拟、关卡回放等场景。
+ * ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+ */
+
+// ─── 配置类型 ─────────────────────────────────────────────────────────────────
+
+export type KnifeHitConfig = {
+  /** 木桩半径（像素），默认 120 */
+  targetRadius: number;
+  /** 已插入飞刀之间最小角度差（度），默认 15 */
+  minSeparationAngle: number;
+  /** 基础旋转速度（度/秒），默认 90 */
+  baseRotationSpeed: number;
+  /** 旋转方向，1=顺时针，-1=逆时针 */
+  rotationDirection: 1 | -1;
+  /** 苹果收集判定角度半径（度），默认 8 */
+  appleAngularRadius: number;
+  /** 苹果额外得分，默认 50 */
+  appleBonusScore: number;
+  /** 每刀成功插入得分，默认 10 */
+  knifeScore: number;
+  /** 关卡需要投出的飞刀总数 */
+  knivesRequired: number;
+  /** 旋转方向变化阶段 */
+  phaseChanges?: Array<{ atKnifeNumber: number; newDirection: 1 | -1; newSpeed?: number }>;
+};
+
+// ─── 核心类型 ─────────────────────────────────────────────────────────────────
+
+export type Apple = {
+  id: number;
+  /** 苹果在木桩上的固定角度（相对于木桩坐标系，度） */
+  angle: number;
+  collected: boolean;
+};
+
+export type Target = {
+  radius: number;
+  rotationSpeed: number;
+  rotationDirection: 1 | -1;
+  /** 当前旋转角度 [0, 360) */
+  currentAngle: number;
+  /** 已插入飞刀的角度列表（相对于世界坐标系，度） */
+  insertedKnives: number[];
+};
+
+// ─── 动作类型 ─────────────────────────────────────────────────────────────────
+
+export type KnifeHitAction =
+  | { type: 'throw_knife' }              // 玩家点击投刀（使用当前 currentAngle）
+  | { type: 'update_rotation'; deltaMs: number }   // 每帧旋转更新
+  | { type: 'reset' };
+
+// ─── 状态类型 ─────────────────────────────────────────────────────────────────
+
+export type KnifeHitState = {
+  target: Target;
+  apples: Apple[];
+  knivesRemaining: number;   // 剩余可投飞刀数
+  knivesThrown: number;      // 已成功投出的飞刀数
+  score: number;
+  gameOver: boolean;
+  win: boolean;
+  loseReason: 'knife_collision' | null;
+  /** 上一次投刀是否收集到苹果 */
+  lastAppleCollected: boolean;
+  lastAppleId: number | null;
+  /** 上一次投刀的插入角度 */
+  lastInsertedAngle: number | null;
+};
+
+// ─── 分步操作返回类型 ─────────────────────────────────────────────────────────
+
+/** 碰撞检测结果 */
+export type CollisionCheckResult = {
+  collision: boolean;
+  /** 最近的已插入飞刀角度（若有） */
+  nearestKnifeAngle?: number;
+  /** 最近飞刀的角距（度） */
+  nearestAngleDistance?: number;
+};
+
+/** 投刀结果 */
+export type ThrowResult = {
+  success: boolean;
+  insertedAngle: number;
+  appleCollected: boolean;
+  appleId?: number;
+  bonusScore: number;
+  levelComplete: boolean;
+};
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 必须导出的函数
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+// ─── 初始化 ──────────────────────────────────────────────────────────────────
+
+/**
+ * init：根据关卡配置初始化游戏状态
+ */
+export declare function init(
+  config: KnifeHitConfig,
+  apples?: Apple[],
+): KnifeHitState;
+
+// ─── 一体化接口（测试/AI 模拟用） ───────────────────────────────────────────
+
+/**
+ * dispatch：接收动作，返回新状态（纯函数）
+ * - throw_knife：投出飞刀（使用当前 currentAngle）
+ * - update_rotation：更新旋转（通常由渲染层每帧调用）
+ * - reset：重置
+ *
+ * ⚠️ 仅用于无头测试和 AI 模拟。渲染层请使用下方分步函数。
+ */
+export declare function dispatch(state: KnifeHitState, action: KnifeHitAction): KnifeHitState;
+
+/**
+ * getState：返回当前状态快照
+ */
+export declare function getState(state: KnifeHitState): KnifeHitState;
+
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+// 分步函数（渲染层/场景层必须使用这些函数）
+// ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+/**
+ * updateRotation：每帧更新木桩旋转角度
+ * 公式：currentAngle = (currentAngle + rotationSpeed × direction × deltaMs/1000) % 360
+ *
+ * 渲染层每帧调用，根据返回的 currentAngle 旋转木桩精灵组
+ */
+export declare function updateRotation(
+  state: KnifeHitState,
+  deltaMs: number,
+): KnifeHitState;
+
+/**
+ * checkCollision：检测在给定角度插入是否会与已有飞刀碰撞
+ * 角距公式：angularDistance(a, b) = min(|a-b|, 360-|a-b|)
+ * 碰撞条件：任意已有飞刀的角距 < minSeparationAngle
+ *
+ * 渲染层在玩家点击时立即调用，若碰撞则播放碰撞动画，否则继续飞行动画
+ */
+export declare function checkCollision(
+  state: KnifeHitState,
+  newAngle: number,
+): CollisionCheckResult;
+
+/**
+ * collectApple：检测并收集指定角度处的苹果
+ * 收集条件：angularDistance(angle, apple.angle) < apple.angular_radius
+ *
+ * 内部被 throwKnife 调用，也可由渲染层单独调用以查询是否会命中苹果
+ */
+export declare function collectApple(
+  state: KnifeHitState,
+  angle: number,
+): { collected: boolean; appleId?: number; bonusScore: number; newState: KnifeHitState };
+
+/**
+ * throwKnife：执行投刀操作（使用 target.currentAngle 作为插入角度）
+ * 1. 检测碰撞，若碰撞则 gameOver = true
+ * 2. 检测苹果收集
+ * 3. 将当前角度加入 insertedKnives
+ * 4. knivesRemaining--；score += knifeScore
+ * 5. 处理旋转方向/速度变化（根据 phaseChanges）
+ *
+ * 渲染层在飞刀飞行动画结束后调用
+ */
+export declare function throwKnife(state: KnifeHitState): KnifeHitState;
+
+/**
+ * checkLevelComplete：检测当前关卡是否通关
+ * 通关条件：knivesRemaining == 0 且 gameOver == false
+ */
+export declare function checkLevelComplete(
+  state: KnifeHitState,
+): { complete: boolean; totalScore: number; applesCollected: number };