聚合智能
juhe-cli 开放平台
返回首页

juhecli-wx-client 个微客户端

SKILL: juhecli-wx-client — 管理微信个微实例的客户端生命周期，包括恢复实例、停止实例、查询状态版本、设置通知地址代理桥接等操作

使用案例

查看微信登录状态停止微信客户端

检查实例状态

查询当前微信实例的运行状态
>查看微信实例是否在线
// Agent 调用 wx client status 查询实例状态
$juhe-cli wx client status '{}'
{ "status": 2, "msg": "实例已在线" }

恢复实例

恢复已停止的微信实例
>帮我恢复微信实例
// Agent 先检查状态，再恢复实例
$juhe-cli wx client status '{}'
{ "status": 0, "msg": "实例已停止" }
$juhe-cli wx client restore '{"proxy": "", "is_login_proxy": false, "bridge": "", "sync_history_msg": true, "auto_start": true}'
{ "status": 0, "msg": "恢复成功" }

概述

个微客户端 SKILL 由 juhecli-wx-client 提供，支持微信个微实例的完整生命周期管理。 包括实例恢复、停止、状态查询、版本获取、通知地址设置、代理配置、桥接设置和实例升级等 8 个命令。

与企微客户端不同，个微客户端独有 is_login_proxy、is_long_proxy 参数， 以及 status、version 命令，使用时需注意区分。

SKILL 包

SKILL 名称说明
juhecli-wx-client个微客户端管理 - 恢复/停止实例，查询状态/版本，设置通知地址/代理/桥接

触发方式

当用户提出以下意图时，Agent 应激活此 SKILL：

  • "启动微信实例" / "恢复实例" / "上线微信"
  • "查看实例状态" / "微信在线吗" / "实例运行情况"
  • "设置回调地址" / "配置通知 URL"
  • "设置代理" / "配置 socks5 代理"
  • "设置桥接" / "配置桥接 ID"
  • "查看版本" / "升级实例" / "更新版本"
  • "停止实例" / "下线微信"

详细说明

恢复实例 (restore)

恢复微信个微实例到正常运行状态，支持代理、桥接、历史消息同步等配置。

bash
wx client restore '{"proxy": "", "is_login_proxy": false, "bridge": "", "sync_history_msg": true, "auto_start": true}'

参数：

  • proxy (string, 可选) — 代理地址，支持 http/socks4/socks5 格式 [用户提供]
  • is_login_proxy (bool, 可选) — 是否使用登录代理 [个微独有] [用户提供]
  • bridge (string, 可选) — 桥接 ID [用户提供]
  • sync_history_msg (bool, 可选) — 是否同步历史消息，默认 true
  • auto_start (bool, 可选) — 是否自动启动，默认 true

停止实例 (stop)

停止当前运行的微信实例，释放资源。

bash
wx client stop '{}'

获取实例状态 (status)

查询当前微信实例的运行状态，此命令为个微独有。

bash
wx client status '{}'

返回值：

  • status 字段：0=已停止, 1=运行中, 2=已在线
status=0 表示实例已停止，需要 restore；status=1 表示正在运行但尚未上线；status=2 表示已正常在线，可以进行消息收发等操作。

获取实例版本 (version)

获取当前微信实例的版本信息，此命令为个微独有。

bash
wx client version '{}'

设置通知地址 (set_notify_url)

设置消息事件回调通知地址，设置后微信实例会将消息事件推送至指定 URL。

bash
wx client set_notify_url '{"notify_url": "https://example.com/callback"}'

参数：

  • notify_url (string, 必填) — 回调通知 URL [用户提供]

设置代理 (set_proxy)

为微信实例配置代理，支持 http、socks4、socks5 协议。

bash
wx client set_proxy '{"proxy": "socks5://127.0.0.1:1080", "is_long_proxy": false}'

参数：

  • proxy (string, 必填) — 代理地址 [用户提供]
  • is_long_proxy (bool, 可选) — 是否为长代理 [个微独有] [用户提供]

设置桥接 ID (set_bridge)

bash
wx client set_bridge '{"bridge": "bridge-id"}'

参数：

  • bridge (string, 必填) — 桥接 ID [用户提供]

升级实例 (update)

升级微信实例版本，仅支持升级不支持降级。

bash
wx client update '{"new_client_type": 1}'

参数：

  • new_client_type (int, 必填) — 目标版本类型 [用户提供]
升级操作不可逆，请确认新版本类型正确后再执行。

与企微客户端差异

特性企微客户端个微客户端
restore 的 is_login_proxy无有
set_proxy 的 is_long_proxy无有
status 命令无有（返回 0/1/2）
version 命令无有

参数来源说明

参数来源标记获取方式
proxy[用户提供]用户直接提供代理地址
is_login_proxy[用户提供]用户确认是否使用登录代理
is_long_proxy[用户提供]用户确认是否为长代理
bridge[用户提供]用户提供桥接 ID
notify_url[用户提供]用户提供回调地址
new_client_type[用户提供]用户提供目标版本类型
status[来自 status 返回值]调用 wx client status 获取

典型工作流

实例状态检查与恢复

  1. wx client status — 检查实例当前状态
  2. 若 status=0（已停止）：wx client restore — 恢复实例
  3. wx client status — 确认恢复成功（status=2 表示已在线）

配置代理并启动

  1. wx client set_proxy — 设置代理（如需代理）
  2. wx client set_notify_url — 设置消息回调地址
  3. wx client restore — 恢复实例并启动
  4. wx client status — 确认实例在线

实例维护

  1. wx client version — 检查当前版本
  2. wx client update — 升级到新版本
  3. wx client version — 确认升级成功

AI Agent 调用示例

wx client restore

text
// 用户：帮我启动微信实例
AI: 好的，我先检查实例状态。
[调用 wx client status]
→ status=0（已停止）

[调用 wx client restore {"proxy":"","is_login_proxy":false,"bridge":"","sync_history_msg":true,"auto_start":true}]

[调用 wx client status]
→ status=2（已在线）

AI: 实例已成功上线，可以正常使用。

wx client status

text
// 用户：查看微信实例状态
AI: 好的，我来检查。
[调用 wx client status]
AI: 当前实例状态：已在线（status=2），实例运行正常。

wx client set_proxy

text
// 用户：设置代理 socks5://127.0.0.1:1080，使用长代理
AI: 好的，我来设置代理。
[调用 wx client set_proxy {"proxy":"socks5://127.0.0.1:1080","is_long_proxy":true}]
AI: 代理设置成功！

wx client set_notify_url

text
// 用户：设置消息回调到 https://myserver.com/callback
AI: 正在设置通知地址...
[调用 wx client set_notify_url {"notify_url":"https://myserver.com/callback"}]
AI: 通知地址设置成功！实例消息事件将推送至该地址。

wx client update

text
// 用户：查看当前版本
AI: 我来查询当前实例版本。
[调用 wx client version]
AI: 当前版本：v3.2.1

// 用户：升级到新版本
AI: 好的，我来执行升级操作。
[调用 wx client update {"new_client_type":1}]
[调用 wx client version]
AI: 升级成功！当前版本已更新至 v3.3.0

完整工作流：启动微信并配置代理

text
// 用户：帮我启动微信并配置代理
AI: 好的，我先检查实例状态。

[步骤 1: 检查状态]
[调用 wx client status] → status=0（已停止）

[步骤 2: 设置代理]
[调用 wx client set_proxy {"proxy":"socks5://127.0.0.1:1080","is_long_proxy":false}]

[步骤 3: 设置通知地址]
[调用 wx client set_notify_url {"notify_url":"https://myserver.com/callback"}]

[步骤 4: 恢复实例]
[调用 wx client restore {"proxy":"","is_login_proxy":false,"bridge":"","sync_history_msg":true,"auto_start":true}]

[步骤 5: 确认状态]
[调用 wx client status] → status=2（已在线）

AI: 实例已成功上线！代理和通知地址均已配置完成。

错误处理

  • 实例不存在：返回错误，需要先通过 device 管理创建实例
  • 重复恢复：提示实例已运行，无需重复操作
  • 升级失败：版本类型无效或已是最高版本，检查 new_client_type
  • 代理连接失败：检查代理地址格式和连通性
  • status 长期为 1：实例运行中但未上线，检查网络或代理配置
建议在执行关键操作前先调用 wx client status 检查实例状态， 避免在实例离线时执行消息操作。恢复实例后等待 status=2 再进行后续操作。