jvibe 1.1.8 → 1.1.10

package/lib/plugins/registry.json

@@ -5,49 +5,435 @@
       "id": "serena",
       "name": "Serena",
       "category": "memory",
+      "description": "符号分析 + 项目记忆",
       "integration": { "type": "mcp" },
-      "default_tier": "core"
-    },
-    {
-      "id": "brave-search",
-      "name": "Brave Search",
-      "category": "search",
-      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "serena",
+        "mcpAliases": ["serena"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "serena-slim"]
+        }
+      },
       "default_tier": "core"
     },
     {
       "id": "filesystem-mcp",
       "name": "Filesystem MCP",
       "category": "filesystem",
+      "description": "基础文件操作",
       "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "filesystem",
+        "mcpAliases": ["filesystem", "filesystem-mcp"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-filesystem", "{{project_root}}"]
+        }
+      },
       "default_tier": "core"
     },
     {
       "id": "github-mcp",
       "name": "GitHub MCP",
       "category": "git",
+      "description": "Git/代码托管",
       "integration": { "type": "mcp" },
-      "default_tier": "core"
+      "claude": {
+        "mcpServerName": "github",
+        "mcpAliases": ["github", "github-mcp"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-github"],
+          "env": {
+            "GITHUB_PERSONAL_ACCESS_TOKEN": "{{GITHUB_PERSONAL_ACCESS_TOKEN}}"
+          }
+        }
+      },
+      "requires": { "env": ["GITHUB_PERSONAL_ACCESS_TOKEN"] },
+      "default_tier": "project"
     },
     {
       "id": "context7",
       "name": "Context7",
       "category": "docs",
+      "description": "查询库/框架文档",
       "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "context7",
+        "mcpAliases": ["context7", "context7-mcp"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@upstash/context7-mcp"]
+        }
+      },
       "default_tier": "core"
     },
     {
       "id": "agent-browser",
       "name": "Agent Browser",
       "category": "browser",
-      "integration": { "type": "daemon+skill" },
+      "description": "浏览器自动化（Skill 形态）",
+      "integration": { "type": "skill" },
+      "claude": {
+        "skillName": "agent-browser",
+        "skillSource": "https://raw.githubusercontent.com/vercel-labs/agent-browser/v0.6.0/skills/agent-browser/SKILL.md",
+        "skillDir": ".claude/skills/agent-browser",
+        "globalInstall": "npm install -g agent-browser && agent-browser install",
+        "allowedTools": ["Bash(agent-browser:*)"]
+      },
       "default_tier": "core"
     },
+
+    {
+      "id": "postgres-mcp",
+      "name": "PostgreSQL",
+      "category": "database",
+      "description": "PostgreSQL 数据库操作",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "postgres",
+        "mcpAliases": ["postgres", "postgresql"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-postgres"],
+          "env": {
+            "POSTGRES_CONNECTION_STRING": "{{POSTGRES_CONNECTION_STRING}}"
+          }
+        }
+      },
+      "requires": { "env": ["POSTGRES_CONNECTION_STRING"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "mysql-mcp",
+      "name": "MySQL",
+      "category": "database",
+      "description": "MySQL 数据库操作",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "mysql",
+        "mcpAliases": ["mysql"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mysql-mcp"],
+          "env": {
+            "MYSQL_HOST": "{{MYSQL_HOST}}",
+            "MYSQL_PORT": "{{MYSQL_PORT}}",
+            "MYSQL_USER": "{{MYSQL_USER}}",
+            "MYSQL_PASSWORD": "{{MYSQL_PASSWORD}}",
+            "MYSQL_DATABASE": "{{MYSQL_DATABASE}}"
+          }
+        }
+      },
+      "requires": { "env": ["MYSQL_HOST", "MYSQL_USER", "MYSQL_PASSWORD", "MYSQL_DATABASE"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "mongodb-mcp",
+      "name": "MongoDB",
+      "category": "database",
+      "description": "MongoDB 数据库操作",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "mongodb",
+        "mcpAliases": ["mongodb", "mongo"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mcp-mongo-server"],
+          "env": {
+            "MONGODB_URI": "{{MONGODB_URI}}"
+          }
+        }
+      },
+      "requires": { "env": ["MONGODB_URI"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "supabase-mcp",
+      "name": "Supabase",
+      "category": "database",
+      "description": "Supabase 数据库 + Auth + Storage",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "supabase",
+        "mcpAliases": ["supabase"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@supabase/mcp-server-supabase", "--access-token", "{{SUPABASE_ACCESS_TOKEN}}"]
+        }
+      },
+      "requires": { "env": ["SUPABASE_ACCESS_TOKEN"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "redis-mcp",
+      "name": "Redis",
+      "category": "database",
+      "description": "Redis 缓存操作",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "redis",
+        "mcpAliases": ["redis"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-redis"],
+          "env": {
+            "REDIS_URL": "{{REDIS_URL}}"
+          }
+        }
+      },
+      "requires": { "env": ["REDIS_URL"] },
+      "default_tier": "project"
+    },
+
+    {
+      "id": "docker-mcp",
+      "name": "Docker",
+      "category": "container",
+      "description": "Docker 容器管理",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "docker",
+        "mcpAliases": ["docker"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mcp-server-docker"]
+        }
+      },
+      "default_tier": "project"
+    },
+    {
+      "id": "kubernetes-mcp",
+      "name": "Kubernetes",
+      "category": "container",
+      "description": "Kubernetes 集群管理",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "kubernetes",
+        "mcpAliases": ["kubernetes", "k8s"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mcp-server-kubernetes"]
+        }
+      },
+      "default_tier": "project"
+    },
+
+    {
+      "id": "aws-mcp",
+      "name": "AWS",
+      "category": "cloud",
+      "description": "AWS 云服务管理",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "aws",
+        "mcpAliases": ["aws"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mcp-server-aws"],
+          "env": {
+            "AWS_ACCESS_KEY_ID": "{{AWS_ACCESS_KEY_ID}}",
+            "AWS_SECRET_ACCESS_KEY": "{{AWS_SECRET_ACCESS_KEY}}",
+            "AWS_REGION": "{{AWS_REGION}}"
+          }
+        }
+      },
+      "requires": { "env": ["AWS_ACCESS_KEY_ID", "AWS_SECRET_ACCESS_KEY", "AWS_REGION"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "gcp-mcp",
+      "name": "Google Cloud",
+      "category": "cloud",
+      "description": "GCP 云服务管理",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "gcp",
+        "mcpAliases": ["gcp", "google-cloud"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "gcp-mcp"],
+          "env": {
+            "GOOGLE_APPLICATION_CREDENTIALS": "{{GOOGLE_APPLICATION_CREDENTIALS}}"
+          }
+        }
+      },
+      "requires": { "env": ["GOOGLE_APPLICATION_CREDENTIALS"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "azure-mcp",
+      "name": "Azure",
+      "category": "cloud",
+      "description": "Azure 云服务管理",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "azure",
+        "mcpAliases": ["azure"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mcp-server-azure"],
+          "env": {
+            "AZURE_SUBSCRIPTION_ID": "{{AZURE_SUBSCRIPTION_ID}}",
+            "AZURE_CLIENT_ID": "{{AZURE_CLIENT_ID}}",
+            "AZURE_CLIENT_SECRET": "{{AZURE_CLIENT_SECRET}}",
+            "AZURE_TENANT_ID": "{{AZURE_TENANT_ID}}"
+          }
+        }
+      },
+      "requires": { "env": ["AZURE_SUBSCRIPTION_ID", "AZURE_CLIENT_ID", "AZURE_CLIENT_SECRET", "AZURE_TENANT_ID"] },
+      "default_tier": "project"
+    },
+
     {
       "id": "playwright-mcp",
-      "name": "Playwright MCP",
-      "category": "browser",
+      "name": "Playwright",
+      "category": "testing",
+      "description": "浏览器自动化测试",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "playwright",
+        "mcpAliases": ["playwright"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@playwright/mcp"]
+        }
+      },
+      "default_tier": "project"
+    },
+    {
+      "id": "puppeteer-mcp",
+      "name": "Puppeteer",
+      "category": "testing",
+      "description": "Chrome 无头浏览器测试",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "puppeteer",
+        "mcpAliases": ["puppeteer"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@hisma/server-puppeteer"]
+        }
+      },
+      "default_tier": "project"
+    },
+
+    {
+      "id": "chrome-devtools-mcp",
+      "name": "Chrome DevTools",
+      "category": "frontend",
+      "description": "Chrome 开发者工具调试",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "chrome-devtools",
+        "mcpAliases": ["chrome-devtools", "devtools"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "chrome-devtools-mcp"]
+        }
+      },
+      "default_tier": "project"
+    },
+
+    {
+      "id": "figma-mcp",
+      "name": "Figma",
+      "category": "design",
+      "description": "Figma 设计文件操作",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "figma",
+        "mcpAliases": ["figma"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mcp-figma"]
+        }
+      },
+      "default_tier": "project"
+    },
+
+    {
+      "id": "slack-mcp",
+      "name": "Slack",
+      "category": "communication",
+      "description": "Slack 消息与频道管理",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "slack",
+        "mcpAliases": ["slack"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "slack-mcp-server"],
+          "env": {
+            "SLACK_MCP_XOXB_TOKEN": "{{SLACK_MCP_XOXB_TOKEN}}"
+          }
+        }
+      },
+      "requires": { "env": ["SLACK_MCP_XOXB_TOKEN"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "discord-mcp",
+      "name": "Discord",
+      "category": "communication",
+      "description": "Discord 消息与服务器管理",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "discord",
+        "mcpAliases": ["discord"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "mcp-server-discord"],
+          "env": {
+            "DISCORD_BOT_TOKEN": "{{DISCORD_BOT_TOKEN}}"
+          }
+        }
+      },
+      "requires": { "env": ["DISCORD_BOT_TOKEN"] },
+      "default_tier": "project"
+    },
+
+    {
+      "id": "notion-mcp",
+      "name": "Notion",
+      "category": "docs",
+      "description": "Notion 页面与数据库操作",
+      "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "notion",
+        "mcpAliases": ["notion"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@notionhq/notion-mcp-server"],
+          "env": {
+            "NOTION_TOKEN": "{{NOTION_TOKEN}}"
+          }
+        }
+      },
+      "requires": { "env": ["NOTION_TOKEN"] },
+      "default_tier": "project"
+    },
+    {
+      "id": "confluence-mcp",
+      "name": "Confluence",
+      "category": "docs",
+      "description": "Confluence 文档协作",
       "integration": { "type": "mcp" },
+      "claude": {
+        "mcpServerName": "confluence",
+        "mcpAliases": ["confluence"],
+        "mcpServer": {
+          "command": "npx",
+          "args": ["-y", "@answerai/confluence-mcp"],
+          "env": {
+            "CONFLUENCE_BASE_URL": "{{CONFLUENCE_BASE_URL}}",
+            "CONFLUENCE_USER_EMAIL": "{{CONFLUENCE_USER_EMAIL}}",
+            "CONFLUENCE_API_TOKEN": "{{CONFLUENCE_API_TOKEN}}"
+          }
+        }
+      },
+      "requires": { "env": ["CONFLUENCE_BASE_URL", "CONFLUENCE_USER_EMAIL", "CONFLUENCE_API_TOKEN"] },
       "default_tier": "project"
     }
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jvibe",
-  "version": "1.1.8",
+  "version": "1.1.10",
   "description": "\u6587\u6863\u9a71\u52a8\u7684 AI \u8f85\u52a9\u5f00\u53d1\u7cfb\u7edf - Doc-driven AI-assisted development system for Claude Code and OpenCode",
   "main": "bin/jvibe.js",
   "bin": {

package/scripts/init.js

@@ -6,6 +6,10 @@
 const fs = require('fs-extra');
 const path = require('path');
 const chalk = require('chalk');
+const {
+  loadPluginRegistry,
+  configureClaudeCoreTools
+} = require('../lib/plugins/core-tools');
 
 const TEMPLATE_DIR = path.join(__dirname, '../template');
 
@@ -30,6 +34,8 @@ async function init(options = {}) {
   console.log(chalk.blue('\n🚀 正在初始化 JVibe...\n'));
 
   try {
+    const pluginRegistry = await loadPluginRegistry();
+
     // 1. 检查是否已存在 JVibe 配置
     const claudeDir = path.join(cwd, '.claude');
     const opencodeDir = path.join(cwd, '.opencode');
@@ -143,6 +149,37 @@ async function init(options = {}) {
       await fs.writeJson(opencodeMetaPath, opencodeMeta, { spaces: 2 });
     }
 
+    // 6.5 配置 Core Tools（MCP Servers + Skills，仅写入缺失项）
+    const coreToolsResult = await configureClaudeCoreTools(cwd, pluginRegistry);
+    if (coreToolsResult && coreToolsResult.error) {
+      console.log(chalk.yellow(`⚠️  Core Tools 自动配置已跳过：${coreToolsResult.error}`));
+    } else if (coreToolsResult) {
+      const mcpAdded = typeof coreToolsResult.mcpAdded === 'number'
+        ? coreToolsResult.mcpAdded
+        : coreToolsResult.added - (coreToolsResult.skillsAdded ? coreToolsResult.skillsAdded.length : 0);
+      if (mcpAdded > 0) {
+        console.log(chalk.gray(`   已写入 MCP Server 配置: ${mcpAdded} 项 (.claude/settings.local.json)`));
+      }
+      if (Array.isArray(coreToolsResult.skillsAdded) && coreToolsResult.skillsAdded.length > 0) {
+        console.log(chalk.gray(`   已安装 Skill: ${coreToolsResult.skillsAdded.length} 项`));
+      }
+      if (Array.isArray(coreToolsResult.skillsNeedingCli) && coreToolsResult.skillsNeedingCli.length > 0) {
+        coreToolsResult.skillsNeedingCli.forEach(({ pluginId, globalInstall }) => {
+          if (!pluginId || !globalInstall) return;
+          console.log(chalk.yellow(`⚠️  ${pluginId} 需要全局安装 CLI: ${globalInstall}`));
+        });
+      }
+    }
+    if (coreToolsResult && Array.isArray(coreToolsResult.missingTemplates) && coreToolsResult.missingTemplates.length > 0) {
+      console.log(chalk.yellow(`⚠️  以下 Core Tools 未提供自动配置模板，请手动配置: ${coreToolsResult.missingTemplates.join(', ')}`));
+    }
+    if (coreToolsResult && Array.isArray(coreToolsResult.missingEnv) && coreToolsResult.missingEnv.length > 0) {
+      coreToolsResult.missingEnv.forEach(({ pluginId, keys }) => {
+        if (!pluginId || !Array.isArray(keys) || keys.length === 0) return;
+        console.log(chalk.yellow(`⚠️  ${pluginId} 可能缺少环境变量: ${keys.join(', ')}`));
+      });
+    }
+
     // 7. 输出成功信息
     console.log(chalk.green('\n✅ JVibe 初始化完成！\n'));
 

package/scripts/plugins.js

@@ -0,0 +1,159 @@
+/**
+ * JVibe Plugins Script
+ * 配置/检查插件（先从 Core Tools 开始）
+ */
+
+const fs = require('fs-extra');
+const path = require('path');
+const chalk = require('chalk');
+const { spawn } = require('child_process');
+const readline = require('readline');
+const {
+  loadPluginRegistry,
+  configureClaudeCoreTools
+} = require('../lib/plugins/core-tools');
+
+function askQuestion(question) {
+  // 非交互环境（CI / stdin 重定向 / 管道）下，避免 readline 卡住。
+  // 默认选择 "n"（跳过安装），以免误触发全局安装。
+  if (!process.stdin.isTTY || !process.stdout.isTTY) {
+    return Promise.resolve('n');
+  }
+
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise(resolve => {
+    let resolved = false;
+    const finish = (answer) => {
+      if (resolved) return;
+      resolved = true;
+      try { rl.close(); } catch {}
+      resolve((answer || '').trim().toLowerCase());
+    };
+
+    rl.on('close', () => finish('n'));
+    rl.on('SIGINT', () => finish('n'));
+
+    try {
+      rl.question(question, finish);
+    } catch {
+      finish('n');
+    }
+  });
+}
+
+async function installSkillCli(globalInstall) {
+  return new Promise((resolve) => {
+    console.log(chalk.gray(`   正在安装: ${globalInstall}`));
+
+    // 解析命令
+    const parts = globalInstall.split('&&').map(s => s.trim());
+
+    const runCommand = (cmd, callback) => {
+      const [command, ...args] = cmd.split(/\s+/);
+      const child = spawn(command, args, {
+        stdio: 'inherit',
+        shell: true
+      });
+      child.on('close', code => callback(code === 0));
+      child.on('error', () => callback(false));
+    };
+
+    const runSequentially = (commands, index = 0) => {
+      if (index >= commands.length) {
+        resolve(true);
+        return;
+      }
+      runCommand(commands[index], success => {
+        if (!success) {
+          resolve(false);
+          return;
+        }
+        runSequentially(commands, index + 1);
+      });
+    };
+
+    runSequentially(parts);
+  });
+}
+
+async function configureCore() {
+  const cwd = process.cwd();
+
+  const registry = await loadPluginRegistry();
+  const claudeDir = path.join(cwd, '.claude');
+
+  if (!await fs.pathExists(claudeDir)) {
+    console.log(chalk.yellow('⚠️  未检测到 .claude/，已跳过 Core Tools 配置'));
+    return;
+  }
+
+  const result = await configureClaudeCoreTools(cwd, registry);
+  if (result && result.error) {
+    console.log(chalk.yellow(`⚠️  Core Tools 自动配置已跳过：${result.error}`));
+    return;
+  }
+
+  // MCP Server 配置结果
+  const mcpAdded = typeof result.mcpAdded === 'number'
+    ? result.mcpAdded
+    : result.added - (result.skillsAdded ? result.skillsAdded.length : 0);
+  if (mcpAdded > 0) {
+    console.log(chalk.green(`✅ 已写入 MCP Server 配置: ${mcpAdded} 项 (.claude/settings.local.json)`));
+  }
+
+  // Skill 配置结果
+  if (result && Array.isArray(result.skillsAdded) && result.skillsAdded.length > 0) {
+    console.log(chalk.green(`✅ 已安装 Skill: ${result.skillsAdded.length} 项`));
+
+    for (const { pluginId, skillDir } of result.skillsAdded) {
+      console.log(chalk.gray(`   - ${pluginId} → ${skillDir}`));
+    }
+  }
+
+  // Skill CLI 安装提示（即使 Skill 已存在也提示）
+  if (result && Array.isArray(result.skillsNeedingCli) && result.skillsNeedingCli.length > 0) {
+    for (const { pluginId, cliCommand, globalInstall } of result.skillsNeedingCli) {
+      if (!globalInstall) continue;
+      const label = cliCommand ? `${pluginId} (${cliCommand})` : pluginId;
+      const answer = await askQuestion(chalk.yellow(`   ⚠️  ${label} 需要全局安装 CLI，是否现在安装？(Y/n) `));
+      if (answer === '' || answer === 'y' || answer === 'yes') {
+        const success = await installSkillCli(globalInstall);
+        if (success) {
+          console.log(chalk.green(`   ✅ ${pluginId} CLI 安装成功`));
+        } else {
+          console.log(chalk.red(`   ❌ ${pluginId} CLI 安装失败，请手动执行: ${globalInstall}`));
+        }
+      } else {
+        console.log(chalk.gray(`   跳过安装，稍后可手动执行: ${globalInstall}`));
+      }
+    }
+  }
+
+  if (
+    mcpAdded === 0 &&
+    (!result.skillsAdded || result.skillsAdded.length === 0) &&
+    (!result.skillsNeedingCli || result.skillsNeedingCli.length === 0)
+  ) {
+    console.log(chalk.green('✅ Core Tools 配置已存在，无需重复写入'));
+  }
+
+  if (result && Array.isArray(result.missingTemplates) && result.missingTemplates.length > 0) {
+    console.log(chalk.yellow(`⚠️  以下 Core Tools 未提供自动配置模板，请手动配置: ${result.missingTemplates.join(', ')}`));
+  }
+
+  if (result && Array.isArray(result.missingEnv) && result.missingEnv.length > 0) {
+    console.log(chalk.yellow('⚠️  以下 Core Tools 可能缺少环境变量，启动 MCP Server 时可能失败：'));
+    result.missingEnv.forEach(({ pluginId, keys }) => {
+      if (!pluginId || !Array.isArray(keys) || keys.length === 0) return;
+      console.log(chalk.yellow(`   - ${pluginId}: ${keys.join(', ')}`));
+    });
+    console.log(chalk.gray('   提示：在当前 shell 中 export 对应变量后重试'));
+  }
+}
+
+module.exports = {
+  configureCore
+};