@gbits-jszx/dg-cli 0.0.1

package/README.md

@@ -0,0 +1,61 @@
+# @gbits-jszx/dg-cli
+
+DataGateway CLI — 部署 / 运维 / 配置一站式工具，Go 二进制经由 npx 分发。
+
+## 安装与使用
+
+```bash
+# 一次性运行（推荐）
+npx -y @gbits-jszx/dg-cli@latest doctor
+
+# 全局安装
+npm i -g @gbits-jszx/dg-cli
+dg-cli doctor
+
+# 项目本地依赖
+npm i -D @gbits-jszx/dg-cli
+npx dg-cli doctor
+```
+
+## 平台支持
+
+| OS | Arch |
+|---|---|
+| Linux | x64 / arm64 |
+| macOS | Intel / Apple Silicon |
+| Windows | x64 |
+
+> npm 装包时根据 `process.platform/arch` 自动只下载当前平台的二进制（约 8MB），其它子包跳过。
+
+## 主要命令
+
+- `dg-cli doctor`：环境自检
+- `dg-cli config init|validate|path`：配置文件管理（schema 驱动）
+- `dg-cli install|upgrade|rollback`：VM 部署
+- `dg-cli docker build|push`：镜像构建发布
+- `dg-cli system rotate-secret`：业务系统密钥轮换
+
+完整文档：[DataGateway 项目仓库](https://m68gitlab.g-bits.com/jszx-infra/datagateway)。
+
+## 常见问题
+
+**Q1：装完执行报「不支持的平台」**
+当前平台未被收录（仅支持 linux x64/arm64、macOS Intel/Apple Silicon、Windows x64）。请联系维护者补齐 `@gbits-jszx/dg-cli-<platform>-<arch>` 子包，或通过仓库内 GitLab 渠道安装本地构建版本。
+
+**Q2：`npx` 报错「需要登录 https://registry.npmjs.org」**
+本机 `~/.npmrc` 把 registry 切到了私有镜像（如 npmmirror）。临时切回：
+
+```bash
+npm config set registry https://registry.npmjs.org/
+npx -y @gbits-jszx/dg-cli@latest doctor
+```
+
+**Q3：与 `configs/config.yaml`、`.env` 文件的优先级**
+bootstrap 把所有环境变量与当前工作目录原样透传给 Go 二进制，配置加载链与直接跑 `dg-cli` 完全一致：CLI flag > env (`DG_*`) > `configs/config.yaml` > 默认值。
+
+**Q4：内网 / 无公网出口怎么办**
+走 GitLab Generic Package 渠道（详见 `docs/dev-guide/OPS-部署指南.md` 第 4 步「离线兜底」）。
+
+## License
+
+MIT

package/bin/dg-cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+// dg-cli npm bootstrap: 按 process.platform/arch 解析对应平台子包二进制并透传调用。
+// 设计原则：stdio inherit + 默认 cwd + 默认 env，确保子进程感知到的运行环境与直接跑二进制完全一致。
+
+"use strict";
+const { execFileSync } = require("child_process");
+
+const platform = process.platform; // 'linux' / 'darwin' / 'win32'
+const arch = process.arch;          // 'x64' / 'arm64'
+const pkg = `@gbits-jszx/dg-cli-${platform}-${arch}`;
+const exe = platform === "win32" ? "dg-cli.exe" : "dg-cli";
+
+let binPath;
+try {
+  binPath = require.resolve(`${pkg}/bin/${exe}`);
+} catch (e) {
+  console.error(`[dg-cli] 不支持的平台: ${platform}-${arch}`);
+  console.error(`[dg-cli] 请安装对应子包：${pkg}`);
+  console.error(`[dg-cli] 或联系维护者补齐该平台。`);
+  process.exit(2);
+}
+
+try {
+  execFileSync(binPath, process.argv.slice(2), {
+    stdio: "inherit",
+    env: process.env,
+  });
+} catch (err) {
+  process.exit(typeof err.status === "number" ? err.status : 1);
+}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@gbits-jszx/dg-cli",
+  "version": "0.0.1",
+  "description": "DataGateway CLI — 部署/运维/配置一站式（Go binary，npx 分发）",
+  "bin": {
+    "dg-cli": "bin/dg-cli.js"
+  },
+  "files": [
+    "bin/",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=14"
+  },
+  "optionalDependencies": {
+    "@gbits-jszx/dg-cli-linux-x64": "0.0.1",
+    "@gbits-jszx/dg-cli-linux-arm64": "0.0.1",
+    "@gbits-jszx/dg-cli-darwin-x64": "0.0.1",
+    "@gbits-jszx/dg-cli-darwin-arm64": "0.0.1",
+    "@gbits-jszx/dg-cli-win32-x64": "0.0.1"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://m68gitlab.g-bits.com/jszx-infra/datagateway.git"
+  },
+  "keywords": [
+    "datagateway",
+    "cli",
+    "mcp",
+    "gateway"
+  ]
+}