@myclaw163/clawclaw-cli 0.6.54

package/src/strategies/goals/linger-corpse-goal.ts

@@ -0,0 +1,79 @@
+import type { GameState, PlayerInfo } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import { dist, nearestKnownCorpse, nearestKnownCorpseNav } from '../game-utils.js';
+import type { BehaviorDecision, CorpseTarget, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+
+const LINGER_MIN = 40;
+const LINGER_MAX = 100;
+/** 走到离游走点这么近就算到达、换下一个点（贴尸游走半径 40-100，单步约 144px）。 */
+const LINGER_REACHED = 24;
+/** 单个游走点最多停留这么久就强制换点，防止点落在墙里不可达时卡死。 */
+const LINGER_DWELL_MS = 4000;
+
+export class LingerCorpseGoal extends Goal {
+  private wanderTarget: { x: number; y: number } | null = null;
+  private wanderUntil = 0;
+  private anchorKey = '';
+
+  constructor(private readonly avoidResolver?: (state: GameState, ctx: StrategyContext) => PlayerInfo[]) {
+    super();
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    const body = nearestKnownCorpse(state, ctx);
+    if (!body) {
+      // 还没拿到尸体坐标：朝尸体所在房间靠近，人进视野后坐标自然补全，再切到下面的贴尸游走。
+      this.wanderTarget = null;
+      const nav = nearestKnownCorpseNav(state, ctx);
+      return nav ? [{ action: Action.move({ x: nav.x, y: nav.y }) }] : [];
+    }
+    // 有坐标：在尸体周围 40-100 徘徊。目标「粘住」直到到点 / 超时 / 换了尸体——不再每 tick 重随机，
+    // 否则主循环对「同一移动目标」的去重永不触发，会每轮打断上一次移动、在原地抖而走不出一条游走腿。
+    return [{ action: Action.move(this.resolveWanderTarget(state, ctx, body)) }];
+  }
+
+  // Nav / 非 Nav 的不对称是有意的：tick 取坐标用严格的 nearestKnownCorpse（没坐标无法定点游走），
+  // 但只要还记得尸体在某房间（nearestKnownCorpseNav 非空）就不该 finish——此时应继续走向房间锚点，
+  // 等人进视野把坐标补全，否则尸体一离开视野就提前结束、再也走不回去。
+  isFinish(state: GameState, ctx: StrategyContext): boolean {
+    return nearestKnownCorpseNav(state, ctx) == null;
+  }
+
+  private resolveWanderTarget(state: GameState, ctx: StrategyContext, corpse: CorpseTarget): { x: number; y: number } {
+    const key = corpse.name ?? `${Math.round(corpse.x)},${Math.round(corpse.y)}`;
+    const now = Date.now();
+    const reached = this.wanderTarget != null
+      && dist(state.you.x, state.you.y, this.wanderTarget.x, this.wanderTarget.y) <= LINGER_REACHED;
+    if (this.wanderTarget == null || this.anchorKey !== key || reached || now >= this.wanderUntil) {
+      this.anchorKey = key;
+      this.wanderTarget = this.pickOffset(state, ctx, corpse);
+      this.wanderUntil = now + LINGER_DWELL_MS;
+    }
+    return this.wanderTarget;
+  }
+
+  private pickOffset(state: GameState, ctx: StrategyContext, corpse: CorpseTarget): { x: number; y: number } {
+    const avoid = this.avoidResolver?.(state, ctx) ?? [];
+    return avoid.length > 0 ? this.farSideOffset(state, corpse, avoid) : this.randomOffset(corpse);
+  }
+
+  private farSideOffset(state: GameState, corpse: CorpseTarget, avoid: PlayerInfo[]): { x: number; y: number } {
+    const nearest = avoid.reduce((best, p) => {
+      const d = p.distance ?? dist(state.you.x, state.you.y, p.x, p.y);
+      const bestD = best.distance ?? dist(state.you.x, state.you.y, best.x, best.y);
+      return d < bestD ? p : best;
+    });
+    const vx = corpse.x - nearest.x;
+    const vy = corpse.y - nearest.y;
+    const len = Math.hypot(vx, vy);
+    if (len === 0) return this.randomOffset(corpse);
+    return { x: corpse.x + (vx / len) * LINGER_MAX, y: corpse.y + (vy / len) * LINGER_MAX };
+  }
+
+  private randomOffset(corpse: CorpseTarget): { x: number; y: number } {
+    const angle = Math.random() * 2 * Math.PI;
+    const radius = LINGER_MIN + Math.random() * (LINGER_MAX - LINGER_MIN);
+    return { x: corpse.x + Math.cos(angle) * radius, y: corpse.y + Math.sin(angle) * radius };
+  }
+}

package/src/strategies/goals/lone-kill-core.ts

@@ -0,0 +1,82 @@
+import type { GameState, PlayerInfo } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import {
+  canUseKill,
+  dist,
+  KILL_RANGE,
+  LONE_IGNORE_MS,
+  nonTeammatesVisible,
+} from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+
+export interface LoneKillOptions {
+  /** 紧急期调用方可无视「刚遇到人群」后的短暂停手窗口。 */
+  bypassIgnoreWindow?: boolean;
+}
+
+export type LoneKillAssessment =
+  | { kind: 'hunt'; target: PlayerInfo }
+  | { kind: 'idle' };
+
+/**
+ * crab-sabotage 与 lone-kill-task 共享的落单猎杀状态机。
+ * 刀在冷却（或出刀用完）时一律返回 idle，让上层下沉去做低优先级任务，而不是追/原地等刀。
+ */
+export class LoneKillCore {
+  private loneIgnoreUntil = 0;
+  private suppressStop = false;
+
+  reset(): void {
+    this.loneIgnoreUntil = 0;
+    this.suppressStop = false;
+  }
+
+  /** 兜底任务/巡逻移动是否应 stop_on_player。 */
+  patrolStopOnPlayer(): boolean {
+    return !this.suppressStop;
+  }
+
+  assess(state: GameState, ctx: StrategyContext, opts: LoneKillOptions = {}): LoneKillAssessment {
+    const now = Date.now();
+    this.suppressStop = false;
+    const nonTeammates = nonTeammatesVisible(state, ctx);
+
+    if (nonTeammates.length === 0) {
+      if (state.players.length > 0) {
+        this.loneIgnoreUntil = now + LONE_IGNORE_MS;
+        this.suppressStop = true;
+      }
+      return { kind: 'idle' };
+    }
+
+    if (nonTeammates.length > 1) {
+      this.loneIgnoreUntil = now + LONE_IGNORE_MS;
+      this.suppressStop = true;
+      return { kind: 'idle' };
+    }
+
+    if (!opts.bypassIgnoreWindow && now < this.loneIgnoreUntil) {
+      this.suppressStop = true;
+      return { kind: 'idle' };
+    }
+
+    if (!canUseKill(state)) {
+      // 刀在冷却或出刀已用完：不追不等，下沉做低优先级伪装任务，冷却好再下手
+      //（贴脸反射刀 immediateLoneKillDecision 仍会在冷却结束瞬间生效，不丢顺手的杀）。
+      this.suppressStop = true;
+      return { kind: 'idle' };
+    }
+
+    return { kind: 'hunt', target: nonTeammates[0] };
+  }
+
+  pursue(state: GameState, ctx: StrategyContext, target: PlayerInfo): BehaviorDecision {
+    const d = target.distance ?? dist(state.you.x, state.you.y, target.x, target.y);
+    if (d <= KILL_RANGE && canUseKill(state)) {
+      ctx.notifications.push(`发现落单目标${target.name}，出刀！`);
+      return { action: Action.kill(target.name) };
+    }
+    if (d > KILL_RANGE) ctx.notifications.push(`发现落单目标${target.name}，正在靠近！`);
+    return { action: Action.move({ x: target.x, y: target.y }) };
+  }
+}

package/src/strategies/goals/lone-kill-goal.ts

@@ -0,0 +1,24 @@
+import type { GameState, PlayerInfo } from '../../sdk/types.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+import type { LoneKillCore } from './lone-kill-core.js';
+
+/**
+ * 落单猎杀子目标（叶子，由上层以 URGENT 优先级挂载）：对上层经 {@link LoneKillCore.assess} 选中、
+ * 并经 setTarget() 注入的目标产出追击 / 出刀决策。判定逻辑在 core/上层，本叶子只负责产出动作。
+ */
+export class LoneKillGoal extends Goal {
+  private target: PlayerInfo | null = null;
+
+  constructor(private readonly core: LoneKillCore) {
+    super();
+  }
+
+  setTarget(target: PlayerInfo): void {
+    this.target = target;
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    return this.target ? [this.core.pursue(state, ctx, this.target)] : [];
+  }
+}

package/src/strategies/goals/lone-kill-task-top.test.ts

@@ -0,0 +1,85 @@
+import { describe, expect, it } from 'vitest';
+import type { GameState, TaskInfo } from '../../sdk/types.js';
+import type { StrategyContext } from '../types.js';
+import { LoneKillTaskTop } from './lone-kill-task-top.js';
+
+function state(overrides: Partial<GameState> = {}): GameState {
+  return {
+    phase: 'wandering',
+    tick: 1,
+    you: {
+      name: 'octopus',
+      x: 0,
+      y: 0,
+      room: 'control',
+      role: 'neutral_octopus',
+      faction: 'neutral',
+      is_alive: true,
+      kill_cooldown_secs: 10,
+    },
+    your_tasks: [],
+    players: [],
+    corpses: [],
+    stale: false,
+    ...overrides,
+  };
+}
+
+function task(task_name: string, x: number, y: number): TaskInfo {
+  return {
+    task_id: task_name,
+    task_name,
+    room: 'control',
+    status: 'normal',
+    x,
+    y,
+    is_fake_shrimp: true,
+  };
+}
+
+function context(overrides: Partial<StrategyContext> = {}): StrategyContext {
+  return {
+    taskData: [],
+    emergency: null,
+    taskLocalBlockedUntil: 0,
+    reportCorpseTarget: null,
+    reportBlockedUntil: 0,
+    notifications: [],
+    lastProgressNotifyAt: Date.now(),
+    teammates: new Set(),
+    alarmDone: false,
+    rooms: [{ name: 'patrol', x: 500, y: 0 }],
+    playerNamesBySeat: {},
+    forcePatrolAdvance: false,
+    blockedMoveTarget: null,
+    mySeat: 1,
+    speechNotifications: [],
+    agentAlerts: [],
+    ...overrides,
+  };
+}
+
+describe('LoneKillTaskTop', () => {
+  it('does not try to repair emergency tasks as octopus', () => {
+    const top = new LoneKillTaskTop();
+    const ctx = context({
+      taskData: [task('fake-clean', 100, 0)],
+      emergency: {
+        task_id: 'repair',
+        task_name: 'repair',
+        room: 'control',
+        status: 'emergency',
+        x: 0,
+        y: 0,
+        remaining_secs: 60,
+      },
+    });
+
+    top.tick(state(), ctx);
+    const decisions = top.subGoal?.tick(state(), ctx) ?? [];
+
+    expect(decisions).toHaveLength(1);
+    expect(decisions[0].action.type).toBe('move');
+    expect(decisions[0].action.payload).toMatchObject({ target_x: 100, target_y: 0 });
+  });
+});

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

@@ -0,0 +1,86 @@
+import type { GameState } from '../../sdk/types.js';
+import {
+  firstAvailableTask,
+  killCooldownSecs,
+  nonTeammatesVisible,
+  PatrolState,
+  PROGRESS_INTERVAL_MS,
+} from '../game-utils.js';
+import type { BehaviorDecision, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+import { LoneKillCore } from './lone-kill-core.js';
+import { LoneKillGoal } from './lone-kill-goal.js';
+import { WanderTaskGoal } from './wander-task-goal.js';
+import { emitLeaf, setBehavior, URGENT_GOAL_PRIORITY, WANDER_GOAL_PRIORITY } from './leaf-goal.js';
+import { corpseReportWithNonTeammate, immediateLoneKillDecision } from './crab-octopus-reflexes.js';
+
+/**
+ * 章鱼（中立带刀）的「落单猎杀 + 任务伪装」编排 top。本身不产决策，每 tick 只判定该走哪个行为、
+ * 把对应**叶子子目标**挂为唯一子目标（产出动作的是叶子，优先级标注紧急/游走，供 ConversationGoal 判断）：
+ *
+ * 0. 反射（crab-octopus-reflexes，URGENT，抢在落单猎杀编排之前）：落单非队友贴脸(≤KILL_RANGE)且刀好 →
+ *    立刻出刀；否则有尸体且附近有非队友 → 报警/靠近报警（不管尸体是谁造成的）。
+ * 1. 落单猎杀（LoneKillGoal，URGENT）：core.assess() 判 hunt（刀好且有落单目标）→ 叶子 pursue() 靠近 / 出刀。
+ *    刀在冷却时 assess 返回 idle，不追不等，直接下沉到任务伪装。
+ * 2. 任务伪装 / 巡逻（WanderTaskGoal，WANDER）：做已分配的伪装任务；章鱼不能提交紧急维修任务，
+ *    跳过紧挨已知尸体（含看见过、已离开视野的）的任务，没任务就按房间巡逻，绝不停在原地。
+ */
+export class LoneKillTaskTop extends Goal {
+  private readonly killCore = new LoneKillCore();
+  private readonly patrol = new PatrolState();
+  private readonly loneKillGoal = new LoneKillGoal(this.killCore);
+  private readonly wanderGoal = new WanderTaskGoal(
+    (state, ctx) => firstAvailableTask(ctx.taskData, () => true, undefined, ctx.blockedMoveTarget, ctx.knownCorpses),
+    () => this.killCore.patrolStopOnPlayer(),
+    this.patrol,
+  );
+
+  onMeetingResume(): void {
+    this.killCore.reset();
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    this.emitProgress(state, ctx);
+
+    const immediateKill = immediateLoneKillDecision(state, ctx);
+    if (immediateKill) return emitLeaf(this, immediateKill, URGENT_GOAL_PRIORITY);
+
+    const corpseReport = corpseReportWithNonTeammate(state, ctx);
+    if (corpseReport) return emitLeaf(this, corpseReport, URGENT_GOAL_PRIORITY);
+
+    const target = this.killCore.assess(state, ctx);
+    if (target.kind === 'hunt') {
+      this.loneKillGoal.setTarget(target.target);
+      return setBehavior(this, this.loneKillGoal, URGENT_GOAL_PRIORITY);
+    }
+    return setBehavior(this, this.wanderGoal, WANDER_GOAL_PRIORITY);
+  }
+
+  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 nonTeammates = nonTeammatesVisible(state, ctx);
+
+    let msg = `[进度] 当前在${room}`;
+    if (nonTeammates.length === 0) {
+      msg += '，视野内没有落单目标，继续做任务伪装。';
+    } else if (nonTeammates.length === 1) {
+      msg += `，视野内发现落单目标${nonTeammates[0].name}。`;
+      if (cd > 0) msg += `攻击冷却中(${cd}s)，先做任务、冷却好再下手。`;
+      if (killsRemaining === 0) msg += '出刀次数已用完，继续做任务伪装。';
+    } else {
+      msg += `，视野内有${nonTeammates.length}人，不适合动手。`;
+    }
+
+    const completed = ctx.taskData.filter(t => t.status === 'completed').length;
+    const total = ctx.taskData.length;
+    msg += ` 任务进度 ${completed}/${total}。`;
+
+    ctx.notifications.push(msg);
+  }
+}

package/src/strategies/goals/move-room-goal.ts

@@ -0,0 +1,60 @@
+import type { GameState } from '../../sdk/types.js';
+import { Action } from '../../sdk/action.js';
+import { isInRoom, PROGRESS_INTERVAL_MS, resolveRoom } from '../game-utils.js';
+import type { BehaviorDecision, RoomTarget, StrategyContext } from '../types.js';
+import { Goal } from './goal.js';
+
+export type RoomArrival = (state: GameState, target: RoomTarget) => boolean;
+
+const arrivedByRoomName: RoomArrival = (state, target) => isInRoom(target.name, state);
+
+export interface MoveRoomGoalOptions {
+  emitProgress?: boolean;
+  stopOnPlayer?: boolean;
+}
+
+export class MoveRoomGoal extends Goal {
+  constructor(
+    public readonly room: string,
+    private readonly hasArrived: RoomArrival = arrivedByRoomName,
+    private readonly options: MoveRoomGoalOptions = {},
+  ) {
+    super();
+  }
+
+  tick(state: GameState, ctx: StrategyContext): BehaviorDecision[] {
+    const target = resolveRoom(this.room, ctx);
+    this.emitProgress(state, ctx, target);
+    if (!target || this.hasArrived(state, target)) return [];
+    return [{ action: Action.move({ x: target.x, y: target.y }, this.options.stopOnPlayer ?? false) }];
+  }
+
+  isFinish(state: GameState, ctx: StrategyContext): boolean {
+    const target = resolveRoom(this.room, ctx);
+    if (target == null) return false;
+    const finished = this.hasArrived(state, target);
+    if (finished) this.emitProgress(state, ctx, target);
+    return finished;
+  }
+
+  private emitProgress(state: GameState, ctx: StrategyContext, target: RoomTarget | null): void {
+    if (this.options.emitProgress === false) return;
+
+    const now = Date.now();
+    if (now - ctx.lastProgressNotifyAt < PROGRESS_INTERVAL_MS) return;
+    ctx.lastProgressNotifyAt = now;
+
+    const room = state.you.room ?? '未知房间';
+    if (!target) {
+      const available = ctx.rooms.map(room => room.name).join(', ') || '地图尚未加载';
+      ctx.notifications.push(`[进度] 当前在${room}，找不到目标房间「${this.room}」。可用房间: ${available}。`);
+      return;
+    }
+
+    if (state.you.room === target.name) {
+      ctx.notifications.push(`[进度] 已到达目标房间「${target.name}」，当前位置${room}。`);
+    } else {
+      ctx.notifications.push(`[进度] 当前在${room}，正在前往目标房间「${target.name}」。`);
+    }
+  }
+}

package/src/strategies/goals/normal-shrimp-top.test.ts

@@ -0,0 +1,80 @@
+import { describe, expect, it } from 'vitest';
+import type { GameState } from '../../sdk/types.js';
+import type { StrategyContext } from '../types.js';
+import { KeepAwayGoal } from './keep-away-goal.js';
+import { NormalShrimpTop } from './normal-shrimp-top.js';
+
+function stateWithStranger(distance: number): GameState {
+  return {
+    phase: 'wandering',
+    tick: 1,
+    you: {
+      name: 'shrimp',
+      x: 0,
+      y: 0,
+      room: 'control',
+      role: 'shrimp',
+      faction: 'lobster',
+      is_alive: true,
+    },
+    your_tasks: [],
+    players: [{ name: 'stranger', seat: 2, x: distance, y: 0, room: 'control', distance }],
+    all_players: [{ name: 'stranger', seat: 2, role: 'unknown', is_alive: true }],
+    corpses: [],
+    stale: false,
+  };
+}
+
+function context(overrides: Partial<StrategyContext> = {}): StrategyContext {
+  return {
+    taskData: [],
+    emergency: null,
+    taskLocalBlockedUntil: 0,
+    reportCorpseTarget: null,
+    reportBlockedUntil: 0,
+    notifications: [],
+    lastProgressNotifyAt: Date.now(),
+    teammates: new Set(),
+    alarmDone: false,
+    rooms: [],
+    playerNamesBySeat: { '2': 'stranger' },
+    forcePatrolAdvance: false,
+    blockedMoveTarget: null,
+    mySeat: 1,
+    speechNotifications: [],
+    agentAlerts: [],
+    ...overrides,
+  };
+}
+
+describe('NormalShrimpTop vision thresholds', () => {
+  it('starts backing off at the shrimp vision range', () => {
+    const top = new NormalShrimpTop();
+
+    top.tick(stateWithStranger(270), context());
+
+    expect(top.subGoal).toBeInstanceOf(KeepAwayGoal);
+  });
+
+  it('does not start backing off just outside the vision enter range', () => {
+    const top = new NormalShrimpTop();
+
+    top.tick(stateWithStranger(271), context());
+
+    expect(top.subGoal).not.toBeInstanceOf(KeepAwayGoal);
+  });
+
+  it('keeps backing off through the vision exit buffer', () => {
+    const top = new NormalShrimpTop();
+    const ctx = context();
+
+    top.tick(stateWithStranger(270), ctx);
+    expect(top.subGoal).toBeInstanceOf(KeepAwayGoal);
+
+    top.tick(stateWithStranger(299), ctx);
+    expect(top.subGoal).toBeInstanceOf(KeepAwayGoal);
+
+    top.tick(stateWithStranger(300), ctx);
+    expect(top.subGoal).not.toBeInstanceOf(KeepAwayGoal);
+  });
+});