NapCat 戳一戳插件 v1.0.0

适配说明：本分支基于原项目 acpoke_plugin 适配新版 MaiBot SDK。

原作者：何夕

本分支仓库：acpoke_plugin_new

---

功能说明

• 支持在群聊/私聊中对目标用户执行"戳一戳"。
• 支持通过用户昵称（person_api）或直接 QQ 号定位目标。
• 内置同一目标冷却，避免短时间内重复戳同一个人。

说明：插件通过 SEND_POKE 命令交由 Adapter 执行，是否需要额外配置取决于你使用的 Adapter 实现。

---

快速开始

1. 安装 SDK：pip install maibot-plugin-sdk
2. 将 acpoke_plugin 放入 MaiBot 插件目录（plugins/ 文件夹）。
3. 启动 MaiBot，插件会自动加载。

---

插件配置

配置文件：acpoke_plugin/config.toml

poke 配置项

• command_name：Adapter 命令名，默认 SEND_POKE（一般无需修改）。
• cooldown_seconds：同一目标冷却时间（秒），默认 300。
• debug：是否开启调试日志，默认 false。

---

使用建议

• 强烈建议在更新插件前备份当前插件文件，以免意外丢失。
• 若你使用的 Adapter 对 SEND_POKE 的参数名不同，可优先修改 command_name，或在日志中观察 Adapter 的报错信息。
• 觉得好用的话，就给原项目 acpoke_plugin 点个 star 吧~

---

更新日志

版本 1.0.0

• 适配新版 MaiBot SDK（maibot-plugin-sdk）
• 使用 @Tool 装饰器替代旧版 @Action
• 使用 PluginConfigBase 定义强类型配置
• 实现三个必需的生命周期方法：on_load()、on_unload()、on_config_update()
• 添加 create_plugin() 工厂函数
• 使用 self.ctx 能力代理替代旧 API

版本 0.5.1

• 适配新版 MaiBot：移除旧版 LLM_JUDGE/llm_judge 相关字段，避免加载失败
• SEND_POKE 发送逻辑增强：检查返回值并做参数兼容尝试
• 增加配置项：command_name / cooldown_seconds / debug

版本 0.5.0

• 重构插件，让戳一戳信息走adapter，做到了即装即用

版本 0.4.3

• 适配 maibot0.11

版本 0.4.2

• 修复了bot无法知道自己戳过的问题
• 修复了戳一戳私聊报错的问题
• 感谢Neorestim提供的支持

版本 0.4.1

• 修复了0.10.1里无法获取group id的问题
• 修改了manifest.json文件

版本 0.4.0

• 重构了group id获取的方式，可以在所有群里执行戳一戳

版本 0.3.4

• 修改 API 格式，支持 Maimai 0.9.1 版本

版本 0.3.3

• 修改 API 格式，支持 Maimai 0.8.1 版本
• 添加 manifest.json 文件支持

版本 0.1.0

• 构建代码框架
• 分离私聊戳戳和群聊戳戳的请求
• 使用 HTTP 直接与 NapCat 对接
• 强制启用 DEBUG 模式

---

致谢

• 原项目作者：何夕
• 原项目地址：acpoke_plugin