feat(desktop): add WebMCP debugging tools for structured AI agent access

Register 15 structured tools via navigator.modelContext (Chrome 146+)
for direct state queries without DOM scraping. Reduces token consumption
~67% vs DevTools MCP snapshot-based debugging. Dev mode only.

Tools: get_zclaw_state, check_connection, send_message, cancel_stream,
get_streaming_state, list_conversations, get_current_conversation,
switch_conversation, get_token_usage, get_offline_queue,
get_saas_account, get_available_models, get_current_agent,
list_agents, get_console_errors

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

CLAUDE.md

@@ -261,7 +261,37 @@ ZCLAW 提供 11 个自主能力包（9 启用 + 2 禁用）：
 - 配置读写
 - Hand 触发
 
-### 7.2 验证命令
+### 7.2 前端调试优先使用 WebMCP
+
+ZCLAW 注册了 WebMCP 结构化调试工具（`desktop/src/lib/webmcp-tools.ts`），AI 代理可直接查询应用状态而无需 DOM 截图。
+
+**原则：能用 WebMCP 工具完成的调试，优先使用 WebMCP 而非 DevTools MCP（`take_snapshot`/`evaluate_script`），以减少约 67% 的 token 消耗。**
+
+已注册的 WebMCP 工具：
+
+| 工具名 | 用途 |
+|--------|------|
+| `get_zclaw_state` | 综合状态概览（连接、登录、流式、模型） |
+| `check_connection` | 连接状态检查 |
+| `send_message` | 发送聊天消息 |
+| `cancel_stream` | 取消当前流式响应 |
+| `get_streaming_state` | 流式响应详细状态 |
+| `list_conversations` | 列出最近对话 |
+| `get_current_conversation` | 获取当前对话完整消息 |
+| `switch_conversation` | 切换到指定对话 |
+| `get_token_usage` | Token 用量统计 |
+| `get_offline_queue` | 离线消息队列 |
+| `get_saas_account` | SaaS 账户和订阅信息 |
+| `get_available_models` | 可用 LLM 模型列表 |
+| `get_current_agent` | 当前 Agent 详情 |
+| `list_agents` | 所有 Agent 列表 |
+| `get_console_errors` | 应用日志中的错误 |
+
+**使用前提**：Chrome 146+ 并启用 `chrome://flags/#enable-webmcp-testing`。仅在开发模式注册。
+
+**何时仍需 DevTools MCP**：UI 布局/样式问题、点击交互、截图对比、网络请求检查。
+
+### 7.3 验证命令
 
 ```bash
 # TypeScript 类型检查
@@ -274,7 +304,7 @@ pnpm vitest run
 pnpm start:dev
 ````
 
-### 7.3 人工验证清单
+### 7.4 人工验证清单
 
 - [ ] 能否正常连接后端服务
 - [ ] 能否发送消息并获得流式响应