扫描 OA 邮箱(himalaya 或 WorkBuddy agent-mail connector)→ 分类邮件 → 解密解析 xlsx 附件 → 生成结构化简报 → 多渠道投递(飞书 / 微信 Clawbot / Markdown)。融合 email-daily-summary v3.0.7(68 pitfall 实战金标准 + 加密 xlsx 处理)与 baoanmobile-tdhl v2.1.0(AskUserQuestion 4 Phase 渐进式引导)两大生产级技能。双模式运行:手动模式全程
OA 邮件简报是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
同时注意输入完整性、执行条件和输出可用性。从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;
若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
v1.2.0 — 融合 email-daily-summary v3.0.7(68 pitfall + xlsx 解密 + 4 段分类)与 baoanmobile-tdhl v2.1.0(AskUserQuestion 4 Phase 渐进式引导)。专门适配 WorkBuddy 与 Hermes 两个智能体平台;IM 投递锁定 飞书 与 微信 Clawbot;Obsidian 入库为可选扩展(默认关闭)。
融合自 baoanmobile-tdhl v2.1.0。详见
references/tdhl-askuserquestion-pattern.md。
每个 Phase 需用户选择时,Agent 必须用 AskUserQuestion 工具弹选项框,禁止让用户回复编号或提示词。
每个问题必须包含:
[其他] 选项(label="其他(自定义)"),配自由输入框,multiSelect=false选项超 4 个时:取 TOP3 + [其他(自定义)]。
config.json,切换用户/邮箱/渠道只改此文件如果用户是首次使用,跳过完整 Phase 1,走快速路径:
Step 1(环境自检):
python scripts/check_deps.py
任何 fail 项由 Agent 自动修复(不抛命令给用户)。
Step 2(3 个关键配置,AskUserQuestion 一次问完):
Step 3(试运行):
python scripts/daily_pipeline.py # v1.3 规划 # 或 Agent 直接执行 Phase 2 工作流
试运行成功后,AskUserQuestion 询问是否设置每日定时(Phase 3)。
完整 5 步配置向导(含 xlsx 解密、KB 入库等高级选项)见下方 Phase 1。
| 触发源 | 模式 | AskUserQuestion | 输出 |
|---|---|---|---|
| 用户说"扫一下今天邮件" / "生成简报" | 手动(Phase 0→3) | ✅ 全程交互 | 长报告或 IM 分段 |
| 用户说"设置早报 cron" / "每天 8 点自动跑" | 定时设置(Phase 3) | ✅ 设置时交互 | automation_update / Hermes trigger |
| Automation 定时触发 | cron 运行 | ❌ 无人工 | IM 分段(≤195 字符/段) |
模式不清时用 AskUserQuestion 询问。
python scripts/check_deps.py
脚本输出 JSON 给 Agent 读取。Agent 根据 fail_count 决定下一步:
| 检查项 | fail 时 Agent 动作(不抛命令给用户) |
|---|---|
| Python 3.10+ | 自动安装 Python 3.10+ |
| config.json | 进入 Phase 1 配置向导 |
| Python pkg (openpyxl/xlrd/msoffcrypto) | 自动 pip install(xlrd 必须 ==1.2.0) |
| himalaya CLI | macOS: brew install himalaya / Linux: cargo install himalaya / Windows: 下载 release |
| himalaya config.toml | Agent 用 assets/himalaya-config.template.toml 自动创建,需用户提供 IMAP host + 授权码 |
| 输出渠道 | Phase 1 步骤 1.4 时配置 |
fail = Agent 必须自动修复,不给用户抛命令行。 warn = 不阻断,记录在后续步骤提示即可。
fail_count=0 → 进入 Phase 1(首次)或 Phase 2(已配置)。
铁律:每个步骤必须使用 AskUserQuestion,等待用户选择后再推进。
Agent 先尝试读取已配置的 himalaya 账号列表(himalaya account list)。AskUserQuestion 弹出:
如果未配置任何账号 → 直接询问:
中国移动OA邮箱 IMAP 配置(实测验证 ✅):
imap..chinamobile.com (按你所在省份替换 ,如 gd / bj / sh)smtp..chinamobile.com encryption.type = "tls"(隐式 TLS,不是 start-tls)imap.139.com 是 139 免费邮箱的,OA邮箱(@.chinamobile.com )不用这个assets/himalaya-config.template.tomlAskUserQuestion 询问时间范围:
用户选择后写入 config.json 的 scan.time_range_hours。
AskUserQuestion 询问是否启用 xlsx 解密:
选 2 → Agent 等待用户粘贴密码候选列表,写入 config.json 的 xlsx.password_candidates。
AskUserQuestion 问主渠道(单选):
第二轮:根据第一轮选择,AskUserQuestion 问具体参数:
oc_xxx)https://...)+ 可选 chat_idoutput/)Agent 写入 config.json,用 AskUserQuestion 展示确认摘要并询问:
KB 入库是低频可选功能,不在配置向导里主动问。想用的用户自行在
config.json设kb_ingest.enabled=true,详见下文"Obsidian 知识库入库"章节。
进入 Phase 2 前置校验:
email_account.login 非空(himalaya 模式)output.channel 已配置且对应参数非空scan.time_range_hours > 0# himalaya 路线(跨平台) himalaya envelope list --page-size 50 --page 1 --folder INBOX --output json > /tmp/oa_p1.json himalaya envelope list --page-size 50 --page 2 --folder INBOX --output json > /tmp/oa_p2.json himalaya envelope list --page-size 50 --page 3 --folder INBOX --output json > /tmp/oa_p3.json
--output json 返回单行 JSON(不是 JSONL),用 json.loads 整体解析--page-size 100 + --output json 可能 >60s,用 50 × 3 页更稳mcp__agent-mail__ListMessages,limit=50 每次业务关键词(命中即候选):考核 / 营销 / 渠道 / 产品 / 酬金 / 流程 / 系统 / 合规 / 商机 / 欠费 / 管理办法 / 规范 / 制度 / 实名制 / 反诈 / 稽核 / 通报 / 宽带 / 网格 / 异常 / 扣罚 / 评价 / 评优 / 重点 / 攻坚
非业务关键词(命中即跳过):福利 / 生日 / 工会 / 餐厅 / 实物兑换 / 端午节 / 体检 / 慰问 / 团建
规则:
关键词列表可在
config.json的filter段自定义,按业务实际增减。
himalaya message read# 单 ID 调用,~30s/封
himalaya message read 会同时显示多层转发历史,对溯源政策依据有用决策树:
.xlsx → 下载并解析.xls(不是 .xlsx)→ 用 xlrd==1.2.0,不用 openpyxlOLE2 解密失败时(手动模式触发 AskUserQuestion 分支决策):
cron 模式:跳过 + 标注"加密无法解密" + 从正文补充 + 写入"明日待查"段。
绝不伪造数据——解不开就解不开,不用估计值凑数。详见 references/xlsx-decryption-cookbook.md。
4 段式分类(内容过多触发 5/6 段升级):
| 段 | 标记 | 内容 |
|---|---|---|
| 1 | 🟥 今晚必办 | 今晚截止项,时间倒序,已过期红字 |
| 2 | 🟧 明天必办 | 明天截止项,含时间锚点 |
| 3 | 🟨 周末前必办 | 周末前必办项 |
| 4 | 📊 数据 | 数据快照、排名、环比 |
5 段触发:数据段 > 195 字符 或 中期节点 > 3 项 6 段触发:今天 ≥ 4 项 + 7 天内 ≥ 5 项 + 月末 ≥ 3 项 + xlsx 解析 ≥ 5 项
分段完成后,AskUserQuestion 展示并询问:
cron 模式:跳过此步,直接投递。
| 渠道 | 工具 | 限制 |
|---|---|---|
| 飞书 IM | WorkBuddy 飞书 connector / Hermes send_im_safe.py | ≤195 字符 / 30 行/段 |
| 飞书 DM | 同上 | ≤400 字符 / 50 行/段 |
| 微信 Clawbot | WorkBuddy Clawbot connector / Hermes webhook 适配器 | ≤500 字符/段 |
| Markdown | Write 工具 | 无限 |
投递前自检(所有渠道):
wc -m 每段(飞书群 ≤195,Clawbot ≤500)详见 references/im-delivery-protocol.md。
成功:
失败:
试运行成功后,AskUserQuestion 询问是否设置自动运行:
Agent 用 automation_update 工具创建定时任务:
scheduleType: recurringrrule: 根据用户选择生成 RFC 5545 规则prompt: 执行管线的完整指令cwds: 技能根目录路径三个默认 schedule:
| Schedule | RRULE | 内容 |
|---|---|---|
| 早报 | FREQ=DAILY;BYHOUR=8;BYMINUTE=0 |
今天截止 + 数据快照 |
| 晚报 | FREQ=DAILY;BYHOUR=18;BYMINUTE=0 |
今晚已过期 + 明天 + 周末 + 数据 |
| KB 入库(可选) | FREQ=WEEKLY;BYDAY=MO,TU,WE,TH,FR;BYHOUR=12;BYMINUTE=5 |
9 步流水线写 Obsidian(仅 kb_ingest.enabled=true 时) |
Agent 使用 Hermes 自身的定时触发器配置:
feishu:oc_xxx 或 clawbot:)基本没人用这个功能。仅当需要把邮件知识长期沉淀到 Obsidian 笔记库时才启用。默认
kb_ingest.enabled=false,不启用时 skill 完全可用。日报简报和 KB 入库是两个独立功能——日报看"今天有什么重要的",KB 入库看"这条知识要不要长期存"。大多数人只需要日报。
启用:config.json 设 kb_ingest.enabled=true + 填 vault_path。9 步流水线详见 references/kb-ingest-workflow.md。
什么邮件该入库(举例):
入库后笔记长什么样:见 assets/optional/obsidian-schema.template.md(含 frontmatter 模板 + 正文 4 段结构 + tag 分类表)。
从 v3.0.7 的 68 条中精选通用部分。详见
references/pitfall-library.md。
| # | Pitfall | Fix |
|---|---|---|
| 1 | himalaya --page-size 100 --output json 超 60s |
用 --page-size 50 × 3 页 |
| 2 | himalaya message read 批量必超时 |
单 ID 一次,串行不并行 |
| 3 | --output json 返回单行 JSON |
json.loads 整体解析 |
| 4 | 主题含业务+非业务关键词 | 仍按业务处理 |
| 5 | .xls 文件 openpyxl 打不开 |
用 xlrd==1.2.0 |
| 6 | OLE2 加密 xlsx 密码未知 | 试 40+ 候选;全失败标注"加密无法解密",绝不伪造 |
| 7 | wc -m 与 send_im_safe 实际计数差 +5~50 |
飞书群 ≤195 字符/段(不是 295/300) |
| 8 | Variation Selector emoji 触发安全扫描 | 用 🟥🟧🟨🟦🟪🔥📊📋📅⏰📌 |
| 9 | 同主题同日多封 = 系统重发 | 只取最早 1 封 |
| 10 | 同日 V4→V5→V6 多版本 | 取最后版本,旧版入 dedupe 不入笔记 |
| 11 | 内部 slang(业务术语外的随意缩写) | 用纯业务术语 |
| 12 | openpyxl 返回缓存公式值 | 用 data_only=True |
| 13 | 不同 xlsx "金额"列位置不同 | 必读前 3 行表头确认列号 |
| 14 | --check-only 实际会发送 |
auto-delivery cron 接受 4-6 段投递 |
| 15 | "归属"列为空 ≠ 不存在 | 区分"归属明确" vs "归属待定" |
tdhl-askuserquestion-pattern.md — tdhl v2.1.0 的 AskUserQuestion 模式精华implementation-analysis.md — v3.0.7 深度解读 + GitHub 对标 + 设计决策xlsx-decryption-cookbook.md — OLE2 解密代码模式 + 密码候选表模板 + 失败协议im-delivery-protocol.md — 飞书 + Clawbot + Markdown 分段规则 + 字符自检 + emoji 黑名单kb-ingest-workflow.md — 可选模块。9 步 Obsidian 入库流水线(仅 kb_ingest.enabled=true 时加载)pitfall-library.md — 15 条 pitfall 详细症状 + 修复 + 代码示例preflight-cross-platform.md — 平台特定 preflight 命令(macOS/Linux/Windows)check_deps.py — 环境自检脚本,输出 JSON 给 Agent 读取preflight_check.py — 5 项诊断(跨平台)xlsx_decrypt.py — 通用 OLE2 xlsx 解密im_segment.py — 分段写文件 + wc -m 自检 + Variation Selector emoji 扫描himalaya-config.template.toml — 跨平台 himalaya 配置模板optional/obsidian-schema.template.md — 可选模块。Obsidian 笔记 frontmatter schema(仅启用 KB 入库时使用)所有配置集中(邮箱账号 / 扫描参数 / 过滤关键词 / xlsx 密码 / 输出渠道 / 分类规则 / KB 入库开关 / 定时)。切换用户/邮箱/渠道只改此文件,不改代码。
✅ 使用:
❌ 不使用:
mcp__agent-mail__SendMessage)agent-mail connector(推荐)或 himalaya CLIautomation_update 工具创建 recurring 任务send_im_safe.py 飞书 / Clawbot webhook 适配器其他平台(Claude Code / Cursor / OpenClaw 等)不在 v1.2.0 适配范围内。
config.json 集中配置scripts/check_deps.py 环境自检email-daily-summary-pro → oa-mail-briefing(更通用)assets/optional/)scripts/daily_pipeline.py 一键管线(输出 JSON 给 Agent 读取)agent_created: true, MIT-equivalent internal use, distributable via WorkBuddy Skillhub team edition相关专题
热门下载
相关下载
精品课程
共6课时 | 54.7万人学习
共89课时 | 134.3万人学习
共49课时 | 82.7万人学习
最新文章