@hippox/codegenie 3.11.2026-rc.2 → 3.11.2026-rc.3

package/README.md

@@ -17,11 +17,27 @@ codegenie --version
 说明：
 
 - npm 安装会直接创建全局 `codegenie` 命令
-- npm 安装阶段会预热 runtime assets，因此安装时间会略长，但首次运行会更快
-- 首次运行通常不再需要解包和安装依赖；只有预热失败时，才会在首启补做初始化
+- npm 安装阶段会预热 runtime assets；Windows 还会额外隐藏预热一次默认启动路径，因此安装时间会略长，但首次可见启动会更快
+- 首次运行通常不再需要解包和安装依赖；首次进入某个工作区时，仍可能有少量项目级初始化
 - 首次运行不会再把二进制复制到 `~/.codegenie/bin`
+- npm 安装/升级会清理旧的 standalone 二进制和临时更新残留
 - `upgrade` 在 npm 安装场景下会提示或委托执行 npm 升级命令，不直接覆写 npm 全局目录
 
+## 卸载
+
+推荐顺序：
+
+```bash
+codegenie uninstall --yes
+npm uninstall -g @hippox/codegenie
+```
+
+说明：
+
+- `codegenie uninstall --yes` 删除 `~/.codegenie` 运行目录
+- `npm uninstall -g @hippox/codegenie` 删除 npm 全局命令和包记录
+- npm 卸载生命周期脚本会做最佳努力清理，但不同 npm 版本行为不完全一致，不应只依赖 `npm uninstall -g`
+
 ## 平台说明
 
 当前 staged 平台包：`@hippox/codegenie-win32-x64`

package/bin/codegenie.js

@@ -1,17 +1,19 @@
 #!/usr/bin/env node
 
 const { spawnSync } = require("child_process")
+const { buildLaunchEnv } = require("../lib/launch.js")
 const { resolveBinary } = require("../lib/resolve-binary.js")
+const { shouldPrintStartupHint, startupHintText } = require("../lib/startup-hint.js")
 
 function main() {
+  if (shouldPrintStartupHint(process.argv.slice(2))) {
+    console.error(startupHintText())
+  }
+
   const resolved = resolveBinary()
   const result = spawnSync(resolved.binaryPath, process.argv.slice(2), {
     stdio: "inherit",
-    env: {
-      ...process.env,
-      CODEGENIE_INSTALL_SOURCE: "npm",
-      CODEGENIE_NPM_PACKAGE: resolved.packageName,
-    },
+    env: buildLaunchEnv(resolved.packageName, process.env),
   })
 
   if (result.error) {

package/bin/postinstall.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 const { resolveBinary } = require("../lib/resolve-binary.js")
-const { prewarmBinary } = require("../lib/prewarm.js")
+const { prewarmBinary, warmStartupBinary } = require("../lib/prewarm.js")
 
 try {
   const resolved = resolveBinary()
@@ -16,6 +16,16 @@ try {
   } else {
     console.log("[codegenie] Runtime assets are ready. First launch should be faster.")
   }
+
+  if (process.platform === "win32") {
+    console.log("[codegenie] Finalizing hidden first-launch warmup...")
+    const startupWarm = warmStartupBinary(resolved.binaryPath)
+    if (startupWarm.error) {
+      console.warn(`[codegenie] Hidden startup warmup failed: ${startupWarm.error.message}`)
+    } else if (typeof startupWarm.status === "number" && startupWarm.status !== 0) {
+      console.warn(`[codegenie] Hidden startup warmup exited with code ${startupWarm.status}. First visible launch may still be slower.`)
+    }
+  }
 } catch (error) {
   const message = error && error.message ? error.message : String(error)
   console.warn("[codegenie] npm install completed, but platform binary verification will be deferred to first launch.")

package/bin/uninstall.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+const { cleanupAfterNpmUninstall } = require("../lib/cleanup.js")
+
+try {
+  const result = cleanupAfterNpmUninstall()
+  if (result.removed) {
+    console.log(`[codegenie] Removed runtime directory: ${result.rootDir}`)
+  } else if (result.reason === "standalone-active") {
+    console.log("[codegenie] Skip runtime cleanup because standalone installation is still active.")
+  } else if (result.reason === "package-mismatch") {
+    console.log("[codegenie] Skip runtime cleanup because install context belongs to another npm package.")
+  } else if (result.reason === "standalone-binary-present") {
+    console.log("[codegenie] Skip runtime cleanup because standalone binary is still present.")
+  }
+} catch (error) {
+  const message = error && error.message ? error.message : String(error)
+  console.warn(`[codegenie] Runtime cleanup during npm uninstall failed: ${message}`)
+}

package/lib/cleanup.js

@@ -0,0 +1,76 @@
+const fs = require("fs")
+const os = require("os")
+const path = require("path")
+
+function runtimePaths(homeDir = os.homedir()) {
+  const rootDir = path.join(homeDir, ".codegenie")
+  const binDir = path.join(rootDir, "bin")
+  return {
+    rootDir,
+    binDir,
+    binaryPath: path.join(binDir, process.platform === "win32" ? "codegenie.exe" : "codegenie"),
+    installContextPath: path.join(rootDir, "install-context.json"),
+  }
+}
+
+function isRecord(value) {
+  return typeof value === "object" && value !== null
+}
+
+function belongsToExpectedPackageFamily(actualPackageName, expectedPackageName) {
+  return actualPackageName === expectedPackageName || actualPackageName.startsWith(`${expectedPackageName}-`)
+}
+
+function readInstallContext(homeDir = os.homedir()) {
+  try {
+    const raw = JSON.parse(fs.readFileSync(runtimePaths(homeDir).installContextPath, "utf-8"))
+    if (!isRecord(raw)) return null
+    if (raw.installSource !== "npm" && raw.installSource !== "standalone") return null
+    return {
+      installSource: raw.installSource,
+      npmPackageName:
+        typeof raw.npmPackageName === "string" && raw.npmPackageName.trim() ? raw.npmPackageName.trim() : null,
+    }
+  } catch {
+    return null
+  }
+}
+
+function cleanupAfterNpmUninstall(options = {}) {
+  const homeDir = options.homeDir || os.homedir()
+  const expectedPackageName =
+    options.expectedPackageName || process.env.CODEGENIE_NPM_PACKAGE || process.env.npm_package_name || null
+  const paths = runtimePaths(homeDir)
+  const context = readInstallContext(homeDir)
+
+  if (context && context.installSource === "standalone") {
+    return { removed: false, reason: "standalone-active", rootDir: paths.rootDir }
+  }
+
+  if (
+    context &&
+    expectedPackageName &&
+    context.npmPackageName &&
+    !belongsToExpectedPackageFamily(context.npmPackageName, expectedPackageName)
+  ) {
+    return { removed: false, reason: "package-mismatch", rootDir: paths.rootDir }
+  }
+
+  if (!context && fs.existsSync(paths.binaryPath)) {
+    return { removed: false, reason: "standalone-binary-present", rootDir: paths.rootDir }
+  }
+
+  if (!fs.existsSync(paths.rootDir)) {
+    return { removed: false, reason: "missing", rootDir: paths.rootDir }
+  }
+
+  fs.rmSync(paths.rootDir, { recursive: true, force: true })
+  return { removed: true, reason: "removed", rootDir: paths.rootDir }
+}
+
+module.exports = {
+  belongsToExpectedPackageFamily,
+  cleanupAfterNpmUninstall,
+  readInstallContext,
+  runtimePaths,
+}

package/lib/launch.js

@@ -0,0 +1,14 @@
+const packageJson = require("../package.json")
+
+function buildLaunchEnv(resolvedPackageName, baseEnv = process.env) {
+  return {
+    ...baseEnv,
+    CODEGENIE_INSTALL_SOURCE: "npm",
+    CODEGENIE_NPM_PACKAGE: packageJson.name,
+    CODEGENIE_NPM_PLATFORM_PACKAGE: resolvedPackageName,
+  }
+}
+
+module.exports = {
+  buildLaunchEnv,
+}

package/lib/prewarm.js

@@ -1,3 +1,5 @@
+const fs = require("fs")
+const os = require("os")
 const { spawnSync } = require("child_process")
 
 function buildPrewarmEnv(baseEnv = process.env) {
@@ -5,6 +7,8 @@ function buildPrewarmEnv(baseEnv = process.env) {
     ...baseEnv,
     CODEGENIE_PREPARE_ONLY: "true",
     CODEGENIE_INSTALL_SOURCE: "npm",
+    CODEGENIE_NPM_PACKAGE:
+      baseEnv.CODEGENIE_NPM_PACKAGE || baseEnv.npm_package_name || "codegenie",
   }
 }
 
@@ -16,7 +20,51 @@ function prewarmBinary(binaryPath, spawnImpl = spawnSync, baseEnv = process.env)
   })
 }
 
+function buildStartupWarmEnv(baseEnv = process.env) {
+  return {
+    ...baseEnv,
+    CODEGENIE_WARM_STARTUP: "true",
+    CODEGENIE_WARM_STARTUP_TIMEOUT_MS: baseEnv.CODEGENIE_WARM_STARTUP_TIMEOUT_MS || "10000",
+    CODEGENIE_INSTALL_SOURCE: "npm",
+    CODEGENIE_NPM_PACKAGE:
+      baseEnv.CODEGENIE_NPM_PACKAGE || baseEnv.npm_package_name || "codegenie",
+    OPENCODE_DISABLE_AUTOUPDATE: "true",
+  }
+}
+
+function resolveWarmupCwd(baseEnv = process.env, existsImpl = fs.existsSync) {
+  const initCwd = typeof baseEnv.INIT_CWD === "string" ? baseEnv.INIT_CWD.trim() : ""
+  if (initCwd && existsImpl(initCwd)) {
+    return initCwd
+  }
+
+  const userProfile = typeof baseEnv.USERPROFILE === "string" ? baseEnv.USERPROFILE.trim() : ""
+  if (userProfile) {
+    return userProfile
+  }
+
+  const home = typeof baseEnv.HOME === "string" ? baseEnv.HOME.trim() : ""
+  if (home) {
+    return home
+  }
+
+  return os.homedir()
+}
+
+function warmStartupBinary(binaryPath, spawnImpl = spawnSync, baseEnv = process.env, existsImpl = fs.existsSync) {
+  return spawnImpl(binaryPath, [], {
+    stdio: "ignore",
+    timeout: 20000,
+    windowsHide: true,
+    cwd: resolveWarmupCwd(baseEnv, existsImpl),
+    env: buildStartupWarmEnv(baseEnv),
+  })
+}
+
 module.exports = {
   buildPrewarmEnv,
+  buildStartupWarmEnv,
   prewarmBinary,
+  resolveWarmupCwd,
+  warmStartupBinary,
 }

package/lib/startup-hint.js

@@ -0,0 +1,19 @@
+function shouldPrintStartupHint(argv = [], options = {}) {
+  const env = options.env || process.env
+  const platform = options.platform || process.platform
+  const isTTY = options.isTTY ?? process.stderr.isTTY
+
+  if (!isTTY) return false
+  if (platform !== "win32") return false
+  if (env.CODEGENIE_PREPARE_ONLY === "true" || env.CODEGENIE_WARM_STARTUP === "true") return false
+  return argv.length === 0
+}
+
+function startupHintText() {
+  return "[codegenie] Starting interface..."
+}
+
+module.exports = {
+  shouldPrintStartupHint,
+  startupHintText,
+}

package/package.json

@@ -1,11 +1,14 @@
 {
   "name": "@hippox/codegenie",
-  "version": "3.11.2026-rc.2",
+  "version": "3.11.2026-rc.3",
   "private": false,
   "description": "HarmonyOS AI 开发 CLI，binary-first 发布并通过 npm 分发平台二进制",
   "license": "MIT",
   "scripts": {
-    "postinstall": "node ./bin/postinstall.js"
+    "postinstall": "node ./bin/postinstall.js",
+    "preuninstall": "node ./bin/uninstall.js",
+    "uninstall": "node ./bin/uninstall.js",
+    "postuninstall": "node ./bin/uninstall.js"
   },
   "bin": {
     "codegenie": "bin/codegenie.js"
@@ -23,7 +26,7 @@
     "ai"
   ],
   "optionalDependencies": {
-    "@hippox/codegenie-win32-x64": "3.11.2026-rc.2"
+    "@hippox/codegenie-win32-x64": "3.11.2026-rc.3"
   },
   "publishConfig": {
     "access": "public"