使用 OneBot V11 API 获取用户信息、群管理员列表、群公告和群精华消息，并以文本、Puppeteer 图片、resvg 图片或合并转发消息发送结果。
推荐接入 NapCat，可获取的用户与群聊字段更加完整。并且作者开发测试和生产环境用的就是NapCat捏。
| 功能 | 支持内容 |
|---|---|
| 用户信息 | 基础资料、群成员信息、QQ 状态及协议端扩展字段 |
| 群管理员列表 | 群主与管理员资料、群信息及头像 |
| 群精华 | 精华消息列表、分页浏览和单条详情 |
| 群公告 | 公告列表、分页浏览和单条详情 |
| 多种输出 | 文本、Puppeteer 图片、resvg 图片和 OneBot 合并转发 |
| 辅助能力 | 图片样式切换、深色模式、自动撤回和 WebUI 配置汇总 |
| 协议端 | 状态 | 说明 |
|---|---|---|
| NapCat | 完整适配 | 推荐使用，可获取更多扩展字段 |
| Lagrange.OneBot | 已适配 | 支持用户信息与群聊相关功能 |
| LLOneBot / Lucky Lillia Bot | 未适配 | 部分返回格式与 NapCat 相同，可自行尝试 |
本插件仅面向 OneBot V11 会话，使用其他协议时相关指令会返回不支持提示。
| 依赖 | 类型 | 用途 |
|---|---|---|
http |
必需服务 | 请求头像、公告图片和字体资源 |
@resvg/resvg-js |
npm 运行时依赖 | 轻量级 SVG 图片渲染，由插件依赖自动安装 |
puppeteer |
可选服务 | 启用 Puppeteer 图片输出时需要 |
notifier |
可选服务 | 在 Koishi WebUI 中展示配置汇总与提示 |
console |
可选服务 | 启用 WebUI 渲染预览时需要 |
默认仅开启 Puppeteer 图片输出，因此使用默认配置时需要启用一个提供 puppeteer 服务的插件。未启用 Puppeteer 时，可改用文本、resvg 图片或合并转发输出。
所有指令名都可以在插件配置中修改。
| 默认指令 | 常用别名 | 功能 |
|---|---|---|
用户信息 [QQ号或@用户] |
aui、awa_user_info |
查询用户及群成员详细信息 |
群管理列表 |
al、awa_group_admin_list |
查询当前群的群主和管理员 |
群精华列表 |
群精华、age |
分页查看群精华消息 |
群精华详情 <序号> |
aged |
查看指定精华消息详情 |
群公告列表 |
群公告、agn |
分页查看群公告 |
群公告详情 <序号> |
agnd |
查看指定公告详情 |
查看puppeteer图片样式 |
- | 查看可用的 Puppeteer 图片样式 |
常用选项如下：
-i, --index <序号>：选择 Puppeteer 图片样式。--mode <light|dark>：覆盖 resvg 图片的明暗模式。-p, --page <页码>：指定群公告或群精华列表页码。-s, --pagesize <数量>：指定列表每页显示数量。
| 格式 | 配置项 | 说明 |
|---|---|---|
| 文本消息 | sendText |
直接发送易于复制的文本内容 |
| Puppeteer 图片 | sendImage |
支持 Source、LXGW 和 Flat 图片样式 |
| resvg 图片 | sendImageSvg |
资源占用较低，适合快速稳定出图 |
| 合并转发 | sendForward |
使用 OneBot 合并转发消息展示结构化信息 |
至少需要启用一种输出格式。多种格式可以同时开启；当 Puppeteer 服务不可用时，插件会跳过 Puppeteer 图片并继续发送其他已启用格式。
以下图片均使用 NapCat 平台生成。
- Source：使用思源宋体渲染的现代信息卡片样式。
- LXGW：使用霞鹜文楷渲染的黑白信息卡片样式。
- Flat：色块清晰的扁平化信息卡片样式。
- resvg：使用 SVG 模板与 resvg 引擎渲染的轻量图片。
以下文档保留了不同 OneBot 实现返回的原始 JSON 数据，方便对照字段差异和排查协议适配问题。
跨实现的稳定字段另提供一份文档型 Proto3 Schema，其设计说明见 Protocol Buffer 数据模型。该 Schema 不参与插件运行或代码生成。
| 协议端 | 用户信息 | 管理员列表 |
|---|---|---|
| Lagrange.OneBot | 查看样例 | 查看样例 |
| NapCat | 查看样例 | 查看样例 |
图片渲染使用以下开源字体：
- 思源宋体（Source Han Serif SC），遵循 SIL Open Font License 1.1。
- 霞鹜文楷（LXGW WenKai），遵循 SIL Open Font License 1.1。
本插件基于 MIT License 开源，欢迎修改、分发和二次开发。
Bug 反馈、功能建议和插件开发交流可加入 QQ 群 1085190201，也可以通过 Koishi 论坛主题 或仓库 Issue 反馈。