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

package/README.md

@@ -10,17 +10,35 @@
 
 只需添加 MCP 服务配置：
 
+**方式一：npx（推荐）**
+
 ```json
 {
   "mcpServers": {
     "bkui-knowledge": {
       "command": "npx",
-      "args": ["-y", "@blueking/bkui-knowledge"]
+      "args": ["-y", "@blueking/bkui-knowledge", "${workspaceFolder}"]
+    }
+  }
+}
+```
+
+**方式二：本地开发**
+
+```json
+{
+  "mcpServers": {
+    "bkui-knowledge": {
+      "command": "node",
+      "args": ["/path/to/bkui-knowledge/bin/bkui-knowledge.js"],
+      "cwd": "/path/to/your-project"
     }
   }
 }
 ```
 
+> ⚠️ 必须传递项目路径，否则 skills 无法同步到正确位置
+
 **特性：**
 - ✅ 首次启动自动同步推荐 skills 到 `.cursor/skills/`
 - ✅ 自动生成 `.cursor/rules/bkui.mdc`（规则自动注入 AI 上下文）

package/bin/bkui-knowledge.js

@@ -11,11 +11,16 @@
  *   "mcpServers": {
  *     "bkui-knowledge": {
  *       "command": "npx",
- *       "args": ["-y", "@blueking/bkui-knowledge"]
+ *       "args": ["-y", "@blueking/bkui-knowledge", "${workspaceFolder}"]
  *     }
  *   }
  * }
  *
+ * 项目路径传递方式（优先级从高到低）：
+ * 1. 命令行参数: npx @blueking/bkui-knowledge /path/to/project
+ * 2. 环境变量: BKUI_PROJECT_ROOT=/path/to/project
+ * 3. 当前工作目录 (cwd)
+ *
  * 更新机制：
  * - skills 内置在 npm 包中
  * - 更新 skills 时：修改代码 → npm publish
@@ -42,9 +47,19 @@ function log(msg) {
 }
 
 /**
- * 获取用户项目根目录（cwd）
+ * 获取用户项目根目录
+ * 优先级：命令行参数 > 环境变量 > cwd
  */
 function getProjectRoot() {
+  // 1. 命令行参数: node bkui-knowledge.js /path/to/project
+  if (process.argv[2] && !process.argv[2].startsWith('-')) {
+    return process.argv[2];
+  }
+  // 2. 环境变量: BKUI_PROJECT_ROOT=/path/to/project
+  if (process.env.BKUI_PROJECT_ROOT) {
+    return process.env.BKUI_PROJECT_ROOT;
+  }
+  // 3. 默认使用 cwd
   return process.cwd();
 }
 
@@ -308,6 +323,9 @@ async function startMcpServer() {
 async function main() {
   const projectRoot = getProjectRoot();
 
+  // 调试：输出实际的工作目录
+  log(`工作目录: ${projectRoot}`);
+
   // 1. 同步 skills（同步执行，从 npm 包读取）
   syncSkills(projectRoot);
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blueking/bkui-knowledge",
-  "version": "0.0.1-beta.1",
+  "version": "0.0.1-beta.3",
   "description": "蓝鲸前端知识库 MCP 服务 - 自动同步 skills，支持 Cursor/VSCode",
   "main": "server/mcp-core.js",
   "bin": {