@blueking/bkui-knowledge 0.0.1-beta.2 → 0.0.1-beta.4

package/README.md

@@ -10,19 +10,34 @@
 
 只需添加 MCP 服务配置：
 
+**方式一：npx（推荐）**
+
 ```json
 {
   "mcpServers": {
     "bkui-knowledge": {
       "command": "npx",
-      "args": ["-y", "@blueking/bkui-knowledge"],
-      "cwd": "${workspaceFolder}"
+      "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"
     }
   }
 }
 ```
 
-> ⚠️ `cwd` 必须设置为项目根目录，否则 skills 无法同步到正确位置
+> ⚠️ 必须传递项目路径，否则 skills 无法同步到正确位置
 
 **特性：**
 - ✅ 首次启动自动同步推荐 skills 到 `.cursor/skills/`

package/bin/bkui-knowledge.js

@@ -11,13 +11,15 @@
  *   "mcpServers": {
  *     "bkui-knowledge": {
  *       "command": "npx",
- *       "args": ["-y", "@blueking/bkui-knowledge"],
- *       "cwd": "${workspaceFolder}"
+ *       "args": ["-y", "@blueking/bkui-knowledge", "${workspaceFolder}"]
  *     }
  *   }
  * }
  *
- * 注意：cwd 必须设置为项目根目录，否则 skills 无法同步到正确位置
+ * 项目路径传递方式（优先级从高到低）：
+ * 1. 命令行参数: npx @blueking/bkui-knowledge /path/to/project
+ * 2. 环境变量: BKUI_PROJECT_ROOT=/path/to/project
+ * 3. 当前工作目录 (cwd)
  *
  * 更新机制：
  * - skills 内置在 npm 包中
@@ -45,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();
 }
 
@@ -311,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.2",
+  "version": "0.0.1-beta.4",
   "description": "蓝鲸前端知识库 MCP 服务 - 自动同步 skills，支持 Cursor/VSCode",
   "main": "server/mcp-core.js",
   "bin": {