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 获取后应展示给用户进行扫码。
| 返回值 | 说明 |
|---|---|
qrcode | base64 编码的二维码图片 |
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,再向用户索要验证码。
| 参数 | 类型 | 说明 | 来源 |
|---|---|---|---|
ticket | string | 验证票据 | [需查询] 从 check 返回的 authUrl 中提取 |
pin | string | 验证码 | [用户提供] |
text
用户:IPAD 登录需要验证码 654321
Agent:好的,正在验证。
→ 从上次 wx login check 返回中提取 ticket
→ 调用 wx login verify,ticket="..." pin="654321"
Agent:验证成功,IPAD 登录完成。典型工作流
标准扫码登录
- Agent 调用
wx login qrcode,获取二维码展示给用户 - Agent 轮询
wx login check,等待用户扫码 - 扫码成功,实例自动上线
手机确认登录
- Agent 调用
wx login qrcode,获取二维码 - Agent 调用
wx login push,推送确认到手机 - 用户手机确认后自动登录
IPAD 验证码登录
- Agent 调用
wx login qrcode,获取二维码 - Agent 调用
wx login check,检查状态 - 若返回
status==1,说明需要验证码 - Agent 从 authUrl 提取 ticket,向用户索要 pin
- Agent 调用
wx login verify,传入 ticket + pin 完成登录
IPAD 验证码场景中,ticket 从 check 返回的 authUrl 中解析获得
[需查询], pin 需要用户手动输入 [用户提供]。错误处理
- 二维码过期:Agent 应重新调用
wx login qrcode获取新二维码并提示用户重新扫码 - 验证码错误:Agent 应提示用户重新输入 pin
- 实例已登录:返回当前登录状态,Agent 应告知用户无需重复操作