v2.8.0: MCP 新增 list_domains 工具;create_mailbox/MCP 与 REST 支持 webhook 参数、省略 domain_id 时随机分配已启用 Email Workers 的域名;修复 webhook 校验后置导致的半截创建(先校验再建邮箱);/docs 页与 docs/07 同步

console/frontend/src/pages/Docs.tsx

@@ -11,10 +11,11 @@ const MCP_URL = `${window.location.origin}/api/v1/mcp`;
 
 /** # 成员变量: MCP 工具清单(与 /api/v1/mcp tools/list 一致) **/
 const MCP_TOOLS = [
+  { name: "list_domains", params: "—", desc: "列出可用域名(创建邮箱的 domain_id 由此获取)" },
   { name: "list_mailboxes", params: "—", desc: "列出所有邮箱(域名、catch-all 标记、保留秒数)" },
   { name: "list_emails", params: "mailbox_id? / limit?", desc: "列出未过期邮件,limit 默认 20、最大 100" },
   { name: "get_email", params: "id", desc: "单封邮件详情(正文 + 附件元数据);过期邮件报错" },
-  { name: "create_mailbox", params: "domain_id / address / retention_seconds?", desc: "创建邮箱;address 可传本地部分或完整地址,保留默认 86400 秒" },
+  { name: "create_mailbox", params: "domain_id? / address / retention_seconds? / webhook?", desc: "创建邮箱;省略 domain_id 时随机分配一个已启用 Email Workers 的域名(address 须为本地部分)" },
   { name: "delete_mailbox", params: "id", desc: "删除邮箱" },
 ];
 
@@ -23,7 +24,7 @@ const API_ENDPOINTS = [
   { method: "GET", path: "/accounts", desc: "账号列表(不含已撤销)" },
   { method: "GET", path: "/domains", desc: "域名列表" },
   { method: "GET", path: "/mailboxes", desc: "邮箱列表" },
-  { method: "POST", path: "/mailboxes", desc: "创建邮箱,body: { domain_id, address, retention_seconds? };409 已存在" },
+  { method: "POST", path: "/mailboxes", desc: "创建邮箱,body: { address, domain_id?, retention_seconds?, webhook? };省略 domain_id 随机分配;409 已存在/无可用域名" },
   { method: "DELETE", path: "/mailboxes/:id", desc: "删除邮箱" },
   { method: "GET", path: "/emails", desc: "未过期邮件列表,query: mailbox_id? / limit / offset" },
   { method: "GET", path: "/emails/:id", desc: "邮件详情 + 附件元数据;410 已过期" },