codewave-openclaw-installer 1.0.2 → 2.1.0

package/bin/check.mjs

@@ -0,0 +1,623 @@
+#!/usr/bin/env node
+
+/**
+ * CodeWave Toolkit — Preflight Check
+ *
+ * 检测所有 Skill 的外部依赖、认证配置、运行环境，
+ * 输出每个 Skill 的就绪状态和修复建议。
+ *
+ * 用法：
+ *   node bin/check.mjs            # 检测所有 skill
+ *   node bin/check.mjs --json     # JSON 输出（供程序消费）
+ *   node bin/check.mjs --fix      # 尝试自动修复（安装缺失依赖）
+ */
+
+import { spawn } from 'node:child_process';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir, platform } from 'node:os';
+
+// ─── 颜色 ───
+const NO_COLOR = process.env.NO_COLOR || process.argv.includes('--json');
+const bold   = (s) => NO_COLOR ? s : `\x1b[1m${s}\x1b[0m`;
+const green  = (s) => NO_COLOR ? s : `\x1b[32m${s}\x1b[0m`;
+const yellow = (s) => NO_COLOR ? s : `\x1b[33m${s}\x1b[0m`;
+const red    = (s) => NO_COLOR ? s : `\x1b[31m${s}\x1b[0m`;
+const cyan   = (s) => NO_COLOR ? s : `\x1b[36m${s}\x1b[0m`;
+const dim    = (s) => NO_COLOR ? s : `\x1b[2m${s}\x1b[0m`;
+const gray   = dim;
+
+const isWin = process.platform === 'win32';
+const isMac = process.platform === 'darwin';
+const isLinux = process.platform === 'linux';
+const JSON_MODE = process.argv.includes('--json');
+const FIX_MODE = process.argv.includes('--fix');
+
+// ─── 工具函数 ───
+
+function commandExists(cmd) {
+  return new Promise((resolve) => {
+    const check = isWin ? 'where' : 'which';
+    const child = spawn(check, [cmd], { stdio: 'ignore', shell: isWin });
+    child.on('close', (code) => resolve(code === 0));
+    child.on('error', () => resolve(false));
+  });
+}
+
+function getCommandVersion(cmd, args = ['--version']) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: ['ignore', 'pipe', 'pipe'], shell: isWin });
+    let stdout = '';
+    child.stdout?.on('data', (d) => { stdout += d.toString(); });
+    child.on('close', (code) => resolve(code === 0 ? stdout.trim().split('\n')[0] : null));
+    child.on('error', () => resolve(null));
+  });
+}
+
+function fileExists(p) {
+  return existsSync(p);
+}
+
+function readJson(p) {
+  try {
+    return JSON.parse(readFileSync(p, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function openclawChannelHints() {
+  const configPath = join(homedir(), '.openclaw', 'openclaw.json');
+  const config = readJson(configPath);
+  const hints = [];
+
+  if (config?.channels?.feishu) {
+    hints.push(`${configPath}#channels.feishu`);
+  }
+
+  return hints;
+}
+
+function run(cmd, args) {
+  return new Promise((resolve) => {
+    const child = spawn(cmd, args, { stdio: 'inherit', shell: isWin });
+    child.on('close', (code) => resolve(code ?? 1));
+    child.on('error', () => resolve(1));
+  });
+}
+
+// ─── 检测项定义 ───
+
+/** @typedef {{ name: string, status: 'ok'|'warn'|'fail', version?: string, message: string, fix?: string }} CheckResult */
+
+async function checkCli(name, { installCmd, versionArgs, optional = false } = {}) {
+  const exists = await commandExists(name);
+  if (!exists) {
+    return {
+      name,
+      status: optional ? 'warn' : 'fail',
+      message: `未安装`,
+      fix: installCmd || null,
+    };
+  }
+  const version = await getCommandVersion(name, versionArgs || ['--version']);
+  return {
+    name,
+    status: 'ok',
+    version: version || 'unknown',
+    message: '已安装',
+  };
+}
+
+async function checkRazelConfig() {
+  const configPath = join(homedir(), '.razel', 'config.json');
+  if (!fileExists(configPath)) {
+    return {
+      name: '~/.razel/config.json',
+      status: 'fail',
+      message: '配置文件不存在',
+      fix: 'razel-py-cli init  # 或 razel-cli init',
+    };
+  }
+  const config = readJson(configPath);
+  if (!config) {
+    return {
+      name: '~/.razel/config.json',
+      status: 'fail',
+      message: '配置文件无法解析',
+    };
+  }
+  return { name: '~/.razel/config.json', status: 'ok', message: '存在且可解析' };
+}
+
+async function checkOpenClawConfig() {
+  const configPath = join(homedir(), '.openclaw', 'openclaw.json');
+  if (!fileExists(configPath)) {
+    return {
+      name: 'openclaw.json (LLM)',
+      status: 'warn',
+      message: '未找到 OpenClaw 配置文件（部分 Skill 需要 LLM）',
+    };
+  }
+  return { name: 'openclaw.json (LLM)', status: 'ok', message: '存在' };
+}
+
+async function checkPythonDocx() {
+  return new Promise((resolve) => {
+    const child = spawn('python3', ['-c', 'import docx; print(docx.__version__)'], {
+      stdio: ['ignore', 'pipe', 'pipe'],
+    });
+    let stdout = '';
+    child.stdout?.on('data', (d) => { stdout += d.toString(); });
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve({ name: 'python-docx', status: 'ok', version: stdout.trim(), message: '已安装' });
+      } else {
+        resolve({
+          name: 'python-docx',
+          status: 'warn',
+          message: '未安装（DOCX 解析的 fallback 方案之一）',
+          fix: 'pip3 install python-docx',
+        });
+      }
+    });
+    child.on('error', () => {
+      resolve({ name: 'python-docx', status: 'warn', message: 'python3 不可用' });
+    });
+  });
+}
+
+async function checkDocxPipeline() {
+  // DOCX 解析需要至少一个可用：pandoc > textutil (macOS) > python-docx
+  const pandoc = await commandExists('pandoc');
+  const textutil = isMac && await commandExists('textutil');
+  const pythonDocx = await checkPythonDocx();
+  const hasPythonDocx = pythonDocx.status === 'ok';
+
+  const available = [];
+  if (pandoc) available.push('pandoc');
+  if (textutil) available.push('textutil');
+  if (hasPythonDocx) available.push('python-docx');
+
+  if (available.length === 0) {
+    return {
+      name: 'DOCX 解析工具链',
+      status: 'fail',
+      message: '缺少所有 DOCX 解析方案 (pandoc / textutil / python-docx)',
+      fix: isMac ? 'brew install pandoc' : isLinux ? 'sudo apt install pandoc' : 'pip3 install python-docx',
+    };
+  }
+  return {
+    name: 'DOCX 解析工具链',
+    status: 'ok',
+    message: `可用方案: ${available.join(', ')}`,
+  };
+}
+
+function hasAnyValue(...values) {
+  return values.some((value) => Boolean(value));
+}
+
+function checkPopoAuth(razelConfig) {
+  const hasPopo = hasAnyValue(
+    razelConfig?.popo_app_id,
+    razelConfig?.popo_app_secret,
+    process.env.POPO_APP_ID,
+    process.env.POPO_APP_SECRET,
+  );
+
+  return hasPopo
+    ? { name: 'PoPo 认证', status: 'ok', message: '已配置' }
+    : {
+        name: 'PoPo 认证',
+        status: 'warn',
+        message: '未配置 (popo-doc, popo-robot-api 需要)',
+        fix: '编辑 ~/.razel/config.json 填入 popo_app_id + popo_app_secret',
+      };
+}
+
+function checkLlmConfig(razelConfig, openclawConfigCheck) {
+  const hasLlm = hasAnyValue(
+    razelConfig?.llm_api_key,
+    razelConfig?.llm_base_url,
+    razelConfig?.openai_api_key,
+    razelConfig?.openai_base_url,
+    process.env.OPENAI_API_KEY,
+    process.env.OPENAI_BASE_URL,
+    process.env.ACCEPTANCE_LLM_API_KEY,
+    process.env.ACCEPTANCE_LLM_BASE_URL,
+    openclawConfigCheck.status === 'ok',
+  );
+
+  return hasLlm
+    ? { name: 'LLM 配置', status: 'ok', message: '已配置' }
+    : {
+        name: 'LLM 配置',
+        status: 'warn',
+        message: '未检测到 LLM API Key 或 OpenClaw LLM 配置',
+        fix: '设置 OPENAI_API_KEY / OPENAI_BASE_URL 环境变量，或用 razel-py-cli config set llm_base_url / llm_api_key',
+      };
+}
+
+function checkAsrProvider(razelConfig) {
+  const asrAvailable = [
+    hasAnyValue(razelConfig?.dashscope_api_key, process.env.DASHSCOPE_API_KEY) && 'DashScope',
+    hasAnyValue(razelConfig?.aigw_base_url, razelConfig?.aigw_api_key) && 'AIGW',
+    razelConfig?.local_server && 'Local',
+  ].filter(Boolean);
+
+  return asrAvailable.length > 0
+    ? { name: 'ASR Provider', status: 'ok', message: `可用: ${asrAvailable.join(', ')}` }
+    : {
+        name: 'ASR Provider',
+        status: 'fail',
+        message: '无可用 ASR 服务 (speed-to-text 需要)',
+        fix: '用 razel-py-cli config set dashscope_api_key，或设置 aigw_base_url + aigw_api_key',
+      };
+}
+
+async function checkChannel(name, configPaths, envVars, commands, options = {}) {
+  const { hintMessage } = options;
+  const commandMatches = [];
+  for (const cmd of commands) {
+    if (await commandExists(cmd)) {
+      commandMatches.push(cmd);
+    }
+  }
+
+  const configMatches = configPaths.filter(fileExists);
+  const envMatches = envVars.filter((key) => Boolean(process.env[key]));
+
+  const hints = [
+    ...commandMatches.map((cmd) => `命令:${cmd}`),
+    ...configMatches.map((path) => `配置:${path}`),
+    ...envMatches.map((key) => `环境变量:${key}`),
+  ];
+
+  if (commandMatches.length > 0) {
+    return {
+      name,
+      status: 'ok',
+      message: hints.length > 0 ? `已检测到 (${hints.join(', ')})` : '已检测到',
+    };
+  }
+
+  if (configMatches.length > 0 || envMatches.length > 0) {
+    return {
+      name,
+      status: 'warn',
+      message: hintMessage || `检测到环境线索，但缺少可执行命令 (${hints.join(', ')})`,
+    };
+  }
+
+  return {
+    name,
+    status: 'warn',
+    message: '未检测到本机环境线索',
+  };
+}
+
+// ─── Skill 依赖矩阵 ───
+
+const SKILLS = [
+  {
+    name: 'acceptance-doc-entry',
+    label: '项目验收文档生成',
+    deps: ['razel-py-cli', 'razel-config', 'llm-config'],
+    critical: ['razel-py-cli'],
+  },
+  {
+    name: 'pmo-weekly-report',
+    label: 'PMO 项目看板周报',
+    deps: ['razel-cli', 'jq', 'docx-pipeline'],
+    critical: [],  // 飞书渠道无外部依赖，PoPo 才需要 razel-cli
+  },
+  {
+    name: 'popo-doc',
+    label: 'PoPo 文档查询下载',
+    deps: ['razel-cli', 'razel-config', 'popo-auth'],
+    critical: ['razel-cli', 'popo-auth'],
+  },
+  {
+    name: 'popo-robot-api',
+    label: 'PoPo 机器人 API',
+    deps: ['razel-cli', 'razel-config', 'popo-auth'],
+    critical: ['razel-cli', 'popo-auth'],
+  },
+  {
+    name: 'smart-customer-service',
+    label: '智能客服知识库',
+    deps: [],  // 零外部依赖
+    critical: [],
+  },
+  {
+    name: 'speed-to-text',
+    label: '音视频转文字稿',
+    deps: ['razel-py-cli', 'razel-config', 'asr-provider'],
+    critical: ['razel-py-cli', 'asr-provider'],
+  },
+  {
+    name: 'tencent-meeting',
+    label: '腾讯会议回放嗅探',
+    deps: ['razel-cli'],
+    critical: ['razel-cli'],
+  },
+  {
+    name: 'yidun-skill-sec',
+    label: '代码包安全扫描（易盾）',
+    deps: ['curl', 'jq', 'openssl'],
+    critical: ['curl', 'openssl'],
+  },
+];
+
+// ─── 主流程 ───
+
+async function main() {
+  if (!JSON_MODE) {
+    console.log('');
+    console.log(bold('🔍 CodeWave Toolkit — Preflight Check'));
+    console.log(dim(`   平台: ${platform()} | 时间: ${new Date().toLocaleString()}`));
+    console.log('');
+    console.log('─'.repeat(60));
+  }
+
+  // Phase 1: 基础环境检测
+  const checks = {};
+
+  if (!JSON_MODE) {
+    console.log('');
+    console.log(bold('📋 基础环境检测'));
+    console.log('');
+  }
+
+  // CLI 工具
+  checks['razel-py-cli'] = await checkCli('razel-py-cli', {
+    installCmd: 'pip3 install razel-py-cli && razel-py-cli init',
+  });
+  checks['razel-cli'] = await checkCli('razel-cli', {
+    installCmd: 'npm install -g @lcap-delivery/razel-cli@latest && razel-cli init',
+  });
+  checks['jq'] = await checkCli('jq', {
+    installCmd: isMac ? 'brew install jq' : 'sudo apt install jq',
+    optional: true,
+  });
+  checks['curl'] = await checkCli('curl', {
+    installCmd: isMac ? 'brew install curl' : 'sudo apt install curl',
+    optional: true,
+  });
+  checks['openssl'] = await checkCli('openssl', {
+    installCmd: isMac ? 'brew install openssl' : 'sudo apt install openssl',
+    optional: true,
+  });
+  checks['pandoc'] = await checkCli('pandoc', {
+    installCmd: isMac ? 'brew install pandoc' : 'sudo apt install pandoc',
+    optional: true,
+  });
+  checks['openclaw'] = await checkCli('openclaw', { optional: true });
+
+  // DOCX 工具链
+  checks['docx-pipeline'] = await checkDocxPipeline();
+
+  // 配置文件
+  checks['razel-config'] = await checkRazelConfig();
+  checks['openclaw-config'] = await checkOpenClawConfig();
+
+  const razelConfig = readJson(join(homedir(), '.razel', 'config.json'));
+  checks['popo-auth'] = checkPopoAuth(razelConfig);
+  checks['llm-config'] = checkLlmConfig(razelConfig, checks['openclaw-config']);
+  checks['asr-provider'] = checkAsrProvider(razelConfig);
+  checks['lark-channel'] = await checkChannel(
+    'Lark 渠道',
+    [
+      join(homedir(), '.openclaw', 'lark.json'),
+      join(homedir(), '.openclaw', 'extensions', '@openclaw', 'feishu'),
+      join(homedir(), '.openclaw', 'extensions', 'openclaw-lark'),
+      ...openclawChannelHints(),
+    ],
+    ['LARK_APP_ID', 'LARK_APP_SECRET', 'FEISHU_APP_ID', 'FEISHU_APP_SECRET'],
+    [],
+    { hintMessage: `检测到环境线索，可通过 openclaw 渠道引导继续 (${[
+      join(homedir(), '.openclaw', 'lark.json'),
+      join(homedir(), '.openclaw', 'extensions', '@openclaw', 'feishu'),
+      join(homedir(), '.openclaw', 'extensions', 'openclaw-lark'),
+    ].filter(fileExists).map((path) => `配置:${path}`).concat(
+      ['LARK_APP_ID', 'LARK_APP_SECRET', 'FEISHU_APP_ID', 'FEISHU_APP_SECRET']
+        .filter((key) => Boolean(process.env[key]))
+        .map((key) => `环境变量:${key}`),
+    ).join(', ')})` },
+  );
+  checks['dingtalk-channel'] = await checkChannel(
+    'DingTalk 渠道',
+    [
+      join(homedir(), '.dws'),
+      join(homedir(), '.dingtalk'),
+      join(homedir(), '.config', 'dingtalk-workspace-cli'),
+    ],
+    ['DWS_CLIENT_ID', 'DWS_CLIENT_SECRET'],
+    ['dws', 'dingtalk', 'dingtalk-workspace-cli'],
+  );
+
+  // 打印基础环境结果
+  if (!JSON_MODE) {
+    const allChecks = [
+      checks['razel-py-cli'], checks['razel-cli'], checks['jq'],
+      checks['curl'], checks['openssl'], checks['pandoc'], checks['openclaw'], checks['docx-pipeline'],
+      checks['razel-config'], checks['openclaw-config'],
+      checks['popo-auth'], checks['llm-config'], checks['asr-provider'],
+      checks['lark-channel'], checks['dingtalk-channel'],
+    ];
+
+    for (const c of allChecks) {
+      const icon = c.status === 'ok' ? green('✅') : c.status === 'warn' ? yellow('⚠️') : red('❌');
+      const ver = c.version ? dim(` (${c.version})`) : '';
+      console.log(`  ${icon}  ${c.name}${ver} — ${c.message}`);
+      if (c.fix && c.status !== 'ok') {
+        console.log(`       ${dim('修复:')} ${cyan(c.fix)}`);
+      }
+    }
+  }
+
+  // Phase 2: 按 Skill 评估就绪状态
+  if (!JSON_MODE) {
+    console.log('');
+    console.log('─'.repeat(60));
+    console.log('');
+    console.log(bold('📊 Skill 就绪状态'));
+    console.log('');
+  }
+
+  const skillResults = [];
+
+  for (const skill of SKILLS) {
+    const issues = [];
+    const warnings = [];
+    const fixes = [];
+
+    for (const dep of skill.deps) {
+      const check = checks[dep];
+      if (!check) continue;
+      if (check.status === 'fail') {
+        const isCritical = skill.critical.includes(dep);
+        if (isCritical) {
+          issues.push(`${check.name}: ${check.message}`);
+        } else {
+          warnings.push(`${check.name}: ${check.message}`);
+        }
+        if (check.fix) fixes.push(check.fix);
+      } else if (check.status === 'warn') {
+        warnings.push(`${check.name}: ${check.message}`);
+        if (check.fix) fixes.push(check.fix);
+      }
+    }
+
+    let status;
+    if (issues.length > 0) {
+      status = 'fail';
+    } else if (warnings.length > 0) {
+      status = 'warn';
+    } else {
+      status = 'ok';
+    }
+
+    const result = {
+      skill: skill.name,
+      label: skill.label,
+      status,
+      issues,
+      warnings,
+      fixes,
+    };
+    skillResults.push(result);
+
+    if (!JSON_MODE) {
+      const icon = status === 'ok' ? green('✅') : status === 'warn' ? yellow('⚠️') : red('❌');
+      const statusText = status === 'ok' ? green('就绪') : status === 'warn' ? yellow('部分可用') : red('不可用');
+      console.log(`  ${icon}  ${bold(skill.name)} ${dim(`(${skill.label})`)} — ${statusText}`);
+
+      for (const issue of issues) {
+        console.log(`       ${red('✗')} ${issue}`);
+      }
+      for (const warn of warnings) {
+        console.log(`       ${yellow('△')} ${warn}`);
+      }
+      if (fixes.length > 0 && status !== 'ok') {
+        console.log(`       ${dim('修复:')}`);
+        for (const fix of fixes) {
+          console.log(`         ${cyan(fix)}`);
+        }
+      }
+    }
+  }
+
+  // Phase 3: 汇总
+  const okCount = skillResults.filter(s => s.status === 'ok').length;
+  const warnCount = skillResults.filter(s => s.status === 'warn').length;
+  const failCount = skillResults.filter(s => s.status === 'fail').length;
+  const total = skillResults.length;
+
+  if (JSON_MODE) {
+    const output = {
+      platform: platform(),
+      timestamp: new Date().toISOString(),
+      checks: Object.fromEntries(
+        Object.entries(checks).map(([k, v]) => [k, { status: v.status, message: v.message, version: v.version || null }])
+      ),
+      channels: {
+        lark: { status: checks['lark-channel'].status, message: checks['lark-channel'].message },
+        dingtalk: { status: checks['dingtalk-channel'].status, message: checks['dingtalk-channel'].message },
+      },
+      skills: skillResults,
+      summary: { total, ok: okCount, warn: warnCount, fail: failCount },
+    };
+    console.log(JSON.stringify(output, null, 2));
+  } else {
+    console.log('');
+    console.log('─'.repeat(60));
+    console.log('');
+    console.log(bold('📊 汇总'));
+    console.log('');
+    console.log(`  ${green(`✅ 就绪: ${okCount}`)}  ${yellow(`⚠️ 部分可用: ${warnCount}`)}  ${red(`❌ 不可用: ${failCount}`)}  总计: ${total}`);
+
+    if (failCount > 0) {
+      console.log('');
+      console.log(bold('🔧 快速修复'));
+      console.log('');
+
+      // 去重收集所有 fix 命令
+      const allFixes = new Set();
+      for (const skill of skillResults) {
+        if (skill.status !== 'ok') {
+          for (const fix of skill.fixes) {
+            allFixes.add(fix);
+          }
+        }
+      }
+      let i = 1;
+      for (const fix of allFixes) {
+        console.log(`  ${i}. ${cyan(fix)}`);
+        i++;
+      }
+
+      if (FIX_MODE) {
+        console.log('');
+        console.log(bold('🔧 自动修复模式'));
+        console.log('');
+        for (const fix of allFixes) {
+          console.log(`  运行: ${cyan(fix)}`);
+          const [cmd, ...args] = fix.split(/\s+/);
+          // 对链式命令（含 &&）用 shell 执行
+          if (fix.includes('&&')) {
+            const code = await run('sh', ['-c', fix]);
+            if (code === 0) {
+              console.log(green('  ✅ 成功'));
+            } else {
+              console.log(yellow(`  ⚠️ 退出码 ${code}`));
+            }
+          } else {
+            const code = await run(cmd, args);
+            if (code === 0) {
+              console.log(green('  ✅ 成功'));
+            } else {
+              console.log(yellow(`  ⚠️ 退出码 ${code}`));
+            }
+          }
+          console.log('');
+        }
+        console.log(dim('  修复完成，建议重新运行 check 验证'));
+      } else {
+        console.log('');
+        console.log(dim('  提示: 运行 node bin/check.mjs --fix 尝试自动安装缺失依赖'));
+      }
+    }
+
+    console.log('');
+  }
+
+  // 退出码：有 fail 返回 1
+  process.exit(failCount > 0 ? 1 : 0);
+}
+
+main().catch((err) => {
+  console.error(red(`Fatal: ${err.message}`));
+  process.exit(2);
+});