diff --git a/README.md b/README.md
index e181ef90..8cf0c756 100644
--- a/README.md
+++ b/README.md
@@ -28,7 +28,7 @@
-Memoh is an always-on, containerized AI agent system. Create multiple AI bots, each running in its own isolated container with persistent memory, and interact with them across Telegram, Discord, Lark (Feishu), or the built-in Web/CLI. Bots can execute commands, edit files, browse the web, call external tools via MCP, and remember everything — like giving each bot its own computer and brain.
+Memoh is an always-on, containerized AI agent system. Create multiple AI bots, each running in its own isolated container with persistent memory, and interact with them across Telegram, Discord, Lark (Feishu), Email, or the built-in Web/CLI. Bots can execute commands, edit files, browse the web, call external tools via MCP, and remember everything — like giving each bot its own computer and brain.
## Quick Start
@@ -73,15 +73,18 @@ Memoh Bot can distinguish and remember requests from multiple humans and bots, w
- 👥 **Multi-User & Identity Recognition**: Bots can distinguish individual users in group chats, remember each person's context separately, and send direct messages to specific users. Cross-platform identity binding unifies the same person across Telegram, Discord, Lark, and Web.
- 📦 **Containerized**: Each bot runs in its own isolated containerd container. Bots can freely execute commands, edit files, and access the network within their containers — like having their own computer. Supports container snapshots for save/restore.
- 🧠 **Memory Engineering**: Hybrid retrieval (dense vector search + BM25 keyword search) with LLM-driven fact extraction. Last 24 hours of context loaded by default, with memory compaction and rebuild capabilities.
-- 💬 **Multi-Platform**: Supports Telegram, Discord, Lark (Feishu), and built-in Web/CLI. Unified message format with rich text, media attachments, reactions, and streaming across all platforms. Cross-platform identity binding.
+- 💬 **Multi-Platform**: Supports Telegram, Discord, Lark (Feishu), Email, and built-in Web/CLI. Unified message format with rich text, media attachments, reactions, and streaming across all platforms. Cross-platform identity binding.
+- 📧 **Email**: Multi-adapter email service (Mailgun, generic SMTP) with per-bot binding and outbound audit log. Bots can send and receive emails as a channel.
- 🔧 **MCP (Model Context Protocol)**: Full MCP support (HTTP / SSE / Stdio). Built-in tools for container operations, memory search, web search, scheduling, messaging, and more. Connect external MCP servers for extensibility.
- 🧩 **Subagents**: Create specialized sub-agents per bot with independent context and skills, enabling multi-agent collaboration.
- 🎭 **Skills & Identity**: Define bot personality via IDENTITY.md, SOUL.md, and modular skill files that bots can enable/disable at runtime.
-- 🔍 **Web Search**: Configurable search providers (Brave Search, etc.) for web search and URL content fetching.
+- 🔍 **Web Search**: 12 built-in search providers — Brave, Bing, Google, Tavily, DuckDuckGo, SearXNG, Serper, Sogou, Jina, Exa, Bocha, and Yandex — for web search and URL content fetching.
- ⏰ **Scheduled Tasks**: Cron-based scheduling with max-call limits. Bots can autonomously run commands or tools at specified intervals.
+- 💓 **Heartbeat**: Periodic autonomous tasks — bots can perform routine operations (e.g., check-ins, summaries, monitoring) at configurable intervals with execution logging.
- 📥 **Inbox**: Cross-channel inbox — messages from other channels are queued and surfaced in the system prompt so the bot never misses context.
+- 📊 **Token Usage Tracking**: Monitor token consumption per bot with usage statistics and visualization.
- 🧪 **Multi-Model**: Works with any OpenAI-compatible, Anthropic, or Google Generative AI provider. Per-bot model assignment for chat, memory, and embedding.
-- 🖥️ **Web UI**: Modern dashboard (Vue 3 + Tailwind CSS) with real-time streaming chat, tool call visualization, container filesystem browser, and visual configuration for all settings. Dark/light theme, i18n.
+- 🖥️ **Web UI**: Modern dashboard (Vue 3 + Tailwind CSS) with real-time streaming chat, tool call visualization, in-chat file manager, container filesystem browser, and visual configuration for all settings. Dark/light theme, i18n.
- 🚀 **One-Click Deploy**: Docker Compose with automatic migration, containerd setup, and CNI networking. Interactive install script included.
## Tech Stack
@@ -98,12 +101,12 @@ Memoh Bot can distinguish and remember requests from multiple humans and bots, w
## Architecture
```
-┌─────────────┐ ┌─────────────────┐ ┌──────────────┐
-│ Channels │ │ Web UI │ │ CLI │
-│ (TG/DC/FS) │ │ (Vue 3 :8082) │ │ │
-└──────┬───────┘ └────────┬────────┘ └──────┬───────┘
- │ │ │
- ▼ ▼ ▼
+┌──────────────────┐ ┌─────────────────┐ ┌──────────────┐
+│ Channels │ │ Web UI │ │ CLI │
+│ (TG/DC/FS/Email) │ │ (Vue 3 :8082) │ │ │
+└────────┬─────────┘ └────────┬────────┘ └──────┬───────┘
+ │ │ │
+ ▼ ▼ ▼
┌──────────────────────────────────────────────────────────┐
│ Server (Go :8080) │
│ Auth · Bots · Channels · Memory · Containers · MCP │
diff --git a/README_CN.md b/README_CN.md
index e61fcd6a..f835ed65 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -28,7 +28,7 @@
-Memoh 是一个常驻运行的容器化 AI Agent 系统。你可以创建多个 AI 机器人,每个机器人运行在独立的容器中,拥有持久化记忆,并通过 Telegram、Discord、飞书(Lark) 或内置的 Web/CLI 与之交互。机器人可以执行命令、编辑文件、浏览网页、通过 MCP 调用外部工具,并记住一切 —— 就像给每个 Bot 一台自己的电脑和大脑。
+Memoh 是一个常驻运行的容器化 AI Agent 系统。你可以创建多个 AI 机器人,每个机器人运行在独立的容器中,拥有持久化记忆,并通过 Telegram、Discord、飞书(Lark)、Email 或内置的 Web/CLI 与之交互。机器人可以执行命令、编辑文件、浏览网页、通过 MCP 调用外部工具,并记住一切 —— 就像给每个 Bot 一台自己的电脑和大脑。
## 快速开始
@@ -73,15 +73,18 @@ Memoh Bot 能区分并记忆多人与多 bot 的请求,在任意群聊中无
- 👥 **多用户与身份识别**:Bot 可在群聊中区分不同用户,分别记忆每个人的上下文,并支持向特定用户单独发送消息。跨平台身份绑定将同一用户在 Telegram、Discord、飞书、Web 上的身份统一关联。
- 📦 **容器化**:每个 bot 运行在独立的 containerd 容器中,可在容器内自由执行命令、编辑文件、访问网络,宛如各自拥有一台电脑。支持容器快照保存与恢复。
- 🧠 **记忆工程**:混合检索(稠密向量搜索 + BM25 关键词搜索),LLM 驱动的知识抽取。默认加载最近 24 小时上下文,支持记忆压缩与重建。
-- 💬 **多平台**:支持 Telegram、Discord、飞书(Lark) 及内置 Web/CLI。跨平台统一消息格式,支持富文本、媒体附件、表情回应和流式输出。跨平台身份绑定。
+- 💬 **多平台**:支持 Telegram、Discord、飞书(Lark)、Email 及内置 Web/CLI。跨平台统一消息格式,支持富文本、媒体附件、表情回应和流式输出。跨平台身份绑定。
+- 📧 **邮件**:多适配器邮件服务(Mailgun、通用 SMTP),支持按 bot 绑定与发信审计日志。Bot 可将邮件作为渠道收发。
- 🔧 **MCP(模型上下文协议)**:完整 MCP 支持(HTTP / SSE / Stdio)。内置容器操作、记忆搜索、网络搜索、定时任务、消息发送等工具,可连接外部 MCP 服务器扩展。
- 🧩 **子代理**:为每个 bot 创建专用子代理,拥有独立上下文与技能,实现多代理协作。
- 🎭 **技能与身份**:通过 IDENTITY.md、SOUL.md 定义 bot 人格,模块化技能文件可在运行时启用/禁用。
-- 🔍 **网络搜索**:可配置搜索提供商(Brave Search 等),支持网页搜索与 URL 内容抓取。
+- 🔍 **网络搜索**:内置 12 种搜索提供商 —— Brave、Bing、Google、Tavily、DuckDuckGo、SearXNG、Serper、搜狗、Jina、Exa、Bocha、Yandex,支持网页搜索与 URL 内容抓取。
- ⏰ **定时任务**:基于 Cron 的任务调度,支持最大调用次数限制。Bot 可自主在指定时间执行命令或工具。
+- 💓 **心跳**:周期性自主任务,Bot 可按配置间隔执行例行操作(如签到、汇总、监控),并记录执行日志。
- 📥 **收件箱**:跨渠道收件箱,其他渠道的消息会排入收件箱并呈现在系统提示词中,确保 bot 不遗漏上下文。
+- 📊 **Token 用量追踪**:按 bot 监控 token 消耗,支持用量统计与可视化。
- 🧪 **多模型**:兼容任何 OpenAI 兼容、Anthropic 或 Google Generative AI 提供商。每个 bot 可独立配置聊天、记忆和嵌入模型。
-- 🖥️ **Web 管理界面**:基于 Vue 3 + Tailwind CSS 的现代面板,实时流式聊天、工具调用可视化、容器文件浏览器,所有配置可视化操作。深色/浅色主题,中英文支持。
+- 🖥️ **Web 管理界面**:基于 Vue 3 + Tailwind CSS 的现代面板,实时流式聊天、工具调用可视化、聊天内文件管理器、容器文件浏览器,所有配置可视化操作。深色/浅色主题,中英文支持。
- 🚀 **一键部署**:Docker Compose 编排,自动迁移、containerd 初始化与网络配置,一条命令启动全栈。附带交互式安装脚本。
## 技术栈
@@ -98,12 +101,12 @@ Memoh Bot 能区分并记忆多人与多 bot 的请求,在任意群聊中无
## 架构
```
-┌─────────────┐ ┌─────────────────┐ ┌──────────────┐
-│ Channels │ │ Web UI │ │ CLI │
-│ (TG/DC/FS) │ │ (Vue 3 :8082) │ │ │
-└──────┬───────┘ └────────┬────────┘ └──────┬───────┘
- │ │ │
- ▼ ▼ ▼
+┌──────────────────┐ ┌─────────────────┐ ┌──────────────┐
+│ Channels │ │ Web UI │ │ CLI │
+│ (TG/DC/FS/Email) │ │ (Vue 3 :8082) │ │ │
+└────────┬─────────┘ └────────┬────────┘ └──────┬───────┘
+ │ │ │
+ ▼ ▼ ▼
┌──────────────────────────────────────────────────────────┐
│ Server (Go :8080) │
│ Auth · Bots · Channels · Memory · Containers · MCP │
@@ -125,7 +128,7 @@ Memoh Bot 能区分并记忆多人与多 bot 的请求,在任意群聊中无
## 路线图
-详见 [Roadmap Version 0.1.0](https://github.com/memohai/Memoh/issues/86)。
+详见 [Roadmap](https://github.com/memohai/Memoh/issues/86)。
## 开发