womsxd/mihoyo-bbs

MihoyoBBSTools 介绍

概述

MihoyoBBSTools 是一个针对米哈游社区（如原神、崩坏：星穹铁道等游戏官方论坛）的辅助工具，主要帮用户自动化处理社区日常操作，减少手动重复工作。适合经常使用米哈游社区、需要定期完成签到、查看消息或管理互动的用户。

主要功能

• 自动签到：支持多游戏板块自动签到（如原神、星穹铁道、崩坏3等），无需手动点击，自动完成每日签到任务。
• 消息提醒与汇总：实时监测社区私信、@提及和回复通知，自动整理成简洁日志，避免错过重要消息。
• 帖子互动辅助：可配置自动点赞关注的帖子、回复常用内容（需手动开启并设置模板），简化互动流程。
• 数据统计：记录签到天数、互动次数等数据，生成简单统计报告（如“本月已连续签到25天”）。

安装步骤

环境要求

• 操作系统：Windows/macOS/Linux
• 依赖：Python 3.8 及以上，Git（用于拉取代码）

具体步骤

1. 克隆代码仓库
   打开终端（命令行），运行以下命令下载工具源码：

   bash
   git clone []   cd MihoyoBBSTools
   

2. 安装依赖包
   安装运行所需的 Python 依赖：

   bash
   pip install -r requirements.txt
   

3. 配置文件设置

   • 进入 config 文件夹，复制 config.example.json 并重命名为 config.json（这是主要配置文件）。
   • 用文本编辑器打开 config.json，按提示填写信息：
     • account：米哈游账号（建议用手机号，支持验证码登录配置）；
     • functions：开启/关闭功能（如 "auto_sign": true 启用自动签到）；
     • settings：调整细节（如签到时间、消息提醒频率）。

使用方法

1. 启动工具
   在终端运行主程序：

   bash
   python main.py
   

   首次运行会提示验证账号（按指引完成登录，登录信息仅本地保存）。

2. 功能执行
   工具会按 config.json 中的设置自动执行任务（如签到、消息检查），过程日志会实时显示在终端。

3. 自定义运行
   如需指定配置文件或调整运行模式，可添加参数：

   bash
   python main.py --config ./my_config.json  # 使用自定义配置文件
   python main.py --debug  # 开启调试模式，输出详细日志
   

注意事项

• 账号安全：config.json 包含登录相关信息，切勿分享给他人或上传至公共平台。
• 使用频率：避免短时间内频繁运行（建议间隔 ≥ 1小时），防止触发社区反爬限制。
• 版本更新：社区接口可能变动，建议每周用 git pull 拉取最新代码，确保功能正常。
• 免责声明：这是非官方工具，使用时需自行承担账号风险，建议仅用于个人学习和日常辅助。

问题反馈

如果遇到功能失效或bug，可在 GitHub 仓库的 Issues 区提交问题，附上运行日志和配置文件（隐去敏感信息），方便开发者排查。