给 DeepSeek Harness（DSH）的 IMAP 多账号邮件分类插件，支持三层垃圾判断与缓存优先的即时报告。解决多邮箱收信、分类与报告的痛点。
核心机制¶
插件采用「前台后台分离」的架构，前台只读缓存，后台 worker 独立轮询收信。
- 前台（只读）：读取本机缓存的
index.json或state.json，命令如/mail_brief，不联网、不等授权，响应毫秒级。 - 后台（轮询）：独立进程，默认每 5 分钟轮询一次（可配置
sync.pollIntervalMs）。IMAP 只读拉取预览（BODY.PEEK[]），不置\Seen，不下载附件。支持断点续传（基于UIDVALIDITY和UID）。 - 三层判断：
1. 硬规则：黑名单、冒充检测、钓鱼特征、无退订营销。
2. 启发式打分：基于历史互动、关键词、附件类型、SPF/DKIM 结果打分（0-100）。
3. 模型仲裁：当前无内置实现，默认关闭，仅暴露适配点，不提供上传第三方服务的能力。
安装与配置¶
安装¶
尚未发布到 npm，需使用 GitHub 安装命令。请使用固定版本 v0.2.3。
dsh plugin add github:Ronniealgo/dsh-mail-guardian#v0.2.3
配置要点¶
- 凭据引用：配置里必须使用
credentialRef引用，不能直接填写密码。值存入 DSH 密钥库的refs段。 - 必填项：
accounts列表。不配置也能启动，但报告会提示未配置。 - 自动化开关：
automation.moveRules和automation.moveHeuristics默认为false，需手动开启才会自动分类移动。
常用命令与工具¶
侧栏与指令¶
/mail_brief：立即显示本机最新报告，不联网、不收信。/mail_check：查看各账号同步状态与上次成功时间。mail_move：移到指定文件夹，必须带confirm参数。
Agent 工具（只读与改信分离）¶
- 只读工具（不联网）：
mail_report（今日报告）、mail_summarize（简报）、mail_list（列表）、mail_search（检索本地缓存）。 - 改信工具（需确认）：
mail_move（移动）、mail_mark（标记状态）、mail_pending（处理待定邮件，需confirm）。
安全与行为边界¶
- 不做永久删除：插件不支持全局
EXPUNGE，仅支持移动到垃圾箱或归档。服务器不支持MOVE/UIDPLUS且非 Gmail 时，直接拒绝移动。 - 不点击、不加载：正文链接只做文本分析，不访问；不加载远程图片，防止追踪。
- 操作需确认：任何移动操作（
mail_move）都必须带confirm。插件不会自动回复、转发或发信。 - 零运行时依赖：依赖由 DSH 宿主提供，不打包第三方运行时。
