@ppdocs/mcp 3.2.9 → 3.2.11

package/dist/tools/discussion.d.ts

@@ -4,4 +4,5 @@
  *       kg_discussion_reply, kg_discussion_close_and_archive, kg_discussion_delete
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerDiscussionTools(server: McpServer, projectId: string): void;
+import { type McpContext } from './shared.js';
+export declare function registerDiscussionTools(server: McpServer, ctx: McpContext): void;

package/dist/tools/discussion.js

@@ -8,7 +8,7 @@ import { getClient } from '../storage/httpClient.js';
 import { decodeObjectStrings } from '../utils.js';
 import { wrap, safeTool } from './shared.js';
 import { DiscussionManager } from '../storage/discussion.js';
-export function registerDiscussionTools(server, projectId) {
+export function registerDiscussionTools(server, ctx) {
     const client = () => getClient();
     server.tool('kg_discuss', '💬 跨项目讨论 — 发起、回复、归档协同讨论。action: list(列出活跃讨论)|read(读取详情)|create(发起)|reply(回复)|close(结案归档)|delete(删除)', {
         action: z.enum(['list', 'read', 'create', 'reply', 'close', 'delete'])
@@ -35,8 +35,8 @@ export function registerDiscussionTools(server, projectId) {
                 const active = DiscussionManager.listActive();
                 const cleanMsg = cleaned > 0 ? `\n⚠️ 已自动清理 ${cleaned} 条超过7天不活跃的讨论` : '';
                 if (active.length === 0)
-                    return wrap(`当前无活跃的讨论 (本项目ID: ${projectId})${cleanMsg}`);
-                return wrap(`本项目ID: ${projectId}\n活跃讨论区 (${active.length} 个):${cleanMsg}\n\n` + JSON.stringify(active, null, 2));
+                    return wrap(`当前无活跃的讨论 (本项目ID: ${ctx.projectId})${cleanMsg}`);
+                return wrap(`本项目ID: ${ctx.projectId}\n活跃讨论区 (${active.length} 个):${cleanMsg}\n\n` + JSON.stringify(active, null, 2));
             }
             case 'read': {
                 const readIds = decoded.ids || (decoded.id ? [decoded.id] : []);
@@ -57,15 +57,15 @@ export function registerDiscussionTools(server, projectId) {
                 const count = DiscussionManager.activeCount();
                 if (count >= 10)
                     return wrap('❌ 活跃讨论已达上限(10条)');
-                const id = DiscussionManager.create(decoded.title, projectId, decoded.participants, decoded.content);
-                return wrap(`✅ 讨论已发起，ID: ${id}\n发起方: ${projectId}\n参与方: ${decoded.participants.join(', ')}`);
+                const id = DiscussionManager.create(decoded.title, ctx.projectId, decoded.participants, decoded.content);
+                return wrap(`✅ 讨论已发起，ID: ${id}\n发起方: ${ctx.projectId}\n参与方: ${decoded.participants.join(', ')}`);
             }
             case 'reply': {
                 if (!decoded.id)
                     return wrap('❌ reply 需要 id');
                 if (!decoded.content)
                     return wrap('❌ reply 需要 content');
-                const success = DiscussionManager.reply(decoded.id, projectId, decoded.content, decoded.newSummary);
+                const success = DiscussionManager.reply(decoded.id, ctx.projectId, decoded.content, decoded.newSummary);
                 return wrap(success ? `✅ 回复成功 (ID: ${decoded.id})` : `❌ 回复失败，讨论不存在或已关闭`);
             }
             case 'close': {

package/dist/tools/index.js

@@ -27,12 +27,12 @@ export function registerTools(server, projectId, user, onProjectChange) {
     registerStatusTool(server, ctx);
     // 📚 知识 (kg_doc + kg_tree + kg_projects + kg_rules)
     registerDocTools(server, ctx.projectId);
-    registerProjectTools(server, ctx.projectId);
-    registerRuleTools(server, ctx.projectId);
+    registerProjectTools(server, ctx);
+    registerRuleTools(server, ctx);
     // 📝 工作流 (kg_task + kg_files + kg_discuss)
     registerTaskTools(server, ctx.projectId, ctx.user);
     registerFileTools(server);
-    registerDiscussionTools(server, ctx.projectId);
+    registerDiscussionTools(server, ctx);
     // 🔬 代码分析 (不变)
     registerAnalyzerTools(server, ctx.projectId);
 }

package/dist/tools/projects.d.ts

@@ -4,4 +4,5 @@
  * 删除: kg_create_project (桌面端操作)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerProjectTools(server: McpServer, projectId: string): void;
+import { type McpContext } from './shared.js';
+export declare function registerProjectTools(server: McpServer, ctx: McpContext): void;

package/dist/tools/projects.js

@@ -5,14 +5,14 @@
  */
 import { getClient } from '../storage/httpClient.js';
 import { wrap, safeTool } from './shared.js';
-export function registerProjectTools(server, projectId) {
+export function registerProjectTools(server, ctx) {
     const client = () => getClient();
     server.tool('kg_projects', '📋 列出所有可访问的项目(返回名称和ID)。跨项目操作的第一步: 获取项目ID后用于其他工具的 targetProject 参数', {}, async () => safeTool(async () => {
         const projects = await client().crossListProjects();
         if (projects.length === 0)
             return wrap('暂无可访问的项目');
         const lines = projects.map(p => {
-            const isCurrent = p.id === projectId ? ' ★当前' : '';
+            const isCurrent = p.id === ctx.projectId ? ' ★当前' : '';
             return `- ${p.name} (${p.id})${isCurrent}`;
         });
         return wrap(`可访问的项目 (${projects.length} 个):\n\n${lines.join('\n')}`);

package/dist/tools/rules.d.ts

@@ -4,4 +4,5 @@
  * 删除: kg_get_global_rules_meta, kg_save_global_rules_meta (管理员操作)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-export declare function registerRuleTools(server: McpServer, projectId: string): void;
+import { type McpContext } from './shared.js';
+export declare function registerRuleTools(server: McpServer, ctx: McpContext): void;

package/dist/tools/rules.js

@@ -7,7 +7,7 @@ import { z } from 'zod';
 import { getClient } from '../storage/httpClient.js';
 import { decodeObjectStrings, getRules, RULE_TYPE_LABELS } from '../utils.js';
 import { wrap, safeTool, crossPrefix } from './shared.js';
-export function registerRuleTools(server, projectId) {
+export function registerRuleTools(server, ctx) {
     const client = () => getClient();
     server.tool('kg_rules', '📏 项目规则管理 — 读取或保存代码风格、审查规则等。action: get(读取规则)|save(保存规则)|get_meta(读取触发配置)|save_meta(保存触发配置)', {
         action: z.enum(['get', 'save', 'get_meta', 'save_meta'])
@@ -51,7 +51,7 @@ export function registerRuleTools(server, projectId) {
                         return wrap(`暂无项目规则(项目: ${decoded.targetProject})`);
                     return wrap(`${crossPrefix(decoded.targetProject)}${allRules.join('\n\n')}`);
                 }
-                const rules = await getRules(projectId, decoded.ruleType || undefined);
+                const rules = await getRules(ctx.projectId, decoded.ruleType || undefined);
                 if (!rules || rules.trim() === '') {
                     const meta = await client().getRulesMeta();
                     const typeName = decoded.ruleType ? (meta[decoded.ruleType]?.label || decoded.ruleType) : '项目';

package/dist/web/ui.js

@@ -74,9 +74,6 @@ label{font-size:12px;color:#64748b;font-weight:500;display:block;margin-bottom:4
 .tab.active{color:#60a5fa;border-color:#60a5fa}
 @keyframes pulse{0%,100%{opacity:1}50%{opacity:.4}}
 </style>
-<meta http-equiv="Cache-Control" content="no-cache, no-store, must-revalidate">
-<meta http-equiv="Pragma" content="no-cache">
-<meta http-equiv="Expires" content="0">
 </head>
 <body>
 <div class="app" id="app"></div>
@@ -92,7 +89,7 @@ function go(page,data){Object.assign(S,data||{});S.page=page;_lastDetailRid=null
 function toast(m,t){t=t||'ok';var e=document.getElementById('toast');e.textContent=m;e.className='toast '+t+' show';setTimeout(function(){e.className='toast'},3000)}
 
 // ============ API ============
-function api(path,opts){return fetch(path,opts).then(function(r){return r.json()}).then(function(d){console.log('[api]',path,d);return d})}
+function api(path,opts){return fetch(path,opts).then(function(r){return r.json()})}
 
 // ============ Init ============
 function init(){
@@ -111,7 +108,7 @@ 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('📂 请补全绝对路径，例如 D:/projects/'+entry.name);
         setTimeout(function(){var inp=document.getElementById('iDir');if(inp){inp.focus();inp.setSelectionRange(0,0)}},150);
         return;
       }
@@ -191,19 +188,22 @@ function renderAdd(){
 }
 
 function renderAddStep1(){
+  var dirName=S.addDir?S.addDir.replace(/\\\\/g,'/').split('/').filter(Boolean).pop():'';
+  var namePreview=dirName?'<div style="font-size:12px;color:#60a5fa;margin:-8px 0 12px">📂 项目名: <strong>'+dirName+'</strong></div>':'';
   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="Win: D:\\\\projects\\\\app  Mac: /Users/xxx/app" oninput="S.addDir=this.value"></div>'+
+  '<div class="card no-hover"><div class="section"><h2>➕ 添加项目 — Step 1/2</h2>'+
+  '<p style="font-size:13px;color:#64748b;margin-bottom:12px">指定本地项目目录，以目录名作为项目名称</p>'+
+  '<div class="fg"><label>本地项目目录 (绝对路径)</label><input id="iDir" value="'+S.addDir+'" placeholder="例: D:/projects/my-app" oninput="S.addDir=this.value;_render()"></div>'+
+  namePreview+
   '<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('路径需为绝对路径(D:\\xxx 或 /Users/xxx)或留空','err');return}
+  var dir=document.getElementById('iDir').value.trim();
+  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){
+  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}
     S.authRequestId=r.requestId;S.authStartTime=Date.now();S.authStatus='pending';S.addStep=2;
     render();startAuthPoll();
@@ -304,7 +304,7 @@ function renderOverview(p){
   '<div class="stat"><span>同步: '+(p.connected?'🟢 运行中':'🔴 '+p.syncStatus)+' '+(p.lastSync?'('+p.lastSync+')':'')+'</span></div>'+
   '</div></div>'+
   '<div class="card no-hover"><div class="section"><h2>📚 知识图谱</h2>'+
-  '<div class="tree-box" id="treeBox">加载中 ...</div></div></div>';
+  '<div class="tree-box" id="treeBox">加载中...</div></div></div>';
 }
 
 function renderMcpTab(p){
@@ -361,22 +361,11 @@ function renderPromptsTab(p){
 
 // ============ Data Loading ============
 function loadTree(rid){
-  var box=document.getElementById('treeBox');
-  if(!box) return;
-  var xhr=new XMLHttpRequest();
-  xhr.open('GET','/api/bind/'+rid+'/tree?_='+Date.now(),true);
-  xhr.onload=function(){
-    try{
-      var r=JSON.parse(xhr.responseText);
-      var txt=r.tree||'知识库为空';
-      var NL=String.fromCharCode(10);
-      if(r.docCount>0) txt='共 '+r.docCount+' 文档, '+r.dirCount+' 目录'+NL+NL+txt;
-      if(r.readOnly) txt='🔒 只读模式'+NL+NL+txt;
-      box.textContent=txt;
-    }catch(e){box.textContent='解析失败: '+e}
-  };
-  xhr.onerror=function(){box.textContent='请求失败'};
-  xhr.send();
+  var box=document.getElementById('treeBox');if(!box)return Promise.resolve();
+  return api('/api/bind/'+rid+'/tree').then(function(r){
+    var prefix=r.readOnly?'🔒 只读模式\\n\\n':'';
+    box.textContent=r.tree?(prefix+(r.docCount>0?'共 '+r.docCount+' 文档, '+r.dirCount+' 目录\\n\\n':'')+r.tree):'知识库为空';
+  }).catch(function(e){box.textContent='加载失败: '+e});
 }
 function loadMcpStatus(rid){return api('/api/bind/'+rid+'/mcp').then(function(r){S.mcpStatus=r.platforms||{}}).catch(function(){S.mcpStatus={}})}
 function loadMcpAll(rid){return api('/api/bind/'+rid+'/mcp/all').then(function(r){S.mcpAll=r.servers||[]}).catch(function(){S.mcpAll=[]})}
@@ -469,11 +458,7 @@ render=function(){
   var _rid=S.projects[S.detailIdx]?S.projects[S.detailIdx].remoteId:null;
   if(S.page==='detail'&&_rid&&!_detailLoading&&_lastDetailRid!==_rid){
     _detailLoading=true;_lastDetailRid=_rid;
-    loadMcpStatus(_rid);loadMcpAll(_rid);loadPrompts(_rid);
-    setTimeout(function(){
-      _detailLoading=false;
-      loadTree(_rid);
-    },100);
+    Promise.all([loadTree(_rid),loadMcpStatus(_rid),loadMcpAll(_rid),loadPrompts(_rid)]).then(function(){_detailLoading=false;_render()}).catch(function(){_detailLoading=false});
   }
 };
 setInterval(function(){

package/package.json

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