@hunyed15/codecgc 0.1.0 → 0.1.1

package/INSTALLATION.md

@@ -34,16 +34,21 @@ npm --version     # 应显示 9.x.x 或更高
 
 ## 安装 CodeCGC
 
-### 方式 1：从源码全局安装（推荐）
+### 方式 1：从 npm 全局安装（推荐）
 
 ```bash
-# 1. 解压 release 包到本地目录
-cd /path/to/codecgc/release
+# 使用 npm 官方源安装
+npm install -g @hunyed15/codecgc --registry=https://registry.npmjs.org/
+```
+
+安装完成后，CodeCGC 会尝试自动执行一次用户级 Claude 集成，相当于：
 
-# 2. 全局安装
-npm install -g .
+```bash
+cgc-install --mode user
 ```
 
+如果安装阶段因为 Python 未就绪而跳过了这一步，可以在装好 Python 后手动补执行该命令。
+
 安装后，以下命令将全局可用：
 - `cgc`
 - `cgc-install`

package/README.md

@@ -1,4 +1,4 @@
-# CodeCGC Release v0.1.0
+# CodeCGC Release v0.1.1
 
 ## 📦 发布内容
 
@@ -6,7 +6,7 @@
 
 ## 📋 版本信息
 
-- **版本号**: 0.1.0
+- **版本号**: 0.1.1
 - **发布日期**: 2026-05-04
 - **Python 要求**: >= 3.10
 - **Node.js 要求**: >= 20.0.0
@@ -36,20 +36,19 @@
 ### 1. 安装
 
 ```bash
-# 进入 release 目录
-cd /path/to/codecgc/release
-
-# 安装 CodeCGC
-npm install -g .
+# 从 npm 安装 CodeCGC
+npm install -g @hunyed15/codecgc --registry=https://registry.npmjs.org/
 
 # 安装 Python 依赖
 pip install pyyaml
 
-# 安装 MCP 服务器
-cd codexmcp && pip install -e . && cd ..
-cd geminimcp && pip install -e . && cd ..
+# 如自动集成未生效，可手动补执行
+cgc-install --mode user
 ```
 
+全局安装完成后，CodeCGC 会尝试自动写入 Claude 用户级集成到 `~/.claude`。
+如果安装时 Python 尚未就绪，自动集成会跳过，此时可在安装 Python 后手动执行 `cgc-install --mode user`。
+
 ### 2. 初始化项目
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hunyed15/codecgc",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Claude-hosted multi-model workflow product shell for CodeCGC.",
   "license": "MIT",
   "type": "commonjs",
@@ -23,6 +23,7 @@
     "cgc-route": "bin/cgc-route.js"
   },
   "scripts": {
+    "postinstall": "node scripts/postinstall_codecgc.js",
     "cgc:help": "node bin/cgc.js --help",
     "cgc:status": "node bin/cgc-status.js --format summary",
     "cgc:doctor": "node bin/cgc-doctor.js --format summary",
@@ -39,6 +40,7 @@
   "files": [
     "bin/",
     "scripts/*.py",
+    "scripts/postinstall_codecgc.js",
     "scripts/README-codecgc-cli.md",
     ".claude/hooks/route-edit.ps1",
     "codecgc/cgc/",

package/scripts/postinstall_codecgc.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+const path = require("node:path");
+
+function shouldRunUserInstall() {
+  const globalFlag = String(process.env.npm_config_global || "").toLowerCase();
+  const localPrefix = String(process.env.npm_config_local_prefix || "");
+  const prefix = String(process.env.npm_config_prefix || "");
+
+  if (globalFlag === "true") {
+    return true;
+  }
+  if (prefix && localPrefix && prefix !== localPrefix) {
+    return true;
+  }
+  return false;
+}
+
+function findPython() {
+  const override = String(process.env.CODECGC_PYTHON_COMMAND || "").trim();
+  const candidates = override
+    ? [override]
+    : (process.platform === "win32" ? ["python", "py"] : ["python3", "python"]);
+
+  for (const command of candidates) {
+    const probe = spawnSync(command, ["--version"], {
+      encoding: "utf8",
+      shell: false,
+    });
+    if (probe.status === 0) {
+      return command;
+    }
+  }
+  return "";
+}
+
+function main() {
+  if (!shouldRunUserInstall()) {
+    return 0;
+  }
+
+  const python = findPython();
+  if (!python) {
+    console.warn("[codecgc] Skipped automatic Claude integration: Python was not found.");
+    console.warn("[codecgc] Run `cgc-install --mode user` after installing Python.");
+    return 0;
+  }
+
+  const repoRoot = path.resolve(__dirname, "..");
+  const installScript = path.join(repoRoot, "scripts", "install_codecgc.py");
+  const result = spawnSync(
+    python,
+    [installScript, "--mode", "user", "--format", "summary"],
+    {
+      cwd: repoRoot,
+      stdio: "inherit",
+      shell: false,
+      env: {
+        ...process.env,
+        PYTHONIOENCODING: process.env.PYTHONIOENCODING || "utf-8",
+        PYTHONUTF8: process.env.PYTHONUTF8 || "1",
+      },
+    },
+  );
+
+  if (result.status !== 0) {
+    console.warn("[codecgc] Automatic Claude integration did not complete during npm install.");
+    console.warn("[codecgc] You can retry manually with `cgc-install --mode user`.");
+  }
+
+  return 0;
+}
+
+process.exit(main());