@myclaw163/clawclaw-cli 0.6.66 → 0.6.68

package/src/sdk/types.ts

@@ -1,159 +1,161 @@
-// ─── Spatial ───
-
-export interface Position {
-  x: number;
-  y: number;
-}
-
-export interface MapRoom {
-  id: string;
-  x: number;
-  y: number;
-}
-
-// ─── WebSocket Events ───
-
-export interface GameEvent {
-  type: string;
-  [key: string]: any;
-}
-
-// ─── Action Error Codes ───
-
-export enum ActionErrorCode {
-  TASK_ALREADY_COMPLETED = 'task_already_completed',
-  TASK_NOT_ASSIGNED = 'task_not_assigned_to_you',
-  TASK_ALREADY_IN_PROGRESS = 'task_already_in_progress',
-  NO_SABOTAGE_COMPLETED = 'no_sabotage_completed',
-  ROLE_CANNOT_KILL = 'role_cannot_kill',
-  EMERGENCY_ALREADY_ACTIVE = 'emergency_already_active',
-  TARGET_UNREACHABLE = 'target_unreachable_or_too_far',
-  PATH_NOT_FOUND = 'path_not_found',
-  INVALID_POSITION = 'invalid_position_blocked',
-}
-
-// ─── WebSocket Connection State ───
-
-export enum WsConnectionState {
-  Disconnected = 'disconnected',
-  Connecting = 'connecting',
-  Connected = 'connected',
-  Reconnecting = 'reconnecting',
-  Switching = 'switching',
-}
-
-// ─── Phase ───
-
-export type Phase = 'preparing' | 'wandering' | 'meeting' | 'game_over';
-export type MeetingSubPhase = 'entry' | 'speech' | 'vote';
-
-// ─── Game State ───
-
-export interface PlayerSelf {
-  name: string;
-  x: number;
-  y: number;
-  room: string;
-  seat?: number;
-  role: string;
-  faction: string;
-  is_alive: boolean;
-  kill_cooldown_secs?: number;
-  kills_remaining?: number | null;
-  currently_moving?: boolean;
-  remaining_secs?: number;
-  doing_task?: boolean;
-  task_name?: string;
-}
-
-export interface PlayerInfo {
-  name: string;
-  seat?: number;
-  x: number;
-  y: number;
-  room: string;
-  distance?: number;
-}
-
-export interface CorpseInfo {
-  name: string;
-  seat?: number;
-  room: string;
-  distance?: number;
-  x?: number;
-  y?: number;
-}
-
-export interface MeetingState {
-  caller: string | null;
-  sub_phase: MeetingSubPhase;
-  alive_players: string[];
-  current_speaker?: string | null;
-  speeches_so_far?: Record<string, string>;
-  speeches?: Record<string, string>;
-  votes_submitted?: string[];
-}
-
-export interface TaskInfo {
-  task_id: string;
-  task_name: string;
-  room: string;
-  status: string;
-  x?: number;
-  y?: number;
-  is_fake_shrimp?: boolean;
-  faction?: 'lobster' | 'crab';
-}
-
-/**
- * 全局任务站点（map 的 all_task_locations）：所有玩家共享、开局固定的任务点位置。与 `your_tasks` /
- * `StrategyContext.taskData`（仅自己被分配、带 status）不同——这里只有位置，没有 status。
- * faction='lobster' 是正常任务点，'crab' 是破坏点。
- */
-export interface TaskLocation {
-  name: string;
-  room?: string;
-  x: number;
-  y: number;
-  faction?: 'lobster' | 'crab';
-}
-
-export interface EmergencyInfo extends TaskInfo {
-  remaining_secs: number;
-}
-
-export interface GameState {
-  phase: Phase;
-  tick: number;
-  you: PlayerSelf;
-  your_tasks: TaskInfo[];
-  players: PlayerInfo[];
-  corpses: CorpseInfo[];
-  emergency?: EmergencyInfo;
-  task_progress?: { completed: number; goal: number };
-  new_events?: Array<Record<string, any>>;
-  stale: boolean;
-  meeting?: MeetingState;
-  winner?: string | null;
-  win_reason?: string;
-  all_players?: Array<{ name: string; role: string; is_alive: boolean; seat: number }>;
-  settlement?: Record<string, any>;
-  game_id?: string;
-  last_ejected?: string | null;
-  last_votes?: Record<string, string>;
-  [key: string]: any;
-}
-
-// ─── Review ───
-
-export interface GameResult {
-  gameId: string;
-  won: boolean;
-  role: string;
-  faction: string;
-  winner: string;
-  winReason: string;
-  survivedToEnd: boolean;
-  totalTicks: number;
-  allPlayers: Array<{ name: string; role: string; is_alive: boolean; seat: number }>;
-}
+// ─── Spatial ───
+
+export interface Position {
+  x: number;
+  y: number;
+}
+
+export interface MapRoom {
+  id: string;
+  x: number;
+  y: number;
+}
+
+// ─── WebSocket Events ───
+
+export interface GameEvent {
+  type: string;
+  [key: string]: any;
+}
+
+// ─── Action Error Codes ───
+
+export enum ActionErrorCode {
+  TASK_ALREADY_COMPLETED = 'task_already_completed',
+  TASK_NOT_ASSIGNED = 'task_not_assigned_to_you',
+  TASK_ALREADY_IN_PROGRESS = 'task_already_in_progress',
+  NO_SABOTAGE_COMPLETED = 'no_sabotage_completed',
+  ROLE_CANNOT_KILL = 'role_cannot_kill',
+  EMERGENCY_ALREADY_ACTIVE = 'emergency_already_active',
+  TARGET_UNREACHABLE = 'target_unreachable_or_too_far',
+  PATH_NOT_FOUND = 'path_not_found',
+  INVALID_POSITION = 'invalid_position_blocked',
+}
+
+// ─── WebSocket Connection State ───
+
+export enum WsConnectionState {
+  Disconnected = 'disconnected',
+  Connecting = 'connecting',
+  Connected = 'connected',
+  Reconnecting = 'reconnecting',
+  Switching = 'switching',
+}
+
+// ─── Phase ───
+
+export type Phase = 'preparing' | 'wandering' | 'meeting' | 'game_over';
+export type MeetingSubPhase = 'entry' | 'speech' | 'vote';
+
+// ─── Game State ───
+
+export interface PlayerSelf {
+  name: string;
+  x: number;
+  y: number;
+  room: string;
+  seat?: number;
+  role: string;
+  faction: string;
+  is_alive: boolean;
+  kill_cooldown_secs?: number;
+  kills_remaining?: number | null;
+  currently_moving?: boolean;
+  remaining_secs?: number;
+  doing_task?: boolean;
+  task_name?: string;
+}
+
+export interface PlayerInfo {
+  name: string;
+  seat?: number;
+  x: number;
+  y: number;
+  room: string;
+  distance?: number;
+}
+
+export interface CorpseInfo {
+  name: string;
+  seat?: number;
+  room: string;
+  distance?: number;
+  x?: number;
+  y?: number;
+}
+
+export interface MeetingState {
+  caller: string | null;
+  sub_phase: MeetingSubPhase;
+  alive_players: string[];
+  current_speaker?: string | null;
+  speeches_so_far?: Record<string, string>;
+  speeches?: Record<string, string>;
+  votes_submitted?: string[];
+}
+
+export interface TaskInfo {
+  task_id: string;
+  task_name: string;
+  room: string;
+  status: string;
+  x?: number;
+  y?: number;
+  is_fake_shrimp?: boolean;
+  faction?: 'lobster' | 'crab';
+}
+
+/**
+ * 全局任务站点（map 的 all_task_locations）：所有玩家共享、开局固定的任务点位置。与 `your_tasks` /
+ * `StrategyContext.taskData`（仅自己被分配、带 status）不同——这里只有位置，没有 status。
+ * faction='lobster' 是正常任务点，'crab' 是破坏点。
+ */
+export interface TaskLocation {
+  name: string;
+  room?: string;
+  x: number;
+  y: number;
+  faction?: 'lobster' | 'crab';
+}
+
+export interface EmergencyInfo extends TaskInfo {
+  remaining_secs: number;
+}
+
+export interface GameState {
+  phase: Phase;
+  tick: number;
+  you: PlayerSelf;
+  your_tasks: TaskInfo[];
+  players: PlayerInfo[];
+  corpses: CorpseInfo[];
+  emergency?: EmergencyInfo;
+  /** 服务端下发的「已知存活人数」：存活者 + 本玩家尚未目睹其死亡者之和。残局抢修紧急任务的门槛。 */
+  alive_count?: number;
+  task_progress?: { completed: number; goal: number };
+  new_events?: Array<Record<string, any>>;
+  stale: boolean;
+  meeting?: MeetingState;
+  winner?: string | null;
+  win_reason?: string;
+  all_players?: Array<{ name: string; role: string; is_alive: boolean; seat: number }>;
+  settlement?: Record<string, any>;
+  game_id?: string;
+  last_ejected?: string | null;
+  last_votes?: Record<string, string>;
+  [key: string]: any;
+}
+
+// ─── Review ───
+
+export interface GameResult {
+  gameId: string;
+  won: boolean;
+  role: string;
+  faction: string;
+  winner: string;
+  winReason: string;
+  survivedToEnd: boolean;
+  totalTicks: number;
+  allPlayers: Array<{ name: string; role: string; is_alive: boolean; seat: number }>;
+}

package/src/strategies/avoid-lone.ts

@@ -1,11 +1,11 @@
-import type { StrategyEntry } from './types.js';
-import { GoalRootStrategy } from './goals/goal-root-strategy.js';
-import { AvoidLoneTop } from './goals/avoid-lone-top.js';
-
-export const strategy: StrategyEntry = {
-  id: 'avoid-lone',
-  description: '避免落单。视野里只有一个人时寻路躲避主动避开（推演逃点、持续远离）；视野里有两人以上时跟住次近的玩家、把可见人数维持在 ≥2（最近的人本就贴着不会丢，次近的人才是跌回一对一的临界）；持续无人或没有当前目标时巡逻。',
-  create() {
-    return new GoalRootStrategy('avoid-lone', () => new AvoidLoneTop(), { resetOnMeetingResume: false });
-  },
-};
+import type { StrategyEntry } from './types.js';
+import { GoalRootStrategy } from './goals/goal-root-strategy.js';
+import { AvoidLoneTop } from './goals/avoid-lone-top.js';
+
+export const strategy: StrategyEntry = {
+  id: 'avoid-lone',
+  description: '避免落单。视野里只有一个人时寻路躲避主动避开（推演逃点、持续远离）；视野里有两人以上时跟住次近的玩家、把可见人数维持在 ≥2（最近的人本就贴着不会丢，次近的人才是跌回一对一的临界）；持续无人或没有当前目标时巡逻。',
+  create() {
+    return new GoalRootStrategy('avoid-lone', () => new AvoidLoneTop(), { resetOnMeetingResume: false });
+  },
+};

package/src/strategies/avoid-players.knowledge.md

@@ -1,20 +1,19 @@
-# avoid-players 知识契约
-
-`avoid-players` 读取统一的玩家三档标记：
-
-| 标记 | 行为 |
-|------|------|
-| `suspect` | 加入回避名单，进入视野便逃离 |
-| `hostile` | 加入回避名单，进入视野便逃离 |
-| `trusted` | 不因知识标记而回避 |
-
-回避名单 = 启动参数（座位号/名字）∪ suspect/hostile 标记。威胁消失后恢复巡逻。
-
-```bash
-ccl knowledge mark 4 suspect --confidence 0.7 --note "贴脸尾随"
-ccl knowledge mark 4 hostile --confidence 0.9 --note "确认危险"
-ccl knowledge mark 4 trusted --note "已澄清"
-ccl knowledge del player 4
-```
-
-`role` 是纯身份事实，不直接控制策略。
+# avoid-players 知识契约
+
+`avoid-players` 读取两档玩家标记，**未标记的一律默认「被怀疑」**：
+
+| 标记 | 行为 |
+|------|------|
+| `hostile`（坏人） | 加入回避名单，进入视野便逃离 |
+| `trusted`（好人） | 不因知识标记而回避 |
+| 未标记（被怀疑） | 不自动回避——照常按房间巡逻（需要躲谁就把它标 hostile，或用启动参数点名） |
+
+回避名单 = 启动参数（座位号/名字）∪ 知识库 hostile 标记。威胁消失后恢复巡逻。
+
+```bash
+ccl knowledge mark 4 hostile --note "确认危险"
+ccl knowledge mark 4 trusted --note "已澄清"
+ccl knowledge del player 4            # 取消标记 → 回到默认「被怀疑」（不自动回避）
+```
+
+`role` 是纯身份事实，不直接控制策略。

package/src/strategies/avoid-players.ts

@@ -1,15 +1,15 @@
-import type { StrategyEntry } from './types.js';
-import { GoalRootStrategy } from './goals/goal-root-strategy.js';
-import { AvoidPlayersTop } from './goals/avoid-players-top.js';
-import { parseTargetArgs } from './player-targets.js';
-
-export const strategy: StrategyEntry = {
-  id: 'avoid-players',
-  description: '回避玩家：按房间顺序巡逻，视野里出现回避目标就寻路躲避（推演逃点、持续远离），威胁消失后恢复巡逻。回避名单 = 启动参数（座位号或名字，可多人，可省略）∪ 知识库中标记为 suspect/hostile 的玩家；trusted 不回避。Agent 可用 `ccl knowledge mark` 动态改判，免重启。',
-  create(args?: string[]) {
-    const targets = args ? parseTargetArgs(args) : [];
-    return new GoalRootStrategy('avoid-players', () => new AvoidPlayersTop(targets), {
-      resetOnMeetingResume: false,
-    });
-  },
-};
+import type { StrategyEntry } from './types.js';
+import { GoalRootStrategy } from './goals/goal-root-strategy.js';
+import { AvoidPlayersTop } from './goals/avoid-players-top.js';
+import { parseTargetArgs } from './player-targets.js';
+
+export const strategy: StrategyEntry = {
+  id: 'avoid-players',
+  description: '回避玩家：按房间顺序巡逻，视野里出现回避目标就寻路躲避（推演逃点、持续远离），威胁消失后恢复巡逻。回避名单 = 启动参数（座位号或名字，可多人，可省略）∪ 知识库中标记为 hostile（坏人）的玩家；trusted 与未标记的被怀疑者都不自动回避（要躲就标 hostile 或用启动参数点名）。Agent 可用 `ccl knowledge mark` 动态改判，免重启。',
+  create(args?: string[]) {
+    const targets = args ? parseTargetArgs(args) : [];
+    return new GoalRootStrategy('avoid-players', () => new AvoidPlayersTop(targets), {
+      resetOnMeetingResume: false,
+    });
+  },
+};

package/src/strategies/corpse-patrol.ts

@@ -1,22 +1,22 @@
-import type { StrategyEntry } from './types.js';
-import { GoalRootStrategy } from './goals/goal-root-strategy.js';
-import { CorpsePatrolTop } from './goals/corpse-patrol-top.js';
-import { parseGreetingArgs } from './greeting.js';
-
-class CorpsePatrolStrategy extends GoalRootStrategy {
-  constructor(private readonly greetingPhrases: string[]) {
-    super('corpse-patrol', () => new CorpsePatrolTop(greetingPhrases), { resetOnMeetingResume: false });
-  }
-
-  speechWarmupTexts(): string[] {
-    return this.greetingPhrases;
-  }
-}
-
-export const strategy: StrategyEntry = {
-  id: 'corpse-patrol',
-  description: '发现尸体就在附近40至100距离内随机游荡，但不报告——故意在尸体旁出没制造嫌疑感。没有尸体时巡逻各房间。传入打招呼话术时，视野内出现人就随机发送一条，之后120秒内不再发言。不做任务，不杀人。（天堂鱼默认；进阶版见 paradise-fish）参数：可选：1~3 条打招呼话术。',
-  create(args?: string[]) {
-    return new CorpsePatrolStrategy(parseGreetingArgs(args, 'corpse-patrol'));
-  },
-};
+import type { StrategyEntry } from './types.js';
+import { GoalRootStrategy } from './goals/goal-root-strategy.js';
+import { CorpsePatrolTop } from './goals/corpse-patrol-top.js';
+import { parseGreetingArgs } from './greeting.js';
+
+class CorpsePatrolStrategy extends GoalRootStrategy {
+  constructor(private readonly greetingPhrases: string[]) {
+    super('corpse-patrol', () => new CorpsePatrolTop(greetingPhrases), { resetOnMeetingResume: false });
+  }
+
+  speechWarmupTexts(): string[] {
+    return this.greetingPhrases;
+  }
+}
+
+export const strategy: StrategyEntry = {
+  id: 'corpse-patrol',
+  description: '发现尸体就在附近40至100距离内随机游荡，但不报告——故意在尸体旁出没制造嫌疑感。没有尸体时巡逻各房间。传入打招呼话术时，视野内出现人就随机发送一条，之后120秒内不再发言。不做任务，不杀人；但残局（已知存活≤6）出现紧急维修任务时例外，会最高优先级抢着去做，阻止蟹靠破坏倒计时取胜。（天堂鱼默认；进阶版见 paradise-fish）参数：可选：1~3 条打招呼话术。',
+  create(args?: string[]) {
+    return new CorpsePatrolStrategy(parseGreetingArgs(args, 'corpse-patrol'));
+  },
+};

package/src/strategies/crab-sabotage.ts

@@ -1,21 +1,21 @@
-import type { StrategyEntry } from './types.js';
-import { GoalRootStrategy } from './goals/goal-root-strategy.js';
-import { CrabSabotageTop } from './goals/crab-sabotage-top.js';
-import { ConversationGoal } from './goals/conversation-goal.js';
-import { SpeechModule, getSpeechConfigForRole } from './speech-module.js';
-
-export const strategy: StrategyEntry = {
-  id: 'crab-sabotage',
-  description: '优先完成蟹的真实破坏任务（破坏点紧挨已知尸体时会跳过）；做完立刻触发紧急警报；警报期照样会被举报、不乱杀，只清真正落单的目标。有紧急事件时跳过破坏流程。视野里只有一个非队友且冷却可用就靠近，进入50距离就立刻出刀，即使正在做破坏任务；刀在冷却时不追不等、改做低优先级任务伪装，冷却好且目标仍落单可见再出刀；正在做任务时不会撇下任务去追猎（贴脸且刀好仍会立刻出刀）。发现尸体且附近有非队友、但当前不能原地出刀时，会靠近并报告尸体。视野里出现两人以上时，暂停攻击10秒并做任务伪装，先做真实任务再做虾的伪装任务；选任务时会跳过紧挨已知尸体（含看见过、已离开视野的）的任务。没有可做任务时按房间巡逻，绝不停在原地。（普通蟹默认）',
-  create(args?: string[]) {
-    const role = args?.[0] ?? 'crab_generic';
-    let convo: ConversationGoal | null = null;
-    return new GoalRootStrategy('crab-sabotage', () => {
-      convo = new ConversationGoal(() => new CrabSabotageTop(), new SpeechModule(getSpeechConfigForRole(role)));
-      return convo;
-    }, {
-      resetOnMeetingResume: false,
-      onUpdateRole: role => convo?.updateConfig(role),
-    });
-  },
-};
+import type { StrategyEntry } from './types.js';
+import { GoalRootStrategy } from './goals/goal-root-strategy.js';
+import { CrabSabotageTop } from './goals/crab-sabotage-top.js';
+import { ConversationGoal } from './goals/conversation-goal.js';
+import { SpeechModule, getSpeechConfigForRole } from './speech-module.js';
+
+export const strategy: StrategyEntry = {
+  id: 'crab-sabotage',
+  description: '优先完成蟹的真实破坏任务（破坏点紧挨已知尸体时会跳过）；做完立刻触发紧急警报；警报期照样会被举报、不乱杀，只清真正落单的目标。有紧急事件时跳过破坏流程。视野里只有一个非队友且冷却可用就靠近，进入50距离就立刻出刀，即使正在做破坏任务；刀在冷却时不追不等、改做低优先级任务伪装，冷却好且目标仍落单可见再出刀；正在做任务时不会撇下任务去追猎（贴脸且刀好仍会立刻出刀）。发现尸体且附近有非队友、但当前不能原地出刀时，会靠近并报告尸体。视野里出现两人以上时，暂停攻击10秒并做任务伪装，先做真实任务再做虾的伪装任务；选任务时会跳过紧挨已知尸体（含看见过、已离开视野的）的任务。没有可做任务时按房间巡逻，绝不停在原地。（普通蟹默认）',
+  create(args?: string[]) {
+    const role = args?.[0] ?? 'crab_generic';
+    let convo: ConversationGoal | null = null;
+    return new GoalRootStrategy('crab-sabotage', () => {
+      convo = new ConversationGoal(() => new CrabSabotageTop(), new SpeechModule(getSpeechConfigForRole(role)));
+      return convo;
+    }, {
+      resetOnMeetingResume: false,
+      onUpdateRole: role => convo?.updateConfig(role),
+    });
+  },
+};