juhecli-login 企微登录
juhecli-login — 企微登录管理：获取登录二维码、轮询扫码状态、自动登录
使用案例
帮我登录企业微信自动登录重新扫码登录
获取登录二维码
通过 guid 获取企微登录二维码
>帮我登录企业微信
// Agent 先通过 device list 获取 guid
$juhe-cli login qrcode --guid xxxx-xxxx-xxxx
{
"data": {
"qrcode_base64": "iVBORw0KGgo...base64编码的二维码图片...",
"scan_url": "https://login.work.weixin.qq.com/xxxx?key=yyyy",
"key": "yyyy-yyyy-yyyy"
}
}
// Agent 将二维码展示给用户扫码
检查登录状态
轮询检查用户是否已扫码确认
>扫码完成了，检查一下状态
$juhe-cli login check --guid xxxx-xxxx-xxxx
{
"data": {
"status": "confirmed",
"uin": "1688856900xxxxxx",
"nickname": "张三"
}
}
// status: waiting=等待扫码, scanned=已扫码, confirmed=已确认, expired=已过期
自动登录
使用已保存的会话自动恢复登录
>自动登录
// Agent 使用缓存的 guid 尝试自动恢复会话
$juhe-cli login auto_login --guid xxxx-xxxx-xxxx
{
"data": {
"status": "success",
"uin": "1688856900xxxxxx",
"nickname": "张三"
}
}
概述
企微登录 SKILL 提供企业微信登录相关的三个命令：获取登录二维码、检查扫码状态和自动登录。 这是使用其他企微功能（联系人、消息、群组等）的前提条件。 AI Agent 需要先通过设备管理 SKILL 获取 guid，然后使用此 SKILL 完成登录。
SKILL 定位
此 SKILL 是企微功能的入口。登录成功后，AI Agent 才能调用联系人、消息、用户等其他企微 SKILL。
触发方式
用户可能会这样自然地表达需求：
- "登录企业微信"
- "扫码登录"
- "重新登录"
- "自动登录"
- "帮我登录企微"
命令列表
| SKILL 名称 | 说明 |
|---|---|
juhecli-login | 企微登录管理 - 获取二维码、检查扫码状态、自动登录 |
详细命令说明
获取登录二维码 (login qrcode)
获取企业微信登录二维码。返回 base64 编码的二维码图片和扫码链接，用户需使用企业微信扫码完成登录。AI Agent 会将二维码展示给用户。
参数
| 参数 | 类型 | 必填 | 来源 | 说明 |
|---|---|---|---|---|
guid | string | 是 | [需查询] | 设备管理 SKILL 的返回值 |
verify_login | boolean | 否 | [用户提供] | 用户可选择是否验证登录状态，默认 false |
返回值
qrcode_base64— base64 编码的二维码图片（Agent 展示给用户）scan_url— 扫码链接（备用方式）- 登录会话信息
检查登录状态 (login check)
轮询检查当前扫码状态。AI Agent 获取二维码后，应定期调用此命令检查用户是否已扫码确认。
参数
| 参数 | 类型 | 来源 | 说明 |
|---|---|---|---|
guid | string | [需查询] | 来自设备管理 SKILL |
返回状态
| 状态 | 说明 | Agent 应对 |
|---|---|---|
waiting | 等待扫码 | 继续轮询 |
scanned | 已扫码，等待确认 | 提示用户在手机上确认 |
confirmed | 已确认，登录成功 | 通知用户登录成功 |
expired | 二维码已过期 | 重新调用 qrcode 命令 |
自动登录 (login auto_login)
使用之前已保存的登录信息自动恢复会话，无需重新扫码。适用于之前已成功登录过的实例。
参数
| 参数 | 类型 | 来源 | 说明 |
|---|---|---|---|
guid | string | [需查询] | 来自设备管理 SKILL |
自动登录条件
自动登录需要之前已成功登录过，且登录会话未过期。如果自动登录失败，需要重新走扫码登录流程。
Agent 交互示例
扫码登录
text
用户: "登录企业微信"
AI: 好的，正在为您获取登录二维码...
[Agent 调用 login qrcode]
请使用企业微信扫描以下二维码登录：
[展示二维码图片]
等待您扫码中...
[Agent 定期调用 login check 轮询状态]
→ waiting（等待扫码...）
→ scanned（已扫码，请在手机上确认...）
→ confirmed
登录成功！欢迎使用企业微信。自动登录
text
用户: "自动登录"
AI: 好的，正在尝试自动恢复登录状态...
[Agent 调用 login auto_login]
已自动恢复登录状态，无需重新扫码。现在可以正常使用企微功能了。重新登录
text
用户: "重新登录"
AI: 好的，为您重新获取登录二维码...
[Agent 调用 login qrcode]
请扫描新的二维码：
[展示二维码图片]
[Agent 轮询 login check]
→ confirmed
重新登录成功！参数来源说明
| 参数 | 来源标记 | 获取方式 |
|---|---|---|
guid | [需查询] | Agent 通过 device list 获取 |
verify_login | [用户提供] | 用户指定，默认 false |
典型工作流
扫码登录流程
- Agent 通过
device list获取 guid - Agent 调用
login qrcode获取二维码 - Agent 将二维码展示给用户
- Agent 定期调用
login check轮询状态 - 检测到
confirmed后通知用户登录成功
自动登录流程
- Agent 通过
device list获取 guid - Agent 调用
login auto_login尝试恢复会话 - 如果成功，直接可以使用企微功能
- 如果失败，自动切换到扫码登录流程
错误处理
| 错误 | 原因 | 处理方式 |
|---|---|---|
| guid 未配置 | 未获取设备 GUID | 先调用 device list 获取 guid |
| 二维码过期 | 超过有效时间未扫码 | 重新调用 login qrcode 获取新二维码 |
| 自动登录失败 | 会话已过期 | 改用扫码登录流程 |
| 网络错误 | API 不可达 | 检查网络连接，稍后重试 |
登录有效期
企业微信登录会话有有效期限制。过期后需重新扫码登录。 AI Agent 应在登录失败时自动尝试扫码登录作为兜底方案。