koishi-plugin-onebot-touxian
Koishi 插件：onebot-touxian - QQ 群头衔修改插件，支持管理员给成员设置头衔和群成员自助设置头衔。
💬 插件使用问题 / 🐛 Bug反馈 / 👨💻 插件开发交流，欢迎加入QQ群：259248174 🎉（这个群G了）
💬 插件使用问题 / 🐛 Bug反馈 / 👨💻 插件开发交流，欢迎加入新QQ群：1085190201 🎉
💡 在群里直接艾特我，回复的更快哦~ ✨
预览
安装
yarn add koishi-plugin-onebot-touxian
# or
npm install koishi-plugin-onebot-touxian
或在 Koishi 控制台的插件市场中搜索 onebot-touxian 安装。
功能特性
-
管理员设置头衔 — 通过 设置头衔指令为指定成员设置群头衔（需在配置中添加 QQ 号） -
自助设置头衔 — 群成员通过 自助头衔指令为自己设置专属头衔 -
支持 @ 提及 — 通过
@用户或直接输入 QQ 号指定目标用户 -
指令别名 — 设置头衔同时支持ast和awa_set_title两种别名
前置条件
使用本插件前，请确保目标群已开启 展示成员群头衔 功能：
手机QQ → 右上角 ☰ → 管理群 → 个性管理 → 群头衔和标识管理 → 开启 「展示成员群头衔」
否则即使通过 API 设置了头衔，群成员也不会看到。
使用示例
管理员给他人设置头衔
需要先将自己的 QQ 号添加到配置的 adminUsers 列表中。
设置头衔 ThisIsALongTouxian @VincentZyu
可以通过 @ 方式指定用户并设置头衔
设置头衔 ThisIsAnotherLongTouxian 1830540513
也可以传入qq号
自助设置头衔
任何人都可以使用，为自己设置专属群头衔。
自助头衔 ThisIsMyTitle
配置项
| 配置项 | 类型 | 默认值 | 说明 |
|---|---|---|---|
adminCommandName |
string |
设置头衔 |
管理员给他人设置头衔的指令名 |
selfCommandName |
string |
自助头衔 |
给自己设置头衔的指令名 |
adminUsers |
string[] |
[] |
允许使用设置头衔指令的 QQ 号列表 |
