@ppdocs/mcp 2.6.7 → 2.6.9

package/README.md

@@ -109,10 +109,9 @@ npx @ppdocs/mcp init -p <projectId> -k <key> --codex
 | `kg_update_node` | 更新节点内容 |
 | `kg_delete_node` | 删除节点 |
 | `kg_lock_node` | 锁定节点 (AI 只能锁定，解锁需前端手动) |
-| `kg_list_nodes` | 列出所有节点 |
+| `kg_list_nodes` | 列出节点 (支持 status/edges 过滤，maxEdges=0 查孤立节点) |
 | `kg_search` | 关键词搜索 |
 | `kg_find_path` | 查找依赖路径 |
-| `kg_find_orphans` | 查找孤立节点 |
 | `kg_get_relations` | 获取节点关系 |
 
 ### 任务管理工具
@@ -175,6 +174,10 @@ npx @ppdocs/mcp init -p <projectId> -k <key> --codex
 
 ## 更新日志
 
+### v2.6.9
+- ✨ `kg_list_nodes` 支持 status/minEdges/maxEdges 过滤
+- 🗑️ 移除 `kg_find_orphans` (用 `kg_list_nodes(maxEdges: 0)` 替代)
+
 ### v2.5.0
 - ✨ 新增 CLI init 命令，自动安装工作流模板
 - ✨ 支持 Codex 模式 (--codex)

package/dist/cli.js

@@ -242,7 +242,6 @@ function generateHooksConfig() {
         hooks: {
             UserPromptSubmit: [
                 {
-                    matcher: '*',
                     hooks: [{ type: 'command', command }]
                 }
             ]
@@ -266,12 +265,12 @@ function installClaudeTemplates(cwd) {
         copyDirRecursive(srcHooks, destHooks);
         console.log(`✅ Installed .claude/hooks/`);
     }
-    // 3. 生成跨平台 hooks 配置并合并到 settings.local.json
-    const settingsLocalPath = path.join(claudeDir, 'settings.local.json');
+    // 3. 生成跨平台 hooks 配置并合并到 settings.json (hooks 必须在 settings.json 才能生效)
+    const settingsPath = path.join(claudeDir, 'settings.json');
     let existingSettings = {};
-    if (fs.existsSync(settingsLocalPath)) {
+    if (fs.existsSync(settingsPath)) {
         try {
-            existingSettings = JSON.parse(fs.readFileSync(settingsLocalPath, 'utf-8'));
+            existingSettings = JSON.parse(fs.readFileSync(settingsPath, 'utf-8'));
         }
         catch { /* ignore */ }
     }
@@ -281,8 +280,8 @@ function installClaudeTemplates(cwd) {
         ...hooksConfig
     };
     fs.mkdirSync(claudeDir, { recursive: true });
-    fs.writeFileSync(settingsLocalPath, JSON.stringify(mergedSettings, null, 2));
-    console.log(`✅ Configured .claude/settings.local.json hooks (${process.platform})`);
+    fs.writeFileSync(settingsPath, JSON.stringify(mergedSettings, null, 2));
+    console.log(`✅ Configured .claude/settings.json hooks (${process.platform})`);
 }
 /** 安装 Codex 模板 (生成 AGENTS.md) */
 function installCodexTemplates(cwd) {

package/dist/storage/httpClient.d.ts

@@ -5,11 +5,16 @@
  * API URL 格式: http://localhost:20001/api/:projectId/:password/...
  */
 import type { NodeData, SearchResult, PathResult, BugfixRecord, Task, TaskSummary, TaskLogType, TaskExperience } from './types.js';
+export interface ListNodesFilter {
+    status?: 'incomplete' | 'complete' | 'fixing' | 'refactoring' | 'deprecated';
+    minEdges?: number;
+    maxEdges?: number;
+}
 export declare class PpdocsApiClient {
     private baseUrl;
     constructor(apiUrl: string);
     private request;
-    listNodes(): Promise<NodeData[]>;
+    listNodes(filter?: ListNodesFilter): Promise<NodeData[]>;
     getNode(nodeId: string): Promise<NodeData | null>;
     createNode(node: Partial<NodeData>): Promise<NodeData>;
     updateNode(nodeId: string, updates: Partial<NodeData>): Promise<NodeData | null>;
@@ -22,12 +27,6 @@ export declare class PpdocsApiClient {
     lockNode(nodeId: string, locked: boolean): Promise<NodeData | null>;
     searchNodes(keywords: string[], limit?: number): Promise<SearchResult[]>;
     findPath(startId: string, endId: string): Promise<PathResult | null>;
-    findOrphans(): Promise<Array<{
-        id: string;
-        title: string;
-        type: string;
-        status: string;
-    }>>;
     getRelations(nodeId: string): Promise<Array<{
         nodeId: string;
         title: string;
@@ -52,7 +51,7 @@ export declare class PpdocsApiClient {
     completeTask(taskId: string, experience: TaskExperience): Promise<Task | null>;
 }
 export declare function initClient(apiUrl: string): void;
-export declare function listNodes(_projectId: string): Promise<NodeData[]>;
+export declare function listNodes(_projectId: string, filter?: ListNodesFilter): Promise<NodeData[]>;
 export declare function getNode(_projectId: string, nodeId: string): Promise<NodeData | null>;
 export declare function createNode(_projectId: string, node: Partial<NodeData>): Promise<NodeData>;
 export declare function updateNode(_projectId: string, nodeId: string, updates: Partial<NodeData>): Promise<NodeData | null>;
@@ -65,12 +64,6 @@ export declare function deleteNode(_projectId: string, nodeId: string): Promise<
 export declare function lockNode(_projectId: string, nodeId: string, locked: boolean): Promise<NodeData | null>;
 export declare function searchNodes(_projectId: string, keywords: string[], limit?: number): Promise<SearchResult[]>;
 export declare function findPath(_projectId: string, startId: string, endId: string): Promise<PathResult | null>;
-export declare function findOrphans(_projectId: string): Promise<Array<{
-    id: string;
-    title: string;
-    type: string;
-    status: string;
-}>>;
 export declare function getRelations(_projectId: string, nodeId: string): Promise<Array<{
     nodeId: string;
     title: string;

package/dist/storage/httpClient.js

@@ -99,8 +99,34 @@ export class PpdocsApiClient {
         }
     }
     // ============ 节点操作 ============
-    async listNodes() {
-        return this.request('/nodes');
+    async listNodes(filter) {
+        const nodes = await this.request('/nodes');
+        if (!filter)
+            return nodes;
+        // 计算每个节点的连接数 (入边+出边)
+        const edgeCounts = new Map();
+        nodes.forEach(n => edgeCounts.set(n.id, 0));
+        nodes.forEach(n => {
+            (n.dependencies || []).forEach(dep => {
+                // 出边: 当前节点依赖别人
+                edgeCounts.set(n.id, (edgeCounts.get(n.id) || 0) + 1);
+                // 入边: 被依赖的节点 (按 signature 匹配)
+                const target = nodes.find(t => t.signature?.toLowerCase() === dep.name.toLowerCase());
+                if (target)
+                    edgeCounts.set(target.id, (edgeCounts.get(target.id) || 0) + 1);
+            });
+        });
+        // 过滤
+        return nodes.filter(n => {
+            if (filter.status && n.status !== filter.status)
+                return false;
+            const edges = edgeCounts.get(n.id) || 0;
+            if (filter.minEdges !== undefined && edges < filter.minEdges)
+                return false;
+            if (filter.maxEdges !== undefined && edges > filter.maxEdges)
+                return false;
+            return true;
+        });
     }
     async getNode(nodeId) {
         try {
@@ -228,9 +254,6 @@ export class PpdocsApiClient {
             return null;
         }
     }
-    async findOrphans() {
-        return this.request('/orphans');
-    }
     async getRelations(nodeId) {
         const result = await this.request(`/relations/${nodeId}`);
         // 转换字段名 (API 返回 type，前端期望 edgeType)
@@ -323,8 +346,8 @@ function getClient() {
     return client;
 }
 // 导出与 fileStorage 相同的函数签名
-export async function listNodes(_projectId) {
-    return getClient().listNodes();
+export async function listNodes(_projectId, filter) {
+    return getClient().listNodes(filter);
 }
 export async function getNode(_projectId, nodeId) {
     return getClient().getNode(nodeId);
@@ -350,9 +373,6 @@ export async function searchNodes(_projectId, keywords, limit) {
 export async function findPath(_projectId, startId, endId) {
     return getClient().findPath(startId, endId);
 }
-export async function findOrphans(_projectId) {
-    return getClient().findOrphans();
-}
 export async function getRelations(_projectId, nodeId) {
     return getClient().getRelations(nodeId);
 }

package/dist/tools/index.js

@@ -120,21 +120,20 @@ export function registerTools(server, projectId, _user) {
         };
         return wrap(projectId, JSON.stringify(output, null, 2));
     });
-    // 7. 列出所有节点
-    server.tool('kg_list_nodes', '列出项目全部节点概览', {}, async () => {
-        const nodes = await storage.listNodes(projectId);
+    // 7. 列出节点 (支持过滤)
+    server.tool('kg_list_nodes', '列出节点，支持按状态/连接数过滤。maxEdges=0 可查孤立节点', {
+        status: z.enum(['incomplete', 'complete', 'fixing', 'refactoring', 'deprecated']).optional().describe('状态过滤'),
+        minEdges: z.number().optional().describe('最小连接数(含)'),
+        maxEdges: z.number().optional().describe('最大连接数(含)，0=孤立节点')
+    }, async (args) => {
+        const filter = (args.status || args.minEdges !== undefined || args.maxEdges !== undefined)
+            ? { status: args.status, minEdges: args.minEdges, maxEdges: args.maxEdges }
+            : undefined;
+        const nodes = await storage.listNodes(projectId, filter);
         const output = nodes.map(n => ({ id: n.id, title: n.title, type: n.type, status: n.status, locked: n.locked }));
         return wrap(projectId, JSON.stringify(output, null, 2));
     });
-    // 8. 查找孤立节点
-    server.tool('kg_find_orphans', '查找无连线的孤立节点(用于清理)', {}, async () => {
-        const orphans = await storage.findOrphans(projectId);
-        if (orphans.length === 0) {
-            return wrap(projectId, '没有孤立节点');
-        }
-        return wrap(projectId, JSON.stringify(orphans, null, 2));
-    });
-    // 9. 查询节点关系网 (支持多层)
+    // 8. 查询节点关系网 (支持多层)
     server.tool('kg_get_relations', '获取节点的上下游关系(谁依赖它/它依赖谁)，支持多层查询', {
         nodeId: z.string().describe('节点ID'),
         depth: z.number().min(1).max(3).optional().describe('查询层数(默认1，最大3)')

package/package.json

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