dsh-email

主要功能

• email_list/email_read/email_search 支持列出、读取、按主题/发件人/收件人/抄送搜索邮件，无结果时可回退扫描最近邮件正文
• email_send 支持带附件代发邮件，默认发信前弹出确认（显示收件人、主题、附件数）
• email_folders 列出邮箱文件夹，email_attachment 按序号下载附件到会话工作区
• 内置 QQ/163/126/新浪/阿里/Gmail/Outlook/iCloud 八种邮箱预设，也支持手填任意 IMAP/SMTP 服务器
• 支持多账号配置，工具调用时用 account 参数切换，并支持 IMAP 连接复用（idle 超时可调）
• 提供网页设置页配置账号、密码、多账号 YAML，并可测试连接；密码字段标记为 secret 不进日志/导出

适合什么时候用

• 希望 Agent 自动查收/回复邮件、整理未读列表
• 需要让 Agent 代发带附件的邮件并保留人工审批确认
• 需要按关键词搜索历史邮件或下载邮件附件供 Agent 处理

安装后会多出什么

使用前需要

• 需要邮箱的 IMAP/SMTP 授权码或应用专用密码（不支持 OAuth2 强制的企业邮箱）
• 在 DSH web profile 下通过 npm 安装（dsh plugin --profile web add dsh-email），安装后需重启 dsh web
• 密码建议通过环境变量 DSH_EMAIL_PASSWORD 提供，避免明文写入配置文件