@myclaw163/clawclaw-cli 0.6.56 → 0.6.58

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 (50) hide show
  1. package/bin/clawclaw-cli.mjs +3 -3
  2. package/package.json +1 -1
  3. package/scripts/sync-bundled-skill.mjs +1 -1
  4. package/skills/clawclaw/SKILL.md +7 -3
  5. package/skills/clawclaw/references/GAME-MECHANICS.md +5 -5
  6. package/skills/clawclaw/references/STREAM.md +4 -3
  7. package/src/cli.ts +0 -43
  8. package/src/commands/config.ts +30 -30
  9. package/src/commands/game-start-plan.test.ts +10 -68
  10. package/src/commands/game.ts +318 -173
  11. package/src/commands/history.ts +1 -1
  12. package/src/commands/peek.ts +16 -9
  13. package/src/commands/setup/codex.ts +248 -248
  14. package/src/commands/setup/hermes.test.ts +96 -96
  15. package/src/commands/setup/hermes.ts +76 -76
  16. package/src/commands/setup/index.ts +13 -13
  17. package/src/commands/setup/openclaw.test.ts +114 -114
  18. package/src/commands/setup/openclaw.ts +147 -147
  19. package/src/commands/strategy.ts +29 -38
  20. package/src/commands/watch.test.ts +7 -11
  21. package/src/commands/watch.ts +77 -66
  22. package/src/lib/game-client.ts +3 -3
  23. package/src/lib/host-config-patcher.test.ts +130 -130
  24. package/src/lib/host-config-patcher.ts +151 -151
  25. package/src/lib/hub-reminder.ts +19 -19
  26. package/src/lib/strategy-export.test.ts +1 -1
  27. package/src/runtime/event-daemon.test.ts +81 -2
  28. package/src/runtime/event-daemon.ts +325 -287
  29. package/src/runtime/owner-control.ts +150 -0
  30. package/src/runtime/runtime-logger.ts +11 -3
  31. package/src/runtime/ws-client.test.ts +57 -0
  32. package/src/runtime/ws-client.ts +2 -2
  33. package/src/sdk/index.ts +4 -4
  34. package/src/strategies/game-utils.test.ts +27 -1
  35. package/src/strategies/game-utils.ts +27 -4
  36. package/src/strategies/goals/crab-octopus-reflexes.ts +4 -4
  37. package/src/strategies/goals/crab-sabotage-top.ts +1 -1
  38. package/src/strategies/goals/keep-away-goal.ts +10 -7
  39. package/src/strategies/goals/kill-frenzy-top.ts +5 -5
  40. package/src/strategies/goals/kill-target-goal.ts +2 -2
  41. package/src/strategies/goals/kill-target-top.ts +2 -2
  42. package/src/strategies/goals/lone-kill-core.ts +3 -3
  43. package/src/strategies/goals/lone-kill-task-top.ts +1 -1
  44. package/src/strategies/goals/task-kill-report-top.ts +3 -3
  45. package/src/strategies/goals/warrior-shrimp-top.ts +2 -2
  46. package/src/strategies/pathfind/escape-planner.ts +10 -3
  47. package/src/strategies/spawn.ts +16 -5
  48. package/src/strategies/strategy-loop.ts +9 -3
  49. package/src/runtime/daemon.ts +0 -100
  50. package/src/runtime/opening-mover.ts +0 -303
@@ -521,7 +521,7 @@ function createPlayerHistorySubcommand(): Command {
521
521
  kind,
522
522
  error: {
523
523
  code: 'no_player_history',
524
- message: 'No player_spotted history yet. Join a game and wait for the event daemon to receive player_spotted events.',
524
+ message: 'No player_spotted history yet. Join a game and wait for the game runtime to receive player_spotted events.',
525
525
  },
526
526
  }, null, 2));
527
527
  return;
@@ -1,16 +1,15 @@
1
1
  import { Command } from 'commander';
2
- import { join } from 'path';
3
2
  import { AuthStore } from '../lib/auth.js';
4
3
  import { getProfileStateDir } from '../lib/init-command.js';
5
- import { snapshotOnce } from './watch.js';
4
+ import { sendOwnerControlRequest } from '../runtime/owner-control.js';
6
5
 
7
6
  export interface RunPeekOptions {
8
7
  stdout: (line: string) => void;
9
8
  stderr?: (line: string) => void;
10
9
  }
11
10
 
12
- /** One-shot snapshot of the local feed.json. Returns process exit code. */
13
- export function runPeek(opts: RunPeekOptions): number {
11
+ /** One-shot snapshot of the active game owner. Returns process exit code. */
12
+ export async function runPeek(opts: RunPeekOptions): Promise<number> {
14
13
  const stderr = opts.stderr ?? ((s) => process.stderr.write(s));
15
14
  const store = new AuthStore();
16
15
  const profile = store.getActive();
@@ -18,9 +17,17 @@ export function runPeek(opts: RunPeekOptions): number {
18
17
  opts.stdout(JSON.stringify({ exit_reason: ['not_logged_in'], error: 'Not logged in' }) + '\n');
19
18
  return 0;
20
19
  }
21
- const feedPath = join(getProfileStateDir(profile), 'feed.json');
22
20
  try {
23
- snapshotOnce({ feedPath, stdout: opts.stdout });
21
+ const response = await sendOwnerControlRequest(getProfileStateDir(profile), 'snapshot');
22
+ if (!response?.ok) {
23
+ throw new Error('ccl game runtime is not running. Start it first with `ccl game start`.');
24
+ }
25
+ opts.stdout(JSON.stringify({
26
+ exit_reason: ['snapshot'],
27
+ next_step: 'One-shot snapshot. No further events will follow from this invocation.',
28
+ events: [],
29
+ summary: response.summary ?? null,
30
+ }) + '\n');
24
31
  return 0;
25
32
  } catch (err: any) {
26
33
  stderr((err?.message ?? String(err)) + '\n');
@@ -30,9 +37,9 @@ export function runPeek(opts: RunPeekOptions): number {
30
37
 
31
38
  export function createPeekCommand(): Command {
32
39
  return new Command('peek')
33
- .description('Print a one-shot snapshot of current game state from the local feed (no HTTP, no streaming). Pairs with `ccl game start` for live updates and `ccl events` for history.')
34
- .action(() => {
35
- const code = runPeek({ stdout: (s) => process.stdout.write(s) });
40
+ .description('Print a one-shot snapshot from the active game owner. Pairs with `ccl game start` for live updates and `ccl events` for history.')
41
+ .action(async () => {
42
+ const code = await runPeek({ stdout: (s) => process.stdout.write(s) });
36
43
  if (code !== 0) process.exit(code);
37
44
  });
38
45
  }
@@ -1,248 +1,248 @@
1
- /**
2
- * `ccl setup codex` — 使用 Codex 原生 `codex mcp add` 安装 ClawClaw MCP server
3
- *
4
- * 优先: codex mcp add clawclaw -- <启动命令>
5
- * 回退: 直接写 ~/.codex/config.toml(codex 不可用时)
6
- *
7
- * 用法:
8
- * ccl setup codex # dry-run 预览
9
- * ccl setup codex -y # 应用
10
- * ccl setup codex --print # 仅输出等价命令行
11
- */
12
-
13
- import { Command } from 'commander';
14
- import { homedir } from 'os';
15
- import { join } from 'path';
16
- import { existsSync, readFileSync, appendFileSync, copyFileSync, readdirSync, statSync as fsStatSync } from 'fs';
17
- import { spawnSync } from 'child_process';
18
-
19
- // ─── 路径解析 ──────────────────────────────────────────────────
20
-
21
- function resolveCodexConfigPath(): string {
22
- const home = process.env.CODEX_HOME?.trim();
23
- if (home) return join(home, 'config.toml');
24
- return join(homedir(), '.codex', 'config.toml');
25
- }
26
-
27
- function resolveCodexClawclawEntry(): { command: string; args: string[] } | null {
28
- const isWin = process.platform === 'win32';
29
- const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
30
-
31
- // 1. dist/mcp-server.js 优先(编译后的纯 JS,无 tsx stdout 污染,最可靠)
32
- const distCandidates = [
33
- join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'dist', 'mcp-server.js'),
34
- join('D:', 'codex-clawclaw', 'dist', 'mcp-server.js'),
35
- ];
36
- for (const dist of distCandidates) {
37
- try { if (existsSync(dist)) return { command: 'node', args: [dist] }; } catch { /* continue */ }
38
- }
39
-
40
- // 2. .mjs 包装器(bin/codex-clawclaw.mjs, 自注册 tsx, 直接 node 运行)
41
- const mjsCandidates = [
42
- join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
43
- join('D:', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
44
- ];
45
- for (const mjs of mjsCandidates) {
46
- try { if (existsSync(mjs)) return { command: process.execPath, args: [mjs] }; } catch { /* continue */ }
47
- }
48
-
49
- // 3. PATH 上找 bin(.cmd)
50
- const cmdNames = isWin
51
- ? ['codex-clawclaw.cmd', 'codex-clawclaw.ps1', 'codex-clawclaw']
52
- : ['codex-clawclaw'];
53
- const sep = isWin ? '\\' : '/';
54
- const pathDirs = (process.env.PATH || '').split(isWin ? ';' : ':').filter(Boolean);
55
- for (const dir of pathDirs) {
56
- for (const name of cmdNames) {
57
- const full = `${dir}${sep}${name}`;
58
- try { if (existsSync(full)) return { command: full, args: [] }; } catch { /* continue */ }
59
- }
60
- }
61
-
62
- // 4. 旧版路径(src/mcp-server.ts, 需搭配 tsx)
63
- const tsCandidates = [
64
- join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'src', 'mcp-server.ts'),
65
- join('D:', 'codex-clawclaw', 'src', 'mcp-server.ts'),
66
- ];
67
- for (const ts of tsCandidates) {
68
- try { if (existsSync(ts)) return { command: process.execPath, args: [resolveTsxCli(), ts] }; } catch { /* continue */ }
69
- }
70
-
71
- return null;
72
- }
73
-
74
- function resolveTsxCli(): string {
75
- const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
76
- const candidates = [
77
- join(appData, 'npm', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
78
- join('D:', 'codex-clawclaw', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
79
- ];
80
- for (const c of candidates) {
81
- try { if (existsSync(c)) return c; } catch { /* continue */ }
82
- }
83
- return 'tsx';
84
- }
85
-
86
- /** 解析 codex CLI 的可执行文件路径(直接 .exe,不依赖 shell shim) */
87
- function resolveCodexExe(): string | null {
88
- // 1. 从 config.toml 读取 CODEX_CLI_PATH(ccl 自己的全局配置)
89
- const configPath = join(homedir(), '.clawclaw', 'config.json');
90
- try {
91
- if (existsSync(configPath)) {
92
- const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
93
- if (cfg.codexCliPath && existsSync(cfg.codexCliPath)) return cfg.codexCliPath;
94
- }
95
- } catch { /* ignore */ }
96
-
97
- // 2. 从 ~/.codex/config.toml 读取 CODEX_CLI_PATH 环境变量
98
- // 搜索 AppData\Local\OpenAI\Codex\bin\ 下最新的 codex.exe
99
- const appData = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
100
- const codexBinDir = join(appData, 'OpenAI', 'Codex', 'bin');
101
- try {
102
- if (existsSync(codexBinDir)) {
103
- const dirs = readdirSync(codexBinDir).filter((d: string) => {
104
- try { return fsStatSync(join(codexBinDir, d)).isDirectory(); } catch { return false; }
105
- }).sort().reverse(); // 最新版本优先
106
- for (const d of dirs) {
107
- const exe = join(codexBinDir, d, 'codex.exe');
108
- try { if (existsSync(exe)) return exe; } catch { /* continue */ }
109
- }
110
- }
111
- } catch { /* ignore */ }
112
-
113
- // 3. PATH 上找 codex.cmd(Windows)
114
- const pathDirs = (process.env.PATH || '').split(';').filter(Boolean);
115
- for (const dir of pathDirs) {
116
- const full = join(dir, 'codex.cmd');
117
- try { if (existsSync(full)) return full; } catch { /* continue */ }
118
- }
119
-
120
- return null;
121
- }
122
-
123
- function codexMcpAvailable(): boolean {
124
- const exe = resolveCodexExe();
125
- if (!exe) return false;
126
- try {
127
- const r = spawnSync(exe, ['mcp', 'list', '--json'], {
128
- env: { ...process.env, NO_COLOR: '1' },
129
- windowsHide: true, timeout: 10_000, encoding: 'utf-8',
130
- });
131
- return r.status === 0;
132
- } catch { return false; }
133
- }
134
-
135
- function codexMcpAlreadyRegistered(): boolean {
136
- const exe = resolveCodexExe();
137
- if (!exe) return false;
138
- try {
139
- const r = spawnSync(exe, ['mcp', 'list', '--json'], {
140
- env: { ...process.env, NO_COLOR: '1' },
141
- windowsHide: true, timeout: 10_000, encoding: 'utf-8',
142
- });
143
- if (r.status !== 0 || !r.stdout) return false;
144
- const servers = JSON.parse(r.stdout);
145
- return Array.isArray(servers) && servers.some((s: any) => s.name === 'clawclaw');
146
- } catch { return false; }
147
- }
148
-
149
- // ─── Commander ─────────────────────────────────────────────────
150
-
151
- export function createSetupCodexSubcommand(): Command {
152
- return new Command('codex')
153
- .description('使用 codex mcp add 安装 ClawClaw MCP server(codex 不可用时回退到写 config.toml)。')
154
- .option('-y, --yes', '应用更改(默认 dry-run)')
155
- .option('--print', '仅输出推荐命令')
156
- .action((opts: { yes?: boolean; print?: boolean }) => {
157
- const entry = resolveCodexClawclawEntry();
158
- if (!entry) {
159
- console.log('未找到 codex-clawclaw。');
160
- console.log('发布后: npm install -g codex-clawclaw');
161
- console.log('本地开发: 在 codex-clawclaw 目录下 npm link');
162
- process.exit(1);
163
- }
164
-
165
- const addArgs = ['mcp', 'add', 'clawclaw', '--', entry.command, ...entry.args];
166
-
167
- if (opts.print) {
168
- console.log('# 推荐执行:');
169
- console.log(`codex ${addArgs.join(' ')}`);
170
- console.log('');
171
- console.log('# 等价 config.toml:');
172
- console.log('[mcp_servers.clawclaw]');
173
- console.log(`command = '${entry.command.replace(/\\/g, '\\\\')}'`);
174
- console.log(`args = ${JSON.stringify(entry.args)}`);
175
- console.log('startup_timeout_sec = 30');
176
- return;
177
- }
178
-
179
- if (codexMcpAvailable() && codexMcpAlreadyRegistered()) {
180
- console.log('ClawClaw MCP server 已注册。');
181
- process.exit(0);
182
- }
183
-
184
- if (!opts.yes) {
185
- console.log('待执行:');
186
- console.log(` codex ${addArgs.join(' ')}`);
187
- if (!codexMcpAvailable()) {
188
- console.log('');
189
- console.log('(codex mcp 不可用,将回退到直接写 config.toml)');
190
- }
191
- console.log('');
192
- console.log('Dry-run 模式。加 -y 以应用更改。');
193
- process.exit(2);
194
- }
195
-
196
- // ── 应用: 优先 codex mcp add ──
197
- if (codexMcpAvailable()) {
198
- const r = spawnSync(resolveCodexExe()!, addArgs, {
199
- env: { ...process.env, NO_COLOR: '1' },
200
- windowsHide: true, timeout: 30_000, encoding: 'utf-8',
201
- });
202
- if (r.status !== 0) {
203
- console.error('codex mcp add 失败:', r.stderr?.trim() || r.stdout?.trim() || `exit ${r.status}`);
204
- process.exit(1);
205
- }
206
- console.log('已注册 ClawClaw MCP server(无需重启 Codex)。');
207
- process.exit(0);
208
- }
209
-
210
- // ── 回退: 直接写 config.toml ──
211
- const configPath = resolveCodexConfigPath();
212
- if (!existsSync(configPath)) {
213
- console.log('Codex config 未找到:', configPath);
214
- console.log('请先运行 codex 完成初始化。');
215
- process.exit(1);
216
- }
217
-
218
- let raw: string;
219
- try { raw = readFileSync(configPath, 'utf-8'); } catch (e: any) {
220
- console.error('读取失败:', e?.message ?? e);
221
- process.exit(1);
222
- }
223
-
224
- if (/^\s*\[mcp_servers\.clawclaw\]/m.test(raw)) {
225
- console.log('[mcp_servers.clawclaw] 已存在于 config.toml。');
226
- process.exit(0);
227
- }
228
-
229
- const ts = new Date().toISOString().replace(/[:.]/g, '-');
230
- copyFileSync(configPath, `${configPath}.bak.${ts}`);
231
-
232
- const snippet = [
233
- '',
234
- '[mcp_servers.clawclaw]',
235
- `command = '${entry.command.replace(/\\/g, '\\\\')}'`,
236
- `args = ${JSON.stringify(entry.args)}`,
237
- 'startup_timeout_sec = 30',
238
- '',
239
- ].join('\n');
240
- appendFileSync(configPath, snippet, 'utf-8');
241
-
242
- console.log(`已更新 ${configPath}(备份: config.toml.bak.${ts})`);
243
- console.log('');
244
- console.log('重启 Codex 后生效。可用工具:');
245
- console.log(' clawclaw_game_start / clawclaw_game_stop / clawclaw_game_status');
246
- console.log(' clawclaw_do / clawclaw_state / clawclaw_events / ...');
247
- });
248
- }
1
+ /**
2
+ * `ccl setup codex` — 使用 Codex 原生 `codex mcp add` 安装 ClawClaw MCP server
3
+ *
4
+ * 优先: codex mcp add clawclaw -- <启动命令>
5
+ * 回退: 直接写 ~/.codex/config.toml(codex 不可用时)
6
+ *
7
+ * 用法:
8
+ * ccl setup codex # dry-run 预览
9
+ * ccl setup codex -y # 应用
10
+ * ccl setup codex --print # 仅输出等价命令行
11
+ */
12
+
13
+ import { Command } from 'commander';
14
+ import { homedir } from 'os';
15
+ import { join } from 'path';
16
+ import { existsSync, readFileSync, appendFileSync, copyFileSync, readdirSync, statSync as fsStatSync } from 'fs';
17
+ import { spawnSync } from 'child_process';
18
+
19
+ // ─── 路径解析 ──────────────────────────────────────────────────
20
+
21
+ function resolveCodexConfigPath(): string {
22
+ const home = process.env.CODEX_HOME?.trim();
23
+ if (home) return join(home, 'config.toml');
24
+ return join(homedir(), '.codex', 'config.toml');
25
+ }
26
+
27
+ function resolveCodexClawclawEntry(): { command: string; args: string[] } | null {
28
+ const isWin = process.platform === 'win32';
29
+ const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
30
+
31
+ // 1. dist/mcp-server.js 优先(编译后的纯 JS,无 tsx stdout 污染,最可靠)
32
+ const distCandidates = [
33
+ join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'dist', 'mcp-server.js'),
34
+ join('D:', 'codex-clawclaw', 'dist', 'mcp-server.js'),
35
+ ];
36
+ for (const dist of distCandidates) {
37
+ try { if (existsSync(dist)) return { command: 'node', args: [dist] }; } catch { /* continue */ }
38
+ }
39
+
40
+ // 2. .mjs 包装器(bin/codex-clawclaw.mjs, 自注册 tsx, 直接 node 运行)
41
+ const mjsCandidates = [
42
+ join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
43
+ join('D:', 'codex-clawclaw', 'bin', 'codex-clawclaw.mjs'),
44
+ ];
45
+ for (const mjs of mjsCandidates) {
46
+ try { if (existsSync(mjs)) return { command: process.execPath, args: [mjs] }; } catch { /* continue */ }
47
+ }
48
+
49
+ // 3. PATH 上找 bin(.cmd)
50
+ const cmdNames = isWin
51
+ ? ['codex-clawclaw.cmd', 'codex-clawclaw.ps1', 'codex-clawclaw']
52
+ : ['codex-clawclaw'];
53
+ const sep = isWin ? '\\' : '/';
54
+ const pathDirs = (process.env.PATH || '').split(isWin ? ';' : ':').filter(Boolean);
55
+ for (const dir of pathDirs) {
56
+ for (const name of cmdNames) {
57
+ const full = `${dir}${sep}${name}`;
58
+ try { if (existsSync(full)) return { command: full, args: [] }; } catch { /* continue */ }
59
+ }
60
+ }
61
+
62
+ // 4. 旧版路径(src/mcp-server.ts, 需搭配 tsx)
63
+ const tsCandidates = [
64
+ join(appData, 'npm', 'node_modules', 'codex-clawclaw', 'src', 'mcp-server.ts'),
65
+ join('D:', 'codex-clawclaw', 'src', 'mcp-server.ts'),
66
+ ];
67
+ for (const ts of tsCandidates) {
68
+ try { if (existsSync(ts)) return { command: process.execPath, args: [resolveTsxCli(), ts] }; } catch { /* continue */ }
69
+ }
70
+
71
+ return null;
72
+ }
73
+
74
+ function resolveTsxCli(): string {
75
+ const appData = process.env.APPDATA || join(homedir(), 'AppData', 'Roaming');
76
+ const candidates = [
77
+ join(appData, 'npm', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
78
+ join('D:', 'codex-clawclaw', 'node_modules', 'tsx', 'dist', 'cli.mjs'),
79
+ ];
80
+ for (const c of candidates) {
81
+ try { if (existsSync(c)) return c; } catch { /* continue */ }
82
+ }
83
+ return 'tsx';
84
+ }
85
+
86
+ /** 解析 codex CLI 的可执行文件路径(直接 .exe,不依赖 shell shim) */
87
+ function resolveCodexExe(): string | null {
88
+ // 1. 从 config.toml 读取 CODEX_CLI_PATH(ccl 自己的全局配置)
89
+ const configPath = join(homedir(), '.clawclaw', 'config.json');
90
+ try {
91
+ if (existsSync(configPath)) {
92
+ const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
93
+ if (cfg.codexCliPath && existsSync(cfg.codexCliPath)) return cfg.codexCliPath;
94
+ }
95
+ } catch { /* ignore */ }
96
+
97
+ // 2. 从 ~/.codex/config.toml 读取 CODEX_CLI_PATH 环境变量
98
+ // 搜索 AppData\Local\OpenAI\Codex\bin\ 下最新的 codex.exe
99
+ const appData = process.env.LOCALAPPDATA || join(homedir(), 'AppData', 'Local');
100
+ const codexBinDir = join(appData, 'OpenAI', 'Codex', 'bin');
101
+ try {
102
+ if (existsSync(codexBinDir)) {
103
+ const dirs = readdirSync(codexBinDir).filter((d: string) => {
104
+ try { return fsStatSync(join(codexBinDir, d)).isDirectory(); } catch { return false; }
105
+ }).sort().reverse(); // 最新版本优先
106
+ for (const d of dirs) {
107
+ const exe = join(codexBinDir, d, 'codex.exe');
108
+ try { if (existsSync(exe)) return exe; } catch { /* continue */ }
109
+ }
110
+ }
111
+ } catch { /* ignore */ }
112
+
113
+ // 3. PATH 上找 codex.cmd(Windows)
114
+ const pathDirs = (process.env.PATH || '').split(';').filter(Boolean);
115
+ for (const dir of pathDirs) {
116
+ const full = join(dir, 'codex.cmd');
117
+ try { if (existsSync(full)) return full; } catch { /* continue */ }
118
+ }
119
+
120
+ return null;
121
+ }
122
+
123
+ function codexMcpAvailable(): boolean {
124
+ const exe = resolveCodexExe();
125
+ if (!exe) return false;
126
+ try {
127
+ const r = spawnSync(exe, ['mcp', 'list', '--json'], {
128
+ env: { ...process.env, NO_COLOR: '1' },
129
+ windowsHide: true, timeout: 10_000, encoding: 'utf-8',
130
+ });
131
+ return r.status === 0;
132
+ } catch { return false; }
133
+ }
134
+
135
+ function codexMcpAlreadyRegistered(): boolean {
136
+ const exe = resolveCodexExe();
137
+ if (!exe) return false;
138
+ try {
139
+ const r = spawnSync(exe, ['mcp', 'list', '--json'], {
140
+ env: { ...process.env, NO_COLOR: '1' },
141
+ windowsHide: true, timeout: 10_000, encoding: 'utf-8',
142
+ });
143
+ if (r.status !== 0 || !r.stdout) return false;
144
+ const servers = JSON.parse(r.stdout);
145
+ return Array.isArray(servers) && servers.some((s: any) => s.name === 'clawclaw');
146
+ } catch { return false; }
147
+ }
148
+
149
+ // ─── Commander ─────────────────────────────────────────────────
150
+
151
+ export function createSetupCodexSubcommand(): Command {
152
+ return new Command('codex')
153
+ .description('使用 codex mcp add 安装 ClawClaw MCP server(codex 不可用时回退到写 config.toml)。')
154
+ .option('-y, --yes', '应用更改(默认 dry-run)')
155
+ .option('--print', '仅输出推荐命令')
156
+ .action((opts: { yes?: boolean; print?: boolean }) => {
157
+ const entry = resolveCodexClawclawEntry();
158
+ if (!entry) {
159
+ console.log('未找到 codex-clawclaw。');
160
+ console.log('发布后: npm install -g codex-clawclaw');
161
+ console.log('本地开发: 在 codex-clawclaw 目录下 npm link');
162
+ process.exit(1);
163
+ }
164
+
165
+ const addArgs = ['mcp', 'add', 'clawclaw', '--', entry.command, ...entry.args];
166
+
167
+ if (opts.print) {
168
+ console.log('# 推荐执行:');
169
+ console.log(`codex ${addArgs.join(' ')}`);
170
+ console.log('');
171
+ console.log('# 等价 config.toml:');
172
+ console.log('[mcp_servers.clawclaw]');
173
+ console.log(`command = '${entry.command.replace(/\\/g, '\\\\')}'`);
174
+ console.log(`args = ${JSON.stringify(entry.args)}`);
175
+ console.log('startup_timeout_sec = 30');
176
+ return;
177
+ }
178
+
179
+ if (codexMcpAvailable() && codexMcpAlreadyRegistered()) {
180
+ console.log('ClawClaw MCP server 已注册。');
181
+ process.exit(0);
182
+ }
183
+
184
+ if (!opts.yes) {
185
+ console.log('待执行:');
186
+ console.log(` codex ${addArgs.join(' ')}`);
187
+ if (!codexMcpAvailable()) {
188
+ console.log('');
189
+ console.log('(codex mcp 不可用,将回退到直接写 config.toml)');
190
+ }
191
+ console.log('');
192
+ console.log('Dry-run 模式。加 -y 以应用更改。');
193
+ process.exit(2);
194
+ }
195
+
196
+ // ── 应用: 优先 codex mcp add ──
197
+ if (codexMcpAvailable()) {
198
+ const r = spawnSync(resolveCodexExe()!, addArgs, {
199
+ env: { ...process.env, NO_COLOR: '1' },
200
+ windowsHide: true, timeout: 30_000, encoding: 'utf-8',
201
+ });
202
+ if (r.status !== 0) {
203
+ console.error('codex mcp add 失败:', r.stderr?.trim() || r.stdout?.trim() || `exit ${r.status}`);
204
+ process.exit(1);
205
+ }
206
+ console.log('已注册 ClawClaw MCP server(无需重启 Codex)。');
207
+ process.exit(0);
208
+ }
209
+
210
+ // ── 回退: 直接写 config.toml ──
211
+ const configPath = resolveCodexConfigPath();
212
+ if (!existsSync(configPath)) {
213
+ console.log('Codex config 未找到:', configPath);
214
+ console.log('请先运行 codex 完成初始化。');
215
+ process.exit(1);
216
+ }
217
+
218
+ let raw: string;
219
+ try { raw = readFileSync(configPath, 'utf-8'); } catch (e: any) {
220
+ console.error('读取失败:', e?.message ?? e);
221
+ process.exit(1);
222
+ }
223
+
224
+ if (/^\s*\[mcp_servers\.clawclaw\]/m.test(raw)) {
225
+ console.log('[mcp_servers.clawclaw] 已存在于 config.toml。');
226
+ process.exit(0);
227
+ }
228
+
229
+ const ts = new Date().toISOString().replace(/[:.]/g, '-');
230
+ copyFileSync(configPath, `${configPath}.bak.${ts}`);
231
+
232
+ const snippet = [
233
+ '',
234
+ '[mcp_servers.clawclaw]',
235
+ `command = '${entry.command.replace(/\\/g, '\\\\')}'`,
236
+ `args = ${JSON.stringify(entry.args)}`,
237
+ 'startup_timeout_sec = 30',
238
+ '',
239
+ ].join('\n');
240
+ appendFileSync(configPath, snippet, 'utf-8');
241
+
242
+ console.log(`已更新 ${configPath}(备份: config.toml.bak.${ts})`);
243
+ console.log('');
244
+ console.log('重启 Codex 后生效。可用工具:');
245
+ console.log(' clawclaw_game_start / clawclaw_game_stop / clawclaw_game_status');
246
+ console.log(' clawclaw_do / clawclaw_state / clawclaw_events / ...');
247
+ });
248
+ }