ribo-cli-setup 2.0.0

package/README.md

@@ -0,0 +1,74 @@
+# ribo-cli-setup npx 一键安装器
+
+员工无需手动下载二进制、无需 sudo，一条命令完成「检测平台 → 从网关下载对应二进制 → 接入 WorkBuddy/千问办公 → 实名授权」。
+
+## 用法
+
+```bash
+# 最简：自动检测平台，从默认网关下载并接入 WorkBuddy
+npx ribo-cli-setup
+
+# 接入千问办公
+npx ribo-cli-setup --qwenwork
+
+# 指定内网网关地址（下载源 + CLI 运行地址）
+npx ribo-cli-setup --gateway https://gw.ribo.internal
+
+# 组合示例
+npx ribo-cli-setup --gateway https://gw.ribo.internal --target qwenwork --bin-dir ~/bin
+
+# 仅下载二进制，不自动授权
+npx ribo-cli-setup --skip-auth
+
+# 解除注册
+npx ribo-cli-setup --uninstall --target workbuddy
+```
+
+也可用环境变量代替 `--gateway`：
+
+```bash
+RIBO_GATEWAY_URL=https://gw.ribo.internal npx ribo-cli-setup
+```
+
+## 工作原理
+
+1. **平台检测**：`process.platform`（darwin/linux/win32）+ `process.arch`（arm64/x64→amd64）
+2. **拉取清单**：`GET <gateway>/download/manifest` → 各平台文件名、大小、SHA256、最新版本
+3. **下载校验**：`GET <gateway>/download/<file>` 流式下载到 `~/.local/bin/ribo-cli`（Windows 为 `%LOCALAPPDATA%\ribo-cli-setup\ribo-cli.exe`），逐块计算 SHA256 并与清单比对，损坏即报错
+4. **配置网关**：`ribo-cli config set-gateway <url>`
+5. **接入客户端**：`ribo-cli install --workbuddy|--qwenwork`（写 mcp.json + 装 Skill 包）
+6. **实名授权**：交互确认后执行 `ribo-cli auth init`（企微扫码/mock 确认页）
+
+> 二进制由网关 `/download/**` 端点分发（见 `gateway/.../api/DistController.java`），文件名白名单 + 目录穿越防护，公开可下载（运行仍需实名授权）。
+
+## 选项
+
+| 选项 | 说明 |
+|---|---|
+| `-g, --gateway <url>` | 网关地址，默认 `https://aigc.ribo-group.com/asushiye` |
+| `-t, --target <name>` | `workbuddy` \| `qwenwork` |
+| `--workbuddy` / `--qwenwork` | target 的快捷写法 |
+| `--bin-dir <dir>` | 二进制安装目录，默认 `~/.local/bin` |
+| `-f, --force` | 忽略本地已有版本，强制重新下载 |
+| `--skip-auth` | 安装后不自动执行 auth init |
+| `--uninstall` | 解除注册 |
+| `-y, --yes` | 跳过确认 |
+
+## 发布到 npm
+
+```bash
+cd npx
+npm login
+npm publish            # 包名 ribo-cli-setup，bin 入口 bin/cli.js
+```
+
+发布后全公司即可 `npx ribo-cli-setup` 一键接入。若用私有 registry，员工侧加 `--registry` 或配置 `.npmrc`。
+
+## 本地测试（无需发布）
+
+```bash
+# 在项目根目录，用临时 HOME 隔离测试，不影响真实配置
+HOME=/tmp/ribo-test node npx/bin/cli.js \
+  --gateway http://127.0.0.1:8081 --target qwenwork \
+  --bin-dir /tmp/ribo-test/bin --skip-auth --yes
+```

package/bin/cli.js

@@ -0,0 +1,352 @@
+#!/usr/bin/env node
+/**
+ * ribo-cli-setup 一键安装器（npx）
+ *
+ * 用法：
+ *   npx ribo-cli-setup                       # 自动检测平台，从默认网关下载并接入 WorkBuddy
+ *   npx ribo-cli-setup --qwenwork            # 接入千问办公
+ *   npx ribo-cli-setup --gateway <url>       # 指定网关地址（下载源 + CLI 运行地址）
+ *   npx ribo-cli-setup --target workbuddy|qwenwork
+ *   npx ribo-cli-setup --force               # 忽略本地已存在版本，强制重新下载
+ *   npx ribo-cli-setup --uninstall           # 解除注册
+ *
+ * 环境变量：RIBO_GATEWAY_URL 可替代 --gateway
+ * 流程：检测 os/arch → 拉 /download/manifest → 匹配平台二进制 → 下载校验 sha256
+ *       → 安装到 ~/.local/bin（或 --bin-dir）→ 调 ribo-cli install / auth init
+ */
+'use strict';
+
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+const https = require('https');
+const http = require('http');
+const crypto = require('crypto');
+const { execFileSync, spawnSync } = require('child_process');
+
+const DEFAULT_GATEWAY = 'https://aigc.ribo-group.com/asushiye';
+const BIN_NAME = process.platform === 'win32' ? 'ribo-cli.exe' : 'ribo-cli';
+
+// ---------- 参数解析 ----------
+function parseArgs(argv) {
+  const opts = {
+    gateway: process.env.RIBO_GATEWAY_URL || DEFAULT_GATEWAY,
+    target: null,
+    binDir: null,
+    force: false,
+    uninstall: false,
+    skipAuth: false,
+    yes: false,
+    help: false,
+  };
+  for (let i = 0; i < argv.length; i++) {
+    const a = argv[i];
+    switch (a) {
+      case '--gateway': case '-g': opts.gateway = argv[++i]; break;
+      case '--target': case '-t': opts.target = argv[++i]; break;
+      case '--bin-dir': opts.binDir = argv[++i]; break;
+      case '--workbuddy': opts.target = 'workbuddy'; break;
+      case '--qwenwork': opts.target = 'qwenwork'; break;
+      case '--force': case '-f': opts.force = true; break;
+      case '--uninstall': opts.uninstall = true; break;
+      case '--skip-auth': opts.skipAuth = true; break;
+      case '--yes': case '-y': opts.yes = true; break;
+      case '--help': case '-h': opts.help = true; break;
+      default:
+        console.error(`未知参数: ${a}（用 --help 查看用法）`);
+        process.exit(2);
+    }
+  }
+  opts.gateway = opts.gateway.replace(/\/+$/, '');
+  if (opts.target && !['workbuddy', 'qwenwork'].includes(opts.target)) {
+    console.error(`--target 仅支持 workbuddy 或 qwenwork`);
+    process.exit(2);
+  }
+  return opts;
+}
+
+function printHelp() {
+  console.log(`ribo-cli-setup 一键安装器
+
+用法:
+  npx ribo-cli-setup [选项]
+
+选项:
+  -g, --gateway <url>     网关地址（下载源+运行地址），默认 ${DEFAULT_GATEWAY}
+                          也可用环境变量 RIBO_GATEWAY_URL
+  -t, --target <name>     接入目标: workbuddy | qwenwork（默认交互选择/workbuddy）
+      --workbuddy         等价于 --target workbuddy
+      --qwenwork          等价于 --target qwenwork
+      --bin-dir <dir>     二进制安装目录（默认 ~/.local/bin）
+  -f, --force             忽略本地已有版本，强制重新下载
+      --skip-auth         安装后不自动执行 auth init
+      --uninstall         解除注册（移除 mcp.json 条目与 Skill 包）
+  -y, --yes               跳过所有确认
+  -h, --help              显示本帮助`);
+}
+
+// ---------- 平台检测 ----------
+function detectPlatform() {
+  const p = process.platform; // darwin | linux | win32
+  const a = process.arch;     // arm64 | x64
+  const osName = p === 'darwin' ? 'darwin' : p === 'linux' ? 'linux' : p === 'win32' ? 'windows' : null;
+  const archName = a === 'arm64' ? 'arm64' : a === 'x64' ? 'amd64' : null;
+  if (!osName || !archName) {
+    console.error(`不支持的平台: ${p}/${a}（仅支持 darwin|linux|windows × amd64|arm64）`);
+    process.exit(1);
+  }
+  return { osName, archName, isWindows: p === 'win32' };
+}
+
+// ---------- HTTP ----------
+function httpGet(url, redirect = 0) {
+  return new Promise((resolve, reject) => {
+    if (redirect > 5) return reject(new Error('重定向次数过多'));
+    const mod = url.startsWith('https:') ? https : http;
+    const req = mod.get(url, { timeout: 30000 }, (res) => {
+      const loc = res.headers.location;
+      if ([301, 302, 303, 307, 308].includes(res.statusCode) && loc) {
+        res.resume();
+        const next = new URL(loc, url).toString();
+        return httpGet(next, redirect + 1).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        let body = '';
+        res.on('data', (d) => (body += d));
+        res.on('end', () => reject(new Error(`HTTP ${res.statusCode}: ${body.slice(0, 200)}`)));
+        return;
+      }
+      resolve(res);
+    });
+    req.on('error', reject);
+    req.on('timeout', () => req.destroy(new Error('请求超时')));
+  });
+}
+
+async function getJSON(url) {
+  const res = await httpGet(url);
+  return new Promise((resolve, reject) => {
+    let body = '';
+    res.on('data', (d) => (body += d));
+    res.on('end', () => {
+      try { resolve(JSON.parse(body)); }
+      catch (e) { reject(new Error(`响应非 JSON（${url}）: ${body.slice(0, 120)}`)); }
+    });
+    res.on('error', reject);
+  });
+}
+
+async function downloadFile(url, destPath, expectedSha, expectedSize) {
+  const res = await httpGet(url);
+  const tmp = destPath + '.download';
+  await new Promise((resolve, reject) => {
+    const ws = fs.createWriteStream(tmp);
+    const hash = crypto.createHash('sha256');
+    let received = 0;
+    let lastPct = -10;
+    res.on('data', (d) => {
+      received += d.length;
+      hash.update(d);
+      if (expectedSize) {
+        const pct = Math.floor((received / expectedSize) * 100);
+        if (pct - lastPct >= 10) { process.stdout.write(`\r  下载中… ${pct}%`); lastPct = pct; }
+      }
+    });
+    res.pipe(ws);
+    ws.on('finish', () => {
+      if (expectedSize) process.stdout.write('\r  下载中… 100%\n');
+      ws.close(() => {
+        const actual = hash.digest('hex');
+        const headerSha = res.headers['x-ribo-sha256'];
+        const sha = expectedSha || headerSha;
+        if (sha && actual !== sha) {
+          fs.unlink(tmp, () => {});
+          return reject(new Error(`SHA256 校验失败\n  期望: ${sha}\n  实际: ${actual}`));
+        }
+        resolve();
+      });
+    });
+    ws.on('error', reject);
+    res.on('error', reject);
+  });
+  fs.renameSync(tmp, destPath);
+  if (process.platform !== 'win32') fs.chmodSync(destPath, 0o755);
+}
+
+// ---------- 安装目录 ----------
+function resolveBinDir(opts) {
+  if (opts.binDir) return path.resolve(opts.binDir);
+  if (process.platform === 'win32') {
+    const base = process.env.LOCALAPPDATA || path.join(os.homedir(), 'AppData', 'Local');
+    return path.join(base, 'ribo-cli-setup');
+  }
+  return path.join(os.homedir(), '.local', 'bin');
+}
+
+function localVersion(binPath) {
+  try {
+    const out = execFileSync(binPath, ['version'], { encoding: 'utf8', timeout: 8000 });
+    const m = out.match(/(\d+\.\d+\.\d+)/);
+    return m ? m[1] : null;
+  } catch { return null; }
+}
+
+// ---------- 交互确认 ----------
+function confirm(question, assumeYes) {
+  if (assumeYes) return Promise.resolve(true);
+  return new Promise((resolve) => {
+    process.stdout.write(`${question} [y/N] `);
+    process.stdin.once('data', (d) => resolve(/^y/i.test(d.toString().trim())));
+  });
+}
+
+// ---------- 主流程 ----------
+async function main() {
+  const opts = parseArgs(process.argv.slice(2));
+  if (opts.help) { printHelp(); return; }
+
+  const plat = detectPlatform();
+  const binDir = resolveBinDir(opts);
+  const binPath = path.join(binDir, BIN_NAME);
+
+  console.log('┌─────────────────────────────────────────────┐');
+  console.log('│        ribo-cli-setup 一键安装器               │');
+  console.log('└─────────────────────────────────────────────┘');
+  console.log(`  平台: ${plat.osName}/${plat.archName}`);
+  console.log(`  网关: ${opts.gateway}`);
+  console.log(`  安装目录: ${binDir}`);
+  console.log();
+
+  // 拉取清单
+  let manifest;
+  try {
+    manifest = await getJSON(`${opts.gateway}/download/manifest`);
+  } catch (e) {
+    console.error(`✗ 无法从网关获取版本清单: ${e.message}`);
+    console.error(`  请确认网关已启动且 /download 可访问（--gateway 指定正确地址）`);
+    process.exit(1);
+  }
+
+  const target = manifest.files.find(
+    (f) => f.os === plat.osName && f.arch === plat.archName && f.version === manifest.latest_version
+  ) || manifest.files.find((f) => f.os === plat.osName && f.arch === plat.archName);
+
+  if (!target) {
+    console.error(`✗ 网关未提供 ${plat.osName}/${plat.archName} 平台的二进制`);
+    console.error(`  可用: ${manifest.files.map((f) => `${f.os}/${f.arch}@${f.version}`).join(', ')}`);
+    process.exit(1);
+  }
+
+  // 版本比较：本地已是最新且未 --force 则跳过下载
+  const existing = localVersion(binPath);
+  let needDownload = opts.force || existing !== target.version;
+  if (existing === target.version && !opts.force) {
+    console.log(`· 本地已是最新版本 ${existing}，跳过下载（--force 可强制重装）`);
+  }
+
+  // 卸载分支
+  if (opts.uninstall) {
+    const tgt = opts.target || (await pickTarget(opts));
+    if (!tgt) { console.error('未指定接入目标，已取消'); process.exit(1); }
+    const flag = tgt === 'qwenwork' ? '--qwenwork' : '--workbuddy';
+    if (!fs.existsSync(binPath)) { console.error(`✗ 未找到 ${binPath}，无法解除注册`); process.exit(1); }
+    console.log(`→ 解除 ${tgt} 注册…`);
+    run(binPath, ['install', flag, '--uninstall']);
+    return;
+  }
+
+  if (needDownload) {
+    fs.mkdirSync(binDir, { recursive: true });
+    const url = `${opts.gateway}/download/${target.file}`;
+    console.log(`→ 下载 ${target.file} (${(target.size / 1024 / 1024).toFixed(1)} MB)…`);
+    try {
+      await downloadFile(url, binPath, target.sha256, target.size);
+    } catch (e) {
+      console.error(`\n✗ 下载失败: ${e.message}`);
+      process.exit(1);
+    }
+    console.log(`✓ 已安装 ${BIN_NAME} ${target.version} → ${binPath}`);
+    // 校验 sha256（下载函数已校验，这里再确认本地文件）
+    const diskSha = crypto.createHash('sha256').update(fs.readFileSync(binPath)).digest('hex');
+    if (target.sha256 && diskSha !== target.sha256) {
+      console.error(`✗ 本地文件 SHA256 不匹配，已损坏`);
+      process.exit(1);
+    }
+  } else {
+    console.log(`· 使用本地二进制 ${binPath}`);
+  }
+
+  // 网关地址写入 CLI 配置
+  console.log('→ 配置网关地址…');
+  run(binPath, ['config', 'set-gateway', opts.gateway]);
+
+  // 选择接入目标
+  const tgt = opts.target || (await pickTarget(opts));
+  if (!tgt) { console.error('未指定接入目标，已取消（仅完成二进制安装）'); notePathIfMissing(binDir); return; }
+  const flag = tgt === 'qwenwork' ? '--qwenwork' : '--workbuddy';
+
+  console.log(`→ 接入 ${tgt === 'qwenwork' ? '千问办公' : 'WorkBuddy'}…`);
+  run(binPath, ['install', flag]);
+
+  // 实名授权
+  if (!opts.skipAuth) {
+    const doAuth = opts.yes || (await confirm('是否现在执行实名授权（ribo-cli auth init）？', false));
+    if (doAuth) {
+      console.log('→ 发起实名授权（将打开浏览器/企微扫码，完成后回到终端）…');
+      runInteractive(binPath, ['auth', 'init']);
+    } else {
+      console.log('· 已跳过授权，稍后可手动执行: ribo-cli auth init');
+    }
+  }
+
+  notePathIfMissing(binDir);
+  console.log();
+  console.log('✓ 全部完成。');
+}
+
+// 选择接入目标（无 --target 时交互；非 TTY 默认 workbuddy）
+async function pickTarget(opts) {
+  if (!process.stdin.isTTY || opts.yes) return 'workbuddy';
+  return new Promise((resolve) => {
+    console.log('请选择接入目标:');
+    console.log('  1) WorkBuddy   (~/.workbuddy)');
+    console.log('  2) 千问办公     (~/.qwenworkcn)');
+    process.stdout.write('输入 1 或 2 [默认 1]: ');
+    process.stdin.once('data', (d) => {
+      const v = d.toString().trim();
+      resolve(v === '2' ? 'qwenwork' : 'workbuddy');
+    });
+  });
+}
+
+function run(bin, args) {
+  const r = spawnSync(bin, args, { stdio: 'inherit' });
+  if (r.status !== 0 && r.status !== null) {
+    // install/config 非致命错误也继续（如已注册）
+  }
+}
+function runInteractive(bin, args) {
+  try { execFileSync(bin, args, { stdio: 'inherit' }); }
+  catch { /* auth init 可能因用户取消而非零退出 */ }
+}
+
+// 若 binDir 不在 PATH，给出提示
+function notePathIfMissing(binDir) {
+  const p = (process.env.PATH || '').split(path.delimiter);
+  if (!p.includes(binDir)) {
+    console.log();
+    console.log(`⚠ ${binDir} 不在 PATH 中，请手动加入：`);
+    if (process.platform === 'win32') {
+      console.log(`   setx PATH "%PATH%;${binDir}"`);
+    } else {
+      const shell = process.env.SHELL || '/bin/bash';
+      const rc = shell.includes('zsh') ? '~/.zshrc' : '~/.bashrc';
+      console.log(`   echo 'export PATH="${binDir}:$PATH"' >> ${rc} && source ${rc}`);
+    }
+  }
+}
+
+main().catch((e) => {
+  console.error(`\n✗ 安装失败: ${e.message}`);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "ribo-cli-setup",
+  "version": "2.0.0",
+  "description": "ribo-cli 一键安装器：检测操作系统与 CPU 架构，从 ribo 网关下载对应平台 CLI 二进制，完成 WorkBuddy / 千问办公接入与实名授权",
+  "bin": {
+    "ribo-cli-setup": "bin/cli.js"
+  },
+  "files": [
+    "bin/"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "keywords": [
+    "ribo",
+    "erp",
+    "mcp",
+    "cli"
+  ],
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "license": "UNLICENSED",
+  "private": false
+}