GroupSign - 群自动打卡插件

一个用于 NcatBot 的自动群打卡插件，支持每日定时在指定 QQ 群进行自动打卡。

📋 功能特性

• ✅ 自动打卡：每天 0 点自动执行群打卡任务
• ✅ 多群支持：支持同时管理多个群组的打卡
• ✅ 随机延迟：打卡时添加 0.1-0.8 秒的随机延迟，更加自然
• ✅ 灵活管理：通过命令动态添加、移除、查看打卡群列表
• ✅ 权限控制：所有管理命令需要管理员权限
• ✅ 异步调度：使用异步机制，不会阻塞其他任务

📦 安装

1. 确保已安装 NcatBot
2. 将本插件放置到 NcatBot 的插件目录./plugins中
3. 重启 NcatBot 或重载插件

# 克隆插件到插件目录
cd /path/to/ncatbot/plugins
git clone https://github.com/GEYUANwuqi/ncatbot.plugin.GroupSign.git

⚙️ 配置

插件会自动创建配置项，主要配置项如下：

配置项	类型	默认值	说明
group_list	list[str]	[""]	需要自动打卡的群号列表

配置文件会自动保存在 NcatBot 的配置目录中。

🚀 使用方法

添加打卡群组

/sign_add <群号>

示例：

/sign_add 123456789

移除打卡群组

/sign_remove <群号>
# 或使用别名
/sign_rm <群号>

示例：

/sign_remove 123456789

查看打卡列表

/sign_list

清空打卡列表

/sign_clear

📝 命令列表

命令	别名	参数	权限	说明
sign_add	-	<群号>	管理员	添加群组到打卡列表
sign_remove	sign_rm	<群号>	管理员	从打卡列表中移除群组
sign_clear	-	-	管理员	清空打卡列表
sign_list	-	-	管理员	查看当前打卡列表

🔧 工作原理

1. 定时调度：插件启动时会创建一个守护线程，运行异步调度循环
2. 时间计算：每次执行后自动计算距离下一个 0 点的时间
3. 异步等待：使用 asyncio.sleep() 等待到指定时间
4. 执行打卡：到达指定时间后，遍历配置的群列表依次执行打卡
5. 随机延迟：每次打卡前添加随机延迟，避免被检测（其实是给真人打卡留空隙）

⚠️ 注意事项

1. 权限要求：所有管理命令都需要管理员权限才能执行
2. 自动启动：插件加载后会自动启动定时任务，无需手动触发
3. 守护线程：调度器运行在守护线程中，插件卸载时会自动停止

🐛 故障排除

插件无法加载

• 检查 NcatBot 版本和Napcat 版本是否兼容
• 检查插件路径是否正确

命令无响应

• 确认是否具有管理员权限
• 检查命令格式是否正确

📜 更新日志

v2.0.0

• 初始版本发布
• 支持自动定时打卡
• 支持多群管理
• 添加随机延迟功能

👨‍💻 开发者

• 作者：物起
• 版本：2.0.0

📄 许可证

本项目采用 MIT 许可证，详见 LICENSE 文件。

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📧 联系方式

如有问题或建议，请通过以下方式联系：

• 提交 Issue
• 发送邮件至：yzd627350525@gmail.com

---

⭐ 如果这个插件对你有帮助，请给个 Star 支持一下！