@gbits-jszx/dg-cli 0.3.6 → 0.4.0

package/bin/dg-cli.js

@@ -10,6 +10,42 @@ const arch = process.arch;          // 'x64' / 'arm64'
 const pkg = `@gbits-jszx/dg-cli-${platform}-${arch}`;
 const exe = platform === "win32" ? "dg-cli.exe" : "dg-cli";
 
+// 后台异步比对本地版本与 npm registry latest（D5：零依赖、零阻塞、出错全静默）。
+// 不阻塞主进程：req.unref() 让请求不延长 process 生命周期；任意错误吞掉。
+// 实际能否打印 WARN 取决于 execFileSync 后 Node 是否还在 drain IO；
+// 长命令（helm install）期间响应早已 buffered → 大概率能打印；
+// 短命令（--version）可能来不及 → 静默丢弃，符合"不打扰用户"原则。
+function checkLatestAsync() {
+  if (process.env.DG_NPX_NO_VERSION_CHECK) return; // 离线/CI 用环境变量短路
+  try {
+    const https = require("https");
+    const localVer = require("../package.json").version;
+    const url = "https://registry.npmjs.org/-/package/@gbits-jszx/dg-cli/dist-tags";
+    const req = https.get(url, { timeout: 1500 }, (res) => {
+      if (res.statusCode !== 200) { res.resume(); return; }
+      let data = "";
+      res.on("data", (chunk) => { data += chunk; });
+      res.on("end", () => {
+        try {
+          const tags = JSON.parse(data);
+          const remoteVer = tags && tags.latest;
+          if (remoteVer && remoteVer !== localVer) {
+            console.error(
+              `[dg-cli] 本地 ${localVer}，registry latest=${remoteVer}；` +
+              `若需刷新：rm -rf ~/.npm/_npx && npx -y --prefer-online @gbits-jszx/dg-cli@latest <cmd>`
+            );
+          }
+        } catch (_) { /* 静默 */ }
+      });
+      res.on("error", () => {});
+    });
+    req.on("error", () => {});
+    req.on("timeout", () => { req.destroy(); });
+    if (req.unref) req.unref();
+  } catch (_) { /* 静默 */ }
+}
+checkLatestAsync();
+
 let binPath;
 try {
   binPath = require.resolve(`${pkg}/bin/${exe}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gbits-jszx/dg-cli",
-  "version": "0.3.6",
+  "version": "0.4.0",
   "description": "DataGateway CLI — 部署/运维/配置一站式（Go binary，npx 分发）",
   "bin": {
     "dg-cli": "bin/dg-cli.js"
@@ -13,11 +13,11 @@
     "node": ">=14"
   },
   "optionalDependencies": {
-    "@gbits-jszx/dg-cli-linux-x64": "0.3.6",
-    "@gbits-jszx/dg-cli-linux-arm64": "0.3.6",
-    "@gbits-jszx/dg-cli-darwin-x64": "0.3.6",
-    "@gbits-jszx/dg-cli-darwin-arm64": "0.3.6",
-    "@gbits-jszx/dg-cli-win32-x64": "0.3.6"
+    "@gbits-jszx/dg-cli-linux-x64": "0.4.0",
+    "@gbits-jszx/dg-cli-linux-arm64": "0.4.0",
+    "@gbits-jszx/dg-cli-darwin-x64": "0.4.0",
+    "@gbits-jszx/dg-cli-darwin-arm64": "0.4.0",
+    "@gbits-jszx/dg-cli-win32-x64": "0.4.0"
   },
   "license": "MIT",
   "repository": {

package/README.md

@@ -1,61 +0,0 @@
-# @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 deploy install|upgrade|rollback`：VM 部署
-- `dg-cli image 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