@myclaw163/clawclaw-cli 0.6.64 → 0.6.66

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