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） - 消息发送、通讯录解析、微盘列表、邮件搜索、文档搜索、会议列表、智能表格创建均已实测通过 - 测试数据已全部清理，未污染真实账号 **尚未实测**：群聊历史（机器人未开通该品类）。相关文档已明确标注验证状态，未实测的能力不写「实际效果」段落。
9.4 KiB
智能表格
企业微信里结构最像数据库的载体：子表 = 表，字段 = 列，记录 = 行，另外还有视图（筛选/排序/分组/列宽/填色） 和仪表盘图表两层展示配置。建表、查数、加减列、增删改记录、做看板都在这里。 这是整套能力里方法最多、能做的事最丰富的一域——也是删除类操作最集中的一域。
未指明类型的表格需求默认走这里；只有你明说「在线表格」或给出 /sheet/ 链接，
才会转 10 在线表格。
你可以怎么说
「帮我建个项目管理表」 「加一列『预算』」 「加条记录：登录优化，负责人张三，9 月 15 号截止」 「把『登录优化』的状态改成已完成」 「统计一下各部门各多少条」 「做个看板，加个月度销售趋势图」
📋 验证状态
| 项 | 状态 |
|---|---|
| 新建智能表格 | ✅ 已实测 |
| 读表基本信息与子表结构 | ✅ 已实测：返回 1 张子表 / 5 个字段 / 5 条记录 |
| 查字段列表与属性 | ⚠️ 未实测 |
| SQL 查数 / 读记录 | ⚠️ 未实测 |
| 新增 / 修改 / 删除记录 | ⚠️ 未实测 |
| 新增 / 修改 / 删除字段 | ⚠️ 未实测 |
| 新增 / 改名 / 删除子表 | ⚠️ 未实测 |
| 视图与仪表盘图表 | ⚠️ 未实测 |
| 导入 Excel / CSV 建表 | ⚠️ 未实测 |
| 完整链路（你说一句话 → 助手自动建完） | ⚠️ 未实测 |
实测记录（命令层，人工在真实账号上执行）：
wecom-cli smartsheet create ... # ✅ 建出一张智能表格，标识以 s3_ 开头
wecom-cli smartsheet sheets list ... # ✅ 返回子表结构：1 张子表 / 5 个字段 / 5 条记录
这一条同时印证了一个坑：建表时指定名称的参数是 name 而不是 doc_name——
实测中人工凭常识写成 doc_name 直接失败，技能文档写的是对的。
只验到「建表 + 读结构」两步。 记录、字段、视图、图表的增删改一条都没跑， 所以本页不写「实际效果」，也不虚构任何记录内容或返回值。 下面「能力清单」与「注意事项」来自接口定义与技能文档，是设计意图，不是实测结论。
测试数据处置：命令行没有删除文档的接口，测试用的智能表格已重命名为 「【可删除】DesireCore验收测试-*」，需要在企业微信里手动删除。
能力清单
除「新建」与「读子表结构」外均未实测。
| 能做什么 | 命令 | 风险 |
|---|---|---|
| 新建智能表格（可一次建好子表 + 字段） | wecom-cli smartsheet create |
低风险写入 |
| 导入 Excel / CSV 建表（或追加到已有表） | wecom-cli smartsheet import |
低风险写入 |
| 看表基本信息 + 子表列表 | wecom-cli smartsheet sheets list |
读取 |
| 新增子表 / 仪表盘 | wecom-cli smartsheet sheets add |
低风险写入 |
| 改子表名 | wecom-cli smartsheet sheets update |
高风险写入 |
| 删子表 | wecom-cli smartsheet sheets delete |
高风险写入 |
| 查字段列表与属性 | wecom-cli smartsheet fields list |
读取 |
| 新增字段 | wecom-cli smartsheet fields add |
低风险写入 |
| 改字段（名称 / 属性 / 类型） | wecom-cli smartsheet fields update |
低风险写入（改类型时升为高风险） |
| 删字段 | wecom-cli smartsheet fields delete |
高风险写入 |
| 用 SQL 查数（支持聚合、TopN） | wecom-cli smartsheet records query |
读取 |
| 读记录（权限受限时的读法） | wecom-cli smartsheet records list |
读取 |
| 新增记录 | wecom-cli smartsheet records add |
低风险写入 |
| 改记录 | wecom-cli smartsheet records update |
高风险写入 |
| 删记录 | wecom-cli smartsheet records delete |
高风险写入 |
| 查 / 新增 / 修改视图 | wecom-cli smartsheet views list / add / update |
读取 / 低风险写入 |
| 删视图 | wecom-cli smartsheet views delete |
高风险写入 |
| 查 / 新增 / 修改仪表盘图表 | wecom-cli smartsheet charts list / add / update |
读取 / 低风险写入 |
| 删图表 | wecom-cli smartsheet charts delete |
高风险写入 |
| 上传图片 / 文件到文档空间 | wecom-cli smartsheet images / files upload |
低风险写入 |
整套能力的 26 个高风险动作里，有 7 个集中在这一域。删除类操作没有任何回滚通道， 客户端也不提供恢复接口。
搜索表格、改表格文件名不在这里——那两件事归 13 文档管理。 本域的「改子表名」改的是子表，不是整个文件的名字。
注意事项
删除类操作最集中，也最不可逆。 记住这三条：
- 删一列 = 连带删掉这一列的全部数据。 助手会告诉你「该列已有的全部数据会一并丢失」。
- 删一张子表 = 里面的字段和记录一起没。 助手会先数一数有多少字段、多少条记录再告诉你。
- 删视图 = 那套筛选、排序、分组、列宽、填色配置没了，只能手工重建。
「删全部」「清一下」这种说法它不会动手。 描述模糊时助手会先问清范围和保留条件—— 「删除 2026 年 3 月之前的记录」「只保留状态为已完成的行」这种才算说清楚了。
一次改超过 100 条记录，即使是普通修改也会先问你一句，说明影响范围。 另外单次修改最多影响 2000 行，超过要分批。
改字段类型是隐蔽的高风险动作。 只改列名、改显示属性是可逆的，助手直接做； 但改字段类型会让企业微信对已有单元格做转换甚至直接丢弃（比如文本改成数字时， 非数字内容就没了）。所以助手会先读回这个字段当前的类型，跟你要改成的类型比对， 不一致就按高风险处理，先告诉你「该列已有的 N 条数据可能被转换或清空」。
写记录之前它会先读几条现有的。 目的是对齐用词——避免造出「进行中」和「处理中」两套并存的脏数据。
统计交给服务端算，不拉全量回来数。 「统计一下各部门多少条」这类问题，助手会用 SQL 让企业微信 算完再返回。超过 1000 行的求和、计数、排名它不会自己心算。
只做描述性统计，不做因果和预测。
- ✅ 各部门工单数排名、本月销售额 TopN、按状态分组统计、同比环比的数值计算
- ❌ 「为什么 A 部门工单这么多」「下个月销售额预测」「这数据反映了什么问题」「建议怎么优化」
「标红 / 高亮 / 加底色」是真的改表，不是在回复里加粗。 助手会去改视图的条件格式配置，让你在企业微信里打开就能看到颜色。
能由其他列算出来的值，它会建议用公式列。 比如「剩余天数」「完成率」—— 你没指定类型时它直接用公式列；你指定了别的类型，它说明公式列的好处之后听你的。
建表时它会顺手做两件事：清掉新建时自带的空记录，以及按内容长度给每列设个合适的宽度。
有上限：单张子表最多 20000 条记录、150 个字段。接近上限时助手会提前告诉你。
这些做不到（会直接说明，不变通）：
- 历史版本、时间点快照、查看修改历史或操作日志
- 恢复已删除的记录、字段、子表
- 导出为 Excel / CSV
- 删除智能表格文件本身
- 插入 AI 字段、写入地理位置字段、写入群字段（引导你在客户端手动做）
参考别人的表 ≠ 往别人的表里写。 你说「参考 X 表的格式」时，助手会读 X 的字段结构， 然后建一张新表往新表写，不会往 X 里写。
三条通用边界在本域怎么体现
- 只能改它自己建的东西——你自己建的那张智能表格，助手改不了：加不了列、写不进记录。 它会说明这条边界，并建议「由我新建一张」或者你自己在客户端改。 实测的建表 + 读结构就是在助手自己建的表上完成的。
- 能力按品类逐项开通——智能表格属于文档品类。未开通时助手会把官方开通指引原样转给你， 然后停下，不重试。另外，你对这张表没有全部权限时，SQL 查数会被拒， 助手会自动降级成按你可见范围读记录，而不是报错了事。
- 危险动作先问你——7 个高风险写入 + 1 个条件升级，每个执行前都会复述具体影响 （删哪一列 / 哪张子表 / 多少条记录）并等你明确同意。见 99 风险与确认。