前言¶

在 DeepSeek Harness（DSH）里跑智能体时，常见需求是替用户发通知、拉取收件箱里的工单或回复。若每次都在会话外手动开邮箱客户端，上下文会断；若在应用里硬编码一套邮件 SDK，又和 Harness 的工具调用模型脱节。dsh-mail-bridge 以插件形式把 SMTP、IMAP 封成 agent 可调用的工具，默认按 QQ 邮箱的 host/端口写好，凭据写在本地 profile，不把密钥打进插件包。下面介绍它的能力、安装与配置方式。

这是什么¶

dsh-mail-bridge 由社区维护者 lmy060307 发布，归类为「联网工具」。实现上基于 Python 标准库的 SMTP / IMAP，宿主侧通过 index.js 调起脚本，不额外依赖 npm 邮件库；发信、列信、读正文、列文件夹、下附件各对应一个工具名，供 DSH 会话中的 agent 调用。插件当前版本为 0.1.0，许可证 MIT。

社区目录页：https://www.skillhub.cn/plugins/lmy060307/dsh-mail-bridge
源码与说明：https://github.com/lmy060307/dsh-mail-bridge

SkillHub 为独立插件目录站点，与 DeepSeek / 幻方无官方从属关系；DSH 生态习惯是「一切皆插件」，本插件是其中一种联网能力扩展。

核心功能¶

README 中列出的工具有五类，名称与作用如下。

文档中写明的边界包括：面向 QQ 邮箱常用子集，不使用 OAuth，不处理草稿、不回写已读；附件下载会过滤路径穿越，重名时自动加序号；正文里的远程图片不会拉取。

安装与启用¶

本机需要 Python 3，默认解释器命令为 python，可在配置里用 pythonPath 覆盖。

从插件名安装：

dsh plugin install dsh-mail-bridge

若已把源码放在本地目录，也可指定路径：

dsh plugin install /path/to/mail-bridge

安装前建议阅读仓库源码与 LICENSE，确认插件将以当前 dsh 进程权限访问本机与网络。

配置凭据¶

授权码等敏感信息不要写进插件包，应在 profile 的 cordis.patch.yml 里按插件 id 覆盖。最小示例：

- id: mail-bridge
  name: dsh-mail-bridge
  config:
    user: your-name@qq.com
    pass: your-smtp-authorization-code

其余字段可留空：默认 smtp.qq.com:465、imap.qq.com:993。接入其他服务商时再补 host/port：

    smtpHost: smtp.example.com
    smtpPort: 465
    imapHost: imap.example.com
    imapPort: 993

QQ 邮箱的 pass 须在「设置 → 账户 → POP3/IMAP 服务」中生成授权码，不是网页登录密码。授权码具备收发权限，只保存在本地 profile，勿提交仓库；泄露后应在邮箱后台重新生成。

典型用法（agent 侧）¶

文档未给出固定对话话术，典型流程可按工具名组合理解：

1. 用 mail_folders 确认收件箱等文件夹名称。
2. 用 mail_list 在目标文件夹取最近邮件的 uid 与元信息。
3. 对感兴趣的 uid 调用 mail_read 看正文，必要时用 mail_download 落盘附件。
4. 需要对外回复或通知时，用 mail_send 发信（可带抄送与本地附件路径）。

mail_send 会真实发出邮件；在需要人工确认的场景下，宜在流程上保留确认步骤，避免 agent 误发。

适用场景与注意¶

适合已在 DSH 中编排 agent、又需要标准 SMTP/IMAP（尤其 QQ 邮箱）的团队或个人：例如自动汇总收件箱、按主题检索后读信、发送运维或业务通知。

注意事项归纳自 README：

• 凭据仅放本地 cordis.patch.yml，与插件包分离。
• 功能子集刻意保持简单，不支持 OAuth 与已读回写等完整客户端能力。
• 插件代码与 Python 脚本随安装进入环境，安装前应自行审阅 GitHub 仓库。

结尾¶

dsh-mail-bridge 把常见邮件操作收成五个 Harness 工具，默认 QQ 邮箱、可改 SMTP/IMAP 指向其他服务，适合把「收一封、回一封」纳入 agent 工作流。更多信息见社区目录 SkillHub 插件页 与 GitHub README。