@blueking/bkui-knowledge 0.0.1-beta.1 → 0.0.1-beta.10

package/server/mcp-core.js

@@ -21,31 +21,17 @@ const KNOWLEDGE_DIR = path.join(ROOT_DIR, 'knowledge');
 // 重要: 工具描述会被自动注入到 AI 上下文，因此在此嵌入核心规则
 // ---------------------------------------------------------
 const TOOLS = [
-  // L0 工具: 获取索引 (核心工具，描述中嵌入规则)
+  // L0 工具: 获取索引
   {
     name: "get_knowledge_index",
-    description: `【蓝鲸前端知识库】当用户需要使用 bk- 组件、bkui-vue、蓝鲸组件库、MagicBox 时，必须使用此知识库的工具。
-
-## 自动触发条件
-遇到以下关键词时，应主动调用本知识库工具：
-- bk-navigation, bk-menu, bk-table, bk-form, bk-dialog 等 bk- 前缀组件
-- bkui-vue, 蓝鲸组件库, MagicBox, 蓝鲸前端
-- 设计稿还原, 管理后台页面
-
-## 强制规范
-- 组件库: bkui-vue (前缀 bk-)
-- 语法: Vue 3 <script setup lang="ts">
-- 样式: MagicBox 原子类 (mt10, mb20)
-
-## ⚠️ 常见错误
-- bk-navigation 用 default-open，不是 default-open-keys
-- bk-menu 用 opened-keys，不是 default-open-keys
-- bk-dialog 用 v-model:isShow，不是 v-model
-
-## 工作流程
-1. 使用 bk- 组件前，先调用 get_component_api 获取 API
-2. 需要页面模板时，调用 get_skill({ skillId: 'bkui-builder' }) 获取规则
-3. 根据布局分析报告按需加载模版资源`,
+    description: `【蓝鲸前端知识库】遇到 bk- 组件、bkui-vue、蓝鲸组件库时必须使用。
+
+首次使用时，请先读取 .cursor/skills/bkui-quick-start.md 获取完整规范和索引。
+
+快速参考：
+- bk-dialog 用 v-model:isShow（不是 v-model）
+- bk-menu 用 opened-keys（不是 default-open-keys）
+- bk-navigation 用 default-open（不是 default-open-keys）`,
     inputSchema: {
       type: "object",
       properties: {
@@ -61,7 +47,7 @@ const TOOLS = [
   // L1 工具: 获取 Skill 详情
   {
     name: "get_skill",
-    description: "获取技能文档 (Markdown)。可用 ID: bkui-builder(设计稿还原), layout-rules(布局规范), api-standard(请求封装), pinia-setup(状态管理), vite-migration(Vite迁移), bundle-optimization(构建优化), virtual-list(虚拟滚动), unit-testing(单测), bkui-cheatsheet(速查表)",
+    description: "获取技能文档 (Markdown)。可用 ID: bkui-quick-start(入门指南), bkui-builder(设计稿还原), bkui-cheatsheet(速查表), api-standard(请求封装), pinia-setup(状态管理), vite-migration(Vite迁移), bundle-optimization(构建优化), virtual-list(虚拟滚动), unit-testing(单测), code-review(代码评审)",
     inputSchema: {
       type: "object",
       properties: {
@@ -119,6 +105,22 @@ const TOOLS = [
       type: "object",
       properties: {}
     }
+  },
+
+  // L3 工具: 获取资源文件 (绕过 Cursor FetchMcpResource bug)
+  {
+    name: "get_resource",
+    description: "获取 skill 或 example 资源文件内容。URI 格式: skill://skillId/subDir/path 或 example://componentId/exampleName。用于获取布局模板、代码示例等资源。",
+    inputSchema: {
+      type: "object",
+      properties: {
+        uri: {
+          type: "string",
+          description: "资源 URI，如: skill://bkui-builder/assets/layouts/admin-layout-dark.vue, example://table/basic"
+        }
+      },
+      required: ["uri"]
+    }
   }
 ];
 
@@ -167,8 +169,9 @@ function buildResources() {
     if (manifest.skills && manifest.skills.items) {
       const skillsBasePath = path.join(KNOWLEDGE_DIR, manifest.skills.base_path);
       manifest.skills.items.forEach(skill => {
-        const skillDir = path.join(skillsBasePath, skill.id);
-        ['scripts', 'references', 'assets'].forEach(subDir => {
+        // 使用 skill.path 推断目录（支持外部 skill）
+        const skillDir = path.join(skillsBasePath, path.dirname(skill.path));
+        ['scripts', 'references', 'assets', 'rules'].forEach(subDir => {
           const subDirPath = path.join(skillDir, subDir);
           if (fs.existsSync(subDirPath)) {
             scanSkillDir(subDirPath, '').forEach(filePath => {
@@ -289,7 +292,7 @@ const Handlers = {
 
     // 检查 skill 目录下的附属资源，生成 skill:// URIs
     const skillDir = path.dirname(filePath);
-    const subDirs = ['scripts', 'references', 'assets'];
+    const subDirs = ['scripts', 'references', 'assets', 'rules'];
     const availableResources = [];
 
     subDirs.forEach(dir => {
@@ -447,7 +450,6 @@ ${recommendedIds.map(id => {
 ### 同步位置
 
 - \`.cursor/skills/*.md\` - 技能文档
-- \`.cursor/commands/*.md\` - 斜杠指令 (可通过 /${recommendedIds[0]} 调用)
 - \`.cursor/rules/bkui.mdc\` - 规则文件 (自动注入 AI 上下文)
 - \`.cursor/.bkui-knowledge-version\` - 版本标记
 
@@ -462,6 +464,17 @@ ${recommendedIds.map(id => {
     return { content: [{ type: "text", text: result }] };
   },
 
+  // L3: 获取资源文件 (绕过 Cursor FetchMcpResource bug)
+  async get_resource({ uri }) {
+    const result = await readResource(uri);
+    // readResource 返回 { content: string } 或 { contents: [{ text }] }
+    const text = result.content || (result.contents && result.contents[0] && result.contents[0].text);
+    if (!text) {
+      throw new Error(`Resource not found or empty: ${uri}`);
+    }
+    return { content: [{ type: "text", text }] };
+  },
+
   // Prompt 处理
   async get_prompt({ name }) {
     if (name === "BKUI-EXPERT") {
@@ -566,8 +579,8 @@ async function handleExampleResource(uri) {
     throw new Error(`Example '${exampleName}' not found for ${componentId}. Available: ${compExamples.examples.map(e => e.name).join(', ')}`);
   }
 
-  // 读取示例文件
-  const examplePath = path.join(ROOT_DIR, manifest.componentExamples.base_path, example.file);
+  // 读取示例文件 (base_path 相对于 KNOWLEDGE_DIR)
+  const examplePath = path.join(KNOWLEDGE_DIR, manifest.componentExamples.base_path, example.file);
   if (!fs.existsSync(examplePath)) {
     throw new Error(`Example file not found: ${example.file}`);
   }
@@ -588,8 +601,8 @@ async function handleSkillResource(uri) {
 
   const [, skillId, subDir, filePath] = match;
 
-  if (!['scripts', 'references', 'assets'].includes(subDir)) {
-    throw new Error(`Invalid skill subDir: ${subDir}. Must be scripts, references, or assets`);
+  if (!['scripts', 'references', 'assets', 'rules'].includes(subDir)) {
+    throw new Error(`Invalid skill subDir: ${subDir}. Must be scripts, references, assets, or rules`);
   }
 
   const manifest = loadManifest();
@@ -598,7 +611,9 @@ async function handleSkillResource(uri) {
     throw new Error(`Skill not found: ${skillId}`);
   }
 
-  const fullPath = path.join(KNOWLEDGE_DIR, manifest.skills.base_path, skillId, subDir, filePath);
+  // 使用 skill.path 推断目录（支持外部 skill）
+  const skillDir = path.dirname(skill.path);
+  const fullPath = path.join(KNOWLEDGE_DIR, manifest.skills.base_path, skillDir, subDir, filePath);
   if (!fs.existsSync(fullPath)) {
     throw new Error(`Skill resource not found: ${subDir}/${filePath}`);
   }