能力要按通道能稳定执行的动作列，不要按采购名词列。个人微信 API、个人微信机器人、个人微信 RPA 在工程上对应的是同一组动作：登录存活、出站投递、入站事件、素材、会话资料、朋友圈互动。合同和验收必须落到其中一类。混在一起无法联调，演示却可以看起来「都有了」。

验收勾动作，不勾名词。名词可以很长，本期能稳住的往往只有两三项。

通道侧先勾这些

登录与存活。号实例能上线、能被检测掉线、掉线可告警。没有这一项，后面所有调用都是假失败。个人号绑在一台设备上，休眠会直接让存活变假。远程桌面抢焦点也一样。HTTP 还通，节点已经停，属于设备层故障。

出站文本。指定号、指定会话（好友或群）、投递已渲染文本、回执带会话类型。这是通路探针。文本不通，不要测图片和朋友圈。探针失败时改素材参数，是在错误层排障。

第一期只验证文本探针。字段按文档：appId、toWxid、content。

# 完整地址以文档为准
payload = {
    "appId": app_id,
    "toWxid": test_wxid,  # 先测好友，不要一上来打群
    "content": "能力验收：文本探针",
}
# 成功以手机可见为准，再勾下一张能力表

这段通了，只勾「出站文本」。不要把朋友圈、拉群画进同一张表。toWxid 填群 ID 去证明私聊能力，验收会漂。

出站素材。上传与发送拆开。本地路径不是合法内容。原图过大常常只表现为超时。同一素材多会话应复用，避免版本分裂。

入站事件。消息到达、好友关系变化、进群等。事件可能重复，消费侧必须幂等。回会话是另一跳，不要和入站写在同一个重试器。自己发出的消息也会回调，不判断就会自反馈。

会话资料。标签、备注。主数据在业务库，通道只执行。两边各发明一套枚举会对不上。

朋友圈。可见范围、素材、互动是另一组动作。出站文本通了，不代表圈能发。第一期不要和私聊投递绑在同一张验收表上。新设备登录后一段时间圈功能可能不可用，文档有说明，不要当发送接口坏了。

桌面点击不是通道能力。好友未通过就出站、群闲聊全回、圈下发广告链，都不要列入第一期。多号必须按实例隔离，不能共用一个客户端单例当「能力已通」。单例通了，只是串号通了。

能力怎么验收才算齐

每项单独给测试会话，单独给失败分类：通道不可用、对象不对、明确拒绝、不确定。私聊成功不能画进群清单。演示用的会话类型写进记录。接得快不等于映射表和回执齐。映射错只是错得更快。

测试号与生产号隔离。合同只写本期动作。开放列表可以很长，第一期勾全表，失败无法归因。排期按项走：先登录和文本，再素材和入站，最后资料和朋友圈。

查看个人微信 API 文档：
https://doc.geweapi.com/