@myclaw163/clawclaw-cli 0.6.70 → 0.6.74

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 (212) hide show
  1. package/README.md +377 -427
  2. package/package.json +48 -48
  3. package/personas//347/220/206/346/231/272/346/270/251/345/222/214.md +23 -23
  4. package/personas//350/200/201/350/260/213/346/267/261/347/256/227.md +22 -22
  5. package/personas//350/257/232/346/201/263/347/233/264/347/216/207.md +22 -22
  6. package/personas//350/275/273/346/235/276/346/264/273/346/263/274.md +22 -22
  7. package/personas//351/207/216/346/200/247/345/217/233/351/200/206.md +23 -23
  8. package/scripts/check-skill-command-surface.mjs +116 -0
  9. package/scripts/find-hide-spots.py +157 -157
  10. package/scripts/postinstall.mjs +20 -20
  11. package/scripts/sync-bundled-skill.mjs +244 -244
  12. package/scripts/sync-bundled-skill.test.mjs +152 -152
  13. package/skills/clawclaw/SKILL.md +246 -244
  14. package/skills/clawclaw/references/CHATTERBOX.md +141 -142
  15. package/skills/clawclaw/references/COMMANDS.md +155 -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 +42 -45
  19. package/skills/clawclaw/references/STRATEGIES.md +59 -59
  20. package/skills/clawclaw/references/STREAM.md +93 -91
  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 +124 -109
  25. package/src/commands/account.ts +209 -209
  26. package/src/commands/config.ts +30 -30
  27. package/src/commands/do.test.ts +84 -73
  28. package/src/commands/do.ts +130 -126
  29. package/src/commands/events.test.ts +71 -71
  30. package/src/commands/events.ts +221 -155
  31. package/src/commands/game-map.test.ts +28 -28
  32. package/src/commands/game-start-plan.test.ts +84 -84
  33. package/src/commands/game.ts +1113 -1042
  34. package/src/commands/history-player.test.ts +102 -102
  35. package/src/commands/history.ts +573 -573
  36. package/src/commands/hub.test.ts +96 -96
  37. package/src/commands/hub.ts +234 -234
  38. package/src/commands/knowledge.test.ts +13 -13
  39. package/src/commands/knowledge.ts +139 -139
  40. package/src/commands/load.test.ts +51 -51
  41. package/src/commands/load.ts +13 -13
  42. package/src/commands/meeting-history.test.ts +106 -106
  43. package/src/commands/memory.ts +40 -40
  44. package/src/commands/peek.ts +45 -45
  45. package/src/commands/persona.ts +57 -57
  46. package/src/commands/setup/codex.ts +266 -266
  47. package/src/commands/setup/hermes.test.ts +96 -96
  48. package/src/commands/setup/hermes.ts +76 -76
  49. package/src/commands/setup/index.ts +13 -13
  50. package/src/commands/setup/openclaw.test.ts +114 -114
  51. package/src/commands/setup/openclaw.ts +147 -147
  52. package/src/commands/skill.ts +128 -128
  53. package/src/commands/state.ts +46 -46
  54. package/src/commands/strategy.test.ts +145 -145
  55. package/src/commands/strategy.ts +181 -181
  56. package/src/commands/tts.ts +128 -128
  57. package/src/commands/upgrade.test.ts +82 -82
  58. package/src/commands/upgrade.ts +148 -148
  59. package/src/commands/watch.test.ts +999 -977
  60. package/src/commands/watch.ts +660 -658
  61. package/src/lib/auth.test.ts +74 -74
  62. package/src/lib/auth.ts +186 -186
  63. package/src/lib/command-meta.ts +37 -37
  64. package/src/lib/game-client.ts +403 -391
  65. package/src/lib/game-context.ts +92 -0
  66. package/src/lib/host-config-patcher.test.ts +130 -130
  67. package/src/lib/host-config-patcher.ts +151 -151
  68. package/src/lib/http-keepalive.ts +15 -15
  69. package/src/lib/http-transport.test.ts +42 -42
  70. package/src/lib/http-transport.ts +113 -113
  71. package/src/lib/hub-client.test.ts +56 -56
  72. package/src/lib/hub-client.ts +88 -88
  73. package/src/lib/hub-install.test.ts +98 -98
  74. package/src/lib/hub-install.ts +121 -121
  75. package/src/lib/hub-reminder.ts +56 -56
  76. package/src/lib/hub-unzip.test.ts +69 -69
  77. package/src/lib/hub-unzip.ts +62 -62
  78. package/src/lib/init-command.test.ts +75 -75
  79. package/src/lib/init-command.ts +120 -120
  80. package/src/lib/knowledge-store.test.ts +170 -170
  81. package/src/lib/knowledge-store.ts +369 -369
  82. package/src/lib/load-context.test.ts +52 -52
  83. package/src/lib/load-context.ts +52 -52
  84. package/src/lib/match-state.test.ts +134 -134
  85. package/src/lib/match-state.ts +94 -94
  86. package/src/lib/netease-tts.ts +83 -83
  87. package/src/lib/normalize.ts +42 -42
  88. package/src/lib/persona.test.ts +41 -41
  89. package/src/lib/persona.ts +72 -72
  90. package/src/lib/server-registry.ts +152 -152
  91. package/src/lib/skill-version.test.ts +48 -48
  92. package/src/lib/skill-version.ts +19 -19
  93. package/src/lib/strategy-export.test.ts +232 -232
  94. package/src/lib/strategy-export.ts +242 -242
  95. package/src/lib/tts-keys.ts +7 -7
  96. package/src/lib/tts-speech.test.ts +63 -63
  97. package/src/lib/tts-speech.ts +76 -76
  98. package/src/lib/workspace-argv.test.ts +49 -49
  99. package/src/lib/workspace-argv.ts +44 -44
  100. package/src/perception/player-history-store.test.ts +87 -87
  101. package/src/perception/player-history-store.ts +194 -194
  102. package/src/pipeline/event-format.test.ts +243 -215
  103. package/src/pipeline/event-format.ts +501 -485
  104. package/src/pipeline/event-hints.ts +195 -190
  105. package/src/pipeline/event-store.test.ts +28 -28
  106. package/src/pipeline/event-store.ts +193 -193
  107. package/src/pipeline/pipeline.ts +35 -35
  108. package/src/pipeline/player-projection.test.ts +119 -0
  109. package/src/pipeline/player-projection.ts +380 -0
  110. package/src/runtime/auto-upgrade.test.ts +66 -66
  111. package/src/runtime/auto-upgrade.ts +31 -31
  112. package/src/runtime/event-daemon.test.ts +209 -141
  113. package/src/runtime/event-daemon.ts +519 -457
  114. package/src/runtime/owner-control.ts +150 -150
  115. package/src/runtime/raw-ws-log.test.ts +33 -33
  116. package/src/runtime/raw-ws-log.ts +32 -32
  117. package/src/runtime/runtime-logger.ts +107 -107
  118. package/src/runtime/ws-client.test.ts +125 -104
  119. package/src/runtime/ws-client.ts +287 -272
  120. package/src/sdk/action.ts +166 -166
  121. package/src/sdk/index.ts +110 -110
  122. package/src/sdk/types.ts +161 -161
  123. package/src/strategies/avoid-lone.ts +12 -12
  124. package/src/strategies/avoid-players.knowledge.md +19 -19
  125. package/src/strategies/avoid-players.ts +16 -16
  126. package/src/strategies/corpse-patrol.ts +23 -23
  127. package/src/strategies/crab-sabotage.ts +22 -22
  128. package/src/strategies/custom-module.test.ts +270 -270
  129. package/src/strategies/find-player.ts +17 -17
  130. package/src/strategies/game-utils.test.ts +242 -242
  131. package/src/strategies/game-utils.ts +846 -846
  132. package/src/strategies/goals/anchor-linger.ts +77 -77
  133. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  134. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  135. package/src/strategies/goals/avoid-players-top.ts +121 -121
  136. package/src/strategies/goals/conversation-goal.ts +51 -51
  137. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  138. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  139. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  140. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  141. package/src/strategies/goals/find-player-top.ts +93 -93
  142. package/src/strategies/goals/flee-players-goal.ts +53 -53
  143. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  144. package/src/strategies/goals/goal-manager.ts +41 -41
  145. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  146. package/src/strategies/goals/goal.ts +28 -28
  147. package/src/strategies/goals/hide-top.ts +197 -197
  148. package/src/strategies/goals/keep-away-goal.ts +221 -221
  149. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  150. package/src/strategies/goals/kill-lone-top.ts +160 -160
  151. package/src/strategies/goals/kill-target-goal.ts +59 -59
  152. package/src/strategies/goals/kill-target-top.ts +109 -109
  153. package/src/strategies/goals/leaf-goal.ts +27 -27
  154. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  155. package/src/strategies/goals/lone-kill-core.ts +82 -82
  156. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  157. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  158. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  159. package/src/strategies/goals/move-room-goal.ts +60 -60
  160. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  161. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  162. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  163. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  164. package/src/strategies/goals/patrol-top.ts +57 -57
  165. package/src/strategies/goals/report-patrol-top.ts +80 -80
  166. package/src/strategies/goals/safe-task-goal.ts +102 -102
  167. package/src/strategies/goals/social-task-top.ts +161 -161
  168. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  169. package/src/strategies/goals/task-only-top.ts +57 -57
  170. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  171. package/src/strategies/goals/task-report-top.ts +57 -57
  172. package/src/strategies/goals/wander-task-goal.ts +33 -33
  173. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  174. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  175. package/src/strategies/greeting.ts +53 -53
  176. package/src/strategies/hide-spots.ts +59 -59
  177. package/src/strategies/hide.ts +24 -24
  178. package/src/strategies/kill-frenzy.ts +13 -13
  179. package/src/strategies/kill-lone.knowledge.md +17 -17
  180. package/src/strategies/kill-lone.ts +14 -14
  181. package/src/strategies/kill-target.ts +19 -19
  182. package/src/strategies/loader.test.ts +678 -678
  183. package/src/strategies/loader.ts +179 -179
  184. package/src/strategies/lone-kill-task.ts +22 -22
  185. package/src/strategies/meeting-gate.test.ts +59 -59
  186. package/src/strategies/meeting-gate.ts +23 -23
  187. package/src/strategies/move-room.ts +16 -16
  188. package/src/strategies/new-events-backfill.ts +98 -98
  189. package/src/strategies/off-route-points.ts +105 -105
  190. package/src/strategies/paradise-fish.knowledge.md +19 -19
  191. package/src/strategies/paradise-fish.ts +26 -26
  192. package/src/strategies/pathfind/distance-field.ts +150 -150
  193. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  194. package/src/strategies/pathfind/escape-planner.ts +355 -355
  195. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  196. package/src/strategies/patrol.ts +12 -12
  197. package/src/strategies/player-targets.ts +13 -13
  198. package/src/strategies/report-patrol.ts +12 -12
  199. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  200. package/src/strategies/shrimp-memory.ts +26 -26
  201. package/src/strategies/social-task.test.ts +28 -28
  202. package/src/strategies/social-task.ts +50 -50
  203. package/src/strategies/spawn.ts +82 -82
  204. package/src/strategies/speech-module.ts +123 -123
  205. package/src/strategies/strategy-loop.test.ts +15 -0
  206. package/src/strategies/strategy-loop.ts +776 -771
  207. package/src/strategies/task-kill-report.ts +18 -18
  208. package/src/strategies/task-only.ts +12 -12
  209. package/src/strategies/task-report.ts +23 -23
  210. package/src/strategies/types.ts +109 -109
  211. package/src/strategies/warrior-memory.knowledge.md +21 -21
  212. package/src/strategies/warrior-memory.ts +17 -17
@@ -1,266 +1,266 @@
1
- /**
2
- * `ccl setup codex` — 使用 Codex 原生 `codex mcp add` 安装 ClawClaw MCP server
3
- *
4
- * 优先: codex mcp add clawclaw --env CLAWCLAW_WS_URL=... -- <启动命令>
5
- * 回退: 直接写 ~/.codex/config.toml(codex 不可用时)
6
- *
7
- * 自动设置 CLAWCLAW_WS_URL,实现 clawclaw_game_start 零参数调用。
8
- *
9
- * 用法:
10
- * ccl setup codex # dry-run 预览
11
- * ccl setup codex -y # 应用(默认 ws://127.0.0.1:19997)
12
- * ccl setup codex -y --ws-port 19998 # 指定端口
13
- * ccl setup codex --print # 仅输出等价命令行
14
- */
15
-
16
- import { Command } from 'commander';
17
- import { homedir } from 'os';
18
- import { join } from 'path';
19
- import { existsSync, readFileSync, appendFileSync, copyFileSync, readdirSync, statSync as fsStatSync } from 'fs';
20
- import { spawnSync } from 'child_process';
21
-
22
- // ─── 路径解析 ──────────────────────────────────────────────────
23
-
24
- function resolveCodexConfigPath(): string {
25
- const home = process.env.CODEX_HOME?.trim();
26
- if (home) return join(home, 'config.toml');
27
- return join(homedir(), '.codex', 'config.toml');
28
- }
29
-
30
- function resolveCodexClawclawEntry(): { command: string; args: string[] } | null {
31
- const isWin = process.platform === 'win32';
32
- const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
33
-
34
- // 1. dist/mcp-server.js 优先(编译后的纯 JS,无 tsx stdout 污染,最可靠)
35
- const distCandidates = [
36
- join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'dist', 'mcp-server.js'),
37
- join('D:', 'codex-clawclaw', 'dist', 'mcp-server.js'),
38
- ];
39
- for (const dist of distCandidates) {
40
- try { if (existsSync(dist)) return { command: 'node', args: [dist] }; } catch { /* continue */ }
41
- }
42
-
43
- // 2. .mjs 包装器(bin/codex-clawclaw.mjs, 自注册 tsx, 直接 node 运行)
44
- const mjsCandidates = [
45
- join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
46
- join('D:', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
47
- ];
48
- for (const mjs of mjsCandidates) {
49
- try { if (existsSync(mjs)) return { command: process.execPath, args: [mjs] }; } catch { /* continue */ }
50
- }
51
-
52
- // 3. PATH 上找 bin(.cmd)
53
- const cmdNames = isWin
54
- ? ['codex-clawclaw.cmd', 'codex-clawclaw.ps1', 'codex-clawclaw']
55
- : ['codex-clawclaw'];
56
- const sep = isWin ? '\\' : '/';
57
- const pathDirs = (process.env.PATH || '').split(isWin ? ';' : ':').filter(Boolean);
58
- for (const dir of pathDirs) {
59
- for (const name of cmdNames) {
60
- const full = `${dir}${sep}${name}`;
61
- try { if (existsSync(full)) return { command: full, args: [] }; } catch { /* continue */ }
62
- }
63
- }
64
-
65
- // 4. 旧版路径(src/mcp-server.ts, 需搭配 tsx)
66
- const tsCandidates = [
67
- join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'src', 'mcp-server.ts'),
68
- join('D:', 'codex-clawclaw', 'src', 'mcp-server.ts'),
69
- ];
70
- for (const ts of tsCandidates) {
71
- try { if (existsSync(ts)) return { command: process.execPath, args: [resolveTsxCli(), ts] }; } catch { /* continue */ }
72
- }
73
-
74
- return null;
75
- }
76
-
77
- function resolveTsxCli(): string {
78
- const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
79
- const candidates = [
80
- join(appData, 'npm', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
81
- join('D:', 'codex-clawclaw', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
82
- ];
83
- for (const c of candidates) {
84
- try { if (existsSync(c)) return c; } catch { /* continue */ }
85
- }
86
- return 'tsx';
87
- }
88
-
89
- /** 解析 codex CLI 的可执行文件路径(直接 .exe,不依赖 shell shim) */
90
- function resolveCodexExe(): string | null {
91
- // 1. 从 config.toml 读取 CODEX_CLI_PATH(ccl 自己的全局配置)
92
- const configPath = join(homedir(), '.clawclaw', 'config.json');
93
- try {
94
- if (existsSync(configPath)) {
95
- const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
96
- if (cfg.codexCliPath && existsSync(cfg.codexCliPath)) return cfg.codexCliPath;
97
- }
98
- } catch { /* ignore */ }
99
-
100
- // 2. 从 ~/.codex/config.toml 读取 CODEX_CLI_PATH 环境变量
101
- // 搜索 AppData\Local\OpenAI\Codex\bin\ 下最新的 codex.exe
102
- const appData = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
103
- const codexBinDir = join(appData, 'OpenAI', 'Codex', 'bin');
104
- try {
105
- if (existsSync(codexBinDir)) {
106
- const dirs = readdirSync(codexBinDir).filter((d: string) => {
107
- try { return fsStatSync(join(codexBinDir, d)).isDirectory(); } catch { return false; }
108
- }).sort().reverse(); // 最新版本优先
109
- for (const d of dirs) {
110
- const exe = join(codexBinDir, d, 'codex.exe');
111
- try { if (existsSync(exe)) return exe; } catch { /* continue */ }
112
- }
113
- }
114
- } catch { /* ignore */ }
115
-
116
- // 3. PATH 上找 codex.cmd(Windows)
117
- const pathDirs = (process.env.PATH || '').split(';').filter(Boolean);
118
- for (const dir of pathDirs) {
119
- const full = join(dir, 'codex.cmd');
120
- try { if (existsSync(full)) return full; } catch { /* continue */ }
121
- }
122
-
123
- return null;
124
- }
125
-
126
- function codexMcpAvailable(): boolean {
127
- const exe = resolveCodexExe();
128
- if (!exe) return false;
129
- try {
130
- const r = spawnSync(exe, ['mcp', 'list', '--json'], {
131
- env: { ...process.env, NO_COLOR: '1' },
132
- windowsHide: true, timeout: 10_000, encoding: 'utf-8',
133
- });
134
- return r.status === 0;
135
- } catch { return false; }
136
- }
137
-
138
- function codexMcpAlreadyRegistered(): boolean {
139
- const exe = resolveCodexExe();
140
- if (!exe) return false;
141
- try {
142
- const r = spawnSync(exe, ['mcp', 'list', '--json'], {
143
- env: { ...process.env, NO_COLOR: '1' },
144
- windowsHide: true, timeout: 10_000, encoding: 'utf-8',
145
- });
146
- if (r.status !== 0 || !r.stdout) return false;
147
- const servers = JSON.parse(r.stdout);
148
- return Array.isArray(servers) && servers.some((s: any) => s.name === 'clawclaw');
149
- } catch { return false; }
150
- }
151
-
152
- // ─── Commander ─────────────────────────────────────────────────
153
-
154
- export function createSetupCodexSubcommand(): Command {
155
- return new Command('codex')
156
- .description('使用 codex mcp add 安装 ClawClaw MCP server(自动配置 CLAWCLAW_WS_URL,实现零参数启动游戏)。')
157
- .option('-y, --yes', '应用更改(默认 dry-run)')
158
- .option('--print', '仅输出推荐命令')
159
- .option('--ws-port <port>', 'app-server WebSocket 端口(默认 19997)', '19997')
160
- .action((opts: { yes?: boolean; print?: boolean; wsPort?: string }) => {
161
- const wsPort = opts.wsPort || '19997';
162
- const wsUrl = `ws://127.0.0.1:${wsPort}`;
163
- const entry = resolveCodexClawclawEntry();
164
- if (!entry) {
165
- console.log('未找到 codex-clawclaw。');
166
- console.log('安装: npm install -g @myclaw163/codex-clawclaw --registry https://registry.npmmirror.com/');
167
- console.log('本地开发: 在 codex-clawclaw 目录下 npm link');
168
- process.exit(1);
169
- }
170
-
171
- const addArgs = ['mcp', 'add', 'clawclaw', '--env', `CLAWCLAW_WS_URL=${wsUrl}`, '--', entry.command, ...entry.args];
172
-
173
- if (opts.print) {
174
- console.log('# 推荐执行:');
175
- console.log(`codex ${addArgs.join(' ')}`);
176
- console.log('');
177
- console.log('# 等价 config.toml:');
178
- console.log('[mcp_servers.clawclaw]');
179
- console.log(`command = '${entry.command.replace(/\\/g, '\\\\')}'`);
180
- console.log(`args = ${JSON.stringify(entry.args)}`);
181
- console.log('[mcp_servers.clawclaw.env]');
182
- console.log(`CLAWCLAW_WS_URL = '${wsUrl}'`);
183
- console.log('startup_timeout_sec = 30');
184
- return;
185
- }
186
-
187
- if (codexMcpAvailable() && codexMcpAlreadyRegistered()) {
188
- console.log(`ClawClaw MCP server 已注册(CLWCLAW_WS_URL=${wsUrl})。`);
189
- process.exit(0);
190
- }
191
-
192
- if (!opts.yes) {
193
- console.log('待执行:');
194
- console.log(` codex ${addArgs.join(' ')}`);
195
- if (!codexMcpAvailable()) {
196
- console.log('');
197
- console.log('(codex mcp 不可用,将回退到直接写 config.toml)');
198
- }
199
- console.log('');
200
- console.log(`默认端口 ${wsPort},可用 --ws-port 指定。`);
201
- console.log('Dry-run 模式。加 -y 以应用更改。');
202
- process.exit(2);
203
- }
204
-
205
- // ── 应用: 优先 codex mcp add ──
206
- if (codexMcpAvailable()) {
207
- const r = spawnSync(resolveCodexExe()!, addArgs, {
208
- env: { ...process.env, NO_COLOR: '1' },
209
- windowsHide: true, timeout: 30_000, encoding: 'utf-8',
210
- });
211
- if (r.status !== 0) {
212
- console.error('codex mcp add 失败:', r.stderr?.trim() || r.stdout?.trim() || `exit ${r.status}`);
213
- process.exit(1);
214
- }
215
- console.log(`已注册 ClawClaw MCP server(CLAWCLAW_WS_URL=${wsUrl})。`);
216
- console.log('');
217
- console.log('下一步:');
218
- console.log(` 1. codex app-server --listen ${wsUrl}`);
219
- console.log(` 2. codex --remote ${wsUrl}`);
220
- console.log(' 3. 在会话中说 开始一局龙虾杀(无需传参数)');
221
- process.exit(0);
222
- }
223
-
224
- // ── 回退: 直接写 config.toml ──
225
- const configPath = resolveCodexConfigPath();
226
- if (!existsSync(configPath)) {
227
- console.log('Codex config 未找到:', configPath);
228
- console.log('请先运行 codex 完成初始化。');
229
- process.exit(1);
230
- }
231
-
232
- let raw: string;
233
- try { raw = readFileSync(configPath, 'utf-8'); } catch (e: any) {
234
- console.error('读取失败:', e?.message ?? e);
235
- process.exit(1);
236
- }
237
-
238
- if (/^\s*\[mcp_servers\.clawclaw\]/m.test(raw)) {
239
- console.log('[mcp_servers.clawclaw] 已存在于 config.toml。');
240
- process.exit(0);
241
- }
242
-
243
- const ts = new Date().toISOString().replace(/[:.]/g, '-');
244
- copyFileSync(configPath, `${configPath}.bak.${ts}`);
245
-
246
- const snippet = [
247
- '',
248
- '[mcp_servers.clawclaw]',
249
- `command = '${entry.command.replace(/\\/g, '\\\\')}'`,
250
- `args = ${JSON.stringify(entry.args)}`,
251
- 'startup_timeout_sec = 30',
252
- '',
253
- '[mcp_servers.clawclaw.env]',
254
- `CLAWCLAW_WS_URL = '${wsUrl}'`,
255
- '',
256
- ].join('\n');
257
- appendFileSync(configPath, snippet, 'utf-8');
258
-
259
- console.log(`已更新 ${configPath}(备份: config.toml.bak.${ts})`);
260
- console.log(`CLAWCLAW_WS_URL = ${wsUrl}`);
261
- console.log('');
262
- console.log('重启 Codex 后生效。可用工具:');
263
- console.log(' clawclaw_game_start / clawclaw_game_stop / clawclaw_game_status');
264
- console.log(' clawclaw_do / clawclaw_state / clawclaw_events / ...');
265
- });
266
- }
1
+ /**
2
+ * `ccl setup codex` — 使用 Codex 原生 `codex mcp add` 安装 ClawClaw MCP server
3
+ *
4
+ * 优先: codex mcp add clawclaw --env CLAWCLAW_WS_URL=... -- <启动命令>
5
+ * 回退: 直接写 ~/.codex/config.toml(codex 不可用时)
6
+ *
7
+ * 自动设置 CLAWCLAW_WS_URL,实现 clawclaw_game_start 零参数调用。
8
+ *
9
+ * 用法:
10
+ * ccl setup codex # dry-run 预览
11
+ * ccl setup codex -y # 应用(默认 ws://127.0.0.1:19997)
12
+ * ccl setup codex -y --ws-port 19998 # 指定端口
13
+ * ccl setup codex --print # 仅输出等价命令行
14
+ */
15
+
16
+ import { Command } from 'commander';
17
+ import { homedir } from 'os';
18
+ import { join } from 'path';
19
+ import { existsSync, readFileSync, appendFileSync, copyFileSync, readdirSync, statSync as fsStatSync } from 'fs';
20
+ import { spawnSync } from 'child_process';
21
+
22
+ // ─── 路径解析 ──────────────────────────────────────────────────
23
+
24
+ function resolveCodexConfigPath(): string {
25
+ const home = process.env.CODEX_HOME?.trim();
26
+ if (home) return join(home, 'config.toml');
27
+ return join(homedir(), '.codex', 'config.toml');
28
+ }
29
+
30
+ function resolveCodexClawclawEntry(): { command: string; args: string[] } | null {
31
+ const isWin = process.platform === 'win32';
32
+ const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
33
+
34
+ // 1. dist/mcp-server.js 优先(编译后的纯 JS,无 tsx stdout 污染,最可靠)
35
+ const distCandidates = [
36
+ join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'dist', 'mcp-server.js'),
37
+ join('D:', 'codex-clawclaw', 'dist', 'mcp-server.js'),
38
+ ];
39
+ for (const dist of distCandidates) {
40
+ try { if (existsSync(dist)) return { command: 'node', args: [dist] }; } catch { /* continue */ }
41
+ }
42
+
43
+ // 2. .mjs 包装器(bin/codex-clawclaw.mjs, 自注册 tsx, 直接 node 运行)
44
+ const mjsCandidates = [
45
+ join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
46
+ join('D:', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
47
+ ];
48
+ for (const mjs of mjsCandidates) {
49
+ try { if (existsSync(mjs)) return { command: process.execPath, args: [mjs] }; } catch { /* continue */ }
50
+ }
51
+
52
+ // 3. PATH 上找 bin(.cmd)
53
+ const cmdNames = isWin
54
+ ? ['codex-clawclaw.cmd', 'codex-clawclaw.ps1', 'codex-clawclaw']
55
+ : ['codex-clawclaw'];
56
+ const sep = isWin ? '\\' : '/';
57
+ const pathDirs = (process.env.PATH || '').split(isWin ? ';' : ':').filter(Boolean);
58
+ for (const dir of pathDirs) {
59
+ for (const name of cmdNames) {
60
+ const full = `${dir}${sep}${name}`;
61
+ try { if (existsSync(full)) return { command: full, args: [] }; } catch { /* continue */ }
62
+ }
63
+ }
64
+
65
+ // 4. 旧版路径(src/mcp-server.ts, 需搭配 tsx)
66
+ const tsCandidates = [
67
+ join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'src', 'mcp-server.ts'),
68
+ join('D:', 'codex-clawclaw', 'src', 'mcp-server.ts'),
69
+ ];
70
+ for (const ts of tsCandidates) {
71
+ try { if (existsSync(ts)) return { command: process.execPath, args: [resolveTsxCli(), ts] }; } catch { /* continue */ }
72
+ }
73
+
74
+ return null;
75
+ }
76
+
77
+ function resolveTsxCli(): string {
78
+ const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
79
+ const candidates = [
80
+ join(appData, 'npm', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
81
+ join('D:', 'codex-clawclaw', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
82
+ ];
83
+ for (const c of candidates) {
84
+ try { if (existsSync(c)) return c; } catch { /* continue */ }
85
+ }
86
+ return 'tsx';
87
+ }
88
+
89
+ /** 解析 codex CLI 的可执行文件路径(直接 .exe,不依赖 shell shim) */
90
+ function resolveCodexExe(): string | null {
91
+ // 1. 从 config.toml 读取 CODEX_CLI_PATH(ccl 自己的全局配置)
92
+ const configPath = join(homedir(), '.clawclaw', 'config.json');
93
+ try {
94
+ if (existsSync(configPath)) {
95
+ const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
96
+ if (cfg.codexCliPath && existsSync(cfg.codexCliPath)) return cfg.codexCliPath;
97
+ }
98
+ } catch { /* ignore */ }
99
+
100
+ // 2. 从 ~/.codex/config.toml 读取 CODEX_CLI_PATH 环境变量
101
+ // 搜索 AppData\Local\OpenAI\Codex\bin\ 下最新的 codex.exe
102
+ const appData = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
103
+ const codexBinDir = join(appData, 'OpenAI', 'Codex', 'bin');
104
+ try {
105
+ if (existsSync(codexBinDir)) {
106
+ const dirs = readdirSync(codexBinDir).filter((d: string) => {
107
+ try { return fsStatSync(join(codexBinDir, d)).isDirectory(); } catch { return false; }
108
+ }).sort().reverse(); // 最新版本优先
109
+ for (const d of dirs) {
110
+ const exe = join(codexBinDir, d, 'codex.exe');
111
+ try { if (existsSync(exe)) return exe; } catch { /* continue */ }
112
+ }
113
+ }
114
+ } catch { /* ignore */ }
115
+
116
+ // 3. PATH 上找 codex.cmd(Windows)
117
+ const pathDirs = (process.env.PATH || '').split(';').filter(Boolean);
118
+ for (const dir of pathDirs) {
119
+ const full = join(dir, 'codex.cmd');
120
+ try { if (existsSync(full)) return full; } catch { /* continue */ }
121
+ }
122
+
123
+ return null;
124
+ }
125
+
126
+ function codexMcpAvailable(): boolean {
127
+ const exe = resolveCodexExe();
128
+ if (!exe) return false;
129
+ try {
130
+ const r = spawnSync(exe, ['mcp', 'list', '--json'], {
131
+ env: { ...process.env, NO_COLOR: '1' },
132
+ windowsHide: true, timeout: 10_000, encoding: 'utf-8',
133
+ });
134
+ return r.status === 0;
135
+ } catch { return false; }
136
+ }
137
+
138
+ function codexMcpAlreadyRegistered(): boolean {
139
+ const exe = resolveCodexExe();
140
+ if (!exe) return false;
141
+ try {
142
+ const r = spawnSync(exe, ['mcp', 'list', '--json'], {
143
+ env: { ...process.env, NO_COLOR: '1' },
144
+ windowsHide: true, timeout: 10_000, encoding: 'utf-8',
145
+ });
146
+ if (r.status !== 0 || !r.stdout) return false;
147
+ const servers = JSON.parse(r.stdout);
148
+ return Array.isArray(servers) && servers.some((s: any) => s.name === 'clawclaw');
149
+ } catch { return false; }
150
+ }
151
+
152
+ // ─── Commander ─────────────────────────────────────────────────
153
+
154
+ export function createSetupCodexSubcommand(): Command {
155
+ return new Command('codex')
156
+ .description('使用 codex mcp add 安装 ClawClaw MCP server(自动配置 CLAWCLAW_WS_URL,实现零参数启动游戏)。')
157
+ .option('-y, --yes', '应用更改(默认 dry-run)')
158
+ .option('--print', '仅输出推荐命令')
159
+ .option('--ws-port <port>', 'app-server WebSocket 端口(默认 19997)', '19997')
160
+ .action((opts: { yes?: boolean; print?: boolean; wsPort?: string }) => {
161
+ const wsPort = opts.wsPort || '19997';
162
+ const wsUrl = `ws://127.0.0.1:${wsPort}`;
163
+ const entry = resolveCodexClawclawEntry();
164
+ if (!entry) {
165
+ console.log('未找到 codex-clawclaw。');
166
+ console.log('安装: npm install -g @myclaw163/codex-clawclaw --registry https://registry.npmmirror.com/');
167
+ console.log('本地开发: 在 codex-clawclaw 目录下 npm link');
168
+ process.exit(1);
169
+ }
170
+
171
+ const addArgs = ['mcp', 'add', 'clawclaw', '--env', `CLAWCLAW_WS_URL=${wsUrl}`, '--', entry.command, ...entry.args];
172
+
173
+ if (opts.print) {
174
+ console.log('# 推荐执行:');
175
+ console.log(`codex ${addArgs.join(' ')}`);
176
+ console.log('');
177
+ console.log('# 等价 config.toml:');
178
+ console.log('[mcp_servers.clawclaw]');
179
+ console.log(`command = '${entry.command.replace(/\\/g, '\\\\')}'`);
180
+ console.log(`args = ${JSON.stringify(entry.args)}`);
181
+ console.log('[mcp_servers.clawclaw.env]');
182
+ console.log(`CLAWCLAW_WS_URL = '${wsUrl}'`);
183
+ console.log('startup_timeout_sec = 30');
184
+ return;
185
+ }
186
+
187
+ if (codexMcpAvailable() && codexMcpAlreadyRegistered()) {
188
+ console.log(`ClawClaw MCP server 已注册(CLWCLAW_WS_URL=${wsUrl})。`);
189
+ process.exit(0);
190
+ }
191
+
192
+ if (!opts.yes) {
193
+ console.log('待执行:');
194
+ console.log(` codex ${addArgs.join(' ')}`);
195
+ if (!codexMcpAvailable()) {
196
+ console.log('');
197
+ console.log('(codex mcp 不可用,将回退到直接写 config.toml)');
198
+ }
199
+ console.log('');
200
+ console.log(`默认端口 ${wsPort},可用 --ws-port 指定。`);
201
+ console.log('Dry-run 模式。加 -y 以应用更改。');
202
+ process.exit(2);
203
+ }
204
+
205
+ // ── 应用: 优先 codex mcp add ──
206
+ if (codexMcpAvailable()) {
207
+ const r = spawnSync(resolveCodexExe()!, addArgs, {
208
+ env: { ...process.env, NO_COLOR: '1' },
209
+ windowsHide: true, timeout: 30_000, encoding: 'utf-8',
210
+ });
211
+ if (r.status !== 0) {
212
+ console.error('codex mcp add 失败:', r.stderr?.trim() || r.stdout?.trim() || `exit ${r.status}`);
213
+ process.exit(1);
214
+ }
215
+ console.log(`已注册 ClawClaw MCP server(CLAWCLAW_WS_URL=${wsUrl})。`);
216
+ console.log('');
217
+ console.log('下一步:');
218
+ console.log(` 1. codex app-server --listen ${wsUrl}`);
219
+ console.log(` 2. codex --remote ${wsUrl}`);
220
+ console.log(' 3. 在会话中说 开始一局龙虾杀(无需传参数)');
221
+ process.exit(0);
222
+ }
223
+
224
+ // ── 回退: 直接写 config.toml ──
225
+ const configPath = resolveCodexConfigPath();
226
+ if (!existsSync(configPath)) {
227
+ console.log('Codex config 未找到:', configPath);
228
+ console.log('请先运行 codex 完成初始化。');
229
+ process.exit(1);
230
+ }
231
+
232
+ let raw: string;
233
+ try { raw = readFileSync(configPath, 'utf-8'); } catch (e: any) {
234
+ console.error('读取失败:', e?.message ?? e);
235
+ process.exit(1);
236
+ }
237
+
238
+ if (/^\s*\[mcp_servers\.clawclaw\]/m.test(raw)) {
239
+ console.log('[mcp_servers.clawclaw] 已存在于 config.toml。');
240
+ process.exit(0);
241
+ }
242
+
243
+ const ts = new Date().toISOString().replace(/[:.]/g, '-');
244
+ copyFileSync(configPath, `${configPath}.bak.${ts}`);
245
+
246
+ const snippet = [
247
+ '',
248
+ '[mcp_servers.clawclaw]',
249
+ `command = '${entry.command.replace(/\\/g, '\\\\')}'`,
250
+ `args = ${JSON.stringify(entry.args)}`,
251
+ 'startup_timeout_sec = 30',
252
+ '',
253
+ '[mcp_servers.clawclaw.env]',
254
+ `CLAWCLAW_WS_URL = '${wsUrl}'`,
255
+ '',
256
+ ].join('\n');
257
+ appendFileSync(configPath, snippet, 'utf-8');
258
+
259
+ console.log(`已更新 ${configPath}(备份: config.toml.bak.${ts})`);
260
+ console.log(`CLAWCLAW_WS_URL = ${wsUrl}`);
261
+ console.log('');
262
+ console.log('重启 Codex 后生效。可用工具:');
263
+ console.log(' clawclaw_game_start / clawclaw_game_stop / clawclaw_game_status');
264
+ console.log(' clawclaw_do / clawclaw_state / clawclaw_events / ...');
265
+ });
266
+ }