🌟 Yunzai-Bot 校友帮签到插件 🌟

让校友帮签到变得简单而智能

📚 目录

• 项目说明
• 主要功能
• 安装方法
• 使用指南
  • 基础命令
  • 进阶功能
  • 位置与设备设置
  • 图片签到功能
  • 周志提交功能
  • 功能详解
• 网页管理面板
• 配置说明
• 常见问题
• 注意事项
• 更新日志
• 开发计划
• 问题反馈
• 致谢
• 许可证

📋 项目说明

本项目是基于 Yunzai-Bot 开发的校友帮自动签到插件，为校友帮平台用户提供便捷的自动化签到解决方案。支持多用户管理、自定义签到时间、自动签到、重新签到、周志自动提交等丰富功能，让您的校园生活更加轻松。

声明：本项目仅供学习交流使用，请勿用于商业用途。使用本项目产生的任何后果由使用者自行承担。

💡 为什么选择本插件？

• 全自动化：一次配置，永久省心
• 功能丰富：覆盖校友帮平台所有常用功能
• 简单易用：无需编程知识，命令式操作
• 安全可靠：本地存储账号信息，保障隐私安全
• 持续更新：定期维护，不断优化功能体验

✨ 主要功能

✨ 多用户管理：支持多个用户同时使用 ⏰ 自定义签到：可自定义每日签到时间 🤖 自动签到：支持定时自动签到（可开关） 🔄 重新签到：支持重新签到功能（可开关） 📊 状态查询：随时查看签到配置状态

📝 结果通知：签到结果实时通知 📸 图片签到：支持自定义签到图片 📔 周志提交：支持自动提交周志 ⚡ 简单配置：命令式操作，无需修改配置文件 🌍 位置模拟：支持自定义签到位置

🔧 安装方法

前置条件

• 已安装 Yunzai-Bot v3.0+
• Node.js 14.0+ 环境

安装步骤

方法一：使用 Git 安装（推荐）

1. 进入 Yunzai-Bot 根目录

cd Yunzai-Bot

2. 克隆本项目到 plugins 目录

git clone https://github.com/your-username/Xyb_plugin.git ./plugins/Xyb_plugin/

3. 安装依赖

pnpm install

4. 重启 Yunzai-Bot

pnpm restart

方法二：手动下载安装

1. 下载本项目的 zip 文件
2. 解压到 Yunzai-Bot/plugins/ 目录下
3. 进入 Yunzai-Bot 根目录

cd Yunzai-Bot

4. 安装依赖

pnpm install

5. 重启 Yunzai-Bot

pnpm restart

安装验证

安装完成后，可以通过发送 #xyb帮助 命令来验证插件是否安装成功。如果收到帮助信息，则表示安装成功。

📖 使用指南

基础命令

命令	说明	示例
#xyb绑定	绑定校友帮账号	#xyb绑定 账号 密码
#xyb签到	手动签到	#xyb签到
#xyb签退	手动签退	#xyb签退
#xyb状态	查看当前状态	#xyb状态
#xyb帮助	查看帮助信息	#xyb帮助

进阶功能

命令	说明	示例
#xyb设置签到时间	设置自动签到时间	#xyb设置签到时间 8:30
#xyb设置签退时间	设置自动签退时间	#xyb设置签退时间 17:30
#xyb自动签到 开启/关闭	开启/关闭自动签到	#xyb自动签到 开启
#xyb自动签退 开启/关闭	开启/关闭自动签退	#xyb自动签退 开启
#xyb自动签到状态	查看自动签到状态	#xyb自动签到状态

位置与设备设置

命令	说明	示例
#xyb设置签到位置	设置签到位置（经纬度坐标）	#xyb设置签到位置 116.397128,39.916527
#xyb设置设备名称	设置签到设备名称	#xyb设置设备名称 MI 10
#xyb自动获取位置 开启/关闭	开启/关闭自动获取位置	#xyb自动获取位置 开启
#xyb查看位置	查看当前设置的位置	#xyb查看位置
#xyb测试位置	测试当前位置是否有效	#xyb测试位置

图片签到功能

命令	说明	示例
#xyb拍照签到 开启/关闭	开启/关闭拍照签到功能	#xyb拍照签到 开启
#xyb设置签到图片	设置签到图片路径	#xyb设置签到图片 /api/files/138
#xyb设置签退图片	设置签退图片路径	#xyb设置签退图片 /api/files/138
#xyb查看签到图片	查看当前设置的签到图片	#xyb查看签到图片
#xyb上传签到图片	上传签到图片（回复图片）	#xyb上传签到图片
#xyb上传签退图片	上传签退图片（回复图片）	#xyb上传签退图片

周志提交功能

命令	说明	示例
#xyb自动周志 开启/关闭	开启/关闭自动周志提交	#xyb自动周志 开启
#xyb设置周志提交日	设置周志自动提交的星期几	#xyb设置周志提交日 5
#xyb提交周志	手动提交周志(使用默认内容)	#xyb提交周志

🌐 网页管理面板

除了通过聊天机器人命令管理插件外，我们还提供了一个现代化的网页管理界面，让您可以更直观地管理校友帮插件。

✨ 网页面板功能

功能模块	功能说明	特色
📊 仪表盘	实时显示用户统计、签到状态、系统概览	数据可视化、实时更新
👥 用户管理	查看所有用户信息、搜索筛选、导出数据	批量管理、数据导出
⚙️ 全局配置	设置默认位置、设备名称、签到时间等	可视化配置、即时生效
📅 签到设置	配置自动签到、周志提交等高级功能	开关控制、时间设置
📝 日志查看	查看系统日志、错误信息、操作记录	实时日志、级别筛选

🚀 启动网页面板

方法一：使用启动脚本（推荐）

Windows用户：

# 双击运行
start-web.bat

# 或命令行运行
.\start-web.bat

Linux/Mac用户：

# 添加执行权限（首次运行）
chmod +x start-web.sh

# 运行脚本
./start-web.sh

方法二：手动启动

# 安装依赖（如果未安装）
npm install

# 启动服务器
npm run web

# 或直接运行
node web/server.js

🌍 访问管理面板

启动成功后，打开浏览器访问：

http://localhost:3000

📱 界面预览

现代化响应式设计，支持桌面端和移动端

🔧 技术特性

• 🎨 现代化UI：渐变色彩、流畅动画、直观图标
• 📱 响应式设计：完美适配各种屏幕尺寸
• ⚡ 实时数据：自动刷新、动态加载
• 🔒 数据安全：本地存储、无外部依赖
• 🛠️ 易于使用：直观操作、即时反馈

📋 使用说明

1. 查看仪表盘：了解系统整体状态和用户统计
2. 管理用户：查看用户列表、搜索特定用户、导出数据
3. 配置设置：可视化配置各种参数，即时生效
4. 查看日志：实时监控系统运行状态和错误信息

🔍 API测试

我们还提供了一个API测试页面，方便开发者调试：

http://localhost:3000/test.html

📖 详细文档

更多详细信息请查看：web/README.md