@myclaw163/clawclaw-cli 0.6.66 → 0.6.67

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (199) hide show
  1. package/README.md +427 -427
  2. package/bin/clawclaw-cli.mjs +3 -3
  3. package/package.json +48 -48
  4. package/personas//347/220/206/346/231/272/346/270/251/345/222/214.md +23 -23
  5. package/personas//350/200/201/350/260/213/346/267/261/347/256/227.md +22 -22
  6. package/personas//350/257/232/346/201/263/347/233/264/347/216/207.md +22 -22
  7. package/personas//350/275/273/346/235/276/346/264/273/346/263/274.md +22 -22
  8. package/personas//351/207/216/346/200/247/345/217/233/351/200/206.md +23 -23
  9. package/scripts/find-hide-spots.py +157 -157
  10. package/scripts/postinstall.mjs +20 -20
  11. package/scripts/sync-bundled-skill.mjs +245 -245
  12. package/scripts/sync-bundled-skill.test.mjs +152 -152
  13. package/skills/clawclaw/SKILL.md +244 -245
  14. package/skills/clawclaw/references/CHATTERBOX.md +142 -142
  15. package/skills/clawclaw/references/COMMANDS.md +148 -148
  16. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -188
  17. package/skills/clawclaw/references/HUB.md +48 -48
  18. package/skills/clawclaw/references/KNOWLEDGE.md +43 -43
  19. package/skills/clawclaw/references/STRATEGIES.md +57 -57
  20. package/skills/clawclaw/references/STREAM.md +91 -92
  21. package/skills/clawclaw/references/TACTICS.md +65 -65
  22. package/src/assets/clawclaw-ascii-map.txt +40 -40
  23. package/src/cli.ts +110 -110
  24. package/src/commands/_schema.ts +109 -109
  25. package/src/commands/account.ts +209 -209
  26. package/src/commands/do.test.ts +73 -73
  27. package/src/commands/do.ts +126 -126
  28. package/src/commands/events.test.ts +71 -71
  29. package/src/commands/events.ts +155 -155
  30. package/src/commands/game-map.test.ts +28 -28
  31. package/src/commands/game-start-plan.test.ts +84 -84
  32. package/src/commands/game.ts +1027 -1027
  33. package/src/commands/history-player.test.ts +102 -102
  34. package/src/commands/history.ts +573 -573
  35. package/src/commands/hub.test.ts +96 -96
  36. package/src/commands/hub.ts +234 -234
  37. package/src/commands/knowledge.test.ts +19 -19
  38. package/src/commands/knowledge.ts +168 -168
  39. package/src/commands/load.test.ts +51 -51
  40. package/src/commands/load.ts +13 -13
  41. package/src/commands/meeting-history.test.ts +106 -106
  42. package/src/commands/memory.ts +40 -40
  43. package/src/commands/peek.ts +45 -45
  44. package/src/commands/persona.ts +57 -57
  45. package/src/commands/setup/codex.ts +266 -248
  46. package/src/commands/skill.ts +128 -128
  47. package/src/commands/state.ts +46 -46
  48. package/src/commands/strategy.test.ts +135 -135
  49. package/src/commands/strategy.ts +180 -180
  50. package/src/commands/tts.ts +128 -128
  51. package/src/commands/upgrade.test.ts +82 -82
  52. package/src/commands/upgrade.ts +148 -148
  53. package/src/commands/watch.test.ts +966 -966
  54. package/src/commands/watch.ts +659 -659
  55. package/src/lib/auth.test.ts +59 -59
  56. package/src/lib/auth.ts +186 -186
  57. package/src/lib/command-meta.ts +37 -37
  58. package/src/lib/game-client.ts +391 -391
  59. package/src/lib/http-keepalive.ts +15 -15
  60. package/src/lib/http-transport.test.ts +42 -42
  61. package/src/lib/http-transport.ts +113 -113
  62. package/src/lib/hub-client.test.ts +56 -56
  63. package/src/lib/hub-client.ts +88 -88
  64. package/src/lib/hub-install.test.ts +98 -98
  65. package/src/lib/hub-install.ts +121 -121
  66. package/src/lib/hub-reminder.ts +75 -75
  67. package/src/lib/hub-unzip.test.ts +69 -69
  68. package/src/lib/hub-unzip.ts +62 -62
  69. package/src/lib/init-command.test.ts +75 -75
  70. package/src/lib/init-command.ts +120 -120
  71. package/src/lib/knowledge-store.test.ts +180 -180
  72. package/src/lib/knowledge-store.ts +374 -374
  73. package/src/lib/load-context.test.ts +52 -52
  74. package/src/lib/load-context.ts +52 -52
  75. package/src/lib/match-state.test.ts +134 -134
  76. package/src/lib/match-state.ts +94 -94
  77. package/src/lib/netease-tts.ts +83 -83
  78. package/src/lib/normalize.ts +42 -42
  79. package/src/lib/persona.test.ts +41 -41
  80. package/src/lib/persona.ts +72 -72
  81. package/src/lib/server-registry.ts +152 -152
  82. package/src/lib/skill-version.test.ts +48 -48
  83. package/src/lib/skill-version.ts +19 -19
  84. package/src/lib/strategy-export.test.ts +232 -232
  85. package/src/lib/strategy-export.ts +242 -242
  86. package/src/lib/tts-keys.ts +7 -7
  87. package/src/lib/tts-speech.test.ts +63 -63
  88. package/src/lib/tts-speech.ts +76 -76
  89. package/src/lib/workspace-argv.test.ts +49 -49
  90. package/src/lib/workspace-argv.ts +44 -44
  91. package/src/perception/player-history-store.test.ts +87 -87
  92. package/src/perception/player-history-store.ts +194 -194
  93. package/src/pipeline/event-format.test.ts +135 -135
  94. package/src/pipeline/event-format.ts +376 -376
  95. package/src/pipeline/event-hints.ts +173 -173
  96. package/src/pipeline/event-store.test.ts +28 -28
  97. package/src/pipeline/event-store.ts +193 -193
  98. package/src/pipeline/pipeline.ts +35 -35
  99. package/src/runtime/auto-upgrade.test.ts +66 -66
  100. package/src/runtime/auto-upgrade.ts +31 -31
  101. package/src/runtime/event-daemon.test.ts +107 -107
  102. package/src/runtime/event-daemon.ts +409 -409
  103. package/src/runtime/owner-control.ts +150 -150
  104. package/src/runtime/raw-ws-log.test.ts +33 -33
  105. package/src/runtime/raw-ws-log.ts +32 -32
  106. package/src/runtime/runtime-logger.ts +107 -107
  107. package/src/runtime/ws-client.test.ts +104 -104
  108. package/src/runtime/ws-client.ts +272 -272
  109. package/src/sdk/action.ts +166 -166
  110. package/src/sdk/index.ts +111 -111
  111. package/src/sdk/types.ts +159 -159
  112. package/src/strategies/avoid-lone.ts +11 -11
  113. package/src/strategies/avoid-players.knowledge.md +20 -20
  114. package/src/strategies/avoid-players.ts +15 -15
  115. package/src/strategies/corpse-patrol.ts +22 -22
  116. package/src/strategies/crab-sabotage.ts +21 -21
  117. package/src/strategies/custom-module.test.ts +269 -269
  118. package/src/strategies/find-player.ts +16 -16
  119. package/src/strategies/game-utils.test.ts +190 -190
  120. package/src/strategies/game-utils.ts +782 -782
  121. package/src/strategies/goals/anchor-linger.ts +77 -77
  122. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  123. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  124. package/src/strategies/goals/avoid-players-top.ts +121 -121
  125. package/src/strategies/goals/conversation-goal.ts +51 -51
  126. package/src/strategies/goals/corpse-patrol-top.ts +91 -91
  127. package/src/strategies/goals/crab-octopus-reflexes.ts +93 -93
  128. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  129. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  130. package/src/strategies/goals/find-player-top.ts +93 -93
  131. package/src/strategies/goals/flee-players-goal.ts +53 -53
  132. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  133. package/src/strategies/goals/goal-manager.ts +41 -41
  134. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  135. package/src/strategies/goals/goal.ts +28 -28
  136. package/src/strategies/goals/hide-top.ts +197 -197
  137. package/src/strategies/goals/keep-away-goal.ts +217 -217
  138. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  139. package/src/strategies/goals/kill-lone-top.ts +160 -160
  140. package/src/strategies/goals/kill-target-goal.ts +59 -59
  141. package/src/strategies/goals/kill-target-top.ts +109 -109
  142. package/src/strategies/goals/leaf-goal.ts +25 -25
  143. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  144. package/src/strategies/goals/lone-kill-core.ts +82 -82
  145. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  146. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  147. package/src/strategies/goals/lone-kill-task-top.ts +86 -86
  148. package/src/strategies/goals/move-room-goal.ts +60 -60
  149. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  150. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  151. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  152. package/src/strategies/goals/paradise-fish-top.ts +207 -207
  153. package/src/strategies/goals/patrol-top.ts +57 -57
  154. package/src/strategies/goals/report-patrol-top.ts +80 -80
  155. package/src/strategies/goals/safe-task-goal.ts +102 -102
  156. package/src/strategies/goals/social-task-top.ts +161 -161
  157. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  158. package/src/strategies/goals/task-only-top.ts +57 -57
  159. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  160. package/src/strategies/goals/task-report-top.ts +57 -57
  161. package/src/strategies/goals/wander-task-goal.ts +33 -33
  162. package/src/strategies/goals/warrior-shrimp-top.test.ts +86 -86
  163. package/src/strategies/goals/warrior-shrimp-top.ts +500 -500
  164. package/src/strategies/greeting.ts +53 -53
  165. package/src/strategies/hide-spots.ts +123 -123
  166. package/src/strategies/hide.ts +23 -23
  167. package/src/strategies/kill-frenzy.ts +12 -12
  168. package/src/strategies/kill-lone.knowledge.md +20 -20
  169. package/src/strategies/kill-lone.ts +13 -13
  170. package/src/strategies/kill-target.ts +18 -18
  171. package/src/strategies/loader.test.ts +678 -678
  172. package/src/strategies/loader.ts +172 -172
  173. package/src/strategies/lone-kill-task.ts +21 -21
  174. package/src/strategies/meeting-gate.test.ts +59 -59
  175. package/src/strategies/meeting-gate.ts +23 -23
  176. package/src/strategies/move-room.ts +15 -15
  177. package/src/strategies/new-events-backfill.ts +98 -98
  178. package/src/strategies/paradise-fish.knowledge.md +20 -20
  179. package/src/strategies/paradise-fish.ts +25 -25
  180. package/src/strategies/pathfind/distance-field.ts +150 -150
  181. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  182. package/src/strategies/pathfind/escape-planner.ts +355 -355
  183. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  184. package/src/strategies/patrol.ts +11 -11
  185. package/src/strategies/player-targets.ts +13 -13
  186. package/src/strategies/report-patrol.ts +11 -11
  187. package/src/strategies/shrimp-memory.knowledge.md +20 -20
  188. package/src/strategies/shrimp-memory.ts +25 -25
  189. package/src/strategies/social-task.test.ts +28 -28
  190. package/src/strategies/social-task.ts +49 -49
  191. package/src/strategies/spawn.ts +82 -82
  192. package/src/strategies/speech-module.ts +123 -123
  193. package/src/strategies/strategy-loop.ts +771 -771
  194. package/src/strategies/task-kill-report.ts +17 -17
  195. package/src/strategies/task-only.ts +11 -11
  196. package/src/strategies/task-report.ts +22 -22
  197. package/src/strategies/types.ts +102 -102
  198. package/src/strategies/warrior-memory.knowledge.md +22 -22
  199. package/src/strategies/warrior-memory.ts +16 -16
@@ -1,17 +1,17 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { TaskKillReportTop } from './goals/task-kill-report-top.js';
4
-
5
- export const strategy: StrategyEntry = {
6
- id: 'task-kill-report',
7
- description: '需传入嫌疑目标(座位号或名字,可多人)。看到目标且冷却好,50内就出刀,否则追上去;冷却中贴身跟随。目标不在视野时,遇到尸体就报告;没尸体就做普通任务。',
8
- create(args?: string[]) {
9
- if (!args || args.length === 0) {
10
- throw new Error('task-kill-report strategy requires suspected target seat numbers or player names as arguments.');
11
- }
12
- const targets = [...args];
13
- return new GoalRootStrategy('task-kill-report', () => new TaskKillReportTop(targets), {
14
- resetOnMeetingResume: false,
15
- });
16
- },
17
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { TaskKillReportTop } from './goals/task-kill-report-top.js';
4
+
5
+ export const strategy: StrategyEntry = {
6
+ id: 'task-kill-report',
7
+ description: '需传入嫌疑目标(座位号或名字,可多人)。看到目标且冷却好,50内就出刀,否则追上去;冷却中贴身跟随。目标不在视野时,遇到尸体就报告;没尸体就做普通任务。',
8
+ create(args?: string[]) {
9
+ if (!args || args.length === 0) {
10
+ throw new Error('task-kill-report strategy requires suspected target seat numbers or player names as arguments.');
11
+ }
12
+ const targets = [...args];
13
+ return new GoalRootStrategy('task-kill-report', () => new TaskKillReportTop(targets), {
14
+ resetOnMeetingResume: false,
15
+ });
16
+ },
17
+ };
@@ -1,11 +1,11 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { TaskOnlyTop } from './goals/task-only-top.js';
4
-
5
- export const strategy: StrategyEntry = {
6
- id: 'task-only',
7
- description: '专心做任务。紧急任务出现时优先处理,其次按顺序完成普通任务,如果是蟹,则蟹的伪装任务也会做。没有尸体报告和战斗行为。',
8
- create() {
9
- return new GoalRootStrategy('task-only', () => new TaskOnlyTop(), { resetOnMeetingResume: false });
10
- },
11
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { TaskOnlyTop } from './goals/task-only-top.js';
4
+
5
+ export const strategy: StrategyEntry = {
6
+ id: 'task-only',
7
+ description: '专心做任务。紧急任务出现时优先处理,其次按顺序完成普通任务,如果是蟹,则蟹的伪装任务也会做。没有尸体报告和战斗行为。',
8
+ create() {
9
+ return new GoalRootStrategy('task-only', () => new TaskOnlyTop(), { resetOnMeetingResume: false });
10
+ },
11
+ };
@@ -1,22 +1,22 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { TaskReportTop } from './goals/task-report-top.js';
4
- import { parseGreetingArgs } from './greeting.js';
5
-
6
- class TaskReportStrategy extends GoalRootStrategy {
7
- constructor(private readonly greetingPhrases: string[]) {
8
- super('task-report', () => new TaskReportTop(greetingPhrases), { resetOnMeetingResume: false });
9
- }
10
-
11
- speechWarmupTexts(): string[] {
12
- return this.greetingPhrases;
13
- }
14
- }
15
-
16
- export const strategy: StrategyEntry = {
17
- id: 'task-report',
18
- description: '遇尸体最优先:达到报告距离立刻报告,没达到距离就靠近准备报告。紧急任务出现时优先处理,其次按顺序完成普通任务。传入打招呼话术时,视野内出现人就随机发送一条,之后120秒内不再发言。(普通虾默认;进阶版见 shrimp-memory)参数:可选:1~3 条打招呼话术。',
19
- create(args?: string[]) {
20
- return new TaskReportStrategy(parseGreetingArgs(args, 'task-report'));
21
- },
22
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { TaskReportTop } from './goals/task-report-top.js';
4
+ import { parseGreetingArgs } from './greeting.js';
5
+
6
+ class TaskReportStrategy extends GoalRootStrategy {
7
+ constructor(private readonly greetingPhrases: string[]) {
8
+ super('task-report', () => new TaskReportTop(greetingPhrases), { resetOnMeetingResume: false });
9
+ }
10
+
11
+ speechWarmupTexts(): string[] {
12
+ return this.greetingPhrases;
13
+ }
14
+ }
15
+
16
+ export const strategy: StrategyEntry = {
17
+ id: 'task-report',
18
+ description: '遇尸体最优先:达到报告距离立刻报告,没达到距离就靠近准备报告。紧急任务出现时优先处理,其次按顺序完成普通任务。传入打招呼话术时,视野内出现人就随机发送一条,之后120秒内不再发言。(普通虾默认;进阶版见 shrimp-memory)参数:可选:1~3 条打招呼话术。',
19
+ create(args?: string[]) {
20
+ return new TaskReportStrategy(parseGreetingArgs(args, 'task-report'));
21
+ },
22
+ };
@@ -1,102 +1,102 @@
1
- import type { GameState, TaskInfo, TaskLocation, EmergencyInfo, CorpseInfo } from '../sdk/types.js';
2
- import type { Action } from '../sdk/action.js';
3
- import type { KnowledgeView } from '../lib/knowledge-store.js';
4
-
5
- /**
6
- * Minimal interface for custom modules (built-in and strategy-registered).
7
- * Strategy authors implement this to inject custom analysis modules
8
- * (e.g. CoMovementTracker, VisibilityTracker, SpeechAnalyzer) via ctx.customModules.
9
- * The strategy-loop manages lifecycle through these hooks:
10
- * - processEvents: called every tick with new events, tick number, and current game state
11
- * - afterDecide: called after strategy.decide(), can filter/modify decisions (chained by registration order)
12
- * - onMeetingResume: called after each meeting (decay or full reset)
13
- * - onMapLoaded: called when fresh map data is available
14
- */
15
- export interface CustomModule {
16
- processEvents(events: any[], tick: number, state: GameState): void;
17
- afterDecide?(decisions: BehaviorDecision[], state: GameState, ctx: StrategyContext): BehaviorDecision[];
18
- onMeetingResume?(): void;
19
- onMapLoaded?(rawRooms: any[]): void;
20
- }
21
-
22
- export interface BehaviorDecision {
23
- action: Action;
24
- }
25
-
26
- export interface CorpseTarget {
27
- x: number;
28
- y: number;
29
- name?: string;
30
- room?: string;
31
- }
32
-
33
- export interface Strategy {
34
- readonly name: string;
35
- decide(state: GameState, ctx: StrategyContext): BehaviorDecision[];
36
- /** Called when wandering resumes after a meeting pause. */
37
- onMeetingResume?(): void;
38
- /** Called by strategy-loop after getRoleInfo() resolves, allowing late config update. */
39
- updateRole?(role: string): void;
40
- /** Return custom analysis modules. Called once during setup, before the main loop. */
41
- customModules?(): CustomModule[];
42
- /** Optional texts used by strategy-loop for async speech audio warmup. */
43
- speechWarmupTexts?(): string[];
44
- }
45
-
46
- export interface StrategyEntry {
47
- readonly id: string;
48
- readonly description: string;
49
- create(args?: string[]): Strategy;
50
- }
51
-
52
- export interface RoomTarget {
53
- name: string;
54
- x: number;
55
- y: number;
56
- }
57
-
58
- export interface StrategyContext {
59
- taskData: TaskInfo[];
60
- /**
61
- * 全局任务站点(map 的 all_task_locations),strategy-loop 加载地图后写入。与 taskData(仅自己被
62
- * 分配、带 status)不同:这是地图上所有任务点的位置,开局固定。用于「同伴停在任务点附近 → 在真实
63
- * 任务点假装做任务」这类定点行为。首次地图加载前可能为空/未设置。
64
- */
65
- taskLocations?: TaskLocation[];
66
- emergency: EmergencyInfo | null;
67
- taskLocalBlockedUntil: number;
68
- reportCorpseTarget: CorpseTarget | null;
69
- reportBlockedUntil: number;
70
- notifications: string[];
71
- lastProgressNotifyAt: number;
72
- teammates: Set<string>;
73
- alarmDone: boolean;
74
- rooms: RoomTarget[];
75
- playerNamesBySeat: Record<string, string>;
76
- /** Set by strategy-loop when a move target is unreachable too many times. Patrol strategies should advance past the current room. */
77
- forcePatrolAdvance: boolean;
78
- blockedMoveTarget: { x: number; y: number } | null;
79
- /** Own seat number, used by speech module for initiation arbitration. */
80
- mySeat: number;
81
- /** Speech-module notifications, flushed by strategy-loop as robot_speak_rule events. */
82
- speechNotifications: string[];
83
- /**
84
- * Strategy → agent real-time briefings, flushed by strategy-loop as `strategy_alert`
85
- * events (notable → surfaced live by `ccl watch`, unlike `notifications` which only
86
- * land in the log as `type:'auto'`). Push **sparingly**, only on a decisive autonomous
87
- * move the agent must account for when it next speaks/votes (e.g. the bot reported a
88
- * corpse — possibly its own kill — to deflect). NOT for per-tick progress.
89
- */
90
- agentAlerts: string[];
91
- /**
92
- * 跨 tick 的已知尸体记忆,由 strategy-loop 每 tick 用中心 CorpseMemory 写入:尸体从出现一直存在到
93
- * 开会才清空(开会时由 strategy-loop 清空)。是 `state.corpses`(仅当前视野)的严格超集,含已离开
94
- * 视野、之前看见过的尸体。策略应统一读它做尸体检测/接近/任务回避/死亡确认,而非只看 `state.corpses`。
95
- * 通过 hasKnownCorpse / nearestKnownCorpse / firstAvailableTask 的 avoidCorpses 参数消费。
96
- */
97
- knownCorpses?: CorpseInfo[];
98
- knowledge?: KnowledgeView;
99
- recentlyKilledTargets?: Map<string, number>;
100
- /** Strategy-registered modules. strategy-loop auto-calls processEvents, afterDecide, onMeetingResume and onMapLoaded. */
101
- customModules?: CustomModule[];
102
- }
1
+ import type { GameState, TaskInfo, TaskLocation, EmergencyInfo, CorpseInfo } from '../sdk/types.js';
2
+ import type { Action } from '../sdk/action.js';
3
+ import type { KnowledgeView } from '../lib/knowledge-store.js';
4
+
5
+ /**
6
+ * Minimal interface for custom modules (built-in and strategy-registered).
7
+ * Strategy authors implement this to inject custom analysis modules
8
+ * (e.g. CoMovementTracker, VisibilityTracker, SpeechAnalyzer) via ctx.customModules.
9
+ * The strategy-loop manages lifecycle through these hooks:
10
+ * - processEvents: called every tick with new events, tick number, and current game state
11
+ * - afterDecide: called after strategy.decide(), can filter/modify decisions (chained by registration order)
12
+ * - onMeetingResume: called after each meeting (decay or full reset)
13
+ * - onMapLoaded: called when fresh map data is available
14
+ */
15
+ export interface CustomModule {
16
+ processEvents(events: any[], tick: number, state: GameState): void;
17
+ afterDecide?(decisions: BehaviorDecision[], state: GameState, ctx: StrategyContext): BehaviorDecision[];
18
+ onMeetingResume?(): void;
19
+ onMapLoaded?(rawRooms: any[]): void;
20
+ }
21
+
22
+ export interface BehaviorDecision {
23
+ action: Action;
24
+ }
25
+
26
+ export interface CorpseTarget {
27
+ x: number;
28
+ y: number;
29
+ name?: string;
30
+ room?: string;
31
+ }
32
+
33
+ export interface Strategy {
34
+ readonly name: string;
35
+ decide(state: GameState, ctx: StrategyContext): BehaviorDecision[];
36
+ /** Called when wandering resumes after a meeting pause. */
37
+ onMeetingResume?(): void;
38
+ /** Called by strategy-loop after getRoleInfo() resolves, allowing late config update. */
39
+ updateRole?(role: string): void;
40
+ /** Return custom analysis modules. Called once during setup, before the main loop. */
41
+ customModules?(): CustomModule[];
42
+ /** Optional texts used by strategy-loop for async speech audio warmup. */
43
+ speechWarmupTexts?(): string[];
44
+ }
45
+
46
+ export interface StrategyEntry {
47
+ readonly id: string;
48
+ readonly description: string;
49
+ create(args?: string[]): Strategy;
50
+ }
51
+
52
+ export interface RoomTarget {
53
+ name: string;
54
+ x: number;
55
+ y: number;
56
+ }
57
+
58
+ export interface StrategyContext {
59
+ taskData: TaskInfo[];
60
+ /**
61
+ * 全局任务站点(map 的 all_task_locations),strategy-loop 加载地图后写入。与 taskData(仅自己被
62
+ * 分配、带 status)不同:这是地图上所有任务点的位置,开局固定。用于「同伴停在任务点附近 → 在真实
63
+ * 任务点假装做任务」这类定点行为。首次地图加载前可能为空/未设置。
64
+ */
65
+ taskLocations?: TaskLocation[];
66
+ emergency: EmergencyInfo | null;
67
+ taskLocalBlockedUntil: number;
68
+ reportCorpseTarget: CorpseTarget | null;
69
+ reportBlockedUntil: number;
70
+ notifications: string[];
71
+ lastProgressNotifyAt: number;
72
+ teammates: Set<string>;
73
+ alarmDone: boolean;
74
+ rooms: RoomTarget[];
75
+ playerNamesBySeat: Record<string, string>;
76
+ /** Set by strategy-loop when a move target is unreachable too many times. Patrol strategies should advance past the current room. */
77
+ forcePatrolAdvance: boolean;
78
+ blockedMoveTarget: { x: number; y: number } | null;
79
+ /** Own seat number, used by speech module for initiation arbitration. */
80
+ mySeat: number;
81
+ /** Speech-module notifications, flushed by strategy-loop as robot_speak_rule events. */
82
+ speechNotifications: string[];
83
+ /**
84
+ * Strategy → agent real-time briefings, flushed by strategy-loop as `strategy_alert`
85
+ * events (notable → surfaced live by `ccl watch`, unlike `notifications` which only
86
+ * land in the log as `type:'auto'`). Push **sparingly**, only on a decisive autonomous
87
+ * move the agent must account for when it next speaks/votes (e.g. the bot reported a
88
+ * corpse — possibly its own kill — to deflect). NOT for per-tick progress.
89
+ */
90
+ agentAlerts: string[];
91
+ /**
92
+ * 跨 tick 的已知尸体记忆,由 strategy-loop 每 tick 用中心 CorpseMemory 写入:尸体从出现一直存在到
93
+ * 开会才清空(开会时由 strategy-loop 清空)。是 `state.corpses`(仅当前视野)的严格超集,含已离开
94
+ * 视野、之前看见过的尸体。策略应统一读它做尸体检测/接近/任务回避/死亡确认,而非只看 `state.corpses`。
95
+ * 通过 hasKnownCorpse / nearestKnownCorpse / firstAvailableTask 的 avoidCorpses 参数消费。
96
+ */
97
+ knownCorpses?: CorpseInfo[];
98
+ knowledge?: KnowledgeView;
99
+ recentlyKilledTargets?: Map<string, number>;
100
+ /** Strategy-registered modules. strategy-loop auto-calls processEvents, afterDecide, onMeetingResume and onMapLoaded. */
101
+ customModules?: CustomModule[];
102
+ }
@@ -1,22 +1,22 @@
1
- # warrior-memory 知识契约
2
-
3
- `warrior-memory` 只读取统一的玩家三档标记:
4
-
5
- | 标记 | 行为 |
6
- |------|------|
7
- | `suspect` | 可疑:只回避观察,刀可用也绝不出刀(被贴身追击也只逃不反击) |
8
- | `hostile` | 敌对:刀可用时主动追杀;刀冷却或枪虾无次数时回避 |
9
- | `trusted` | 可信:绝不攻击,也不会因其在场而对陌生人后撤 |
10
-
11
- **suspect 只回避、不自卫**:对仅标记 suspect 的玩家,武士虾永远只观察、回避、拉开距离,绝不会因为怀疑或被持续贴身追击而先手出刀(被追到死角也只逃)。确认其敌对后请升级标为 hostile,再由刀好时主动追杀。
12
-
13
- 无标记玩家按陌生人处理:平时不主动猎杀;无 trusted 同伴且单个陌生人贴近 270px 内时先拉开距离。尸体场景仍有更高优先级:刀可用时会攻击尸体旁最近的非 trusted 非队友,因此确认好人后应及时标为 trusted。
14
-
15
- ```bash
16
- ccl knowledge mark 5 suspect --confidence 0.7 --note "电力房尾随"
17
- ccl knowledge mark 5 hostile --confidence 0.9 --note "确认敌对"
18
- ccl knowledge mark 3 trusted --note "不在场证明成立"
19
- ccl knowledge del player 5
20
- ```
21
-
22
- 启动参数 `ccl strategy warrior-memory -- 3 7` 仍表示本次策略运行的明确猎杀目标。`role` 是纯身份事实,不直接控制策略。
1
+ # warrior-memory 知识契约
2
+
3
+ `warrior-memory` 只读取统一的玩家三档标记:
4
+
5
+ | 标记 | 行为 |
6
+ |------|------|
7
+ | `suspect` | 可疑:只回避观察,刀可用也绝不出刀(被贴身追击也只逃不反击) |
8
+ | `hostile` | 敌对:刀可用时主动追杀;刀冷却或枪虾无次数时回避 |
9
+ | `trusted` | 可信:绝不攻击,也不会因其在场而对陌生人后撤 |
10
+
11
+ **suspect 只回避、不自卫**:对仅标记 suspect 的玩家,武士虾永远只观察、回避、拉开距离,绝不会因为怀疑或被持续贴身追击而先手出刀(被追到死角也只逃)。确认其敌对后请升级标为 hostile,再由刀好时主动追杀。
12
+
13
+ 无标记玩家按陌生人处理:平时不主动猎杀;无 trusted 同伴且单个陌生人贴近 270px 内时先拉开距离。尸体场景仍有更高优先级:刀可用时会攻击尸体旁最近的非 trusted 非队友,因此确认好人后应及时标为 trusted。
14
+
15
+ ```bash
16
+ ccl knowledge mark 5 suspect --confidence 0.7 --note "电力房尾随"
17
+ ccl knowledge mark 5 hostile --confidence 0.9 --note "确认敌对"
18
+ ccl knowledge mark 3 trusted --note "不在场证明成立"
19
+ ccl knowledge del player 5
20
+ ```
21
+
22
+ 启动参数 `ccl strategy warrior-memory -- 3 7` 仍表示本次策略运行的明确猎杀目标。`role` 是纯身份事实,不直接控制策略。
@@ -1,16 +1,16 @@
1
- import type { StrategyEntry } from './types.js';
2
- import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
- import { WarriorShrimpTop } from './goals/warrior-shrimp-top.js';
4
- import { parseTargetArgs } from './player-targets.js';
5
-
6
- export const strategy: StrategyEntry = {
7
- id: 'warrior-memory',
8
- description:
9
- '带刀虾·记忆进阶版(武士虾/枪虾通用,好人带刀;kill-lone 的带记忆升级)。统一读取 ccl knowledge 三档标记:suspect 只回避观察、刀可用也绝不出刀(被贴身追击也只逃不反击,确认敌对请升级为 hostile),hostile 在刀好时主动追杀、刀不好时回避,trusted 视为可信同伴且绝不攻击。发现尸体且旁边有非 trusted 对象、刀可用就先出刀,否则靠近报警;无可信同伴且单个陌生人贴近270内时先拉开到300再做任务;无危险时优先紧急任务,否则做任务/巡逻。枪虾会尊重剩余出刀次数。',
10
- create(args?: string[]) {
11
- const huntTargets = args ? parseTargetArgs(args) : [];
12
- return new GoalRootStrategy('warrior-memory', () => new WarriorShrimpTop(huntTargets), {
13
- resetOnMeetingResume: false,
14
- });
15
- },
16
- };
1
+ import type { StrategyEntry } from './types.js';
2
+ import { GoalRootStrategy } from './goals/goal-root-strategy.js';
3
+ import { WarriorShrimpTop } from './goals/warrior-shrimp-top.js';
4
+ import { parseTargetArgs } from './player-targets.js';
5
+
6
+ export const strategy: StrategyEntry = {
7
+ id: 'warrior-memory',
8
+ description:
9
+ '带刀虾·记忆进阶版(武士虾/枪虾通用,好人带刀;kill-lone 的带记忆升级)。统一读取 ccl knowledge 三档标记:suspect 只回避观察、刀可用也绝不出刀(被贴身追击也只逃不反击,确认敌对请升级为 hostile),hostile 在刀好时主动追杀、刀不好时回避,trusted 视为可信同伴且绝不攻击。发现尸体且旁边有非 trusted 对象、刀可用就先出刀,否则靠近报警;无可信同伴且单个陌生人贴近270内时先拉开到300再做任务;无危险时优先紧急任务,否则做任务/巡逻。枪虾会尊重剩余出刀次数。',
10
+ create(args?: string[]) {
11
+ const huntTargets = args ? parseTargetArgs(args) : [];
12
+ return new GoalRootStrategy('warrior-memory', () => new WarriorShrimpTop(huntTargets), {
13
+ resetOnMeetingResume: false,
14
+ });
15
+ },
16
+ };