npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

@gbits-jszx/gw-cli

v2026.1110.2-abfbc16

Published

GW-Framework build, publish and k3s delivery CLI

Readme

@gbits-jszx/gw-cli

应用 Helm 安装/更新成功后打印本次解析的项目访问地址;内部存储准备、失败、dry-run 和未配置地址时不打印该入口。WSL / 云 VM 完整命令从 config new 开始,正常流程不要求指定认证路径。

源码已支持残留控制记录的受控恢复:普通/强制启动先持有运行锁并核验实例归属,记录中管理器/服务/构建进程全部退出才回收;存活或复用PID、权限不足及记录变化继续拒绝。已有本机PostgreSQL缺凭据时拒绝生成替代密码。此修复需发布后才进入npm,当前仅为源码行为。

VM首装init自动识别CLI私有registry、Helm默认~/.config/helm/registry/config.json及Docker默认~/.docker/config.json,尊重官方环境路径;缺少有效登录时提示用户名和隐藏密码/Token。认证先于存储写入,重复init仍检查;只导入当前仓库,原Helm/Docker文件保持。无需额外registry-config,正常init/install仍只传project-id/version/tag,详见仓库认证。

本次发布增加整命名空间清空与单项目配置移除:npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway deploy k3s destroy --namespace authgateway --namespace-wide --reason approved-fresh-install --dry-run;npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway config remove --dry-run。实际执行须携带当前approval摘要;命名空间内数据库/PVC永久删除,配置先私有备份并仅移除指定项目。完整清空说明区分源码与npm发布状态。

本轮发布包含受控恢复预览:npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway deploy helm uninstall --namespace authgateway --release authgateway-pg --recover-pending-install --dry-run。操作者先确认各机器部署均已退出;仅接受首次revision1、Pod从未启动、无外部依赖的挂起安装。先备份、复核后正常卸载,保留PVC并恢复相同凭据;普通挂起升级仍拒绝。历史终态Job与Pod不阻断启停,同namespace的Traefik路由受限支持卸载。日常使用 @latest,精确版本以 --version 和npm发布记录为准。版本号在打包阶段同时写入package.json和Windows/Linux原生程序。

本轮包包含根 gw.tasks.yaml 任务模式,run/build/test 和 process status/stop/restart/logs 共用定义,支持 run/build/test --dry-run;见 项目任务与进程管理。以下旧固定映射、端口清理和数据库参数说明只适用于无任务表的兼容路径;任务模式首次迁移先停止旧 run,db/部署不变。

AuthGateway 源码命令 go run ./tools/cli all 准备 PostgreSQL 单库并启动 AuthGW(内置 IAM)、Web、Mock;标准入口是 go run ./tools/cli --project-id authgateway run all。独立 iam 目标已删除,test core 覆盖内置 IAM;普通重启不删库。下方 Demo 说明仅适用于上游框架。

面向多个网关项目的跨平台构建、运行和交付工具。项目级命令的身份唯一来自显式 --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@latest。公网使用 npx -y --prefer-online @gbits-jszx/gw-cli@latest;没有 Node/npm 的 Linux/WSL 可直接运行包内 bin/native/gw-cli-linux-amd64。源码开发继续使用 go run ./tools/cli。

默认 all、部署版本自动选择、npm 全局账本和 Helm 部署进度均已进入当前 npm 版本。

PC 开发构建发布、WSL/云 VM 初始化部署更新。公网 registry 为 https://registry.npmjs.org/,包内包含 Windows amd64 和 Linux amd64(含 WSL)二进制。

WSL 必须使用安装在 WSL 内的 Linux Node/npm。若 type -a node npm npx 指向 /mnt/c/...,或 node -p "process.platform" 输出 win32,应先切换到 WSL 原生 Node。即使 Node 正确,也不要在包含 Windows 侧 node_modules 的 /mnt/c/Users/<用户> 下运行;npm 会把它识别为本地项目并污染 WSL 的 bin 查找,表现为 Path contains delimiter (":") / gw-cli: not found。切到 WSL home 或实际仓库后再执行:

cd /mnt/g/Git/Wurq/Projects/GW-Framework
npx -y --prefer-online @gbits-jszx/gw-cli@latest --version

打包过程和最终 .tgz 全部位于仓库根目录 .gw-build/npm/;源码目录不会生成 bin/native 或被 npm version 改写。

端口调试与新项目

debug port kill <端口> 已包含在当前 npm 版本中,也可使用源码验证:

go run ./tools/cli debug port kill 18080 --dry-run
go run ./tools/cli debug port kill 18080

无需项目代号,查询指定端口的 TCP 监听和 UDP 绑定 PID,并强制结束对应进程。--dry-run 仅预览;不清理远端连接,不跨 Windows/WSL,不自动提权或结束进程树。Linux/WSL 需要 ss(iproute2);查询权限不足或清理失败会返回非零退出码。正在运行的 run all 若有一个 app 被结束,监督进程会退出并清理其余 app 和临时数据库;清理后的占用查询会发现自动重启,但不会自动追杀新 PID。

Windows 默认 run all 启动本机 app,连接 db start 管理的本机持久 PostgreSQL(127.0.0.1:15433);不是 k3s Pod。一次性数据库显式使用 run all --database temporary,默认映射 127.0.0.1:55432,退出时回收容器和数据;--target local|wsl 只控制该临时模式的 Docker 执行位置。

任务表项目使用 run all --force 先独立编译,失败/取消保留旧实例,通过后才经独立认证通道通知 app/Vite 退出,并行最多等待 20 秒,超时才强杀剩余进程;构建立即取消,不等待串行编译。AuthGW 自身排空上限 15 秒;Windows Vite/npm 经专属 stdin EOF 和 Node 预加载适配触发 Vite 自身清理,完成后 npm 自然结束;无响应进程才由超时回收。新适配须重启 CLI 管理器一次生效。请求确认上限 5 秒,随后最多等 30 秒获取运行锁。状态快照位于 .gw-build/local/tasks//run.json,凭据仍留在用户私有目录。此行为以当前源码版为准(管理器协议 4),发布 npm 后才进入对应 npm 版本。首次迁移先退出旧管理器再启动;无任务表项目保留原可执行文件归属校验。单目标不支持 --force,无关进程和持久数据库不在终止范围。

CLI 当前不提供新项目源码脚手架;先准备框架源码布局,再运行 config new 交互登记用户级项目配置。它不会生成目录或改写 Go module;deploy k3s init 只初始化集群资源。完整步骤见新项目接入。

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。

停止本机任务

本轮包包含顶层停止命令,原 process stop 保留兼容:

go run ./tools/cli --project-id authgateway stop all
go run ./tools/cli --project-id authgateway stop all --force

默认并行通知服务退出,最多等 20 秒再强杀,最多等 30 秒释放运行锁;显式 --force 不通知、不排空,直接强杀所属服务/Vite/构建,最多等 10 秒收尾并释放锁。整组停止均走独立认证通道,请求确认上限 5 秒;强杀仅支持 all,可打断已开始的优雅退出。协议 4 支持两种方式;协议 2 仅在显式强杀时复用原 force 通道,协议 3 需先优雅停止再升级后使用强杀。管理器失联不按旧 PID 或端口杀进程。run all --force 先编译预检,通过后优雅退出并复用产物启动;含自定义prepare的force暂拒绝。无控制记录且锁空闲时stop提示无需停止;锁占用/损坏/权限错误仍报错。

日期版本号

npm、Image、Chart 使用相同的 yyyy.Mdd.id-short_sha1 格式,例如 2026.914.1-d3844db,不要求三者同号。Mdd 是去除整体前导零的 MMdd,id 是当天序号并作为 SemVer patch。npm 在 CLI 全局范围独立编号;Image/Chart 按项目和制品类型编号。npm build、npm package、npm publish 和 publish npm 默认 --version auto,使用执行机器的本地日期、当天序号和当前仓库 HEAD 的 7 位 Git SHA;序号从 1 开始、同日递增、跨日重置。也可用完整版本显式重建未发布版本;日期须有效,核心数字段和序号不得带前导零。

该格式可直接被 npm 和 Helm 解析为 SemVer:yyyy.Mdd.id 是 major/minor/patch,short_sha1 是 prerelease 标识。字面 yyyy.MMdd.short_sha1-number 不能直接使用,因为 MMDD 可能有前导零,且 SemVer 第三核心段必须为数字;因此将数字序号放在第三段、SHA 放在连字符之后。CLI 在打包副本中自动同步 package.json 的 version、gwVersion 和 Windows/Linux 二进制编译版本,无需手工修改源码中的 gwVersion。日常安装继续使用 @latest;精确复现使用完整版本号。由于它在 SemVer 中属于 prerelease,普通版本范围默认不会匹配,依赖方应使用 @latest 或精确版本。

npm publish / publish npm 会自动向 npm 传入 --tag latest,明确把本次版本设为 @latest,同时满足 npm 对 prerelease 发布的显式 tag 要求。--dry-run 使用相同参数但不上传;npm pack --dry-run 只检查打包,不能替代发布检查。

真实发布还会创建并向当前源码仓库的 Git origin 推送轻量 tag。前缀分别为 npm-、image-、chart-,格式为 <type>-yyyy-MMdd-id-short_sha1;例如 npm 版本 2026.914.14-fdc9a58 对应 npm-2026-0914-14-fdc9a58。tag 指向版本中 short SHA 对应的源码提交,MMDD 在 Git tag 中固定补齐四位。同名同提交视为幂等成功,同名不同提交拒绝覆盖。制品上传和账本写入先完成,若后续 Git 认证、远端或 tag 冲突失败,CLI 会明确报告“制品已发布、Git tag 失败”,不会删除已发布制品。build/package 与 npm dry-run 不创建 tag;历史 SemVer 显式发布仍使用制品前缀并附加当前 HEAD short SHA。

旧的 yyyy.Mdd.0-short_sha1.id 和 yyyy.MM.dd.id 仅保留为显式输入兼容,用于重建已经发布的旧包;新自动版本不会再生成旧格式。

npm 序号记录位于统一配置 ~/jszx-infra/.gw-cli/config.yaml 的 shared.artifacts.npm;打包开始即占用,失败和 dry-run 也占用一次,避免自动重用版本。同一用户配置下的并发自动打包不会重复分配,清理 .gw-build 或切换仓库副本不会重置编号。首次写入时,旧 projects.*.artifacts.npm 会合并到 shared:每日序号取最大值,最近构建/发布取较新记录,并删除项目内 npm 节点。手动指定版本可用于重打包或在本地验证后发布;换机器或 CI 多节点并行时仍需统一分配并显式传入未发布版本。GW_CLI_PROJECTS 仅覆盖旧账本作为升级兼容路径。

镜像 tag

image build 默认 --tag auto,生成 yyyy.Mdd.id-short_sha1,例如 2026.914.1-d3844db。该格式同时满足 Docker tag 与 Helm SemVer,Image 与 Chart 各自编号。deploy helm install 省略版本参数时,会按 --project-id 从发布账本自动选择最近成功发布的 Chart 版本和目标镜像仓库最近成功发布的 Image tag;换机器或账本缺失时再显式传入。日期按执行 CLI 的机器本地时间计算,SHA 取当前 HEAD,序号从 1 起,同日递增、跨日重置。参数优先级为 --tag > GW_IMAGE_TAG > auto;已存在的 yyyy.Mdd.0-short_sha1.id、yyyy.M.d-id 和 yyyy.MM.dd.id 仍可显式重建或推送。

镜像与 npm 独立计数;镜像编号写入统一配置的 projects.<project-id>.artifacts.image。开始构建时即占号,失败也保留,但只有成功构建才更新该 repository 的最近可推送 tag。同一 project-id 的不同镜像 repository 共用镜像每日序号,各自保存最近成功构建。显式 tag 可用于本地重建;不查询 Harbor。换机器或 CI 多节点构建时,应统一分配并显式传入未发布 tag,不能覆盖已发布镜像。

# 自动编号,输出 Docker 构建日志及最终完整镜像名
go run ./tools/cli --project-id gw-demo image build
# 自动使用该 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 package 独立生成 yyyy.Mdd.id-short_sha1,例如 2026.914.1-d3844db;Chart metadata、归档名和 Harbor OCI tag 不再二次映射或添加 project-id 前缀。chart push 默认复用统一配置中尚未发布且文件仍存在的精确归档;没有可复用包时自动分配下一版本、打包并推送。旧的 yyyy.Mdd.0-short_sha1.id、yyyy.M.d-id、{project-id}-yyyy.MM.dd.id、yyyy.MM.dd.id 和合法 SemVer 仍可显式用于重建或回滚。Chart 默认地址为 oci://<Harbor>/<Harbor项目>/charts/<project-id>,自动与镜像路径分离,无需另传 /charts;--registry/--repository 可覆盖 registry 和 OCI 父路径。

配置查看与校验

go run ./tools/cli config new
go run ./tools/cli config new --project-id my-gateway --non-interactive --yes
go run ./tools/cli config list
go run ./tools/cli config list --json
go run ./tools/cli config show
go run ./tools/cli config check
go run ./tools/cli --project-id gw-demo config show

config new 回显确认后写入 projects.<project-id> 并输出接入命令;若同一文件仍是旧版或混合版凭据结构,会先在内存升级和校验,再创建 config.yaml.bak.<时间> 私有备份并原子替换,失败不改原文件。config list 读取统一配置中已记录的项目代号;config show 仅显示凭据状态,不输出 Token 或密码;config check 只做静态校验,不执行集群写操作。运行时配置使用 config runtime get/set/history/rollback。

config show 将 Deployment values 标为 Chart 内置,只在本地源码 values 确实存在时展示 Source values(仅本地开发)。不再展示 Profiles 目录;JSON 删除 profiles-dir,无本地文件时省略 framework-values,新增 deployment-values 来源说明。CLI 不再保存或读取部署 profile,旧字段由 config check 拒绝;无源码 VM 无需在用户目录维护 values 副本。 配置命令已随 2026.9.13-9 发布到 npm latest。

使用

在 GW-Framework 源码根目录执行以下命令;公开 npm 入口的切换条件见本文开头:

go run ./tools/cli --version
go run ./tools/cli --project-id gw-demo doctor
go run ./tools/cli --project-id gw-demo test
go run ./tools/cli --project-id gw-demo build
go run ./tools/cli --project-id gw-demo run all

| 命令 | --project-id | |---|---| | build/run/test、image/chart/npm/publish 的实际操作 | 必填 | | deploy k3s/helm 的实际操作,包括状态查询及 dry-run | 必填 | | 隐藏 cleanup,仅供 npm wrapper 回收本地资源 | 必填 | | config new --non-interactive | 必填 | | config list/new/show/check/runtime | 可选;config new 交互询问代号 | | doctor | 可选 | | 帮助和版本查询 | 不需要 |

项目代号最长 63 字符,以小写字母开头,只含小写字母、数字和不连续的连字符,末尾为字母或数字。缺失、空值、非法值或重复参数均失败;两次相同值也不接受。源码从当前目录向上找最近 go.mod,不通过项目代号定位另一个仓库。

build、run、test 省略目标时默认 all,也可显式选择 core|mock|web|all;通用 GW-Framework 项目目标固定映射 ./apps/core-gateway、./apps/mock-gateway、./apps/web-service。AuthGateway 保留逻辑目标 core,源码检测后映射到 ./apps/auth-gateway,mock/web 不变;构建和运行的 all 不包含 CLI。test core/mock/web 只执行对应宿主的 go test -short,test all 执行 go test -short ./apps/... 覆盖 apps 下全部包但不扫描 CLI;需要执行 CLI 集成测试时单独运行 go test ./tools/cli,CI 若要测试全部 Go 包但跳过集成测试则运行 go test -short ./...。单目标执行对应 package 的测试子树。旧 manifest 自定义 app/package/build/run/test/health-url 不再生效。smoke 和整个 dev 入口已删除。

基础默认值随 Chart 发布;CLI 不再提供部署 profile 参数或预设选择,部署直接使用 Chart 默认值和项目配置。config check 带 project-id 时验证登记及字段,未知或旧代号不再通过;不带代号只检查全局静态结构。

域名和 TLS Secret 通过 config new 保存。WSL 可显式使用 --windows-hosts 维护开发机解析,云 VM 使用 DNS;不再提供 beta/release 预设。

本地 run all 除了通用宿主、local.* 配置和本机持久 PostgreSQL,还会根据 local.demo 启动仓库内置登录与 Hello Demo,本地演示账号和密码固定为 demo/demo123;不读取用户环境变量。Helm 直接使用 values 中的展示密码,TLS 证书由 Secret 管理。显式 --database temporary 使用随机密码,退出时回收。

Go 项目的 build、run、test 需要源码和 Go。本仓库默认 run 还需要已由 db start 启动的本机 PostgreSQL,以及 Windows 上执行统一迁移脚本所需的 Git for Windows;只有 --database temporary 需要 Docker。run 会按目标先构建,再启动 .gw-build/local/ 下对应二进制;Windows 启动 .exe,省略目标时等同 build all。如果旧 app 仍占用任一 app 端口,run 直接失败,不会自动终止旧进程。npm 发布使用当前平台 npm;镜像命令优先使用当前平台 Docker,Windows 缺少 Docker 时转 WSL;Chart 推送在 Windows 默认走 WSL,可用 --wsl=false 切换。平台能力由 doctor 输出。

根 --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 直接使用 npm 包中的 Linux amd64 CLI,或使用已核对版本的独立二进制。下面是 Windows 源码端的预览入口:

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。已有密码分别复用,首次密码隐藏输入,危险修改需二次确认。显式提供 --tls-secret-name/--tls-cert-file/--tls-key-file/--tls-host 可导入公司证书;WSL 开发机可加 --windows-hosts。完整说明见 k3s 初始化。本轮包包含上述参数和 WSL PowerShell 路径回退。

发布凭据

项目身份仅来自 --project-id,默认交付地址和资源名称从代号推导。Harbor 端点按对应命令支持的参数 > GW_HARBOR_REGISTRY/GW_HARBOR_PROJECT > 用户配置端点 > szharbor.g-bits.com/jszx-infra 默认值解析。用户 ~/jszx-infra/.gw-cli/config.yaml 保存凭据、平台区块和项目制品版本,不保存当前项目;旧 projects.yaml 仅通过显式 GW_CLI_PROJECTS 兼容。CI 显式传代号并注入凭据,无需携带项目清单。帮助和版本查询不创建配置。

Namespace/应用 Release 默认代号,PG Release 默认 <代号>-pg,数据库名/用户名将 - 转为 _,数据库连接 Secret 默认 <代号>-database。超长 Release/资源名自动缩短并保留确定性哈希;Namespace 和制品地址保留完整代号。kubeconfig/context 默认 /etc/rancher/k3s/k3s.yaml / default,可通过现有参数及环境变量覆盖。详细规则见多项目 CLI 指南。

go run ./tools/cli npm publish
go run ./tools/cli --project-id gw-demo image push
go run ./tools/cli --project-id gw-demo chart push

缺少 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 的 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 不探测、不登录、不询问账密。

实际安装依次输出目标、Chart默认值、前置检查和 Helm 结果,等待期间定期显示 Pod 状态。通用部署检查已有数据库 Secret;AuthGateway VM 的 prepare 由 Chart 创建数据库资源,serve 才要求数据库、TLS 与镜像拉取 Secret 已就绪。

Token 和密码在终端中不回显。配置文件保存明文凭据,Unix 下目录/文件权限为 0700/0600,Windows 使用用户目录 ACL。网关服务不读取此文件。

源码打包与本地验证

已有公开 npm 包;npm 构建/发布在当前源码中不再使用项目代号,版本统一记录到 shared.artifacts.npm:

# 自动使用当天序号,终端会打印版本和文件名
go run ./tools/cli 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 config show
# 只检查发布包,不上传、不询问 Token
go run ./tools/cli npm publish --dry-run
# 获得发布授权后执行:重新构建并自动编号,输入具备发布权限的 npm Token
go run ./tools/cli npm publish

发布后的版本号不可复用。这里的 gw-cli 是包内命令名,公网下载始终使用 scoped 包 @gbits-jszx/gw-cli。

AuthGateway 首装参数简化

init 不再询问 Namespace、数据库名或业务用户名;config new 保存目标和前缀,配置中的首装能力标记决定流程,不根据 authgateway 等固定名称选择分支。PostgreSQL owner/runtime 角色由前缀派生;Redis 使用独立实例、逻辑库0和默认ACL用户,密码在Secret自动生成并复用。若只想实例名为 authgw,使用已发布制品的 project-id=authgateway,并在引导中填写 Namespace/Release=authgw;改 project-id 会改变默认制品仓库。

首次使用 npx -y --prefer-online @gbits-jszx/gw-cli@latest config new,按显示默认值填写或回车,保存 Namespace/Release、数据库前缀、域名和证书路径。部署自动读取项目配置,日常只传 project-id/version/tag;namespace/release 保留为本次覆盖参数,Chart 地址自动推导。

npx -y --prefer-online @gbits-jszx/gw-cli@latest --project-id authgateway deploy helm install --version 2026.1009.12-a06e78d --tag 2026.1009.6-d6ac256

首装按 config new → k3s init一次准备PG16/Redis/PVC/TLS与镜像凭据 → helm install初始化业务并启动应用;后续只执行install。Profile参数和旧预设读取已删除;新项目使用Chart默认值。旧profile字段明确报错,只读检查不自动改写用户配置。--values/--set保留为高级覆盖,非日常必填项。 完整默认值、操作命令和顺序解释见云 VM 指南。