@steinscheng/zhaotongkuan 0.8.8 → 0.8.10

package/README.md

@@ -17,6 +17,24 @@ npx @steinscheng/zhaotongkuan@latest install \
 
 `--stop-after-check` 必须与 `--start` 同时使用；成功结果不会留下本地服务进程。
 
+已有安装可直接使用同一个 npm 引导器升级，无需手动准备 ZIP 或 SHA-256：
+
+```bash
+npx @steinscheng/zhaotongkuan@latest update --start --json
+```
+
+`update` 会读取标准安装目录中的 `config/installation.json`，复用原来的业务数据目录和安装根目录，并把经过内置 SHA-256 校验的发行包交给同一事务安装器。若原安装使用了自定义目录，请显式传入 `--data-dir`，必要时同时传入 `--install-root`：
+
+```powershell
+npx @steinscheng/zhaotongkuan@latest update `
+  --data-dir "C:\Users\Alice\AppData\Local\找同款" `
+  --install-root "C:\Users\Alice\AppData\Local\找同款\installation" `
+  --start `
+  --json
+```
+
+更新前应停止正在运行的任务。更新器不会切换数据目录、不会删除激活或浏览器资料；更新失败会返回 JSON 并回滚。`update` 不支持找不到安装记录的全新机器，此时使用 `install`。
+
 私有 GitHub Release 会优先使用已登录的 `gh` CLI 下载；引导器不读取、保存或输出 GitHub Token。也可以安装发行方通过其他可信渠道交付的本地 ZIP：
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steinscheng/zhaotongkuan",
-  "version": "0.8.8",
+  "version": "0.8.10",
   "description": "Small, verifiable installer bootstrap for the Zhaotongkuan Codex plugin",
   "type": "module",
   "bin": {

package/src/cli.js

@@ -2,7 +2,7 @@ import { createHash } from "node:crypto";
 import { createReadStream, createWriteStream, existsSync, mkdtempSync, readFileSync, rmSync } from "node:fs";
 import { copyFile, lstat, mkdir, realpath } from "node:fs/promises";
 import { get as httpsGet } from "node:https";
-import { tmpdir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import { basename, dirname, isAbsolute, join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { spawnSync } from "node:child_process";
@@ -126,6 +126,43 @@ export function parseArgs(argv) {
   return result;
 }
 
+function defaultDataDir(platform = process.platform, env = process.env) {
+  const configured = String(env.ZTK_DATA_DIR || "").trim();
+  if (configured) return resolve(configured);
+  if (platform === "win32") {
+    return resolve(env.LOCALAPPDATA || join(homedir(), "AppData", "Local"), "找同款");
+  }
+  if (platform === "darwin") return resolve(join(homedir(), "Library", "Application Support", "找同款"));
+  return resolve(env.XDG_DATA_HOME || join(homedir(), ".local", "share"), "zhaotongkuan");
+}
+
+export function discoverExistingInstall(options, platform = process.platform, env = process.env) {
+  const requestedDataDir = options.dataDir ? resolve(options.dataDir) : defaultDataDir(platform, env);
+  const installRoot = resolve(options.installRoot || join(requestedDataDir, "installation"));
+  const pluginRoot = join(installRoot, "plugins", "zhaotongkuan");
+  const configPath = join(pluginRoot, "config", "installation.json");
+  if (!existsSync(configPath)) {
+    throw new BootstrapError(
+      "could not find an existing managed installation; pass --data-dir and --install-root if it uses custom paths",
+      "existing_installation_missing",
+    );
+  }
+  let config;
+  try {
+    config = JSON.parse(readFileSync(configPath, "utf8"));
+  } catch {
+    throw new BootstrapError("existing installation metadata is invalid", "existing_installation_invalid");
+  }
+  const recordedDataDir = config && typeof config.data_dir === "string" ? resolve(config.data_dir) : null;
+  if (!recordedDataDir) {
+    throw new BootstrapError("existing installation metadata has no valid data directory", "existing_installation_invalid");
+  }
+  if (options.dataDir && requestedDataDir !== recordedDataDir) {
+    throw new BootstrapError("--data-dir does not match the existing installation", "data_dir_mismatch");
+  }
+  return { dataDir: recordedDataDir, installRoot };
+}
+
 export function loadChannel() {
   const channel = JSON.parse(readFileSync(CHANNEL_PATH, "utf8"));
   if (channel.schema_version !== 1 || !channel.repository || !channel.version) {
@@ -371,7 +408,7 @@ export function sanitizeForJson(value, key = "", depth = 0) {
 }
 
 function help() {
-  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`;
+  return `Usage:\n  npx @steinscheng/zhaotongkuan@latest install [options]\n  npx @steinscheng/zhaotongkuan@latest update [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\nThe update command discovers the existing managed installation and reuses its data directory and install root.\n`;
 }
 
 function emitError(error, jsonMode) {
@@ -403,7 +440,13 @@ export async function main(argv) {
       process.stdout.write(`${PACKAGE_JSON.version}\n`);
       return 0;
     }
-    if (options.command !== "install") throw new BootstrapError(`unknown command: ${options.command}`, "invalid_argument");
+    if (!["install", "update"].includes(options.command)) {
+      throw new BootstrapError(`unknown command: ${options.command}`, "invalid_argument");
+    }
+    if (options.command === "update") {
+      const existing = discoverExistingInstall(options);
+      options = { ...options, ...existing };
+    }
 
     const release = resolveRelease(options);
     const python = findPython(options.python);
@@ -446,6 +489,7 @@ export async function main(argv) {
         release_version: release.version,
         target: `${release.target.platform}-${release.target.arch}`,
         checksum_verified: true,
+        operation: options.command,
       },
     };
     process.stdout.write(`${JSON.stringify(output)}\n`);

package/src/release-channel.json

@@ -1,11 +1,11 @@
 {
   "schema_version": 1,
   "repository": "SchengSteins/zhaotongkuan",
-  "version": "0.8.8",
+  "version": "0.8.10",
   "artifacts": {
     "any": {
-      "url": "https://github.com/SchengSteins/zhaotongkuan/releases/download/v0.8.8/zhaotongkuan-0.8.8.zip",
-      "sha256": "09b1c9322a4e52c1f6dbc8ab000a1e57828886fe41b052afc2920a166164cf2f"
+      "url": "https://github.com/SchengSteins/zhaotongkuan/releases/download/v0.8.10/zhaotongkuan-0.8.10.zip",
+      "sha256": "22dc69e85afd4cc475663cc9b45b8bdcb7615d28d15796a0c789205f9856452f"
     }
   }
 }