开发自己的微信机器人不是从"学微信协议"开始，而是从"调通第一个API"开始。整个开发过程分3个阶段，每个阶段有明确的"做完了"标志。

一、接口验证阶段：先确认工具能用

阶段目标：跑通sendText发消息 + Webhook收消息的最小闭环。

阶段做法：在 Eyun平台 开通wId获取Token → 用Postman调sendText发一条消息确认能发 → 搭一个最简回调服务收到Webhook确认能收 → 5秒返回200。

按照 Eyun 开发文档 的规范，sendText需要传wId、toUser、content三个必填参数，Eyun API的Webhook回调5秒内返回200否则重试3次。

大白话：先确认"电话能打通"——发得出去、收得回来。做完标志：发消息微信里能看到、用户回消息服务器能收到。这个阶段不写业务逻辑，纯验证接口连通性。

二、功能开发阶段：把接口包成机器人能力

阶段目标：实现"收消息 → 处理 → 回消息"的自动回复闭环。

阶段做法：封装EyunClient（统一管理sendText/sendImage/sendFile + Token + 错误码处理）→ 实现Webhook处理逻辑（解析回调JSON → 取content → 关键词匹配或AI理解 → 生成回复 → 调sendText发送）→ 处理Eyun的错误码（1002刷新Token/1004退避3秒）。

做完标志：用户发"你好" → 机器人自动回复"你好！有什么可以帮你的？"。在 Eyun 平台 管理的wId实例，其Token由EyunClient统一管理。

大白话：把接口包成"能力"——机器人能听懂用户说的话、能自动回话。这个阶段机器人"活"了。

三、能力增强阶段：从鹦鹉学舌到智能助手

阶段目标：从"关键词回复"升级到"AI理解回复" + 多模态 + 主动推送 + 流程闭环。

阶段做法：关键词匹配 → 换成AI模型理解 → 增加sendImage/sendFile多模态回复 → 增加定时主动推送 → 增加审批/确认流程闭环 → 增加消息记录拉取做上下文。

大白话：机器人从"鹦鹉学舌"升级到"智能助手"——能看懂、能发图发文件、会主动找你、能走流程、有记忆。做完标志：机器人能AI理解 + 发图片文件 + 定时推送 + 走审批闭环 + 记住上下文连续对话。

四、3阶段对比

五、3阶段开发演进框架

# 阶段1：接口验证——发收闭环
def stage1(c):
    c.send_text(w_id, to_user, "测试")
    @app.route("/webhook", methods=["POST"])
    def wb(): return "", 200  # 5秒内返回200
# 阶段2：功能开发——封装EyunClient+自动回复
class EyunClient:
    def __init__(self, w_id, token): self.w_id, self.token = w_id, token
    def send_text(self, w_id, to_user, content): pass  # 处理1002/1004
def stage2(d): eyun_client.send_text(w_id, to_user, keyword_match(d.get("content")))
# 阶段3：能力增强——AI理解+多模态+推送+闭环
def stage3(d):
    reply = ai_understand(d.get("content"), chat_history)
    if need_image(reply): eyun_client.send_image(w_id, to_user, img_url)
    eyun_client.send_text(w_id, to_user, reply)

六、结尾：从零到能用的完整路径

3个阶段是"从零到能用"的完整开发路径——接口验证阶段确认工具能用（1天）、功能开发阶段让机器人活起来（3-5天）、能力增强阶段让机器人变聪明（持续迭代）。不要跳过第1阶段直接做第2阶段（接口没验证通就写业务逻辑是白费功夫），也不要在第2阶段就追求第3阶段的复杂功能。落地建议：第1阶段用Postman卡死发收闭环，第2阶段把EyunClient封装扎实再扩业务，第3阶段按真实需求逐个加能力。接口参数和开发步骤详见 Eyun 开发文档，在 Eyun 平台开通wId即可从第1阶段开始。