ZJU-REAL 电子邮箱 Skill（himalaya）
通过沙箱内的 himalaya 命令以当前用户的邮箱身份收发和管理邮件。himalaya 二进制已随沙箱镜像预装，无需安装。用户的邮箱配置（IMAP/SMTP + 授权码）由后端注入到 ~/.config/himalaya/config.toml，账号名固定为 default，所有命令无需指定 -a/--account。
连接前置（必须先确认）
本技能要求用户已在「插件 → 电子邮箱 → 绑定邮箱」填写邮箱地址与授权码完成绑定（凭据已注入沙箱）。
- 执行任意业务命令前，先用
himalaya folder list -o json确认能连上邮箱；若报「cannot find configuration」「no account」「authentication failed」之类，停止并提示用户先到「插件 → 电子邮箱」绑定邮箱账号，不要尝试在聊天里收集邮箱密码。 - 绑定用的是各邮箱服务商的授权码 / app password（不是登录密码）：Gmail 用 App Password、QQ/网易/腾讯企业邮在邮箱设置里「开启 IMAP/SMTP 并获取授权码」。这些引导话术在绑定页已有，技能里只需提示用户去绑定。
凭据由后端注入到沙箱
~/.config/himalaya/config.toml，跨会话存活；技能本身不读写、不导出授权码明文。
全局约定
- 加
-o json（或--output json）让输出结构化、便于解析；展示给用户时再转成自然语言。 - 邮件用数字 id 标识（来自
envelope list）。先 list 拿 id，再对该 id read/reply/flag。 - 默认文件夹是收件箱（INBOX）。其它文件夹用
-f <folder>（如-f Sent）。
常用操作
查看收件箱 / 列邮件
himalaya envelope list -o json # 收件箱最近邮件（含 id/发件人/主题/日期/未读标记）
himalaya envelope list -f Sent -o json # 指定文件夹
himalaya envelope list --page-size 20 -o json # 控制条数
搜索邮件
# himalaya 的查询 DSL：from/subject/body/... 组合
himalaya envelope list 'from alice and subject 报告' -o json
himalaya envelope list 'since 2026-06-01' -o json
阅读某封邮件
himalaya message read <id> -o json # 读正文
himalaya message read <id> --no-headers # 仅正文纯文本
发送邮件（含附件）
用 MML 模板从 stdin 喂给 template send。附件用 <#part ...> 指向沙箱 /workspace 下的文件：
cat <<'EOF' | himalaya template send
To: someone@example.com
Cc: boss@example.com
Subject: 月度报告
您好，
附件是本月报告，请查收。
<#part type=application/pdf filename=/workspace/月度报告.pdf><#/part>
EOF
- 发纯文本就去掉
<#part>行。多个附件就写多行<#part ...>。 - 要发的文件先确保在沙箱
/workspace里（用户上传的文件、或本会话生成的产物）。
回复 / 转发
# 回复（带原文引用）：编辑模板后 send
himalaya message reply <id> --output json # 取回复模板
# 实操：用 template 工作流——先拿回复模板，填好正文再 send
himalaya message forward <id> # 转发模板
reply/forward 的稳妥做法：
himalaya template reply <id>/himalaya template forward <id>取模板 → 在模板里补正文（必要时加<#part>附件）→ 管道给himalaya template send。
下载附件
himalaya attachment download <id> # 下到沙箱当前目录（/workspace）
下载后可用 sandbox_get_artifact 把文件交付给用户。
标记 / 整理
himalaya flag add <id> seen # 标记已读
himalaya flag remove <id> seen # 标记未读
himalaya flag add <id> flagged # 加星标
himalaya message move <id> <目标文件夹> # 移动到文件夹
himalaya message delete <id> # 删除（进废纸篓/标记删除）
文件夹
himalaya folder list -o json # 列出所有文件夹
注意事项
- Gmail 文件夹别名：Gmail 的特殊文件夹名带
[Gmail]/前缀（如[Gmail]/Sent Mail、[Gmail]/Trash）。直接用-f Sent可能找不到——先folder list看真实名称，再用准确名称。 - 附件大小：受邮件服务商限制（多数 20–50MB）；过大的文件改用网盘链接。
- 收件人确认：发信前把收件人、主题、是否带附件向用户复述确认一次，避免误发。
- 失败处理：命令报鉴权失败/连接超时，多半是授权码失效或服务器设置变更——提示用户到「插件 → 电子邮箱」重新绑定，不要在聊天里索要密码。