前言¶
在 DSH 里处理邮件，常见做法是装邮箱类插件，在对话里用工具列信、读信、搜信。新邮件要人自己打开客户端或手动拉列表，才能把上下文交给模型。若希望「来信即触发会话」，并自动产出摘要、待办和回复建议，需要额外把监控、游标和会话持久化接在一起。dsh-email-monitor 在继承上游 dsh-email 接入能力的同时，把后台轮询和新邮件建会话做进同一套插件，首期自动监控面向 163 IMAP。
这是什么¶
dsh-email-monitor 是 DSH 联网工具类扩展，维护者为 sunqing975，仓库 github.com/sunqing975/dsh-email-monitor，当前包版本 0.24.0-monitor.1。它基于 STARDUSTLC666/dsh-email v0.24.0 修改，包名改为 dsh-email-monitor，替代上游同名能力使用，不应与原版 dsh-email 同时启用。
界面保留「邮件」「邮箱设置」「处理记录」；不再把发送、草稿、定时发送、邮件任务、规则或邮箱修改工具注册为使用入口（上游相关源码仍保留以便兼容）。
邮箱接入与监控范围¶
接入与自动监控支持范围不同，以下以 README 表格为准。
| 能力 | 当前支持范围 |
|---|---|
| 邮箱接入、列表、搜索和阅读（继承上游） | QQ、腾讯企业邮、163、126、新浪、阿里云、Gmail、Outlook、iCloud，自定义 IMAP/SMTP 企业邮箱；另有 POP3、OAuth、AgentMail |
| 后台自动监控 → 新会话摘要、待办、建议回复（本项目新增） | 首期开放 163 IMAP；其他邮箱适配与实机收件验证待完成 |
| IM 通知 | 暂未实现；结果显示在 DSH 会话中 |
两条主流程：新邮件自动触发 DSH 对话，以及选择已有邮件生成回复建议。具体品牌是否可用取决于服务器协议、账户权限和认证策略；本项目未逐一完成所有品牌实机验证。
自动监控行为¶
默认每 60 秒检查指定账户收件箱；首次成功检查只建立基线，跳过历史邮件。每封新邮件创建一个 DSH 会话，生成摘要、待办与建议回复文本；已读状态不影响检测。监控进度会持久化，失败后会重试；先确认会话持久化，再推进邮件游标。
「处理记录」展示监听状态、检查时间、自动/手动提交结果及关联会话；删除会话后记录仍保留并带提示。插件不自动发送回复，不自动解析或下载附件。需要 DSH 主进程持续运行、网络可用以及已配置模型；邮件正文会交给模型并保存在会话记录中。完整配置与限制见仓库内 163 监控使用说明。
安装与启用¶
当前为源码构建版本，尚未发布到 npm。资料中的步骤为：克隆仓库、安装依赖并构建，再通过 DSH 插件安装能力安装本地包目录，包名为 dsh-email-monitor。
git clone https://github.com/sunqing975/dsh-email-monitor.git
cd dsh-email-monitor
pnpm install --ignore-scripts
pnpm run build
环境与引擎要求：DSH >=0.2.1-rc.3；Node.js ^22.19.0 || >=24.0.0。本扩展保留上游 tool-email 配置条目、email_* 工具与账户存储标识；已有账户迁移前请备份配置。上游自动更新注册已关闭，避免更新覆盖监控扩展。
安装前应阅读仓库源码与 MIT 许可证；插件在 DSH 主进程权限下运行，授权码与邮件内容会进入本地配置与会话，勿把授权码发到聊天或提交仓库。
典型用法（163 自动监控与手动建议）¶
下面步骤来自 README 安装与配置小节，面向首期开放的 163 IMAP 监控。
- 在网易邮箱网页开启 IMAP 服务，取得授权码。
- 在 DSH「邮件设置」中添加
163账户，填写完整邮箱地址和 IMAP 授权码，测试连接。 - 在「邮箱设置」的「新邮件监听」中选择账户，填写会话工作目录，开启监听并保存。默认每 60 秒检查
INBOX；首次检查跳过历史邮件。 - 在「邮件」中选择任意已有邮件，点击「生成回复建议」，自动打开 DSH 对话；可继续对话调整回复语气与内容。
高级配置与页面控件同步，字段包括 incomingMonitorEnabled、incomingMonitorAccount、incomingMonitorFolder、incomingMonitorPollSeconds、incomingMonitorCwd（均属 tool-email）。手动建议提供 email_suggest_reply；阅读类工具保留 email_list、email_read、email_search、email_folders、email_health。
适用场景与注意¶
适合已在 DSH 中配置模型、希望 163 收件箱新信自动变成可跟进会话的开发者或团队；QQ、企业邮箱、OAuth、多账户同时监控与可选 IM 通知在后续计划中。
与仅做读写的邮箱插件相比，本项目的差异在监控游标、失败重试与会话侧的摘要提示；若只需要偶发读信，不必开启监听。Google OAuth 需自行配置客户端；Outlook 默认客户端及授权边界见上游 REFERENCE.zh.md。
结尾¶
dsh-email-monitor 把多邮箱接入与 163 首期后台监控收在同一扩展里：来信自动建会话并给出摘要与回复建议，已有邮件也可一键生成建议再在对话中润色。目录页见 skillhub.cn/plugins/sunqing975/dsh-email-monitor；源码、Issues 与文档见 GitHub 仓库。社区插件目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
