ccbot-cli 2.0.1 → 2.1.0

package/bin/install.js

@@ -1,349 +1,509 @@
-#!/usr/bin/env node
-
-'use strict';
-const fs = require('fs');
-const path = require('path');
-const os = require('os');
-const { execSync } = require('child_process');
-
-const pkg = require(path.join(__dirname, '..', 'package.json'));
-const VERSION = pkg.version;
-const HOME = os.homedir();
-const CLAUDE_DIR = path.join(HOME, '.claude');
-
-const { rmSafe, ensureDir, readJSON, writeJSON, deepMerge } = require(path.join(__dirname, 'lib', 'utils.js'));
-const { MCP_SERVERS, SKILLS } = require(path.join(__dirname, 'lib', 'registry.js'));
-
-// ── ANSI ──
-const c = {
-  b: s => `\x1b[1m${s}\x1b[0m`,
-  d: s => `\x1b[2m${s}\x1b[0m`,
-  red: s => `\x1b[31m${s}\x1b[0m`,
-  grn: s => `\x1b[32m${s}\x1b[0m`,
-  ylw: s => `\x1b[33m${s}\x1b[0m`,
-  blu: s => `\x1b[34m${s}\x1b[0m`,
-  mag: s => `\x1b[35m${s}\x1b[0m`,
-  cyn: s => `\x1b[36m${s}\x1b[0m`,
-};
-
-function banner() {
-  console.log(c.cyn(`
-   ██████╗ ██████╗ ██████╗  ██████╗ ████████╗
-  ██╔════╝██╔════╝██╔══██╗██╔═══██╗╚══██╔══╝
-  ██║     ██║     ██████╔╝██║   ██║   ██║
-  ██║     ██║     ██╔══██╗██║   ██║   ██║
-  ╚██████╗╚██████╗██████╔╝╚██████╔╝   ██║
-   ╚═════╝ ╚═════╝╚═════╝  ╚═════╝    ╚═╝`));
-  console.log(c.d(`  Claude Code 环境一键配置  v${VERSION}\n`));
-}
-
-function step(n, total, msg) { console.log(`\n  ${c.cyn(`[${n}/${total}]`)} ${c.b(msg)}`); }
-function ok(msg)   { console.log(`  ${c.grn('✔')} ${msg}`); }
-function warn(msg) { console.log(`  ${c.ylw('⚠')} ${msg}`); }
-function info(msg) { console.log(`  ${c.blu('ℹ')} ${msg}`); }
-function fail(msg) { console.log(`  ${c.red('✘')} ${msg}`); }
-
-function divider(title) {
-  const line = '─'.repeat(44);
-  const pad = ' '.repeat(Math.max(0, 43 - title.length));
-  console.log(`\n${c.d('┌' + line + '┐')}`);
-  console.log(`${c.d('│')} ${c.b(title)}${pad}${c.d('│')}`);
-  console.log(`${c.d('└' + line + '┘')}`);
-}
-
-// ── CLI 参数 ──
-const args = process.argv.slice(2);
-let autoYes = false;
-let uninstallMode = false;
-
-for (let i = 0; i < args.length; i++) {
-  if (args[i] === '--yes' || args[i] === '-y') autoYes = true;
-  else if (args[i] === '--uninstall') uninstallMode = true;
-  else if (args[i] === '--help' || args[i] === '-h') {
-    banner();
-    console.log(`${c.b('用法:')}  npx ccbot-cli [选项]
-
-${c.b('选项:')}
-  --yes, -y       全自动模式 (安装全部预设)
-  --uninstall     卸载已安装的配置
-  --help, -h      显示帮助
-
-${c.b('示例:')}
-  npx ccbot-cli                ${c.d('# 交互菜单')}
-  npx ccbot-cli -y             ${c.d('# 一键全装')}
-  npx ccbot-cli --uninstall    ${c.d('# 卸载')}
-`);
-    process.exit(0);
-  }
-}
-
-// ── 检测 Claude Code CLI ──
-function detectClaudeCLI() {
-  try {
-    execSync('claude --version', { stdio: 'pipe' });
-    return true;
-  } catch { return false; }
-}
-
-// ── 安装 Claude Code CLI ──
-function installClaudeCLI() {
-  info('正在安装 Claude Code CLI...');
-  try {
-    execSync('npm install -g @anthropic-ai/claude-code', { stdio: 'inherit' });
-    ok('Claude Code CLI 安装成功');
-    return true;
-  } catch (e) {
-    fail(`安装失败: ${e.message}`);
-    return false;
-  }
-}
-
-// ── 生成项目脚手架 ──
-function scaffold(projectDir) {
-  const PKG_ROOT = path.join(__dirname, '..');
-  const files = [
-    { src: 'config/CLAUDE.md', dest: 'CLAUDE.md' },
-    { src: 'config/.claudeignore', dest: '.claudeignore' },
-  ];
-
-  let count = 0;
-  files.forEach(({ src, dest }) => {
-    const srcPath = path.join(PKG_ROOT, src);
-    const destPath = path.join(projectDir, dest);
-    if (!fs.existsSync(srcPath)) { warn(`模板缺失: ${src}`); return; }
-    if (fs.existsSync(destPath)) { info(`已存在，跳过: ${dest}`); return; }
-    fs.copyFileSync(srcPath, destPath);
-    ok(dest);
-    count++;
-  });
-
-  // .claude/settings.json (项目级)
-  const localSettingsDir = path.join(projectDir, '.claude');
-  const localSettingsPath = path.join(localSettingsDir, 'settings.json');
-  if (!fs.existsSync(localSettingsPath)) {
-    ensureDir(localSettingsDir);
-    writeJSON(localSettingsPath, {});
-    ok('.claude/settings.json');
-    count++;
-  } else {
-    info('已存在，跳过: .claude/settings.json');
-  }
-
-  return count;
-}
-
-// ── 安装 MCP Servers ──
-function installMCPServers(selected) {
-  const settingsPath = path.join(CLAUDE_DIR, 'settings.json');
-  let settings = readJSON(settingsPath) || {};
-  if (!settings.mcpServers) settings.mcpServers = {};
-
-  let count = 0;
-  selected.forEach(srv => {
-    const [command, srvArgs] = srv.args(HOME);
-    settings.mcpServers[srv.name] = { command, args: srvArgs };
-    ok(`${srv.name} ${c.d(`(${srv.desc})`)}`);
-    count++;
-  });
-
-  ensureDir(CLAUDE_DIR);
-  writeJSON(settingsPath, settings);
-  info(`已写入 ${c.cyn(settingsPath)}`);
-  return count;
-}
-
-// ── 安装 Skills ──
-function installSkills(selected) {
-  let count = 0;
-  selected.forEach(skill => {
-    info(`安装 ${skill.name}...`);
-    try {
-      execSync(skill.cmd, { stdio: 'inherit' });
-      ok(`${skill.name} ${c.d(`(${skill.desc})`)}`);
-      count++;
-    } catch (e) {
-      fail(`${skill.name} 安装失败: ${e.message}`);
-    }
-  });
-  return count;
-}
-
-// ── 环境变量清理 ──
-function cleanEnvKeys() {
-  const patterns = [
-    /^ANTHROPIC_API_KEY$/i,
-    /^CLAUDE_API_KEY$/i,
-    /^OPENAI_API_KEY$/i,
-  ];
-  const found = [];
-  for (const [key] of Object.entries(process.env)) {
-    if (patterns.some(p => p.test(key))) found.push(key);
-  }
-  if (found.length === 0) {
-    ok('未检测到敏感环境变量');
-    return 0;
-  }
-  found.forEach(key => {
-    warn(`检测到: ${c.ylw(key)} — 建议从系统环境变量中移除`);
-  });
-  info('Claude Code 使用 OAuth 认证，无需 API Key 环境变量');
-  return found.length;
-}
-
-// ── 卸载 ──
-function runUninstall() {
-  divider('卸载 ccbot-cli 配置');
-
-  const settingsPath = path.join(CLAUDE_DIR, 'settings.json');
-  const settings = readJSON(settingsPath);
-  if (!settings) { fail('未找到 settings.json'); return; }
-
-  if (settings.mcpServers) {
-    const names = Object.keys(settings.mcpServers);
-    const known = MCP_SERVERS.map(s => s.name);
-    let removed = 0;
-    names.forEach(name => {
-      if (known.includes(name)) {
-        delete settings.mcpServers[name];
-        ok(`移除 MCP: ${name}`);
-        removed++;
-      }
-    });
-    if (removed === 0) info('无 ccbot 安装的 MCP Server');
-  }
-
-  writeJSON(settingsPath, settings);
-  ok('settings.json 已更新');
-  console.log('');
-  ok(c.b('卸载完成\n'));
-}
-
-// ── 主流程 ──
-
-async function main() {
-  if (uninstallMode) { runUninstall(); return; }
-
-  banner();
-
-  if (autoYes) {
-    await runFullInstall();
-    return;
-  }
-
-  const { select } = await import('@inquirer/prompts');
-  const action = await select({
-    message: '请选择操作',
-    choices: [
-      { name: `一键全装 ${c.d('(CLI + MCP + Skills + 脚手架)')}`, value: 'full' },
-      { name: `仅安装 MCP Servers`, value: 'mcp' },
-      { name: `仅安装 Skills / Plugins`, value: 'skills' },
-      { name: `生成项目脚手架 ${c.d('(CLAUDE.md 等)')}`, value: 'scaffold' },
-      { name: `环境变量检查`, value: 'env' },
-      { name: `${c.red('卸载')} ccbot 配置`, value: 'uninstall' },
-    ],
-  });
-
-  switch (action) {
-    case 'full': await runFullInstall(); break;
-    case 'mcp': await runMCPInstall(); break;
-    case 'skills': await runSkillsInstall(); break;
-    case 'scaffold': await runScaffold(); break;
-    case 'env': runEnvCheck(); break;
-    case 'uninstall': runUninstall(); break;
-  }
-}
-
-// ── 一键全装 ──
-async function runFullInstall() {
-  const totalSteps = 5;
-
-  // 1. CLI
-  step(1, totalSteps, 'Claude Code CLI');
-  if (detectClaudeCLI()) {
-    ok('已安装');
-  } else {
-    installClaudeCLI();
-  }
-
-  // 2. MCP
-  step(2, totalSteps, `安装 MCP Servers (${MCP_SERVERS.length} 个)`);
-  installMCPServers(MCP_SERVERS);
-
-  // 3. Skills
-  step(3, totalSteps, `安装 Skills (${SKILLS.length} 个)`);
-  installSkills(SKILLS);
-
-  // 4. 脚手架
-  step(4, totalSteps, '生成项目脚手架');
-  scaffold(process.cwd());
-
-  // 5. 环境检查
-  step(5, totalSteps, '环境变量检查');
-  cleanEnvKeys();
-
-  finish();
-}
-
-// ── 单独安装 MCP ──
-async function runMCPInstall() {
-  const { checkbox } = await import('@inquirer/prompts');
-  const selected = await checkbox({
-    message: '选择要安装的 MCP Servers',
-    choices: MCP_SERVERS.map(s => ({
-      name: `${s.name} ${c.d(`— ${s.desc}`)}`,
-      value: s,
-      checked: true,
-    })),
-  });
-  if (selected.length === 0) { info('未选择任何 MCP Server'); return; }
-
-  step(1, 1, `安装 MCP Servers (${selected.length} 个)`);
-  installMCPServers(selected);
-  finish();
-}
-
-// ── 单独安装 Skills ──
-async function runSkillsInstall() {
-  const { checkbox } = await import('@inquirer/prompts');
-  const selected = await checkbox({
-    message: '选择要安装的 Skills',
-    choices: SKILLS.map(s => ({
-      name: `${s.name} ${c.d(`— ${s.desc}`)}`,
-      value: s,
-      checked: true,
-    })),
-  });
-  if (selected.length === 0) { info('未选择任何 Skill'); return; }
-
-  step(1, 1, `安装 Skills (${selected.length} 个)`);
-  installSkills(selected);
-  finish();
-}
-
-// ── 单独脚手架 ──
-async function runScaffold() {
-  step(1, 1, `生成项目脚手架 → ${c.cyn(process.cwd())}`);
-  scaffold(process.cwd());
-  finish();
-}
-
-// ── 单独环境检查 ──
-function runEnvCheck() {
-  step(1, 1, '环境变量检查');
-  cleanEnvKeys();
-}
-
-// ── 完成 ──
-function finish() {
-  divider('安装完成');
-  console.log('');
-  console.log(`  ${c.b('配置目录:')}  ${c.cyn(CLAUDE_DIR)}`);
-  console.log(`  ${c.b('版本:')}      v${VERSION}`);
-  console.log(`  ${c.b('卸载:')}      ${c.d('npx ccbot-cli --uninstall')}`);
-  console.log('');
-  console.log(c.cyn('  ✔ 配置完成，开始使用 Claude Code 吧！\n'));
-}
-
-if (require.main === module) {
-  main().catch(err => { fail(err.message); process.exit(1); });
-}
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+
+const pkg = require(path.join(__dirname, '..', 'package.json'));
+const VERSION = pkg.version;
+const HOME = os.homedir();
+
+// ── Node.js 版本检查 ──
+const MIN_NODE = pkg.engines?.node?.match(/(\d+)/)?.[1] || '18';
+if (parseInt(process.versions.node) < parseInt(MIN_NODE)) {
+  console.error(`\x1b[31m✘ 需要 Node.js >= ${MIN_NODE}，当前: ${process.versions.node}\x1b[0m`);
+  process.exit(1);
+}
+const PKG_ROOT = fs.realpathSync(path.join(__dirname, '..'));
+const { shouldSkip, copyRecursive, rmSafe, deepMergeNew, printMergeLog, parseFrontmatter } =
+  require(path.join(__dirname, 'lib', 'utils.js'));
+const { detectCclineBin, installCcline: _installCcline } = require(path.join(__dirname, 'lib', 'ccline.js'));
+const {
+  detectCodexAuth: detectCodexAuthImpl,
+  getCodexCoreFiles,
+  postCodex: postCodexFlow,
+} = require(path.join(__dirname, 'adapters', 'codex.js'));
+const {
+  SETTINGS_TEMPLATE,
+  getClaudeCoreFiles,
+  detectClaudeAuth: detectClaudeAuthImpl,
+  postClaude: postClaudeFlow,
+} = require(path.join(__dirname, 'adapters', 'claude.js'));
+
+// ── ANSI ──
+
+const c = {
+  b: s => `\x1b[1m${s}\x1b[0m`,
+  d: s => `\x1b[2m${s}\x1b[0m`,
+  red: s => `\x1b[31m${s}\x1b[0m`,
+  grn: s => `\x1b[32m${s}\x1b[0m`,
+  ylw: s => `\x1b[33m${s}\x1b[0m`,
+  blu: s => `\x1b[34m${s}\x1b[0m`,
+  mag: s => `\x1b[35m${s}\x1b[0m`,
+  cyn: s => `\x1b[36m${s}\x1b[0m`,
+};
+
+function banner() {
+  console.log(c.cyn(`
+   ██████╗ ██████╗ ██████╗  ██████╗ ████████╗
+  ██╔════╝██╔════╝██╔══██╗██╔═══██╗╚══██╔══╝
+  ██║     ██║     ██████╔╝██║   ██║   ██║
+  ██║     ██║     ██╔══██╗██║   ██║   ██║
+  ╚██████╗╚██████╗██████╔╝╚██████╔╝   ██║
+   ╚═════╝ ╚═════╝╚═════╝  ╚═════╝    ╚═╝`));
+  console.log(c.d(`  ☠ ccbot-cli · Claude Code 一键配置  v${VERSION}\n`));
+}
+
+function divider(title) {
+  const line = '─'.repeat(44);
+  const pad = ' '.repeat(Math.max(0, 43 - title.length));
+  console.log(`\n${c.d('┌' + line + '┐')}`);
+  console.log(`${c.d('│')} ${c.b(title)}${pad}${c.d('│')}`);
+  console.log(`${c.d('└' + line + '┘')}`);
+}
+
+function step(n, total, msg) { console.log(`\n  ${c.cyn(`[${n}/${total}]`)} ${c.b(msg)}`); }
+function ok(msg) { console.log(`  ${c.grn('✔')} ${msg}`); }
+function warn(msg) { console.log(`  ${c.ylw('⚠')} ${msg}`); }
+function info(msg) { console.log(`  ${c.blu('ℹ')} ${msg}`); }
+function fail(msg) { console.log(`  ${c.red('✘')} ${msg}`); }
+
+// ── 认证 ──
+
+function detectClaudeAuth(settings) {
+  return detectClaudeAuthImpl({ settings, HOME, warn });
+}
+
+function detectCodexAuth() {
+  return detectCodexAuthImpl({ HOME, warn });
+}
+
+// ── 模板 ──
+
+// ── CLI 参数 ──
+
+const args = process.argv.slice(2);
+let target = null;
+let uninstallTarget = null;
+let autoYes = false;
+
+for (let i = 0; i < args.length; i++) {
+  if (args[i] === '--target' && args[i + 1]) { target = args[++i]; }
+  else if (args[i] === '--uninstall' && args[i + 1]) { uninstallTarget = args[++i]; }
+  else if (args[i] === '--yes' || args[i] === '-y') { autoYes = true; }
+  else if (args[i] === '--help' || args[i] === '-h') {
+    banner();
+    console.log(`${c.b('用法:')}  npx ccbot-cli [选项]
+
+${c.b('选项:')}
+  --target ${c.cyn('<claude|codex>')}      安装目标
+  --uninstall ${c.cyn('<claude|codex>')}   卸载目标
+  --yes, -y                    全自动模式
+  --help, -h                   显示帮助
+
+${c.b('示例:')}
+  npx ccbot-cli                        ${c.d('# 交互菜单')}
+  npx ccbot-cli --target claude -y      ${c.d('# 零配置一键安装')}
+  npx ccbot-cli --uninstall claude      ${c.d('# 直接卸载')}
+`);
+    process.exit(0);
+  }
+}
+
+// ── 卸载 ──
+
+function runUninstall(tgt) {
+  if (!['claude', 'codex'].includes(tgt)) { fail('--uninstall 必须是 claude 或 codex'); process.exit(1); }
+  const targetDir = path.join(HOME, `.${tgt}`);
+  const backupDir = path.join(targetDir, '.sage-backup');
+  const manifestPath = path.join(backupDir, 'manifest.json');
+  if (!fs.existsSync(manifestPath)) { fail(`未找到安装记录: ${manifestPath}`); process.exit(1); }
+
+  const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'));
+  if (manifest.manifest_version && manifest.manifest_version > 1) {
+    fail(`manifest 版本 ${manifest.manifest_version} 不兼容，请升级 ccbot-cli 后再卸载`);
+    process.exit(1);
+  }
+  divider(`卸载 ccbot-cli v${manifest.version}`);
+
+  (manifest.installed || []).forEach(f => {
+    const p = path.join(targetDir, f);
+    if (fs.existsSync(p)) { rmSafe(p); console.log(`  ${c.red('✘')} ${f}`); }
+  });
+  (manifest.backups || []).forEach(f => {
+    const bp = path.join(backupDir, f);
+    const tp = path.join(targetDir, f);
+    if (fs.existsSync(bp)) { fs.renameSync(bp, tp); ok(`恢复: ${f}`); }
+  });
+
+  rmSafe(backupDir);
+  const us = path.join(targetDir, '.sage-uninstall.js');
+  if (fs.existsSync(us)) fs.unlinkSync(us);
+  console.log('');
+  ok(c.b('卸载完成\n'));
+}
+
+// ── 安装核心 ──
+
+/**
+ * 递归扫描 skills 目录，找出所有 user-invocable: true 的 SKILL.md
+ * @param {string} skillsDir - skills 源目录绝对路径
+ * @returns {Array<{meta: Object, relPath: string, hasScripts: boolean}>}
+ */
+function scanInvocableSkills(skillsDir) {
+  const results = [];
+  function scan(dir) {
+    const skillMd = path.join(dir, 'SKILL.md');
+    if (fs.existsSync(skillMd)) {
+      try {
+        const content = fs.readFileSync(skillMd, 'utf8');
+        const meta = parseFrontmatter(content);
+        if (meta && meta['user-invocable'] === 'true' && meta.name) {
+          const relPath = path.relative(skillsDir, dir);
+          const scriptsDir = path.join(dir, 'scripts');
+          const hasScripts = fs.existsSync(scriptsDir) &&
+            fs.readdirSync(scriptsDir).some(f => f.endsWith('.js'));
+          results.push({ meta, relPath, hasScripts });
+        }
+      } catch (e) { /* 解析失败跳过 */ }
+    }
+    try {
+      fs.readdirSync(dir).forEach(sub => {
+        const subPath = path.join(dir, sub);
+        if (fs.statSync(subPath).isDirectory() && !shouldSkip(sub) && sub !== 'scripts') {
+          scan(subPath);
+        }
+      });
+    } catch (e) { /* 读取失败跳过 */ }
+  }
+  scan(skillsDir);
+  return results;
+}
+
+const INVOCABLE_TARGETS = {
+  claude: {
+    dir: 'commands',
+    label: '斜杠命令',
+    skillRoot: '~/.claude/skills',
+  },
+  codex: {
+    dir: 'prompts',
+    label: 'custom prompts',
+    skillRoot: '~/.codex/skills',
+  },
+};
+
+function getInvocableTarget(targetName) {
+  const targetCfg = INVOCABLE_TARGETS[targetName];
+  if (!targetCfg) throw new Error(`不支持的 invocable target: ${targetName}`);
+  return targetCfg;
+}
+
+function getSkillPath(skillRoot, skillRelPath) {
+  return skillRelPath
+    ? `${skillRoot}/${skillRelPath}/SKILL.md`
+    : `${skillRoot}/SKILL.md`;
+}
+
+function buildCommandFrontmatter(meta) {
+  const desc = (meta.description || '').replace(/"/g, '\\"');
+  const argHint = meta['argument-hint'];
+  const tools = meta['allowed-tools'] || 'Read';
+  const lines = ['---', `name: ${meta.name}`, `description: "${desc}"`];
+
+  if (argHint) lines.push(`argument-hint: "${argHint}"`);
+  lines.push(`allowed-tools: ${tools}`);
+  lines.push('---', '');
+  return lines;
+}
+
+function buildClaudeBody(skillPath, meta, hasScripts) {
+  const lines = [];
+  if (hasScripts) {
+    lines.push('以下所有步骤一气呵成，不要在步骤间停顿等待用户输入：', '');
+    lines.push(`1. 读取规范：${skillPath}`);
+    lines.push(`2. 执行命令：\`node ~/.claude/skills/run_skill.js ${meta.name} $ARGUMENTS\``);
+    lines.push('3. 按规范分析输出，完成后续动作', '');
+    lines.push('全程不要停顿，不要询问是否继续。');
+    return lines;
+  }
+
+  lines.push('读取以下秘典，根据内容为用户提供专业指导：', '');
+  lines.push('```', skillPath, '```');
+  return lines;
+}
+
+function buildCodexPromptBody(skillPath, meta, hasScripts) {
+  const lines = [];
+  if (meta['argument-hint']) lines.push(`Arguments: ${meta['argument-hint']}`, '');
+  lines.push(`Read \`${skillPath}\` before acting.`, '');
+  if (hasScripts) {
+    lines.push(`Then run \`node ~/.codex/skills/run_skill.js ${meta.name} $ARGUMENTS\`.`);
+    lines.push('Do not stop between steps unless blocked by permissions or missing required inputs.');
+    lines.push('Use the skill guidance plus script output to complete the task end-to-end.');
+    return lines;
+  }
+
+  lines.push('Use that skill as the authoritative playbook for the task.');
+  lines.push('Respond with concrete actions instead of generic advice.');
+  return lines;
+}
+
+function generateInvocableContent(meta, skillRelPath, hasScripts, targetName) {
+  const targetCfg = getInvocableTarget(targetName);
+  const skillPath = getSkillPath(targetCfg.skillRoot, skillRelPath);
+  const lines = targetName === 'claude' ? buildCommandFrontmatter(meta) : [];
+  const body = targetName === 'claude'
+    ? buildClaudeBody(skillPath, meta, hasScripts)
+    : buildCodexPromptBody(skillPath, meta, hasScripts);
+  return [...lines, ...body, ''].join('\n');
+}
+
+function generateCommandContent(meta, skillRelPath, hasScripts) {
+  return generateInvocableContent(meta, skillRelPath, hasScripts, 'claude');
+}
+
+function generatePromptContent(meta, skillRelPath, hasScripts) {
+  return generateInvocableContent(meta, skillRelPath, hasScripts, 'codex');
+}
+
+function installGeneratedArtifacts(skillsSrcDir, targetDir, backupDir, manifest, targetName) {
+  const skills = scanInvocableSkills(skillsSrcDir);
+  if (skills.length === 0) return 0;
+
+  const targetCfg = getInvocableTarget(targetName);
+  const installDir = path.join(targetDir, targetCfg.dir);
+  fs.mkdirSync(installDir, { recursive: true });
+
+  skills.forEach(({ meta, relPath, hasScripts }) => {
+    const fileName = `${meta.name}.md`;
+    const destFile = path.join(installDir, fileName);
+    const relFile = path.posix.join(targetCfg.dir, fileName);
+
+    if (fs.existsSync(destFile)) {
+      const backupSubdir = path.join(backupDir, targetCfg.dir);
+      fs.mkdirSync(backupSubdir, { recursive: true });
+      fs.copyFileSync(destFile, path.join(backupSubdir, fileName));
+      manifest.backups.push(relFile);
+      info(`备份: ${c.d(relFile)}`);
+    }
+
+    const content = generateInvocableContent(meta, relPath, hasScripts, targetName);
+    fs.writeFileSync(destFile, content);
+    manifest.installed.push(relFile);
+  });
+
+  ok(`${targetCfg.dir}/ ${c.d(`(自动生成 ${skills.length} 个 ${targetCfg.label})`)}`);
+  return skills.length;
+}
+
+function installGeneratedCommands(skillsSrcDir, targetDir, backupDir, manifest) {
+  return installGeneratedArtifacts(skillsSrcDir, targetDir, backupDir, manifest, 'claude');
+}
+
+function installGeneratedPrompts(skillsSrcDir, targetDir, backupDir, manifest) {
+  return installGeneratedArtifacts(skillsSrcDir, targetDir, backupDir, manifest, 'codex');
+}
+
+function backupPathIfExists(targetDir, backupDir, relPath, manifest) {
+  const targetPath = path.join(targetDir, relPath);
+  if (!fs.existsSync(targetPath)) return false;
+
+  const backupPath = path.join(backupDir, relPath);
+  rmSafe(backupPath);
+  copyRecursive(targetPath, backupPath);
+  manifest.backups.push(relPath);
+  info(`备份: ${c.d(relPath)}`);
+  return true;
+}
+
+function pruneLegacyCodexSettings(targetDir, backupDir, manifest) {
+  const relPath = 'settings.json';
+  const settingsPath = path.join(targetDir, relPath);
+  if (!fs.existsSync(settingsPath)) return null;
+
+  backupPathIfExists(targetDir, backupDir, relPath, manifest);
+  rmSafe(settingsPath);
+  warn('移除 legacy settings.json（Codex 已改用 config.toml）');
+  return settingsPath;
+}
+
+function installCore(tgt) {
+  const targetDir = path.join(HOME, `.${tgt}`);
+  const backupDir = path.join(targetDir, '.sage-backup');
+  const manifestPath = path.join(backupDir, 'manifest.json');
+
+  step(1, 3, `安装核心文件 → ${c.cyn(targetDir)}`);
+  fs.mkdirSync(backupDir, { recursive: true });
+
+  const filesToInstall = tgt === 'codex'
+    ? getCodexCoreFiles()
+    : getClaudeCoreFiles();
+
+  const manifest = {
+    manifest_version: 1, version: VERSION, target: tgt,
+    timestamp: new Date().toISOString(), installed: [], backups: []
+  };
+
+  filesToInstall.forEach(({ src, dest }) => {
+    const srcPath = path.join(PKG_ROOT, src);
+    const destPath = path.join(targetDir, dest);
+    if (!fs.existsSync(srcPath)) {
+      if (src === 'skills') {
+        fail(`核心文件缺失: ${srcPath}\n    请尝试: npm cache clean --force && npx ccbot-cli`);
+        process.exit(1);
+      }
+      warn(`跳过: ${src}`); return;
+    }
+
+    if (fs.existsSync(destPath)) {
+      const bp = path.join(backupDir, dest);
+      rmSafe(bp); copyRecursive(destPath, bp); manifest.backups.push(dest);
+      info(`备份: ${c.d(dest)}`);
+    }
+    ok(dest);
+    rmSafe(destPath); copyRecursive(srcPath, destPath); manifest.installed.push(dest);
+  });
+
+  // 为目标 CLI 自动生成 user-invocable artifacts
+  if (tgt === 'claude') {
+    const skillsSrc = path.join(PKG_ROOT, 'skills');
+    installGeneratedCommands(skillsSrc, targetDir, backupDir, manifest);
+  } else if (tgt === 'codex') {
+    const skillsSrc = path.join(PKG_ROOT, 'skills');
+    installGeneratedPrompts(skillsSrc, targetDir, backupDir, manifest);
+  }
+
+  let settingsPath = null;
+  let settings = {};
+  if (tgt === 'claude') {
+    settingsPath = path.join(targetDir, 'settings.json');
+    if (fs.existsSync(settingsPath)) {
+      try {
+        settings = JSON.parse(fs.readFileSync(settingsPath, 'utf8'));
+      } catch (e) {
+        warn('settings.json 解析失败，将使用空配置');
+        settings = {};
+      }
+      fs.copyFileSync(settingsPath, path.join(backupDir, 'settings.json'));
+      manifest.backups.push('settings.json');
+    }
+    settings.outputStyle = 'abyss-cultivator';
+    ok(`outputStyle = ${c.mag('abyss-cultivator')}`);
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2) + '\n');
+    manifest.installed.push('settings.json');
+  } else {
+    pruneLegacyCodexSettings(targetDir, backupDir, manifest);
+  }
+
+  fs.writeFileSync(manifestPath, JSON.stringify(manifest, null, 2) + '\n');
+
+  const uSrc = path.join(PKG_ROOT, 'bin', 'uninstall.js');
+  const uDest = path.join(targetDir, '.sage-uninstall.js');
+  if (fs.existsSync(uSrc)) { fs.copyFileSync(uSrc, uDest); fs.chmodSync(uDest, '755'); }
+
+  return { targetDir, settingsPath, settings, manifest, manifestPath };
+}
+
+// ── Claude 后续 ──
+
+async function postClaude(ctx) {
+  await postClaudeFlow({
+    ctx,
+    autoYes,
+    HOME,
+    PKG_ROOT,
+    step,
+    ok,
+    warn,
+    info,
+    c,
+    deepMergeNew,
+    printMergeLog,
+    installCcline: _installCcline,
+  });
+}
+
+// ── Codex 后续 ──
+
+async function postCodex() {
+  await postCodexFlow({
+    autoYes,
+    HOME,
+    PKG_ROOT,
+    step,
+    ok,
+    warn,
+    info,
+    c,
+  });
+}
+
+// ── 主流程 ──
+
+async function main() {
+  if (uninstallTarget) { runUninstall(uninstallTarget); return; }
+
+  banner();
+
+  if (target) {
+    if (!['claude', 'codex'].includes(target)) { fail('--target 必须是 claude 或 codex'); process.exit(1); }
+    const ctx = installCore(target);
+    if (target === 'claude') await postClaude(ctx);
+    else await postCodex();
+    finish(ctx);
+    return;
+  }
+
+  const { select } = await import('@inquirer/prompts');
+  const action = await select({
+    message: '请选择操作',
+    choices: [
+      { name: `安装到 Claude Code ${c.d('(~/.claude/')}${c.d(')')}`, value: 'install-claude' },
+      { name: `安装到 Codex CLI   ${c.d('(~/.codex/')}${c.d(')')}`, value: 'install-codex' },
+      { name: `${c.red('卸载')} Claude Code`, value: 'uninstall-claude' },
+      { name: `${c.red('卸载')} Codex CLI`, value: 'uninstall-codex' },
+    ],
+  });
+
+  switch (action) {
+    case 'install-claude': {
+      const ctx = installCore('claude');
+      await postClaude(ctx);
+      finish(ctx); break;
+    }
+    case 'install-codex': {
+      const ctx = installCore('codex');
+      await postCodex();
+      finish(ctx); break;
+    }
+    case 'uninstall-claude': runUninstall('claude'); break;
+    case 'uninstall-codex': runUninstall('codex'); break;
+  }
+}
+
+function finish(ctx) {
+  const tgt = ctx.manifest.target;
+  divider('安装完成');
+  console.log('');
+  console.log(`  ${c.b('目标:')}     ${c.cyn(ctx.targetDir)}`);
+  console.log(`  ${c.b('版本:')}     v${VERSION}`);
+  console.log(`  ${c.b('文件:')}     ${ctx.manifest.installed.length} 个安装, ${ctx.manifest.backups.length} 个备份`);
+  console.log(`  ${c.b('卸载:')}     ${c.d(`npx ccbot-cli --uninstall ${tgt}`)}`);
+  console.log('');
+  console.log(c.mag(`  ⚚ 劫——破——了——！！！\n`));
+}
+
+if (require.main === module) {
+  main().catch(err => { fail(err.message); process.exit(1); });
+}
+
+module.exports = {
+  deepMergeNew, detectClaudeAuth, detectCodexAuth,
+  detectCclineBin, copyRecursive, shouldSkip, SETTINGS_TEMPLATE,
+  scanInvocableSkills,
+  generateCommandContent,
+  generatePromptContent,
+  installGeneratedCommands,
+  installGeneratedPrompts,
+};