Struct WecomClient 

pub struct WecomClient { /* private fields */ }

WeCom 客户端：认证、服务发现与方法调用的统一入口。

经 WecomClientBuilder 构建后即可直接使用：

let client = WecomClientBuilder::new()
    .token_provider(Arc::new(provider))
    .build()
    .await?;

// 程序化调用（服务/方法名由 discovery 下发）
let svc = client.service("hr").await?;
let result = svc.method(&["users", "list"])?.invoke(json!({})).await?;

Implementations

impl WecomClient

pub fn from_transport(transport: Transport) -> Result<Self, Error>

用已构建的 transport 组装客户端（自动挂网关协议端点目录）。

适合需要完全自定义 transport 的调用方；常规路径请用 WecomClientBuilder。

Errors

wecomx::Client 构建失败时返回 wecomx::Error。

pub fn from_client(inner: Client) -> Self

包裹一个已配置好的 wecomx::Client（不改动其任何配置）。

pub fn inner(&self) -> &Client

底层 wecomx::Client（需要沙箱 FS、helper、扩展命令等高级配置时使用）。

pub fn into_inner(self) -> Client

消耗自身，返回底层 wecomx::Client。

pub fn transport(&self) -> &Transport

带鉴权的 transport（可注入默认 header、extension 等）。

pub async fn list_services(&self) -> Result<Vec<ServiceInfo>, Error>

列出 discovery 下发的服务目录。

Errors

服务发现失败时返回 wecomx::Error。

pub async fn service(&self, name: &str) -> Result<ServiceHandle<'_>, Error>

获取指定服务的句柄（服务名由 discovery 下发）。

Errors

服务不存在或发现失败时返回 wecomx::Error。

pub async fn method(&self, path: &[&str]) -> Result<MethodHandle<'_>, Error>

按路径（服务名 + 资源段 + 方法名）直接获取方法句柄。

Errors

方法不存在或发现失败时返回 wecomx::Error。

pub fn run(&self, argv: Vec<String>) -> CliRun<'_>

CLI 风格的 argv 调度入口（与 wecom-cli 同一套命令模型）。

返回 wecomx::CliRun（IntoFuture），.await 即执行：

client.run(vec!["wecom".into(), "hr".into(), "users".into(), "list".into()])
    .await?;