@ppdocs/mcp 3.2.7 → 3.2.9

package/dist/tools/index.js

@@ -8,6 +8,7 @@
  * 📝 工作流:   kg_task, kg_files, kg_discuss (3个)
  * 🔬 代码分析: code_scan, code_query, code_impact, code_context (4个)
  */
+import { createContext } from './shared.js';
 import { registerInitTool } from './init.js';
 import { registerStatusTool } from './kg_status.js';
 import { registerDocTools } from './docs.js';
@@ -18,18 +19,20 @@ import { registerFileTools } from './files.js';
 import { registerDiscussionTools } from './discussion.js';
 import { registerAnalyzerTools } from './analyzer.js';
 export function registerTools(server, projectId, user, onProjectChange) {
-    // 🔗 初始化 (kg_init — 运行时项目切换)
-    registerInitTool(server, projectId, onProjectChange || (() => { }));
+    // 创建共享可变上下文 — 所有工具捕获此对象引用
+    const ctx = createContext(projectId, user);
+    // 🔗 初始化 (kg_init — 运行时项目切换，更新 ctx)
+    registerInitTool(server, ctx, onProjectChange || (() => { }));
     // 📊 导航 (kg_status + kg_tree在docs中)
-    registerStatusTool(server, projectId);
+    registerStatusTool(server, ctx);
     // 📚 知识 (kg_doc + kg_tree + kg_projects + kg_rules)
-    registerDocTools(server, projectId);
-    registerProjectTools(server, projectId);
-    registerRuleTools(server, projectId);
+    registerDocTools(server, ctx.projectId);
+    registerProjectTools(server, ctx.projectId);
+    registerRuleTools(server, ctx.projectId);
     // 📝 工作流 (kg_task + kg_files + kg_discuss)
-    registerTaskTools(server, projectId, user);
+    registerTaskTools(server, ctx.projectId, ctx.user);
     registerFileTools(server);
-    registerDiscussionTools(server, projectId);
+    registerDiscussionTools(server, ctx.projectId);
     // 🔬 代码分析 (不变)
-    registerAnalyzerTools(server, projectId);
+    registerAnalyzerTools(server, ctx.projectId);
 }

package/dist/tools/init.d.ts

@@ -5,9 +5,8 @@
  * - 智能体调用 kg_init 传入 projectPath
  * - MCP 从该路径读取 .ppdocs 配置
  * - 重新初始化 HTTP Client 指向正确项目
- * - 后续所有工具调用自动使用新的项目上下文
+ * - 更新共享 McpContext，所有工具自动获取新 projectId
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-/** 获取当前已初始化的 projectId */
-export declare function getActiveProjectId(): string | null;
-export declare function registerInitTool(server: McpServer, defaultProjectId: string, onProjectChange: (newProjectId: string, newApiUrl: string) => void): void;
+import { type McpContext } from './shared.js';
+export declare function registerInitTool(server: McpServer, ctx: McpContext, onProjectChange: (newProjectId: string, newApiUrl: string) => void): void;

package/dist/tools/init.js

@@ -5,20 +5,15 @@
  * - 智能体调用 kg_init 传入 projectPath
  * - MCP 从该路径读取 .ppdocs 配置
  * - 重新初始化 HTTP Client 指向正确项目
- * - 后续所有工具调用自动使用新的项目上下文
+ * - 更新共享 McpContext，所有工具自动获取新 projectId
  */
 import * as fs from 'fs';
 import * as path from 'path';
 import { z } from 'zod';
 import { initClient } from '../storage/httpClient.js';
 import { wrap, safeTool } from './shared.js';
-// 当前会话的项目上下文 (模块级单例)
-let currentProjectId = null;
+// 当前会话的 API URL (用于幂等检查)
 let currentApiUrl = null;
-/** 获取当前已初始化的 projectId */
-export function getActiveProjectId() {
-    return currentProjectId;
-}
 /** 尝试从指定目录读取 .ppdocs 配置 */
 function readPpdocsFrom(dir) {
     const configPath = path.join(dir, '.ppdocs');
@@ -38,8 +33,8 @@ function readPpdocsFrom(dir) {
         return null;
     }
 }
-export function registerInitTool(server, defaultProjectId, onProjectChange) {
-    server.tool('kg_init', '🔗 项目上下文初始化 — 读取指定目录的 .ppdocs 配置，切换 MCP 连接到对应项目。首次对话建议调用。不传 projectPath 则使用当前工作目录', {
+export function registerInitTool(server, ctx, onProjectChange) {
+    server.tool('kg_init', '🔗 项目上下文初始化 — 读取指定目录的 .ppdocs 配置，切换 MCP 连接到对应项目。首次对话必须调用。不传 projectPath 则使用当前工作目录', {
         projectPath: z.string().optional().describe('项目根目录的绝对路径(含 .ppdocs 文件)，不传则使用 cwd'),
     }, async ({ projectPath }) => safeTool(async () => {
         const targetDir = projectPath || process.cwd();
@@ -52,7 +47,7 @@ export function registerInitTool(server, defaultProjectId, onProjectChange) {
                 `或通过 WebUI 绑定项目:\n` +
                 `  npx @ppdocs/mcp webui`);
         }
-        // 2. 检查是否需要切换
+        // 2. 幂等检查
         if (currentApiUrl === config.apiUrl) {
             return wrap(`✅ 项目上下文已就绪 (无需切换)\n\n` +
                 `📂 项目: ${config.projectId}\n` +
@@ -61,9 +56,11 @@ export function registerInitTool(server, defaultProjectId, onProjectChange) {
         }
         // 3. 重新初始化 HTTP Client
         initClient(config.apiUrl);
-        currentProjectId = config.projectId;
         currentApiUrl = config.apiUrl;
-        // 4. 通知主进程更新工具注册的 projectId
+        // 4. 更新共享上下文 — 所有工具立刻获得新 projectId
+        ctx.projectId = config.projectId;
+        ctx.user = config.user;
+        // 5. 通知主进程
         onProjectChange(config.projectId, config.apiUrl);
         return wrap(`✅ 项目上下文已初始化\n\n` +
             `📂 项目: ${config.projectId}\n` +

package/dist/tools/kg_status.d.ts

@@ -2,4 +2,5 @@
  * 📊 kg_status — 项目速览仪表盘 (新增)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerStatusTool(server: McpServer, projectId: string): void;
+import { type McpContext } from './shared.js';
+export declare function registerStatusTool(server: McpServer, ctx: McpContext): void;

package/dist/tools/kg_status.js

@@ -3,7 +3,7 @@
  */
 import { getClient } from '../storage/httpClient.js';
 import { wrap, safeTool } from './shared.js';
-export function registerStatusTool(server, projectId) {
+export function registerStatusTool(server, ctx) {
     const client = () => getClient();
     server.tool('kg_status', '📊 项目速览仪表盘 — 一键了解项目健康。返回: 文档总数、目录数、活跃任务数、最近变更。每次对话开始建议首先调用', {}, async () => safeTool(async () => {
         const [docs, activeTasks] = await Promise.all([
@@ -20,7 +20,7 @@ export function registerStatusTool(server, projectId) {
             statusMap.set(s, (statusMap.get(s) || 0) + 1);
         }
         const lines = [
-            `📊 项目速览 [${projectId}]`,
+            `📊 项目速览 [${ctx.projectId}]`,
             ``,
             `📄 文档: ${docCount} 个 | 📁 目录: ${dirCount} 个`,
             `📝 活跃任务: ${activeTasks.length} 个`,

package/dist/tools/shared.d.ts

@@ -3,6 +3,13 @@
  * 合并原 helpers.ts + 新增 safeTool / withCross 模式
  */
 import type { DocData } from '../storage/types.js';
+/** 运行时可变上下文 — 所有工具通过引用获取最新值 */
+export interface McpContext {
+    projectId: string;
+    user: string;
+}
+/** 创建可变上下文对象 (工具闭包捕获此对象的引用，kg_init 更新其属性) */
+export declare function createContext(projectId: string, user: string): McpContext;
 export declare function wrap(text: string): {
     content: {
         type: "text";

package/dist/tools/shared.js

@@ -2,6 +2,10 @@
  * MCP 工具共享模块
  * 合并原 helpers.ts + 新增 safeTool / withCross 模式
  */
+/** 创建可变上下文对象 (工具闭包捕获此对象的引用，kg_init 更新其属性) */
+export function createContext(projectId, user) {
+    return { projectId, user };
+}
 // ==================== MCP 返回包装 ====================
 export function wrap(text) {
     return { content: [{ type: 'text', text }] };

package/dist/web/ui.js

@@ -111,7 +111,8 @@ function init(){
       var entry=items[i].webkitGetAsEntry&&items[i].webkitGetAsEntry();
       if(entry&&entry.isDirectory){
         go('add',{addStep:1,addDir:entry.name});
-        toast('📂 检测到 '+entry.name+'，可直接发送授权或补全路径');
+        toast('📂 检测到 '+entry.name+'，请补全绝对路径后发送授权');
+        setTimeout(function(){var inp=document.getElementById('iDir');if(inp){inp.focus();inp.setSelectionRange(0,0)}},150);
         return;
       }
     }
@@ -193,14 +194,14 @@ function renderAddStep1(){
   return '<span class="back" onclick="cancelAuth();go(\\x27list\\x27)">← 返回项目列表</span>'+
   '<div class="card no-hover"><div class="section"><h2>➕ 添加项目</h2>'+
   '<p style="font-size:13px;color:#64748b;margin-bottom:12px">点击发送授权，在主机端 PPDocs 应用中选择项目并批准</p>'+
-  '<div class="fg"><label>本地项目目录 (可选，MCP安装时需要)</label><input id="iDir" value="'+S.addDir+'" placeholder="(可选) D:/projects/my-app" oninput="S.addDir=this.value"></div>'+
+  '<div class="fg"><label>本地项目目录 (可选，MCP安装时需要)</label><input id="iDir" value="'+S.addDir+'" placeholder="Win: D:\\\\projects\\\\app  Mac: /Users/xxx/app" oninput="S.addDir=this.value"></div>'+
   '<div class="btn-row"><button class="btn btn-p" onclick="doAuthStart()">📡 发送授权请求</button></div>'+
   '</div></div>';
 }
 
 function doAuthStart(){
   var dir=(document.getElementById('iDir')?document.getElementById('iDir').value:'').trim();
-  if(dir&&!/^[A-Za-z]:[\\\\\\/]|^\\//.test(dir)){toast('路径需为绝对路径或留空','err');return}
+  if(dir&&!/^[A-Za-z]:[\\\\\\/]|^\\/|^~\//.test(dir)){toast('路径需为绝对路径(D:\\xxx 或 /Users/xxx)或留空','err');return}
   S.addDir=dir;
   api('/api/auth/start',{method:'POST',headers:{'Content-Type':'application/json'},body:JSON.stringify({localDir:dir||''})}).then(function(r){
     if(!r.ok){toast(r.error||'授权请求失败','err');return}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ppdocs/mcp",
-  "version": "3.2.7",
+  "version": "3.2.9",
   "description": "ppdocs MCP Server - Knowledge Graph for Claude",
   "type": "module",
   "main": "dist/index.js",