5分钟搞定米游社自动签到：手把手教你配置MihoyoBBSTools

【免费下载链接】MihoyoBBSToolsWomsxd/AutoMihoyoBBS，米游社相关脚本项目地址: https://gitcode.com/gh_mirrors/mi/MihoyoBBSTools

米游社自动签到工具MihoyoBBSTools是一款强大的Python自动化脚本，能够帮助你自动完成米游社社区签到、游戏签到、获取米游币等日常任务。无论你是原神、崩坏：星穹铁道还是绝区零的玩家，这个工具都能为你节省大量重复操作时间，让你专注于游戏本身。本文将为你提供完整的配置指南，让你在5分钟内快速上手这个实用的自动化工具。

🚀 快速入门：从零开始配置

第一步：项目部署与环境搭建

首先，你需要获取项目代码并完成基础环境配置：

# 克隆项目到本地 git clone https://gitcode.com/gh_mirrors/mi/MihoyoBBSTools # 进入项目目录 cd MihoyoBBSTools # 安装Python依赖 pip install -r requirements.txt

第二步：配置文件初始化

进入config目录，复制配置文件模板：

# 复制配置文件模板 cp config/config.yaml.example config/config.yaml

现在打开 config/config.yaml 文件，你会看到完整的配置结构。这是整个工具的核心配置文件，所有功能都通过这里进行控制。

🔧 核心配置详解：账号认证与游戏选择

账号认证配置

在配置文件中，account部分是最关键的，它决定了工具如何访问你的米游社账号：

account: cookie: "" # 可选，脚本会自动生成 stuid: "123456789" # 必须，你的米游社用户ID stoken: "v2_xxx" # 必须，核心认证令牌 mid: "abcdef1234" # 仅v2_stoken需要，设备指纹标识

配置要点：

• stuid：你的米游社用户ID，纯数字格式
• stoken：认证令牌，通常以v2_开头
• mid：如果你的stoken是v2版本，必须填写此参数

游戏签到配置

在games部分，你可以选择要自动签到的游戏：

games: cn: enable: true genshin: checkin: true # 原神签到 black_list: [] # 黑名单账号 honkai_sr: checkin: true # 崩坏：星穹铁道签到 black_list: [] zzz: checkin: true # 绝区零签到 black_list: []

📱 三种Cookie获取方法对比

为了让你快速获取所需的认证信息，这里提供了三种方法的对比：

方法一：手机抓包（推荐）

这是最可靠的方法，适合有一定技术基础的用户：

1. 安装HttpCanary（Android）或Stream（iOS）
2. 配置SSL证书并信任
3. 登录米游社APP
4. 筛选包含getTokenBySToken的请求
5. 从响应中提取stoken和stuid值

方法二：浏览器控制台

如果你习惯使用网页版米游社：

1. 登录米游社官网
2. 按F12打开开发者工具
3. 在Console标签页输入：

document.cookie.split(';').filter(c => c.includes('stoken') || c.includes('stuid'))

方法三：使用社区工具

一些社区开发者提供了专门的工具，可以简化操作流程。这些工具通常有更友好的界面，适合不想折腾的用户。

⚙️ 高级配置与个性化设置

社区功能配置

除了游戏签到，MihoyoBBSTools还支持米游社社区功能：

mihoyobbs: enable: true checkin: true # 社区签到 checkin_list: [5, 2] # 签到社区ID read: true # 自动看帖 like: true # 点赞帖子 cancel_like: true # 取消点赞 share: true # 分享帖子

社区ID对应关系：

• 1：崩坏3
• 2：原神
• 3：崩坏学园2
• 4：未定事件簿
• 5：大别墅
• 6：崩坏：星穹铁道
• 8：绝区零

多账号管理

如果你有多个米游社账号，可以创建多个配置文件：

config/ ├── account_1.yaml # 第一个账号 ├── account_2.yaml # 第二个账号 └── account_3.yaml # 第三个账号

脚本会自动扫描config目录下所有.yaml文件并依次执行，实现多账号批量管理。

🛠️ 常见问题解决方案

问题1：stoken缺失或错误

症状：脚本提示"无Stoken请手动填入stoken！"

解决方法：

1. 检查config.yaml文件中stoken字段是否为空
2. 确保stoken值被正确引号包围
3. 重新获取stoken并更新配置
4. 如果是v2_stoken，确保同时填写了mid参数

问题2：配置文件格式错误

症状：脚本无法启动或报YAML解析错误

解决方法：

1. 使用YAML格式检查工具验证配置文件
2. 确保所有缩进使用空格而非制表符
3. 检查冒号后是否有空格
4. 参考 config/config.yaml.example 检查格式

问题3：签到失败

症状：某个游戏签到失败但其他正常

解决方法：

1. 检查该游戏的checkin设置是否为true
2. 确认账号是否在黑名单中
3. 查看日志文件获取详细错误信息
4. 尝试单独运行该游戏的签到模块

🔄 自动化部署与监控

定时任务设置

为了让签到完全自动化，可以设置定时任务：

# Linux/Mac使用crontab # 每天凌晨3点执行签到 0 3 * * * cd /path/to/MihoyoBBSTools && python3 main.py # Windows使用任务计划程序 # 创建每日任务执行python main.py

日志监控与分析

脚本运行时会生成详细的日志，帮助你排查问题：

# 查看最新日志 tail -f logs/mihoyo.log # 搜索错误信息 grep -i "error\|fail" logs/mihoyo.log # 查看签到成功记录 grep -i "success\|完成" logs/mihoyo.log

📊 配置检查清单

完成配置后，使用以下清单验证你的设置：

• 项目已成功克隆到本地
• Python依赖已安装完成
• config.yaml文件已正确创建
• stuid和stoken已正确填写
• 如果是v2_stoken，mid参数已填写
• 需要签到的游戏已启用
• 社区功能按需配置
• 配置文件格式正确（YAML格式）

测试配置是否正确

配置完成后，使用以下命令验证：

# 测试登录功能 python3 login.py --test # 运行完整签到流程 python3 main.py

如果一切正常，你应该能看到类似以下的输出：

[INFO] 开始执行米游社自动签到 [INFO] 成功登录账号：123456789 [INFO] 原神签到成功：获得原石×10 [INFO] 星穹铁道签到成功：获得星琼×5 [INFO] 米游社社区签到完成

💡 最佳实践与维护技巧

定期维护建议

1. 定期更新stoken：建议每25-28天手动更新一次stoken，避免签到中断
2. 备份配置文件：修改配置文件前，先创建备份
3. 监控运行状态：设置简单的监控脚本，在签到失败时发送通知
4. 关注项目更新：定期查看项目更新，获取新功能和修复

性能优化技巧

• 对于多账号用户，建议错开执行时间，避免同时请求导致API限制
• 如果遇到网络问题，可以调整重试次数和间隔时间
• 使用Docker部署可以获得更好的环境隔离和稳定性

安全注意事项

• 不要将配置文件上传到公开仓库
• 定期检查脚本运行日志，确保没有异常
• 如果不再使用，及时删除配置文件中的敏感信息

🎯 开始你的自动化之旅

现在你已经掌握了MihoyoBBSTools的全部配置技巧。记住几个关键点：

1. 认证信息是关键：正确的stoken和stuid是自动签到的基础
2. 配置要细心：YAML格式对缩进敏感，注意检查格式
3. 定期维护：stoken有有效期，需要定期更新
4. 多账号支持：通过多个配置文件轻松管理多个账号

按照本文的步骤操作，你可以在5分钟内完成全部配置，让米游社自动签到工具稳定运行。如果在配置过程中遇到问题，可以查看项目中的 config/README.md 文件获取更多帮助信息。

最后提醒：请合理使用自动化工具，遵守米游社用户协议，不要滥用API接口，以免影响账号安全。祝你游戏愉快，签到顺利！

【免费下载链接】MihoyoBBSToolsWomsxd/AutoMihoyoBBS，米游社相关脚本项目地址: https://gitcode.com/gh_mirrors/mi/MihoyoBBSTools