@ppdocs/mcp 3.1.0 → 3.1.2

package/dist/cli.js

@@ -274,9 +274,10 @@ function copyDirRecursive(src, dest) {
     }
 }
 /** 生成跨平台的 hooks 配置 (调用 python hook.py) */
-function generateHooksConfig() {
-    // hook.py 支持关键词动态匹配，比静态读取 MD 更灵活
-    const command = 'python .claude/hooks/hook.py';
+function generateHooksConfig(cwd) {
+    // 使用绝对路径，避免 CWD 不一致导致找不到脚本
+    const hookPath = path.join(cwd, '.claude', 'hooks', 'hook.py').replace(/\\/g, '/');
+    const command = `python ${hookPath}`;
     return {
         hooks: {
             UserPromptSubmit: [
@@ -340,7 +341,7 @@ function installClaudeTemplates(cwd) {
         }
         catch { /* ignore */ }
     }
-    const hooksConfig = generateHooksConfig();
+    const hooksConfig = generateHooksConfig(cwd);
     // 合并 MCP 权限到 permissions.allow
     const existingPermissions = existingSettings.permissions || {};
     const existingAllow = existingPermissions.allow || [];

package/dist/storage/httpClient.d.ts

@@ -104,11 +104,24 @@ export declare function getDocsByStatus(_projectId: string, statusList: string[]
 export declare function getTree(_projectId: string): Promise<TreeNode[]>;
 export declare function getRules(_projectId: string, ruleType: string): Promise<string[]>;
 export declare function saveRules(_projectId: string, ruleType: string, rules: string[]): Promise<boolean>;
+export declare function appendRules(_projectId: string, ruleType: string, newRules: string[]): Promise<{
+    success: boolean;
+    total: number;
+    added: number;
+}>;
 export declare function getRulesMeta(): Promise<Record<string, RuleMeta>>;
 export declare function saveRulesMeta(meta: Record<string, RuleMeta>): Promise<boolean>;
+export declare function mergeRulesMeta(newMeta: Record<string, RuleMeta>): Promise<{
+    success: boolean;
+    total: number;
+}>;
 export declare function crossGetRulesMeta(target: string): Promise<Record<string, RuleMeta>>;
 export declare function getGlobalRulesMeta(): Promise<Record<string, RuleMeta>>;
 export declare function saveGlobalRulesMeta(meta: Record<string, RuleMeta>): Promise<boolean>;
+export declare function mergeGlobalRulesMeta(newMeta: Record<string, RuleMeta>): Promise<{
+    success: boolean;
+    total: number;
+}>;
 export declare function listTasks(_projectId: string, status?: 'active' | 'archived'): Promise<TaskSummary[]>;
 export declare function getTask(_projectId: string, taskId: string): Promise<Task | null>;
 export declare function createTask(_projectId: string, task: {

package/dist/storage/httpClient.js

@@ -508,12 +508,26 @@ export async function getRules(_projectId, ruleType) {
 export async function saveRules(_projectId, ruleType, rules) {
     return getClient().saveRulesApi(ruleType, rules);
 }
+export async function appendRules(_projectId, ruleType, newRules) {
+    const existing = await getClient().getRulesApi(ruleType);
+    const existingSet = new Set(existing.map(r => r.trim()));
+    const toAdd = newRules.filter(r => !existingSet.has(r.trim()));
+    const merged = [...existing, ...toAdd];
+    const success = await getClient().saveRulesApi(ruleType, merged);
+    return { success, total: merged.length, added: toAdd.length };
+}
 export async function getRulesMeta() {
     return getClient().getRulesMeta();
 }
 export async function saveRulesMeta(meta) {
     return getClient().saveRulesMeta(meta);
 }
+export async function mergeRulesMeta(newMeta) {
+    const existing = await getClient().getRulesMeta();
+    const merged = { ...existing, ...newMeta };
+    const success = await getClient().saveRulesMeta(merged);
+    return { success, total: Object.keys(merged).length };
+}
 export async function crossGetRulesMeta(target) {
     return getClient().crossGetRulesMeta(target);
 }
@@ -523,6 +537,12 @@ export async function getGlobalRulesMeta() {
 export async function saveGlobalRulesMeta(meta) {
     return getClient().saveGlobalRulesMeta(meta);
 }
+export async function mergeGlobalRulesMeta(newMeta) {
+    const existing = await getClient().getGlobalRulesMeta();
+    const merged = { ...existing, ...newMeta };
+    const success = await getClient().saveGlobalRulesMeta(merged);
+    return { success, total: Object.keys(merged).length };
+}
 // ============ 任务管理 ============
 export async function listTasks(_projectId, status) {
     return getClient().listTasks(status);

package/dist/tools/index.js

@@ -237,20 +237,20 @@ export function registerTools(server, projectId, _user) {
         }
         return { content: [{ type: 'text', text: rules }] };
     });
-    // 3.7 保存项目规则
-    server.tool('kg_save_rules', '保存单个类型的项目规则(独立文件存储)', {
+    // 3.7 保存项目规则 (自动合并,去重追加)
+    server.tool('kg_save_rules', '保存单个类型的项目规则(自动合并:已有规则保留,新规则去重追加)', {
         ruleType: z.string()
             .describe('规则类型(如 userStyles, codeStyle, reviewRules, testRules, unitTests, 或自定义类型)'),
         rules: z.array(z.string()).describe('规则数组')
     }, async (args) => {
         const decoded = decodeObjectStrings(args);
-        const success = await storage.saveRules(projectId, decoded.ruleType, decoded.rules);
-        if (!success) {
+        const result = await storage.appendRules(projectId, decoded.ruleType, decoded.rules);
+        if (!result.success) {
             return wrap('❌ 保存失败');
         }
         const meta = await storage.getRulesMeta();
         const label = meta[decoded.ruleType]?.label || decoded.ruleType;
-        return wrap(`✅ ${label}已保存 (${decoded.rules.length} 条)`);
+        return wrap(`✅ ${label}已保存 (新增${result.added}条, 共${result.total}条)`);
     });
     // 3.8 获取规则触发配置
     server.tool('kg_get_rules_meta', '获取规则触发配置(所有类型的标签、关键词、触发数)。用于查看/编辑 hooks 触发条件', {}, async () => {
@@ -270,8 +270,8 @@ export function registerTools(server, projectId, _user) {
             return wrap(`❌ ${String(e)}`);
         }
     });
-    // 3.9 保存规则触发配置
-    server.tool('kg_save_rules_meta', '保存规则触发配置(标签、关键词、触发数)。支持新增自定义规则类型', {
+    // 3.9 保存规则触发配置 (自动合并)
+    server.tool('kg_save_rules_meta', '保存规则触发配置(自动合并:已有类型更新,新类型创建,其他类型不受影响)', {
         meta: z.record(z.string(), z.object({
             label: z.string().describe('规则显示名称'),
             keywords: z.array(z.string()).default([]).describe('触发关键词列表'),
@@ -281,11 +281,11 @@ export function registerTools(server, projectId, _user) {
     }, async (args) => {
         try {
             const decoded = decodeObjectStrings(args.meta);
-            const success = await storage.saveRulesMeta(decoded);
-            if (!success) {
+            const result = await storage.mergeRulesMeta(decoded);
+            if (!result.success) {
                 return wrap('❌ 保存失败');
             }
-            return wrap(`✅ 规则触发配置已保存 (${Object.keys(decoded).length} 个类型)`);
+            return wrap(`✅ 触发配置已保存 (更新${Object.keys(decoded).length}个类型, 共${result.total}个类型)`);
         }
         catch (e) {
             return wrap(`❌ ${String(e)}`);
@@ -309,8 +309,8 @@ export function registerTools(server, projectId, _user) {
             return wrap(`❌ ${String(e)}`);
         }
     });
-    // 3.11 保存全局默认规则触发配置
-    server.tool('kg_save_global_rules_meta', '保存全局默认规则触发配置(新项目创建时继承此配置)。支持新增自定义规则类型', {
+    // 3.11 保存全局默认规则触发配置 (自动合并)
+    server.tool('kg_save_global_rules_meta', '保存全局默认触发配置(自动合并:已有类型更新,新类型创建,其他类型不受影响)', {
         meta: z.record(z.string(), z.object({
             label: z.string().describe('规则显示名称'),
             keywords: z.array(z.string()).default([]).describe('触发关键词列表'),
@@ -320,11 +320,11 @@ export function registerTools(server, projectId, _user) {
     }, async (args) => {
         try {
             const decoded = decodeObjectStrings(args.meta);
-            const success = await storage.saveGlobalRulesMeta(decoded);
-            if (!success) {
+            const result = await storage.mergeGlobalRulesMeta(decoded);
+            if (!result.success) {
                 return wrap('❌ 保存失败');
             }
-            return wrap(`✅ 全局默认规则触发配置已保存 (${Object.keys(decoded).length} 个类型)`);
+            return wrap(`✅ 全局触发配置已保存 (更新${Object.keys(decoded).length}个类型, 共${result.total}个类型)`);
         }
         catch (e) {
             return wrap(`❌ ${String(e)}`);

package/package.json

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

package/templates/hooks/hook.py

@@ -60,9 +60,14 @@ def is_bypass(text):
 # ╚══════════════════════════════════════════════════════════════╝
 
 
+def get_project_root():
+    """从 __file__ 反推项目根目录 (.claude/hooks/hook.py → 上两级)"""
+    return os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
+
+
 def load_ppdocs_config():
     """读取 .ppdocs 配置"""
-    config_path = os.path.join(os.getcwd(), ".ppdocs")
+    config_path = os.path.join(get_project_root(), ".ppdocs")
     if not os.path.exists(config_path):
         return None
     try: