@guandata/guancli 1.0.61 → 1.0.62

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## @guandata/guancli 1.0.62 - 2026-09-19
+
+- 安装包按平台拆分：主包只保留启动器、Skill 与文档，原生程序由同版本的 `@guandata/guancli-<平台>-<架构>` 可选依赖提供，安装时只下载当前系统的一份，安装命令与 CLI 行为不变。
+- 平台包缺失或主包与平台包版本不一致时给出可操作提示；新增 `pack:all`、`verify:platforms` 与自动选包/注册表门禁，发布前校验五个平台包。
+
 ## @guandata/guancli 1.0.61 - 2026-09-18
 
 - 指标取数不再静默忽略无效筛选与排序字段：`--dim`、`--filter`、`--sort-asc`/`--sort-desc` 都按指标详情中的字段校验，未命中返回 `METRIC_UNSUPPORTED_DIMENSION`；结构化 `--filter-json`/`--filter-file` 在解析阶段返回 `FILTER_UNKNOWN_FIELD`，不会透传未知字段。

package/README.md

@@ -10,6 +10,8 @@ npm install -g --foreground-scripts @guandata/guancli
 
 > 全局安装/升级时会通过 postinstall 自动执行一次 `guancli install-skill` 刷新 AI skill。`--foreground-scripts` 用于显示明确的成功、失败或跳过结果；失败时按提示手动运行 `guancli install-skill`。CI 等无需 skill 的环境可设 `GUAN_SKIP_INSTALL_SKILL=1` 跳过。
 
+安装包会通过 npm `optionalDependencies` 自动选择当前系统的原生二进制。不要使用 `--omit=optional` 或 `optional=false`；企业 npm 镜像也需要同步对应的 `@guandata/guancli-<平台>-<架构>` 包。若平台包缺失，CLI 会显示对应包名和重新安装方法。
+
 也可以直接使用：
 
 ```bash

package/bin/platforms.js

@@ -0,0 +1,44 @@
+"use strict";
+
+// Single source of truth for the optionalDependencies platform-package split.
+// bin/run.js, scripts/build.js and the build/preflight tests all read this file
+// so that the matrix, the package names and the embedded binary names can never
+// drift apart.
+
+const PACKAGE_PREFIX = "@guandata/guancli";
+const CLI_NAME = "guancli";
+const BINARY_NAMES = ["guancli"];
+
+const PLATFORM_TARGETS = [
+  { platform: "darwin", arch: "arm64", suffix: "darwin-arm64", ext: "" },
+  { platform: "darwin", arch: "x64", suffix: "darwin-x64", ext: "" },
+  { platform: "linux", arch: "x64", suffix: "linux-x64", ext: "" },
+  { platform: "linux", arch: "arm64", suffix: "linux-arm64", ext: "" },
+  { platform: "win32", arch: "x64", suffix: "win32-x64", ext: ".exe" },
+].map((target) => ({
+  ...target,
+  key: `${target.platform}-${target.arch}`,
+  packageName: `${PACKAGE_PREFIX}-${target.suffix}`,
+  binaries: BINARY_NAMES.map((name) => `${name}${target.ext}`),
+}));
+
+function targetForRuntime(platform, arch) {
+  return PLATFORM_TARGETS.find(
+    (target) => target.platform === platform && target.arch === arch
+  );
+}
+
+function optionalDependencies(version) {
+  return Object.fromEntries(
+    PLATFORM_TARGETS.map((target) => [target.packageName, version])
+  );
+}
+
+module.exports = {
+  CLI_NAME,
+  PACKAGE_PREFIX,
+  BINARY_NAMES,
+  PLATFORM_TARGETS,
+  optionalDependencies,
+  targetForRuntime,
+};

package/bin/run.js

@@ -7,34 +7,79 @@ const path = require("path");
 const fs = require("fs");
 const os = require("os");
 const { createInstallChildEnv, reexecInstallCommand } = require("./install-env");
-
-const PLATFORM_MAP = {
-  "darwin-arm64": "guancli-darwin-arm64",
-  "darwin-x64": "guancli-darwin-x64",
-  "linux-x64": "guancli-linux-x64",
-  "linux-arm64": "guancli-linux-arm64",
-  "win32-x64": "guancli-win32-x64.exe",
-};
-
-function getBinaryPath() {
-  const key = `${process.platform}-${process.arch}`;
-  const binaryName = PLATFORM_MAP[key];
-  if (!binaryName) {
-    console.error(
-      `Unsupported platform: ${key}\nSupported: ${Object.keys(PLATFORM_MAP).join(", ")}`
+const {
+  BINARY_NAMES,
+  PACKAGE_PREFIX,
+  PLATFORM_TARGETS,
+  targetForRuntime,
+} = require("./platforms");
+
+// The native binaries are delivered by per-platform optional dependencies, so
+// an installation only downloads and unpacks the current OS/architecture.
+function resolvePlatformBinaries(options = {}) {
+  const platform = options.platform || process.platform;
+  const arch = options.arch || process.arch;
+  const resolvePackage = options.resolvePackage || require.resolve;
+  const exists = options.exists || fs.existsSync;
+  const readJson =
+    options.readJson || ((filename) => JSON.parse(fs.readFileSync(filename, "utf8")));
+  const key = `${platform}-${arch}`;
+  const target = targetForRuntime(platform, arch);
+  if (!target) {
+    throw new Error(
+      `Unsupported platform: ${key}\nSupported: ${PLATFORM_TARGETS.map((item) => item.key).join(", ")}`
     );
-    process.exit(1);
   }
 
-  const binaryPath = path.join(__dirname, "..", "binaries", binaryName);
-  if (!fs.existsSync(binaryPath)) {
-    console.error(
-      `Binary not found: ${binaryPath}\nRun 'npm run build' to compile binaries.`
-    );
-    process.exit(1);
+  try {
+    const packageJson = resolvePackage(`${target.packageName}/package.json`);
+    const platformVersion = readJson(packageJson).version;
+    const mainVersion = readJson(path.join(__dirname, "..", "package.json")).version;
+    if (platformVersion !== mainVersion) {
+      throw new Error(
+        `Platform package ${target.packageName} version ${platformVersion} does not match ` +
+          `${PACKAGE_PREFIX} ${mainVersion}. Reinstall ${PACKAGE_PREFIX}.`
+      );
+    }
+    const binDir = path.join(path.dirname(packageJson), "bin");
+    const binaryPaths = {};
+    for (const binary of target.binaries) {
+      const binaryPath = path.join(binDir, binary);
+      if (!exists(binaryPath)) {
+        throw new Error(
+          `Platform package ${target.packageName} is installed but its binary is missing: ${binaryPath}. ` +
+            `Reinstall ${PACKAGE_PREFIX}.`
+        );
+      }
+      binaryPaths[binary.replace(/\.exe$/, "")] = binaryPath;
+    }
+    return { target, binaryPaths };
+  } catch (err) {
+    if (err.message && err.message.startsWith("Platform package ")) throw err;
+
+    // Local development fallback. The generated directory is excluded from
+    // the published main package, so installed users always use the optional
+    // platform dependency above.
+    const localBinDir = path.join(__dirname, "..", "platforms", target.suffix, "bin");
+    const binaryPaths = {};
+    for (const binary of target.binaries) {
+      const binaryPath = path.join(localBinDir, binary);
+      if (!exists(binaryPath)) {
+        throw new Error(
+          `Missing optional platform package ${target.packageName} for ${key}.\n` +
+            `Reinstall without disabling optional dependencies:\n` +
+            `  npm install -g ${PACKAGE_PREFIX}\n` +
+            `If you used --omit=optional or optional=false, remove that setting first.`
+        );
+      }
+      binaryPaths[binary.replace(/\.exe$/, "")] = binaryPath;
+    }
+    return { target, binaryPaths };
   }
+}
 
-  return binaryPath;
+function getBinaryPath(options = {}) {
+  return resolvePlatformBinaries(options).binaryPaths[BINARY_NAMES[0]];
 }
 
 function copyDirectory(src, dest) {
@@ -81,7 +126,7 @@ function installBuddySkills(pkgRoot, skill) {
   }
 }
 
-if (process.argv[2] === "version" && process.argv.length === 3) {
+if (require.main === module && process.argv[2] === "version" && process.argv.length === 3) {
   const pkg = JSON.parse(fs.readFileSync(path.join(__dirname, "..", "package.json"), "utf8"));
   console.log(pkg.version);
   process.exit(0);
@@ -111,7 +156,7 @@ function resolveNpxInvocation() {
   return { command: "npx", argsPrefix: [] };
 }
 
-if (process.argv[2] === "install-skill") {
+if (require.main === module && process.argv[2] === "install-skill") {
   reexecInstallCommand(__filename, process.argv.slice(2));
   const pkgRoot = path.join(__dirname, "..");
   const extraArgs = process.argv.slice(3);
@@ -143,28 +188,38 @@ if (process.argv[2] === "install-skill") {
   process.exit(status);
 }
 
-const binary = getBinaryPath();
+if (require.main === module) {
+  let binary;
+  try {
+    binary = getBinaryPath();
+  } catch (err) {
+    console.error(err.message);
+    process.exit(1);
+  }
 
-try {
-  if (process.platform !== "win32") {
-    fs.chmodSync(binary, 0o755);
+  try {
+    if (process.platform !== "win32") {
+      fs.chmodSync(binary, 0o755);
+    }
+  } catch (_) {
+    // chmod may fail in read-only environments
   }
-} catch (_) {
-  // chmod may fail in read-only environments; binary might already be executable
-}
 
-if (process.platform === "win32") {
-  try { execSync("chcp 65001", { stdio: "ignore" }); } catch (_) {}
-}
+  if (process.platform === "win32") {
+    try { execSync("chcp 65001", { stdio: "ignore" }); } catch (_) {}
+  }
 
-try {
-  execFileSync(binary, process.argv.slice(2), {
-    stdio: "inherit",
-    env: { ...process.env, GUANCLI_PROG_NAME: "guancli" },
-  });
-} catch (err) {
-  if (err.status != null) {
-    process.exit(err.status);
+  try {
+    execFileSync(binary, process.argv.slice(2), {
+      stdio: "inherit",
+      env: { ...process.env, GUANCLI_PROG_NAME: "guancli" },
+    });
+  } catch (err) {
+    if (err.status != null) {
+      process.exit(err.status);
+    }
+    throw err;
   }
-  throw err;
 }
+
+module.exports = { getBinaryPath, resolvePlatformBinaries };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@guandata/guancli",
-  "version": "1.0.61",
+  "version": "1.0.62",
   "description": "观远 BI 命令行工具 - 通过 API 操作 ETL、数据集、页面、表单等资源，并提供 ChatBI 问数/洞察能力",
   "bin": {
     "guancli": "bin/run.js"
@@ -8,13 +8,17 @@
   "scripts": {
     "postinstall": "node bin/postinstall.js",
     "build": "node scripts/build.js && node scripts/sync-skill.js",
+    "pack:all": "node scripts/pack-all.js",
+    "test:build-script": "node scripts/platform-tests.js build && node scripts/platform-tests.js run",
+    "test:package-layout": "node scripts/platform-tests.js layout && node scripts/platform-tests.js install-smoke",
+    "test:auto-select": "node scripts/platform-tests.js auto-select",
+    "verify:platforms": "node scripts/verify-platforms.js",
     "changelog": "node ../../scripts/generate-release-changelog.js .",
     "check-changelog": "node ../../scripts/check-release-changelog.js .",
-    "prepublishOnly": "npm run check-changelog && npm run build && node scripts/preflight.js"
+    "prepublishOnly": "npm run test:build-script && npm run check-changelog && npm run build && node scripts/preflight.js && npm run test:package-layout && npm run test:auto-select"
   },
   "files": [
     "bin/",
-    "binaries/",
     "skills/",
     "CHANGELOG.md",
     "LICENSE",
@@ -37,8 +41,15 @@
   "engines": {
     "node": ">=14"
   },
+  "optionalDependencies": {
+    "@guandata/guancli-darwin-arm64": "1.0.62",
+    "@guandata/guancli-darwin-x64": "1.0.62",
+    "@guandata/guancli-linux-x64": "1.0.62",
+    "@guandata/guancli-linux-arm64": "1.0.62",
+    "@guandata/guancli-win32-x64": "1.0.62"
+  },
   "publishConfig": {
-    "access": "public",
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
   }
 }