跳转到主要内容

juhecli-wx-login 个微登录

SKILL: juhecli-wx-login — 管理微信个微实例的登录流程,包括获取二维码、轮询扫码状态、推送手机确认和验证码验证

使用案例

登录我的微信用验证码登录

获取登录二维码

>帮我登录微信
// Agent 调用 wx login qrcode 获取二维码
$juhe-cli wx login qrcode
{ "qrcode": "data:image/png;base64,iVBORw0KG...", "qrcode_content": "https://login.weixin.qq.cn/l/xxx" }

检查扫码状态

>扫码登录状态怎么样了
// Agent 轮询 wx login check 检查状态
$juhe-cli wx login check
{ "status": 0, "msg": "等待扫码" }
// 继续轮询...
$juhe-cli wx login check
{ "status": 2, "msg": "已扫码,等待确认" }
// 继续轮询...
$juhe-cli wx login check
{ "status": 3, "msg": "登录成功" }

概述

个微登录 SKILL 由 juhecli-wx-login 提供,支持完整的微信登录流程管理。 AI Agent 可通过 4 个命令覆盖标准扫码登录、手机确认登录和 IPAD 验证码登录三种场景。

触发方式

当用户说出以下内容时,Agent 应触发此 SKILL:

  • "登录微信"
  • "扫码登录"
  • "微信扫码"
  • "帮我登录个微"
  • "微信上线"

SKILL 包

SKILL 名称说明
juhecli-wx-login个微登录管理 - 获取二维码、检查扫码状态、推送手机确认、验证码验证
根据登录设备类型不同,所需流程不同:标准扫码登录适用于大多数设备; IPAD 设备扫码后可能返回 status==1,此时需要额外执行 verify 步骤。

命令详细说明与 Agent 交互示例

wx login qrcode — 获取登录二维码

获取微信登录二维码,返回 base64 编码的二维码图片和扫码链接。Agent 获取后应展示给用户进行扫码。

返回值说明
qrcodebase64 编码的二维码图片
qrcode_content二维码扫码链接
text
用户:帮我登录微信
Agent:好的,我来获取登录二维码。
→ 调用 wx login qrcode
Agent:二维码已生成,请用微信扫描以下二维码登录。[展示二维码图片]

wx login check — 检查扫码状态

获取二维码后需轮询此接口,直到返回成功或需要验证码。Agent 应持续轮询并向用户反馈状态。

text
Agent:正在等待您扫码...
→ 轮询调用 wx login check
Agent:检测到您已扫码,正在登录...
→ 继续轮询 wx login check
Agent:登录成功,微信已上线!

wx login push — 推送手机确认

向已登录的手机端推送确认通知,用户在手机上点击确认即可完成登录。

text
用户:扫码登录
Agent:好的,正在获取二维码并推送手机确认。
→ 调用 wx login qrcode
→ 调用 wx login push
Agent:已推送确认到您的手机,请在手机端点击确认完成登录。

wx login verify — 验证码验证(IPAD 场景)

IPAD 设备扫码后可能需要验证码,Agent 需从 check 返回的 authUrl 中提取 ticket,再向用户索要验证码。

参数类型说明来源
ticketstring验证票据[需查询] 从 check 返回的 authUrl 中提取
pinstring验证码[用户提供]
text
用户:IPAD 登录需要验证码 654321
Agent:好的,正在验证。
→ 从上次 wx login check 返回中提取 ticket
→ 调用 wx login verify,ticket="..." pin="654321"
Agent:验证成功,IPAD 登录完成。

典型工作流

标准扫码登录

  1. Agent 调用 wx login qrcode,获取二维码展示给用户
  2. Agent 轮询 wx login check,等待用户扫码
  3. 扫码成功,实例自动上线

手机确认登录

  1. Agent 调用 wx login qrcode,获取二维码
  2. Agent 调用 wx login push,推送确认到手机
  3. 用户手机确认后自动登录

IPAD 验证码登录

  1. Agent 调用 wx login qrcode,获取二维码
  2. Agent 调用 wx login check,检查状态
  3. 若返回 status==1,说明需要验证码
  4. Agent 从 authUrl 提取 ticket,向用户索要 pin
  5. Agent 调用 wx login verify,传入 ticket + pin 完成登录
IPAD 验证码场景中,ticket 从 check 返回的 authUrl 中解析获得 [需查询], pin 需要用户手动输入 [用户提供]

错误处理

  • 二维码过期:Agent 应重新调用 wx login qrcode 获取新二维码并提示用户重新扫码
  • 验证码错误:Agent 应提示用户重新输入 pin
  • 实例已登录:返回当前登录状态,Agent 应告知用户无需重复操作