@myclaw163/clawclaw-cli 0.6.54

package/src/strategies/goals/report-patrol-top.ts

@@ -0,0 +1,80 @@
+import type { GameState } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import {
+  nearestKnownCorpse,
+  nearestReportableCorpse,
+  patrolStep,
+  PatrolState,
+  PROGRESS_INTERVAL_MS,
+} from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+
+export class ReportPatrolTop extends Goal {
+  private readonly patrol = new PatrolState();
+  private lastCorpseNotified = false;
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    const reportDecision = this.tryReport(state, ctx);
+    if (reportDecision) {
+      this.emitProgress(state, ctx);
+      return [reportDecision];
+    }
+
+    const decisions = this.patrolDecision(state, ctx);
+    this.emitProgress(state, ctx);
+    return decisions;
+  }
+
+  private tryReport(state: GameState, ctx: StrategyContext): BehaviorDecision | null {
+    const reportable = nearestReportableCorpse(state);
+    if (reportable) {
+      ctx.reportCorpseTarget = null;
+      this.lastCorpseNotified = false;
+      ctx.notifications.push('发现尸体，正在报告！');
+      return { action: Action.report(reportable.name, reportable.room) };
+    }
+
+    const corpse = nearestKnownCorpse(state, ctx);
+    if (corpse) {
+      if (!this.lastCorpseNotified) {
+        this.lastCorpseNotified = true;
+        const label = corpse.name ? `${corpse.name}的尸体` : '尸体';
+        ctx.notifications.push(`视野内发现${label}，正在靠近准备报告。`);
+      }
+      ctx.reportCorpseTarget = corpse;
+      return { action: Action.move({ x: corpse.x, y: corpse.y }) };
+    }
+
+    this.lastCorpseNotified = false;
+    ctx.reportCorpseTarget = null;
+    return null;
+  }
+
+  private patrolDecision(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    if (state.you.doing_task) return [];
+    return patrolStep(state, ctx, this.patrol, false);
+  }
+
+  private emitProgress(state: GameState, ctx: StrategyContext): void {
+    const now = Date.now();
+    if (now - ctx.lastProgressNotifyAt < PROGRESS_INTERVAL_MS) return;
+    ctx.lastProgressNotifyAt = now;
+
+    const room = state.you.room ?? '未知';
+    const target = this.patrol.nextRoom(ctx);
+
+    let msg = `[进度] 当前在${room}`;
+    if (ctx.reportCorpseTarget) {
+      const label = ctx.reportCorpseTarget.name ?? '未知';
+      msg += `，正在靠近${label}的尸体准备报告。`;
+    } else if (target) {
+      msg += `，巡逻中，正在前往${target.name}寻找尸体。`;
+    } else {
+      msg += '，巡逻中。';
+    }
+    msg += ` 共${ctx.rooms.length}个房间。`;
+
+    ctx.notifications.push(msg);
+  }
+}

package/src/strategies/goals/safe-task-goal.ts

@@ -0,0 +1,102 @@
+import type { GameState, Position, TaskInfo } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import { dist, nearestSafeTask, PATROL_REACHED_DISTANCE, PatrolState, taskMoveDecision } from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+
+export type ThreatPointResolver = (state: GameState, ctx: StrategyContext) => Position[];
+const NON_CRAB = (t: TaskInfo) => t.faction !== 'crab';
+
+export interface SafeTaskPlanOptions {
+  holdUnsafeCurrentForMs?: number;
+}
+
+/**
+ * 进阶普通虾的劳作循环：与 TaskOrPatrolGoal 同构，但任务选择换成 nearestSafeTask——
+ * 测地最近、威胁硬排除（任务点旁有威胁，或必经之路经过威胁附近都不选）、带粘性
+ * （当前任务仍合法就不换，杜绝摇摆；路被把守时粘性失效自动换任务）。
+ * 全部任务被排除或做完时按房间顺序巡逻。
+ */
+export class SafeTaskOrPatrolGoal extends Goal {
+  private readonly patrol = new PatrolState();
+  private current: TaskInfo | null = null;
+  private holdUnsafeCurrentUntil = 0;
+
+  constructor(private readonly threatPoints: ThreatPointResolver) {
+    super();
+  }
+
+  /** 当前粘住的任务，供调用方播报进度（逃跑期间也能看到将回归的任务）。 */
+  get currentTask(): TaskInfo | null {
+    return this.current;
+  }
+
+  /** Refresh the remembered task without issuing a task move. Safe to call while fleeing. */
+  planTask(state: GameState, ctx: StrategyContext, opts: SafeTaskPlanOptions = {}): TaskInfo | null {
+    if (opts.holdUnsafeCurrentForMs != null) {
+      this.holdUnsafeCurrentUntil = Math.max(this.holdUnsafeCurrentUntil, Date.now() + opts.holdUnsafeCurrentForMs);
+    }
+    if (state.you.doing_task) return this.current;
+
+    const task = nearestSafeTask(state, ctx.taskData, NON_CRAB, ctx.emergency, ctx.blockedMoveTarget, ctx.knownCorpses, {
+      threatPoints: this.threatPoints(state, ctx),
+      stickyTaskName: this.current?.task_name ?? null,
+    });
+    this.current = task;
+    return task;
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    if (state.you.doing_task) return [];
+
+    const locked = this.current ? this.safeCurrentTask(state, ctx) : this.planTask(state, ctx);
+    if (locked) {
+      this.current = locked;
+      return [taskMoveDecision(state, ctx, locked)];
+    }
+
+    if (this.current) {
+      const remembered = this.findCurrentTask(ctx);
+      if (remembered && this.isStillAssignable(remembered, ctx) && Date.now() < this.holdUnsafeCurrentUntil) return [];
+      this.current = null;
+      const replanned = this.planTask(state, ctx);
+      if (replanned) return [taskMoveDecision(state, ctx, replanned)];
+    }
+
+    let room = this.patrol.nextRoom(ctx);
+    if (!room) return [];
+    if (dist(state.you.x, state.you.y, room.x, room.y) <= PATROL_REACHED_DISTANCE) {
+      this.patrol.advance(ctx);
+      const next = this.patrol.nextRoom(ctx);
+      if (next) room = next;
+    }
+    return [{ action: Action.move({ x: room.x, y: room.y }) }];
+  }
+
+  private safeCurrentTask(state: GameState, ctx: StrategyContext): TaskInfo | null {
+    const current = this.findCurrentTask(ctx);
+    if (!current) return null;
+
+    const safe = nearestSafeTask(state, [current], NON_CRAB, null, ctx.blockedMoveTarget, ctx.knownCorpses, {
+      threatPoints: this.threatPoints(state, ctx),
+      stickyTaskName: current.task_name,
+    });
+    return safe;
+  }
+
+  private findCurrentTask(ctx: StrategyContext): TaskInfo | null {
+    if (!this.current) return null;
+    return ctx.taskData.find(t => t.task_id === this.current?.task_id)
+      ?? ctx.taskData.find(t => t.task_name === this.current?.task_name)
+      ?? null;
+  }
+
+  private isStillAssignable(task: TaskInfo, ctx: StrategyContext): boolean {
+    return task.status !== 'completed'
+      && task.status !== 'in_progress'
+      && task.x != null
+      && task.y != null
+      && (!ctx.blockedMoveTarget || dist(task.x, task.y, ctx.blockedMoveTarget.x, ctx.blockedMoveTarget.y) > 10)
+      && NON_CRAB(task);
+  }
+}

package/src/strategies/goals/social-task-top.ts

@@ -0,0 +1,161 @@
+import type { GameState } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import {
+  dist,
+  firstAvailableTask,
+  isTargetAlive,
+  matchesTarget,
+  PROGRESS_INTERVAL_MS,
+  reportCorpseDecision,
+  TASK_SUBMIT_RADIUS,
+} from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+
+export interface SocialTarget {
+  target: string;
+  greeting: string | null;
+}
+
+interface SocialTargetState {
+  greetingSent: boolean;
+  lastSpeechTime: number;
+  silenceNotified: boolean;
+}
+
+const GREETING_DISTANCE = 200;
+const SILENCE_TIMEOUT_MS = 10_000;
+
+export class SocialTaskTop extends Goal {
+  private readonly socialTargets: SocialTarget[];
+  private readonly targetStates = new Map<string, SocialTargetState>();
+
+  constructor(socialTargets: SocialTarget[]) {
+    super();
+    this.socialTargets = socialTargets;
+    for (const st of socialTargets) {
+      this.targetStates.set(st.target, {
+        greetingSent: false,
+        lastSpeechTime: 0,
+        silenceNotified: false,
+      });
+    }
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    const decisions: BehaviorDecision[] = [];
+    const now = Date.now();
+
+    const corpseDecision = reportCorpseDecision(state, ctx);
+    if (corpseDecision) {
+      this.emitProgress(state, ctx);
+      return [corpseDecision];
+    }
+
+    for (const st of this.socialTargets) {
+      if (!isTargetAlive(state, st.target, ctx)) continue;
+
+      const visiblePlayer = state.players.find(p => matchesTarget(st.target, p, ctx));
+      if (!visiblePlayer) continue;
+
+      const targetState = this.targetStates.get(st.target)!;
+      const d = visiblePlayer.distance ?? dist(state.you.x, state.you.y, visiblePlayer.x, visiblePlayer.y);
+
+      const targetSpeechEvent = (state.new_events ?? []).find(
+        evt => evt.type === 'wandering_speech' && evt.actor_name === visiblePlayer.name,
+      );
+
+      if (targetSpeechEvent) {
+        targetState.lastSpeechTime = now;
+        targetState.silenceNotified = false;
+
+        const speechText = targetSpeechEvent.text ?? targetSpeechEvent.content ?? '';
+        const seatNum = visiblePlayer.seat ?? st.target;
+        ctx.notifications.push(`${seatNum}号跟我说话了：「${speechText}」`);
+        this.emitProgress(state, ctx);
+        return decisions;
+      }
+
+      if (st.greeting != null && !targetState.greetingSent) {
+        if (d > GREETING_DISTANCE) {
+          if (state.you.doing_task) {
+            this.emitProgress(state, ctx);
+            return decisions;
+          }
+          decisions.push({ action: Action.move({ x: visiblePlayer.x, y: visiblePlayer.y }) });
+          this.emitProgress(state, ctx);
+          return decisions;
+        }
+        decisions.push({ action: Action.speech(st.greeting) });
+        targetState.greetingSent = true;
+        targetState.lastSpeechTime = now;
+        targetState.silenceNotified = false;
+        const seatNum = visiblePlayer.seat ?? st.target;
+        ctx.notifications.push(`已向${seatNum}号打招呼：「${st.greeting}」`);
+        this.emitProgress(state, ctx);
+        return decisions;
+      }
+
+      if (targetState.greetingSent && targetState.lastSpeechTime > 0) {
+        if (now - targetState.lastSpeechTime >= SILENCE_TIMEOUT_MS) {
+          if (!targetState.silenceNotified) {
+            targetState.silenceNotified = true;
+            const seatNum = visiblePlayer.seat ?? st.target;
+            ctx.notifications.push(`${seatNum}号没回话，放弃等待，去做任务。`);
+          }
+          continue;
+        }
+      }
+
+      if (targetState.greetingSent) {
+        this.emitProgress(state, ctx);
+        return decisions;
+      }
+
+    }
+
+    const taskDecision = this.tryTask(state, ctx);
+    if (taskDecision) decisions.push(taskDecision);
+
+    this.emitProgress(state, ctx);
+    return decisions;
+  }
+
+  private tryTask(state: GameState, ctx: StrategyContext): BehaviorDecision | null {
+    const task = firstAvailableTask(ctx.taskData, t => t.faction !== 'crab', ctx.emergency, ctx.blockedMoveTarget);
+    if (!task) return null;
+
+    const isEmergencyTask = task === ctx.emergency;
+    if (state.you.doing_task && !isEmergencyTask) return null;
+
+    const d = dist(state.you.x, state.you.y, task.x!, task.y!);
+    if (d <= TASK_SUBMIT_RADIUS && Date.now() >= ctx.taskLocalBlockedUntil) {
+      return { action: Action.doTask(task.task_name) };
+    }
+    return { action: Action.move({ x: task.x!, y: task.y! }) };
+  }
+
+  private emitProgress(state: GameState, ctx: StrategyContext): void {
+    const now = Date.now();
+    if (now - ctx.lastProgressNotifyAt < PROGRESS_INTERVAL_MS) return;
+    ctx.lastProgressNotifyAt = now;
+
+    const room = state.you.room ?? '未知';
+    const completed = ctx.taskData.filter(t => t.status === 'completed').length;
+    const total = ctx.taskData.filter(t => t.faction !== 'crab').length;
+
+    const visibleTargetNames = this.socialTargets
+      .filter(st => state.players.some(p => matchesTarget(st.target, p, ctx)))
+      .map(st => st.target);
+
+    let msg = `[进度] 当前在${room}。`;
+    if (visibleTargetNames.length > 0) {
+      msg += `社交目标在视野内: ${visibleTargetNames.join(', ')}。`;
+    } else {
+      msg += `社交目标不在视野内，正在做任务。`;
+    }
+    msg += ` 任务进度 ${completed}/${total}。`;
+
+    ctx.notifications.push(msg);
+  }
+}

package/src/strategies/goals/task-kill-report-top.ts

@@ -0,0 +1,163 @@
+import type { GameState } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import {
+  canUseKill,
+  dist,
+  firstAvailableTask,
+  hasKillUseRemaining,
+  isTargetAlive,
+  killCooldownSecs,
+  KILL_RANGE,
+  LONE_FOLLOW_DISTANCE,
+  matchesTarget,
+  PROGRESS_INTERVAL_MS,
+  reportCorpseDecision,
+  TASK_SUBMIT_RADIUS,
+} from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+import { emitLeaf, URGENT_GOAL_PRIORITY, WANDER_GOAL_PRIORITY } from './leaf-goal.js';
+
+type VisibleTargetMatch = {
+  player: GameState['players'][number];
+  dist: number;
+};
+
+export class TaskKillReportTop extends Goal {
+  private readonly targets: string[];
+  private readonly targetSpottedNotified = new Set<string>();
+
+  constructor(targets: string[]) {
+    super();
+    this.targets = [...targets];
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    const allDead = this.targets.every(t => !isTargetAlive(state, t, ctx));
+    if (allDead) {
+      ctx.notifications.push('所有嫌疑目标都已死亡，策略结束。');
+      this.emitProgress(state, ctx);
+      this.clearSub();
+      return [];
+    }
+
+    const visibleMatches = this.visibleTargets(state, ctx);
+    const cd = killCooldownSecs(state);
+    const hasKill = hasKillUseRemaining(state);
+    const killReady = canUseKill(state);
+
+    if (visibleMatches.length > 0 && hasKill) {
+      const nearest = visibleMatches[0];
+
+      if (!this.targetSpottedNotified.has(nearest.player.name)) {
+        this.targetSpottedNotified.add(nearest.player.name);
+        ctx.notifications.push(`发现嫌疑目标${nearest.player.name}！`);
+      }
+
+      if (nearest.dist <= KILL_RANGE && killReady) {
+        ctx.notifications.push(`嫌疑目标${nearest.player.name}在攻击范围内，出刀！`);
+        return this.emitDecisions(state, ctx, [{ action: Action.kill(nearest.player.name) }], URGENT_GOAL_PRIORITY);
+      }
+
+      if (nearest.dist > KILL_RANGE && killReady) {
+        return this.emitDecisions(
+          state,
+          ctx,
+          [{ action: Action.move({ x: nearest.player.x, y: nearest.player.y }) }],
+          URGENT_GOAL_PRIORITY,
+        );
+      }
+
+      if (!killReady) {
+        if (nearest.dist > LONE_FOLLOW_DISTANCE) {
+          return this.emitDecisions(
+            state,
+            ctx,
+            [{ action: Action.move({ x: nearest.player.x, y: nearest.player.y }) }],
+            URGENT_GOAL_PRIORITY,
+          );
+        }
+        this.emitProgress(state, ctx);
+        this.clearSub();
+        return [];
+      }
+    } else {
+      this.targetSpottedNotified.clear();
+    }
+
+    const reportDecision = reportCorpseDecision(state, ctx);
+    if (reportDecision) {
+      return this.emitDecisions(state, ctx, [reportDecision], URGENT_GOAL_PRIORITY);
+    }
+
+    const taskDecision = this.tryTask(state, ctx);
+    if (taskDecision) {
+      return this.emitDecisions(state, ctx, [taskDecision], WANDER_GOAL_PRIORITY);
+    }
+
+    this.emitProgress(state, ctx);
+    this.clearSub();
+    return [];
+  }
+
+  private visibleTargets(state: GameState, ctx: StrategyContext): VisibleTargetMatch[] {
+    const aliveTargets = this.targets.filter(t => isTargetAlive(state, t, ctx));
+    return state.players
+      .map(player => {
+        if (!aliveTargets.some(t => matchesTarget(t, player, ctx))) return null;
+        const d = player.distance ?? dist(state.you.x, state.you.y, player.x, player.y);
+        return { player, dist: d };
+      })
+      .filter((match): match is VisibleTargetMatch => match !== null)
+      .sort((a, b) => a.dist - b.dist);
+  }
+
+  private tryTask(state: GameState, ctx: StrategyContext): BehaviorDecision | null {
+    if (state.you.doing_task) return null;
+
+    const task = firstAvailableTask(ctx.taskData, t => t.faction !== 'crab', ctx.emergency, ctx.blockedMoveTarget);
+    if (!task) return null;
+
+    const d = dist(state.you.x, state.you.y, task.x!, task.y!);
+    if (d <= TASK_SUBMIT_RADIUS && Date.now() >= ctx.taskLocalBlockedUntil) {
+      return { action: Action.doTask(task.task_name) };
+    }
+    return { action: Action.move({ x: task.x!, y: task.y! }) };
+  }
+
+  private emitDecisions(
+    state: GameState,
+    ctx: StrategyContext,
+    decisions: BehaviorDecision[],
+    priority: number,
+  ): BehaviorDecision[] {
+    this.emitProgress(state, ctx);
+    return emitLeaf(this, decisions, priority);
+  }
+
+  private clearSub(): void {
+    if (this.subGoal) this.removeSubGoal();
+  }
+
+  private emitProgress(state: GameState, ctx: StrategyContext): void {
+    const now = Date.now();
+    if (now - ctx.lastProgressNotifyAt < PROGRESS_INTERVAL_MS) return;
+    ctx.lastProgressNotifyAt = now;
+
+    const room = state.you.room ?? '未知';
+    const cd = killCooldownSecs(state);
+    const killsRemaining = state.you.kills_remaining;
+    const targetNames = this.targets.join(', ');
+    const aliveCount = this.targets.filter(t => isTargetAlive(state, t, ctx)).length;
+
+    const completed = ctx.taskData.filter(t => t.status === 'completed').length;
+    const total = ctx.taskData.filter(t => t.faction !== 'crab').length;
+
+    let msg = `[进度] 当前在${room}，嫌疑目标: ${targetNames}（存活${aliveCount}/${this.targets.length}）。`;
+    if (cd > 0) msg += `攻击冷却中(${cd}s)。`;
+    if (killsRemaining === 0) msg += '出刀次数已用完。';
+    msg += ` 任务进度 ${completed}/${total}。`;
+
+    ctx.notifications.push(msg);
+  }
+}

package/src/strategies/goals/task-only-top.ts

@@ -0,0 +1,57 @@
+import type { GameState } from '../../sdk/types.js';
+import { firstAvailableTask, PROGRESS_INTERVAL_MS, taskMoveDecision } from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+
+export class TaskOnlyTop extends Goal {
+  private lastEmergencyNotified = false;
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    if (state.emergency && !this.lastEmergencyNotified) {
+      this.lastEmergencyNotified = true;
+      ctx.notifications.push(`紧急任务出现！优先处理。`);
+    } else if (!state.emergency) {
+      this.lastEmergencyNotified = false;
+    }
+
+    const task = firstAvailableTask(ctx.taskData, () => true, ctx.emergency, ctx.blockedMoveTarget);
+    if (!task) {
+      this.emitProgress(state, ctx);
+      return [];
+    }
+
+    if (state.you.doing_task && task !== ctx.emergency) {
+      this.emitProgress(state, ctx);
+      return [];
+    }
+
+    const decisions = [taskMoveDecision(state, ctx, task)];
+    this.emitProgress(state, ctx);
+    return decisions;
+  }
+
+  private emitProgress(state: GameState, ctx: StrategyContext): void {
+    const now = Date.now();
+    if (now - ctx.lastProgressNotifyAt < PROGRESS_INTERVAL_MS) return;
+    ctx.lastProgressNotifyAt = now;
+
+    const room = state.you.room ?? '未知';
+    const completed = ctx.taskData.filter(t => t.status === 'completed').length;
+    const total = ctx.taskData.length;
+    const current = firstAvailableTask(ctx.taskData, () => true, ctx.emergency);
+
+    let msg = `[进度] 当前在${room}`;
+    if (current) {
+      msg += `，正在前往${current.room}做任务「${current.task_name}」`;
+    } else {
+      msg += `，没有可用任务`;
+    }
+    msg += `。已完成 ${completed}/${total} 个任务。`;
+
+    if (state.emergency) {
+      msg += ` 紧急任务进行中！`;
+    }
+
+    ctx.notifications.push(msg);
+  }
+}

package/src/strategies/goals/task-or-patrol-goal.ts

@@ -0,0 +1,41 @@
+import type { GameState, TaskInfo } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import { dist, firstAvailableTask, PATROL_REACHED_DISTANCE, PatrolState, taskMoveDecision } from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+
+export type TaskPredicate = (task: TaskInfo) => boolean;
+const NON_CRAB: TaskPredicate = t => t.faction !== 'crab';
+
+/**
+ * 好人虾的默认劳作循环：有可做任务（含紧急任务，由 firstAvailableTask 自动优先）就去做，
+ * 没任务就按房间顺序巡逻。抽自 task-report.tryTask，供 task-report / 武士虾共用
+ * （进阶普通虾用其安全选任务变体 SafeTaskOrPatrolGoal）。
+ *
+ * 直接产出 move/doTask 决策、不挂子目标，因此既能作为子目标接入 GoalManager，
+ * 也能被编排型 Goal 持有并直接 tick（见 WarriorShrimpTop）。
+ * 自身不发进度通知，进度由调用方按场景统一播报。
+ */
+export class TaskOrPatrolGoal extends Goal {
+  private readonly patrol = new PatrolState();
+
+  constructor(private readonly predicate: TaskPredicate = NON_CRAB) {
+    super();
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    if (state.you.doing_task) return [];
+
+    const task = firstAvailableTask(ctx.taskData, this.predicate, ctx.emergency, ctx.blockedMoveTarget);
+    if (task) return [taskMoveDecision(state, ctx, task)];
+
+    let room = this.patrol.nextRoom(ctx);
+    if (!room) return [];
+    if (dist(state.you.x, state.you.y, room.x, room.y) <= PATROL_REACHED_DISTANCE) {
+      this.patrol.advance(ctx);
+      const next = this.patrol.nextRoom(ctx);
+      if (next) room = next;
+    }
+    return [{ action: Action.move({ x: room.x, y: room.y }) }];
+  }
+}

package/src/strategies/goals/task-report-top.ts

@@ -0,0 +1,57 @@
+import type { GameState } from '../../sdk/types.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { firstAvailableTask, reportCorpseDecision, PROGRESS_INTERVAL_MS } from '../game-utils.js';
+import { GreetingTracker } from '../greeting.js';
+import { Goal } from './goal.js';
+import { TaskOrPatrolGoal } from './task-or-patrol-goal.js';
+
+export class TaskReportTop extends Goal {
+  private readonly taskGoal = new TaskOrPatrolGoal();
+  private readonly greeting: GreetingTracker;
+
+  constructor(greetingPhrases: string[]) {
+    super();
+    this.greeting = new GreetingTracker(greetingPhrases);
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    const decisions: BehaviorDecision[] = [];
+
+    const greetingDecision = this.greeting.tryGreeting(state);
+    if (greetingDecision) decisions.push(greetingDecision);
+
+    const reportDecision = reportCorpseDecision(state, ctx, { respectBlock: true });
+    if (reportDecision) {
+      decisions.unshift(reportDecision);
+      return decisions;
+    }
+
+    decisions.push(...this.taskGoal.tick(state, ctx));
+
+    this.emitProgress(state, ctx);
+    return decisions;
+  }
+
+  private emitProgress(state: GameState, ctx: StrategyContext): void {
+    const now = Date.now();
+    if (now - ctx.lastProgressNotifyAt < PROGRESS_INTERVAL_MS) return;
+    ctx.lastProgressNotifyAt = now;
+
+    const completed = ctx.taskData.filter(t => t.status === 'completed').length;
+    const total = ctx.taskData.filter(t => t.faction !== 'crab').length;
+    const current = firstAvailableTask(ctx.taskData, t => t.faction !== 'crab', ctx.emergency, ctx.blockedMoveTarget);
+    const room = state.you.room ?? '未知';
+
+    let msg = `[进度] 当前在${room}`;
+    if (current) {
+      msg += `，正在前往${current.room}做任务「${current.task_name}」`;
+    }
+    msg += `。已完成 ${completed}/${total} 个任务。`;
+
+    if (state.emergency) {
+      msg += ` 紧急任务进行中！`;
+    }
+
+    ctx.notifications.push(msg);
+  }
+}