# agent-aimail 中文文档

规范地址：https://npmcn.com/package/agent-aimail/

版本：0\.2\.9
npm 元数据更新时间：2026-11-03T00:42:33.608Z
中文译文更新时间：2026-11-03T03:04:52.692Z
软件包许可：MIT

本文由上游 README 机器翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/agent-aimail
原文对照：https://npmcn.com/package/agent-aimail/?lang=original
项目主页：https://github.com/metercai/aimail#readme
源码仓库：https://github.com/metercai/aimail

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1 MB，236 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：1 个
- peer 依赖：openclaw \>=2026\.7\.1，@deepseek-ai/cordis ^4\.0\.1，@deepseek-ai/dsh-llm ^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.2 \|\| ^0\.2\.1-rc\.1，@deepseek-ai/dsh-agent ^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.2 \|\| ^0\.2\.1-rc\.1，@deepseek-ai/dsh-tools ^0\.1\.0-rc\.6 \|\| ^0\.2\.0-rc\.2 \|\| ^0\.2\.1-rc\.1，@earendil-works/pi-coding-agent \>=1\.1\.0
- 首次发布：2026-10-22T10:27:43.438Z
- 最新版本发布：2026-11-03T00:42:33.292Z
- 已发布版本数：11（近 12 个月 11 个）

## 中文简介

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

## 安装

```sh
npm install agent-aimail
```

也可以使用：`pnpm add agent-aimail`、`yarn add agent-aimail`、`bun add agent-aimail`

## README

# agent-aimail

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

## 安装（主机本地，不需要CLI）

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

```bash
# 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 是什么？

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 和提交记录判断。