ai-engineering-init 1.2.9 → 1.3.1

package/.claude/settings.json

@@ -37,11 +37,5 @@
       }
     ]
   },
-  "mcpServers": {
-    "codex": {
-      "command": "/Users/xujiajun/.nvm/versions/node/v20.19.6/bin/codex",
-      "args": ["mcp-server"],
-      "description": "OpenAI Codex CLI - 代码分析/算法实现/代码审查"
-    }
-  }
+  "mcpServers": {}
 }

package/README.md

@@ -49,12 +49,18 @@ cd ai-engineering-init
 | OpenAI Codex | `--tool codex` | `.codex/` 目录 + `AGENTS.md` |
 | 全部 | `--tool all` | 以上全部 |
 
-## 选项
+## 命令与选项
 
-```
+```bash
+# 命令
+npx ai-engineering-init                 # 交互式初始化（安装到当前项目）
+npx ai-engineering-init update          # 更新已安装的框架文件
+npx ai-engineering-init global          # 全局安装到 ~/.claude 等，对所有项目生效
+
+# 选项
 --tool, -t <工具>   指定工具: claude | cursor | codex | all
---dir,  -d <目录>   目标目录（默认：当前目录）
---force,-f          强制覆盖已有文件
+--dir,  -d <目录>   目标目录（默认：当前目录，仅 init/update 有效）
+--force,-f          强制覆盖（init 覆盖已有文件；update/global 同时更新保留文件）
 --help, -h          显示帮助
 ```
 
@@ -237,11 +243,31 @@ npx ai-engineering-init@latest update --force
 
 > **注意**：不加 `@latest` 会使用 npx 本地缓存的旧版本，源文件不是最新的。
 
+## 全局安装（v1.3.0+）
+
+一次安装，所有项目自动生效：
+
+```bash
+# 全局安装所有工具（~/.claude + ~/.cursor + ~/.codex）
+npx ai-engineering-init@latest global
+
+# 只全局安装指定工具
+npx ai-engineering-init@latest global --tool claude
+npx ai-engineering-init@latest global --tool cursor
+
+# 强制覆盖已有全局文件
+npx ai-engineering-init@latest global --force
+```
+
+> **说明**：全局安装将 Skills/Commands/Hooks 安装到 `~/.claude` / `~/.cursor` / `~/.codex`。`settings.json`、`mcp.json` 采用合并策略，不覆盖用户已有配置。项目级配置优先级高于全局配置，两者可共存。
+
 ## 更新日志
 
 查看完整更新历史：[CHANGELOG.md](./CHANGELOG.md)
 
-**v1.2.6 修复**：Cursor stop hook 自包含，不再依赖 Claude Code 安装；修复完成音效无法触发的问题。
+**v1.3.0 新增**：`global` 命令，支持系统级全局安装，一次安装对所有项目生效。
+**v1.2.7 修复**：Cursor `beforeSubmitPrompt` hook 输出格式改为 JSON，修复技能注入失效。
+**v1.2.6 修复**：Cursor stop hook 自包含，不再依赖 Claude Code 安装。
 
 ## License
 

package/bin/index.js

@@ -190,16 +190,15 @@ const GLOBAL_RULES = {
     label: 'Claude Code',
     targetDir: path.join(HOME_DIR, '.claude'),
     files: [
-      { src: '.claude/skills',                dest: 'skills',                label: 'Skills（全局技能库）',    isDir: true },
-      { src: '.claude/commands',              dest: 'commands',              label: 'Commands（全局命令）',    isDir: true },
-      { src: '.claude/agents',               dest: 'agents',               label: 'Agents（全局子代理）',    isDir: true },
-      { src: '.claude/hooks',                dest: 'hooks',                label: 'Hooks（全局钩子）',       isDir: true },
+      { src: '.claude/skills',                dest: 'skills',                label: 'Skills（全局技能库）',          isDir: true },
+      { src: '.claude/commands',              dest: 'commands',              label: 'Commands（全局命令）',          isDir: true },
+      { src: '.claude/agents',               dest: 'agents',               label: 'Agents（全局子代理）',          isDir: true },
+      { src: '.claude/hooks',                dest: 'hooks',                label: 'Hooks（全局钩子）',             isDir: true },
       { src: '.claude/framework-config.json', dest: 'framework-config.json', label: 'framework-config.json' },
+      { src: '.claude/settings.json',         dest: 'settings.json',         label: 'settings.json（Hooks + MCP 配置）', merge: true, rewritePrefix: '.claude/' },
     ],
-    preserve: [
-      { dest: 'settings.json', reason: '包含用户 MCP 配置和权限设置' },
-    ],
-    note: `Skills/Commands/Hooks 已安装到 ~/.claude，对所有项目自动生效`,
+    preserve: [],
+    note: `Skills/Commands/Hooks/Settings 已安装到 ~/.claude，对所有项目自动生效`,
   },
   cursor: {
     label: 'Cursor',
@@ -208,7 +207,7 @@ const GLOBAL_RULES = {
       { src: '.cursor/skills',     dest: 'skills',     label: 'Skills（全局技能库）',        isDir: true },
       { src: '.cursor/agents',     dest: 'agents',     label: 'Agents（全局子代理）',        isDir: true },
       { src: '.cursor/hooks',      dest: 'hooks',      label: 'Hooks（全局钩子脚本）',       isDir: true },
-      { src: '.cursor/hooks.json', dest: 'hooks.json', label: 'hooks.json（Hooks 触发配置）' },
+      { src: '.cursor/hooks.json', dest: 'hooks.json', label: 'hooks.json（Hooks 触发配置）', rewritePrefix: '.cursor/' },
       { src: '.cursor/mcp.json',   dest: 'mcp.json',   label: 'mcp.json（MCP 服务器配置）', merge: true },
     ],
     preserve: [],
@@ -258,6 +257,34 @@ function mergeJsonFile(srcPath, destPath, label) {
   }
 }
 
+/** 将 JSON 中的相对路径重写为绝对路径（递归遍历所有字符串值） */
+function rewritePaths(obj, relPrefix, absPrefix) {
+  if (typeof obj === 'string') {
+    // 匹配 "node .claude/hooks/xxx" 或 ".cursor/hooks/xxx" 等相对路径
+    return obj.split(' ').map(part =>
+      part.startsWith(relPrefix) ? part.replace(relPrefix, absPrefix) : part
+    ).join(' ');
+  }
+  if (Array.isArray(obj)) return obj.map(item => rewritePaths(item, relPrefix, absPrefix));
+  if (typeof obj === 'object' && obj !== null) {
+    const result = {};
+    for (const [k, v] of Object.entries(obj)) {
+      result[k] = rewritePaths(v, relPrefix, absPrefix);
+    }
+    return result;
+  }
+  return obj;
+}
+
+/** 重写已写入的 JSON 文件中的相对路径为绝对路径 */
+function rewriteJsonFilePaths(filePath, relPrefix, absPrefix) {
+  try {
+    let data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+    data = rewritePaths(data, relPrefix, absPrefix);
+    fs.writeFileSync(filePath, JSON.stringify(data, null, 2) + '\n');
+  } catch { /* 静默失败 */ }
+}
+
 /** 全局安装单个工具 */
 function globalInstallTool(toolKey) {
   const rule       = GLOBAL_RULES[toolKey];
@@ -280,6 +307,10 @@ function globalInstallTool(toolKey) {
     // merge 模式：合并 JSON 而非覆盖（保留用户已有配置）
     if (item.merge) {
       const result = mergeJsonFile(srcPath, destPath, item.label);
+      // merge 后路径重写
+      if (result >= 0 && item.rewritePrefix) {
+        rewriteJsonFilePaths(destPath, item.rewritePrefix, globalDest + '/');
+      }
       if (result >= 0) installed++; else failed++;
       continue;
     }
@@ -295,7 +326,16 @@ function globalInstallTool(toolKey) {
         installed += n;
       } else {
         fs.mkdirSync(path.dirname(destPath), { recursive: true });
-        fs.copyFileSync(srcPath, destPath);
+        // 非 merge JSON 文件的路径重写
+        if (item.rewritePrefix && destPath.endsWith('.json')) {
+          try {
+            let data = JSON.parse(fs.readFileSync(srcPath, 'utf8'));
+            data = rewritePaths(data, item.rewritePrefix, globalDest + '/');
+            fs.writeFileSync(destPath, JSON.stringify(data, null, 2) + '\n');
+          } catch { fs.copyFileSync(srcPath, destPath); }
+        } else {
+          fs.copyFileSync(srcPath, destPath);
+        }
         console.log(`  ${fmt('green', '✓')}  ${item.label}`);
         installed++;
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-engineering-init",
-  "version": "1.2.9",
+  "version": "1.3.1",
   "description": "AI 工程化配置初始化工具 — 一键为 Claude Code、OpenAI Codex 等 AI 工具初始化 Skills 和项目规范",
   "keywords": [
     "claude-code",