@gbits-jszx/gw-cli 2026.9.13-5 → 2026.9.13-6

package/README.md

@@ -1,46 +1,46 @@
-# @gbits-jszx/gw-cli
-
+# @gbits-jszx/gw-cli
+
 面向多个网关项目的跨平台构建、运行和交付工具。项目身份唯一来自显式 `--project-id <代号>`（或 `--project-id=<代号>`）；不需要 `gw.project.yaml`，不接受旧 `--project` 路径，也不从 `GW_PROJECT_FILE` 或用户凭据中的旧 ID 兜底。`npm build/package/publish` 专用于维护 CLI 本身，包名固定为 `@gbits-jszx/gw-cli`，项目代号只隔离版本账本。
 
-> 新接口已随 `@gbits-jszx/gw-cli@2026.9.13-3` 发布并核对为 latest，公网使用 `npx -y --prefer-online @gbits-jszx/gw-cli@latest`；`2026.9.12-9` 及更早版本仍是旧 `--project` 接口。源码开发继续使用 `go run ./tools/cli`。
-
-[PC 开发构建发布、WSL/云 VM 初始化部署更新](../../../docs/user-docs/CLI-MULTI-PROJECT.md)。公网 registry 为 `https://registry.npmjs.org/`，包内包含 Windows amd64 和 Linux amd64（含 WSL）二进制。
-
-打包过程和最终 `.tgz` 全部位于仓库根目录 `.gw-build/npm/`；源码目录不会生成 `bin/native` 或被 `npm version` 改写。
-
-`npm build` 与 `npm package` 等价，从当前源码编译 Windows/Linux CLI 并生成 `.tgz`。编译期间每 5 秒报告已用时间，完成时显示各平台二进制大小、npm 文件清单、压缩包文件名、输出目录和总耗时；任何阶段失败都会保留原始错误并返回非零退出码。`npm publish` / `publish npm` 每次重新构建，并在默认自动编号下分配新的 npm 版本，不直接上传之前 build 的归档。
-
-## 日期版本号
-
+> 当前公开版本为 `@gbits-jszx/gw-cli@2026.9.13-5`，`latest` 已核对。公网使用 `npx -y --prefer-online @gbits-jszx/gw-cli@latest`；没有 Node/npm 的 Linux/WSL 可直接运行包内 `bin/native/gw-cli-linux-amd64`。源码开发继续使用 `go run ./tools/cli`。
+
+[PC 开发构建发布、WSL/云 VM 初始化部署更新](../../../docs/user-docs/CLI-MULTI-PROJECT.md)。公网 registry 为 `https://registry.npmjs.org/`，包内包含 Windows amd64 和 Linux amd64（含 WSL）二进制。
+
+打包过程和最终 `.tgz` 全部位于仓库根目录 `.gw-build/npm/`；源码目录不会生成 `bin/native` 或被 `npm version` 改写。
+
+`npm build` 与 `npm package` 等价，从当前源码编译 Windows/Linux CLI 并生成 `.tgz`。编译期间每 5 秒报告已用时间，完成时显示各平台二进制大小、npm 文件清单、压缩包文件名、输出目录和总耗时；任何阶段失败都会保留原始错误并返回非零退出码。`npm publish` / `publish npm` 每次重新构建，并在默认自动编号下分配新的 npm 版本，不直接上传之前 build 的归档。源码 `go run ./tools/cli --version` 显示嵌入的源码基线 `2026.9.11-2`；打包阶段才把发布版本注入二进制和 `package.json`。
+
+## 日期版本号
+
 npm、Image、Chart 使用相同的 `yyyy.M.d-id` 格式，但按项目和制品类型独立编号，不要求三者同号。例如 `2026.9.11-2` 表示该项目、该类制品当天分配的第 2 个版本。`npm build`、`npm package`、`npm publish` 和 `publish npm` 默认 `--version auto`，按执行机器的本地日期生成，序号从 1 开始、同日递增、跨日重置。也可用 `--version 2026.9.11-2` 显式重建未发布版本，日期须有效，月、日和序号均不得带前导零。
-
+
 该格式可直接被 npm 解析为 SemVer：`yyyy.M.d` 是 major/minor/patch，`id` 是数字型 prerelease 标识。CLI 在打包副本中自动同步 `package.json` 的 `version`、`gwVersion` 和 Windows/Linux 二进制编译版本，无需手工修改源码中的 `gwVersion`。日常安装继续使用 `@latest`；精确复现使用完整版本号。由于它在 SemVer 中属于 prerelease，普通版本范围默认不会匹配，依赖方不要使用 `^2026.9.11`，应使用 `@latest` 或精确版本。
-
-`npm publish` / `publish npm` 会自动向 npm 传入 `--tag latest`，明确把本次版本设为 `@latest`，同时满足 npm 对 prerelease 发布的显式 tag 要求。`--dry-run` 使用相同参数但不上传；`npm pack --dry-run` 只检查打包，不能替代发布检查。
-
-旧的 `yyyy.MM.dd.id` 仅保留为显式输入兼容，用于重建已经发布的旧包；新自动版本不会再生成旧格式。
-
-序号记录位于 `~/jszx-infra/.gw-cli/projects.yaml`，按 `project-id` 和制品类型隔离；打包开始即占用，失败和 dry-run 也占用一次，避免自动重用版本。同一用户目录下、同一项目的并发自动打包不会重复分配，清理 `.gw-build` 或切换仓库副本不会重置编号。手动指定版本可用于重打包或在本地验证后发布；换机器或 CI 多节点并行时仍需统一分配并显式传入未发布版本。`GW_CLI_PROJECTS` 可覆盖账本路径。npm 包名固定，不同项目代号的账本隔离不代表能向该包重复发布同一个版本；维护 CLI 应使用稳定代号，当前为 `gw-demo`。该代号名下最新发布为 `2026.9.13-3`。
-
-## 镜像 tag
-
+
+`npm publish` / `publish npm` 会自动向 npm 传入 `--tag latest`，明确把本次版本设为 `@latest`，同时满足 npm 对 prerelease 发布的显式 tag 要求。`--dry-run` 使用相同参数但不上传；`npm pack --dry-run` 只检查打包，不能替代发布检查。
+
+旧的 `yyyy.MM.dd.id` 仅保留为显式输入兼容，用于重建已经发布的旧包；新自动版本不会再生成旧格式。
+
+序号记录位于 `~/jszx-infra/.gw-cli/projects.yaml`，按 `project-id` 和制品类型隔离；打包开始即占用，失败和 dry-run 也占用一次，避免自动重用版本。同一用户目录下、同一项目的并发自动打包不会重复分配，清理 `.gw-build` 或切换仓库副本不会重置编号。手动指定版本可用于重打包或在本地验证后发布；换机器或 CI 多节点并行时仍需统一分配并显式传入未发布版本。`GW_CLI_PROJECTS` 可覆盖账本路径。npm 包名固定，不同项目代号的账本隔离不代表能向该包重复发布同一个版本；维护 CLI 应使用稳定代号，当前为 `gw-demo`。该代号名下最新发布为 `2026.9.13-5`。
+
+## 镜像 tag
+
 `image build` 默认 `--tag auto`，生成 `yyyy.M.d-id`，例如 `2026.9.10-1`。该格式同时满足 Docker tag 与 Helm SemVer，Image 与 Chart 各自编号；部署时分别传入实际镜像 tag 和 Chart 版本。日期按执行 CLI 的机器本地时间计算，序号从 1 起，同日递增、跨日重置。参数优先级为 `--tag` > `GW_IMAGE_TAG` > `auto`；自动和新显式版本使用新格式，已存在的 `yyyy.MM.dd.id` 仍可显式重建或推送。
-
-镜像与 npm 独立计数，编号同样写入用户级 `projects.yaml`。开始构建时即占号，失败也保留，但只有成功构建才更新该 repository 的最近可推送 tag。同一 `project-id` 的不同镜像 repository 共用镜像每日序号，各自保存最近成功构建。显式 tag 可用于本地重建；不查询 Harbor。换机器或 CI 多节点构建时，应统一分配并显式传入未发布 tag，不能覆盖已发布镜像。
-
-```powershell
-# 自动编号，输出 Docker 构建日志及最终完整镜像名
+
+镜像与 npm 独立计数，编号同样写入用户级 `projects.yaml`。开始构建时即占号，失败也保留，但只有成功构建才更新该 repository 的最近可推送 tag。同一 `project-id` 的不同镜像 repository 共用镜像每日序号，各自保存最近成功构建。显式 tag 可用于本地重建；不查询 Harbor。换机器或 CI 多节点构建时，应统一分配并显式传入未发布 tag，不能覆盖已发布镜像。
+
+```powershell
+# 自动编号，输出 Docker 构建日志及最终完整镜像名
 go run ./tools/cli --project-id gw-demo image build
-# 自动使用该 repository 最近一次成功构建的 tag，不生成新编号
+# 自动使用该 repository 最近一次成功构建的 tag，不生成新编号
 go run ./tools/cli --project-id gw-demo image push
-```
-
+```
+
 `image push` / `publish image` 的默认 `--tag auto` 会读取最近成功构建记录；没有记录时要求先 build 或显式传入 tag。优先级为 `--tag` > `GW_IMAGE_TAG` > 自动识别；为兼容已有本地镜像，显式推送仍接受旧 tag 格式。默认仓库为 `<Harbor>/<Harbor项目>/<project-id>`，完整地址可用 `--repository` 或 `GW_IMAGE_REPOSITORY` 覆盖。
-
-## Chart 版本
-
+
+## Chart 版本
+
 `chart package` 独立生成 `yyyy.M.d-id`，例如 `2026.9.10-1`；Chart metadata、归档名和 Harbor OCI tag 不再二次映射或添加 project-id 前缀。`chart push` 默认复用 `projects.yaml` 中尚未发布且文件仍存在的精确归档；没有可复用包时自动分配下一版本、打包并推送。旧的 `{project-id}-yyyy.MM.dd.id`、`yyyy.MM.dd.id` 和合法 SemVer 仍可显式用于重建或回滚。Chart 默认地址为 `oci://<Harbor>/<Harbor项目>/charts/<project-id>`，自动与镜像路径分离，无需另传 `/charts`；`--registry/--repository` 可覆盖 registry 和 OCI 父路径。
-
+
 ## 配置查看与校验
 
 ```powershell
@@ -50,20 +50,20 @@ go run ./tools/cli --project-id gw-demo project show
 ```
 
 `config show` 仅显示凭据状态，不输出 Token 或密码；`config validate` 只做静态校验，不执行迁移或集群写操作。
-配置命令已随 `2026.9.13-3` 发布到 npm latest。
+配置命令已随 `2026.9.13-5` 发布到 npm latest。
 
 ## 使用
-
+
 在 GW-Framework 源码根目录执行以下命令；公开 npm 入口的切换条件见本文开头：
-
-```powershell
+
+```powershell
 go run ./tools/cli --version
 go run ./tools/cli --project-id gw-demo doctor
 go run ./tools/cli --project-id gw-demo test all
 go run ./tools/cli --project-id gw-demo build all
 go run ./tools/cli --project-id gw-demo run all
-```
-
+```
+
 | 命令 | `--project-id` |
 |---|---|
 | `build/run/test`、`image/chart/npm/publish` 的实际操作 | 必填 |
@@ -84,47 +84,47 @@ Go 项目的 `build`、`run`、`test` 需要源码和 Go，本仓库 `run` 还
 
 根 `--help` 只展示下一层入口，并按颜色分为“本地 PC · 日常开发”“远程 VM · 日常部署”“高级命令 · 制品与维护”；各级命令沿用所属分组颜色，参数默认值使用洋红色突出。交互终端默认启用颜色；`GW_CLI_COLOR=always|never` 可强制开关，未强制开启时 `NO_COLOR` 会关闭颜色。集群操作唯一入口为 `deploy k3s` / `deploy helm`，包括 `deploy k3s restore/purge`；顶层 `k3s` / `helm` 已删除。
 
-`deploy k3s init` 在 WSL 或 Linux amd64 VM 内执行，无需项目文件、源码或 Go。当前新接口未发布，无源码 VM 需使用本次源码构建并核对过版本的 Linux CLI；下面是 Windows 源码端的预览入口：
+`deploy k3s init` 在 WSL 或 Linux amd64 VM 内执行，无需项目文件、源码或 Go。当前公开包已包含新接口；无源码 VM 直接使用 npm 包中的 Linux amd64 CLI，或使用已核对版本的独立二进制。下面是 Windows 源码端的预览入口：
 
 ```powershell
 go run ./tools/cli --project-id gw-demo deploy k3s init --dry-run
-```
-
-目标机器需预先安装并运行 k3s、安装 Helm，并允许当前用户访问 kubeconfig；不自动安装 k3s 或 Helm。PostgreSQL 参数使用 `--pgsql-*`，数据库名为 `--pgsql-dbname`。已有密码分别复用，首次业务及管理员密码人工输入，危险修改需二次确认。imagePullSecret 来自执行机器的 Docker `auths`，缺少有效凭据时跳过，不能由 Chart 的 Helm 登录替代。完整说明见 [k3s 初始化](../../../docs/user-docs/K3S-INIT.md)。源码修改发布后才会进入 npm `@latest`。
-
-## 发布凭据
-
+```
+
+目标机器需预先安装并运行 k3s、安装 Helm，并允许当前用户访问 kubeconfig；不自动安装 k3s 或 Helm。PostgreSQL 参数使用 `--pgsql-*`，数据库名为 `--pgsql-dbname`。已有密码分别复用，首次业务及管理员密码人工输入，危险修改需二次确认。imagePullSecret 来自执行机器的 Docker `auths`，缺少有效凭据时跳过，不能由 Chart 的 Helm 登录替代。完整说明见 [k3s 初始化](../../../docs/user-docs/K3S-INIT.md)。源码改动需要重新发布才会进入 npm `@latest`，当前 `@latest` 已是 `2026.9.13-5`。
+
+## 发布凭据
+
 项目身份仅来自 `--project-id`，默认交付地址和资源名称从代号推导。Harbor 端点按对应命令支持的参数 > `GW_HARBOR_REGISTRY/GW_HARBOR_PROJECT` > 用户配置端点 > `szharbor.g-bits.com/jszx-infra` 默认值解析。用户 `~/jszx-infra/.gw-cli/config.yaml` 保存凭据及其端点，不保存当前项目；`projects.yaml` 按项目记录制品版本。CI 显式传代号并注入凭据，无需携带项目清单。帮助和版本查询不创建配置。
 
 Namespace/应用 Release 默认代号，PG Release 默认 `<代号>-pg`，数据库名/用户名将 `-` 转为 `_`，数据库连接 Secret 默认 `<代号>-database`。超长 Release/资源名自动缩短并保留确定性哈希；Namespace 和制品地址保留完整代号。kubeconfig/context 默认 `/etc/rancher/k3s/k3s.yaml` / `default`，可通过现有参数及环境变量覆盖。详细规则见[多项目 CLI 指南](../../../docs/user-docs/CLI-MULTI-PROJECT.md)。
-
-```powershell
+
+```powershell
 go run ./tools/cli --project-id gw-demo publish npm
 go run ./tools/cli --project-id gw-demo publish image
 go run ./tools/cli --project-id gw-demo publish chart --wsl=false
-```
-
-缺少 npm Token 或 Harbor Robot 账号/密码时，CLI 会询问并自动保存到 `~/jszx-infra/.gw-cli/config.yaml`；可用 `GW_CLI_CONFIG` 覆盖位置。已有配置不重复询问。命令参数、`NODE_AUTH_TOKEN` / `GW_HARBOR_USERNAME` / `GW_HARBOR_PASSWORD` 优先于用户配置。
-
+```
+
+缺少 npm Token 或 Harbor Robot 账号/密码时，CLI 会询问并自动保存到 `~/jszx-infra/.gw-cli/config.yaml`；可用 `GW_CLI_CONFIG` 覆盖位置。已有配置不重复询问。命令参数、`NODE_AUTH_TOKEN` / `GW_HARBOR_USERNAME` / `GW_HARBOR_PASSWORD` 优先于用户配置。
+
 `deploy helm install` 拉取 OCI Chart 时先复用 Helm 原生登录或公共访问；只有确认认证失败才补齐 Harbor 账密，隐藏密码输入、保存后通过 stdin 登录。支持 `--username` / `--password` 和 `GW_HARBOR_USERNAME` / `GW_HARBOR_PASSWORD`，也支持 `--helm-registry-config` / `HELM_REGISTRY_CONFIG` 指定执行机器的 Helm 凭据文件。网络、版本不存在等错误直接报告；`--dry-run` 不探测、不登录、不询问账密。
 
-Token 和密码在终端中不回显。配置文件保存明文凭据，Unix 下目录/文件权限为 0700/0600，Windows 使用用户目录 ACL。网关服务不读取此文件。
-
+Token 和密码在终端中不回显。配置文件保存明文凭据，Unix 下目录/文件权限为 0700/0600，Windows 使用用户目录 ACL。网关服务不读取此文件。
+
 ## 源码打包与本地验证
-
-已有公开 npm 包；`--project-id` 改造首发于 `2026.9.13-2`，config 命令随 `2026.9.13-3` 发布。以下 npm 操作继续使用版本账本对应的维护代号 `gw-demo`：
-
-```powershell
-# 自动使用当天序号，终端会打印版本和文件名
+
+已有公开 npm 包；`--project-id` 改造首发于 `2026.9.13-2`，config 命令随 `2026.9.13-5` 发布。以下 npm 操作继续使用版本账本对应的维护代号 `gw-demo`：
+
+```powershell
+# 自动使用当天序号，终端会打印版本和文件名
 go run ./tools/cli --project-id gw-demo npm build
 # 把占位文件名替换为本次 build 实际输出的文件名；这里使用本地新包
 $gwNpmArchive = './.gw-build/npm/<本次输出的文件名>.tgz'
 npx -y --package $gwNpmArchive gw-cli --version
 npx -y --package $gwNpmArchive gw-cli --project-id gw-demo project show
-# 只检查发布包，不上传、不询问 Token
+# 只检查发布包，不上传、不询问 Token
 go run ./tools/cli --project-id gw-demo publish npm --dry-run
 # 获得发布授权后执行：重新构建并自动编号，输入具备发布权限的 npm Token
 go run ./tools/cli --project-id gw-demo publish npm
-```
-
-发布后的版本号不可复用。这里的 `gw-cli` 是包内命令名，公网下载始终使用 scoped 包 `@gbits-jszx/gw-cli`。
+```
+
+发布后的版本号不可复用。这里的 `gw-cli` 是包内命令名，公网下载始终使用 scoped 包 `@gbits-jszx/gw-cli`。

package/bin/gw-cli.js

@@ -46,6 +46,20 @@ for (let i = 0; i < cliArgs.length; i++) {
   }
 }
 
+// The run target is a positional that may sit behind value-taking flags
+// (--target wsl all), so scan past them instead of testing command[1].
+function runsLocalServices(command) {
+  if (command[0] !== 'run') return false;
+  const valueFlags = new Set(['--target', '--distro', '--values', '--profile']);
+  for (let i = 1; i < command.length; i++) {
+    const arg = command[i];
+    if (valueFlags.has(arg)) { i += 1; continue; }
+    if (arg.startsWith('--')) continue;
+    return ['core', 'mock', 'web', 'all'].includes(arg);
+  }
+  return false;
+}
+
 // Keep the wrapper alive while the native CLI stops its services and database.
 // Windows console events already reach the child; child.kill('SIGINT') on
 // Windows would force-terminate it and skip Go's deferred cleanup.
@@ -62,7 +76,7 @@ child.on('exit', (code) => {
   // Run after the child exits; invoking Docker while a Windows Ctrl+C event is
   // active can interrupt the cleanup subprocess itself.
   // A test/build/publish in another terminal must not remove run all's DB.
-  if (!helpOnly && !invalidSelection && selection.length > 0 && command[0] === 'run' && ['core', 'mock', 'web', 'all'].includes(command[1]) && Number.isInteger(child.pid) && child.pid > 0) {
+  if (!helpOnly && !invalidSelection && selection.length > 0 && runsLocalServices(command) && Number.isInteger(child.pid) && child.pid > 0) {
     spawnSync(binary, [...selection, 'cleanup', '--owner-pid', String(child.pid)], { stdio: 'inherit', windowsHide: true });
   }
   process.exit(code === null ? 1 : code);

package/package.json

@@ -9,12 +9,12 @@
   "files": [
     "bin"
   ],
-  "gwVersion": "2026.9.13-5",
+  "gwVersion": "2026.9.13-6",
   "license": "MIT",
   "name": "@gbits-jszx/gw-cli",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
   },
-  "version": "2026.9.13-5"
+  "version": "2026.9.13-6"
 }