STARDUSTLC666/dsh-email
51最近提交 2026年8月15日
dsh-email DSH 插件
dsh-email 是 DeepSeek Harness 的邮件工具插件，为 agent 提供查收件箱、读邮件、搜邮件、代发邮件、管理文件夹和下载附件的完整能力。支持 Web 设置页和 YAML 两种配置方式，内置 QQ、163、Gmail、Outlook 等常见邮箱预设。
如何安装 dsh-email DSH 插件
dsh plugin --profile web add dsh-email复制不会执行命令。安装 dsh-email DSH 插件前请核对仓库和版本。
dsh-email DSH 插件数据来源
dsh-email DSH 插件快照日期：2026年8月16日
discovered
dsh-email DSH 插件能做什么
- 列出任意文件夹的最新邮件，支持未读过滤和分页
- 读取邮件全文（HTML 自动转纯文本，可配置截断长度）
- 按关键词搜索邮件主题、发件人、收件人或抄送（无结果时回退正文扫描）
- 代发邮件并支持附件，默认发信前需用户确认
- 下载邮件中的指定附件到会话工作区
- 支持多账号配置，通过 account 参数切换，并可设置默认账号
dsh-email DSH 插件适合哪些场景
- 让 agent 自动检查最新未读邮件并生成摘要
- 搜索关键词相关的邮件，快速定位信息
- 代替用户撰写并发送带附件的回复邮件
- 从邮件中提取附件供其他工具处理
- 在一个插件中管理多个邮箱账号（工作/个人）
dsh-email DSH 插件适合谁
- 希望 agent 能处理邮箱的 DSH 用户
- 需要邮件收发功能的自动化流程开发者
dsh-email DSH 插件的限制
- 不支持 OAuth2，仅接受授权码或应用专用密码
- 服务器端搜索仅限主题/发件人/收件人/抄送；回退正文扫描在大邮箱中可能较慢
- 密码以明文保存在 settings.yaml 中（标记为 secret 仅防止日志/导出泄露，不做磁盘加密）
dsh-email DSH 插件的仓库 README 摘录
以下文字摘自 dsh-email DSH 插件的上游仓库 STARDUSTLC666/dsh-email 的 README，版权归原作者，仅作引用。
> **给 agent 一个邮箱**：八个国内邮箱预设开箱即用，收发/搜索/附件下载全搞定。     [](https://awesome-dsh-plugin.com)  DeepSeek Harness 邮件工具插件：让 agent 能**查收件箱、读邮件、搜邮件、代发邮件、收发附件**。纯插件实现，零核心改动，安装即可用。 Email tools for DeepSeek Harness: list, read, search and send mail through standard IMAP/SMTP — with one-line presets for QQ / 163 / 126 / Sina / Aliyun / Gmail / Outlook / iCloud. 纯 Node 实现，**全平台通用**（Windows / macOS / Linux 同一份代码），不依赖 shell、无原生二进制。 ## 工具一览 | 工具 | 作用 | |---|---| | `email_list` | 列出文件夹里最新的邮件（未读过滤、分页、只看摘要不带正文） | | `email_read` | 按 uid 读取一封邮件的全文（HTML 邮件自动转纯文本，超长截断） | | `email_search` | 按关键词搜索主题/发件人/收件人/抄送（服务器端 subject/from/to/cc）；无结果时默认回退到最近 30 封的正文扫描（含 to/cc） | | `email_send` | 代发邮件（支持带附件）。**默认发信前会弹确认**，显示收件人、主题和附件数，由你批准后才发出 | | `email_folders` | 列出邮箱的文件夹（INBOX/已发送/垃圾邮件/自定义…
阅读完整 README仓库许可: MIT
dsh-email DSH 插件常见问题
如何获取邮箱的授权码？
不同邮箱服务商流程不同。QQ/163/126：进入设置 → 账户 → 开启 IMAP/SMTP 服务 → 生成授权码。Gmail：开启两步验证后，在安全设置中生成应用专用密码。Outlook：在 Microsoft 账户安全中生成应用密码。请勿使用登录密码。
dsh-email 支持多个邮箱账号吗？
支持。在 cordis.patch.yml 的 `tool-email` 配置中，可以定义 `accounts` 字段，每个账号有名称（如 work、home）和完整配置。调用邮件工具时通过 `account` 参数选择使用哪个账号，也可设置 `defaultAccount` 作为默认账号。
dsh-email 支持 Gmail 或 Outlook 吗？
支持，插件内置了 Gmail（imap.gmail.com:993, smtp.gmail.com:465）和 Outlook（outlook.office365.com:993, smtp.office365.com:587 STARTTLS）的预设。Gmail 需要使用应用专用密码，Outlook 也需要从 Microsoft 账户安全获取应用密码。不支持 OAuth2。
如何避免在配置文件中保存密码？
你可以设置环境变量 `DSH_EMAIL_PASSWORD`，插件会在运行时读取该变量，从而无需在 YAML 或设置文件中写入密码。这比明文存储更安全。
为什么 email_send 拒绝发信，提示需要审批？
默认情况下 `sendApproval` 为 `true`，出于安全考虑，每次发信前会弹出确认框，显示收件人、主题和附件数量。如果你在无 UI 环境或处于 Full Access 模式下，审批被禁止，发信会被拦截。你可以将 `sendApproval` 设为 `false` 来绕过，但强烈不建议这样做。