codewave-openclaw-installer 1.0.2 → 2.1.0

package/bin/install-lib.mjs

@@ -0,0 +1,215 @@
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+
+export const SKILL_SUMMARIES = [
+  'acceptance-doc-entry    — 项目验收文档生成',
+  'pmo-weekly-report       — PMO 项目看板周报',
+  'popo-doc                — PoPo 文档查询下载',
+  'popo-robot-api          — PoPo 机器人 API',
+  'smart-customer-service  — 智能客服知识库',
+  'speed-to-text           — 通用音视频转文字稿',
+  'tencent-meeting         — 腾讯会议回放嗅探与下载',
+  'yidun-skill-sec         — 代码包安全扫描（易盾）',
+];
+
+export const CHANNEL_DEFINITIONS = {
+  lark: {
+    label: '飞书',
+    detectCommands: ['lark-cli'],
+    runtimeCommands: ['lark-cli', 'openclaw'],
+    desktopAppCandidates: ['Feishu.app', 'Lark.app', '飞书.app'],
+    configPaths: [
+      join(homedir(), '.openclaw', 'lark.json'),
+      join(homedir(), '.openclaw', 'extensions', '@openclaw', 'feishu'),
+      join(homedir(), '.openclaw', 'extensions', 'openclaw-lark'),
+    ],
+    envVars: ['LARK_APP_ID', 'LARK_APP_SECRET', 'FEISHU_APP_ID', 'FEISHU_APP_SECRET'],
+    installCommand: ['npx', ['-y', '@larksuite/openclaw-lark', 'install']],
+    initCandidates: [
+      ['lark-cli', ['auth', 'login', '--recommend']],
+    ],
+    qrCandidates: [],
+  },
+  dingtalk: {
+    label: '钉钉',
+    detectCommands: ['dws', 'dingtalk', 'dingtalk-workspace-cli'],
+    runtimeCommands: ['dws', 'dingtalk', 'dingtalk-workspace-cli'],
+    desktopAppCandidates: ['DingTalk.app', '钉钉.app'],
+    configPaths: [
+      join(homedir(), '.dws'),
+      join(homedir(), '.dingtalk'),
+      join(homedir(), '.config', 'dingtalk-workspace-cli'),
+    ],
+    envVars: ['DWS_CLIENT_ID', 'DWS_CLIENT_SECRET'],
+    installCommand: process.platform === 'win32'
+      ? ['powershell', ['-Command', 'irm https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.ps1 | iex']]
+      : ['sh', ['-c', 'curl -fsSL https://raw.githubusercontent.com/DingTalk-Real-AI/dingtalk-workspace-cli/main/scripts/install.sh | sh']],
+    initCandidates: [
+      ['dws', ['auth', 'login']],
+      ['dingtalk', ['auth', 'login']],
+      ['dingtalk-workspace-cli', ['auth', 'login']],
+    ],
+    qrCandidates: [],
+  },
+  wecom: {
+    label: '企业微信',
+    detectCommands: ['wecom-cli'],
+    runtimeCommands: ['wecom-cli'],
+    desktopAppCandidates: ['企业微信.app', 'WeCom.app', 'WeChatWork.app'],
+    configPaths: [],
+    envVars: [],
+    installCommand: ['npx', ['-y', '@wecom/cli', 'init']],
+    initCandidates: [],
+    qrCandidates: [],
+  },
+};
+
+export function createInstallContext(platform) {
+  return {
+    platform,
+    phases: [
+      '环境预检',
+      '核心依赖安装',
+      '渠道绑定引导',
+      'OpenClaw 扩展安装',
+      '安装后校验',
+      '配置向导',
+    ],
+    results: {},
+    warnings: [],
+    errors: [],
+    channels: {
+      lark: { status: 'pending', message: '未检测', source: 'unknown' },
+      dingtalk: { status: 'pending', message: '未检测', source: 'unknown' },
+      wecom: { status: 'pending', message: '未检测', source: 'unknown' },
+    },
+  };
+}
+
+export function evaluateChannelDetection(channelDefinition, detection) {
+  const desktopApps = detection.desktopApps ?? [];
+  const hintTags = [];
+  if (detection.commands.length > 0) hintTags.push('命令入口');
+  if (desktopApps.length > 0) hintTags.push('桌面客户端');
+  if (detection.configPaths.length > 0) hintTags.push('本地配置');
+  if (detection.envVars.length > 0) hintTags.push('环境变量');
+  const hintText = hintTags.join('、');
+
+  if (detection.commands.length > 0) {
+    return {
+      status: 'ready',
+      source: 'existing-runtime',
+      message: `已检测到${channelDefinition.label}运行入口${hintText ? `（${hintText}）` : ''}`,
+    };
+  }
+
+  if (desktopApps.length > 0 || detection.configPaths.length > 0 || detection.envVars.length > 0) {
+    return {
+      status: 'hinted',
+      source: 'existing-config',
+      message: `检测到${channelDefinition.label}环境线索${hintText ? `（${hintText}）` : ''}`,
+    };
+  }
+
+  return {
+    status: 'absent',
+    source: 'not-detected',
+    message: `未检测到 ${channelDefinition.label} 环境线索`,
+  };
+}
+
+export function shouldDryRun(argv = process.argv) {
+  return argv.includes('--dry-run');
+}
+
+export function classifyPythonInstallFailure(stderr = '') {
+  if (stderr.includes('externally-managed-environment') || stderr.includes('PEP 668')) {
+    return {
+      code: 'pep668',
+      message: '当前 Python 环境受 PEP 668 管理，建议改用 pipx 安装 razel-py-cli',
+    };
+  }
+
+  return {
+    code: 'generic',
+    message: 'Python CLI 安装失败，请检查 python3/pip3 是否可用',
+  };
+}
+
+export function buildRazelConfigBootstrap({
+  razelConfig = {},
+  env = process.env,
+  hasOpenclawLlm = false,
+} = {}) {
+  const writes = [];
+  const missing = [];
+
+  const queueWrite = (cli, key, value) => {
+    if (!value || razelConfig[key]) {
+      return;
+    }
+    writes.push({ cli, key, value });
+  };
+
+  queueWrite('razel-cli', 'popo_app_id', env.POPO_APP_ID);
+  queueWrite('razel-cli', 'popo_app_secret', env.POPO_APP_SECRET);
+
+  const hasPopoAfterBootstrap = Boolean(
+    razelConfig.popo_app_id || env.POPO_APP_ID,
+  ) && Boolean(
+    razelConfig.popo_app_secret || env.POPO_APP_SECRET,
+  );
+
+  if (!hasPopoAfterBootstrap) {
+    missing.push({
+      group: 'popo',
+      title: 'PoPo 认证缺失',
+      commands: [
+        'razel-cli config set popo_app_id <your-app-id>',
+        'razel-cli config set popo_app_secret <your-app-secret>',
+      ],
+    });
+  }
+
+  queueWrite('razel-py-cli', 'llm_base_url', env.OPENAI_BASE_URL || env.ACCEPTANCE_LLM_BASE_URL);
+  queueWrite('razel-py-cli', 'llm_api_key', env.OPENAI_API_KEY || env.ACCEPTANCE_LLM_API_KEY);
+
+  const hasLlmAfterBootstrap = hasOpenclawLlm
+    || (Boolean(razelConfig.llm_base_url || razelConfig.openai_base_url || env.OPENAI_BASE_URL || env.ACCEPTANCE_LLM_BASE_URL)
+      && Boolean(razelConfig.llm_api_key || razelConfig.openai_api_key || env.OPENAI_API_KEY || env.ACCEPTANCE_LLM_API_KEY));
+
+  if (!hasLlmAfterBootstrap) {
+    missing.push({
+      group: 'llm',
+      title: 'LLM 配置缺失',
+      commands: [
+        'razel-py-cli config set llm_base_url <your-llm-base-url>',
+        'razel-py-cli config set llm_api_key <your-llm-api-key>',
+      ],
+    });
+  }
+
+  queueWrite('razel-py-cli', 'dashscope_api_key', env.DASHSCOPE_API_KEY);
+  queueWrite('razel-py-cli', 'aigw_base_url', env.AIGW_BASE_URL);
+  queueWrite('razel-py-cli', 'aigw_api_key', env.AIGW_API_KEY);
+  queueWrite('razel-py-cli', 'local_server', env.LOCAL_ASR_SERVER || env.LOCAL_SERVER);
+
+  const hasAsrAfterBootstrap = Boolean(razelConfig.dashscope_api_key || env.DASHSCOPE_API_KEY)
+    || (Boolean(razelConfig.aigw_base_url || env.AIGW_BASE_URL)
+      && Boolean(razelConfig.aigw_api_key || env.AIGW_API_KEY))
+    || Boolean(razelConfig.local_server || env.LOCAL_ASR_SERVER || env.LOCAL_SERVER);
+
+  if (!hasAsrAfterBootstrap) {
+    missing.push({
+      group: 'asr',
+      title: 'ASR Provider 缺失',
+      commands: [
+        'razel-py-cli config set dashscope_api_key <your-dashscope-key>',
+        'razel-py-cli config set aigw_base_url <your-aigw-base-url>',
+        'razel-py-cli config set aigw_api_key <your-aigw-api-key>',
+      ],
+    });
+  }
+
+  return { writes, missing };
+}