@steinscheng/zhaotongkuan 0.8.0 → 0.8.4

package/README.md

@@ -6,6 +6,17 @@
 npx @steinscheng/zhaotongkuan@latest install --start --json
 ```
 
+自动化或远程部署在只想验证安装、启动、授权门禁后立即退出时，使用：
+
+```bash
+npx @steinscheng/zhaotongkuan@latest install \
+  --start \
+  --stop-after-check \
+  --json
+```
+
+`--stop-after-check` 必须与 `--start` 同时使用；成功结果不会留下本地服务进程。
+
 私有 GitHub Release 会优先使用已登录的 `gh` CLI 下载；引导器不读取、保存或输出 GitHub Token。也可以安装发行方通过其他可信渠道交付的本地 ZIP：
 
 ```bash
@@ -18,6 +29,6 @@ npx @steinscheng/zhaotongkuan@latest install \
 
 必须由发行方通过独立可信渠道提供 `--expected-sha256`。不要从和 ZIP 同一个未验证页面临时复制哈希。
 
-需要 macOS 或 Linux（x64/arm64）、Node.js 18.18+ 和 Python 3.10+。第一阶段使用 Python 运行已审计的安装事务；引导器不会安装系统级 Python、FFmpeg 或 Codex。当前发行包依赖 POSIX 启动脚本，不声明 Windows 支持。
+支持 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 /absolute/path/to/python3` 显式指定；macOS 引导器也会检查 Homebrew 的标准安装位置。
+若机器同时保留系统旧版 Python 和新版 Python，可用 `--python <Python可执行文件绝对路径>` 显式指定；Windows 会识别 `python.exe`/`py`，macOS 引导器也会检查 Homebrew 的标准安装位置。

package/package.json

@@ -1,14 +1,16 @@
 {
   "name": "@steinscheng/zhaotongkuan",
-  "version": "0.8.0",
+  "version": "0.8.4",
   "description": "Small, verifiable installer bootstrap for the Zhaotongkuan Codex plugin",
   "type": "module",
   "bin": {
     "zhaotongkuan": "bin/zhaotongkuan.js"
   },
   "files": [
-    "bin/",
-    "src/",
+    "bin/zhaotongkuan.js",
+    "src/cli.js",
+    "src/extract_installer.py",
+    "src/release-channel.json",
     "README.md",
     "LICENSE.txt"
   ],
@@ -21,7 +23,8 @@
   },
   "os": [
     "darwin",
-    "linux"
+    "linux",
+    "win32"
   ],
   "cpu": [
     "x64",

package/src/cli.js

@@ -37,7 +37,7 @@ function cleanText(value, label) {
 }
 
 export function normalizeTarget(platform = process.platform, arch = process.arch) {
-  const platforms = { darwin: "darwin", linux: "linux" };
+  const platforms = { darwin: "darwin", linux: "linux", win32: "windows" };
   const architectures = { x64: "amd64", arm64: "arm64" };
   if (!platforms[platform] || !architectures[arch]) {
     throw new BootstrapError(`unsupported platform: ${platform}/${arch}`, "unsupported_platform");
@@ -81,6 +81,7 @@ export function parseArgs(argv) {
     json: false,
     dryRun: false,
     start: false,
+    stopAfterCheck: false,
     archive: "",
     expectedSha256: "",
     version: "",
@@ -110,6 +111,7 @@ export function parseArgs(argv) {
     if (flag === "--json") result.json = true;
     else if (flag === "--dry-run") result.dryRun = true;
     else if (flag === "--start") result.start = true;
+    else if (flag === "--stop-after-check") result.stopAfterCheck = true;
     else if (flag === "--help" || flag === "-h") result.command = "help";
     else if (flag === "--bootstrap-version") result.command = "version";
     else if (valueFlags.has(flag)) {
@@ -203,6 +205,8 @@ export function findPython(preferred = "", candidates) {
     "/opt/homebrew/bin/python3",
     "/usr/local/bin/python3",
     "/usr/bin/python3",
+    "python.exe",
+    "py",
     "python",
   ];
   for (const value of values) {
@@ -316,6 +320,7 @@ export function installerArgv(options, release, archivePath, installerPath) {
   ];
   if (options.dryRun) argv.push("--dry-run");
   if (options.start) argv.push("--start");
+  if (options.stopAfterCheck) argv.push("--stop-after-check");
   const mappings = [
     [options.dataDir, "--data-dir"],
     [options.installRoot, "--install-root"],
@@ -366,7 +371,7 @@ export function sanitizeForJson(value, key = "", depth = 0) {
 }
 
 function help() {
-  return `Usage:\n  npx @steinscheng/zhaotongkuan@latest install [options]\n\nSupported hosts:\n  macOS or Linux on x64/arm64\n\nOptions:\n  --archive <path-or-https-url>  Install an explicit release archive\n  --expected-sha256 <digest>     Trusted SHA-256 (required with --archive)\n  --dry-run                      Validate without writing\n  --start                        Start and health-check the service\n  --data-dir <path>              Preserve business data outside the program\n  --install-root <path>          Override managed program directory\n  --codex-bin <path>             Use an explicit Codex CLI\n  --python <path>                Use an explicit Python 3.10+ executable\n  --json                         Emit one JSON object\n`;
+  return `Usage:\n  npx @steinscheng/zhaotongkuan@latest install [options]\n\nSupported hosts:\n  Windows, macOS, or Linux on x64/arm64\n\nOptions:\n  --archive <path-or-https-url>  Install an explicit release archive\n  --expected-sha256 <digest>     Trusted SHA-256 (required with --archive)\n  --dry-run                      Validate without writing\n  --start                        Start and health-check the service\n  --stop-after-check             Stop after a successful startup health check\n  --data-dir <path>              Preserve business data outside the program\n  --install-root <path>          Override managed program directory\n  --codex-bin <path>             Use an explicit Codex CLI\n  --python <path>                Use an explicit Python 3.10+ executable\n  --json                         Emit one JSON object\n`;
 }
 
 function emitError(error, jsonMode) {

package/src/release-channel.json

@@ -1,11 +1,11 @@
 {
   "schema_version": 1,
   "repository": "SchengSteins/zhaotongkuan",
-  "version": "0.8.0",
+  "version": "0.8.4",
   "artifacts": {
     "any": {
-      "url": "https://github.com/SchengSteins/zhaotongkuan/releases/download/v0.8.0/zhaotongkuan-0.8.0.zip",
-      "sha256": "4bee7fcb5a24facbaa8d943ce8a41a6e900464de9f371bd06a545bc4aae14ad5"
+      "url": "https://github.com/SchengSteins/zhaotongkuan/releases/download/v0.8.4/zhaotongkuan-0.8.4.zip",
+      "sha256": "42b0c3911b27b595127e40ca571a4f4bf807f5d410e1f1d042fb4bcc8c257aae"
     }
   }
 }