koishi-plugin-rocom 1.0.6 → 1.0.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/readme.md CHANGED
@@ -1,33 +1,35 @@
1
+ <div align="center">
2
+
1
3
  # koishi-plugin-rocom
2
- 注意,本项目仍处于开发调试期,可能会有未知BUG的产生。
3
- > APIKey
4
- > sk-ba042e079cf9ccb30e72b3d5af458f45
5
- > sk-c7952558b84a176b76d0215760732330
6
- > sk-b3d96323b2b045282c52f81ca43fcad8
7
- > sk-5c14c1e5da063037d02c15e50285dd04
8
- > 交流反馈:1097809141
9
- [![npm](https://img.shields.io/npm/v/koishi-plugin-rocom?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-rocom)
10
4
 
11
- Koishi 版洛克王国数据查询插件。插件基于 WeGame / 后端接口提供账号绑定、个人档案、战绩、背包、阵容、交换大厅、远行商人、查蛋配种、Wiki 查询等功能,并通过 `koishi-plugin-puppeteer` 将部分结果渲染为图片发送。
5
+ <img width="150" height="150" alt="image" src="https://github.com/user-attachments/assets/cdd7655e-08db-4db2-becc-5a2ace6c744b" />
6
+
7
+ **交流反馈群:1097809141**
8
+ **注意,本项目仍处于开发调试期,可能会有未知BUG的产生。**
9
+
10
+ ---
12
11
 
13
- ## 功能概览
12
+ 临时APIKey(任选其一)
13
+ sk-ba042e079cf9ccb30e72b3d5af458f45
14
+ sk-c7952558b84a176b76d0215760732330
15
+ sk-b3d96323b2b045282c52f81ca43fcad8
16
+ sk-5c14c1e5da063037d02c15e50285dd04
14
17
 
15
- | 分类 | 功能 |
16
- | --- | --- |
17
- | 账号管理 | QQ 扫码登录、微信扫码登录、凭证导入、绑定列表、切换账号、解绑、刷新凭证 |
18
- | 数据查询 | 档案、战绩、背包、阵容推荐、阵容详情、交换大厅 |
19
- | 商人提醒 | 远行商人查询、商品关键词订阅、全部订阅(每轮直推整图)、查看订阅、取消订阅 |
20
- | 百科查询 | 精灵 Wiki、技能 Wiki |
21
- | 查蛋配种 | 精灵查蛋、尺寸反查、候选结果、目标配种方案、配种判定 |
22
- | 管理维护 | 刷新所有凭证、删除失效绑定、自动刷新凭证 |
18
+ ---
19
+
20
+ </div>
21
+
22
+ [![npm](https://img.shields.io/npm/v/koishi-plugin-rocom?style=flat-square)](https://www.npmjs.com/package/koishi-plugin-rocom)
23
+
24
+ Koishi 版洛克王国数据查询插件。插件基于 WeGame / 后端接口提供账号绑定、个人档案、战绩、背包、阵容、交换大厅、远行商人、查蛋配种、Wiki 查询等功能。
23
25
 
24
- > 图片位置:插件总览截图。建议插入 `docs/images/overview.png`。
25
26
  ### 安全免责声明
26
27
 
27
28
  - 绑定后的 `token`、`ticket`、扫码凭证等均属于敏感信息,请务必自行妥善保存。
28
29
  - 请勿截图公开、发送他人,或提交到公开仓库,避免凭证泄露后被冒用。
29
30
  - 因凭证或绑定信息泄露导致的账号风险、查询被冒用或相关损失,需要由使用者自行承担。
30
31
  - 非必要不要频繁手动刷新凭证,服务端会自动刷新。
32
+
31
33
  ## 使用前准备
32
34
 
33
35
  本插件依赖 Koishi 的 `database` 服务和 `koishi-plugin-puppeteer` 服务。请先在 Koishi 控制台启用:
@@ -38,34 +40,38 @@ Koishi 版洛克王国数据查询插件。插件基于 WeGame / 后端接口提
38
40
 
39
41
  如果图片渲染失败,插件会尽量回落为文字结果;但档案、战绩、背包、阵容、交换大厅、远行商人和查蛋配种等功能推荐配合 Puppeteer 使用。
40
42
 
41
- > 图片位置:Koishi 插件启用与服务依赖截图。建议插入 `docs/images/setup-services.png`。
43
+ | 功能 | 示例图片 | 功能 | 示例图片 |
44
+ | -------- | -------------------------------------------------- | -------- | -------------------------------------------------- |
45
+ | 帮助菜单 | <img src="docs/images/菜单.png" width="400" /> | 个人档案 | <img src="docs/images/洛克档案.png" width="400" /> |
46
+ | 背包 | <img src="docs/images/洛克背包.png" width="400" /> | 阵容推荐 | <img src="docs/images/洛克阵容.png" width="400" /> |
47
+ | 阵容详情 | <img src="docs/images/阵容详细.png" width="400" /> | 远行商人 | <img src="docs/images/远行商人.png" width="400" /> |
48
+ | 家园 | <img src="docs/images/洛克家园.png" width="400" /> | 查蛋 | <img src="docs/images/洛克查蛋.png" width="400" /> |
49
+ | 精灵面板 | <img src="docs/images/精灵面板.png" width="400" /> |
42
50
 
43
51
  ## 配置项
44
52
 
45
- | 配置项 | 默认值 | 说明 |
46
- | --- | --- | --- |
47
- | `apiBaseUrl` | `https://wegame.shallow.ink` | 后端 API 基础地址 |
48
- | `wegameApiKey` | 空 | WeGame API Key,如后端要求鉴权则填写 |
49
- | `qqLoginDebugMode` | `false` | QQ 扫码登录调试模式,可能输出敏感凭证,仅调试时开启 |
50
- | `adminUserIds` | `[]` | Bot 管理员用户 ID 列表,用于管理员命令 |
51
- | `autoRefreshEnabled` | `false` | 是否启用自动刷新凭证 |
52
- | `autoRefreshTime` | `["00:00", "12:00"]` | 自动刷新凭证的时间点 |
53
- | `merchantSubscriptionEnabled` | `true` | 是否启用远行商人订阅检查 |
54
- | `merchantSubscriptionItems` | `["国王球", "棱镜球", "炫彩精灵蛋"]` | 默认关注的远行商人商品 |
55
- | `merchantCheckInterval` | `300000` | 远行商人订阅检查间隔,单位毫秒 |
56
- | `merchantPrivateSubscriptionEnabled` | `true` | 是否允许私聊订阅远行商人推送 |
57
- | `homeSubscriptionEnabled` | `true` | 是否启用家园菜园和灵感订阅推送 |
58
- | `homeSubscriptionIntervalMinutes` | `5` | 家园订阅检查间隔,单位分钟 |
59
- | `imageCompressionEnabled` | `true` | 是否在发送图片前启用 PNG 无损压缩 |
60
- | `imageCompressionMinBytes` | `262144` | 触发压缩的最小图片大小,单位字节 |
61
- | `imageCompressionLevel` | `9` | PNG zlib 压缩等级,范围 `0-9`,数值越大通常越小但更耗时 |
53
+ | 配置项 | 默认值 | 说明 |
54
+ | ------------------------------------ | ------------------------------------ | ------------------------------------------------------- |
55
+ | `apiBaseUrl` | `https://wegame.shallow.ink` | 后端 API 基础地址 |
56
+ | `wegameApiKey` | 空 | WeGame API Key,如后端要求鉴权则填写 |
57
+ | `qqLoginDebugMode` | `false` | QQ 扫码登录调试模式,可能输出敏感凭证,仅调试时开启 |
58
+ | `adminUserIds` | `[]` | Bot 管理员用户 ID 列表,用于管理员命令 |
59
+ | `autoRefreshEnabled` | `false` | 是否启用自动刷新凭证 |
60
+ | `autoRefreshTime` | `["00:00", "12:00"]` | 自动刷新凭证的时间点 |
61
+ | `merchantSubscriptionEnabled` | `true` | 是否启用远行商人订阅检查 |
62
+ | `merchantSubscriptionItems` | `["国王球", "棱镜球", "炫彩精灵蛋"]` | 默认关注的远行商人商品 |
63
+ | `merchantCheckInterval` | `300000` | 远行商人订阅检查间隔,单位毫秒 |
64
+ | `merchantPrivateSubscriptionEnabled` | `true` | 是否允许私聊订阅远行商人推送 |
65
+ | `homeSubscriptionEnabled` | `true` | 是否启用家园菜园和灵感订阅推送 |
66
+ | `homeSubscriptionIntervalMinutes` | `5` | 家园订阅检查间隔,单位分钟 |
67
+ | `imageCompressionEnabled` | `true` | 是否在发送图片前启用 PNG 无损压缩 |
68
+ | `imageCompressionMinBytes` | `262144` | 触发压缩的最小图片大小,单位字节 |
69
+ | `imageCompressionLevel` | `9` | PNG zlib 压缩等级,范围 `0-9`,数值越大通常越小但更耗时 |
62
70
 
63
71
  ### 图片压缩设置
64
72
 
65
73
  后台配置页中有单独的“图片压缩设置”分组。该功能会在图片发送前对 PNG 的 IDAT 数据做无损重压缩,不会改变图片尺寸、画质或透明度。若压缩失败,或压缩后文件没有变小,会自动发送原图。
66
74
 
67
- > 图片位置:插件配置页截图。建议插入 `docs/images/config.png`。
68
-
69
75
  ## 快速开始
70
76
 
71
77
  1. 启用 `database`、`puppeteer` 和本插件。
@@ -78,443 +84,15 @@ Koishi 版洛克王国数据查询插件。插件基于 WeGame / 后端接口提
78
84
  洛克.档案
79
85
  洛克.背包
80
86
  洛克.查蛋 喵喵
87
+ 洛克.刷新面板
88
+ 洛克.精灵面板 火神
81
89
  ```
82
90
 
83
- > 图片位置:首次使用流程截图。建议插入 `docs/images/quick-start.png`。
84
-
85
- ## 帮助菜单
86
-
87
- ### `洛克`
88
-
89
- 查看插件内置帮助菜单,列出常用账号管理、数据查询和百科/查蛋命令。
90
-
91
- ```text
92
- 洛克
93
- ```
94
-
95
- > 图片位置:帮助菜单截图。建议插入 `docs/images/help-menu.png`。
96
-
97
- ## 账号管理
98
-
99
- 大部分游戏数据查询功能需要先绑定洛克王国账号。查蛋、配种等本地数据功能无需登录。
100
-
101
- ### `洛克.QQ登录`
102
-
103
- 生成 QQ 扫码登录二维码。扫码成功后插件会自动创建绑定,并保存当前用户的主账号凭证。
104
-
105
- ```text
106
- 洛克.QQ登录
107
- ```
108
-
109
- 注意事项:
110
-
111
- - 二维码有效时间约 2 分钟。
112
- - 需要双设备扫码。
113
- - QQ 扫码绑定支持后续刷新凭证。
114
-
115
- > 图片位置:QQ 登录二维码截图。建议插入 `docs/images/account-qq-login.png`。
116
-
117
- ### `洛克.微信登录`
118
-
119
- 生成微信扫码登录链接。扫码成功后插件会自动创建绑定并保存账号。
120
-
121
- ```text
122
- 洛克.微信登录
123
- ```
124
-
125
- 注意事项:
126
-
127
- - 链接有效时间约 2 分钟。
128
- - 需要双设备扫码。
129
-
130
- > 图片位置:微信登录链接截图。建议插入 `docs/images/account-wechat-login.png`。
131
-
132
- ### `洛克.导入 <tgp_id> <tgp_ticket>`
133
-
134
- 手动导入 WeGame 凭证,适用于已有 `tgp_id` 和 `tgp_ticket` 的场景。
135
-
136
- ```text
137
- 洛克.导入 你的tgp_id 你的tgp_ticket
138
- ```
139
-
140
- > 图片位置:凭证导入结果截图。建议插入 `docs/images/account-import.png`。
141
-
142
- ### `洛克.绑定列表`
143
-
144
- 查看当前用户已经绑定的账号列表,并以图片面板展示。主账号会标记为“主账号”;如果图片渲染失败,会回退为文本列表。
145
-
146
- ```text
147
- 洛克.绑定列表
148
- ```
149
-
150
- > 图片位置:绑定列表截图。建议插入 `docs/images/account-bindings.png`。
151
-
152
- ### `洛克.切换 <序号>`
153
-
154
- 切换当前用户的主账号。序号来自 `洛克.绑定列表`。
155
-
156
- ```text
157
- 洛克.切换 2
158
- ```
159
-
160
- > 图片位置:切换账号结果截图。建议插入 `docs/images/account-switch.png`。
161
-
162
- ### `洛克.解绑 <序号>`
163
-
164
- 解绑指定序号的账号,并尝试删除服务端绑定记录。
165
-
166
- ```text
167
- 洛克.解绑 1
168
- ```
169
-
170
- > 图片位置:解绑账号结果截图。建议插入 `docs/images/account-unbind.png`。
171
-
172
- ### `洛克.刷新`
173
-
174
- 刷新当前主账号凭证。当前实现主要适用于 QQ 扫码绑定的账号。
175
-
176
- ```text
177
- 洛克.刷新
178
- ```
179
-
180
- > 图片位置:刷新凭证结果截图。建议插入 `docs/images/account-refresh.png`。
181
-
182
- ## 数据查询
183
-
184
- 以下功能需要先绑定账号。如果凭证过期,请重新登录或使用 `洛克.刷新`。
185
-
186
- ### `洛克.档案`
187
-
188
- 生成个人档案卡片,展示角色基础信息、评分、收藏、AI 点评、雷达图、近期战绩和部分玩家扩展资料。
189
-
190
- ```text
191
- 洛克.档案
192
- ```
193
-
194
- > 图片位置:个人档案卡片截图。建议插入 `docs/images/query-profile.png`。
195
-
196
- ### `洛克.战绩 [页码]`
197
-
198
- 查看对战战绩概览和近期战斗记录。
199
-
200
- ```text
201
- 洛克.战绩
202
- 洛克.战绩 2
203
- ```
204
-
205
- > 图片位置:战绩截图。建议插入 `docs/images/query-record.png`。
206
-
207
- ### `洛克.背包 [分类] [页码]`
208
-
209
- 查看精灵背包。支持按分类筛选,也支持翻页。
210
-
211
- 可用分类:
212
-
213
- - `全部`
214
- - `了不起`
215
- - `异色`
216
- - `炫彩`
217
-
218
- 示例:
219
-
220
- ```text
221
- 洛克.背包
222
- 洛克.背包 异色
223
- 洛克.背包 炫彩 2
224
- 洛克.背包 了不起精灵 3
225
- ```
226
-
227
- > 图片位置:背包截图。建议插入 `docs/images/query-package.png`。
228
-
229
- ### `洛克.阵容 [分类] [页码]`
230
-
231
- 查看阵容推荐列表。参数可用来指定分类或页码。
232
-
233
- ```text
234
- 洛克.阵容
235
- 洛克.阵容 热门 2
236
- 洛克.阵容 PVP
237
- ```
238
-
239
- > 图片位置:阵容推荐截图。建议插入 `docs/images/query-lineup.png`。
240
-
241
- ### `查看阵容 <阵容码>`
242
-
243
- 查看指定阵容的详情,包括阵容名称、标签、作者、精灵、技能和血脉信息。
244
-
245
- 示例:
246
-
247
- ```text
248
- 查看阵容 123456
249
- ```
250
-
251
- > 图片位置:阵容详情截图。建议插入 `docs/images/query-lineup-detail.png`。
252
-
253
- ### `洛克.交换大厅 [页码]`
254
-
255
- 查看玩家交换大厅帖子。支持翻页。
256
-
257
- 示例:
258
-
259
- ```text
260
- 洛克.交换大厅
261
- 洛克.交换大厅 2
262
- ```
263
-
264
- > 图片位置:交换大厅截图。建议插入 `docs/images/query-exchange-hall.png`。
265
-
266
- ## 远行商人
267
-
268
- ### `远行商人`
269
-
270
- 查看当前远行商人的商品、轮次和剩余时间。当前轮次按每日 `08:00 / 12:00 / 16:00 / 20:00` 计算。
271
-
272
- ```text
273
- 远行商人
274
- ```
275
-
276
- > 图片位置:远行商人商品截图。建议插入 `docs/images/merchant-current.png`。
277
-
278
- ### `订阅远行商人 [1/0] [商品名... | 全部]`
279
-
280
- 在群聊中订阅远行商人提醒。群内操作仅 `adminUserIds` 中配置的 Bot 管理员可设置;私聊场景支持个人自行订阅(需开启 `merchantPrivateSubscriptionEnabled`)。
281
-
282
- 参数说明:
283
-
284
- - 第一个可选参数 `1` / `0`:仅群聊生效。`1` 表示命中后 @全体成员,`0` 表示不 @全体。省略时默认 `0`。私聊订阅强制为不 @。
285
- - 后续参数为订阅商品名,按"包含关系"与当前商品名做模糊匹配(例如订阅 `国王球` 会命中 `国王球(大)`)。
286
- - 若只传一个特殊关键字 `全部`,则进入 **全部订阅模式**:忽略商品匹配,只要远行商人本轮有在售商品,就把整张远行商人渲染图直接推送给订阅方。每轮(`08:00 / 12:00 / 16:00 / 20:00`)只推一次。
287
- - 不传任何商品名时,使用配置里的 `merchantSubscriptionItems` 作为默认关键词。
288
-
289
- 查看当前会话的订阅:
290
-
291
- ```text
292
- 查看远行商人订阅
293
- ```
294
-
295
- 常见用法:
296
-
297
- ```text
298
- 订阅远行商人 # 使用配置中的默认关键词
299
- 订阅远行商人 国王球 棱镜球 炫彩精灵蛋 # 按关键词匹配
300
- 订阅远行商人 1 国王球 # 命中后 @全体
301
- 订阅远行商人 全部 # 每轮直接推送整张商人图
302
- 订阅远行商人 1 全部 # 每轮推送并 @全体
303
- ```
304
-
305
- 按关键词订阅时,去重规则是"同一轮次 + 同一匹配商品集合"只推一次;全部订阅模式下仅按轮次去重,本轮推过就不再重复。
306
-
307
- > 图片位置:订阅远行商人结果截图。建议插入 `docs/images/merchant-subscribe.png`。
308
-
309
- ### `取消订阅远行商人`
310
-
311
- 取消当前群聊的远行商人订阅。群内操作仅 `adminUserIds` 中配置的 Bot 管理员可以操作;私聊场景可自行取消个人订阅。
312
-
313
- ```text
314
- 取消订阅远行商人
315
- ```
316
-
317
- > 图片位置:取消订阅截图。建议插入 `docs/images/merchant-unsubscribe.png`。
318
-
319
- ## 家园订阅
320
-
321
- ### `订阅家园菜园 [uid]`
322
-
323
- 订阅指定 UID 的家园菜园成熟提醒。私聊场景可自行订阅;群聊场景仅 `adminUserIds` 中配置的 Bot 管理员可设置。
324
-
325
- ```text
326
- 订阅家园菜园
327
- 订阅家园菜园 12345678
328
- ```
329
-
330
- 不传 `uid` 时,会优先使用你当前绑定账号的 UID。
331
-
332
- ### `订阅家园灵感 [uid]`
333
-
334
- 订阅指定 UID 的家园精灵灵感完成提醒。私聊场景可自行订阅;群聊场景仅 `adminUserIds` 中配置的 Bot 管理员可设置。
335
-
336
- ```text
337
- 订阅家园灵感
338
- 订阅家园灵感 12345678
339
- ```
340
-
341
- 不传 `uid` 时,会优先使用你当前绑定账号的 UID。
342
-
343
- ### `取消订阅家园 [kind] [uid]`
344
-
345
- 取消当前会话的家园订阅。私聊场景可自行取消;群聊场景仅 `adminUserIds` 中配置的 Bot 管理员可操作。
346
-
347
- ```text
348
- 取消订阅家园
349
- 取消订阅家园 菜园
350
- 取消订阅家园 灵感 12345678
351
- ```
352
-
353
- ## Wiki 查询
354
-
355
- ### `洛克.wiki <精灵名>`
356
-
357
- 该功能暂时关闭。发送指令后会返回“该功能暂时关闭”。
358
-
359
- ```text
360
- 洛克.wiki 喵喵
361
- ```
362
-
363
- > 图片位置:精灵 Wiki 查询截图。建议插入 `docs/images/wiki-pet.png`。
364
-
365
- ### `洛克.技能 <技能名>`
366
-
367
- 该功能暂时关闭。发送指令后会返回“该功能暂时关闭”。
368
-
369
- ```text
370
- 洛克.技能 火花
371
- ```
372
-
373
- > 图片位置:技能 Wiki 查询截图。建议插入 `docs/images/wiki-skill.png`。
374
-
375
- ## 查蛋配种
376
-
377
- 查蛋配种功能使用本地 `Pets.json` 数据和后端尺寸查询接口,不需要登录账号。
378
-
379
- ### `洛克.查蛋 <精灵名>`
380
-
381
- 查询指定精灵的蛋组、性别比、孵化时间、身高体重范围、异色蛋概率、同蛋组可配种精灵等信息。
382
-
383
- 示例:
384
-
385
- ```text
386
- 洛克.查蛋 喵喵
387
- ```
388
-
389
- 匹配规则:
390
-
391
- - 精确命中时直接展示查蛋结果。
392
- - 模糊命中一个结果时会提示模糊匹配。
393
- - 命中多个结果时会展示候选列表。
91
+ ## 指令说明
394
92
 
395
- > 图片位置:精灵查蛋结果截图。建议插入 `docs/images/egg-search.png`。
93
+ 完整的指令列表、参数与示例请到指令文档查看:
396
94
 
397
- ### `洛克.查蛋 <身高> [体重]`
398
-
399
- 按尺寸反查精灵。身高使用游戏原生单位 `m`,体重使用 `kg`。同时提供身高和体重时,会优先调用后端尺寸查询接口;如果后端无结果,则回落到本地数据查询。
400
-
401
- 示例:
402
-
403
- ```text
404
- 洛克.查蛋 0.18
405
- 洛克.查蛋 0.18 1.5
406
- 洛克.查蛋 0.18m 1.5kg
407
- 洛克.查蛋 身高0.18m 体重1.5kg
408
- ```
409
-
410
- > 图片位置:尺寸反查结果截图。建议插入 `docs/images/egg-size-search.png`。
411
-
412
- ### 查蛋候选结果
413
-
414
- 当精灵名称命中多个候选时,插件会展示候选列表。请根据候选列表使用更精确的名称重新查询。
415
-
416
- ```text
417
-
418
- ```
419
-
420
- > 图片位置:查蛋候选结果截图。建议插入 `docs/images/egg-candidates.png`。
421
-
422
- ### `洛克.配种 <精灵名>`
423
-
424
- 查询想要孵出某个目标精灵时,可以选择哪些父体。默认孵蛋结果跟随母体,所以目标精灵会作为母体展示。
425
-
426
- 适合在你已经确定“目标宝宝”时使用。例如想孵出喵喵,就只需要输入目标精灵名,插件会返回可用于配种的父体方案。
427
-
428
- 示例:
429
-
430
- ```text
431
- 洛克.配种 喵喵
432
- ```
433
-
434
- 返回内容通常包括:
435
-
436
- - 目标精灵信息
437
- - 可选父体列表
438
- - 相关蛋组
439
- - 孵化时间
440
- - 身高体重范围
441
-
442
- > 图片位置:目标配种方案截图。建议插入 `docs/images/egg-want.png`。
443
-
444
- ### `洛克.配种 <父体> <母体>`
445
-
446
- 判断两只精灵是否可以配种。默认前一个参数为父体,后一个参数为母体,孵蛋结果跟随母体。
447
-
448
- 参数顺序很重要:
449
-
450
- - 第一个参数:父体
451
- - 第二个参数:母体
452
- - 孵蛋结果:跟随母体
453
-
454
- ```text
455
- 洛克.配种 父体名称 母体名称
456
- ```
457
-
458
- 示例:
459
-
460
- ```text
461
- 洛克.配种 喵喵 火花
462
- ```
463
-
464
- 返回内容包括:
465
-
466
- - 是否可以配种
467
- - 共享蛋组
468
- - 无法配种原因
469
- - 孵化时长
470
- - 身高体重范围
471
-
472
- 常见用法:
473
-
474
- - 只输入一个精灵名:查询“怎样孵出这个精灵”
475
- - 输入两个精灵名:判断“这两只精灵能不能配”
476
- - 名称命中多个候选时:插件会返回候选列表,请换成更精确的精灵名重新查询
477
-
478
- > 图片位置:配种判定截图。建议插入 `docs/images/egg-pair.png`。
479
-
480
- ## 管理命令
481
-
482
- 管理命令仅允许 `adminUserIds` 中配置的用户使用。
483
-
484
- ### `洛克.刷新所有凭证`
485
-
486
- 批量刷新所有用户的主账号凭证。仅支持可刷新的 QQ 扫码绑定账号。
487
-
488
- ```text
489
- 洛克.刷新所有凭证
490
- ```
491
-
492
- > 图片位置:刷新所有凭证结果截图。建议插入 `docs/images/admin-refresh-all.png`。
493
-
494
- ### `洛克.删除失效绑定`
495
-
496
- 检查所有用户绑定的有效性,移除失效绑定,并清理对应本地凭证。
497
-
498
- ```text
499
- 洛克.删除失效绑定
500
- ```
501
-
502
- > 图片位置:删除失效绑定结果截图。建议插入 `docs/images/admin-clean-invalid.png`。
503
-
504
- ### 自动刷新凭证
505
-
506
- 开启 `autoRefreshEnabled` 后,插件会按 `autoRefreshTime` 配置的时间点自动刷新所有可刷新的 QQ 绑定账号。
507
-
508
- 推荐配置示例:
509
-
510
- ```yaml
511
- autoRefreshEnabled: true
512
- autoRefreshTime:
513
- - "00:00"
514
- - "12:00"
515
- ```
516
-
517
- > 图片位置:自动刷新配置截图。建议插入 `docs/images/admin-auto-refresh.png`。
95
+ - [指令说明文档](docs/commands.md)
518
96
 
519
97
  ## 常见问题
520
98
 
@@ -522,8 +100,6 @@ autoRefreshTime:
522
100
 
523
101
  请先使用 `洛克.QQ登录` 或 `洛克.微信登录` 绑定账号,再使用档案、战绩、背包、阵容、交换大厅等账号相关功能。
524
102
 
525
- > 图片位置:未绑定提示截图。建议插入 `docs/images/faq-not-bound.png`。
526
-
527
103
  ### 图片生成失败
528
104
 
529
105
  请检查:
@@ -535,14 +111,10 @@ autoRefreshTime:
535
111
 
536
112
  插件在图片失败时会尽量发送文字回退结果。
537
113
 
538
- > 图片位置:图片生成失败排查截图。建议插入 `docs/images/faq-render-failed.png`。
539
-
540
114
  ### QQ 扫码登录超时
541
115
 
542
116
  二维码有效期约 2 分钟。超时后请重新发送 `洛克.QQ登录`。
543
117
 
544
- > 图片位置:登录超时提示截图。建议插入 `docs/images/faq-login-timeout.png`。
545
-
546
118
  ### 远行商人订阅没有推送
547
119
 
548
120
  请检查:
@@ -553,46 +125,6 @@ autoRefreshTime:
553
125
  - 全部订阅模式(`订阅远行商人 全部`)在本轮商品为空时不会推送;每轮 `08:00 / 12:00 / 16:00 / 20:00` 只推一次,已推过的轮次不会重复。
554
126
  - Bot 是否有向目标群聊发送消息的权限。
555
127
 
556
- > 图片位置:远行商人订阅排查截图。建议插入 `docs/images/faq-merchant-subscription.png`。
557
-
558
- ## 图片占位清单
559
-
560
- 建议将后续截图统一放在 `docs/images/` 目录下。
561
-
562
- | 功能 | 建议图片路径 |
563
- | --- | --- |
564
- | 插件总览 | `docs/images/overview.png` |
565
- | 服务启用 | `docs/images/setup-services.png` |
566
- | 插件配置 | `docs/images/config.png` |
567
- | 快速开始 | `docs/images/quick-start.png` |
568
- | 帮助菜单 | `docs/images/help-menu.png` |
569
- | QQ 登录 | `docs/images/account-qq-login.png` |
570
- | 微信登录 | `docs/images/account-wechat-login.png` |
571
- | 凭证导入 | `docs/images/account-import.png` |
572
- | 绑定列表 | `docs/images/account-bindings.png` |
573
- | 切换账号 | `docs/images/account-switch.png` |
574
- | 解绑账号 | `docs/images/account-unbind.png` |
575
- | 刷新凭证 | `docs/images/account-refresh.png` |
576
- | 个人档案 | `docs/images/query-profile.png` |
577
- | 战绩 | `docs/images/query-record.png` |
578
- | 背包 | `docs/images/query-package.png` |
579
- | 阵容推荐 | `docs/images/query-lineup.png` |
580
- | 阵容详情 | `docs/images/query-lineup-detail.png` |
581
- | 交换大厅 | `docs/images/query-exchange-hall.png` |
582
- | 远行商人 | `docs/images/merchant-current.png` |
583
- | 订阅远行商人 | `docs/images/merchant-subscribe.png` |
584
- | 取消订阅远行商人 | `docs/images/merchant-unsubscribe.png` |
585
- | 精灵 Wiki | `docs/images/wiki-pet.png` |
586
- | 技能 Wiki | `docs/images/wiki-skill.png` |
587
- | 精灵查蛋 | `docs/images/egg-search.png` |
588
- | 尺寸反查 | `docs/images/egg-size-search.png` |
589
- | 查蛋候选 | `docs/images/egg-candidates.png` |
590
- | 目标配种方案 | `docs/images/egg-want.png` |
591
- | 配种判定 | `docs/images/egg-pair.png` |
592
- | 刷新所有凭证 | `docs/images/admin-refresh-all.png` |
593
- | 删除失效绑定 | `docs/images/admin-clean-invalid.png` |
594
- | 自动刷新配置 | `docs/images/admin-auto-refresh.png` |
595
-
596
128
  ## 许可证
597
129
 
598
130
  本项目使用 MIT License。