nezumi/astrbot_plugin_qq_group_daily_analysis
1
0
Fork 0
mirror of https://github.com/Nezumi-2711/astrbot_plugin_qq_group_daily_analysis.git synced 2026-09-22 13:38:43 +00:00
Code Issues Packages Projects Releases Wiki Activity
642 Commits 3 Branches 0 Tags
docs/vietnamese-data-models
Commit Graph
65 Commits
Author SHA1 Message Date
SXP-Simon 04fa154a28 [v4.11.2] - 🛠️ 定时报告可同时发送多种格式，可关闭报告发送时的 “📊 每日群聊分析报告已生成” 文字前缀 2026-07-21 16:33:00 +08:00
clown145andSXP-Simon f2bcd6801e [v4.11.1] - 🛠️ 修复 QQ 官方机器人昵称与提及清洗 (#207) 
Fix QQ official nickname and mention handling 

* fix: restore QQ official nicknames and sanitize mentions

* fix: protect QQ official identities and whitespace

* docs: update QQ official nickname guidance

* chore: bump version to v4.11.1

* docs: remove obsolete PDF guidance

* chore: finalize v4.11.1 release prep

* fix(qqofficial): 修复 _sanitize_qq_official_mentions .strip() 吞换行，补充 allow_alphanumeric_user_ids 注释

- .strip() → .strip(' \t')：仅清除首尾空白/制表符，保留用户创作的 \n 换行
- allow_alphanumeric_user_ids：在参数定义处补充注释，说明该标记还控制 ID 正则化和回退显示名
- 响应 Sourcery 代码审查 #207 指出的问题

* chore:  删除不必要的描述

---------

Co-authored-by: SXP-Simon <sxp20061207@163.com>
 2026-07-21 14:53:31 +08:00
clown145andSXP-Simon c18224cb82 [v4.11.0] - ✨ 新增 QQ 官方机器人群聊分析与专用 Markdown 报告 (@clown145 #206) 
* feat: add QQ official bot group analysis support

* fix: use text progress replies for QQ official bot

* fix: harden QQ official proactive reporting

* feat: enhance QQ official markdown reports

* refactor: isolate QQ official markdown reporting

* fix: restore platform adapter exports

* style: format QQ official changes

* fix(main): 添加 html_render 类型声明和 Callable 导入

为 self.html_render 属性添加显式类型声明，解决定时任务中可能因缺少类型注解导致的隐式错误。

* fix(analysis): 消除 execute_daily_analysis 中重复的 bot_self_ids 赋值

去除第二次冗余的 config_manager.get_bot_self_ids() 调用，直接复用已获取的变量。

* cleanup(domain): 移除未使用的分析器适配器和死代码服务文件

删除 golden_quote_analyzer.py、topic_analyzer.py、user_title_analyzer.py（均为未被引用的接口+适配器包装）report_generator.py（旧的文本报告生成器）statistics_calculator.py（与 StatisticsService 功能重复）更新 domain/services/__init__.py 移除对上述文件的引用。

* cleanup(domain): 移除冗余的实体和值对象文件，收敛数据模型至 domain/models/data_models.py

删除 analysis_result.py（与 data_models.py 重复的 SummaryTopic/UserTitle/GoldenQuote 等类定义）value_objects/golden_quote.py、statistics.py、topic.py、user_title.py（均为未被引用的 frozen dataclass 迁移残留）。所有活跃代码已统一导入 domain/models/data_models.py。

* refactor(llm): 抽取 _make_session_id 辅助方法消除重复代码

在 5 个方法（analyze_topics、analyze_user_titles、analyze_golden_quotes、analyze_all_concurrent、analyze_incremental_concurrent）中出现完全相同的 datetime.now().strftime(...) + umo 拼接逻辑，已提取为 _make_session_id 静态方法。

* refactor(message): 正则表达式提升为模块级常量避免重复编译

DISCORD_CUSTOM_EMOJI_PATTERN 和 COMMAND_PATTERN 从类属性移至模块级常量，避免每次实例化 MessageCleanerService 时重新编译正则。

* arch(domain): 定义 IActivityVisualizer 接口并通过依赖注入消除领域层反向依赖

创建 IActivityVisualizer 接口于 domain/repositories/visualization_repository.py，StatisticsService 改由依赖注入接收该接口；ActivityVisualizer 继承接口。消除原 StatisticsService 直接 import infrastructure.visualization 的 DDD 违规。

* fix(main): 补全 Callable 导入和 html_render 类型声明

初次提交(877adb6)因 git add -p 交互式分块时 BOM 导致错误的 hunk 被暂存，Callable 导入和 html_render 类型声明丢失。本次补全这两项修改。

* fix(platform): 补充 QQOfficialAdapter、TelegramAdapter、DiscordAdapter 导出

* refactor(main): 提取内嵌的文本报告生成/发送函数为独立类方法

将 _send_analysis_report 方法中的 generate_text_reports() 和 send_text_reports() 内嵌异步函数提取为 _generate_text_reports 和 _send_text_reports 私有方法。减少闭包复杂度，提升可维护性。

* cleanup(config): 移除废弃的 get_qq_official_t2i_activity_histogram_enabled 向后兼容方法

删除 config_manager.py 中的旧名别名方法，简化 qq_official_markdown.py 中对应的 getattr 回退逻辑为直接方法调用，移除测试中专门验证旧名兼容性的 LegacyDisabledConfig 测试用例。该兼容层仅在迁移期间临时存在，现已完成过渡。

* fix(types): 修复 Pylance 类型告警 — platform_key 未绑定、int(object) 和 template.filename 可能为 None

platform_group_registry.py: 将 platform_key 定义提前，消除 Pylance reportPossiblyUnboundVariable 告警。
qq_official_markdown.py: 将 int(value or 0) 改为 int(value) if value is not None else 0，消除 reportArgumentType 告警。
templates.py: 在使用 template.filename 前增加 None 检查，消除 str|None 不可分配给 str 的告警。
qq_official_adapter.py: 为 post_group_message 添加类型忽略注解，消除 await 不可等待对象的告警。

* fix(types): 修复残留的 Pylance 类型告警

platform_group_registry.py: 将 (platform_key, group_id) 改为 (str(platform_key), group_id)，消除 str|None 不可分配给 str 的 reportArgumentType
qq_official_markdown.py: int(value) 添加 # type: ignore[arg-type]，消除 object 不可分配给 ConvertibleToInt
qq_official_adapter.py: 移除无意义的中间变量，await 行直接添加 # type: ignore[arg-type]

* docs(message): 更新 MessageProcessingService 的文档和注释，消除 Telegram 特殊性表述

类 docstring：移除 '维护 Telegram 群组注册表' 等过时描述，补充 QQ 官方去重职责。
group_registry.upsert 注释：改为泛化的跨平台描述，不再限定 Telegram。
_extract_event_timestamp / _reserve_event_id / _commit_event_id / _release_event_id：英文 docstring 统一为中文。

* docs(message): 修正类注释中只提 QQ 官方的问题，明示 Telegram 也由本服务处理

Telegram 和 QQ 官方消息都经过 MessageProcessingService.process_message()。修正前类 docstring 只提了 QQ 官方的事件去重，缺少 Telegram 作为主要调用者的说明。

* fix(types): 修正 _sanitize_analysis_result_for_export 返回类型注解

函数声明 -> dict 但 _sanitize_export_identity_text 可返回 str|dict|list，Pylance 报 reportReturnType。
改为 -> dict[str, Any] 准确表达实际返回类型，补充缺失的 from typing import Any。

* fix(types): 抑制 Pylance reportReturnType 误报

_sanitize_analysis_result_for_export 的 analysis_result 参数运行时始终为 dict，但 _to_plain_export_data 递归返回 Any 导致 Pylance 推导出 str|dict|list 联合类型。
添加 # type: ignore[return-type] 抑制此误报。

* fix(report): 渲染匿名模式下的未知引用 token 不再静默丢弃

当 hide_user_names=True 且 [id] 不在 known_ids 中时，之前返回空 Markup 导致 token 被静默移除，可能扭曲文本语义。改为返回转义后的原始 [id] 字符串，保留文本布局和语义，同时不泄露身份信息。
参考 Sourcery AI code review 建议。

* fix(import): 避免从 astrbot.core 直接导入 File，优先使用公开 API

astrbot.core 是内部模块，不在公开 API 契约中，可能随版本变化。
改为 try 优先导入 astrbot.api.message_components.File（公开 API），
失败时回退到 astrbot.core.message.components.File（向后兼容）。
同时修复 main.py 和 qq_official_adapter.py 两处导入。

* fix(import): 回退 try/except 伪装，改为直接导入 + 风险注释

astrbot.api.message_components 不存在，try/except 永远走 except 分支，是无效代码。
改为直接 from astrbot.core.message.components import File，用注释说明这是内部 API 可能变化。

* fix(ruff): 代码质量

* docs(README): 调整文档说明，删除 lark 相关的描述和功能标识

* docs(desc): 更新 desc

* fix(message): 将 TG 和 QQ 官方消息缓存成功日志降为 debug

* perf(message): 将 _extract_event_timestamp 延迟到 QQ 官方分支内计算

该时间戳仅用于 QQ 官方消息的 history_content 元数据，但对所有平台都执行了深度 getattr 链。
改为只在 QQ 官方分支内延迟计算，消除 Telegram 等平台上每次消息的白算开销。

* chore(CHANGELOG)

---------

Co-authored-by: SXP-Simon <sxp20061207@163.com>
 2026-07-20 03:24:50 +08:00
SXP-Simon 6b2d4b1dc3 [v4.10.9] - ✨ 新增模板 ”BlueArchive“ 蔚蓝档案 (@VanillaNahida) 2026-07-12 22:20:51 +08:00
SXP-Simon 06fb17bdc2 [v4.10.8] - 🛠️ snowluma 被禁言避免触发分析修复 (#191) 2026-07-10 20:32:34 +08:00
SXP-Simon 3979a30787 [v4.10.7] - ✨ 被禁言避免触发分析功能浪费 token，重构并优化模型请求的重试与降级补偿机制 2026-07-10 15:34:13 +08:00
SXP-Simon 27f0e9e838 [v4.10.6] - ✨ 支持 [SnowLuma](https://github.com/SnowLuma/SnowLuma) ，优化 HatsuneMiku 移动端适配情况 2026-05-23 16:46:35 +08:00
SXP-Simon 1a3d079535 [v4.10.5] - ✨ 支持可选流式 LLM 调用 (#181 @anchorAnc) 2026-05-01 18:37:44 +08:00
SXP-Simon 9e0f88eeda [v4.10.4] - 🛠️ 将镜像地址配置注入到子模板渲染上下文中，解决 ATRI 子模板中变量未定义导致的生成问题 2026-04-27 17:12:29 +08:00
SXP-SimonandCopilot ec2249b9a7 [v4.10.3] - ✨ 优化报告模板中的头像与内联图片复用，并修复 Miku 峰值区块窄屏排版问题 (#178 @lekoOwO) 
Co-authored-by: Copilot <copilot@github.com>
 2026-04-26 14:41:07 +08:00
SXP-SimonandCopilot bb04114cdb [v4.10.2] - ✨ Telegram 头像处理修复，支持多地区渲染环境与自定义镜像 
Co-authored-by: Copilot <copilot@github.com>
 2026-04-25 12:35:18 +08:00
SXP-Simon 948bfb1b5b refactor(render): 解决国内可能存在的资源访问问题，新增大陆资源和海外资源可选项，允许用户根据服务器位置选择不同的资源策略，并且允许自定义资源镜像站 
- Updated language attributes in HTML templates to dynamically set based on `t2i_font_source`.
- Replaced hardcoded Google Fonts links with dynamic links using `t2i_google_fonts_mirror` and `t2i_gstatic_mirror`.
- Adjusted font-family declarations to conditionally include 'Noto Sans SC' and 'Noto Sans TC' based on the `t2i_font_source`.
- Ensured consistent formatting and style across various templates including image, quote, topic, and user title items.
- Added missing newlines at the end of several files for consistency.
 2026-04-25 12:22:36 +08:00
SXP-Simon e48716dbf8 [v4.10.1] - ✨ 优化 T2I 渲染与自定义配置 2026-04-23 08:53:51 +08:00
SXP-Simon e1c5b854c7 [v4.9.19] - ✨ 支持 LLBot 群相册接口并优化 OneBot 适配器 
Fixes #173
 2026-04-22 15:17:28 +08:00
SXP-Simon d36bf4941a [v4.9.18] - ⚙️ base64 传输统一开关修复，正确处理 Onebot Adapter 的图片、文件资源传输情况 2026-04-15 23:19:51 +08:00
SXP-Simon cc162b62dd [v4.9.17] - ✨ 人格画像体验升级，SBTI 和 ACGTI 风格 2026-04-13 22:37:24 +08:00
SXP-Simon 45c9ca9bea [v4.9.16] - 增加了html_only_url选项，使在选择输出格式为html时可以单独发送BaseURL (#166 @shiitin) 2026-04-12 22:08:49 +08:00
SXP-Simon 937f4e1782 [v4.9.15] - fix: 发送假超时不应该导致上传群相册群文件失败，删除 PDF 模块和相关的功能 2026-04-07 22:30:20 +08:00
SXP-Simon b1c85d8994 [v4.9.14] - feat(persona): 分析器人格增强和使用体验优化，可视化选择人格配置 2026-04-04 21:26:31 +08:00
SXP-Simon 45988cf419 [v4.9.13] - feat(ATRI): ATRI 模板 (@Liangyu-G) 2026-04-03 14:32:02 +08:00
SXP-Simon 5dd7cf1aa1 [v4.9.12] - 移除无效的重试器 2026-04-02 17:52:36 +08:00
SXP-Simon e503e7ad63 [v4.9.11] - feat(HTML): HTML 报告与自建外链吗，将群分析变成可以点击跳转的精美网页链接 2026-04-01 22:19:00 +08:00
SXP-Simon 1fa1ebe5ca [v4.9.10] - fix: 解决 TG 未贴表情的 bug，HTML 输出模式，优化渲染 2026-03-31 21:17:31 +08:00
SXP-Simon b041a7ca9e [v4.9.9] - feat(feishu): 尝试接入飞书并且回退黑白名单逻辑，保持旧版本逻辑，插件统一管理 2026-03-29 01:08:00 +08:00
SXP-Simon 6d40745e79 [v4.9.8] - feat(HatsuneMiku): 新增了一个名为 HatsuneMiku 的模板 (#134 @Shiitin) 2026-03-28 22:45:47 +08:00
SXP-Simon b29327674f [v4.9.7] - feat(分析配置细粒度化): 引入三层黑白名单机制（基础群分析开关、定时分析、增量分析），支持更细粒度的群级分析控制；修复自动分析生命周期管理情况避免任务被静默跳过 2026-03-26 23:32:32 +08:00
SXP-Simon 90908cefcb [v4.9.6] - fix(provider): 优化 PDF 模板生成情况，基础设施健壮性增强 2026-03-25 17:43:35 +08:00
SXP-Simon 2120800abd [v4.9.5] - fix(chat_quality_analysis 模块): 优化增量分析逻辑，优化提示词 2026-03-23 17:28:17 +08:00
SXP-Simon 91692170a0 [v4.9.4] - feat(chat_quality_analysis 模块): 新增群聊质量锐评功能（灵感来源：感谢 @Nagi-ovo） 2026-03-23 00:53:05 +08:00
SXP-Simon 51d14dad0b [v4.9.3] - feat(增量分析): 更新增量分析配置，增加安全上限并优化消息拉取逻 2026-03-21 00:54:00 +08:00
SXP-Simon 3b8e2b85ba [v4.9.2] - feat(reaction): 将文字反馈调整为表情反馈 2026-03-19 15:14:33 +08:00
SXP-Simon a71a0a34db [v4.9.1] - feat(persona): 添加分析人格设定的配置选项，并更新相关提示词构建逻辑 2026-03-16 23:49:04 +08:00
SXP-Simon 02bacd3389 [v4.9.0] - fix(telegram): 增强 telegram 平台的插件可用性 2026-03-16 01:03:21 +08:00
SXP-Simon 4745fbccad [v4.8.9] - fix: 群相册严格模式修复 (#111)，尝试解决下载用户头像和重试地狱的问题 （#107） 2026-03-16 00:12:09 +08:00
SXP-Simon cd1cd78a75 [v4.8.8] - feat(golden_quote): 重构金句分析匹配机制，尝试解决金句头像偶尔无法显示的问题，锐评中允许解析用户进行头像渲染 2026-03-13 17:47:04 +08:00
SXP-Simon b3e11a8cf7 [v4.8.7] - feat: 语义化 Trace ID 注入与报告标签 (#103) 2026-03-12 18:26:39 +08:00
SXP-Simon fddb763a6d [v4.8.6] - feat: 新增群相册上传严格模式，增强图片发送超时处理 2026-03-12 15:24:23 +08:00
SXP-Simon 0bedb02295 [v4.8.5] - fix(OneBot): 表情统计修复和群相册兼容性增强 2026-03-10 12:37:26 +08:00
SXP-Simon 70ea0e4fba [v4.8.4] - fix(OneBot): 兼容 napcat 和 llbot 获取历史消息接口 2026-03-07 00:42:22 +08:00
SXP-Simon fb6b7934b1 [v4.8.3] - fix(OneBot): 修复 LLBot 用户仅能获取 100 条消息的问题 2026-03-06 22:51:58 +08:00
SXP-Simon f47af8cb99 [v4.8.1] - feat(traceability): 实现全链路 TraceID 追踪，增强初始化韧性与去重拦截 2026-03-06 17:37:54 +08:00
SXP-Simon 87d5cccdd4 [v4.8.0] - perf(concurrency): 实现群聊分析任务锁及全局资源并发限流控制，增强重试管理器 2026-03-03 21:24:43 +08:00
SXP-Simon 3956939837 [v4.7.15] - fix(dispatcher): 修复自动定时分析报告无法上传群相册的问题 2026-02-26 11:55:08 +08:00
SXP-Simon 417b88ffe9 fix(retry): 尝试增强重试管理器，采用 get_login_info 兜底增强获取 Bot user_id ，避免重试地狱和重复发送 2026-02-24 00:17:09 +08:00
SXP-Simon 412ac5f870 [v4.7.13] - fix(增量分析)解决增量分析传参错误导致用户称号失效的问题 2026-02-23 01:13:30 +08:00
SXP-Simon 4c65b26dab [v4.7.11] - feat(base64): 新增可选 Base64 图片传输开关，默认启用 2026-02-22 15:40:07 +08:00
SXP-Simon 626a890a58 [v4.7.9] feat(Onebot): 重构 OneBot 消息拉取逻辑，采用分页回溯策略；新增分析报告同步上传至群文件和群相册的功能 2026-02-21 19:40:54 +08:00
SXP-Simon c0213f6b6d [v4.7.7] - feat(template): retro_futurism 调整和 hack, spring_festival 模板 2026-02-12 21:49:29 +08:00
SXP-Simon b0ee9ff82f [v4.7.6] - feat: Telegram 按钮交互选择模板 (#83) 2026-02-12 19:07:53 +08:00
SXP-Simon 1fe6426138 [v4.7.5] - feat(Telegram): Telegram 平台支持 (#82 @clown145) 2026-02-12 15:56:58 +08:00