@hippox/codegenie 1.2.15 → 3.11.2026-rc.1

package/README.md

@@ -1,25 +1,33 @@
-# CodeGenie CLI
-
-`CodeGenie` 是面向 HarmonyOS 开发场景的 AI CLI。
-
-## 安装
-
-```bash
-npm install -g codegenie
-```
-
-安装完成后直接执行：
-
-```bash
-codegenie --version
-```
-
-## 平台说明
-
-- npm 安装默认提供主流 `Windows/macOS/Linux` 二进制包
-- `baseline` 兼容构建不会通过 npm 分发，老 CPU 请改用独立二进制发布件
-- `upgrade` 在 npm 安装场景下会提示或委托 `npm install -g codegenie@<tag>`，不会直接覆写 npm 全局目录
-
-## 发布说明
-
-仓库中的 `packages/npm/codegenie` 为元包模板。正式发布前请先运行仓库脚本生成 `dist/npm/` 下的 publishable 包，再按发布顺序上传各平台包和元包。
+# CodeGenie CLI
+
+`CodeGenie` 是面向 HarmonyOS 开发场景的 AI CLI。
+
+## 安装
+
+```bash
+npm install -g @hippox/codegenie
+```
+
+安装完成后即可直接执行：
+
+```bash
+codegenie --version
+```
+
+说明：
+
+- npm 安装会直接创建全局 `codegenie` 命令
+- npm 安装阶段会预热 runtime assets，因此安装时间会略长，但首次运行会更快
+- 首次运行通常不再需要解包和安装依赖；只有预热失败时，才会在首启补做初始化
+- 首次运行不会再把二进制复制到 `~/.codegenie/bin`
+- `upgrade` 在 npm 安装场景下会提示或委托执行 npm 升级命令，不直接覆写 npm 全局目录
+
+## 平台说明
+
+当前 staged 平台包：`@hippox/codegenie-win32-x64`
+
+- `baseline` 兼容构建不会通过 npm 分发，老 CPU 请改用独立二进制发布件
+
+## 发布说明
+
+仓库中的 `packages/npm/codegenie` 为元包模板。正式发布前请先运行仓库脚本生成 `dist/npm/` 下的 publishable 包，再按发布顺序上传各平台包和元包。

package/bin/postinstall.js

@@ -0,0 +1,23 @@
+#!/usr/bin/env node
+
+const { resolveBinary } = require("../lib/resolve-binary.js")
+const { prewarmBinary } = require("../lib/prewarm.js")
+
+try {
+  const resolved = resolveBinary()
+  console.log("[codegenie] npm install complete. Global command \"codegenie\" is ready.")
+  console.log(`[codegenie] Using platform package ${resolved.packageName}.`)
+  console.log("[codegenie] Prewarming runtime assets during npm install...")
+  const result = prewarmBinary(resolved.binaryPath)
+  if (result.error) {
+    console.warn(`[codegenie] Runtime prewarm failed: ${result.error.message}`)
+  } else if (typeof result.status === "number" && result.status !== 0) {
+    console.warn(`[codegenie] Runtime prewarm exited with code ${result.status}. First launch will finish initialization.`)
+  } else {
+    console.log("[codegenie] Runtime assets are ready. First launch should be faster.")
+  }
+} 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.")
+  console.warn(message)
+}

package/lib/prewarm.js

@@ -0,0 +1,22 @@
+const { spawnSync } = require("child_process")
+
+function buildPrewarmEnv(baseEnv = process.env) {
+  return {
+    ...baseEnv,
+    CODEGENIE_PREPARE_ONLY: "true",
+    CODEGENIE_INSTALL_SOURCE: "npm",
+  }
+}
+
+function prewarmBinary(binaryPath, spawnImpl = spawnSync, baseEnv = process.env) {
+  return spawnImpl(binaryPath, [], {
+    stdio: "ignore",
+    timeout: 120000,
+    env: buildPrewarmEnv(baseEnv),
+  })
+}
+
+module.exports = {
+  buildPrewarmEnv,
+  prewarmBinary,
+}

package/lib/resolve-binary.js

@@ -44,10 +44,11 @@ function resolveBinary() {
   try {
     packageJsonPath = require.resolve(`${packageName}/package.json`)
   } catch (error) {
+    const metaPackageName = process.env.npm_package_name || "codegenie"
     const hint = [
       `[codegenie] Failed to locate installed binary package for ${process.platform}/${process.arch}.`,
       `[codegenie] Expected package: ${packageName}`,
-      "[codegenie] Reinstall with `npm install -g codegenie` or use the standalone binary for baseline / unsupported CPUs.",
+      `[codegenie] Reinstall with \`npm install -g ${metaPackageName}\` or use the standalone binary for baseline / unsupported CPUs.`,
     ].join("\n")
     const wrapped = new Error(hint)
     wrapped.cause = error

package/package.json

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