Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/eric2788/koishi-plugin-random-source-selector
透过扫描API链接返回的数据随机抽出一条作为图片或文案发送，支援自定义指令
https://github.com/eric2788/koishi-plugin-random-source-selector
koishi koishi-plugin setu
Last synced: 1 day ago
JSON representation
透过扫描API链接返回的数据随机抽出一条作为图片或文案发送，支援自定义指令
- Host: GitHub
- URL: https://github.com/eric2788/koishi-plugin-random-source-selector
- Owner: eric2788
- Created: 2023-10-26T16:35:52.000Z (about 1 year ago)
- Default Branch: master
- Last Pushed: 2024-01-19T02:46:53.000Z (10 months ago)
- Last Synced: 2024-04-26T16:46:22.251Z (7 months ago)
- Topics: koishi, koishi-plugin, setu
- Language: TypeScript
- Homepage:
- Size: 79.1 KB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
# koishi-plugin-random-source-selector
[](https://www.npmjs.com/package/koishi-plugin-random-source-selector)
透过多行文本链接随机抽出一条作为图片或文案发送，支援自定义指令
## 功能介绍
目前支援的数据解析类型:
- JSON
- 多行文本
- HTML
- 资源
- 源数据
目前支援的发送类型:
- 图片
- 文本
- EJS模板
- 视频
- 音频
- 文件
目前支援透过指令传递参数:
- 以 `{0}` `{1}` `{2}` 传入...
- 透过 `--data` 传入 payload
## 一般例子
**假设你需要传输指令参数到你的链接**
你可以使用 `{0}` `{1}` 等等的方式来传递参数, 例如:
```url
https://google.com/search?q={0}
```
当你的指令为 `google hello` 时，插件会将 `{0}` 替换为 `hello`，并发送到 `https://google.com/search?q=hello`。
另外也支援多个参数，例如:
```url
https://google.com/search?q={0}&safe={1}
```
当你的指令为 `google hello true` 时，插件会将 `{0}` 替换为 `hello`，`{1}` 替换为 `true`，并发送到 `https://google.com/search?q=hello&safe=true`。
---
**假设你需要透过 payload 传输参数到你的链接**
payload一般用在POST，PUT等请求，你可以在设定中添加 `request_data` 数据，例如:
```yml
request_data: '{"name": "{0}", "age": "{1}"}'
request_json: true
```
__注意: 假设你的数据为JSON，则必须设定 `request_json` 为 `true`__
此外，你也可以透过传入 `--data` 来覆盖设定中的参数，例如:
```sh
创建用户 --data '{"name": "foo", "age": "bar"}'
```
插件会将 `--data` 的数据覆盖 `request_data` 中的数据，然后提交请求。
---
**假设你的链接返回多行文本**，例如
```txt
今天礼拜四，V我50
今天是疯狂星期四！！
```
则选择发送类型为`文本`, 数据返回类型为`多行文本`, 插件便会从这两句文案中随机抽选一个返回。
---
**假设你的链接返回多行图片链接**，例如
```txt
https://cdn.xyz/abc.jpg
https://cdn.xyz/xyz.jpg
```
则选择发送类型为`图片`, 数据返回类型为`多行文本`, 插件便会从这两条图片链接随机抽选一张图片返回。
---
**假设你的链接返回随机图片**
则选择发送类型为`图片`, 数据返回类型为`资源`, 插件则会直接把该链接返回的图片直接发送。
此类型适用于所有资源，包括视频，音频，文件等。
## 额外的解析类型选项 + 例子
### HTML
透过 Jquery 提取文本，设置如下
```yml
jquery_selector: 提取元素, 相当于 querySelectorAll(value)
attribute: 获取元素属性, 相当于 getAttribute(value)
```
例子如下:
```html
```
想获取仅限 class 中包含 `abc` 的图片链接，则可用:
```yml
jquery_selector: .abc
attribute: src
```
插件则会从该三张图片中随机抽选。
__注意: 提取的 html 文本为 http 请求的文本，不包含js后期注入的html元素__
### JSON
透过字符进行JSON取值，设置如下
```yml
json_key: 需要扫描的key, 相当于在js中获取json数值时的引用 + 支援迭代逻辑 []
```
例子如下:
```json
[
{
"id": "_5degoesxi",
"question": "What would you like to practice today?",
"possible_answers": [
{
"label": "HTML & CSS",
"action": {
"key": "lesson_category",
"type": "html-css"
}
},
{
"label": "General Typing",
"action": {
"key": "lesson_category",
"type": "general"
}
}
]
},
{
"id": "_zvcr8k6sq",
"question": "Choose your difficult level.",
"possible_answers": [
{
"label": "Easy",
"action": {
"key": "difficulty",
"type": "easy"
}
},
{
"label": "Medium",
"action": {
"key": "difficulty",
"type": "medium"
}
},
{
"label": "Hard",
"action": {
"key": "difficulty",
"type": "hard"
}
}
]
}
]
```
若想获取所有元素中内 action 的 type, 则使用
```yml
json_key: "[].possible_answers[].action.type"
```
`[]` 代表迭代，会提取每个迭代元素的值。
提取后将会从 `hard`, `medium`, `easy`, `general`, `html-css` 中随机抽选。
---
若 JSON 从 object 而非 array 开始，则直接填入该 object 的 key 即可，例如:
```json
{
"abc": {
"xyz": ["foo", "bar"]
}
}
```
则填入:
```yml
json_key: "abc.xyz"
```
就可获得 `foo`, `bar` 的随机抽选。
__注意: 若 `json_key` 填写不当有可能会导致插件报错。__
### EJS
数据类型选择``元数据``，填入``EJS模板``即可。
假设你的返回数据为以下的json:
```json
{
"name": "morpheus",
"job": "leader",
"id": "583",
"createdAt": "2023-11-13T06:30:39.982Z"
}
```
EJS模板则可输入:
```yml
ejs_template: |-
成功创建 name: <%= data.name %>, job: <%= data.job %>
id: <%= data.id %>
```
插件将会根据模板输出回应。