@myclaw163/clawclaw-cli 0.6.68 → 0.6.70

package/src/strategies/off-route-points.ts

@@ -0,0 +1,105 @@
+import type { Position } from '../sdk/types.js';
+import { dist } from './game-utils.js';
+import { assessRoutes } from './pathfind/escape-planner.js';
+
+/**
+ * 离线从烘焙地图算出的「离路点」：远离任务点/出生点、避开走廊与枢纽的低人流坐标
+ * （世界像素，与 GameState / 可行走网格同坐标系）。HIDE_SPOTS（藏身角落）是它的具体集合，
+ * 共用下面的选点器。
+ */
+export interface OffRoutePoint extends Position {
+  /** 所在房间，仅供日志/调试。 */
+  room: string;
+}
+
+export interface NearestSafePointOptions<T extends Position = Position> {
+  /** 点离任一威胁多近就硬排除。 */
+  threatExcludeRadius: number;
+  /** 去该点的测地路径经过威胁这个距离内也排除（避免走向把守者）。 */
+  pathThreatRadius: number;
+  /** 当前已选点：仍是合法候选就保持不变，杜绝等距摇摆。 */
+  stickyTo?: T | null;
+  /** 被标记为不可达的移动目标：在其附近的点跳过。 */
+  blockedTarget?: Position | null;
+}
+
+const BLOCKED_RADIUS = 12;
+
+function samePoint(a: Position, b: Position): boolean {
+  return a.x === b.x && a.y === b.y;
+}
+
+/** 所有点都被威胁封死时的兜底：离威胁最远的点（仍好过原地等死）。 */
+function farthestFromThreats<T extends Position>(
+  points: readonly T[],
+  threatPoints: Position[],
+  blocked?: Position | null,
+): T | null {
+  let best: T | null = null;
+  let bestMin = -Infinity;
+  for (const s of points) {
+    if (blocked && dist(s.x, s.y, blocked.x, blocked.y) <= BLOCKED_RADIUS) continue;
+    const minD = threatPoints.length === 0 ? 0 : Math.min(...threatPoints.map(p => dist(s.x, s.y, p.x, p.y)));
+    if (minD > bestMin) {
+      bestMin = minD;
+      best = s;
+    }
+  }
+  return best;
+}
+
+/**
+ * 从离线点集里选「测地最近的安全点」：威胁旁的点硬排除、去路经过威胁附近的点排除，余者取测地最近
+ * （distance-field 一次扫描；测地不可达按欧氏垫底），带粘性（当前点仍合法就不换）。全部被威胁封死
+ * 时退回「离威胁最远」的点。nearestSafeHideSpot 复用此选点器。
+ */
+export function nearestSafePoint<T extends Position>(
+  points: readonly T[],
+  from: Position,
+  threatPoints: Position[],
+  opts: NearestSafePointOptions<T>,
+): T | null {
+  const excludeR = opts.threatExcludeRadius;
+  const blocked = opts.blockedTarget ?? null;
+
+  const candidates = points.filter(s =>
+    (!blocked || dist(s.x, s.y, blocked.x, blocked.y) > BLOCKED_RADIUS)
+    && !threatPoints.some(p => dist(s.x, s.y, p.x, p.y) <= excludeR));
+
+  if (candidates.length === 0) return farthestFromThreats(points, threatPoints, blocked);
+
+  // 无威胁时粘性可零成本短路（不必为路径检查扫距离场）。
+  if (opts.stickyTo && threatPoints.length === 0) {
+    const sticky = candidates.find(c => samePoint(c, opts.stickyTo!));
+    if (sticky) return sticky;
+  }
+
+  const routes = assessRoutes(
+    from,
+    candidates.map(c => ({ x: c.x, y: c.y })),
+    threatPoints,
+    opts.pathThreatRadius,
+  );
+  const indexed = candidates.map((c, i) => ({ c, i }));
+  const viable = routes == null ? indexed : indexed.filter(({ i }) => !routes[i].nearThreat);
+  const pool = viable.length > 0 ? viable : indexed;
+
+  if (opts.stickyTo) {
+    const sticky = pool.find(({ c }) => samePoint(c, opts.stickyTo!));
+    if (sticky) return sticky.c;
+  }
+
+  // 测地最近（distance-field 距离；测地不可达按欧氏垫底）。
+  let best = pool[0].c;
+  let bestScore = Infinity;
+  for (const { c, i } of pool) {
+    const euclid = dist(from.x, from.y, c.x, c.y);
+    const geo = routes?.[i].distancePx;
+    const score = geo == null ? euclid : geo !== Infinity ? geo : euclid + 1e6;
+    if (score < bestScore) {
+      bestScore = score;
+      best = c;
+    }
+  }
+  return best;
+}

package/src/strategies/paradise-fish.ts

@@ -17,6 +17,7 @@ class ParadiseFishStrategy extends GoalRootStrategy {
 
 export const strategy: StrategyEntry = {
   id: 'paradise-fish',
+  name: '天堂鱼',
   description:
     '天堂鱼·进阶版（中立，不报警、不做任务，靠被投票出局取胜；corpse-patrol 的带记忆升级）。读取 ccl knowledge 两档标记（hostile=坏人 / trusted=好人），未标记的一律默认被怀疑：hostile 视为危险硬寻路远离，被怀疑者按目击者规则保持距离，trusted 视为可抱团的可信同伴。发现尸体绝不报警，贴着尸体游走制造嫌疑；附近有人时远离那人但仍在尸体附近活动。残局（已知存活≤6）出现紧急维修任务时，会在没有带刀坏人需要躲避时优先抢着去做（先于对陌生人保持距离/贴尸/抱团），阻止蟹靠破坏倒计时取胜。传入打招呼话术时，视野内出现人就随机发送一条，之后120秒内不再发言。',
   create(args?: string[]) {

package/src/strategies/patrol.ts

@@ -4,6 +4,7 @@ import { PatrolTop } from './goals/patrol-top.js';
 
 export const strategy: StrategyEntry = {
   id: 'patrol',
+  name: '巡逻',
   description: '按地图房间顺序依次游走，到达一个房间后自动前往下一个，循环往复。卡路时会跳过当前目标换下一个房间。纯游走，不做任务、不打人、不报告尸体。',
   create() {
     return new GoalRootStrategy('patrol', () => new PatrolTop(), { resetOnMeetingResume: false });

package/src/strategies/report-patrol.ts

@@ -4,6 +4,7 @@ import { ReportPatrolTop } from './goals/report-patrol-top.js';
 
 export const strategy: StrategyEntry = {
   id: 'report-patrol',
+  name: '报警',
   description: '专门找尸体：达到报告距离立刻报告，看到尸体就靠近；没有尸体就巡逻各房间。不做任何任务，不打人，目标是让会议尽快开起来。',
   create() {
     return new GoalRootStrategy('report-patrol', () => new ReportPatrolTop(), { resetOnMeetingResume: false });

package/src/strategies/shrimp-memory.ts

@@ -17,6 +17,7 @@ class ShrimpMemoryStrategy extends GoalRootStrategy {
 
 export const strategy: StrategyEntry = {
   id: 'shrimp-memory',
+  name: '精英虾',
   description:
     '普通虾·记忆进阶版（好人、不带刀；task-report 的带记忆升级）。读取 ccl knowledge 两档标记（hostile=坏人 / trusted=好人），未标记的一律默认被怀疑：hostile 硬寻路远离，trusted 视为可信同伴，被怀疑者按目击者规则保持距离。发现尸体最优先报警，并提示复核尸体旁身份不明者；无可信同伴且单个被怀疑者贴近270内时先拉开距离到300再做任务；再处理紧急任务，最后做任务/巡逻（选测地最近、跳过威胁旁或必经威胁的任务）。永不出刀。传入打招呼话术时，视野内出现人就随机发送一条，之后120秒内不再发言。',
   create(args?: string[]) {

package/src/strategies/social-task.ts

@@ -33,6 +33,7 @@ export function parseSocialArgs(args: string[]): SocialTarget[] {
 
 export const strategy: StrategyEntry = {
   id: 'social-task',
+  name: '社交',
   description: '针对指定玩家社交（参数格式 座位=话术 或纯座位，可多人）。视野内出现目标就靠近，没打过招呼先发一次招呼；对方说话就停下等你回复，10秒没回应就转去做任务。全程见到可报告的尸体就报、见到尸体就靠近。不打人。参数：座位=话术 / 座位（可多人）。',
   create(args?: string[]) {
     if (!args || args.length === 0) {

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

@@ -4,6 +4,7 @@ import { TaskKillReportTop } from './goals/task-kill-report-top.js';
 
 export const strategy: StrategyEntry = {
   id: 'task-kill-report',
+  name: '任务刺客',
   description: '需传入嫌疑目标（座位号或名字，可多人）。看到目标且冷却好，50内就出刀，否则追上去；冷却中贴身跟随。目标不在视野时，遇到尸体就报告；没尸体就做普通任务。',
   create(args?: string[]) {
     if (!args || args.length === 0) {

package/src/strategies/task-only.ts

@@ -4,6 +4,7 @@ import { TaskOnlyTop } from './goals/task-only-top.js';
 
 export const strategy: StrategyEntry = {
   id: 'task-only',
+  name: '纯任务',
   description: '专心做任务。紧急任务出现时优先处理，其次按顺序完成普通任务，如果是蟹，则蟹的伪装任务也会做。没有尸体报告和战斗行为。',
   create() {
     return new GoalRootStrategy('task-only', () => new TaskOnlyTop(), { resetOnMeetingResume: false });

package/src/strategies/task-report.ts

@@ -15,6 +15,7 @@ class TaskReportStrategy extends GoalRootStrategy {
 
 export const strategy: StrategyEntry = {
   id: 'task-report',
+  name: '尽责虾',
   description: '遇尸体最优先：达到报告距离立刻报告，没达到距离就靠近准备报告。紧急任务出现时优先处理，其次按顺序完成普通任务。传入打招呼话术时，视野内出现人就随机发送一条，之后120秒内不再发言。（普通虾默认；进阶版见 shrimp-memory）参数：可选：1~3 条打招呼话术。',
   create(args?: string[]) {
     return new TaskReportStrategy(parseGreetingArgs(args, 'task-report'));

package/src/strategies/types.ts

@@ -45,6 +45,13 @@ export interface Strategy {
 
 export interface StrategyEntry {
   readonly id: string;
+  /**
+   * 中文展示名/代词，玩家与 agent 沟通时使用（如「守尸」「武士虾」）。会出现在
+   * `ccl strategy --list`/`--info` 输出里，并可作为 `ccl strategy <名>` 的输入。
+   * 注意：这与 `Strategy.name`（`create()` 返回对象的内部 id 名）不是一回事。
+   * 须全局唯一。
+   */
+  readonly name: string;
   readonly description: string;
   create(args?: string[]): Strategy;
 }

package/src/strategies/warrior-memory.knowledge.md

@@ -6,9 +6,9 @@
 |------|------|
 | `hostile`（坏人） | 敌对：刀可用时主动追杀；刀冷却或枪虾无次数时硬回避 |
 | `trusted`（好人） | 可信：绝不攻击，也不会因其在场而对被怀疑者后撤 |
-| 未标记（被怀疑） | 默认回避观察，刀可用也不主动猎杀；仅「绝境自卫」例外（见下） |
+| 未标记（被怀疑） | 默认回避观察，刀可用也**绝不出刀**（无自卫例外） |
 
-**绝境自卫例外（对所有被怀疑者适用）**：当被同一个被怀疑者连续贴身追击、且逃跑推演判定甩不掉时，武士虾会主动横向变一次向试探。只有它跟着变向重新咬住（确认是在追我、不是顺路赶路）、已进 160px 射程、且我到它视线无墙，才会出于自卫先手击杀，并向 agent 推一条「被动自卫」简报（供后续发言/投票口径对齐，别承认无故先手）。直奔身后任务点、顺路掠过的虾不会跟着变向，会被自然甩开、绝不误杀。**不要求先把对方标成坏人**——实战里真凶往往还没被标记就开始追杀，所以对任何被怀疑者都适用。这是最后手段——多数情况下变向只是把追兵甩开，并不出刀。
+**不对被怀疑者出刀（无自卫机制）**：武士虾只对【已确认 hostile / 启动猎杀目标】出刀。历史上的「被怀疑者持续贴身追击 → 诱饵死角试探 → 绝境自卫先手」整套已删除：几何上无法把「贴身跟我观察/盯防的好人」与「贴身追我的凶手」区分开（两者跟随轨迹一样），自卫出刀迟早误杀同阵营好人、触发 warrior_shrimp_self_destruct 直接崩盘，代价远大于收益。被怀疑者贴身追来也只回避（拉开距离 / 借人多互为目击掩护），绝不反杀。
 
 被怀疑者（未标记）平时按陌生人处理：不主动猎杀；无 trusted 同伴且单个被怀疑者贴近 270px 内时先拉开距离，多个互为目击者时照常做任务；坏人刀冷时硬躲所有非好人。尸体场景对【未报警的身份不明者】只报警不灭口：站在尸体旁即便身边有被怀疑者，也绝不先手击杀，一律靠近报警；但若尸体旁是 hostile 或启动猎杀目标、刀可用，仍会现场先手击杀（凶手就在身边照杀）。
 

package/src/strategies/warrior-memory.ts

@@ -5,8 +5,9 @@ import { parseTargetArgs } from './player-targets.js';
 
 export const strategy: StrategyEntry = {
   id: 'warrior-memory',
+  name: '武士虾',
   description:
-    '带刀虾·记忆进阶版（武士虾/枪虾通用，好人带刀；kill-lone 的带记忆升级）。读取 ccl knowledge 两档标记（hostile=坏人 / trusted=好人），未标记的一律默认被怀疑：hostile 刀好时主动追杀、刀不好时硬回避，trusted 视为可信同伴且绝不攻击，被怀疑者默认只回避观察——仅当被同一个被怀疑者持续贴身追击、避让判定甩不掉时主动横向变向试探，只有它跟着变向仍咬住、进了射程且视线无墙才自卫先手击杀（被动自卫，会推 agent 简报；直奔任务点顺路掠过的虾不跟变向、自然甩开不误杀；不要求先标记，实战里真凶常没来得及标就追杀）。发现尸体优先报警；尸体旁若是 hostile/启动猎杀目标且刀可用会现场先手击杀，但绝不会因尸体旁有未报警的身份不明者就灭口（已根治该误杀）；无可信同伴且单个被怀疑者贴近270内时先拉开到300再做任务；无危险时优先紧急任务，否则做任务/巡逻。枪虾会尊重剩余出刀次数。',
+    '带刀虾·记忆进阶版（武士虾/枪虾通用，好人带刀；kill-lone 的带记忆升级）。读取 ccl knowledge 两档标记（hostile=坏人 / trusted=好人），未标记的一律默认被怀疑：hostile 刀好时主动追杀、刀不好时硬回避，trusted 视为可信同伴且绝不攻击。**只对【已确认 hostile / 启动猎杀目标】出刀**——被怀疑者一律只回避、绝不出刀（无可信同伴且单个被怀疑者贴近270内时先拉开到300再做任务，多人互为目击者则照常做任务）；不再有任何贴身追击判定/诱饵试探/绝境自卫（几何上分不开"贴身跟我观察的好人"和"贴身追我的凶手"，自卫迟早误杀同阵营好人触发武士虾自爆，整套已删除）。发现尸体优先报警；尸体旁若是 hostile/启动猎杀目标且刀可用会现场先手击杀，但绝不会因尸体旁有未报警的身份不明者就灭口（已根治该误杀）；无危险时优先紧急任务，否则做任务/巡逻。枪虾会尊重剩余出刀次数。',
   create(args?: string[]) {
     const huntTargets = args ? parseTargetArgs(args) : [];
     return new GoalRootStrategy('warrior-memory', () => new WarriorShrimpTop(huntTargets), {