agent-aimail

中文文档
0.2.9发布于 2026/11/03MITTypeScriptES Module构建来源已验证

AIMail代理邮件SDK - OpenClaw / dsh (DeepSeek Harness) / Pi主机的单个包。启动时的主机检测,每个主机激活。邮件工具,入站投递(HMAC),董事会/技能资源,代理级寻址。

中文使用文档
文档目录4 节
  1. 安装(主机本地,不需要CLI)
  2. 主机标识
  3. 布局
  4. 出口

agent-aimail

AIMail的单个TypeScript SDK包。一个包服务所有Node.js代理 主机:共享核心(网关客户端,15邮件工具,入站预处理) 链,HMAC验证,自动绑定)加上每个支持的主机适配器 平台。

安装(主机本地,不需要CLI)

每个主机安装相同的包;包标识它的主机 启动及分支环境:

# OpenClaw (gateway plugin)
openclaw plugins install agent-aimail --force --accept-capabilities

# dsh (deepseek-harness, self-mounting bundle)
dsh plugin --profile web add agent-aimail

# pi (earendil-works/pi-coding-agent, extension)
pi install npm:agent-aimail

aimail install (CLI)驱动相同的命令并注册 代理之后。

主机标识

在启动时,包解析哪个主机正在加载它(主机SDK) Resolvability + config dir),断言正在执行的条目与之匹配 主机,则运行主机的激活路径(单板资源→技能释放) →工具注册→入站路由→急切绑定)。添加新的主机类型= 一个注册表项+一个 src/<host>/ 模块;共享核永远不会 复制。

布局

  • src/core/ -与主机无关的核心(身份,自动绑定,工具,入站,董事会,技能)
  • src/mail/ -配置解析(agentmail.json → AgentConfig)
  • src/openclaw/ - OpenClaw插件入口(dist/openclaw/index.js)
  • src/dsh/ - DSH自安装项(dist/dsh/{mail-service,tools,inbound}.js)
  • src/pi/ - PI扩展项(dist/pi/index.js)
  • src/hosts/ -主机注册表+检测+激活断言
  • resources/ -董事会角色提示+代理技能(单一来源,在包中上演)

出口

  • agent-aimail -主机标识项(detect + registry)
  • agent-aimail/core -共享核心API
  • agent-aimail/mail -配置解析器
  • agent-aimail/{openclaw,dsh,pi} -主机项

版本与发布记录

agent-aimail 共发布 11 个版本,首次发布于 2026/10/22;过去 12 个月发布了 11 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.2.9latest2026/11/03今天
0.2.82026/11/02今天
0.2.72026/11/021 天前
0.2.62026/10/304 天前
0.2.52026/10/286 天前
0.2.42026/10/259 天前

关于 agent-aimail 的常见问题

agent-aimail 是什么?

AIMail代理邮件SDK - OpenClaw / dsh (DeepSeek Harness) / Pi主机的单个包。启动时的主机检测,每个主机激活。邮件工具,入站投递(HMAC),董事会/技能资源,代理级寻址。

如何安装 agent-aimail?

在项目目录运行 npm install agent-aimail,或使用 pnpm add / yarn add / bun add。

agent-aimail 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

agent-aimail 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

agent-aimail 可以商用吗?

agent-aimail 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

agent-aimail 还在维护吗?

最新版本 0.2.9 发布于 2026/11/03(今天);至今共发布 11 个版本,其中过去 12 个月发布了 11 个;首次发布于 2026/10/22。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。