juhecli-client 企微客户端

使用案例

概述

企微客户端 SKILL（juhecli-client）用于管理企业微信客户端实例的完整生命周期。 包括实例恢复（带代理、桥接、历史同步等配置）、停止实例、客户端版本升级、 设置消息通知回调地址、配置网络代理和桥接地址等。

触发方式

当用户用自然语言表达以下意图时，Agent 应激活此 SKILL：

• “启动企微实例” / “恢复企微” / “上线客户端”
• “停止实例” / “把企微停了”
• “升级客户端” / “更新企微版本”
• “设置回调地址” / “配置通知URL”
• “配置代理” / “设置网络代理”
• “设置桥接地址” / “配置桥接”

命令一览

Agent 交互示例

client restore - 恢复/启动实例

用户：帮我启动企微实例

Agent：好的，我来帮您启动。请问需要配置代理或桥接地址吗？

用户：不需要，直接启动就行

→ Agent 调用 client restore，开启自动启动和历史消息同步

Agent：企微实例已成功恢复并上线，正在同步历史消息。

用户：通过代理启动企微，代理地址是 http://proxy.example.com:8080

Agent：好的，我来通过代理启动实例。
→ Agent 调用 client restore，传入代理地址

Agent：实例已通过代理启动成功，代理地址：http://proxy.example.com:8080

• auto_start (boolean) - 是否自动启动，默认 true
• bridge (string) [用户提供] - 桥接地址，无则留空
• force_online (boolean) - 是否强制上线，默认 false
• proxy (string) [用户提供] - 代理地址（如 http://proxy:8080），无则留空
• sync_history_msg (boolean) - 是否同步历史消息，默认 true

client stop - 停止实例

用户：把企微实例停了

Agent：停止后实例将离线，无法收发消息。确认要停止吗？

用户：确认

→ Agent 查询 guid，调用 client stop

Agent：企微实例已停止。

• guid (string) [需查询] - 实例 GUID，通过 device list 获取

client update - 升级客户端

用户：升级一下企微客户端

Agent：好的，我来升级客户端版本。
→ Agent 调用 client update

Agent：客户端升级成功。建议重新恢复实例以确保正常运行，需要我现在执行吗？

• new_client_type (number) - 目标客户端类型编号

client set_notify_url - 设置通知回调地址

用户：把回调地址改成 https://myapp.com/webhook

Agent：好的，我来设置新的回调地址。
→ Agent 调用 client set_notify_url

Agent：回调地址已更新为 https://myapp.com/webhook，新消息将推送到此地址。

• notify_url (string) [用户提供] - 回调 URL 地址

client set_proxy - 设置代理

用户：给实例配置代理，地址是 http://10.0.0.1:3128

Agent：好的，我来配置代理。
→ Agent 调用 client set_proxy

Agent：代理已配置为 http://10.0.0.1:3128。

• proxy (string) [用户提供] - 代理地址

client set_bridge - 设置桥接地址

用户：设置桥接地址为 bridge_xxx

Agent：好的，我来设置桥接。
→ Agent 调用 client set_bridge

Agent：桥接地址已设置为 bridge_xxx。

• bridge (string) [用户提供] - 桥接服务地址或 ID

参数来源速查

典型工作流

工作流 1：首次启动实例

用户说“帮我启动企微”。Agent 分步操作：

1. 确认设备：通过 device list 获取可用设备及 guid
2. 恢复实例：调用 client restore 启动实例，询问用户是否需要配置代理或桥接
3. 设置回调：询问用户回调地址，调用 client set_notify_url 完成配置

工作流 2：更换回调地址

用户说“把消息回调地址改成新地址”。Agent 直接调用 client set_notify_url 设置新的回调 URL，设置后新消息将推送到新地址。

工作流 3：通过代理启动

用户说“通过代理启动企微，代理地址是xxx”。Agent 在调用 client restore 时直接传入用户指定的代理地址，一次性完成代理配置和实例启动。

工作流 4：升级客户端版本

用户说“升级企微版本”。Agent 分步操作：

1. 升级版本：调用 client update 执行升级
2. 重启实例：升级完成后建议用户确认是否重新执行 client restore 以确保实例正常运行

工作流 5：停止实例

用户说“停止企微实例”。Agent 操作：

1. 确认操作：提醒用户停止后实例将离线，获取用户确认
2. 查询 guid：通过 device list 获取实例 guid
3. 停止实例：调用 client stop

AI Agent 注意事项

• restore 是最常用的命令，首次部署时建议同时设置 notify_url
• proxy 和 bridge 参数由用户提供，Agent 不应自行猜测或生成
• 执行 stop 前需确认 guid 正确，停止后实例将离线
• update 升级后建议重新执行 restore 确保实例正常
• 如果用户要求“启动企微”，完整流程应为：device list → restore → set_notify_url