@ppdocs/mcp 3.2.14 → 3.2.16

package/dist/cli.js

@@ -90,7 +90,7 @@ ppdocs MCP CLI
 
 Commands:
   init    Initialize ppdocs config + install workflow templates
-  agent   Start PPDocs Agent (Web UI + File Sync)
+  webui   Start PPDocs Web UI (MCP management + File Sync)
 
 Usage:
   npx @ppdocs/mcp init -p <projectId> -k <key> [options]
@@ -124,8 +124,8 @@ export async function runCli(args) {
         await initProject(opts);
         return 'exit';
     }
-    if (cmd === 'agent' || cmd === 'webui') {
-        // 动态导入 Agent 入口 (Web UI + 多项目管理) — 长驻进程，不退出
+    if (cmd === 'webui') {
+        // 动态导入 WebUI 入口 (Web UI + 多项目管理) — 长驻进程，不退出
         await import('./agent.js');
         return 'keep-alive';
     }

package/dist/index.js

@@ -26,9 +26,11 @@ if (args.length > 0) {
     if (result === 'exit')
         process.exit(0);
     if (result === 'keep-alive') {
-        // agent/webui 长驻模式，不继续执行 MCP Server
-        // @ts-ignore: 阻止后续 main() 执行
-        await new Promise(() => { }); // 永不 resolve，进程由 agent.ts 的 HTTP 服务保活
+        // webui 长驻模式，不继续执行 MCP Server
+        // 用 setInterval 保活，避免 Node.js 'unsettled top-level await' 警告
+        setInterval(() => { }, 1 << 30);
+        // @ts-ignore: 防止后续 main() 执行
+        await new Promise(() => { });
     }
     // result === false → 继续作为 MCP Server
 }

package/dist/web/server.js

@@ -158,6 +158,100 @@ export function startWebServer(webPort) {
             res.json({ projects: [] });
         }
     });
+    // GET /api/browse → 服务端目录浏览 (供前端目录选择器使用)
+    app.get('/api/browse', (req, res) => {
+        const dir = req.query.dir || '';
+        try {
+            // 无参数时返回根级入口
+            if (!dir) {
+                const home = os.homedir();
+                // 常用快捷入口
+                const shortcuts = [];
+                const desktop = path.join(home, 'Desktop');
+                if (fs.existsSync(desktop))
+                    shortcuts.push({ name: '🖥️ 桌面 (Desktop)', path: desktop });
+                shortcuts.push({ name: '🏠 用户目录', path: home });
+                if (process.platform === 'darwin') {
+                    const dev = path.join(home, 'Developer');
+                    const docs = path.join(home, 'Documents');
+                    if (fs.existsSync(dev))
+                        shortcuts.push({ name: '💻 Developer', path: dev });
+                    if (fs.existsSync(docs))
+                        shortcuts.push({ name: '📄 Documents', path: docs });
+                }
+                if (process.platform === 'win32') {
+                    // Windows: 列出盘符
+                    const drives = [];
+                    for (let i = 65; i <= 90; i++) {
+                        const d = String.fromCharCode(i) + ':\\';
+                        try {
+                            fs.accessSync(d);
+                            drives.push(d);
+                        }
+                        catch { /* skip */ }
+                    }
+                    res.json({ ok: true, dir: '', dirs: drives, shortcuts, platform: 'win32' });
+                }
+                else {
+                    // Mac/Linux: 列出 home 下的子目录
+                    try {
+                        const homeDirs = fs.readdirSync(home, { withFileTypes: true })
+                            .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+                            .slice(0, 20)
+                            .map(e => path.join(home, e.name));
+                        res.json({ ok: true, dir: home, dirs: homeDirs, shortcuts, platform: process.platform });
+                    }
+                    catch {
+                        res.json({ ok: true, dir: '', dirs: [home], shortcuts, platform: process.platform });
+                    }
+                }
+                return;
+            }
+            // 列出指定目录的子目录
+            if (!fs.existsSync(dir)) {
+                res.json({ ok: false, error: '目录不存在' });
+                return;
+            }
+            const entries = fs.readdirSync(dir, { withFileTypes: true })
+                .filter(e => e.isDirectory() && !e.name.startsWith('.'))
+                .sort((a, b) => a.name.localeCompare(b.name))
+                .slice(0, 100)
+                .map(e => path.join(dir, e.name));
+            res.json({ ok: true, dir, dirs: entries, platform: process.platform });
+        }
+        catch (e) {
+            res.json({ ok: false, error: String(e).slice(0, 100) });
+        }
+    });
+    // GET /api/pick-dir → 调用系统原生目录选择器
+    app.get('/api/pick-dir', async (_req, res) => {
+        try {
+            let cmd;
+            if (process.platform === 'win32') {
+                // Windows: PowerShell FolderBrowserDialog
+                cmd = `powershell -NoProfile -Command "Add-Type -AssemblyName System.Windows.Forms; $d=New-Object System.Windows.Forms.FolderBrowserDialog; $d.Description='选择项目目录'; $d.ShowNewFolderButton=$true; if($d.ShowDialog() -eq 'OK'){$d.SelectedPath}else{''}"`;
+            }
+            else if (process.platform === 'darwin') {
+                // Mac: osascript choose folder
+                cmd = `osascript -e 'try' -e 'POSIX path of (choose folder with prompt "选择项目目录")' -e 'on error' -e '""' -e 'end try'`;
+            }
+            else {
+                // Linux: zenity
+                cmd = `zenity --file-selection --directory --title="选择项目目录" 2>/dev/null || echo ""`;
+            }
+            const { execSync } = await import('child_process');
+            const result = execSync(cmd, { encoding: 'utf-8', timeout: 120000 }).trim();
+            if (result) {
+                res.json({ ok: true, dir: result });
+            }
+            else {
+                res.json({ ok: false, cancelled: true });
+            }
+        }
+        catch {
+            res.json({ ok: false, error: '目录选择器调用失败' });
+        }
+    });
     // ============ 服务端授权流程 ============
     // POST /api/auth/start → 发起授权请求 (代理转发到主机)
     app.post('/api/auth/start', async (req, res) => {

package/dist/web/ui.js

@@ -91,6 +91,11 @@ label{font-size:12px;color:#64748b;font-weight:500;display:block;margin-bottom:4
 .tab{padding:8px 16px;font-size:13px;font-weight:600;color:#64748b;cursor:pointer;border-bottom:2px solid transparent;transition:all .2s}
 .tab.active{color:#60a5fa;border-color:#60a5fa}
 @keyframes pulse{0%,100%{opacity:1}50%{opacity:.4}}
+.dir-picker-list{max-height:50vh;overflow-y:auto}
+.dir-item{padding:8px 12px;border-radius:6px;cursor:pointer;font-size:13px;color:#cbd5e1;display:flex;align-items:center;gap:8px;transition:background .15s}
+.dir-item:hover{background:rgba(96,165,250,.12)}
+.dir-item .icon{font-size:16px}
+.dir-breadcrumb{font-size:12px;color:#64748b;padding:6px 10px;background:rgba(15,23,42,.6);border-radius:6px;margin-bottom:10px;word-break:break-all}
 </style>
 </head>
 <body>
@@ -210,12 +215,61 @@ function renderAddStep1(){
   return '<span class="back" onclick="cancelAuth();go(\\x27list\\x27)">← 返回项目列表</span>'+
   '<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>'+
+  '<div class="fg"><label>本地项目目录 (绝对路径)</label><div style="display:flex;gap:8px"><input id="iDir" style="flex:1" value="'+S.addDir+'" placeholder="例: /Users/me/projects/my-app" oninput="S.addDir=this.value;_render()"><button class="btn btn-p" style="white-space:nowrap;padding:6px 14px" onclick="nativePickDir()">📁 选择目录</button></div></div>'+
   namePreview+
   '<div class="btn-row"><button class="btn btn-p" onclick="doAuthStart()">📡 发送授权请求</button></div>'+
   '</div></div>';
 }
 
+function nativePickDir(){
+  toast('正在打开系统目录选择器...');
+  api('/api/pick-dir').then(function(r){
+    if(r.ok&&r.dir){S.addDir=r.dir;_render();toast('✅ 已选择: '+r.dir);}
+    else if(r.cancelled){toast('已取消');}
+    else{toast('系统选择器不可用，使用内置浏览器','err');openDirPicker();}
+  }).catch(function(){openDirPicker();});
+}
+
+function openDirPicker(){
+  var currentDir='';
+  function browse(d){
+    api('/api/browse'+(d?'?dir='+encodeURIComponent(d):'')).then(function(r){
+      if(!r.ok){toast(r.error||'浏览失败','err');return}
+      currentDir=r.dir||'';
+      var dirs=r.dirs||[];
+      var shortcuts=r.shortcuts||[];
+      var sep=r.platform==='win32'?'\\\\':'/';
+      var html='<div class="dir-breadcrumb">📍 '+(currentDir||'根目录')+'</div>';
+      if(!currentDir&&shortcuts.length>0){
+        for(var s=0;s<shortcuts.length;s++){var sp=shortcuts[s].path.replace(/\\\\/g,'\\\\\\\\').replace(/'/g,"\\\\'");html+='<div class="dir-item" style="color:#60a5fa" onclick="dirPickerNav(\\x27'+sp+'\\x27)"><span class="icon">⚡</span> '+esc(shortcuts[s].name)+'</div>';}
+        html+='<div style="margin:8px 0;border-top:1px solid rgba(100,116,139,.2)"></div>';
+      }
+      if(currentDir){
+        var parts=currentDir.replace(/\\\\/g,'/').split('/').filter(Boolean);
+        var parent=parts.length>1?parts.slice(0,-1).join(sep):(r.platform==='win32'?'':'/');
+        if(r.platform==='win32'&&parts.length===1)parent='';
+        html+='<div class="dir-item" onclick="dirPickerNav(\\x27'+parent.replace(/\\\\/g,'\\\\\\\\').replace(/'/g,"\\\\x27")+'\\x27)"><span class="icon">⬆️</span> .. 上级目录</div>';
+        html+='<div class="dir-item" style="background:rgba(96,165,250,.15);border:1px solid rgba(96,165,250,.3)" onclick="dirPickerSelect(\\x27'+currentDir.replace(/\\\\/g,'\\\\\\\\').replace(/'/g,"\\\\x27")+'\\x27)"><span class="icon">✅</span> <strong>选择当前目录</strong></div>';
+      }
+      for(var i=0;i<dirs.length;i++){
+        var dn=dirs[i].replace(/\\\\/g,'/').split('/').filter(Boolean).pop();
+        html+='<div class="dir-item" onclick="dirPickerNav(\\x27'+dirs[i].replace(/\\\\/g,'\\\\\\\\').replace(/'/g,"\\\\x27")+'\\x27)"><span class="icon">📁</span> '+esc(dn)+'</div>';
+      }
+      if(dirs.length===0&&currentDir){html+='<div style="padding:12px;color:#475569;font-size:13px">（空目录）</div>';}
+      var el=document.getElementById('dirPickerBody');
+      if(el)el.innerHTML=html;
+    });
+  }
+  window.dirPickerNav=function(d){browse(d)};
+  window.dirPickerSelect=function(d){
+    S.addDir=d;var bg=document.querySelector('.modal-bg');if(bg)bg.remove();_render();
+  };
+  var div=document.createElement('div');div.className='modal-bg';
+  div.innerHTML='<div class="modal" style="max-width:550px"><h3>📁 选择项目目录</h3><div class="dir-picker-list" id="dirPickerBody"><div style="padding:20px;color:#64748b">加载中...</div></div><div class="btn-row"><button class="btn btn-s" onclick="closeModal()">取消</button></div></div>';
+  document.body.appendChild(div);div.addEventListener('click',function(e){if(e.target===div)div.remove()});
+  browse('');
+}
+
 function doAuthStart(){
   var dir=document.getElementById('iDir').value.trim();
   if(!dir){toast('请填写目录路径','err');return}

package/package.json

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