dsh-email

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	按关键词搜索发件人/收件人/主题（服务器端）；无结果时默认回退到最近 30 封的正文扫描
email_send	代发邮件（支持带附件）。默认发信前会弹确认，显示收件人、主题和附件数，由你批准后才发出
email_folders	列出邮箱的文件夹（INBOX/已发送/垃圾邮件/自定义…），拿 path 喂给其他工具
email_attachment	按序号下载邮件附件（默认存到会话工作区，模型可直接读取；大小受 maxAttachmentBytes 限制）

示例对话：

帮我看下 QQ 邮箱最新的 10 封未读，把要回复的列出来。

安装

dsh plugin --profile web add dsh-email

（或从 GitHub 安装：dsh plugin --profile web add github:你的账号/dsh-email#，随后按提示在 profile 的 pnpm-workspace.yaml 里授权 prepare 构建。）

装好后重启 dsh web。插件自带空配置，不会弄崩启动；配置前调用任何 email 工具都会返回明确的配置提示。

配置方式有两种（任选其一）：

1. 网页设置（推荐）：重启后打开 设置 → 邮件 (dsh-email)，表单里填邮箱地址和授权码，点「保存并应用」，还带「测试连接」按钮。零 YAML、零重启。
2. YAML：按下面的 cordis.patch.yml 模板手写（多账号 accounts 映射目前只支持这种方式）。

设置页保存的值存在 settings.yaml 的 dsh-email 命名空间里，覆盖 YAML 的默认账号配置；密码字段标记为 secret（不会出现在任何导出/诊断里）。

配置

在你 profile 的 cordis.patch.yml 里覆盖 tool-email 行（在 $DSH_HOME/profiles// 下），然后重启：

- id: tool-email
  config:
    provider: qq          # qq | 163 | 126 | sina | aliyun | gmail | outlook | icloud
    user: you@qq.com
    password: 你的授权码   # 强烈建议改用环境变量 DSH_EMAIL_PASSWORD，见下

不需要预设？手填任意 IMAP/SMTP 服务器即可：

- id: tool-email
  config:
    user: you@corp.example
    password: 你的授权码
    imap: { host: imap.corp.example, port: 993, secure: true }
    smtp: { host: smtp.corp.example, port: 465, secure: true }
    inboxFolder: INBOX