docs: add mailbox

Author: surunzi

docs/.vitepress/sidebar.mts

@@ -382,6 +382,10 @@ export const enSidebar = [
         text: 'Lunar Calendar',
         link: '/guide/official-plugins/lunar-calendar',
       },
+      {
+        text: 'Mailbox',
+        link: '/guide/official-plugins/mailbox',
+      },
       {
         text: 'Map',
         link: '/guide/official-plugins/map',
@@ -942,6 +946,10 @@ export const zhSidebar = [
         text: '万年历',
         link: '/zh/guide/official-plugins/lunar-calendar',
       },
+      {
+        text: '邮箱',
+        link: '/zh/guide/official-plugins/mailbox',
+      },
       {
         text: '地图',
         link: '/zh/guide/official-plugins/map',

docs/guide/official-plugins/mailbox.md

@@ -0,0 +1,30 @@
+# tinker-mailbox
+
+An email client plugin for [TINKER](https://github.com/liriliri/tinker), with IMAP receive ([imapflow](https://imapflow.com/)) and SMTP send ([nodemailer](https://nodemailer.com/)).
+
+![Screenshot](https://raw.githubusercontent.com/liriliri/tinker-plugins/master/packages/tinker-mailbox/screenshot.png)
+
+## Features
+
+- **Multi-account** IMAP/SMTP setup with presets for Gmail, Outlook, QQ, 163, and more
+- **Folder browsing** with local cache, idle sync, and pull-to-load older messages
+- **Message reading** for plain text and HTML mail
+- **Compose & send** with rich-text formatting (bold, lists, font size, etc.)
+- **Move & delete** messages via context menu (trash or permanent delete)
+- **MCP Tools** for listing accounts/folders/messages, reading mail, and sending from the CLI
+
+## Installation
+
+Download and install [TINKER](https://tinker.liriliri.io/), then run:
+
+```bash
+npm i -g tinker-mailbox
+```
+
+## Usage
+
+1. Add an email account and fill in IMAP/SMTP settings (or use a provider preset from the email domain)
+2. Select a folder in the sidebar to browse messages
+3. Click a message to read it; right-click to move or delete
+4. Click **Compose** to write and send a new message
+5. Use the toolbar to switch accounts, edit settings, or refresh the current folder

docs/zh/guide/official-plugins/mailbox.md

@@ -0,0 +1,30 @@
+# tinker-mailbox
+
+TINKER 邮箱客户端插件，支持 IMAP 收信（[imapflow](https://imapflow.com/)）和 SMTP 发信（[nodemailer](https://nodemailer.com/)）。
+
+![截图](https://raw.githubusercontent.com/liriliri/tinker-plugins/master/packages/tinker-mailbox/screenshot.png)
+
+## 功能特性
+
+- **多账户** IMAP/SMTP 配置，内置 Gmail、Outlook、QQ、163 等预设
+- **文件夹浏览**，支持本地缓存、idle 同步，以及下拉加载更早的邮件
+- **邮件阅读**，支持纯文本和 HTML 邮件
+- **撰写与发送**，支持富文本格式（加粗、列表、字号等）
+- **移动与删除**，通过右键菜单将邮件移入垃圾箱或永久删除
+- **MCP Tools**，可通过 CLI 列出账户/文件夹/邮件、阅读邮件并发送邮件
+
+## 安装
+
+下载安装 [TINKER](https://tinker.liriliri.io/)，然后运行：
+
+```bash
+npm i -g tinker-mailbox
+```
+
+## 使用方法
+
+1. 添加邮箱账户并填写 IMAP/SMTP 设置（或根据邮箱域名使用服务商预设）
+2. 在侧边栏选择文件夹浏览邮件
+3. 点击邮件阅读；右键可移动或删除
+4. 点击 **撰写** 编写并发送新邮件
+5. 使用工具栏切换账户、编辑设置或刷新当前文件夹