autosnippet 3.0.2 → 3.0.3

package/README.md

@@ -297,7 +297,8 @@ your-project/
 │   ├── rules/
 │   └── skills/
 └── .vscode/               # VS Code integration
-    └── settings.json      # MCP server config
+    ├── mcp.json           # MCP server config
+    └── extensions.json    # Recommended extensions
 ```
 
 ## Security

package/bin/mcp-server.js

@@ -4,7 +4,18 @@
  * AutoSnippet V2 MCP Server 入口
  * 供 Cursor / VSCode Copilot MCP 配置使用
  *
- * 配置示例 (.cursor/mcp.json):
+ * VSCode 配置示例 (.vscode/mcp.json):
+ * {
+ *   "servers": {
+ *     "autosnippet": {
+ *       "type": "stdio",
+ *       "command": "node",
+ *       "args": ["/path/to/v2/bin/mcp-server.js"]
+ *     }
+ *   }
+ * }
+ *
+ * Cursor 配置示例 (.cursor/mcp.json):
  * {
  *   "mcpServers": {
  *     "autosnippet": {

package/lib/cli/SetupService.js

@@ -617,28 +617,25 @@ export class SetupService {
     });
   }
 
-  /** @private VSCode settings.json → Copilot MCP */
+  /** @private .vscode/mcp.json → VSCode MCP (新标准格式) */
   _configureVSCodeMCP(mcpServerPath) {
     const vscodeDir = join(this.projectRoot, '.vscode');
-    const settingsPath = join(vscodeDir, 'settings.json');
+    const mcpConfigPath = join(vscodeDir, 'mcp.json');
     mkdirSync(vscodeDir, { recursive: true });
 
-    let settings = {};
-    if (existsSync(settingsPath)) {
+    let config = {};
+    if (existsSync(mcpConfigPath)) {
       try {
-        settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
+        config = JSON.parse(readFileSync(mcpConfigPath, 'utf8'));
       } catch {
         /* ignore */
       }
     }
 
-    if (!settings['github.copilot.mcp']) {
-      settings['github.copilot.mcp'] = {};
+    if (!config.servers) {
+      config.servers = {};
     }
-    if (!settings['github.copilot.mcp'].servers) {
-      settings['github.copilot.mcp'].servers = {};
-    }
-    settings['github.copilot.mcp'].servers.autosnippet = {
+    config.servers.autosnippet = {
       type: 'stdio',
       command: 'node',
       args: [mcpServerPath],
@@ -648,7 +645,7 @@ export class SetupService {
       },
     };
 
-    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    writeFileSync(mcpConfigPath, JSON.stringify(config, null, 2));
   }
 
   /** @private .cursor/mcp.json */

package/lib/cli/UpgradeService.js

@@ -2,7 +2,7 @@
  * UpgradeService — IDE 集成升级服务
  *
  * 当 AutoSnippet 发布新版本后，老用户执行 `asd upgrade` 即可更新：
- *   ① MCP 配置（.cursor/mcp.json + .vscode/settings.json）
+ *   ① MCP 配置（.cursor/mcp.json + .vscode/mcp.json）
  *   ② Cursor Skills（.cursor/skills/）
  *   ③ Cursor Rules（.cursor/rules/autosnippet-conventions.mdc + autosnippet-skills.mdc）
  *   ④ Copilot Instructions（.github/copilot-instructions.md）
@@ -101,26 +101,23 @@ export class UpgradeService {
   }
 
   _updateVSCodeMCP(mcpServerPath, nodePath) {
-    const settingsPath = join(this.projectRoot, '.vscode', 'settings.json');
-    if (!existsSync(settingsPath)) {
-      return;
-    }
+    const vscodeDir = join(this.projectRoot, '.vscode');
+    const mcpConfigPath = join(vscodeDir, 'mcp.json');
 
-    let settings = {};
-    try {
-      settings = JSON.parse(readFileSync(settingsPath, 'utf8'));
-    } catch {
-      /* */
+    let config = {};
+    if (existsSync(mcpConfigPath)) {
+      try {
+        config = JSON.parse(readFileSync(mcpConfigPath, 'utf8'));
+      } catch {
+        /* */
+      }
     }
 
-    if (!settings['github.copilot.mcp']) {
-      settings['github.copilot.mcp'] = {};
-    }
-    if (!settings['github.copilot.mcp'].servers) {
-      settings['github.copilot.mcp'].servers = {};
+    if (!config.servers) {
+      config.servers = {};
     }
 
-    settings['github.copilot.mcp'].servers.autosnippet = {
+    config.servers.autosnippet = {
       type: 'stdio',
       command: 'node',
       args: [mcpServerPath],
@@ -130,7 +127,8 @@ export class UpgradeService {
       },
     };
 
-    writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    mkdirSync(vscodeDir, { recursive: true });
+    writeFileSync(mcpConfigPath, JSON.stringify(config, null, 2));
   }
 
   /* ═══ Skills ════════════════════════════════════════ */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "autosnippet",
-  "version": "3.0.2",
+  "version": "3.0.3",
   "description": "AutoSnippet - 连接开发者、AI 与项目知识库的工具",
   "type": "module",
   "main": "lib/bootstrap.js",

package/scripts/install-vscode-copilot.js

@@ -126,7 +126,7 @@ function getMcpServerPath() {
 // ============ 配置 VSCode settings.json ============
 
 function configureVSCodeSettings() {
-  log('\n📝 配置 VSCode settings.json...', 'blue');
+  log('\n📝 配置 VSCode MCP 设置...', 'blue');
 
   if (isAutoSnippetRepo && !args.path) {
     log('ℹ️  检测到在 AutoSnippet 仓库内执行，仅配置全局设置', 'yellow');
@@ -134,8 +134,8 @@ function configureVSCodeSettings() {
   }
 
   const mcpServerPath = getMcpServerPath();
-  const mcpConfig = {
-    name: 'autosnippet',
+  const mcpServerConfig = {
+    type: 'stdio',
     command: 'node',
     args: [mcpServerPath],
     env: {
@@ -143,71 +143,32 @@ function configureVSCodeSettings() {
     },
   };
 
-  let globalConfigured = false;
-  let workspaceConfigured = false;
+  let configured = false;
 
-  // 全局配置
-  if (configGlobal) {
-    const globalSettingsPath = getVSCodeSettingsPath(true);
-    const globalSettings = readJsonFile(globalSettingsPath, {});
-
-    if (!globalSettings['github.copilot.mcp']) {
-      globalSettings['github.copilot.mcp'] = {};
-    }
-    if (!globalSettings['github.copilot.mcp'].servers) {
-      globalSettings['github.copilot.mcp'].servers = [];
-    }
-
-    const existingIndex = globalSettings['github.copilot.mcp'].servers.findIndex(
-      (s) => s.name === 'autosnippet'
-    );
-
-    if (existingIndex >= 0) {
-      globalSettings['github.copilot.mcp'].servers[existingIndex] = mcpConfig;
-    } else {
-      globalSettings['github.copilot.mcp'].servers.push(mcpConfig);
-    }
-
-    // 添加推荐的全局设置
-    globalSettings['github.copilot.enable'] = globalSettings['github.copilot.enable'] || {};
-    globalSettings['github.copilot.enable']['*'] = true;
-    globalSettings['github.copilot.chat.localeOverride'] = 'zh-CN';
-
-    if (writeJsonFile(globalSettingsPath, globalSettings)) {
-      log(`✅ 全局配置完成: ${globalSettingsPath}`, 'green');
-      globalConfigured = true;
-    }
-  }
-
-  // 工作区配置
+  // 工作区配置 → .vscode/mcp.json（新标准格式）
   if (configWorkspace) {
-    const workspaceSettingsPath = getVSCodeSettingsPath(false);
-    const workspaceSettings = readJsonFile(workspaceSettingsPath, {});
-
-    if (!workspaceSettings['github.copilot.mcp']) {
-      workspaceSettings['github.copilot.mcp'] = {};
-    }
-    if (!workspaceSettings['github.copilot.mcp'].servers) {
-      workspaceSettings['github.copilot.mcp'].servers = [];
+    const vscodeDir = path.join(projectPath, '.vscode');
+    const mcpConfigPath = path.join(vscodeDir, 'mcp.json');
+
+    let config = {};
+    if (fs.existsSync(mcpConfigPath)) {
+      try {
+        config = JSON.parse(fs.readFileSync(mcpConfigPath, 'utf8'));
+      } catch { /* ignore */ }
     }
 
-    const existingIndex = workspaceSettings['github.copilot.mcp'].servers.findIndex(
-      (s) => s.name === 'autosnippet'
-    );
-
-    if (existingIndex >= 0) {
-      workspaceSettings['github.copilot.mcp'].servers[existingIndex] = mcpConfig;
-    } else {
-      workspaceSettings['github.copilot.mcp'].servers.push(mcpConfig);
+    if (!config.servers) {
+      config.servers = {};
     }
+    config.servers.autosnippet = mcpServerConfig;
 
-    if (writeJsonFile(workspaceSettingsPath, workspaceSettings)) {
-      log(`✅ 工作区配置完成: ${workspaceSettingsPath}`, 'green');
-      workspaceConfigured = true;
+    if (writeJsonFile(mcpConfigPath, config)) {
+      log(`✅ 工作区 MCP 配置完成: ${mcpConfigPath}`, 'green');
+      configured = true;
     }
   }
 
-  return globalConfigured || workspaceConfigured;
+  return configured;
 }
 
 // ============ 创建推荐扩展配置 ============
@@ -270,41 +231,18 @@ function verifyConfiguration() {
 
   log('\n🔍 验证配置...', 'blue');
 
-  // 检查全局设置
-  if (configGlobal) {
-    const globalSettingsPath = getVSCodeSettingsPath(true);
-    if (fs.existsSync(globalSettingsPath)) {
-      const settings = readJsonFile(globalSettingsPath, {});
-      if (settings['github.copilot.mcp']?.servers) {
-        const hasAutosnippet = settings['github.copilot.mcp'].servers.some(
-          (s) => s.name === 'autosnippet'
-        );
-        if (hasAutosnippet) {
-          log(`✅ VSCode 全局 MCP 配置验证成功`, 'green');
-        } else {
-          log(`⚠️  未在全局设置中找到 autosnippet MCP 服务器`, 'yellow');
-        }
-      } else {
-        log(`⚠️  全局设置中未找到 MCP 配置`, 'yellow');
-      }
-    }
-  }
-
-  // 检查工作区设置
+  // 检查工作区 MCP 配置（.vscode/mcp.json）
   if (configWorkspace) {
-    const workspaceSettingsPath = getVSCodeSettingsPath(false);
-    if (fs.existsSync(workspaceSettingsPath)) {
-      const settings = readJsonFile(workspaceSettingsPath, {});
-      if (settings['github.copilot.mcp']?.servers) {
-        const hasAutosnippet = settings['github.copilot.mcp'].servers.some(
-          (s) => s.name === 'autosnippet'
-        );
-        if (hasAutosnippet) {
-          log(`✅ VSCode 工作区 MCP 配置验证成功`, 'green');
-        } else {
-          log(`⚠️  未在工作区设置中找到 autosnippet MCP 服务器`, 'yellow');
-        }
+    const mcpConfigPath = path.join(projectPath, '.vscode/mcp.json');
+    if (fs.existsSync(mcpConfigPath)) {
+      const config = readJsonFile(mcpConfigPath, {});
+      if (config.servers?.autosnippet) {
+        log(`✅ VSCode 工作区 MCP 配置验证成功 (.vscode/mcp.json)`, 'green');
+      } else {
+        log(`⚠️  .vscode/mcp.json 中未找到 autosnippet 服务器`, 'yellow');
       }
+    } else {
+      log(`⚠️  未找到 .vscode/mcp.json`, 'yellow');
     }
   }
 
@@ -353,18 +291,15 @@ function printQuickStart() {
   log(`   ${path.join(projectPath, '.github/copilot-instructions.md')}`, 'yellow');
 
   log('\n📝 配置位置：');
-  if (configGlobal) {
-    log(`   全局: ${getVSCodeSettingsPath(true)}`, 'yellow');
-  }
   if (configWorkspace) {
-    log(`   工作区: ${getVSCodeSettingsPath(false)}`, 'yellow');
+    log(`   MCP: ${path.join(projectPath, '.vscode/mcp.json')}`, 'yellow');
   }
 
   log('\n💡 提示：');
   log('   - 首次配置需要重启 VSCode');
   log('   - MCP 服务器需要 Node.js 18.0+');
   log('   - Dashboard 运行在 http://localhost:3000');
-  log('   - 可在 VSCode 设置中搜索 "copilot.mcp" 查看配置\n');
+  log('   - MCP 配置位于 .vscode/mcp.json（可加入版本控制共享给团队）\n');
 
   log(`${'='.repeat(60)}\n`, 'blue');
 }

package/scripts/setup-mcp-config.js

@@ -64,41 +64,28 @@ if (isVSCode) {
 }
 
 function configureVSCode() {
-  // 找到 settings.json 路径
-  if (os.platform() === 'darwin') {
-    settingsPath = path.join(os.homedir(), 'Library/Application Support/Code/User/settings.json');
-  } else if (os.platform() === 'win32') {
-    settingsPath = path.join(os.getenv('APPDATA'), 'Code/User/settings.json');
-  } else {
-    settingsPath = path.join(os.homedir(), '.config/Code/User/settings.json');
-  }
+  // 使用 .vscode/mcp.json（VSCode 新标准格式）
+  const vscodeDir = path.join(projectPath, '.vscode');
+  const mcpConfigPath = path.join(vscodeDir, 'mcp.json');
 
-  // 读取现有设置
-  let settings = {};
-  if (fs.existsSync(settingsPath)) {
+  // 读取现有配置
+  let config = {};
+  if (fs.existsSync(mcpConfigPath)) {
     try {
-      const content = fs.readFileSync(settingsPath, 'utf8');
-      settings = JSON.parse(content);
+      const content = fs.readFileSync(mcpConfigPath, 'utf8');
+      config = JSON.parse(content);
     } catch (_e) {
       // 忽略解析错误
     }
   }
 
-  // 添加 MCP 配置
-  if (!settings['github.copilot.mcp']) {
-    settings['github.copilot.mcp'] = {};
-  }
-  if (!settings['github.copilot.mcp'].servers) {
-    settings['github.copilot.mcp'].servers = [];
+  // 添加 MCP 服务器配置
+  if (!config.servers) {
+    config.servers = {};
   }
 
-  // 检查 autosnippet 是否已存在
-  const existingIndex = settings['github.copilot.mcp'].servers.findIndex(
-    (s) => s.name === 'autosnippet'
-  );
-
-  const mcpConfig = {
-    name: 'autosnippet',
+  config.servers.autosnippet = {
+    type: 'stdio',
     command: 'node',
     args: [mcpServerPath],
     env: {
@@ -106,24 +93,19 @@ function configureVSCode() {
     },
   };
 
-  if (existingIndex >= 0) {
-    settings['github.copilot.mcp'].servers[existingIndex] = mcpConfig;
-  } else {
-    settings['github.copilot.mcp'].servers.push(mcpConfig);
-  }
-
-  // 写入设置
+  // 写入 .vscode/mcp.json
   try {
-    fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
-    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+    fs.mkdirSync(vscodeDir, { recursive: true });
+    fs.writeFileSync(mcpConfigPath, JSON.stringify(config, null, 2), 'utf8');
     if (!isQuiet) {
     }
   } catch (e) {
     if (!isQuiet) {
-      console.error(`✗ 保存设置失败: ${e.message}`);
+      console.error(`✗ 保存配置失败: ${e.message}`);
     }
     process.exit(1);
   }
+
 }
 
 function configureCursor() {