fix(enchante): Agent deeplink missing top-level name field

.gitignore

@@ -10,6 +10,7 @@ __pycache__/
 .workbuddy/
 .vscode/
 .idea/
+.codegraph/
 *.swp
 *.swo
 *~
@@ -20,6 +21,7 @@ Thumbs.db
 
 # Test / local KB
 .myknowledge_test/
+.pytest_cache/
 
 # Build artifacts
 frontend/index.standalone.html
@@ -29,10 +31,15 @@ frontend/index.standalone.html
 dist-backend/
 /build/
 *.spec
+!myknowledge-backend.spec
 desktop/node_modules/
 desktop/dist/
 desktop/assets/icon.icns
 
+# Enterprise configs (per-customer; not versioned — keep template.json + README.md)
+desktop/enterprises/*.json
+!desktop/enterprises/template.json
+
 # Design artifacts (generated SVG/PNG, not versioned; keep SPEC.md/.md docs versioned)
 docs/designs/**/export/
 docs/designs/**/screenshots/

README.md

@@ -137,7 +137,7 @@ MyKnowledge comes with a complete AI installation guide (`docs/AI-SETUP.md`). Co
 
 ## Versioning
 
-- **System version**: defined in `backend/__version__.py` (currently 0.7.6)
+- **System version**: defined in `backend/__version__.py` (currently 0.7.7)
 - **KB version**: git commit hash from `agent-commit.txt` checkpoint
 
 ## License

README.zh.md

@@ -137,7 +137,7 @@ pytest tests/ -v
 
 ## 版本
 
-- **系统版本**：定义在 `backend/__version__.py`（当前 0.7.6）
+- **系统版本**：定义在 `backend/__version__.py`（当前 0.7.7）
 - **知识库版本**：从 `agent-commit.txt` checkpoint 读取的 git commit hash
 
 ## 许可

backend/AiClientConfig/agents/MyKnowledge-agent-Enchante.md

@@ -0,0 +1,15 @@
+# MyKnowledge Agent
+
+你是 MyKnowledge 本地知识库（Markdown + Git）的专业 Agent，通过 MyKnowledge MCP 工具读写文档并维护知识库结构。
+
+## 边界与规范
+
+- 一切操作仅限本地知识库 root 内；只允许在 `common-knowledge/`、`projects/`、`archive/` 开头的路径下写入；禁止 `..` 路径穿越与绝对路径。
+- 写入会自动重建父级 readme 并提交 git；不要手动伪造 frontmatter，需保持文档为合法 Markdown。
+- 不删除或改名已有文档的 frontmatter 必需字段；新增字段安全，删改字段需评估影响。
+- 只操作本地知识库，不访问网络、不改写平台自身配置。
+- 遇到不确定的写入（覆盖、删除、改名），先说明后果并征得同意再执行。
+
+## 工具
+
+你的全部工具来自 **MyKnowledge** 这个 MCP server（操作本地知识库）：用 `mcp_get_tool_description` 查看 MyKnowledge 提供的工具清单与用法，用 `mcp_call_tool` 调用；结构异常时用 `maint__knowledgebase_diagnose` 定位。

backend/AiClientConfig/hooks/WorkBuddy.json

@@ -4,10 +4,10 @@
   "supports_hooks": true,
   "event": "PreToolUse",
   "matcher": "Bash|Write|Edit",
-  "matcher_note": "与 Claude Code 同协议：PreToolUse 按工具名触发，必须同时覆盖 Bash 与 Write/Edit（否则 file_write 拦截分支死代码）。MCP 调用由 hooks.py 内部放行。",
-  "command": "curl -s -X POST http://127.0.0.1:8080/hooks/pre-tool-use -H 'Content-Type: application/json' -d '$CLAUDE_TOOL_USE_INPUT'",
-  "protocol": "同 Claude Code：环境变量 $CLAUDE_TOOL_USE_INPUT 传 JSON，stdout 输出 JSON 决策。",
+  "matcher_note": "与 Claude Code 同协议：PreToolUse 按工具名触发，必须覆盖 Bash 与 Write/Edit（否则 file_write 拦截分支死代码）。MCP 调用由 hooks.py 内部放行。",
+  "command": "curl -s -X POST http://127.0.0.1:8080/hooks/pre-tool-use -H 'Content-Type: application/json' -d @-",
+  "protocol": "WorkBuddy 与 Claude Code 的 PreToolUse hook 协议完全同构（2026-08-19 经官方/实测确认）：payload 走 stdin（CodeBuddy CLI 与 WorkBuddy 同源引擎，官方文档「Hook scripts receive JSON-formatted input data via stdin」）；读 hookSpecificOutput.permissionDecision 做 allow/deny（另支持 ask 三态，我们只回 allow/deny 兼容）；退出码 0=放行(按 stdout JSON)/1=非阻断放行/2=阻断/其它=放行。无 $WORKBUDDY_TOOL_USE_INPUT 环境变量传 payload。后端不依赖 tool_use_id/call_id（只读 tool_name/tool_input/cwd），字段名差异无影响。",
   "exit_code_deny": 2,
   "fail_open": true,
-  "notes": "写入 ~/.workbuddy/settings.json 的 hooks.PreToolUse。命令与 ClaudeCode 相同。"
+  "notes": "写入 ~/.workbuddy/settings.json 的 hooks.PreToolUse（非 ~/.claude/），改完须完全重启 WorkBuddy 才加载。命令与 ClaudeCode 相同（-d @- 从 stdin 读 payload）。阻断判定靠 stdout JSON 的 permissionDecision 而非 curl 退出码；后端不可达时 curl 退出非 0 → 放行（fail-open），符合审计日志场景。"
 }

backend/AiClientConfig/platforms.json

@@ -1,11 +1,23 @@
 {
   "_comment": "AI 客户端平台 → 各操作系统下的配置文件路径（单一来源）。平台 key 用 PascalCase，与 client_config.PLATFORMS 及前端 store.clientPlatforms 严格一致。路径占位符：~ → Path.home()，%APPDATA% / %USERPROFILE% → 对应环境变量。kinds 声明该平台支持的配置种类（mcp/hooks/agent）；Enchante 的 MCP/Agent 均走 deeplink（无本地配置文件/agents 目录）。cli_names 用于 client_installed 检测（PATH 探测）。",
-  "os_order": ["macos", "windows", "linux"],
+  "os_order": [
+    "macos",
+    "windows",
+    "linux"
+  ],
   "platforms": {
     "ClaudeCode": {
       "display": "Claude Code",
-      "kinds": ["mcp", "hooks", "agent"],
-      "cli_names": { "macos": "claude", "windows": "claude.exe", "linux": "claude" },
+      "kinds": [
+        "mcp",
+        "hooks",
+        "agent"
+      ],
+      "cli_names": {
+        "macos": "claude",
+        "windows": "claude.exe",
+        "linux": "claude"
+      },
       "paths": {
         "macos": {
           "config_dir": "~/.claude",
@@ -25,11 +37,14 @@
           "settings_file": "~/.claude/settings.json",
           "agents_dir": "~/.claude/agents"
         }
-      }
+      },
+      "enabled": true
     },
     "ClaudeDesktop": {
       "display": "Claude Desktop",
-      "kinds": ["mcp"],
+      "kinds": [
+        "mcp"
+      ],
       "cli_names": {},
       "paths": {
         "macos": {
@@ -44,11 +59,16 @@
           "config_dir": "~/.config/Claude",
           "mcp_file": "~/.config/Claude/claude_desktop_config.json"
         }
-      }
+      },
+      "enabled": true
     },
     "CodeBuddyIDE": {
       "display": "CodeBuddy IDE",
-      "kinds": ["mcp", "hooks", "agent"],
+      "kinds": [
+        "mcp",
+        "hooks",
+        "agent"
+      ],
       "cli_names": {},
       "paths": {
         "macos": {
@@ -57,11 +77,16 @@
           "settings_file": "~/.codebuddy/settings.json",
           "agents_dir": "~/.codebuddy/agents"
         }
-      }
+      },
+      "enabled": true
     },
     "WorkBuddy": {
       "display": "WorkBuddy",
-      "kinds": ["mcp", "hooks", "agent"],
+      "kinds": [
+        "mcp",
+        "hooks",
+        "agent"
+      ],
       "cli_names": {},
       "paths": {
         "macos": {
@@ -70,21 +95,30 @@
           "settings_file": "~/.workbuddy/settings.json",
           "agents_dir": "~/.workbuddy/agents"
         }
-      }
+      },
+      "enabled": true
     },
     "Enchante": {
       "display": "Enchanté",
-      "kinds": ["mcp", "agent"],
+      "kinds": [
+        "mcp",
+        "agent"
+      ],
       "cli_names": {},
       "paths": {
         "macos": {
           "config_dir": "/Applications"
         }
-      }
+      },
+      "enabled": true
     },
     "Cursor": {
       "display": "Cursor",
-      "kinds": ["mcp", "hooks", "agent"],
+      "kinds": [
+        "mcp",
+        "hooks",
+        "agent"
+      ],
       "cli_names": {},
       "paths": {
         "macos": {
@@ -93,7 +127,8 @@
           "hooks_file": "~/.cursor/hooks.json",
           "agents_dir": "~/.cursor/agents"
         }
-      }
+      },
+      "enabled": true
     }
   }
 }

backend/__version__.py

@@ -1,2 +1,2 @@
 """MyKnowledge version."""
-__version__ = "0.7.6"
+__version__ = "0.7.7"