@gbits-jszx/gw-cli 2026.9.14-3 → 2026.9.14-5

package/README.md

@@ -2,9 +2,9 @@
 
 面向多个网关项目的跨平台构建、运行和交付工具。项目级命令的身份唯一来自显式 `--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.14-2`。公网使用 `npx -y --prefer-online @gbits-jszx/gw-cli@latest`；没有 Node/npm 的 Linux/WSL 可直接运行包内 `bin/native/gw-cli-linux-amd64`。源码开发继续使用 `go run ./tools/cli`。
+> 当前公开版本为 `@gbits-jszx/gw-cli@2026.9.14-4`。公网使用 `npx -y --prefer-online @gbits-jszx/gw-cli@latest`；没有 Node/npm 的 Linux/WSL 可直接运行包内 `bin/native/gw-cli-linux-amd64`。源码开发继续使用 `go run ./tools/cli`。
 >
-> 默认 `all`、部署版本自动选择和 CLI 产品中立改造已进入源码，尚未发布到 npm；发布前使用源码验证。
+> 默认 `all`、部署版本自动选择、npm 全局账本和 Helm 部署进度均已进入当前 npm 版本。
 
 [PC 开发构建发布、WSL/云 VM 初始化部署更新](../../../docs/user-docs/CLI-MULTI-PROJECT.md)。公网 registry 为 `https://registry.npmjs.org/`，包内包含 Windows amd64 和 Linux amd64（含 WSL）二进制。
 
@@ -12,14 +12,14 @@ WSL 必须使用安装在 WSL 内的 Linux Node/npm。若 `type -a node npm npx`
 
 ```bash
 cd /mnt/g/Git/Wurq/Projects/GW-Framework
-npx -y --prefer-online @gbits-jszx/gw-cli@2026.9.14-2 --version
+npx -y --prefer-online @gbits-jszx/gw-cli@2026.9.14-4 --version
 ```
 
 打包过程和最终 `.tgz` 全部位于仓库根目录 `.gw-build/npm/`；源码目录不会生成 `bin/native` 或被 `npm version` 改写。
 
 ## 端口调试与新项目
 
-新增 `debug port kill <端口>` 尚未发布到 npm，使用源码验证：
+`debug port kill <端口>` 已包含在当前 npm 版本中，也可使用源码验证：
 
 ```powershell
 go run ./tools/cli debug port kill 18080 --dry-run
@@ -120,7 +120,7 @@ Go 项目的 `build`、`run`、`test` 需要源码和 Go。本仓库默认 `run`
 go run ./tools/cli --project-id gw-demo deploy k3s init --dry-run
 ```
 
-目标机器需预先安装并运行 k3s、安装 Helm，并允许当前用户访问 kubeconfig；不自动安装 k3s 或 Helm。部署前可运行 `doctor --scope deploy`，该 scope 只检查 Helm/k3s/kubeconfig，不要求 Go、Node.js 或 npm。PostgreSQL 参数使用 `--pgsql-*`，数据库名为 `--pgsql-dbname`。已有密码分别复用，首次业务及管理员密码人工输入，危险修改需二次确认。imagePullSecret 来自执行机器的 Docker `auths`，缺少有效凭据时跳过，不能由 Chart 的 Helm 登录替代。完整说明见 [k3s 初始化](../../../docs/user-docs/K3S-INIT.md)。源码改动需要重新发布才会进入 npm `@latest`，当前 `@latest` 是 `2026.9.14-2`。
+目标机器需预先安装并运行 k3s、安装 Helm，并允许当前用户访问 kubeconfig；不自动安装 k3s 或 Helm。部署前可运行 `doctor --scope deploy`，该 scope 只检查 Helm/k3s/kubeconfig，不要求 Go、Node.js 或 npm。PostgreSQL 参数使用 `--pgsql-*`，数据库名为 `--pgsql-dbname`。已有密码分别复用，首次业务及管理员密码人工输入，危险修改需二次确认。imagePullSecret 来自执行机器的 Docker `auths`，缺少有效凭据时跳过，不能由 Chart 的 Helm 登录替代。完整说明见 [k3s 初始化](../../../docs/user-docs/K3S-INIT.md)。当前 `@latest` 是 `2026.9.14-4`。
 
 ## 发布凭据
 
@@ -138,6 +138,8 @@ go run ./tools/cli --project-id gw-demo chart push
 
 `deploy helm install` 的 release、namespace、Chart 地址、数据库资源名、kubeconfig/context 均由 `--project-id` 和固定规则推导；Chart 版本和镜像 tag 默认读取该项目的最近成功发布记录。`--version`、`--tag` 只用于跨机器、账本缺失、回滚或一次性覆盖。拉取 OCI Chart 时先复用 Helm 原生登录或公共访问；只有确认认证失败才补齐 Harbor 账密，隐藏密码输入、保存后通过 stdin 登录。支持 `--username` / `--password` 和 `GW_HARBOR_USERNAME` / `GW_HARBOR_PASSWORD`，也支持 `--helm-registry-config` / `HELM_REGISTRY_CONFIG` 指定执行机器的 Helm 凭据文件。网络、版本不存在等错误直接报告；`--dry-run` 不探测、不登录、不询问账密。
 
+实际安装按 4 个阶段输出目标、Chart/profile、数据库 Secret 前置检查和 Helm 执行结果；默认等待期间每 10 秒打印已用时间与 Pod 状态。缺少 `<project-id>-database` 时会在 Helm 前失败并提示先运行 `deploy k3s init`，避免无输出等待 5 分钟。
+
 Token 和密码在终端中不回显。配置文件保存明文凭据，Unix 下目录/文件权限为 0700/0600，Windows 使用用户目录 ACL。网关服务不读取此文件。
 
 ## 源码打包与本地验证

package/package.json

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