wechat-cli 0.4.0

A CLI tool to interact with a Wechat iLink bot.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162

use std::path::PathBuf;

use clap::{ArgGroup, Args, Parser, Subcommand};

#[derive(Debug, Parser)]
#[command(name = "wechat-cli")]
#[command(about = "Command-line client for WeChat iLink bot APIs")]
#[command(version)]
pub struct Cli {
    #[command(subcommand)]
    pub command: Command,
}

#[derive(Debug, Subcommand)]
pub enum Command {
    /// Log in with a QR code and save the account locally.
    Login(LoginArgs),
    /// Request a login QR code and print it as JSON without saving anything locally.
    Qrcode(QrcodeArgs),
    /// Query a login QR code status and print it as JSON without saving anything locally.
    QrcodeStatus(QrcodeStatusArgs),
    /// Inspect saved accounts.
    Account(AccountArgs),
    /// Wait for the next inbound message and print its context token.
    GetContextToken(GetContextTokenArgs),
    /// Send a text, image, or file message.
    Send(SendArgs),
}

#[derive(Debug, Args)]
pub struct LoginArgs {}

#[derive(Debug, Args)]
pub struct QrcodeArgs {}

#[derive(Debug, Args)]
pub struct QrcodeStatusArgs {
    /// QR code ID returned by `wechat-cli qrcode`.
    #[arg(long)]
    pub qrcode_id: String,
}

#[derive(Debug, Args)]
pub struct AccountArgs {
    #[command(subcommand)]
    pub command: AccountCommand,
}

#[derive(Debug, Subcommand)]
pub enum AccountCommand {
    /// List saved accounts in index order.
    List,
    /// Add or overwrite a saved account.
    Add(AccountAddArgs),
    /// Delete a saved account.
    Delete(AccountDeleteArgs),
}

#[derive(Debug, Args)]
pub struct AccountAddArgs {
    /// WeChat user ID ending with `@im.wechat`.
    #[arg(long)]
    pub user_id: String,
    /// Bot token used to authenticate API requests.
    #[arg(long)]
    pub bot_token: String,
    /// Optional route tag saved for later requests.
    #[arg(long)]
    pub route_tag: Option<String>,
}

#[derive(Debug, Args)]
pub struct AccountDeleteArgs {
    /// Saved account index from `wechat-cli account list`.
    #[arg(long)]
    pub account: usize,
}

#[derive(Debug, Args)]
#[command(after_help = "Authentication Modes:
  1. Saved Account Mode:
     --account <index>
  
  2. Explicit Credentials Mode:
     --bot-token <token> --user-id <user_id> [--route-tag <tag>]

Usage Rules:
  - You must use exactly one of the modes above.
  - --account cannot be combined with --bot-token or --user-id.
  - In Explicit mode, both --bot-token and --user-id are required.")]
pub struct GetContextTokenArgs {
    #[arg(
        long,
        help = "Saved account index from `wechat-cli account list`. Required for Saved Account Mode."
    )]
    pub account: Option<usize>,
    #[arg(long, help = "Target user ID. Required in Explicit Credentials Mode.")]
    pub user_id: Option<String>,
    #[arg(
        long,
        help = "Explicit bot token. Required in Explicit Credentials Mode."
    )]
    pub bot_token: Option<String>,
    #[arg(
        long,
        help = "Optional route tag used only in Explicit Credentials Mode."
    )]
    pub route_tag: Option<String>,
}

#[derive(Debug, Args)]
#[command(group(
    ArgGroup::new("message")
        .args(["text", "file"])
        .required(true)
        .multiple(false)
))]
#[command(after_help = "Authentication Modes:
  1. Saved Account Mode:
     --account <index>
  
  2. Explicit Credentials Mode:
     --bot-token <token> --user-id <user_id> [--route-tag <tag>]

Usage Rules:
  - You must use exactly one of the modes above.
  - --account cannot be combined with --bot-token or --user-id.
  - In Explicit mode, both --bot-token and --user-id are required.
  - --context-token is always required for sending and must be provided explicitly.")]
pub struct SendArgs {
    #[arg(
        long,
        help = "Saved account index from `wechat-cli account list`. Required for Saved Account Mode."
    )]
    pub account: Option<usize>,
    #[arg(long, help = "Target user ID. Required in Explicit Credentials Mode.")]
    pub user_id: Option<String>,
    #[arg(
        long,
        help = "Explicit bot token. Required in Explicit Credentials Mode."
    )]
    pub bot_token: Option<String>,
    #[arg(
        long,
        help = "Optional route tag used only in Explicit Credentials Mode."
    )]
    pub route_tag: Option<String>,
    #[arg(
        long,
        help = "Context token from `get-context-token`. Always required."
    )]
    pub context_token: Option<String>,
    #[arg(long, help = "Plain text message body")]
    pub text: Option<String>,
    #[arg(
        long,
        help = "File path to send. Images are detected and sent as image messages."
    )]
    pub file: Option<PathBuf>,
    #[arg(long, requires = "file", help = "Optional caption for `--file`")]
    pub caption: Option<String>,
}