autosnippet 3.0.0 → 3.0.2

package/scripts/setup-mcp-config.js

@@ -3,16 +3,16 @@
 /**
  * VSCode/Cursor MCP 配置辅助脚本
  * 帮助用户快速配置 AutoSnippet MCP 集成
- * 
+ *
  * 使用:
  *   node scripts/setup-mcp-config.js [--editor vscode|cursor] [--path /path/to/project]
  */
 
-import { execSync } from 'node:child_process';
 import fs from 'node:fs';
-import path from 'node:path';
-import os from 'node:os';
 import { createRequire } from 'node:module';
+import os from 'node:os';
+import path from 'node:path';
+
 const require = createRequire(import.meta.url);
 
 const args = require('minimist')(process.argv.slice(2));
@@ -26,15 +26,13 @@ const isCursor = editor === 'cursor';
 const isQuiet = process.env.ASD_QUIET === 'true';
 
 // 检测是否在 AutoSnippet 仓库内执行
-const isAutoSnippetRepo = fs.existsSync(path.join(projectPath, 'bin/mcp-server.js')) &&
+const isAutoSnippetRepo =
+  fs.existsSync(path.join(projectPath, 'bin/mcp-server.js')) &&
   fs.existsSync(path.join(projectPath, 'bin/asd')) &&
   fs.existsSync(path.join(projectPath, 'package.json'));
 
 if (isAutoSnippetRepo && !args.path) {
   if (!isQuiet) {
-  console.log('⚠️  检测到在 AutoSnippet 仓库内执行');
-  console.log('   AutoSnippet 仓库不应配置 MCP 服务器');
-  console.log('   如需为其他项目配置，请使用: --path /path/to/project');
   }
   process.exit(0);
 }
@@ -44,7 +42,9 @@ if (isAutoSnippetRepo && !args.path) {
 // 检查 MCP Server
 const mcpServerPath = path.join(projectPath, 'bin/mcp-server.js');
 if (!fs.existsSync(mcpServerPath)) {
-  if (!isQuiet) console.error(`✗ MCP Server 未找到: ${mcpServerPath}`);
+  if (!isQuiet) {
+    console.error(`✗ MCP Server 未找到: ${mcpServerPath}`);
+  }
   process.exit(1);
 }
 
@@ -57,65 +57,72 @@ if (isVSCode) {
 } else if (isCursor) {
   configureCursor();
 } else {
-  if (!isQuiet) console.error('✗ 未知编辑器，使用 --editor vscode 或 --editor cursor');
+  if (!isQuiet) {
+    console.error('✗ 未知编辑器，使用 --editor vscode 或 --editor cursor');
+  }
   process.exit(1);
 }
 
 function configureVSCode() {
   // 找到 settings.json 路径
   if (os.platform() === 'darwin') {
-  settingsPath = path.join(os.homedir(), 'Library/Application Support/Code/User/settings.json');
+    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');
+    settingsPath = path.join(os.getenv('APPDATA'), 'Code/User/settings.json');
   } else {
-  settingsPath = path.join(os.homedir(), '.config/Code/User/settings.json');
+    settingsPath = path.join(os.homedir(), '.config/Code/User/settings.json');
   }
 
   // 读取现有设置
   let settings = {};
   if (fs.existsSync(settingsPath)) {
-  try {
-    const content = fs.readFileSync(settingsPath, 'utf8');
-    settings = JSON.parse(content);
-  } catch (e) {
-    // 忽略解析错误
-  }
+    try {
+      const content = fs.readFileSync(settingsPath, 'utf8');
+      settings = JSON.parse(content);
+    } catch (_e) {
+      // 忽略解析错误
+    }
   }
 
   // 添加 MCP 配置
   if (!settings['github.copilot.mcp']) {
-  settings['github.copilot.mcp'] = {};
+    settings['github.copilot.mcp'] = {};
   }
   if (!settings['github.copilot.mcp'].servers) {
-  settings['github.copilot.mcp'].servers = [];
+    settings['github.copilot.mcp'].servers = [];
   }
 
   // 检查 autosnippet 是否已存在
-  const existingIndex = settings['github.copilot.mcp'].servers.findIndex(s => s.name === 'autosnippet');
-  
+  const existingIndex = settings['github.copilot.mcp'].servers.findIndex(
+    (s) => s.name === 'autosnippet'
+  );
+
   const mcpConfig = {
-  name: 'autosnippet',
-  command: 'node',
-  args: [mcpServerPath],
-  env: {
-    ASD_UI_URL: 'http://localhost:3000'
-  }
+    name: 'autosnippet',
+    command: 'node',
+    args: [mcpServerPath],
+    env: {
+      ASD_UI_URL: 'http://localhost:3000',
+    },
   };
 
   if (existingIndex >= 0) {
-  settings['github.copilot.mcp'].servers[existingIndex] = mcpConfig;
+    settings['github.copilot.mcp'].servers[existingIndex] = mcpConfig;
   } else {
-  settings['github.copilot.mcp'].servers.push(mcpConfig);
+    settings['github.copilot.mcp'].servers.push(mcpConfig);
   }
 
   // 写入设置
   try {
-  fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
-  fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
-  if (!isQuiet) console.log('✅ VSCode MCP 配置完成');
+    fs.mkdirSync(path.dirname(settingsPath), { recursive: true });
+    fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf8');
+    if (!isQuiet) {
+    }
   } catch (e) {
-  if (!isQuiet) console.error(`✗ 保存设置失败: ${e.message}`);
-  process.exit(1);
+    if (!isQuiet) {
+      console.error(`✗ 保存设置失败: ${e.message}`);
+    }
+    process.exit(1);
   }
 }
 
@@ -125,25 +132,26 @@ function configureCursor() {
 
   // 创建配置
   const config = {
-  mcpServers: {
-    autosnippet: {
-    command: 'node',
-    args: [
-      path.relative(projectPath, mcpServerPath) || './bin/mcp-server.js'
-    ],
-    env: {
-      ASD_UI_URL: 'http://localhost:3000'
-    }
-    }
-  }
+    mcpServers: {
+      autosnippet: {
+        command: 'node',
+        args: [path.relative(projectPath, mcpServerPath) || './bin/mcp-server.js'],
+        env: {
+          ASD_UI_URL: 'http://localhost:3000',
+        },
+      },
+    },
   };
 
   try {
-  fs.mkdirSync(cursorConfigDir, { recursive: true });
-  fs.writeFileSync(cursorConfigPath, JSON.stringify(config, null, 2), 'utf8');
-  if (!isQuiet) console.log('✅ Cursor MCP 配置完成');
+    fs.mkdirSync(cursorConfigDir, { recursive: true });
+    fs.writeFileSync(cursorConfigPath, JSON.stringify(config, null, 2), 'utf8');
+    if (!isQuiet) {
+    }
   } catch (e) {
-  if (!isQuiet) console.error(`✗ 保存配置失败: ${e.message}`);
-  process.exit(1);
+    if (!isQuiet) {
+      console.error(`✗ 保存配置失败: ${e.message}`);
+    }
+    process.exit(1);
   }
 }

package/scripts/verify-context-api.js

@@ -21,33 +21,33 @@ const opts = {
   path: url.pathname,
   method: 'POST',
   headers: {
-  'Content-Type': 'application/json',
-  'Content-Length': Buffer.byteLength(body)
-  }
+    'Content-Type': 'application/json',
+    'Content-Length': Buffer.byteLength(body),
+  },
 };
 
 const req = client.request(opts, (res) => {
   let data = '';
-  res.on('data', (ch) => { data += ch; });
+  res.on('data', (ch) => {
+    data += ch;
+  });
   res.on('end', () => {
-  if (res.statusCode !== 200) {
-    console.error(`❌ API 返回 ${res.statusCode}`);
-    process.exit(1);
-  }
-  try {
-    const json = JSON.parse(data);
-    if (!json.items || !Array.isArray(json.items)) {
-    console.error('❌ 返回结构异常，缺少 items 数组');
-    process.exit(1);
+    if (res.statusCode !== 200) {
+      console.error(`❌ API 返回 ${res.statusCode}`);
+      process.exit(1);
     }
-    console.log(`✅ /api/context/search 可用，返回 ${json.items.length} 条`);
-    if (json.items.length > 0) {
-    console.log('   示例:', json.items[0].metadata?.sourcePath || json.items[0].id);
+    try {
+      const json = JSON.parse(data);
+      if (!json.items || !Array.isArray(json.items)) {
+        console.error('❌ 返回结构异常，缺少 items 数组');
+        process.exit(1);
+      }
+      if (json.items.length > 0) {
+      }
+    } catch (e) {
+      console.error('❌ 解析响应失败:', e.message);
+      process.exit(1);
     }
-  } catch (e) {
-    console.error('❌ 解析响应失败:', e.message);
-    process.exit(1);
-  }
   });
 });
 

package/skills/autosnippet-analysis/SKILL.md

@@ -143,17 +143,21 @@ autosnippet_bootstrap(operation=refine, candidateIds: ["id1", "id2", ...])
 | 字段 | 重要性 | AI 可填? |
 |------|-------|---------|
 | title | ★★★ 必填 | ✅ |
-| code | ★★★ 必填 | ✅ |
+| content (markdown+pattern+rationale) | ★★★ 必填 | ✅ |
 | language | ★★★ 必填 | ✅ |
-| rationale | ★★★ 强烈推荐 | ✅ |
-| knowledgeType | ★★★ 强烈推荐 | ✅ |
+| kind (rule/pattern/fact) | ★★★ 必填 | ✅ |
+| doClause | ★★★ 必填 | ✅ |
+| category | ★★★ 必填 | ✅ |
+| trigger | ★★★ 必填 | ✅ |
+| description | ★★★ 必填 | ✅ |
+| headers | ★★★ 必填 | ✅ |
+| usageGuide | ★★★ 必填 | ✅ |
+| knowledgeType | ★★★ 必填 | ✅ |
+| reasoning | ★★★ 必填 | Agent 必须自己填 |
 | complexity | ★★☆ 推荐 | ✅ |
 | scope | ★★☆ 推荐 | ✅ |
 | steps | ★★☆ 推荐 | ✅ |
 | constraints.preconditions | ★★☆ 推荐 | ✅ |
-| summary / description | ★★★ 强烈推荐 | ✅ |
-| usageGuide | ★★☆ 推荐 | ⚠️ 需人工审核 |
-| reasoning | ★★★ 必填 | Agent 必须自己填 |
 
 ---
 

package/skills/autosnippet-candidates/SKILL.md

@@ -78,8 +78,16 @@ Every candidate submitted via `submit_candidate` or `submit_candidates` supports
 | Field | Type | Example |
 |-------|------|---------|
 | **title** | string | "网络请求统一封装 - APIClient" |
-| **code** | string | The code pattern (maps to `content.pattern`). Use Xcode placeholders `<#name#>` for variables. |
+| **content** | object | `{ markdown: "≥200字 Markdown 正文", pattern: "核心代码模式", rationale: "设计原理" }` |
 | **language** | string | swift / objc / javascript / python etc. |
+| **kind** | string | `rule` / `pattern` / `fact` |
+| **doClause** | string | 英文祈使句正向指令（≠60 tokens）|
+| **trigger** | string | `@` 开头 kebab-case，如 `@api-client` |
+| **description** | string | 中文摘要 ≤80字 |
+| **category** | string | View / Service / Tool / Model / Network / Storage / UI / Utility |
+| **headers** | string[] | 完整 import 语句数组，无 import 传 `[]` |
+| **usageGuide** | string | Markdown ### 章节格式的使用指南 |
+| **knowledgeType** | string | `code-pattern` / `architecture` / `best-practice` 等 |
 
 ### Layer 2: Classification (strongly recommended — enables filtering & search)
 
@@ -91,20 +99,9 @@ Every candidate submitted via `submit_candidate` or `submit_candidates` supports
 | **scope** | string | `universal` (通用) \| `project-specific` (本项目) \| `target-specific` (特定 Target) |
 | **tags** | string[] | `["networking", "async-await", "error-handling"]` |
 
-### Layer 3: Description & Documentation (强烈建议 — 含双语字段)
-
-| Field | Type | Description |
-|-------|------|-------------|
-| **description** | string | 一句话功能描述 |
-| **summary** | string | 中文详细摘要（等同 summary_cn，Markdown），含功能介绍、设计背景 |
-| **summary_cn** | string | 中文摘要（≤100字）— 与 summary 二选一 |
-| **summary_en** | string | 英文摘要（≤100 words）— **强烈建议**，提升检索与 AI 理解 |
-| **trigger** | string | 触发关键词，**必须** `@` 开头。如 `@api-client` |
-| **usageGuide** | string | 中文使用指南（等同 usageGuide_cn，Markdown），包含 `###` 章节 |
-| **usageGuide_cn** | string | 中文使用指南 — 与 usageGuide 二选一 |
-| **usageGuide_en** | string | 英文使用指南（Markdown ### 章节）— **推荐** |
+### Layer 3: Structured Content (high value — 代码变更与实施步骤)
 
-### Layer 4: Structured Content (high value — enables step-by-step guidance & code diff)
+> **注意**: Layer 1 已包含 V3 全部必填字段（title, content, language, kind, doClause, trigger, description, category, headers, usageGuide, knowledgeType）。本层为可选的高价值补充字段。
 
 | Field | Type | Structure |
 |-------|------|-----------|
@@ -259,7 +256,7 @@ Severity: `error` (must fix) | `warning` (should fix) | `info` (suggestion)
 2. **Maximize information density** — Agent's primary value is extracting structured metadata that humans would skip
 3. **Always fill Layer 1-3 + Reasoning + Recipe-Ready Checklist** at minimum; Layer 4-7 for complex patterns
 4. **Reasoning is mandatory** — Every candidate MUST include `reasoning.whyStandard` + `reasoning.sources` + `reasoning.confidence`. No exceptions.
-5. **Bilingual recommended** — `summary_cn` + `summary_en`, `usageGuide` + `usageGuide_en`. English improves AI understanding and search.
+5. **V3 必填字段** — title, content(markdown+pattern+rationale), trigger, kind, doClause, description, language, category, headers, knowledgeType, usageGuide, reasoning
 6. **Check `recipeReadyHints` in submit response** — If not empty, supplement fields and resubmit
 7. **Parallel query existing Recipes** during generation to reduce duplicates and fill `relations`
 6. **Code examples**: use Xcode placeholders (`<#URL#>`, `<#Token#>`), explain in `usageGuide`
@@ -304,15 +301,15 @@ Recommended sections: When to use / When not to use / Key points / Dependencies
 
 ### 备选：二次补全流程
 
-Step 1: 提交基本字段（title, code, language）→ 获得 candidate ID（`autosnippet_submit_knowledge` 内置自动校验 + 去重检查）
+Step 1: 提交基本字段（title, content, language）→ 获得 candidate ID（`autosnippet_submit_knowledge` 内置自动校验 + 去重检查）
 Step 2: 根据提交返回的校验结果补全缺失字段
 Step 3: 重新提交完整候选
 
 > 注：`autosnippet_enrich_candidates` / `autosnippet_validate_candidate` / `autosnippet_check_duplicate` 已移入 admin 层级。Agent 层级的 `autosnippet_submit_knowledge` 已内置自动校验 + 去重，无需额外调用。
 
-需要补全的两层字段：
-- **语义字段**: rationale, knowledgeType, complexity, scope, steps, constraints
-- **Recipe 必填**: category, trigger, summary_cn, summary_en, headers, usageGuide
+需要补全的字段：
+- **语义字段**: content.rationale, knowledgeType, complexity, scope, steps, constraints
+- **Recipe 必填**: kind, doClause, category, trigger, description, headers, usageGuide, reasoning
 
 ---
 
@@ -324,18 +321,23 @@ Step 3: 重新提交完整候选
   "items": [
     {
       "title": "BiliAPI 网络请求封装",
-      "code": "class BiliAPI {\n  static func request<T: Decodable>(_ endpoint: Endpoint) async throws -> T {\n    let (data, response) = try await URLSession.shared.data(for: endpoint.urlRequest)\n    guard let http = response as? HTTPURLResponse, 200..<300 ~= http.statusCode else {\n      throw BiliError.invalidResponse\n    }\n    return try JSONDecoder().decode(T.self, from: data)\n  }\n}",
+      "content": {
+        "markdown": "## BiliAPI 网络请求统一封装\n\n### ✅ 标准用法\n```swift\nclass BiliAPI {\n  static func request<T: Decodable>(_ endpoint: Endpoint) async throws -> T {\n    let (data, response) = try await URLSession.shared.data(for: endpoint.urlRequest)\n    guard let http = response as? HTTPURLResponse, 200..<300 ~= http.statusCode else {\n      throw BiliError.invalidResponse\n    }\n    return try JSONDecoder().decode(T.self, from: data)\n  }\n}\n```\n\n### 使用示例\n```swift\nlet user: UserInfo = try await BiliAPI.request(UserInfoEndpoint(uid: uid))\n```\n\n### 要点\n- 所有网络请求统一通过 BiliAPI.request()\n- 支持泛型解码，自动 JSON → Model\n- 统一错误处理和响应验证",
+        "pattern": "class BiliAPI {\n  static func request<T: Decodable>(_ endpoint: Endpoint) async throws -> T {\n    let (data, response) = try await URLSession.shared.data(for: endpoint.urlRequest)\n    guard let http = response as? HTTPURLResponse, 200..<300 ~= http.statusCode else {\n      throw BiliError.invalidResponse\n    }\n    return try JSONDecoder().decode(T.self, from: data)\n  }\n}",
+        "rationale": "统一网络层避免各模块各自实现 URLSession 调用，减少重复代码并统一错误处理策略。"
+      },
+      "description": "统一的 API 请求封装，支持泛型解码和错误处理",
+      "kind": "pattern",
+      "doClause": "Use BiliAPI.request() for all network calls with type-safe Decodable responses",
       "language": "swift",
       "category": "Network",
+      "trigger": "@bili-api-request",
+      "headers": ["import Foundation", "import BiliKit"],
       "knowledgeType": "code-pattern",
+      "usageGuide": "### When to use\n- 所有 B 站 API 调用\n- 需要类型安全的响应解码\n\n### Dependencies\n- Foundation\n- BiliKit/Models (Endpoint, BiliError)\n\n### Core steps\n1. 定义 Endpoint\n2. 调用 BiliAPI.request(endpoint)\n3. 处理 Result",
       "complexity": "intermediate",
       "scope": "project-specific",
       "tags": ["networking", "async-await", "generic", "decodable"],
-      "description": "统一的 API 请求封装，支持泛型解码和错误处理",
-      "summary": "基于 async/await 的网络请求封装层，提供类型安全的 API 调用接口。统一错误处理、响应验证和 JSON 解码。",
-      "trigger": "@bili-api-request",
-      "usageGuide": "### When to use\n- 所有 B 站 API 调用\n- 需要类型安全的响应解码\n\n### Dependencies\n- Foundation\n- BiliKit/Models (Endpoint, BiliError)\n\n### Core steps\n1. 定义 Endpoint\n2. 调用 BiliAPI.request(endpoint)\n3. 处理 Result",
-      "rationale": "统一网络层避免各模块各自实现 URLSession 调用，减少重复代码并统一错误处理策略。",
       "steps": [
         {"title": "定义 Endpoint", "description": "创建符合 Endpoint 协议的请求描述", "code": "struct UserInfoEndpoint: Endpoint { ... }"},
         {"title": "发起请求", "description": "调用统一 API 方法", "code": "let user: UserInfo = try await BiliAPI.request(UserInfoEndpoint(uid: uid))"}
@@ -343,7 +345,6 @@ Step 3: 重新提交完整候选
       "codeChanges": [
         {"file": "Sources/Network/OldAPI.swift", "before": "URLSession.shared.dataTask(with: url) { ... }", "after": "let result: T = try await BiliAPI.request(endpoint)", "explanation": "替换回调式为 async/await"}
       ],
-      "headers": ["import Foundation", "import BiliKit"],
       "constraints": {
         "preconditions": ["需要有效的网络连接", "Endpoint 必须实现 urlRequest 属性"],
         "sideEffects": ["发起网络请求"],