autosnippet 2.7.1 → 2.8.0

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

@@ -148,10 +148,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 +202,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/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/package.json

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