koishi-plugin-csss 2.1.0 → 4.0.0
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/lib/index.d.ts +26 -0
- package/lib/index.js +330 -613
- package/package.json +4 -3
- package/readme.md +178 -12
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "koishi-plugin-csss",
|
|
3
|
-
"description": "
|
|
4
|
-
"version": "
|
|
3
|
+
"description": "一个用于 Koishi 的 CS:GO / CS2 服务器状态查询插件，支持单个/批量查询、服务器列表管理，并可将结果渲染为图片",
|
|
4
|
+
"version": "4.0.0",
|
|
5
5
|
"main": "lib/index.js",
|
|
6
6
|
"typings": "lib/index.d.ts",
|
|
7
7
|
"files": [
|
|
@@ -36,7 +36,8 @@
|
|
|
36
36
|
"service": {
|
|
37
37
|
"required": [
|
|
38
38
|
"puppeteer",
|
|
39
|
-
"gamedig"
|
|
39
|
+
"gamedig",
|
|
40
|
+
"database"
|
|
40
41
|
]
|
|
41
42
|
}
|
|
42
43
|
}
|
package/readme.md
CHANGED
|
@@ -2,19 +2,185 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://www.npmjs.com/package/koishi-plugin-csss)
|
|
4
4
|
|
|
5
|
-
cs server status
|
|
5
|
+
cs server status - 一个用于 Koishi 的 CS:GO / CS2 服务器状态查询插件，支持单个/批量查询、服务器列表管理，并可将结果渲染为图片。
|
|
6
6
|
|
|
7
|
-
##
|
|
8
|
-
- ```cs [地址:端口] <-i | -t | -c>```
|
|
7
|
+
## 功能
|
|
9
8
|
|
|
10
|
-
|
|
11
|
-
|
|
12
|
-
|
|
13
|
-
> -c 清除缓存
|
|
9
|
+
- **单个/批量服务器查询**：查询指定/多个IP的 CS 服务器信息，支持从数据库读取预设列表或临时输入（基于gamedig）。
|
|
10
|
+
- **服务器列表管理**：在数据库中添加、移除、查看和清空常用服务器地址。
|
|
11
|
+
- **图片渲染**：将查询结果生成为游戏风格的图片横幅（基于 Puppeteer）。
|
|
14
12
|
|
|
15
|
-
|
|
13
|
+
## 依赖插件
|
|
16
14
|
|
|
17
|
-
|
|
18
|
-
|
|
19
|
-
|
|
20
|
-
|
|
15
|
+
本插件强依赖以下插件，请确保它们已安装并启用：
|
|
16
|
+
|
|
17
|
+
- `koishi-plugin-gamedig`：用于查询 Source 引擎服务器。
|
|
18
|
+
- `koishi-plugin-puppeteer`：用于将 HTML 渲染为图片。
|
|
19
|
+
- `database`：用于存储服务器列表。
|
|
20
|
+
|
|
21
|
+
## 命令列表
|
|
22
|
+
|
|
23
|
+
### `cs <address:string>` - 查询单个服务器
|
|
24
|
+
|
|
25
|
+
查询指定地址的 CS 服务器状态。
|
|
26
|
+
|
|
27
|
+
**别名**：`查询`、`server`
|
|
28
|
+
|
|
29
|
+
**选项**：
|
|
30
|
+
|
|
31
|
+
- `-i, --image`：强制生成图片横幅（即使配置中关闭了图片生成）。
|
|
32
|
+
|
|
33
|
+
- `-t, --text`：强制输出文本格式（即使配置中开启了图片生成）。
|
|
34
|
+
|
|
35
|
+
- `-c, --clear`：清除插件运行时的内存缓存。
|
|
36
|
+
|
|
37
|
+
**用法**：
|
|
38
|
+
|
|
39
|
+
```bash
|
|
40
|
+
cs 127.0.0.1:27015
|
|
41
|
+
cs edgebug.cn
|
|
42
|
+
cs [::1]:27015 -i
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
### `cs.status` - 检查插件状态
|
|
46
|
+
|
|
47
|
+
显示插件当前运行状态、缓存数量和依赖可用性。
|
|
48
|
+
|
|
49
|
+
**用法**：
|
|
50
|
+
|
|
51
|
+
```bash
|
|
52
|
+
cs.status
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
### `cs.help` - 查看帮助信息
|
|
56
|
+
|
|
57
|
+
显示本插件的命令帮助。
|
|
58
|
+
|
|
59
|
+
### `csss [...addresses]` - 批量查询服务器
|
|
60
|
+
|
|
61
|
+
批量查询多个服务器。如果不指定地址，将查询数据库中存储的服务器列表。
|
|
62
|
+
|
|
63
|
+
**别名**：`批量查询`
|
|
64
|
+
|
|
65
|
+
**选项**：
|
|
66
|
+
|
|
67
|
+
- `-l, --list`：显示数据库中保存的服务器列表。
|
|
68
|
+
|
|
69
|
+
- `-a <address>, --add <address>`：添加一个服务器到数据库列表。
|
|
70
|
+
|
|
71
|
+
- `-r <index>, --remove <index>`：从数据库列表中移除指定序号的服务器。
|
|
72
|
+
|
|
73
|
+
- `-c, --clear`：清空数据库中的服务器列表。
|
|
74
|
+
|
|
75
|
+
- `-i, --image`：强制生成图片横幅。
|
|
76
|
+
|
|
77
|
+
- `-t, --text`：强制输出文本格式。
|
|
78
|
+
|
|
79
|
+
**用法**：
|
|
80
|
+
|
|
81
|
+
```bash
|
|
82
|
+
# 查询数据库中的所有服务器
|
|
83
|
+
csss
|
|
84
|
+
|
|
85
|
+
# 临时查询指定的几个服务器
|
|
86
|
+
csss 192.168.1.1:27015 game.example.com:27016
|
|
87
|
+
|
|
88
|
+
# 管理数据库列表
|
|
89
|
+
csss -l #显示数据库中保存的服务器列表
|
|
90
|
+
csss -a 127.0.0.1:27015 #将127.0.0.1:27015添加到数据库列表
|
|
91
|
+
csss -r 1 #从数据库列表中移除序号为1的服务器
|
|
92
|
+
csss -c #清空数据库中的服务器列表
|
|
93
|
+
```
|
|
94
|
+
|
|
95
|
+
## 自定义样式指南
|
|
96
|
+
|
|
97
|
+
`koishi-plugin-csss` 支持通过 `customCSS` 配置项注入自定义 CSS，让您能自由调整生成图片的视觉效果。本指南将说明可用的 HTML 结构、类名和修改示例。
|
|
98
|
+
|
|
99
|
+
### HTML 结构概览
|
|
100
|
+
|
|
101
|
+
### 单个服务器查询 (cs)
|
|
102
|
+
|
|
103
|
+
```html
|
|
104
|
+
<body>
|
|
105
|
+
<div class="corner corner-tl"></div>
|
|
106
|
+
<div class="corner corner-tr"></div>
|
|
107
|
+
<div class="corner corner-bl"></div>
|
|
108
|
+
<div class="corner corner-br"></div>
|
|
109
|
+
|
|
110
|
+
<div class="title">[服务器状态查询]</div>
|
|
111
|
+
<div class="server-name">服务器名称</div>
|
|
112
|
+
<div class="divider"></div>
|
|
113
|
+
|
|
114
|
+
<div class="info-row">
|
|
115
|
+
<span>地图: de_dust2</span>
|
|
116
|
+
<span>IP: 127.0.0.1:27015</span>
|
|
117
|
+
</div>
|
|
118
|
+
<div class="info-row">
|
|
119
|
+
<span style="color: #4CAF50;">人数: 12/32</span>
|
|
120
|
+
<span style="color: #4CAF50;">Ping: 45ms</span>
|
|
121
|
+
</div>
|
|
122
|
+
|
|
123
|
+
<div class="player-section">
|
|
124
|
+
<div class="player-section-title">在线玩家</div>
|
|
125
|
+
<div class="divider" style="margin: 5px 0 15px;"></div>
|
|
126
|
+
<!-- 玩家列表 -->
|
|
127
|
+
<div class="player-row">玩家名1</div>
|
|
128
|
+
<div class="player-row">玩家名2</div>
|
|
129
|
+
...
|
|
130
|
+
</div>
|
|
131
|
+
|
|
132
|
+
<div class="timestamp">查询时间: 2024/1/1 12:00:00</div>
|
|
133
|
+
</body>
|
|
134
|
+
```
|
|
135
|
+
|
|
136
|
+
### 批量服务器查询 (csss)
|
|
137
|
+
|
|
138
|
+
```html
|
|
139
|
+
<body>
|
|
140
|
+
<!-- 四角边框装饰 -->
|
|
141
|
+
<div class="corner corner-tl"></div> ...
|
|
142
|
+
|
|
143
|
+
<div class="title">[服务器状态批量查询]</div>
|
|
144
|
+
<div class="stats">
|
|
145
|
+
<span>查询时间: ...</span>
|
|
146
|
+
<span>耗时: 2.1秒 | 成功: 3/5</span>
|
|
147
|
+
</div>
|
|
148
|
+
<div class="divider"></div>
|
|
149
|
+
|
|
150
|
+
<!-- 每个服务器一个 item -->
|
|
151
|
+
<div class="server-item">
|
|
152
|
+
<div class="server-header">
|
|
153
|
+
<span class="server-index">1.</span>
|
|
154
|
+
<span class="server-name">服务器A</span>
|
|
155
|
+
<span class="server-players" style="color: #4CAF50;">12/32</span>
|
|
156
|
+
</div>
|
|
157
|
+
<div class="server-details">
|
|
158
|
+
<span class="server-addr">127.0.0.1:27015</span>
|
|
159
|
+
<span class="server-ping" style="color: #4CAF50;">延迟: 45ms</span>
|
|
160
|
+
</div>
|
|
161
|
+
<div class="server-details">
|
|
162
|
+
<span class="server-map">地图: de_dust2</span>
|
|
163
|
+
</div>
|
|
164
|
+
</div>
|
|
165
|
+
|
|
166
|
+
<!-- 查询失败的条目 -->
|
|
167
|
+
<div class="server-item error">
|
|
168
|
+
<div class="server-header">
|
|
169
|
+
<span class="server-index">2.</span>
|
|
170
|
+
<span class="server-name">192.168.1.1:27016</span>
|
|
171
|
+
<span class="server-status">❌ 查询失败</span>
|
|
172
|
+
</div>
|
|
173
|
+
<div class="server-details error-msg">连接超时</div>
|
|
174
|
+
</div>
|
|
175
|
+
|
|
176
|
+
<div class="timestamp">📋 输入 `cs 服务器地址` 查询单个服务器</div>
|
|
177
|
+
</body>
|
|
178
|
+
```
|
|
179
|
+
|
|
180
|
+
### 注意事项
|
|
181
|
+
|
|
182
|
+
- 使用`!important`：默认样式通常带有较高优先级，自定义时建议加`!important`确保覆盖。
|
|
183
|
+
|
|
184
|
+
- 字体支持：请确保运行环境已安装您指定的字体，否则将回退到默认等宽字体。
|
|
185
|
+
|
|
186
|
+
- 图片尺寸：`imageWidth` 和 `imageHeight` 在配置中设定，但可通过 CSS 覆盖 `body` 的 `width` 和 `min-height`。
|