[v4.9.9] - feat(feishu): 尝试接入飞书并且回退黑白名单逻辑,保持旧版本逻辑,插件统一管理

This commit is contained in:
SXP-Simon
2026-03-29 01:08:00 +08:00
parent 43f80d24f8
commit b041a7ca9e
3 changed files with 23 additions and 23 deletions
+6 -7
View File
@@ -1,18 +1,17 @@
# 更新日志 (CHANGELOG) # 更新日志 (CHANGELOG)
## [v4.9.8] - feat(HatsuneMiku): 新增了一个名为 HatsuneMiku 的模板 (#134 @Shiitin) ## [v4.9.9] - feat(feishu): 尝试接入飞书并且回退黑白名单逻辑,保持旧版本逻辑,插件统一管理
* **🐛 黑白名单修复**: 分析名单准入并修复 AstrBot 内置白名单绕过问题 (情况如 #133 所述)
* **✨ 新模板 HatsuneMiku**: 感谢 @Shiitin 的贡献,新增了一个名为 HatsuneMiku 的模板,灵感来源于初音未来的可爱风格,适合喜欢二次元风格的用户使用。
<img src="https://fastly.jsdelivr.net/gh/SXP-Simon/astrbot_plugin_qq_group_daily_analysis@main/assets/HatsuneMiku-demo.jpg" alt="HatsuneMiku" width="100%">
--- ---
<details> <details>
<summary>📋 点击查看历史更新日志</summary> <summary>📋 点击查看历史更新日志</summary>
## [v4.9.8] - feat(HatsuneMiku): 新增了一个名为 HatsuneMiku 的模板 (#134 @Shiitin)
* **🐛 黑白名单修复**: 分析名单准入并修复 AstrBot 内置白名单绕过问题 (情况如 #133 所述)
* **✨ 新模板 HatsuneMiku**: 感谢 @Shiitin 的贡献,新增了一个名为 HatsuneMiku 的模板,灵感来源于初音未来的可爱风格,适合喜欢二次元风格的用户使用。
<img src="https://fastly.jsdelivr.net/gh/SXP-Simon/astrbot_plugin_qq_group_daily_analysis@main/assets/HatsuneMiku-demo.jpg" alt="HatsuneMiku" width="100%">
## [v4.9.7] - feat(分析配置细粒度化): 引入三层黑白名单机制(基础群分析开关、定时分析、增量分析),支持更细粒度的群级分析控制;修复自动分析生命周期管理情况避免任务被静默跳过 ## [v4.9.7] - feat(分析配置细粒度化): 引入三层黑白名单机制(基础群分析开关、定时分析、增量分析),支持更细粒度的群级分析控制;修复自动分析生命周期管理情况避免任务被静默跳过
* **🐛 自动分析调度修复**: 修复自动分析任务生命周期检查链路,重置 `schedule_jobs``_terminating` 状态,避免任务被静默跳过;增量分析任务生命周期行为与定时分析保持一致。(#130 @Dongmayyys) * **🐛 自动分析调度修复**: 修复自动分析任务生命周期检查链路,重置 `schedule_jobs``_terminating` 状态,避免任务被静默跳过;增量分析任务生命周期行为与定时分析保持一致。(#130 @Dongmayyys)
* **✨ 配置能力增强**: 引入三层黑白名单机制(基础群分析、定时分析、增量分析),支持更细粒度的群级分析控制;并同步完善面板文案与说明,明确不同名单组合下的实际触发行为,降低配置歧义 * **✨ 配置能力增强**: 引入三层黑白名单机制(基础群分析、定时分析、增量分析),支持更细粒度的群级分析控制;并同步完善面板文案与说明,明确不同名单组合下的实际触发行为,降低配置歧义
+16 -15
View File
@@ -2,7 +2,7 @@
# 群聊日常分析插件 # 群聊日常分析插件
[![Plugin Version](https://img.shields.io/badge/Latest_Version-v4.9.8-blue.svg?style=for-the-badge&color=76bad9)](https://github.com/SXP-Simon/astrbot-qq-group-daily-analysis) [![Plugin Version](https://img.shields.io/badge/Latest_Version-v4.9.9-blue.svg?style=for-the-badge&color=76bad9)](https://github.com/SXP-Simon/astrbot-qq-group-daily-analysis)
[![AstrBot](https://img.shields.io/badge/AstrBot-Plugin-ff69b4?style=for-the-badge)](https://github.com/AstrBotDevs/AstrBot) [![AstrBot](https://img.shields.io/badge/AstrBot-Plugin-ff69b4?style=for-the-badge)](https://github.com/AstrBotDevs/AstrBot)
[![License](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE) [![License](https://img.shields.io/badge/License-MIT-green.svg?style=for-the-badge)](LICENSE)
[![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SXP-Simon/astrbot_plugin_qq_group_daily_analysis) [![Ask DeepWiki](https://deepwiki.com/badge.svg)](https://deepwiki.com/SXP-Simon/astrbot_plugin_qq_group_daily_analysis)
@@ -29,20 +29,6 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
</div> </div>
## Feishu / Lark 集成说明
本插件通过 `LarkAdapter` 复用 AstrBot 已有的 `lark_oapi` 生态能力,在获得授权后即可对 Feishu 群聊执行完整的消息采集与分析。
- **一次性授权**:在飞书开放平台中为你的应用补齐如下权限(仅需在初次部署时授予):
- `im:message:readonly``im:chat:readonly`(读取群消息/群信息)
- `contact:contact.base:readonly`(拉取用户昵称/头像;缺少该权限会导致头像永远显示默认)
- 发送需要的附加 scope(如 `im:message:send` / `im:message:receive_v1` / 上传相关的 `im:resource` 系列)
- **用户头像保障**:插件在分析前会调用 `LarkAdapter.prepare_group_member_cache`,一次性批量拉取最多 100 名活跃成员的头像并在缓存中保留,让后续分析阶段不再遇到“未授权头像”。
- **令牌与长时运行**:飞书的 `tenant_access_token` 有 2 小时有效期,分析任务运行时间若超过此周期,请确保你的 Bot 框架会自动刷新令牌(通常是 SDK 默认行为)。
读取 Feishu 配置后,按照上述授权顺序重新安装/刷新应用,就能在报告里面看到与 QQ/Telegram 一样的用户筛选、头像与 LLM 输出。
## 效果 ## 效果
@@ -135,6 +121,21 @@ _✨ 一个基于 AstrBot 的智能群聊分析插件,支持 **QQ (OneBot)**
> >
> **自部署 T2I 文档**docs.astrbot.app/others/self-host-t2i.html > **自部署 T2I 文档**docs.astrbot.app/others/self-host-t2i.html
> [!IMPORTANT]
>
> Feishu / Lark 集成说明
>
> 本插件通过 `LarkAdapter` 复用 AstrBot 已有的 `lark_oapi` 生态能力,在获得授权后即可对 Feishu 群聊执行完整的消息采集与分析。
>
> - **一次性授权**:在飞书开放平台中为你的应用补齐如下权限(仅需在初次部署时授予):
> - `im:message:readonly`、`im:chat:readonly`(读取群消息/群信息)
> - `contact:contact.base:readonly`(拉取用户昵称/头像;缺少该权限会导致头像永远显示默认)
> - 发送需要的附加 scope(如 `im:message:send` / `im:message:receive_v1` / 上传相关的 `im:resource` 系列)
> - **用户头像保障**:插件在分析前会调用 `LarkAdapter.prepare_group_member_cache`,一次性批量拉取最多 100 名活跃成员的头像并在缓存中保留,让后续分析阶段不再遇到“未授权头像”。
> - **令牌与长时运行**:飞书的 `tenant_access_token` 有 2 小时有效期,分析任务运行时间若超过此周期,请确保你的 Bot 框架会自动刷新令牌(通常是 SDK 默认行为)。
> 读取 Feishu 配置后,按照上述授权顺序重新安装/刷新应用,就能在报告里面看到与 QQ/Telegram 一样的用户筛选、头像与 LLM 输出。
### 🛠️ 灵活配置 ### 🛠️ 灵活配置
- **多平台支持**: 自动识别并适配 OneBot, Discord, Telegram 等平台 - **多平台支持**: 自动识别并适配 OneBot, Discord, Telegram 等平台
+1 -1
View File
@@ -1,7 +1,7 @@
name: astrbot_plugin_qq_group_daily_analysis # 这是你的插件的唯一识别名。 name: astrbot_plugin_qq_group_daily_analysis # 这是你的插件的唯一识别名。
display_name: 群分析总结插件 # 插件的显示名称 display_name: 群分析总结插件 # 插件的显示名称
desc: "[多平台接入开发中] 群日常分析总结插件 - 支持 QQ (aiocqhttp)、Telegram、Discord 以及 Feishu (Lark);生成精美的群聊分析报告,支持话题分析、用户形象、群聊圣经等功能" # 插件简短描述 desc: "[多平台接入开发中] 群日常分析总结插件 - 支持 QQ (aiocqhttp)、Telegram、Discord 以及 Feishu (Lark);生成精美的群聊分析报告,支持话题分析、用户形象、群聊圣经等功能" # 插件简短描述
version: v4.9.8 # 插件版本号。格式:v1.1.1 或者 v1.1 version: v4.9.9 # 插件版本号。格式:v1.1.1 或者 v1.1
author: SXP-Simon # 作者 author: SXP-Simon # 作者
astrbot_version: ">=4.16.0" astrbot_version: ">=4.16.0"
support_platforms: support_platforms: