@myclaw163/clawclaw-cli 0.6.76 → 0.6.77

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 (209) hide show
  1. package/README.md +387 -387
  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/check-skill-command-surface.mjs +116 -116
  10. package/scripts/find-hide-spots.py +157 -157
  11. package/scripts/postinstall.mjs +20 -20
  12. package/scripts/sync-bundled-skill.mjs +254 -245
  13. package/scripts/sync-bundled-skill.test.mjs +152 -152
  14. package/skills/clawclaw/SKILL.md +248 -248
  15. package/skills/clawclaw/references/CHATTERBOX.md +141 -141
  16. package/skills/clawclaw/references/COMMANDS.md +160 -160
  17. package/skills/clawclaw/references/GAME-MECHANICS.md +188 -188
  18. package/skills/clawclaw/references/HUB.md +48 -48
  19. package/skills/clawclaw/references/KNOWLEDGE.md +42 -42
  20. package/skills/clawclaw/references/STRATEGIES.md +59 -59
  21. package/skills/clawclaw/references/STREAM.md +93 -93
  22. package/skills/clawclaw/references/TACTICS.md +65 -65
  23. package/src/assets/clawclaw-ascii-map.txt +40 -40
  24. package/src/cli.ts +112 -112
  25. package/src/commands/_schema.ts +124 -124
  26. package/src/commands/account.ts +209 -209
  27. package/src/commands/data.test.ts +33 -33
  28. package/src/commands/data.ts +22 -22
  29. package/src/commands/do.test.ts +84 -84
  30. package/src/commands/do.ts +130 -130
  31. package/src/commands/events.test.ts +100 -100
  32. package/src/commands/events.ts +250 -250
  33. package/src/commands/game-map.test.ts +28 -28
  34. package/src/commands/game-start-plan.test.ts +84 -84
  35. package/src/commands/game.ts +1113 -1113
  36. package/src/commands/history-player.test.ts +102 -102
  37. package/src/commands/history.ts +573 -573
  38. package/src/commands/hub.test.ts +96 -96
  39. package/src/commands/hub.ts +234 -234
  40. package/src/commands/knowledge.test.ts +13 -13
  41. package/src/commands/knowledge.ts +139 -139
  42. package/src/commands/load.test.ts +51 -51
  43. package/src/commands/load.ts +13 -13
  44. package/src/commands/meeting-history.test.ts +106 -106
  45. package/src/commands/memory.ts +40 -40
  46. package/src/commands/peek.ts +45 -45
  47. package/src/commands/persona.ts +57 -57
  48. package/src/commands/setup/codex.ts +266 -266
  49. package/src/commands/skill.ts +128 -128
  50. package/src/commands/state.ts +46 -46
  51. package/src/commands/strategy.test.ts +153 -153
  52. package/src/commands/strategy.ts +183 -183
  53. package/src/commands/tts.ts +128 -128
  54. package/src/commands/upgrade.test.ts +82 -82
  55. package/src/commands/upgrade.ts +148 -148
  56. package/src/commands/watch.test.ts +999 -999
  57. package/src/commands/watch.ts +660 -660
  58. package/src/lib/auth.test.ts +86 -86
  59. package/src/lib/auth.ts +223 -223
  60. package/src/lib/command-meta.ts +37 -37
  61. package/src/lib/game-client.ts +403 -403
  62. package/src/lib/game-context.ts +92 -92
  63. package/src/lib/http-keepalive.ts +15 -15
  64. package/src/lib/http-transport.test.ts +42 -42
  65. package/src/lib/http-transport.ts +113 -113
  66. package/src/lib/hub-client.test.ts +56 -56
  67. package/src/lib/hub-client.ts +88 -88
  68. package/src/lib/hub-install.test.ts +98 -98
  69. package/src/lib/hub-install.ts +160 -160
  70. package/src/lib/hub-reminder.ts +78 -78
  71. package/src/lib/hub-unzip.test.ts +69 -69
  72. package/src/lib/hub-unzip.ts +62 -62
  73. package/src/lib/init-command.test.ts +75 -75
  74. package/src/lib/init-command.ts +130 -130
  75. package/src/lib/knowledge-store.test.ts +170 -170
  76. package/src/lib/knowledge-store.ts +369 -369
  77. package/src/lib/load-context.test.ts +52 -52
  78. package/src/lib/load-context.ts +52 -52
  79. package/src/lib/match-state.test.ts +134 -134
  80. package/src/lib/match-state.ts +94 -94
  81. package/src/lib/netease-tts.ts +83 -83
  82. package/src/lib/normalize.ts +42 -42
  83. package/src/lib/persona.test.ts +41 -41
  84. package/src/lib/persona.ts +72 -72
  85. package/src/lib/server-registry.ts +152 -152
  86. package/src/lib/skill-version.test.ts +48 -48
  87. package/src/lib/skill-version.ts +19 -19
  88. package/src/lib/strategy-export.test.ts +240 -240
  89. package/src/lib/strategy-export.ts +247 -247
  90. package/src/lib/tts-keys.ts +7 -7
  91. package/src/lib/tts-speech.test.ts +63 -63
  92. package/src/lib/tts-speech.ts +76 -76
  93. package/src/lib/user-data.test.ts +96 -96
  94. package/src/lib/user-data.ts +400 -400
  95. package/src/lib/workspace-argv.test.ts +49 -49
  96. package/src/lib/workspace-argv.ts +44 -44
  97. package/src/perception/player-history-store.test.ts +87 -87
  98. package/src/perception/player-history-store.ts +194 -194
  99. package/src/pipeline/event-format.test.ts +243 -243
  100. package/src/pipeline/event-format.ts +501 -501
  101. package/src/pipeline/event-hints.ts +195 -195
  102. package/src/pipeline/event-store.test.ts +28 -28
  103. package/src/pipeline/event-store.ts +193 -193
  104. package/src/pipeline/pipeline.ts +35 -35
  105. package/src/pipeline/player-projection.test.ts +168 -168
  106. package/src/pipeline/player-projection.ts +370 -370
  107. package/src/runtime/auto-upgrade.test.ts +66 -66
  108. package/src/runtime/auto-upgrade.ts +31 -31
  109. package/src/runtime/event-daemon.test.ts +209 -209
  110. package/src/runtime/event-daemon.ts +519 -519
  111. package/src/runtime/owner-control.ts +150 -150
  112. package/src/runtime/raw-ws-log.test.ts +33 -33
  113. package/src/runtime/raw-ws-log.ts +32 -32
  114. package/src/runtime/runtime-logger.ts +107 -107
  115. package/src/runtime/ws-client.test.ts +125 -125
  116. package/src/runtime/ws-client.ts +287 -287
  117. package/src/sdk/action.ts +166 -166
  118. package/src/sdk/index.ts +110 -110
  119. package/src/sdk/types.ts +161 -161
  120. package/src/strategies/avoid-lone.ts +12 -12
  121. package/src/strategies/avoid-players.knowledge.md +19 -19
  122. package/src/strategies/avoid-players.ts +16 -16
  123. package/src/strategies/corpse-patrol.ts +23 -23
  124. package/src/strategies/crab-sabotage.ts +22 -22
  125. package/src/strategies/custom-module.test.ts +270 -270
  126. package/src/strategies/find-player.ts +17 -17
  127. package/src/strategies/game-utils.test.ts +242 -242
  128. package/src/strategies/game-utils.ts +846 -846
  129. package/src/strategies/goals/anchor-linger.ts +77 -77
  130. package/src/strategies/goals/avoid-lone-top.ts +168 -168
  131. package/src/strategies/goals/avoid-players-top.test.ts +83 -83
  132. package/src/strategies/goals/avoid-players-top.ts +121 -121
  133. package/src/strategies/goals/conversation-goal.ts +51 -51
  134. package/src/strategies/goals/corpse-patrol-top.ts +113 -113
  135. package/src/strategies/goals/crab-octopus-reflexes.ts +101 -101
  136. package/src/strategies/goals/crab-sabotage-top.ts +197 -197
  137. package/src/strategies/goals/emergency-hunt-goal.ts +28 -28
  138. package/src/strategies/goals/find-player-top.ts +93 -93
  139. package/src/strategies/goals/flee-players-goal.ts +53 -53
  140. package/src/strategies/goals/follow-companion-goal.ts +106 -106
  141. package/src/strategies/goals/goal-manager.ts +41 -41
  142. package/src/strategies/goals/goal-root-strategy.ts +49 -49
  143. package/src/strategies/goals/goal.ts +28 -28
  144. package/src/strategies/goals/hide-top.ts +197 -197
  145. package/src/strategies/goals/keep-away-goal.ts +221 -221
  146. package/src/strategies/goals/kill-frenzy-top.ts +80 -80
  147. package/src/strategies/goals/kill-lone-top.ts +160 -160
  148. package/src/strategies/goals/kill-target-goal.ts +59 -59
  149. package/src/strategies/goals/kill-target-top.ts +109 -109
  150. package/src/strategies/goals/leaf-goal.ts +27 -27
  151. package/src/strategies/goals/linger-corpse-goal.ts +35 -35
  152. package/src/strategies/goals/lone-kill-core.ts +82 -82
  153. package/src/strategies/goals/lone-kill-goal.ts +24 -24
  154. package/src/strategies/goals/lone-kill-task-top.test.ts +85 -85
  155. package/src/strategies/goals/lone-kill-task-top.ts +133 -133
  156. package/src/strategies/goals/move-room-goal.ts +60 -60
  157. package/src/strategies/goals/normal-shrimp-top.test.ts +80 -80
  158. package/src/strategies/goals/normal-shrimp-top.ts +242 -242
  159. package/src/strategies/goals/paradise-fish-top.test.ts +126 -126
  160. package/src/strategies/goals/paradise-fish-top.ts +224 -224
  161. package/src/strategies/goals/patrol-top.ts +57 -57
  162. package/src/strategies/goals/report-patrol-top.ts +80 -80
  163. package/src/strategies/goals/safe-task-goal.ts +102 -102
  164. package/src/strategies/goals/social-task-top.ts +161 -161
  165. package/src/strategies/goals/task-kill-report-top.ts +163 -163
  166. package/src/strategies/goals/task-only-top.ts +57 -57
  167. package/src/strategies/goals/task-or-patrol-goal.ts +41 -41
  168. package/src/strategies/goals/task-report-top.ts +57 -57
  169. package/src/strategies/goals/wander-task-goal.ts +33 -33
  170. package/src/strategies/goals/warrior-shrimp-top.test.ts +87 -87
  171. package/src/strategies/goals/warrior-shrimp-top.ts +267 -267
  172. package/src/strategies/greeting.ts +53 -53
  173. package/src/strategies/hide-spots.ts +59 -59
  174. package/src/strategies/hide.ts +24 -24
  175. package/src/strategies/kill-frenzy.ts +13 -13
  176. package/src/strategies/kill-lone.knowledge.md +17 -17
  177. package/src/strategies/kill-lone.ts +14 -14
  178. package/src/strategies/kill-target.ts +19 -19
  179. package/src/strategies/loader.test.ts +678 -678
  180. package/src/strategies/loader.ts +181 -181
  181. package/src/strategies/lone-kill-task.ts +22 -22
  182. package/src/strategies/meeting-gate.test.ts +59 -59
  183. package/src/strategies/meeting-gate.ts +23 -23
  184. package/src/strategies/move-room.ts +16 -16
  185. package/src/strategies/new-events-backfill.ts +98 -98
  186. package/src/strategies/off-route-points.ts +105 -105
  187. package/src/strategies/paradise-fish.knowledge.md +19 -19
  188. package/src/strategies/paradise-fish.ts +26 -26
  189. package/src/strategies/pathfind/distance-field.ts +150 -150
  190. package/src/strategies/pathfind/escape-planner.test.ts +197 -197
  191. package/src/strategies/pathfind/escape-planner.ts +355 -355
  192. package/src/strategies/pathfind/walkable-grid.ts +117 -117
  193. package/src/strategies/patrol.ts +12 -12
  194. package/src/strategies/player-targets.ts +13 -13
  195. package/src/strategies/report-patrol.ts +12 -12
  196. package/src/strategies/shrimp-memory.knowledge.md +19 -19
  197. package/src/strategies/shrimp-memory.ts +26 -26
  198. package/src/strategies/social-task.test.ts +28 -28
  199. package/src/strategies/social-task.ts +50 -50
  200. package/src/strategies/spawn.ts +82 -82
  201. package/src/strategies/speech-module.ts +123 -123
  202. package/src/strategies/strategy-loop.test.ts +15 -15
  203. package/src/strategies/strategy-loop.ts +776 -776
  204. package/src/strategies/task-kill-report.ts +18 -18
  205. package/src/strategies/task-only.ts +12 -12
  206. package/src/strategies/task-report.ts +23 -23
  207. package/src/strategies/types.ts +109 -109
  208. package/src/strategies/warrior-memory.knowledge.md +21 -21
  209. 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
+ }