@ppdocs/mcp 3.2.11 → 3.2.12

package/dist/storage/httpClient.d.ts

@@ -84,7 +84,7 @@ export declare class PpdocsApiClient {
     /** 清空项目文件存储区 */
     clearFiles(): Promise<void>;
     /** 上传已打包好的 zip 数据到本项目 files/ (供 Code Beacon 使用) */
-    uploadRawZip(zipData: Buffer, remoteDir?: string): Promise<{
+    uploadRawZip(zipData: Buffer | Uint8Array | any, remoteDir?: string): Promise<{
         fileCount: number;
     }>;
     /** 跨项目: 列出文件 */

package/dist/storage/httpClient.js

@@ -457,7 +457,7 @@ export class PpdocsApiClient {
         const response = await fetch(`${this.baseUrl}/files${query}`, {
             method: 'POST',
             headers: { 'Content-Type': 'application/octet-stream' },
-            body: new Uint8Array(zipData),
+            body: Buffer.isBuffer(zipData) ? new Uint8Array(zipData) : zipData,
         });
         if (!response.ok) {
             const error = await response.json().catch(() => ({ error: response.statusText }));

package/dist/sync/beacon.js

@@ -141,7 +141,7 @@ export class SyncBeacon {
                 });
                 output.on('close', async () => {
                     try {
-                        const data = fs.readFileSync(tmpFile);
+                        const data = await fs.promises.readFile(tmpFile);
                         // [C2 修复] 使用本项目标准上传接口，而非 crossUploadFiles
                         await client.uploadRawZip(data);
                         console.error(`[Code Beacon] Snapshot synced: ${archive.pointer()} bytes`);
@@ -152,7 +152,7 @@ export class SyncBeacon {
                     finally {
                         try {
                             if (fs.existsSync(tmpFile))
-                                fs.unlinkSync(tmpFile);
+                                fs.promises.unlink(tmpFile);
                         }
                         catch { }
                         resolve();

package/dist/tools/analyzer.js

@@ -133,4 +133,131 @@ export function registerAnalyzerTools(server, projectId) {
         }
         return wrap(lines.join('\n'));
     }));
+    // ===== code_path: 两点间链路追踪 =====
+    server.tool('code_path', '🔗 两点链路追踪 — 给定两个符号(如 fileA.funcA 和 fileB.funcB)，自动搜索中间的引用链路，返回完整路径 + 绑定的知识图谱文档', {
+        projectPath: z.string().describe('项目源码的绝对路径'),
+        symbolA: z.string().describe('起点符号名(如 "handleLogin")'),
+        symbolB: z.string().describe('终点符号名(如 "AuthService")'),
+        maxDepth: z.number().optional().describe('最大搜索深度(1-5, 默认3)'),
+    }, async (args) => safeTool(async () => {
+        const depth = Math.min(5, Math.max(1, args.maxDepth ?? 3));
+        // 1. 获取两个符号的影响树
+        const [treeA, treeB] = await Promise.all([
+            client().analyzerImpactTree(args.projectPath, args.symbolA, depth),
+            client().analyzerImpactTree(args.projectPath, args.symbolB, depth),
+        ]);
+        if (!treeA)
+            return wrap(`❌ 未找到起点符号 "${args.symbolA}"。请确认名称正确且已运行 code_scan`);
+        if (!treeB)
+            return wrap(`❌ 未找到终点符号 "${args.symbolB}"。请确认名称正确且已运行 code_scan`);
+        const graphA = new Map(); // 从 A 出发可达的文件
+        const graphB = new Map(); // 从 B 出发可达的文件
+        const buildGraph = (tree, graph) => {
+            graph.set(tree.definedIn, []);
+            for (const level of tree.levels) {
+                for (const entry of level.entries) {
+                    if (!graph.has(entry.filePath))
+                        graph.set(entry.filePath, []);
+                    graph.get(entry.filePath).push({
+                        file: entry.filePath,
+                        line: entry.line,
+                        depth: level.depth,
+                        from: tree.symbolName,
+                    });
+                }
+            }
+        };
+        buildGraph(treeA, graphA);
+        buildGraph(treeB, graphB);
+        // 3. 查找交集: A 和 B 都能到达的文件
+        const intersection = [];
+        for (const [fileA] of graphA) {
+            if (graphB.has(fileA)) {
+                const refsA = graphA.get(fileA);
+                const refsB = graphB.get(fileA);
+                const minDepthA = refsA.length > 0 ? Math.min(...refsA.map(r => r.depth)) : 0;
+                const minDepthB = refsB.length > 0 ? Math.min(...refsB.map(r => r.depth)) : 0;
+                intersection.push({ file: fileA, depthFromA: minDepthA, depthFromB: minDepthB });
+            }
+        }
+        // 4. 尝试获取 KG 文档绑定
+        let docBindings = {};
+        try {
+            const docClient = client();
+            const allDocs = await docClient.listDocs();
+            for (const doc of allDocs) {
+                if (!doc.isDir && doc.summary) {
+                    docBindings[doc.name] = doc.summary;
+                }
+            }
+        }
+        catch { /* KG 不可用时忽略 */ }
+        // 5. 格式化输出
+        const lines = [
+            `🔗 两点链路追踪`,
+            ``,
+            `📍 起点: ${treeA.symbolName} (${treeA.symbolKind}) → ${treeA.definedIn}:${treeA.lineStart}`,
+            `📍 终点: ${treeB.symbolName} (${treeB.symbolKind}) → ${treeB.definedIn}:${treeB.lineStart}`,
+            ``,
+        ];
+        // 直接引用关系
+        if (treeA.definedIn === treeB.definedIn) {
+            lines.push(`✅ 两个符号定义在同一文件中！`);
+            lines.push('');
+        }
+        // 检查 A 的影响树是否直接包含 B 的文件
+        const directAtoB = graphA.has(treeB.definedIn);
+        const directBtoA = graphB.has(treeA.definedIn);
+        if (directAtoB || directBtoA) {
+            lines.push(`### ✅ 发现直接链路`);
+            if (directAtoB) {
+                const refs = graphA.get(treeB.definedIn);
+                lines.push(`  ${treeA.symbolName} → [L${refs[0]?.depth || 1}] → ${treeB.definedIn} (含 ${treeB.symbolName})`);
+            }
+            if (directBtoA) {
+                const refs = graphB.get(treeA.definedIn);
+                lines.push(`  ${treeB.symbolName} → [L${refs[0]?.depth || 1}] → ${treeA.definedIn} (含 ${treeA.symbolName})`);
+            }
+            lines.push('');
+        }
+        if (intersection.length > 0) {
+            // 按总深度排序
+            intersection.sort((a, b) => (a.depthFromA + a.depthFromB) - (b.depthFromA + b.depthFromB));
+            lines.push(`### 🔗 共经文件 (${intersection.length}个)`);
+            lines.push(`| 文件 | 距${treeA.symbolName} | 距${treeB.symbolName} | 📚 绑定文档 |`);
+            lines.push(`|:---|:---:|:---:|:---|`);
+            for (const node of intersection.slice(0, 20)) {
+                const fileName = node.file.split('/').pop() || node.file;
+                const docBind = docBindings[fileName] || '—';
+                lines.push(`| ${node.file} | L${node.depthFromA} | L${node.depthFromB} | ${docBind} |`);
+            }
+            if (intersection.length > 20) {
+                lines.push(`| ... | | | (还有 ${intersection.length - 20} 个) |`);
+            }
+            lines.push('');
+        }
+        else if (!directAtoB && !directBtoA) {
+            lines.push(`⚠️ 在 ${depth} 层深度内未发现 ${treeA.symbolName} 与 ${treeB.symbolName} 的引用链路`);
+            lines.push(`建议: 增加 maxDepth 参数(当前=${depth}, 最大=5) 重试`);
+            lines.push('');
+        }
+        // 附加: 各符号的影响概要
+        lines.push(`### 📊 影响概要`);
+        lines.push(`- ${treeA.symbolName}: ${treeA.summary}`);
+        lines.push(`- ${treeB.symbolName}: ${treeB.summary}`);
+        // 附加: 绑定的 KG 文档
+        const relevantDocs = [];
+        const symbolNames = [treeA.symbolName, treeB.symbolName];
+        for (const [docName, docSummary] of Object.entries(docBindings)) {
+            if (symbolNames.some(s => docName.toLowerCase().includes(s.toLowerCase()) || s.toLowerCase().includes(docName.toLowerCase()))) {
+                relevantDocs.push(`  📚 ${docName}: ${docSummary}`);
+            }
+        }
+        if (relevantDocs.length > 0) {
+            lines.push('');
+            lines.push(`### 📚 相关知识图谱文档`);
+            lines.push(...relevantDocs);
+        }
+        return wrap(lines.join('\n'));
+    }));
 }

package/dist/tools/index.d.ts

@@ -1,12 +1,12 @@
 /**
  * MCP 工具注册入口
- * 精简后: 13 个工具, 6 个子模块
+ * 精简后: 14 个工具, 6 个子模块
  *
  * 🔗 初始化:   kg_init                       (1个)
  * 📊 导航:     kg_status, kg_tree          (2个)
  * 📚 知识:     kg_doc, kg_projects, kg_rules (3个)
  * 📝 工作流:   kg_task, kg_files, kg_discuss (3个)
- * 🔬 代码分析: code_scan, code_query, code_impact, code_context (4个)
+ * 🔬 代码分析: code_scan, code_query, code_impact, code_context, code_path (5个)
  */
 import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 export declare function registerTools(server: McpServer, projectId: string, user: string, onProjectChange?: (newProjectId: string, newApiUrl: string) => void): void;

package/dist/tools/index.js

@@ -1,12 +1,12 @@
 /**
  * MCP 工具注册入口
- * 精简后: 13 个工具, 6 个子模块
+ * 精简后: 14 个工具, 6 个子模块
  *
  * 🔗 初始化:   kg_init                       (1个)
  * 📊 导航:     kg_status, kg_tree          (2个)
  * 📚 知识:     kg_doc, kg_projects, kg_rules (3个)
  * 📝 工作流:   kg_task, kg_files, kg_discuss (3个)
- * 🔬 代码分析: code_scan, code_query, code_impact, code_context (4个)
+ * 🔬 代码分析: code_scan, code_query, code_impact, code_context, code_path (5个)
  */
 import { createContext } from './shared.js';
 import { registerInitTool } from './init.js';

package/dist/web/server.js

@@ -333,11 +333,11 @@ export function startWebServer(webPort) {
             const json = await resp.json();
             const docs = json.data || [];
             if (docs.length === 0) {
-                res.json({ tree: '知识库为空', docCount: 0, dirCount: 0, readOnly });
+                res.json({ tree: '知识库为空', docs: [], docCount: 0, dirCount: 0, readOnly });
                 return;
             }
-            const lines = docs
-                .sort((a, b) => a.path.localeCompare(b.path))
+            const sortedDocs = docs.sort((a, b) => a.path.localeCompare(b.path));
+            const lines = sortedDocs
                 .map(d => {
                 const depth = (d.path.match(/\//g) || []).length;
                 const indent = '  '.repeat(Math.max(0, depth - 1));
@@ -345,14 +345,56 @@ export function startWebServer(webPort) {
                 const summary = d.summary ? ` — ${d.summary}` : '';
                 return `${indent}${icon} ${d.name}${summary}`;
             });
-            const docCount = docs.filter(d => !d.isDir).length;
-            const dirCount = docs.filter(d => d.isDir).length;
-            res.json({ tree: lines.join('\n'), docCount, dirCount, readOnly });
+            const docCount = sortedDocs.filter(d => !d.isDir).length;
+            const dirCount = sortedDocs.filter(d => d.isDir).length;
+            res.json({ tree: lines.join('\n'), docs: sortedDocs, docCount, dirCount, readOnly });
         }
         catch (e) {
             res.json({ tree: `连接失败: ${String(e).slice(0, 100)}` });
         }
     });
+    // GET /api/bind/:id/doc → 读取单篇文档内容
+    app.get('/api/bind/:id/doc', async (req, res) => {
+        const remoteId = req.params.id;
+        const docPath = req.query.path;
+        if (!docPath) {
+            res.json({ ok: false, error: '缺少 path 参数' });
+            return;
+        }
+        const config = loadAgentConfig();
+        const proj = config?.projects.find(p => p.remote.id === remoteId);
+        if (!config || !proj) {
+            res.json({ ok: false, error: '项目不存在' });
+            return;
+        }
+        let docUrl;
+        if (proj.remote.password) {
+            docUrl = `http://${config.host}:${config.port}/api/${proj.remote.id}/${proj.remote.password}/docs/${encodeURIComponent(docPath)}`;
+        }
+        else {
+            const proxy = config.projects.find(p => p.remote.id !== remoteId && p.remote.password);
+            if (proxy) {
+                docUrl = `http://${config.host}:${config.port}/api/${proxy.remote.id}/${proxy.remote.password}/cross/${remoteId}/docs/${encodeURIComponent(docPath)}`;
+            }
+            else {
+                res.json({ ok: false, error: '未授权' });
+                return;
+            }
+        }
+        try {
+            const resp = await fetch(docUrl);
+            if (!resp.ok) {
+                res.json({ ok: false, error: `HTTP ${resp.status}` });
+                return;
+            }
+            const json = await resp.json();
+            const d = json.data;
+            res.json({ ok: true, content: d?.content || '', summary: d?.summary || '', status: d?.status || '' });
+        }
+        catch (e) {
+            res.json({ ok: false, error: String(e).slice(0, 100) });
+        }
+    });
     // GET /api/bind/:id/prompts → 读取项目提示词文件
     app.get('/api/bind/:id/prompts', (req, res) => {
         const config = loadAgentConfig();

package/dist/web/ui.js

@@ -41,7 +41,25 @@ label{font-size:12px;color:#64748b;font-weight:500;display:block;margin-bottom:4
 .fg{margin-bottom:14px}
 .section{margin-bottom:20px}
 .section h2{font-size:14px;font-weight:600;color:#94a3b8;margin-bottom:12px;display:flex;align-items:center;gap:6px}
-.tree-box{background:rgba(15,23,42,.8);border:1px solid rgba(100,116,139,.2);border-radius:10px;padding:14px;font-family:'Cascadia Code','Fira Code',monospace;font-size:12px;color:#94a3b8;max-height:280px;overflow-y:auto;line-height:1.7;white-space:pre}
+.tree-box{background:rgba(15,23,42,.8);border:1px solid rgba(100,116,139,.2);border-radius:10px;padding:14px;font-size:13px;color:#94a3b8;max-height:400px;overflow-y:auto;line-height:1.4}
+.kg-search{width:100%;padding:8px 12px;margin-bottom:10px;background:rgba(15,23,42,.6);border:1px solid rgba(100,116,139,.2);border-radius:8px;color:#e0e6ed;font-size:13px;outline:none}
+.kg-search:focus{border-color:#60a5fa}
+.kg-stats{display:flex;gap:12px;font-size:12px;color:#64748b;margin-bottom:10px;padding:6px 10px;background:rgba(96,165,250,.06);border-radius:6px}
+.kg-stats span{display:inline-flex;align-items:center;gap:3px}
+.kg-node{padding:5px 8px;border-radius:6px;cursor:pointer;transition:all .15s;display:flex;align-items:center;gap:6px;margin:1px 0}
+.kg-node:hover{background:rgba(96,165,250,.1)}
+.kg-node .icon{font-size:14px;flex-shrink:0;width:18px;text-align:center}
+.kg-node .name{font-weight:500;color:#cbd5e1;font-size:13px;flex:1;overflow:hidden;text-overflow:ellipsis;white-space:nowrap}
+.kg-node .summary{font-size:11px;color:#64748b;margin-left:6px;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;max-width:200px}
+.kg-node.dir .name{color:#60a5fa;font-weight:600}
+.kg-node .arrow{font-size:10px;color:#475569;transition:transform .2s;width:14px;text-align:center;flex-shrink:0}
+.kg-node .arrow.open{transform:rotate(90deg)}
+.kg-children{margin-left:16px;border-left:1px solid rgba(100,116,139,.12);padding-left:4px}
+.kg-children.collapsed{display:none}
+.kg-empty{text-align:center;padding:24px;color:#475569;font-size:13px}
+.doc-modal-content{background:rgba(15,23,42,.9);border:1px solid rgba(100,116,139,.2);border-radius:8px;padding:14px;font-family:'Cascadia Code','Fira Code',monospace;font-size:12px;color:#94a3b8;max-height:50vh;overflow-y:auto;white-space:pre-wrap;line-height:1.6}
+.doc-modal-meta{display:flex;gap:12px;margin-bottom:12px;font-size:12px;color:#64748b}
+.doc-modal-meta span{padding:3px 8px;border-radius:6px;background:rgba(100,116,139,.1)}
 .platform-grid{display:grid;grid-template-columns:1fr 1fr;gap:8px}
 .platform-card{padding:14px;border-radius:10px;border:1px solid rgba(100,116,139,.2);text-align:center;transition:all .2s}
 .platform-card:hover{border-color:#a78bfa;background:rgba(167,139,250,.08)}
@@ -80,7 +98,7 @@ label{font-size:12px;color:#64748b;font-weight:500;display:block;margin-bottom:4
 <div class="toast" id="toast"></div>
 <script>
 // ============ State ============
-var S={host:'',port:20001,hostOk:false,projects:[],page:'list',addStep:1,addDir:'',detailIdx:-1,detailTab:'overview',mcpStatus:{},mcpAll:[],prompts:[],authRequestId:null,authStartTime:0,authStatus:'',authResult:null,modal:null};
+var S={host:'',port:20001,hostOk:false,projects:[],page:'list',addStep:1,addDir:'',detailIdx:-1,detailTab:'overview',mcpStatus:{},mcpAll:[],prompts:[],authRequestId:null,authStartTime:0,authStatus:'',authResult:null,modal:null,kgDocs:[],kgDocCount:0,kgDirCount:0,kgReadOnly:false,kgLoaded:false,kgFilter:'',kgCollapsed:{}};
 
 // ============ Router ============
 function go(page,data){Object.assign(S,data||{});S.page=page;_lastDetailRid=null;cancelAuth();render()}
@@ -108,8 +126,7 @@ function init(){
       var entry=items[i].webkitGetAsEntry&&items[i].webkitGetAsEntry();
       if(entry&&entry.isDirectory){
         go('add',{addStep:1,addDir:entry.name});
-        toast('📂 请补全绝对路径，例如 D:/projects/'+entry.name);
-        setTimeout(function(){var inp=document.getElementById('iDir');if(inp){inp.focus();inp.setSelectionRange(0,0)}},150);
+        toast('请补全绝对路径，例如 D:/projects/'+entry.name);
         return;
       }
     }
@@ -201,7 +218,8 @@ function renderAddStep1(){
 
 function doAuthStart(){
   var dir=document.getElementById('iDir').value.trim();
-  if(dir&&!/^[A-Za-z]:[\\\\\\/]|^\\//.test(dir)){toast('路径需为绝对路径(D:\\xxx 或 /Users/xxx)或留空','err');return}
+  if(!dir){toast('请填写目录路径','err');return}
+  if(!/^[A-Za-z]:[\\\\\\/]|^\\//.test(dir)){toast('请输入绝对路径','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}
@@ -296,15 +314,84 @@ function renderDetail(){
 function renderOverview(p){
   var authBadge=p.hasPassword?'<span class="auth-badge ok">✅ 已授权 (读写)</span>':'<span class="auth-badge no">⚠️ 未授权 (只读)</span>';
   var authBtn=p.hasPassword?'':'<button class="btn btn-p" style="font-size:12px;padding:5px 12px;margin-left:8px" onclick="doReAuth(\\x27'+p.remoteId+'\\x27,\\x27'+(p.localDir||'').replace(/\\\\/g,'/')+'\\x27)">📡 申请读写授权</button>';
-  return '<div class="card no-hover"><div class="section"><h2>📊 概览</h2>'+
+  var overviewCard='<div class="card no-hover"><div class="section"><h2>📊 概览</h2>'+
   '<div class="stat"><span>本地: '+(p.localDir||'<em style="color:#ef4444">未指定</em>')+'</span></div>'+
   '<div class="stat"><span>远程: '+p.remoteName+' ('+p.remoteId+')</span></div>'+
   '<div class="stat"><span>授权: '+authBadge+authBtn+'</span></div>'+
   '<div class="stat"><span>文档: '+(p.docCount||0)+' 个</span></div>'+
   '<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></div>';
+  // ---- 知识图谱树 ----
+  var kgCard='';
+  if(!S.kgLoaded){
+    kgCard='<div class="card no-hover"><div class="section"><h2>📚 知识图谱</h2><div class="kg-empty" style="animation:pulse 1.5s infinite">⏳ 加载中...</div></div></div>';
+  }else if(!S.kgDocs||S.kgDocs.length===0){
+    kgCard='<div class="card no-hover"><div class="section"><h2>📚 知识图谱</h2><div class="kg-empty">📭 知识库为空</div></div></div>';
+  }else{
+    var readOnlyBadge=S.kgReadOnly?'<span style="font-size:11px;color:#f59e0b;margin-left:8px">🔒 只读</span>':'';
+    var statsHtml='<div class="kg-stats"><span>📄 '+S.kgDocCount+' 文档</span><span>📁 '+S.kgDirCount+' 目录</span></div>';
+    var searchHtml='<input class="kg-search" placeholder="搜索文档..." value="'+S.kgFilter+'" oninput="S.kgFilter=this.value;_render()">';
+    var treeHtml=renderKgTree(S.kgDocs,p.remoteId,'',0);
+    kgCard='<div class="card no-hover"><div class="section"><h2>📚 知识图谱'+readOnlyBadge+'</h2>'+statsHtml+'<div class="tree-box">'+searchHtml+treeHtml+'</div></div></div>';
+  }
+  return overviewCard+kgCard;
+}
+
+function esc(s){return s?s.replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;').replace(/"/g,'&quot;'):''}
+function renderKgTree(docs,rid,parentPath,depth){
+  var filter=S.kgFilter?S.kgFilter.toLowerCase():'';
+  // 获取当前层级的直接子节点
+  var children=docs.filter(function(d){
+    // 直接子级: 路径以 parentPath 开头, 且去掉 parentPath 后只剩一级
+    if(parentPath===''){
+      var parts=d.path.split('/').filter(Boolean);
+      return parts.length===1;
+    }
+    if(d.path.indexOf(parentPath+'/')!==0) return false;
+    var rest=d.path.slice(parentPath.length+1);
+    return rest.indexOf('/')===-1;
+  });
+  if(filter){
+    children=children.filter(function(d){
+      if(d.name.toLowerCase().indexOf(filter)>=0) return true;
+      if(d.summary&&d.summary.toLowerCase().indexOf(filter)>=0) return true;
+      // 目录: 检查子孙是否匹配
+      if(d.isDir) return docs.some(function(dd){ return dd.path.indexOf(d.path+'/')===0&&(dd.name.toLowerCase().indexOf(filter)>=0||(dd.summary&&dd.summary.toLowerCase().indexOf(filter)>=0)); });
+      return false;
+    });
+  }
+  if(children.length===0) return depth===0?'<div class="kg-empty">无匹配结果</div>':'';
+  var html='';
+  children.sort(function(a,b){ if(a.isDir!==b.isDir) return a.isDir?-1:1; return a.name.localeCompare(b.name); });
+  children.forEach(function(d){
+    var collapsed=S.kgCollapsed[d.path];
+    if(d.isDir){
+      var arrowCls=collapsed?'arrow':'arrow open';
+      // 计算子文档数
+      var subCount=docs.filter(function(dd){return !dd.isDir&&dd.path.indexOf(d.path+'/')===0}).length;
+      var badge=subCount>0?'<span style="font-size:10px;color:#475569;margin-left:4px">('+subCount+')</span>':'';
+      html+='<div class="kg-node dir" onclick="toggleKgDir(\\x27'+d.path.replace(/'/g,"\\x27")+'\\x27)">';
+      html+='<span class="'+arrowCls+'">▶</span>';
+      html+='<span class="icon">📁</span>';
+      html+='<span class="name">'+esc(d.name)+badge+'</span>';
+      html+='</div>';
+      var childHtml=renderKgTree(docs,rid,d.path,depth+1);
+      html+='<div class="kg-children'+(collapsed?' collapsed':'')+'">'+(childHtml||'')+'</div>';
+    }else{
+      var sum=d.summary?'<span class="summary">'+esc(d.summary)+'</span>':'';
+      html+='<div class="kg-node" onclick="doViewDoc(\\x27'+rid+'\\x27,\\x27'+d.path.replace(/'/g,"\\x27")+'\\x27)">';
+      html+='<span class="arrow" style="visibility:hidden">▶</span>';
+      html+='<span class="icon">📄</span>';
+      html+='<span class="name">'+esc(d.name)+'</span>'+sum;
+      html+='</div>';
+    }
+  });
+  return html;
+}
+
+function toggleKgDir(path){
+  S.kgCollapsed[path]=!S.kgCollapsed[path];
+  _render();
 }
 
 function renderMcpTab(p){
@@ -359,13 +446,40 @@ function renderPromptsTab(p){
   return '<div class="card no-hover"><div class="section"><h2>📝 系统提示词</h2>'+(cards||'<div style="font-size:12px;color:#475569">加载中...</div>')+'</div></div>';
 }
 
+// ============ Doc Viewer ============
+function doViewDoc(rid,docPath){
+  api('/api/bind/'+rid+'/doc?path='+encodeURIComponent(docPath)).then(function(r){
+    if(!r.ok){toast(r.error||'读取失败','err');return}
+    var name=esc(docPath.split('/').pop()||docPath);
+    var meta='';
+    if(r.summary||r.status){
+      meta='<div class="doc-modal-meta">';
+      if(r.status) meta+='<span>状态: '+r.status+'</span>';
+      if(r.summary) meta+='<span>'+r.summary+'</span>';
+      meta+='</div>';
+    }
+    var escaped=(r.content||'暂无内容').replace(/&/g,'&amp;').replace(/</g,'&lt;').replace(/>/g,'&gt;');
+    var div=document.createElement('div');div.className='modal-bg';
+    div.innerHTML='<div class="modal" style="max-width:650px"><h3>📄 '+name+'</h3>'+
+      '<div style="font-size:11px;color:#475569;margin:-12px 0 12px">'+docPath+'</div>'+
+      meta+
+      '<div class="doc-modal-content">'+escaped+'</div>'+
+      '<div class="btn-row" style="margin-top:12px"><button class="btn btn-s" onclick="this.closest(\\x27.modal-bg\\x27).remove()">关闭</button></div></div>';
+    document.body.appendChild(div);
+    div.addEventListener('click',function(e){if(e.target===div)div.remove()});
+  });
+}
+
 // ============ Data Loading ============
 function loadTree(rid){
-  var box=document.getElementById('treeBox');if(!box)return Promise.resolve();
+  S.kgLoaded=false;
   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});
+    S.kgDocs=r.docs||[];
+    S.kgDocCount=r.docCount||0;
+    S.kgDirCount=r.dirCount||0;
+    S.kgReadOnly=!!r.readOnly;
+    S.kgLoaded=true;
+  }).catch(function(e){S.kgDocs=[];S.kgLoaded=true;console.error('loadTree:',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=[]})}

package/package.json

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