@ppdocs/mcp 2.6.5 → 2.6.6

package/dist/cli.js

@@ -135,39 +135,50 @@ function commandExists(cmd) {
         return false;
     }
 }
+/** 静默执行命令 (忽略错误) */
+function execSilent(cmd) {
+    try {
+        execSync(cmd, { stdio: 'ignore' });
+    }
+    catch { /* ignore */ }
+}
 /** 自动检测 AI CLI 并注册 MCP */
 function autoRegisterMcp(apiUrl, user) {
     const detected = [];
+    const serverName = 'ppdocs-kg';
     // 检测 Claude CLI
     if (commandExists('claude')) {
         detected.push('Claude');
         try {
-            const cmd = `claude mcp add ppdocs-kg -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user} -- npx -y @ppdocs/mcp@latest`;
             console.log(`✅ Detected Claude CLI, registering MCP...`);
+            execSilent(`claude mcp remove ${serverName}`);
+            const cmd = `claude mcp add ${serverName} -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user} -- npx -y @ppdocs/mcp@latest`;
             execSync(cmd, { stdio: 'inherit' });
         }
         catch (e) {
             console.log(`⚠️  Claude MCP registration failed: ${e}`);
         }
     }
-    // 检测 Codex CLI (OpenAI)
+    // 检测 Codex CLI (OpenAI) - 使用 --env 而非 -e
     if (commandExists('codex')) {
         detected.push('Codex');
         try {
-            const cmd = `codex mcp add ppdocs-kg -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user} -- npx -y @ppdocs/mcp@latest`;
             console.log(`✅ Detected Codex CLI, registering MCP...`);
+            execSilent(`codex mcp remove ${serverName}`);
+            const cmd = `codex mcp add ${serverName} --env PPDOCS_API_URL=${apiUrl} --env PPDOCS_USER=${user} -- npx -y @ppdocs/mcp@latest`;
             execSync(cmd, { stdio: 'inherit' });
         }
         catch (e) {
             console.log(`⚠️  Codex MCP registration failed: ${e}`);
         }
     }
-    // 检测 Gemini CLI
+    // 检测 Gemini CLI - 命令在位置参数，-e 在后面
     if (commandExists('gemini')) {
         detected.push('Gemini');
         try {
-            const cmd = `gemini mcp add ppdocs-kg -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user} -- npx -y @ppdocs/mcp@latest`;
             console.log(`✅ Detected Gemini CLI, registering MCP...`);
+            execSilent(`gemini mcp remove ${serverName}`);
+            const cmd = `gemini mcp add ${serverName} "npx -y @ppdocs/mcp@latest" -e PPDOCS_API_URL=${apiUrl} -e PPDOCS_USER=${user}`;
             execSync(cmd, { stdio: 'inherit' });
         }
         catch (e) {

package/dist/storage/httpClient.d.ts

@@ -16,11 +16,7 @@ export declare class PpdocsApiClient {
     updateRoot(updates: {
         title?: string;
         description?: string;
-        userStyles?: Array<{
-            key: string;
-            value: string;
-            category: 'config' | 'style' | 'reference';
-        }>;
+        userStyles?: string[];
     }): Promise<NodeData | null>;
     deleteNode(nodeId: string): Promise<boolean>;
     lockNode(nodeId: string, locked: boolean): Promise<NodeData | null>;
@@ -63,11 +59,7 @@ export declare function updateNode(_projectId: string, nodeId: string, updates:
 export declare function updateRoot(_projectId: string, updates: {
     title?: string;
     description?: string;
-    userStyles?: Array<{
-        key: string;
-        value: string;
-        category: 'config' | 'style' | 'reference';
-    }>;
+    userStyles?: string[];
 }): Promise<NodeData | null>;
 export declare function deleteNode(_projectId: string, nodeId: string): Promise<boolean>;
 export declare function lockNode(_projectId: string, nodeId: string, locked: boolean): Promise<NodeData | null>;

package/dist/storage/types.d.ts

@@ -17,12 +17,6 @@ export interface Dependency {
     description: string;
     nodePath?: string;
 }
-export type UserStyleCategory = 'config' | 'style' | 'reference';
-export interface UserStyleItem {
-    key: string;
-    value: string;
-    category: UserStyleCategory;
-}
 export interface VersionRecord {
     version: number;
     date: string;
@@ -51,7 +45,7 @@ export interface NodeData {
     dataOutput?: DataRef;
     dependencies: Dependency[];
     relatedFiles?: string[];
-    userStyles?: UserStyleItem[];
+    userStyles?: string[];
     createdAt?: string;
     updatedAt?: string;
     lastAccessedAt?: string;

package/dist/tools/index.js

@@ -68,14 +68,10 @@ export function registerTools(server, projectId, _user) {
         return wrap(projectId, node ? JSON.stringify(node, null, 2) : '更新失败(节点不存在或已锁定)');
     });
     // 3.5 更新根节点 (专用方法，支持 userStyles)
-    server.tool('kg_update_root', '更新根节点(项目配置、编码风格、测试参数等，锁定时不可更新)', {
+    server.tool('kg_update_root', '更新根节点(项目规则，锁定时不可更新)', {
         title: z.string().optional().describe('项目标题'),
         description: z.string().optional().describe('项目描述(Markdown)'),
-        userStyles: z.array(z.object({
-            key: z.string().describe('配置键'),
-            value: z.string().describe('配置值'),
-            category: z.enum(['config', 'style', 'reference']).describe('分类: config=基本规则, style=编码风格, reference=测试参数')
-        })).optional().describe('用户风格配置(完全替换，非合并)')
+        userStyles: z.array(z.string()).optional().describe('项目规则列表(字符串数组，每条一个规则)')
     }, async (args) => {
         // 空参数检查
         if (args.title === undefined && args.description === undefined && args.userStyles === undefined) {

package/dist/utils.d.ts

@@ -2,7 +2,7 @@
  * MCP Server 工具函数
  */
 /**
- * 获取根节点的用户风格 (优先 userStyles, 兼容 description)
+ * 获取根节点的用户风格
  */
 export declare function getRootStyle(projectId: string): Promise<string>;
 /**

package/dist/utils.js

@@ -5,35 +5,16 @@ import * as storage from './storage/httpClient.js';
 // 缓存根节点风格 (避免每次调用都请求)
 let cachedRootStyle = null;
 let cacheProjectId = null;
-// 风格分类标签
-const STYLE_CATEGORY_LABELS = {
-    config: '配置',
-    style: '风格',
-    reference: '参考'
-};
 /**
- * 将 userStyles 数组格式化为 Markdown 文本
+ * 将 userStyles 字符串数组格式化为 Markdown 列表
  */
 function formatUserStyles(styles) {
     if (!styles || styles.length === 0)
         return '';
-    const groups = { config: [], style: [], reference: [] };
-    styles.forEach(s => {
-        if (groups[s.category])
-            groups[s.category].push(s);
-    });
-    const lines = [];
-    for (const [cat, items] of Object.entries(groups)) {
-        if (items.length === 0)
-            continue;
-        lines.push(`### ${STYLE_CATEGORY_LABELS[cat] || cat}`);
-        items.forEach(item => lines.push(`- **${item.key}**: ${item.value}`));
-        lines.push('');
-    }
-    return lines.join('\n').trim();
+    return styles.map(s => `- ${s}`).join('\n');
 }
 /**
- * 获取根节点的用户风格 (优先 userStyles, 兼容 description)
+ * 获取根节点的用户风格
  */
 export async function getRootStyle(projectId) {
     // 缓存命中
@@ -47,13 +28,12 @@ export async function getRootStyle(projectId) {
             cacheProjectId = projectId;
             return '';
         }
-        // 优先使用结构化 userStyles
+        // 使用 userStyles 字符串数组
         if (rootNode.userStyles && rootNode.userStyles.length > 0) {
             cachedRootStyle = formatUserStyles(rootNode.userStyles);
         }
         else {
-            // 兼容旧版: 使用 description 字段
-            cachedRootStyle = rootNode.description || '';
+            cachedRootStyle = '';
         }
         cacheProjectId = projectId;
         return cachedRootStyle;
@@ -74,11 +54,10 @@ export function clearStyleCache() {
  */
 export async function wrapResult(projectId, result) {
     const style = await getRootStyle(projectId);
-    // 跳过空白或默认模板内容
-    if (!style || style.trim() === '' || /^#\s+\S+\s*\n\n(项目根节点|Project root)?\s*$/.test(style)) {
+    if (!style || style.trim() === '') {
         return result;
     }
-    return `[项目风格]\n${style}\n\n---\n[结果]\n${result}`;
+    return `[项目规则]\n${style}\n\n---\n[结果]\n${result}`;
 }
 /**
  * 解码 Unicode 转义序列

package/package.json

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