autosnippet 2.7.1 → 2.8.2

package/dashboard/dist/index.html

@@ -5,7 +5,7 @@
     <link rel="icon" type="image/svg+xml" href="/vite.svg" />
     <meta name="viewport" content="width=device-width, initial-scale=1.0" />
     <title>AutoSnippet Dashboard</title>
-    <script type="module" crossorigin src="/assets/index-BjfUm8p9.js"></script>
+    <script type="module" crossorigin src="/assets/index-Duc8Qk-c.js"></script>
     <link rel="modulepreload" crossorigin href="/assets/yaml-qRaU8Ldn.js">
     <link rel="modulepreload" crossorigin href="/assets/vendor-BotF760a.js">
     <link rel="modulepreload" crossorigin href="/assets/axios-C0Zqfgkc.js">

package/lib/external/mcp/McpServer.js

@@ -54,6 +54,12 @@ export class McpServer {
 
       // 路径安全守卫 — 在任何写操作前配置
       const projectRoot = process.env.ASD_PROJECT_DIR || process.cwd();
+
+      // 切换工作目录到项目根 — 确保 DB 等相对路径正确解析
+      if (projectRoot !== process.cwd()) {
+        process.chdir(projectRoot);
+      }
+
       Bootstrap.configurePathGuard(projectRoot);
 
       this.bootstrap = new Bootstrap();
@@ -148,10 +154,12 @@ export class McpServer {
       // Bootstrap 冷启动
       case 'autosnippet_bootstrap_knowledge': return bootstrapHandlers.bootstrapKnowledge(ctx, args);
       case 'autosnippet_bootstrap_refine':    return bootstrapHandlers.bootstrapRefine(ctx, args);
-      // Skills 加载 & 创建 & 推荐
+      // Skills 加载 & 创建 & 管理 & 推荐
       case 'autosnippet_list_skills':         return skillHandlers.listSkills();
       case 'autosnippet_load_skill':          return skillHandlers.loadSkill(ctx, args);
       case 'autosnippet_create_skill':        return skillHandlers.createSkill(ctx, args);
+      case 'autosnippet_delete_skill':        return skillHandlers.deleteSkill(ctx, args);
+      case 'autosnippet_update_skill':        return skillHandlers.updateSkill(ctx, args);
       case 'autosnippet_suggest_skills':      return skillHandlers.suggestSkills(ctx);
       default: throw new Error(`Unknown tool: ${name}`);
     }
@@ -200,9 +208,9 @@ export class McpServer {
     await this.initialize();
     const transport = new StdioServerTransport();
     await this.server.connect(transport);
-    this.logger.info('MCP Server started (stdio) — 31 tools');
+    this.logger.info('MCP Server started (stdio) — 38 tools');
     // 在 stderr 写一行简洁的就绪通知（不使用 winston，仅用于 Cursor 日志面板 & 调试）
-    process.stderr.write('AutoSnippet MCP ready — 31 tools\n');
+    process.stderr.write('AutoSnippet MCP ready — 38 tools\n');
   }
 
   async shutdown() {

package/lib/external/mcp/handlers/skill.js

@@ -399,6 +399,204 @@ function _regenerateEditorIndex() {
   }
 }
 
+// ═══════════════════════════════════════════════════════════
+// Handler: deleteSkill
+// ═══════════════════════════════════════════════════════════
+
+/**
+ * 删除项目级 Skill — 移除 {projectRoot}/AutoSnippet/skills/<name>/ 整个目录
+ * 内置 Skill 不可删除。删除后自动 regenerate 编辑器索引。
+ *
+ * @param {object} _ctx  MCP context
+ * @param {object} args  { name: string }
+ * @returns {string} JSON envelope
+ */
+export function deleteSkill(_ctx, args) {
+  const { name } = args || {};
+
+  if (!name) {
+    return JSON.stringify({
+      success: false,
+      error: { code: 'MISSING_PARAM', message: 'name is required' },
+    });
+  }
+
+  // 不允许删除内置 Skill
+  const builtinSkillPath = path.join(SKILLS_DIR, name);
+  if (fs.existsSync(builtinSkillPath)) {
+    return JSON.stringify({
+      success: false,
+      error: {
+        code: 'BUILTIN_PROTECTED',
+        message: `"${name}" is a built-in Skill and cannot be deleted.`,
+      },
+    });
+  }
+
+  // 检查项目级 Skill 是否存在
+  const projectSkillsDir = _getProjectSkillsDir();
+  const skillDir = path.join(projectSkillsDir, name);
+  if (!fs.existsSync(skillDir)) {
+    return JSON.stringify({
+      success: false,
+      error: {
+        code: 'SKILL_NOT_FOUND',
+        message: `Project skill "${name}" not found.`,
+      },
+    });
+  }
+
+  // ── 路径安全检查 ──
+  try {
+    pathGuard.assertProjectWriteSafe(skillDir);
+  } catch (err) {
+    return JSON.stringify({
+      success: false,
+      error: { code: 'PATH_GUARD', message: err.message },
+    });
+  }
+
+  // ── 删除目录 ──
+  try {
+    fs.rmSync(skillDir, { recursive: true, force: true });
+  } catch (err) {
+    return JSON.stringify({
+      success: false,
+      error: { code: 'DELETE_ERROR', message: `Failed to delete skill: ${err.message}` },
+    });
+  }
+
+  // ── regenerate 编辑器索引 ──
+  const indexResult = _regenerateEditorIndex();
+
+  return JSON.stringify({
+    success: true,
+    data: {
+      skillName: name,
+      deleted: true,
+      editorIndex: indexResult,
+      hint: `Skill "${name}" deleted successfully.`,
+    },
+  });
+}
+
+// ═══════════════════════════════════════════════════════════
+// Handler: updateSkill
+// ═══════════════════════════════════════════════════════════
+
+/**
+ * 更新项目级 Skill — 修改 description 和/或 content
+ * 内置 Skill 不可更新。更新后自动 regenerate 编辑器索引。
+ *
+ * @param {object} _ctx  MCP context
+ * @param {object} args  { name, description?, content? }
+ * @returns {string} JSON envelope
+ */
+export function updateSkill(_ctx, args) {
+  const { name, description, content } = args || {};
+
+  if (!name) {
+    return JSON.stringify({
+      success: false,
+      error: { code: 'MISSING_PARAM', message: 'name is required' },
+    });
+  }
+
+  if (!description && !content) {
+    return JSON.stringify({
+      success: false,
+      error: { code: 'NOTHING_TO_UPDATE', message: 'At least one of description or content must be provided.' },
+    });
+  }
+
+  // 不允许更新内置 Skill
+  const builtinSkillPath = path.join(SKILLS_DIR, name, 'SKILL.md');
+  if (fs.existsSync(builtinSkillPath)) {
+    return JSON.stringify({
+      success: false,
+      error: {
+        code: 'BUILTIN_PROTECTED',
+        message: `"${name}" is a built-in Skill and cannot be updated. Fork it as a project skill instead.`,
+      },
+    });
+  }
+
+  // 检查项目级 Skill 是否存在
+  const projectSkillsDir = _getProjectSkillsDir();
+  const skillPath = path.join(projectSkillsDir, name, 'SKILL.md');
+  if (!fs.existsSync(skillPath)) {
+    return JSON.stringify({
+      success: false,
+      error: {
+        code: 'SKILL_NOT_FOUND',
+        message: `Project skill "${name}" not found. Use autosnippet_create_skill to create it first.`,
+      },
+    });
+  }
+
+  try {
+    // ── 读取现有文件 ──
+    const existing = fs.readFileSync(skillPath, 'utf8');
+
+    // 解析现有 frontmatter
+    const fmMatch = existing.match(/^---\n([\s\S]*?)\n---\n?([\s\S]*)$/);
+    let oldFm = '';
+    let oldBody = existing;
+    if (fmMatch) {
+      oldFm = fmMatch[1];
+      oldBody = fmMatch[2];
+    }
+
+    // 解析已有字段
+    const getField = (fm, key) => {
+      const m = fm.match(new RegExp(`^${key}:\\s*(.+?)$`, 'm'));
+      return m ? m[1].trim() : null;
+    };
+
+    const newDesc = description || getField(oldFm, 'description') || name;
+    const newBody = content !== undefined && content !== null ? content : oldBody;
+
+    // 保留原有字段
+    const createdBy = getField(oldFm, 'createdBy') || 'external-ai';
+    const createdAt = getField(oldFm, 'createdAt') || new Date().toISOString();
+    const title = getField(oldFm, 'title');
+
+    // 重建 frontmatter
+    const fmLines = ['---', `name: ${name}`];
+    if (title) fmLines.push(`title: ${title}`);
+    fmLines.push(
+      `description: ${newDesc}`,
+      `createdBy: ${createdBy}`,
+      `createdAt: ${createdAt}`,
+      `updatedAt: ${new Date().toISOString()}`,
+      '---',
+      '',
+    );
+
+    pathGuard.assertProjectWriteSafe(path.join(projectSkillsDir, name));
+    fs.writeFileSync(skillPath, fmLines.join('\n') + newBody, 'utf8');
+  } catch (err) {
+    return JSON.stringify({
+      success: false,
+      error: { code: 'UPDATE_ERROR', message: `Failed to update skill: ${err.message}` },
+    });
+  }
+
+  // ── regenerate 编辑器索引 ──
+  const indexResult = _regenerateEditorIndex();
+
+  return JSON.stringify({
+    success: true,
+    data: {
+      skillName: name,
+      updated: true,
+      fieldsUpdated: [description ? 'description' : null, content ? 'content' : null].filter(Boolean),
+      editorIndex: indexResult,
+      hint: `Skill "${name}" updated. Use autosnippet_load_skill to verify content.`,
+    },
+  });
+}
+
 // ═══════════════════════════════════════════════════════════
 // Handler: suggestSkills
 // ═══════════════════════════════════════════════════════════

package/lib/external/mcp/tools.js

@@ -1,5 +1,5 @@
 /**
- * MCP 工具定义（34 个）+ Gateway 映射
+ * MCP 工具定义（38 个）+ Gateway 映射
  *
  * 只包含 JSON Schema 级别的声明，不含任何业务逻辑。
  */
@@ -18,6 +18,8 @@ export const TOOL_GATEWAY_MAP = {
   autosnippet_bootstrap_knowledge: { action: 'knowledge:bootstrap', resource: 'knowledge' },
   autosnippet_bootstrap_refine: { action: 'candidate:update', resource: 'candidates' },
   autosnippet_create_skill: { action: 'create:skills', resource: 'skills' },
+  autosnippet_delete_skill: { action: 'delete:skills', resource: 'skills' },
+  autosnippet_update_skill: { action: 'update:skills', resource: 'skills' },
 };
 
 export const TOOLS = [
@@ -684,6 +686,57 @@ export const TOOLS = [
       '  • 候选被大量驳回时',
     inputSchema: { type: 'object', properties: {}, required: [] },
   },
+  // 37. 删除项目级 Skill
+  {
+    name: 'autosnippet_delete_skill',
+    description:
+      '删除一个项目级 Skill 及其目录。\n' +
+      '⚠️ 内置 Skill 不可删除。删除后自动更新编辑器索引。\n' +
+      '\n' +
+      '使用场景：\n' +
+      '  • 清理不再需要的自定义 Skill\n' +
+      '  • 移除过时或错误的操作指南',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          description: 'Skill 名称（如 my-auth-guide）',
+        },
+      },
+      required: ['name'],
+    },
+  },
+  // 38. 更新项目级 Skill
+  {
+    name: 'autosnippet_update_skill',
+    description:
+      '更新已存在的项目级 Skill 的描述或内容。\n' +
+      '⚠️ 内置 Skill 不可更新。更新后自动刷新编辑器索引。\n' +
+      '\n' +
+      '使用场景：\n' +
+      '  • 迭代改进已有 Skill 的操作指南\n' +
+      '  • 更新过时的最佳实践内容\n' +
+      '  • 修正 Skill 描述或补充新章节',
+    inputSchema: {
+      type: 'object',
+      properties: {
+        name: {
+          type: 'string',
+          description: 'Skill 名称（必须已存在于项目级 Skills 中）',
+        },
+        description: {
+          type: 'string',
+          description: '新的一句话描述（可选，不传则保持原值）',
+        },
+        content: {
+          type: 'string',
+          description: '新的正文内容（Markdown 格式，不含 frontmatter）。不传则保持原值',
+        },
+      },
+      required: ['name'],
+    },
+  },
   // 36. ② 内容润色：Bootstrap 候选 AI 精炼（Phase 6）
   {
     name: 'autosnippet_bootstrap_refine',

package/lib/http/routes/candidates.js

@@ -22,7 +22,7 @@ const MAX_BATCH_SIZE = 100;
 router.get('/', asyncHandler(async (req, res) => {
   const { status, language, category, keyword } = req.query;
   const page = safeInt(req.query.page, 1);
-  const pageSize = safeInt(req.query.limit, 20, 1, 100);
+  const pageSize = safeInt(req.query.limit, 20, 1, 1000);
 
   const container = getServiceContainer();
   const candidateService = container.get('candidateService');

package/lib/infrastructure/database/DatabaseConnection.js

@@ -9,6 +9,9 @@ const __dirname = path.dirname(__filename);
 
 /**
  * DatabaseConnection - 数据库连接管理器
+ *
+ * 重要：相对 DB 路径通过 projectRoot 解析，而非 process.cwd()。
+ * 这样即使 MCP 服务器的 cwd 不是项目目录，DB 也不会创建到项目外。
  */
 export class DatabaseConnection {
   constructor(config) {
@@ -22,8 +25,14 @@ export class DatabaseConnection {
   async connect() {
     const dbPath = this.config.path;
 
+    // 使用 projectRoot（PathGuard 已配置）优先解析相对路径，
+    // 而非 path.resolve()（依赖 cwd，MCP 场景下 cwd 可能是用户主目录）
+    const projectRoot = pathGuard.projectRoot;
+    const resolvedDbPath = (projectRoot && !path.isAbsolute(dbPath))
+      ? path.resolve(projectRoot, dbPath)
+      : path.resolve(dbPath);
+
     // 路径安全检查 — 防止 DB 文件创建到项目允许范围外
-    const resolvedDbPath = path.resolve(dbPath);
     pathGuard.assertProjectWriteSafe(resolvedDbPath);
     
     // 确保数据目录存在
@@ -32,7 +41,7 @@ export class DatabaseConnection {
       fs.mkdirSync(dbDir, { recursive: true });
     }
 
-    this.db = new Database(dbPath, {
+    this.db = new Database(resolvedDbPath, {
       verbose: this.config.verbose ? (msg) => process.stderr.write(`[SQL] ${msg}\n`) : null,
     });
 

package/lib/service/automation/handlers/AlinkHandler.js

@@ -1,7 +1,12 @@
 /**
  * AlinkHandler — 处理 alink 指令
+ *
+ * 解析编辑器中的 alink 触发行，提取 completionKey，
+ * 通过数据库查找匹配的 Recipe，打开 Dashboard 详情页。
  */
 
+import { getServiceContainer } from '../../../injection/ServiceContainer.js';
+
 /**
  * @param {string} alinkLine
  */
@@ -19,11 +24,45 @@ export async function handleAlink(alinkLine) {
 
   if (completionKey != null) {
     try {
+      // 从 DI 容器获取数据库实例，查找匹配 trigger 的 Recipe
+      const container = getServiceContainer();
+      const db = container.get('database');
+
+      let recipeId = null;
+      if (db) {
+        try {
+          const row = db.prepare(
+            'SELECT id FROM recipes WHERE trigger = ? LIMIT 1',
+          ).get(completionKey);
+          if (row) recipeId = row.id;
+        } catch {
+          // DB 查询失败时回退到搜索
+        }
+
+        // 若精确匹配失败，尝试模糊搜索
+        if (!recipeId) {
+          try {
+            const escaped = completionKey.replace(/[%_\\]/g, ch => `\\${ch}`);
+            const row = db.prepare(
+              "SELECT id FROM recipes WHERE trigger LIKE ? ESCAPE '\\' OR title LIKE ? ESCAPE '\\' LIMIT 1",
+            ).get(`%${escaped}%`, `%${escaped}%`);
+            if (row) recipeId = row.id;
+          } catch { /* silent */ }
+        }
+      }
+
+      // 构建 Dashboard URL 并打开
+      const port = process.env.ASD_DASHBOARD_PORT || 3000;
+      const host = process.env.ASD_DASHBOARD_HOST || 'localhost';
+      const url = recipeId
+        ? `http://${host}:${port}/#/recipes/${recipeId}`
+        : `http://${host}:${port}/#/search?q=${encodeURIComponent(completionKey)}`;
+
       const open = (await import('open')).default;
-      // TODO: 从 V2 缓存系统获取 link
-      console.log(`[alink] completionKey=${completionKey} — V2 链接缓存待实现`);
-    } catch {
-      // 静默
+      await open(url);
+      console.log(`[alink] completionKey=${completionKey} → ${url}`);
+    } catch (err) {
+      console.warn(`[alink] Failed to open link: ${err.message}`);
     }
   }
 }

package/lib/shared/PathGuard.js

@@ -104,11 +104,11 @@ class PathGuard {
     this.#packageRoot = packageRoot ? path.resolve(packageRoot) : null;
     this.#knowledgeBaseDir = knowledgeBaseDir || null;  // 延迟解析
 
-    // 默认白名单：Xcode snippets 目录、全局缓存
+    // 默认白名单：Xcode snippets 目录、全局缓存（cache 子目录，不含整个 ~/.autosnippet）
     const HOME = process.env.HOME || process.env.USERPROFILE || '';
     if (HOME) {
       this.#allowList.add(path.join(HOME, 'Library/Developer/Xcode/UserData/CodeSnippets'));
-      this.#allowList.add(path.join(HOME, '.autosnippet'));
+      this.#allowList.add(path.join(HOME, '.autosnippet', 'cache'));
     }
 
     // 用户自定义白名单

package/package.json

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

package/skills/autosnippet-coldstart/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-coldstart
 description: Cold-start knowledge base initialization. Full 9-dimension analysis workflow — works with both external Agent and internal AI. Call bootstrap_knowledge, then systematically analyze code and submit candidates.
@@ -465,4 +464,3 @@ description: Cold-start knowledge base initialization. Full 9-dimension analysis
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考（命名/并发/错误处理/内存/设计模式）
 - **autosnippet-reference-objc**: Objective-C 业界最佳实践参考（ARC/Block/Delegate/Prefix/GCD）
 - **autosnippet-reference-jsts**: JavaScript/TypeScript 业界最佳实践参考（async/React/Node/ESM/类型系统）
-```

package/skills/autosnippet-reference-jsts/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-reference-jsts
 description: JavaScript/TypeScript 业界最佳实践参考。涵盖类型系统、模块化、错误处理、async/await、命名、ESLint 规则，为冷启动分析提供高质量参考标准。
@@ -437,4 +436,3 @@ const url = baseUrl + '/api/v' + version + '/users/' + userId;
 - **autosnippet-coldstart**: 完整冷启动流程（本 Skill 的主 Skill）
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考
 - **autosnippet-reference-objc**: Objective-C 业界最佳实践参考
-```

package/skills/autosnippet-reference-objc/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-reference-objc
 description: Objective-C 业界最佳实践参考。涵盖命名前缀、属性声明、Delegate 模式、内存管理、nullability、错误处理，为冷启动分析提供高质量参考标准。
@@ -424,4 +423,3 @@ if ([NSThread isMainThread]) {
 - **autosnippet-coldstart**: 完整冷启动流程（本 Skill 的主 Skill）
 - **autosnippet-reference-swift**: Swift 业界最佳实践参考
 - **autosnippet-reference-jsts**: JavaScript/TypeScript 业界最佳实践参考
-```

package/skills/autosnippet-reference-swift/SKILL.md

@@ -1,4 +1,3 @@
-```skill
 ---
 name: autosnippet-reference-swift
 description: Swift 业界最佳实践参考。涵盖命名规范、Swift Concurrency、SwiftUI 模式、错误处理、内存管理、设计模式，为冷启动分析提供高质量参考标准。
@@ -458,4 +457,3 @@ UIView.animate(
 - **autosnippet-coldstart**: 完整冷启动流程（本 Skill 的主 Skill）
 - **autosnippet-reference-objc**: Objective-C 业界最佳实践参考
 - **autosnippet-reference-jsts**: JavaScript/TypeScript 业界最佳实践参考
-```