@steinscheng/zhaotongkuan

这是「找同款」的轻量安装引导器，不包含业务源码、激活码、渠道凭据或用户数据。它会获取与版本对应的 GitHub Release，校验整个 ZIP 的 SHA-256，然后以参数数组调用发行包内的确定性安装器。

npx @steinscheng/zhaotongkuan@latest install --start --json

自动化或远程部署在只想验证安装、启动、授权门禁后立即退出时，使用：

npx @steinscheng/zhaotongkuan@latest install \
  --start \
  --stop-after-check \
  --json

--stop-after-check 必须与 --start 同时使用；成功结果不会留下本地服务进程。

私有 GitHub Release 会优先使用已登录的 gh CLI 下载；引导器不读取、保存或输出 GitHub Token。也可以安装发行方通过其他可信渠道交付的本地 ZIP：

npx @steinscheng/zhaotongkuan@latest install \
  --archive "/absolute/path/to/zhaotongkuan.zip" \
  --expected-sha256 "<trusted 64-character sha256>" \
  --start \
  --json

必须由发行方通过独立可信渠道提供 --expected-sha256。不要从和 ZIP 同一个未验证页面临时复制哈希。

支持 Windows 10/11、macOS 或 Linux（x64/arm64），需要 Node.js 18.18+ 和 Python 3.10+。第一阶段使用 Python 运行已审计的安装事务；引导器不会安装系统级 Python、FFmpeg 或 Codex。Windows 可使用 scripts/install.cmd、scripts/start.cmd 和 scripts/ztk.cmd，macOS/Linux 继续使用对应 .command 入口。

若机器同时保留系统旧版 Python 和新版 Python，可用 --python <Python可执行文件绝对路径> 显式指定；Windows 会识别 python.exe/py，macOS 引导器也会检查 Homebrew 的标准安装位置。