ccg-ros2-workflow 1.0.9 → 1.1.0

package/README.md

@@ -5,7 +5,7 @@
 
 ROS2 多模型协作开发工具 - 基于 Claude Code CLI
 
-> **v1.0.8** - 根据 Codex+Gemini 双模型分析优化工作流
+> **v1.1.0** - 支持直接安装 ace-tool，无需手动安装
 
 ## 特性
 
@@ -176,22 +176,35 @@ npm install -g @google/gemini-cli
 
 ace-tool 是 Augment Code 的代码上下文引擎，让 AI 自动理解项目结构。
 
-安装时选择「配置 ace-tool MCP」会自动添加到 `~/.claude/mcp_servers.json`：
+### 安装方式
+
+运行安装程序，选择「配置 ace-tool MCP」：
+
+```bash
+npx ccg-ros2-workflow
+# 选择 3. 配置 ace-tool MCP
+# 选择版本：ace-tool (Node.js) 或 ace-tool-rs (Rust，推荐)
+# 输入 Token（从 augmentcode.com 或中转服务获取）
+```
+
+### 配置示例
 
 ```json
 {
   "ace-tool": {
-    "command": "ace-tool",
-    "args": ["mcp"],
-    "env": {}
+    "command": "npx",
+    "args": ["ace-tool-rs", "mcp", "--token", "your-token"],
+    "env": { "RUST_LOG": "info" }
   }
 }
 ```
 
-使用前需要：
-1. 安装 ace-tool CLI（访问 https://augmentcode.com/）
-2. 运行 `ace-tool login` 登录
-3. 重启 Claude Code
+### Token 获取
+
+- **官方服务**: https://augmentcode.com/ 注册获取
+- **中转服务**: 使用第三方中转（需要配置 Base URL）
+
+配置完成后重启 Claude Code 即可使用。
 
 ## 语言配置
 
@@ -222,6 +235,17 @@ MIT
 
 ## 更新日志
 
+### v1.1.0
+- 支持直接安装 ace-tool，无需手动安装 CLI
+- 支持 ace-tool (Node.js) 和 ace-tool-rs (Rust) 两种版本
+- 支持配置 Token 和 Base URL（中转服务）
+- 使用 npx 自动下载运行，首次使用自动安装
+
+### v1.0.9
+- 提示词文件统一使用英文
+- 保留 "Code comments in Chinese" 指令
+- 语言规范：提示词(英文) / 交互(中文) / 注释(中文)
+
 ### v1.0.8
 - 基于 Codex+Gemini 双模型交叉验证分析优化
 - `gemini/architect.md`: 增加 QoS 策略设计 + Node Composition

package/bin/cli.js

@@ -158,62 +158,130 @@ async function configureMCP() {
   console.log('ace-tool 是 Augment Code 的代码上下文引擎');
   console.log('它能让 AI 自动理解你的项目结构和代码\n');
 
-  // 检查是否已安装 ace-tool
-  let aceToolInstalled = false;
-  try {
-    execSync('which ace-tool', { stdio: 'ignore' });
-    aceToolInstalled = true;
-    console.log('✅ 检测到 ace-tool 已安装\n');
-  } catch {
-    console.log('⚠️  未检测到 ace-tool\n');
+  // 选择操作
+  console.log('请选择操作：');
+  console.log('1. 安装/更新 ace-tool (Node.js 版本)');
+  console.log('2. 安装/更新 ace-tool-rs (Rust 版本，推荐)');
+  console.log('3. 卸载 ace-tool MCP 配置');
+  console.log('4. 返回');
+
+  const choice = await question('\n请选择 (1-4): ');
+
+  if (choice === '4') return;
+
+  if (choice === '3') {
+    await uninstallMCP();
+    return;
   }
 
-  if (!aceToolInstalled) {
-    console.log('安装 ace-tool 的方式：');
-    console.log('1. 访问 https://augmentcode.com/ 注册账号');
-    console.log('2. 按照官方指引安装 ace-tool CLI\n');
+  const pkg = choice === '2' ? 'ace-tool-rs' : 'ace-tool';
+  const pkgName = choice === '2' ? 'ace-tool-rs (Rust)' : 'ace-tool (Node.js)';
 
-    const proceed = await question('是否继续配置 MCP？(可以稍后安装 ace-tool) (Y/n): ');
-    if (proceed.toLowerCase() === 'n') {
-      return;
-    }
+  console.log(`\n📦 配置 ${pkgName}\n`);
+
+  // 获取 Token
+  console.log('获取 Token 的方式：');
+  console.log('- 官方服务: https://augmentcode.com/ 注册获取');
+  console.log('- 中转服务: 使用第三方中转（需要 Base URL）\n');
+
+  const baseUrl = await question('Base URL (使用官方服务请留空): ');
+  const token = await question('Token (必填): ');
+
+  if (!token.trim()) {
+    console.log('\n❌ Token 不能为空');
+    return;
   }
 
+  // 构建 MCP 配置
+  const args = [pkg, 'mcp'];
+  if (baseUrl.trim()) {
+    args.push('--base-url', baseUrl.trim());
+  }
+  args.push('--token', token.trim());
+
+  const mcpServerConfig = {
+    command: 'npx',
+    args: args,
+    env: pkg === 'ace-tool-rs' ? { RUST_LOG: 'info' } : {}
+  };
+
   // 读取或创建 MCP 配置
   let mcpConfig = {};
   if (fs.existsSync(MCP_CONFIG_PATH)) {
     try {
       mcpConfig = JSON.parse(fs.readFileSync(MCP_CONFIG_PATH, 'utf8'));
-      console.log('检测到已有 MCP 配置，将添加 ace-tool\n');
+      console.log('\n检测到已有 MCP 配置，将更新 ace-tool\n');
     } catch {
       mcpConfig = {};
     }
   }
 
+  // 备份现有配置
+  if (Object.keys(mcpConfig).length > 0) {
+    const backupDir = path.join(CLAUDE_DIR, 'backup');
+    fs.mkdirSync(backupDir, { recursive: true });
+    const backupPath = path.join(backupDir, `mcp_servers_${Date.now()}.json`);
+    fs.writeFileSync(backupPath, JSON.stringify(mcpConfig, null, 2));
+    console.log(`已备份配置到: ${backupPath}`);
+  }
+
   // 添加 ace-tool 配置
-  mcpConfig['ace-tool'] = {
-    command: 'ace-tool',
-    args: ['mcp'],
-    env: {}
-  };
+  mcpConfig['ace-tool'] = mcpServerConfig;
 
   // 写入配置
   fs.mkdirSync(CLAUDE_DIR, { recursive: true });
   fs.writeFileSync(MCP_CONFIG_PATH, JSON.stringify(mcpConfig, null, 2));
 
-  console.log('✅ MCP 配置已写入: ~/.claude/mcp_servers.json\n');
+  console.log('\n✅ MCP 配置已写入: ~/.claude/mcp_servers.json\n');
   console.log('配置内容：');
-  console.log(JSON.stringify(mcpConfig['ace-tool'], null, 2));
+  console.log(JSON.stringify(mcpServerConfig, null, 2));
+
+  console.log('\n📌 说明：');
+  console.log(`- 使用 npx ${pkg} 自动下载运行，无需手动安装`);
+  console.log('- Token 已配置，首次运行会自动下载包');
+  console.log('- 重启 Claude Code 使 MCP 生效');
 
-  console.log('\n📌 后续步骤：');
-  console.log('1. 确保已安装 ace-tool CLI');
-  console.log('2. 运行 ace-tool login 登录 Augment 账号');
-  console.log('3. 重启 Claude Code 使 MCP 生效');
   console.log('\n使用方式：');
   console.log('  在 workflow 中自动调用 mcp__ace-tool__search_context');
   console.log('  或手动调用 mcp__ace-tool__enhance_prompt');
 }
 
+async function uninstallMCP() {
+  console.log('\n🗑️  卸载 ace-tool MCP 配置\n');
+
+  if (!fs.existsSync(MCP_CONFIG_PATH)) {
+    console.log('未找到 MCP 配置文件');
+    return;
+  }
+
+  const confirm = await question('确定要移除 ace-tool MCP 配置吗？ (y/N): ');
+  if (confirm.toLowerCase() !== 'y') {
+    console.log('取消卸载');
+    return;
+  }
+
+  try {
+    let mcpConfig = JSON.parse(fs.readFileSync(MCP_CONFIG_PATH, 'utf8'));
+
+    if (!mcpConfig['ace-tool']) {
+      console.log('MCP 配置中没有 ace-tool');
+      return;
+    }
+
+    delete mcpConfig['ace-tool'];
+
+    if (Object.keys(mcpConfig).length === 0) {
+      fs.unlinkSync(MCP_CONFIG_PATH);
+      console.log('✅ 已删除: ~/.claude/mcp_servers.json');
+    } else {
+      fs.writeFileSync(MCP_CONFIG_PATH, JSON.stringify(mcpConfig, null, 2));
+      console.log('✅ 已从 MCP 配置中移除 ace-tool');
+    }
+  } catch (e) {
+    console.log('❌ 移除失败:', e.message);
+  }
+}
+
 async function configureApiKeys() {
   console.log('\n🔑 配置 API 密钥\n');
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ccg-ros2-workflow",
-  "version": "1.0.9",
+  "version": "1.1.0",
   "description": "ROS2 Multi-model Collaborative Development Workflow - Codex (Low-level) + Gemini (High-level) + Claude (Orchestration)",
   "main": "bin/cli.js",
   "bin": {