👍 赞我 [✅PASS]

插件名称： astrbot_plugin_zanwo（Akizuki 多 Bot 改编版）
QQ 名片点赞功能，支持给自己或指定群友点赞、每日自动点赞订阅，以及多 Bot 协同点赞与单一汇报。

该功能仅适用于 QQ 平台。管理员可以配置群聊白名单，使其只在指定群聊中生效。

🚀 快速开始

给自己点赞

发送：

赞我

在只有一台 Bot 的群里，Bot 会像普通插件一样直接回复点赞结果。

在有多台 Akizuki Bot 的群里，所有成功触发的 Bot 都会尝试点赞，但最终只由一台 Bot 发送汇总消息，避免多台 Bot 同时刷屏。

给别人点赞

使用 QQ 的真实 @ 提及：

赞 @某人

也可以在同一条消息中真正 @ 多位群友：

赞 @用户A @用户B

请通过 QQ 成员列表选择要 @ 的用户，不要只手动输入昵称，否则插件可能无法取得对方的 QQ 号。

⌨️ 命令速查

命令	说明
`赞我`	给当前用户的 QQ 名片点赞
`赞 @某人`	给指定群友点赞，可同时真正 @ 多人
`订阅点赞`	订阅每天自动点赞
`取消订阅点赞`	取消每日自动点赞
`订阅点赞列表`	查看当前订阅点赞的用户 ID 列表
`谁赞了bot`	以纯文本查看哪些用户赞过 Bot

群聊规则要求时，也可以在命令前 @ Bot。多 Bot 群中的重复响应会由插件自动协调，不再需要依靠手动指定某一台 Bot 来避免刷屏。

🤖 多 Bot 协同机制

单 Bot 群

同一条命令只被一台 Bot 响应时：

直接显示原来的普通点赞回复；
不发送“点赞任务汇总”；
不添加用于多 Bot 仲裁的消息表情。

多 Bot 群

同一条命令被多台 Bot 响应时：

每台 Bot 都会独立尝试执行点赞；
已完成处理的 Bot 会在原消息上留下“赞”回应；
最终负责汇报的 Bot 会留下“OK”回应；
群内只发送一条统一汇总；
其他 Bot 不再重复发送文字，也不会把该命令交给大模型继续回复。

消息表情表示的是“处理状态”，不代表每台 Bot 都一定完整送出了全部点赞。准确结果以最终汇总为准。

汇总结果说明

汇总中可能出现：

状态	含义
完整成功	当前 Bot 完整送出预期的 50 个赞
部分成功	当前 Bot 送出了 1～49 个赞，随后因限制停止
今日已赞/达到上限	今天已经赞过该用户，或对方今日可获赞次数已经达到上限
隐私权限限制	对方的 QQ 隐私设置不允许当前 Bot 点赞
平台或好友限制	受到陌生人、好友关系或 QQ 风控等限制
接口异常	QQ、NapCat 或网络接口执行异常
未完成或超时	Bot 已参与该任务，但没有在等待时间内返回结果

含义相同的失败会自动合并计数，不会把多台 Bot 的重复随机文案逐条展开。只有真正需要排查的异常才会显示具体 Bot 和原因。

示例：

点赞任务汇总
目标：2169948834
响应 Bot：11/11
完整成功：0
部分成功：1
今日已赞/达到上限：10
共送出：10 个赞

部分成功：
- 机器人QQ：10/50 个赞

🔁 每日自动点赞

订阅点赞

取消：

取消订阅点赞

订阅后，Bot 会按照插件的定时逻辑每天尝试为你点赞。

自动点赞能否成功，仍然取决于：

Bot 当时是否在线；
QQ 和 NapCat 接口是否正常；
对方的隐私权限；
Bot 与对方的好友关系；
QQ 当日点赞额度。

本次多 Bot 改编主要调整即时点赞、结果汇总和配置持久化；订阅点赞继续沿用原插件逻辑。

👥 群聊白名单

管理员可以在插件配置中设置允许使用该功能的群号。

白名单为空：所有群均可使用；
白名单非空：只有名单中的群可以使用；
私聊不受群聊白名单限制。

不在白名单中的群发送点赞命令时，插件不会执行点赞。

📏 QQ 点赞限制

当前插件每次会尝试分批发送点赞，单台 Bot 对单个目标的预期上限为 50 个赞。

实际结果仍以 QQ 接口返回为准。常见情况包括：

完整送出 50 个赞；
只送出部分点赞后达到上限；
当天已经赞过该用户；
对方当天获得的赞已经达到上限；
陌生人点赞权限被关闭；
Bot 当日给非好友点赞的人数达到限制。

QQ 平台规则可能调整，因此文档中的数量不应视为长期不变的官方承诺。

⚠️ 使用注意

仅支持 QQ。
请使用真实 QQ @ 提及目标用户。
达到当日限制后，需要等待次日重置。
不要频繁重复发送命令，以免触发 QQ 风控。
多 Bot 群中看到多个消息表情属于正常现象，文字汇报只会发送一次。
“赞”回应表示该 Bot 已完成处理，不等同于完整成功 50 个赞。
“OK”回应表示该 Bot 取得了本次最终汇报权。
管理员可以通过群聊白名单限制使用范围。

❓ 常见问题

Q：为什么只有一个 Bot 发消息，但原消息上有很多 Bot 的回应？

多 Bot 群采用“全员执行、单一汇报”的方式。所有参与 Bot 都可以执行点赞并留下完成回应，但只选出一台 Bot 发送汇总，避免刷屏。

Q：为什么显示“部分成功”？

说明该 Bot 已经成功送出了一部分点赞，但在达到 50 个之前遇到了今日上限、平台限制或其他接口拒绝。

Q：为什么很多 Bot 的失败被合并成一个数字？

多台 Bot 返回的文案可能不同，但实际原因相同。例如“今天已经赞过”“点赞次数达到上限”“明天再来”都会归类为“今日已赞/达到上限”。

Q：为什么单 Bot 群没有汇总和表情？

同一条命令只检测到一台 Bot 时，插件会自动保持普通回复模式，不进行没有必要的多 Bot 仲裁。

Q：为什么点赞失败？

常见原因：

对方关闭了陌生人点赞权限；
Bot 今天已经赞过对方；
Bot 当日点赞额度已满；
对方当天获得的赞已经达到上限；
Bot 与对方不是好友；
当前群不在管理员白名单中；
QQ、NapCat 或网络接口发生异常。

Q：为什么订阅了却没有每天收到赞？

可能是 Bot 在定时任务执行时离线、QQ 接口失败、隐私权限受限，或当天点赞额度已经达到上限。

Q：怎样一次给多个人点赞？

在同一条消息中使用真实 QQ 提及：

赞 @用户A @用户B

📎 项目信息

显示名称：赞我
使用版本：Akizuki 多 Bot 改编版
改编自：astrbot_plugin_zanwo

本页面说明的是 Akizuki Bots Cluster 当前部署的改编版本，其行为可能与原插件仓库中的版本不同。

👍 QQ名片赞