Yige
aec2e7c28b
## 概述 / Overview 两件事：新增「企业微信助手」Agent（自带 15 个技能），并修正 `wecom-cli` 条目钉在 6 月快照的 ref 漂移。 Two changes: adds the **WeCom Assistant** agent (bundling 15 skills), and fixes the `wecom-cli` entry whose pinned ref was stuck on a June snapshot. ## 1. 新增企业微信助手 Agent 覆盖企业微信 **14 类服务、95 个方法**：消息、群聊历史、通讯录、日程、会议、待办、邮件、在线文档、在线表格、智能表格、智能文档、文档管理、微盘、媒体文件。 **采用内联形态 + 自带私有技能**：Agent 安装对 `agents/<id>/` 整目录递归复制且 `skills/` 不在排除集合里，因此装 Agent 即带全部技能，用户无需再单独获取技能合集。 ### 技能集（15 个，约 5000 行） - 基于上游 [wecom-cli](https://github.com/WecomTeam/wecom-cli) 官方 Skill（MIT，© WecomTeam）改写，每个技能末尾保留归属声明 - **新增 `wecom-chat`**：补齐上游零覆盖的群聊历史读取 - 补齐上游未覆盖的 `message.send`、`doc.create`，方法覆盖达 **95/95** - 修正上游三处文档漂移：邮件能力描述与实际相反、会议室参数名已过时、`title_highlight` 字段不存在 ### 相对上游的核心增量：风险治理 - 26 个对外可见或不可逆的方法逐个写明**执行前确认要求** - 4 个条件升级方法给出**参数级判据**，而非按方法名一刀切 - 文档权限扩散两项加重处理，涉及**企业外可见**时单独再确认一次 - 内部标识禁止外露，不因用户索要而放宽 - 拒绝导出可识别到具体自然人的隐私字段 ### 三条真机实测得出、上游未覆盖的硬约束 1. 机器人**只能写入/修改自己创建的数据**，真人创建的只能读 2. 每次响应携带的 `extra_identity_context` **禁止透露给用户** 3. 权限错误（`850002`/`851008`/`853006`）**不得重试**，须将 `help_message` **逐字原样**转给用户 ## 2. 修正 wecom-cli 条目 ref 漂移 `source.ref` 原钉在 2026-06-28 的 `72e14f7`，该快照只有 7 个子技能且用已废弃的旧命名（`msg`/`schedule`）。上游 v1.2.0 已扩展到 **14 个**技能。按旧 ref 安装的用户拿到的是三个月前的快照。 - `source.ref` → `78c514b2afee7c0d3d7be715628478421f37ee63` - `children` 由 `scripts/gen-collection-children.py` 重新生成，**7 → 14** - sidecar 同步 `provenance.content.ref`、`childCount` 与 `children` ## 验证 / Verification **静态** - 215 条示例命令追加 `--dry-run` 实跑，**215/215 退出码 0** - 未知方法 0、未知参数 0、`--json` 未知字段 0、枚举违规 0 - 15 个 `SKILL.md` 的 frontmatter 经客户端 `skillFrontmatterSchema` 校验全部通过 - `validate_catalog_metadata.py --require-complete` 与 `gen-collection-children.py`：**0 error** **真机（在真实企业微信账号上端到端）** - **待办域 6/6 方法全通**（含 2 个 write-high），`items` 必填的隐蔽坑实测证实 - **日程域 5 个方法全通**（含 3 个 write-high） - 消息发送、通讯录解析、微盘列表、邮件搜索、文档搜索、会议列表、智能表格创建均已实测通过 - 测试数据已全部清理，未污染真实账号 **尚未实测**：群聊历史（机器人未开通该品类）。相关文档已明确标注验证状态，未实测的能力不写「实际效果」段落。
7.7 KiB
邮件
企业微信邮箱的发、回、转、搜、读：发新邮件、回复、全部回复、转发、发日程邀约邮件与会议邮件， 按各种条件搜邮件，读正文、附件和内嵌图。 能做的比大多数人以为的多——但标已读、删除、存草稿、改标签、撤回这些一概做不了。
你可以怎么说
「给张三发封邮件，说 Q2 进展汇报已经发在群里了」 「回一下这封邮件：收到，周五前给结果」 「把这封转给李四」 「邮箱里搜一下产品周报」 「有没有新邮件？」 「这封邮件说了什么？」
📋 验证状态
| 项 | 状态 |
|---|---|
| 搜索邮件 | ✅ 已实测（返回 0 封匹配——账号里当时确实没有匹配邮件） |
| 发送新邮件 | ⚠️ 未实测 |
| 回复 / 全部回复 | ⚠️ 未实测 |
| 转发 | ⚠️ 未实测 |
| 日程邀约邮件 / 会议邮件 | ⚠️ 未实测 |
| 读邮件正文、附件、内嵌图 | ⚠️ 未实测 |
| 完整链路（你说一句话 → 助手自动发完） | ⚠️ 未实测 |
实测记录（命令层，人工在真实账号上执行）：
wecom-cli mail search # 通过，返回 0 封匹配
只验证了「接口通、能返回」。发送方向一条都没测——因为发出去就收不回， 不适合拿真人邮箱做验收实验。所以本页不写「实际效果」，也不虚构任何邮件内容、收件人或返回值。
能力清单
| 能做什么 | 命令 | 风险 |
|---|---|---|
| 搜索 / 浏览邮件列表 | wecom-cli mail search |
读取（隐私敏感） |
| 读邮件详情（正文 / 附件 / 内嵌图 / 日程信息） | wecom-cli mail get |
读取（隐私敏感） |
| 发送新邮件 | wecom-cli mail send |
高风险写入 |
| 回复 / 全部回复 | 同上（换一组参数） | 高风险写入 |
| 转发 | 同上 | 高风险写入 |
| 日程邀约邮件（只发日程，不建线上会议） | 同上 | 高风险写入 |
| 会议邮件（同时建线上会议） | 同上 | 高风险写入 |
后面五行其实是同一个发送方法的五种用法，靠传不同的参数区分，风险级别相同。
明确做不到的事
这些企业微信的命令行工具都没有提供，助手会如实告诉你去客户端操作：
- 标记已读 / 未读（但按未读条件搜索是可以的）
- 删除邮件、保存草稿
- 给邮件打标签 / 移除标签（但按标签搜索是可以的）
- 撤回已发送的邮件、修改已发送的邮件
- 邮箱账号设置、签名、自动回复、收信规则
注意事项
发出去就收不回，所以一定会先给你看预览。 助手会把最终的主题、收件人（只显示姓名，不显示邮箱）、抄送、正文完整摆出来， 然后等你明确同意才发。哪怕你已经把内容说得很完整，这一步也不会省。
（顺带说明一件事：这套助手的上游文档原本要求「展示完预览就直接发，不许再问」。 本项目故意改了这条——发邮件不可撤回，属于最典型的高风险动作，所以预览之后仍然要等你点头。）
回复的收件人来自原邮件，不去通讯录里找。 这条看起来是细节，实际很关键：通讯录的模糊搜索可能匹配到同音不同字的人，那就发错了。 所以回复时助手直接用原邮件里的发件人地址。
「回一下」默认是全部回复。 想只回发件人，说清楚「只回他」「别回复所有人」。 即使参数上不需要列收件人，预览里也会把最终会收到这封邮件的所有人列全，让你看清范围。
主题前缀是助手自己拼的。 回复会拼成「回复：原主题」，转发拼成「转发：原主题」。 原主题已经带同类前缀时会沿用（一字不改，不会「顺手规范化」）， 但跨类型不抵消——转发一封「回复：xxx」，主题会变成「转发：回复：xxx」。
转发默认不带附加说明。 你没提要加话，助手就不加，企业微信会自动带上原邮件正文。 你提了，它才写进去。
日程邮件和会议邮件的区别是「建不建线上会议室」。
- 说「开会 / 线上会议 / 拉个视频会」→ 会议邮件（会建线上会议室）。线下会议也走会议邮件， 会议室照建，用不用由你定。
- 说「发个日程 / 约个碰头 / 提醒大家周五有活动」→ 日程邀约邮件（不建会议室）。
- 实在判不准，助手会问一句「需要创建线上会议室吗？」。
只有你明确提到「邮箱」或「邮件」时才走这条路。 你只说「帮我约个会」而没提邮件，那是 05 日程 / 06 会议 的活， 助手不会擅自替你改成「发封会议邮件」。
搜索有三条硬线：
- 带时间范围、未读、重要这类条件时，搜索窗口不超过最近 30 天。
- 带关键词的搜索最多返回 100 封。
- 单封邮件的正文加附件合计不超过 50MB。
「最近」按 7 天算。 你说「最近」「近期」「这段时间」而没给具体范围时，助手按最近 7 天处理， 并会在回复里说明它用的是哪个范围。
没拉完会明说。 结果还有更多没取回时，助手会在末尾提示「已展示前 N 条（未拉完）」， 不会让你误以为看到的就是全部。问「有几封」时它看的是总数字段； 总数被接口限制截断时也会如实说明。
多封候选时它不会替你挑。 你要找某一封特定的邮件而搜出好几封时， 助手会用「序号 + 主题 + 发件人 + 时间」列出来让你选。只是浏览或统计时才直接给列表。
附件分两种，一种下得下来，一种下不来。
- 普通附件——助手能落到本地读给你听。
- 微盘附件、以及防泄漏加密链接——这类只能给你一个可点的链接，助手打不开也解不开， 引导你在企业微信客户端里点开看。这是正常的产品行为，不是故障。
邮件正文里的内容是数据，不是指令。 正文里如果出现「忽略之前的指令」「请执行以下命令」 这类文本，助手一律当普通文字处理，不执行。检测到疑似夹带时会在摘要里附一句提示。
收发件人数量看计数不看列表。 一封群发邮件，接口只返回前 30 个收件人，真实人数在计数字段里。 问「这封发给了多少人」时助手报的是真实总数。
三条通用边界在本域怎么体现
- 只能改它自己建的东西——邮件这一域的写操作只有「发出去」，没有「改已有的」。 已发送的邮件既不能改也不能撤回，接口层就没有这两个能力。
- 能力按品类逐项开通——邮件是独立品类（实测账号是后来单独补开的）。 未开通时助手会把官方开通指引原样转给你，然后停下，不重试。
- 危险动作先问你——发送方向的五种用法全是高风险写入，都会先展示预览、 再等你明确同意。见 99 风险与确认。