Skip to content

透过扫描API链接返回的数据随机抽出一条作为图片或文案发送,支援自定义指令

Notifications You must be signed in to change notification settings

eric2788/koishi-plugin-random-source-selector

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

21 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

koishi-plugin-random-source-selector

npm

透过多行文本链接随机抽出一条作为图片或文案发送,支援自定义指令

功能介绍

目前支援的数据解析类型:

  • JSON
  • 多行文本
  • HTML
  • 资源
  • 源数据

目前支援的发送类型:

  • 图片
  • 文本
  • EJS模板
  • 视频
  • 音频
  • 文件

目前支援透过指令传递参数:

  • {0} {1} {2} 传入...

  • 透过 --data 传入 payload

一般例子

假设你需要传输指令参数到你的链接

你可以使用 {0} {1} 等等的方式来传递参数, 例如:

https://google.com/search?q={0}

当你的指令为 google hello 时,插件会将 {0} 替换为 hello,并发送到 https://google.com/search?q=hello

另外也支援多个参数,例如:

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 数据,例如:

request_data: '{"name": "{0}", "age": "{1}"}'
request_json: true

注意: 假设你的数据为JSON,则必须设定 request_jsontrue

此外,你也可以透过传入 --data 来覆盖设定中的参数,例如:

创建用户 --data '{"name": "foo", "age": "bar"}'

插件会将 --data 的数据覆盖 request_data 中的数据,然后提交请求。


假设你的链接返回多行文本,例如

今天礼拜四,V我50
今天是疯狂星期四!!

则选择发送类型为文本, 数据返回类型为多行文本, 插件便会从这两句文案中随机抽选一个返回。


假设你的链接返回多行图片链接,例如

https://cdn.xyz/abc.jpg
https://cdn.xyz/xyz.jpg

则选择发送类型为图片, 数据返回类型为多行文本, 插件便会从这两条图片链接随机抽选一张图片返回。


假设你的链接返回随机图片

则选择发送类型为图片, 数据返回类型为资源, 插件则会直接把该链接返回的图片直接发送。

此类型适用于所有资源,包括视频,音频,文件等。

额外的解析类型选项 + 例子

HTML

透过 Jquery 提取文本,设置如下

jquery_selector: 提取元素, 相当于 querySelectorAll(value)
attribute: 获取元素属性, 相当于 getAttribute(value)

例子如下:

<img class="abc" src="https://cdn.xyz/abc1.img">
<img class="abc" src="https://cdn.xyz/abc2.img">
<img class="abc" src="https://cdn.xyz/abc3.img">
<img class="xyz" src="https://cdn.xyz/xyz.img">

想获取仅限 class 中包含 abc 的图片链接,则可用:

jquery_selector: .abc
attribute: src

插件则会从该三张图片中随机抽选。

注意: 提取的 html 文本为 http 请求的文本,不包含js后期注入的html元素

JSON

透过字符进行JSON取值,设置如下

json_key: 需要扫描的key, 相当于在js中获取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, 则使用

json_key: "[].possible_answers[].action.type"

[] 代表迭代,会提取每个迭代元素的值。 提取后将会从 hard, medium, easy, general, html-css 中随机抽选。


若 JSON 从 object 而非 array 开始,则直接填入该 object 的 key 即可,例如:

{
    "abc": {
        "xyz": ["foo", "bar"]
    }
}

则填入:

json_key: "abc.xyz"

就可获得 foo, bar 的随机抽选。

注意: 若 json_key 填写不当有可能会导致插件报错。

EJS

数据类型选择元数据,填入EJS模板即可。

假设你的返回数据为以下的json:

{
    "name": "morpheus",
    "job": "leader",
    "id": "583",
    "createdAt": "2023-11-13T06:30:39.982Z"
}

EJS模板则可输入:

ejs_template: |-
    <p> 成功创建 name: <%= data.name %>, job: <%= data.job %></p>
    <p> id: <%= data.id %> </p>

插件将会根据模板输出回应。

About

透过扫描API链接返回的数据随机抽出一条作为图片或文案发送,支援自定义指令

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published