# air-plugin
**Repository Path**: ts-yf/air-plugin
## Basic Information
- **Project Name**: air-plugin
- **Description**: TRSS云崽机器人插件，一些小型娱乐功能
- **Primary Language**: JavaScript
- **License**: AFL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-07-09
- **Last Updated**: 2026-05-10
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Yunzai Air-Plugin [已停更]
云崽机器人插件，主要适配官方机器人，搭配TRSS云崽的QQbot使用
> 推荐使用锅巴插件来配置Air-plugin
[](https://qm.qq.com/q/Rv6pE8M8Ug)
## 安装教程
## 1. 准备：[Yunzai-Bot](https://github.com/TimeRainStarSky/Yunzai)
## 2. 选择安装方式，在云崽根目录执行
> 使用Gitee安装
```
git clone -b main --depth=1 https://gitee.com/ts-yf/air-plugin.git ./plugins/air-plugin/
```
## 3.安装依赖
> air-plugin目录下执行
使用yarn
> 不推荐npm，pnpm！
> Linux用户可能会有点不一样，自行查找教程
```
# 安装yarn，可使用npm，pnpm等包管理器安装，已安装可跳过
pnpm add yarn
```
```
pnpm yarn
```
点击展开
注意：需要备案域名和ssl证书
进入库内 main/php/ 将url整体放到网站根目录
先把校验文件下载到网站根目录，然后将你的域名网站添加到
```
QQ开放平台-机器人-开发设置-消息url配置
```
然后将你的网站按下方加入到消息url配置中，
```
你的网站域名/url
```
进锅巴添加把你的网站添加到消息url配置中
```
https://你的网站域名/url?url=
```
伊蕾娜图片
- `#随机伊蕾娜`
[](https://github.com/ts-yf/air-plugin)
- `#今日伊蕾娜`
[](https://github.com/ts-yf/air-plugin)
- `#表情伊蕾娜`
[](https://github.com/ts-yf/air-plugin)
官机代发
- 使用锅巴插件配置 官机代发 相关设置即可
- 使用数据账号接收消息并使用官方机器人发送消息
- 免去频繁艾特官方机器人的步骤
- 第一版，有不少bug，严重恶性bug及时停止插件并进入班级群反馈
> 在Ark白名单内加入数据账号QQ即可使用Ark代发
[](https://github.com/ts-yf/air-plugin)
QQ智能体
- chat功能需要在[腾讯元器](https://yuanqi.tencent.com/)申请智能体
- 按照调用示例所给的东西填入config
- "appid: 智能体id, token: 智能体token"
- #CE + `问题`
[](https://github.com/ts-yf/air-plugin)
全局转换模板md
### 将云崽发送的消息转换为特定模板md再发送
| 原内容 | 转换后 |
| - | - |
| 纯文本 | 文字模板md |
| 纯图片 | 图片模板md |
| 图文混排 | 图文模板md |
###### 正确配置消息url与图床cookie以体验完整版，否则无法发送包含链接，图片的消息
> 使用锅巴配置
- 在锅巴插件配置页面找到`air插件`
- 配置好`Markdown类设置`
- 添加`markdown白名单`，填写BotQQ号
全局转Ark
### 将云崽发送的消息转换为特定Ark再发送
> 注意：截止`2024-7-28`测试Ark功能仅能在`私域机器人`使用，公域的需要达到特定DAU数量去申请权限
| 原内容 | 转换后 |
| - | - |
| 纯文本 | 文本卡片 |
| 带链接文本 | 文本链接卡片 |
| 图片 | 大图卡片 |
###### 正确配置消息url与图床cookie以体验完整版，否则无法发送包含链接，图片的消息
> 使用锅巴配置-推荐
- 在锅巴插件配置页面找到`air插件`
- 打开`全局转Ark`
- 添加`Ark白名单`，填写BotQQ号
> 手动配置
- 在插件目录找到`config/air.config.yaml`使用文本编辑器打开
- 添加以下内容
```
msgReset: true
Ark_users:
- 123456789
```
图床Cookie
- 前往[花瓣网](https://www.huaban.com)注册并登录
- 自行搜索`获取网页cookie方法`