Revdoku

Revdoku

AI Agent 的邮箱。 为每个 Agent 配置专属邮箱和电子邮件地址，以接收消息和附件。每个邮箱还会存储私人文档、数据和项目文件，你可以与获授权的人员和 Agent 共享这些内容。

让你的 Agent 总结收到的邮件、收集发票和附件，或监控投稿的回复。使用托管 MCP 供 AI Agent 使用，使用 CLI 访问本地文件和邮箱，或使用 REST API 进行自有集成。邮箱会保留文件版本，方便你查看更改并恢复较早的文件。

这项技能除了支持读取邮件，也支持上传文件和更改文件；还支持归档邮箱、永久删除邮箱，以及在明确请求并获得授权后创建代理机构客户端账户。永久删除需要针对确切的账户和邮箱获得批准。在本地使用 CLI 时，Revdoku 凭据和状态会存储在你的计算机上；主机工具的权限仍由你控制。

面向开发者

TypeScript 和 JavaScript（Node.js 22 或更高版本）：

npm install revdoku

Python 3.10 或更高版本：

pip install revdoku

import { Revdoku } from 'revdoku';

const client = new Revdoku(); // reads REVDOKU_API_KEY
const { data } = await client.listEmails({ mailboxId: 'bkt_...' });
for (const email of data.emails) console.log(email.receivedAt, email.subject);

请求发送至 https://api.revdoku.com。所有路径均以 /v1 开头，例如 https://api.revdoku.com/v1/mailboxes。

从这里开始	你将获得
快速入门	从新建 API 密钥到收到第一封电子邮件，涵盖 TypeScript、Python 和 cURL。
TypeScript SDK · Python SDK	SDK 指南。源码：revdoku-typescript 和 revdoku-python。
API 指南 · API 参考 · OpenAPI	概念和工作流，以及包含示例的所有操作。
使用编码 Agent 构建	为 Claude Code 和 Codex 提供的提示词与项目规则。
软件包和集成	SDK、n8n 和 Zapier 对比。
独立 CLI · 带版本号的 CLI 下载	无需 AI 集成即可安装和使用终端。
示例	可运行的 Node.js 和 Python 示例，使用普通 HTTP 调用。

请将 API 密钥保存在后端。CLI、示例、技能和插件共用此代码库。有关 Agent 设置，请参阅本地 AI 应用。

给 AI Agent 的提示词

Connect Revdoku so you can create and manage email mailboxes for my AI agents, read emails and attachments, and store files. Follow https://revdoku.com/llms-install.md to set up access. If I need an account, guide me to https://app.revdoku.com/users/sign_up?utm_source=revdoku&utm_medium=prompt&utm_campaign=connect to complete signup in my browser. Keep verification codes and credentials out of chat. Verify access, then continue my task or ask what I want to do.

接收和阅读电子邮件

每个邮箱都有自己的收件地址。创建邮箱时会返回地址和接收状态；对于现有邮箱，具有写入权限的连接可通过 mailbox_get 和 mailbox_list 获取 email.address，在邮箱设置 → 电子邮件中也能查看。使用该地址前，请检查 email.receiving_enabled。

使用 CLI 时，运行 revdoku mailbox --mailbox-id bkt_... 以获取地址、就绪状态和活动情况。使用 revdoku emails --mailbox-id bkt_... 列出邮件，并使用 revdoku email eml_... --mailbox-id bkt_... 阅读邮件。

接收发票、文档、项目更新或经授权的服务验证邮件。每封已接收的电子邮件都会保存为原始 message.eml、解码后的 message.json 以及附件文件。经授权的人员和 Agent 可通过电子邮件 API 和工具读取这些内容；文件工具也会公开已存储的文件。

使用 mailbox_email_list，或在 CLI 中使用 emails 命令并提供已保存的 next_cursor，轮询收到的邮件。mailbox_email_get 会直接返回邮件；mailbox_email_download 可获取附件或原始邮件。任何知道该地址的人都可以向邮箱发送邮件；但要读取邮箱内容，必须拥有访问权限。请参阅接收和阅读电子邮件 和 API 规范。

回复邮件时，请使用 mailbox_email_send 或 revdoku email-send --in-reply-to eml_... --text TEXT。 收件人必须是账户成员、同一账户的其他邮箱，或曾向该邮箱发送邮件且通过发件人身份验证的地址；管理员可以分别关闭每种类型的收件人。当邮箱要求审批时，人员需在控制面板中发送、编辑或拒绝每封邮件。请参阅发送电子邮件。

额外文件存储

使用 revdoku upload ./project-files 私下保存本地文件夹。通过 CLI、API 或控制面板读取文件、查看历史记录并恢复早期版本。所有已存储文件都可随时从 Revdoku 下载。

与具有账户访问权限的人员分享邮箱的控制面板链接。分别为预期使用的邮箱授权每个 AI 连接。控制面板链接本身不会授予访问权限。Agent 可以使用锁和版本检查在同一批文件上协作，以协调更改。

请参阅存储快速入门和 共享访问权限并协调编辑。

方案

在浏览器中访问 https://app.revdoku.com/users/sign_up 创建账户。请勿在 AI 聊天中提供账户凭据和验证码。 新账户默认使用 Free 方案。如需日常使用，请在价格页面选择付费方案。

私有存储和协作须遵循使用条款。 如有账户、账单或访问权限方面的问题，请联系 [email protected]。

本地 AI 应用

安装程序通过 REVDOKU_AGENT 环境变量支持 codex、claude-code、cursor、antigravity、 opencode、grok-build、hermes、openclaw 和 all。自动设置会为 Codex 和 任何其他检测到的客户端安装。

安装公开技能和 CLI：

npx skills add revdoku/revdoku --skill revdoku -g

若要指定单个 Agent，请添加 --agent codex（或 claude-code、cursor 等）。 这也可以避免上游 PromptScript 全局安装错误。

Hermes 可以直接安装完整技能：

hermes skills install revdoku/revdoku/skills/revdoku

若要将此仓库订阅为 Hermes 源，请使用 hermes skills tap add revdoku/revdoku。

Claude Code 用户可以运行 /plugin marketplace add revdoku/revdoku，然后运行 /plugin install revdoku@revdoku。Codex 用户可以使用 codex plugin marketplace add revdoku/revdoku 添加此仓库，并在插件浏览器中选择 Revdoku。Gemini CLI 用户可以运行 gemini extensions install https://github.com/revdoku/revdoku。

Revdoku 所有的技能和捆绑 CLI 也可在 MIT-0 许可下使用；请参阅技能的 LICENSE。此仓库的默认许可证仍为 MIT。第三方依赖保留其各自的许可证。

如果无法使用 npm：

curl -fsSL https://revdoku.com/install.sh | bash

技能会运行其捆绑 CLI。Shell 安装程序会在安装前，使用嵌入的 SHA-256 哈希验证 CLI 和技能文件。 如果验证失败，请获取当前安装程序并重试。不支持覆盖下载源。

npx skills 会在技能内安装 CLI，不会将 revdoku 添加到你的 Shell PATH。 Agent 使用捆绑的 scripts/revdoku.sh，参数与以下命令相同。

存储或更新本地文件夹：

revdoku upload ./project-files

首次运行时，如果缺少凭据，会打开浏览器进行登录。再次运行会更新同一个邮箱。可以在网页注册页面创建新账户。

实用命令：

• revdoku upload PATH — 存储或更新私有文件。
• revdoku files、revdoku read PATH — 列出并读取已存储的文件和邮件。
• revdoku mailbox --mailbox-id ID — 检查收件地址和接收状态。
• revdoku versions PATH、revdoku restore PATH --version-id ID — 查看并还原文件历史版本。
• revdoku status、revdoku ls — 查看连接和邮箱。
• revdoku dashboard、revdoku --help — 打开仪表盘或命令参考。

托管式和 Web Agent

托管 MCP 端点为 https://mcp.revdoku.com。连接前，请通过浏览器 OAuth 登录。 请在浏览器中前往 https://app.revdoku.com/users/sign_up 创建新账户。

托管 Agent 无法读取用户计算机上的文件。对于本地文件夹、JavaScript 包、图片、字体、PDF 和其他二进制资源，请使用本地 Revdoku CLI。 MCP 可以直接写入生成的文本文件。

教程

各 AI 客户端指南：

• 设置中心：https://revdoku.com/connect/
• ChatGPT：https://revdoku.com/chatgpt/
• Codex：https://revdoku.com/codex/
• Claude：https://revdoku.com/claude/
• Claude Desktop 和终端 Agent： https://revdoku.com/claude-desktop-terminal/
• Gemini：https://revdoku.com/gemini/
• Hermes：https://revdoku.com/hermes/

需要手动设置或排查问题时，请使用这些教程。根据用户的文件存储、共享或接收邮件目标进行操作。

公共软件包

此仓库包含 Revdoku CLI、技能、API 文档以及 Claude/Codex/Cursor 插件清单。SDK 源码仅位于上方链接的 SDK 仓库中。托管 MCP 实现在 https://mcp.revdoku.com 上运行。MCP 清单使用 OAuth，且每个工具描述符都需要 OAuth。

请参阅 CHANGELOG.md、api.md 和 MCP 邮箱指南。

代理机构客户账户

运行 revdoku status 查看凭据的默认账户和已授权账户。每个身份都包含 account_kind（standard、agency 或 client）、单独的 client_name，以及在获得父级账户授权时的 agency_account。 在每条命令中使用 --account-id ID 指定目标客户；省略该参数时，始终使用凭据的主账户。代理机构所有者必须在连接时或通过 Account → Access 明确包含客户账户。

revdoku account create-client "Client files" --client-name "Acme Studio" --account-id acct_agency
revdoku ls --account-id acct_...
revdoku upload ./project-files --account-id acct_...

代理机构及其客户共享账户容量。每个客户都有独立的文件、成员和品牌设置。 账户名称和客户名称可以不同。未知的客户名称将保持未设置。 revdoku account --account-id ID 显示客户的身份和有效限额；客户的账单数据仍仅对代理机构所有者开放。 切换浏览器中的账户不会更改 CLI 凭据的默认账户。

自定义接收域名

在 Account Settings 中检查自定义域名是否可用。设置入口位于 Account Settings → Domains → Email，且需要账户管理员权限。优先使用尚未使用的接收子域名；也可以使用专用根域名。更改 DNS 需要用户授权。连接域名不会更改现有邮箱地址。 仅使用 Revdoku 返回的完整地址，并检查 receiving_enabled。切换域名时，可能会返回 assignment.status: pending；请持续轮询，直到状态变为 active 或 failed，在此期间继续使用当前地址。切勿自行构造别名或使用 +tag 变体。 请参阅电子邮件 API 契约。

CLI 安全边界

上传时必须指定路径；使用 revdoku upload . 选择当前文件夹。revdoku upload PATH --dry-run 会列出文件、排除项和字节数，不会建立连接或更改邮箱。公开的 CLI 仅连接到 Revdoku API：https://api.revdoku.com。--url 和 REVDOKU_URL 也接受先前的 https://app.revdoku.com 设置，并将其 API 调用转发到新主机。 浏览器登录和仪表板链接使用 https://app.revdoku.com。 存储传输使用经过批准的 HTTPS 来源。

revdoku delete --account-id ACCOUNT --mailbox-id MAILBOX 会预览永久删除操作。请与用户确认目标和不可逆的影响，然后使用该预览的令牌，通过 --confirm-delete TOKEN 再次执行。令牌会在十分钟后过期，并在提交前被使用。如果响应结果不确定，请先检查邮箱状态，再创建另一个预览。现有脚本必须提供上传路径，并使用删除确认步骤。

说明操作原因

对于有意执行的读取、下载和更改，AI Agent 应在已知原因时填写可选的 reason，简要说明操作目的。不要捏造原因，也不要包含机密、文件内容或转录文本。如果任务已经说明操作目的，就不要向用户询问原因；原因未知时请省略。

MCP 使用 reason；CLI 使用 --reason TEXT；REST 对读取操作使用 reason 查询参数，对更改操作使用 JSON／请求正文中的字段。限长为 2,000 个字符。即使禁用了完整请求日志记录，授权用户仍可在 Timeline 和 Logs 视图中看到原因。更改原因也会保存在版本历史中；读取原因属于访问事件，绝不会替代已保存版本的原因。

revdoku read invoices.csv --mailbox-id bkt_... --reason "Reconcile September expenses"
revdoku upload ./approved.csv --mailbox-id bkt_... --reason "Store the approved totals"