@lxzc-tech/star-cli 0.1.0

package/README.md

@@ -0,0 +1,35 @@
+# @lxzc-tech/star-cli
+
+面向 AI Agent 的数据仓库指标披露 CLI。
+
+## 安装
+
+```bash
+npm install -g @lxzc-tech/star-cli
+```
+
+安装时会自动下载适配当前系统(macOS / Linux / Windows,x64 / arm64)的原生二进制,并校验 checksum。
+
+## 使用
+
+```bash
+star-cli --help
+star-cli auth set --server https://... --cert ... --key ...
+star-cli metrics list --format json
+```
+
+完整命令说明见 `star-cli <command> --help`。
+
+## 支持的平台
+
+- macOS (Intel / Apple Silicon)
+- Linux (x64 / arm64)
+- Windows (x64 / arm64)
+
+其他平台需要从源码构建。
+
+## 卸载
+
+```bash
+npm uninstall -g @lxzc-tech/star-cli
+```

package/bin/star-cli.js

@@ -0,0 +1,32 @@
+#!/usr/bin/env node
+// npm 的 bin 入口。真正的工作由 postinstall(scripts/install.js)下载到本目录
+// 的原生二进制(star-cli / star-cli.exe)完成,这里只做参数与 stdio 转发。
+//
+// 用 Node 脚本作为 bin 入口(而不是直接把 package.json 的 bin 指向原生二进制)
+// 是跨平台 npm 包的标准做法:npm 在 Windows 上为 bin 生成的是 .cmd 包装器,
+// 需要能被当作脚本执行的文件,不能直接 exec 一个原生可执行文件。
+'use strict';
+
+const path = require('path');
+const os = require('os');
+const { spawnSync } = require('child_process');
+
+const binName = os.platform() === 'win32' ? 'star-cli.exe' : 'star-cli';
+const binPath = path.join(__dirname, binName);
+
+const result = spawnSync(binPath, process.argv.slice(2), { stdio: 'inherit' });
+
+if (result.error) {
+  if (result.error.code === 'ENOENT') {
+    console.error(
+      '[star-cli] 未找到已安装的二进制文件。postinstall 可能被跳过了' +
+        '(常见于 --ignore-scripts 安装),请重新运行:\n' +
+        `  npm rebuild @lxzc-tech/star-cli`
+    );
+  } else {
+    console.error(`[star-cli] 启动失败: ${result.error.message}`);
+  }
+  process.exit(1);
+}
+
+process.exit(result.status === null ? 1 : result.status);

package/package.json

@@ -0,0 +1,22 @@
+{
+  "name": "@lxzc-tech/star-cli",
+  "version": "0.1.0",
+  "description": "面向 AI Agent 的数据仓库指标披露 CLI(star-cli)",
+  "license": "UNLICENSED",
+  "os": ["darwin", "linux", "win32"],
+  "cpu": ["x64", "arm64"],
+  "bin": {
+    "star-cli": "bin/star-cli.js"
+  },
+  "files": [
+    "bin/star-cli.js",
+    "scripts/install.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/install.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/scripts/install.js

@@ -0,0 +1,143 @@
+#!/usr/bin/env node
+// postinstall:下载对应平台的 star-cli 二进制并放到 npm bin 机制能找到的位置。
+//
+// 版本对应规则:本 npm 包的版本号(package.json 的 version)必须与 GitHub
+// Release 的 tag 一一对应(npm 包 1.2.3 对应 tag v1.2.3)。每次发布新版
+// star-cli,必须同步发布同版本号的 npm 包,否则 npm install 会去下载一个
+// 不存在的 tag 而失败。
+//
+// 不引入任何 npm 依赖(避免供应链风险):只用 Node 内置模块下载/校验,
+// 用系统自带的 tar 命令解压(macOS/Linux 原生支持 tar.gz;Windows 10+
+// 自带的 tar.exe 同时支持 tar.gz 和 zip)。
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+const os = require('os');
+const https = require('https');
+const crypto = require('crypto');
+const { execFileSync } = require('child_process');
+
+const GITHUB_REPO = 'lxzc-tech/star-cli-releases';
+const PKG = require('../package.json');
+const VERSION = PKG.version;
+const TAG = `v${VERSION}`;
+
+const PLATFORM_MAP = { darwin: 'darwin', linux: 'linux', win32: 'windows' };
+const ARCH_MAP = { x64: 'amd64', arm64: 'arm64' };
+
+function fail(msg) {
+  console.error(`[star-cli] 安装失败: ${msg}`);
+  process.exit(1);
+}
+
+function resolveTarget() {
+  const goos = PLATFORM_MAP[os.platform()];
+  const goarch = ARCH_MAP[os.arch()];
+  if (!goos || !goarch) {
+    fail(
+      `不支持的平台 ${os.platform()}/${os.arch()}。` +
+        `star-cli 目前提供 darwin/linux/windows × amd64/arm64 的预编译产物。` +
+        `如需其他平台,请从源码构建: https://github.com/${GITHUB_REPO}`
+    );
+  }
+  const ext = goos === 'windows' ? 'zip' : 'tar.gz';
+  const archiveName = `star-cli_${goos}_${goarch}.${ext}`;
+  return { goos, goarch, ext, archiveName };
+}
+
+function download(url, destPath) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(destPath);
+    const req = https.get(url, { headers: { 'User-Agent': 'star-cli-npm-installer' } }, (res) => {
+      // GitHub Releases 下载地址会 302 到 objects.githubusercontent.com
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        file.close();
+        fs.unlinkSync(destPath);
+        return download(res.headers.location, destPath).then(resolve, reject);
+      }
+      if (res.statusCode !== 200) {
+        file.close();
+        fs.unlinkSync(destPath);
+        return reject(new Error(`下载失败,HTTP ${res.statusCode}: ${url}`));
+      }
+      res.pipe(file);
+      file.on('finish', () => file.close(resolve));
+    });
+    req.on('error', (err) => {
+      file.close();
+      if (fs.existsSync(destPath)) fs.unlinkSync(destPath);
+      reject(err);
+    });
+  });
+}
+
+function sha256(filePath) {
+  const hash = crypto.createHash('sha256');
+  hash.update(fs.readFileSync(filePath));
+  return hash.digest('hex');
+}
+
+async function verifyChecksum(archivePath, archiveName, tmpDir) {
+  const checksumsPath = path.join(tmpDir, 'checksums.txt');
+  const checksumsUrl = `https://github.com/${GITHUB_REPO}/releases/download/${TAG}/checksums.txt`;
+  await download(checksumsUrl, checksumsPath);
+
+  const checksumsContent = fs.readFileSync(checksumsPath, 'utf8');
+  const line = checksumsContent.split('\n').find((l) => l.trim().endsWith(archiveName));
+  if (!line) {
+    fail(`checksums.txt 中找不到 ${archiveName} 的条目,拒绝安装未经校验的产物`);
+  }
+  const expected = line.trim().split(/\s+/)[0];
+  const actual = sha256(archivePath);
+  if (expected.toLowerCase() !== actual.toLowerCase()) {
+    fail(
+      `checksum 不匹配(可能下载损坏或被篡改)\n` +
+        `  期望: ${expected}\n` +
+        `  实际: ${actual}`
+    );
+  }
+}
+
+function extract(archivePath, ext, destDir) {
+  if (ext === 'zip') {
+    // Windows 10+ 自带的 tar.exe 也能解 zip;这里显式走 tar -xf 统一路径。
+    execFileSync('tar', ['-xf', archivePath, '-C', destDir], { stdio: 'inherit' });
+  } else {
+    execFileSync('tar', ['-xzf', archivePath, '-C', destDir], { stdio: 'inherit' });
+  }
+}
+
+async function main() {
+  const { goos, ext, archiveName } = resolveTarget();
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), 'star-cli-install-'));
+  const archivePath = path.join(tmpDir, archiveName);
+  const downloadUrl = `https://github.com/${GITHUB_REPO}/releases/download/${TAG}/${archiveName}`;
+
+  console.log(`[star-cli] 下载 ${TAG} (${archiveName}) ...`);
+  try {
+    await download(downloadUrl, archivePath);
+    await verifyChecksum(archivePath, archiveName, tmpDir);
+
+    console.log('[star-cli] 校验通过,解压中 ...');
+    extract(archivePath, ext, tmpDir);
+
+    const binName = goos === 'windows' ? 'star-cli.exe' : 'star-cli';
+    const extractedBin = path.join(tmpDir, binName);
+    if (!fs.existsSync(extractedBin)) {
+      fail(`解压后未找到预期的二进制文件: ${extractedBin}`);
+    }
+
+    const binDir = path.join(__dirname, '..', 'bin');
+    fs.mkdirSync(binDir, { recursive: true });
+    const targetBin = path.join(binDir, binName);
+    fs.copyFileSync(extractedBin, targetBin);
+    fs.chmodSync(targetBin, 0o755);
+
+    console.log(`[star-cli] 安装完成: ${targetBin}`);
+  } finally {
+    fs.rmSync(tmpDir, { recursive: true, force: true });
+  }
+}
+
+main().catch((err) => fail(err.message || String(err)));