@hippox/codegenie 1.2.15 → 3.11.2026

package/README.md

@@ -1,25 +1,31 @@
-# 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` 命令
+- 首次运行只会提取内置 kernel 到 `~/.codegenie/kernel`，不会再把二进制复制到 `~/.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,14 @@
+#!/usr/bin/env node
+
+const { resolveBinary } = require("../lib/resolve-binary.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] First launch will only extract kernel files to ~/.codegenie/kernel. No second self-install is required.")
+} 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/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",
   "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"
   },
   "publishConfig": {
     "access": "public"