5步掌握MihoyoBBSTools核心配置从stoken认证到自动化签到完整指南【免费下载链接】MihoyoBBSToolsWomsxd/AutoMihoyoBBS米游社相关脚本项目地址: https://gitcode.com/gh_mirrors/mi/MihoyoBBSToolsMihoyoBBSTools是一个基于Python3开发的米游社自动化签到工具通过stoken认证机制实现米游币自动获取、游戏签到、社区任务等功能的完整解决方案。该工具支持国服和国际服的崩坏学院2、崩坏3、未定事件簿、原神、崩坏星穹铁道、绝区零等游戏签到提供Docker、Kubernetes、青龙面板等多种部署方式帮助用户实现高效稳定的自动化签到流程。核心概念解析stoken认证机制与配置参数stoken认证体系详解stokenSession Token是米游社API认证体系中的核心凭证承担着用户身份验证与会话维持的双重职责。在MihoyoBBSTools项目中stoken通过加密Cookie形式存储用于访问高权限接口。认证参数作用说明获取方式配置必要性stoken核心会话令牌手机抓包或网页控制台提取必须stuid用户唯一标识从Cookie中提取必须mid设备指纹关联v2_stoken必需参数条件必需cookie完整认证Cookie浏览器开发者工具获取推荐配置文件结构解析项目的配置文件采用YAML格式位于config/config.yaml.example主要包含以下核心模块# 基础配置部分 enable: true # 控制整个配置文件是否启用 version: 15 # 配置文件版本号 push: # 推送通知配置 # 账户认证部分 account: cookie: # 完整Cookie可自动从stoken生成 stuid: 123456789 # 用户唯一标识 stoken: v2_xxx # 核心会话凭证 mid: abcdef1234 # v2_stoken必填参数 # 游戏签到配置 games: cn: enable: true # 国服签到开关 genshin: checkin: true # 原神签到开关 black_list: [] # 不签到的账号列表实战配置步骤从零搭建自动化签到系统第一步环境准备与项目部署首先克隆项目仓库到本地git clone https://gitcode.com/gh_mirrors/mi/MihoyoBBSTools cd MihoyoBBSTools pip install -r requirements.txt项目依赖主要包含httpx、PyYAML等第三方库确保Python版本在3.7以上。第二步配置文件初始化复制示例配置文件并重命名cp config/config.yaml.example config/config.yaml对于多用户场景可以创建多个配置文件cp config/config.yaml.example config/user1.yaml cp config/config.yaml.example config/user2.yaml脚本会自动扫描config目录下所有以.yaml为扩展名的文件并按名称顺序依次执行。第三步stoken获取与配置方法一浏览器开发者工具获取推荐打开浏览器无痕/隐身模式访问米游社官网https://www.miyoushe.com/ys/并登录按F12打开开发者工具切换到Network网络标签在Filter筛选器中输入getUserGameUnreadCount点击捕获到的请求在Headers中找到Cookie字段复制完整的Cookie内容方法二控制台快捷提取在米游社网页版控制台中执行以下JavaScript代码var cookies document.cookie.split(;).filter(c c.includes(stoken) || c.includes(stuid) || c.includes(mid) ); console.log(cookies.join(;));方法三v2_stoken特殊处理当stoken以v2_开头时必须同时配置mid参数。mid值通常以account_mid_v2开头可从Cookie中提取。第四步配置文件详细设置打开config.yaml文件按照以下示例配置关键参数account: cookie: login_ticketxxx;stokenxxx;stuidxxx;midxxx stuid: 123456789 stoken: v2_xxxxxxxxxxxxxxxx mid: account_mid_v2_xxxxxxxx mihoyobbs: enable: true checkin: true checkin_list: [5, 2] # 社区ID列表 games: cn: enable: true genshin: checkin: true black_list: [] honkai_sr: checkin: true black_list: []第五步运行测试与验证执行单用户测试python main.py执行多用户测试python main_multi.py查看运行日志确认签到任务执行成功。高级功能详解多环境部署与自动化运维Docker容器化部署项目提供完整的Docker支持适合需要长期稳定运行的场景# 构建并启动容器 docker-compose up -d # 查看运行日志 docker-compose logs -f # 修改定时任务时间默认每天9:30运行 # 编辑docker-compose.yml中的CRON_SIGNIN参数Docker部署的优势在于环境隔离和自动重启确保签到任务不会因系统重启而中断。Kubernetes集群部署对于需要高可用性的生产环境可以使用Kubernetes部署# 创建配置文件 cp config/config.yaml.example kube/config.yaml # 创建ConfigMap并启动服务 kubectl create cm mihoyo-conf --from-file config.yaml kubectl apply -f kube/deployment.yaml # 查看运行状态 kubectl get pods -l appmihoyo kubectl logs pod-name -f青龙面板集成青龙面板用户可以通过以下步骤快速集成拉取仓库ql repo https://github.com/Womsxd/MihoyoBBSTools.git ql_main.py error|mihoyo|log|push|req|set|tools|con|acc|captcha|main|gamecheckin|hoyo_checkin|competition|cloudgames|os_cloudgames|web_activity配置环境变量AutoMihoyoBBS_config_path: /ql/data/config/ AutoMihoyoBBS_config_multi: 1 # 多用户模式 AutoMihoyoBBS_config_prefix: mhy_ # 配置文件前缀复制配置文件cp /ql/data/repo/Womsxd_MihoyoBBSTools/config/config.yaml.example /ql/data/config/mhy_config1.yamlNix Home Manager集成对于使用Nix系统的用户可以通过Home Manager配置Systemd用户服务services.mihoyo-bbs-tools { enable true; settings.config { enable true; account { cookie 你的Cookie; stuid ; stoken ; mid ; }; mihoyobbs.enable false; }; onCalendar 04:00; # 每天4点运行 };常见问题排查指南stoken认证异常解决方案问题排查流程图开始 ├─ 检查配置文件格式 → YAML语法错误 → 修复语法 ├─ 验证stoken有效性 → stoken过期 → 重新获取 ├─ 检查mid参数 → v2_stoken缺少mid → 补充mid值 ├─ 测试网络连接 → 网络异常 → 检查代理设置 ├─ 查看运行日志 → 具体错误信息 → 针对性解决 └─ 成功运行 → 完成常见错误及解决方案错误1stoken缺失或无效症状无 Stoken 请手动填入 stoken或stoken 已失效请重新抓取 cookie解决方案清除本地Cookie缓存重新登录米游社获取新的stoken更新配置文件中的stoken值错误2v2_stoken缺少mid参数症状服务器返回认证失败日志显示缺少必要参数解决方案account: stoken: v2_xxxxxxxxxxxxxxxx mid: account_mid_v2_xxxxxxxx # 必须添加此参数错误3Cookie过期症状{retcode:-100,message:登录信息已过期}解决方案# 自动刷新机制示例 def refresh_cookie(): new_token get_cookie_token_by_stoken() config.config[account][cookie] new_token config.save_config()错误4多用户配置冲突症状多用户运行时只有一个账号生效解决方案确保每个配置文件有唯一名称检查配置文件路径设置确认多用户模式已启用AutoMihoyoBBS_config_multi1日志分析与调试技巧启用详细日志输出查看具体错误信息# 增加日志级别 python main.py --verbose # 查看特定模块日志 python main.py --log-level DEBUG关键日志信息包括Stoken验证成功认证通过开始执行签到任务任务启动签到成功任务完成错误代码: -100认证过期最佳实践与性能优化策略定时任务配置优化根据实际需求调整执行频率避免频繁请求# Docker定时配置每天9:30执行有1200秒随机延时 CRON_SIGNIN: 30 9 * * * # 系统crontab配置每天凌晨3点执行 0 3 * * * cd /path/to/MihoyoBBSTools python3 main_multi.py autorun多账号管理策略对于需要管理多个账号的用户建议采用以下目录结构config/ ├── user1.yaml # 账号1配置 ├── user2.yaml # 账号2配置 ├── user3.yaml # 账号3配置 └── common.yaml # 通用配置如有错误重试机制配置在配置文件中调整重试参数提高任务成功率games: cn: retries: 3 # 重试次数 useragent: Mozilla/5.0 (Linux; Android 12; Unspecified Device) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/103.0.5060.129 Mobile Safari/537.36监控与告警设置结合推送功能实现任务状态监控push: wecom # 支持企业微信、Server酱等推送方式配置推送后系统会在以下情况发送通知签到任务开始执行签到任务成功完成遇到错误需要人工干预定期运行状态报告性能优化建议资源占用优化使用Docker资源限制避免过度占用系统资源调整Python垃圾回收参数合理设置超时时间避免长时间等待网络请求优化使用连接池复用HTTP连接合理设置请求超时时间启用请求压缩减少数据传输量存储优化定期清理日志文件使用轻量级数据库存储运行状态配置日志轮转避免磁盘空间不足通过以上配置和优化MihoyoBBSTools可以实现稳定可靠的自动化签到服务大幅提升用户体验和任务完成率。无论是个人用户还是多账号管理都能找到合适的部署方案和配置策略。【免费下载链接】MihoyoBBSToolsWomsxd/AutoMihoyoBBS米游社相关脚本项目地址: https://gitcode.com/gh_mirrors/mi/MihoyoBBSTools创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
5步掌握MihoyoBBSTools核心配置：从stoken认证到自动化签到完整指南
发布时间：2026/5/28 18:02:47
5步掌握MihoyoBBSTools核心配置从stoken认证到自动化签到完整指南【免费下载链接】MihoyoBBSToolsWomsxd/AutoMihoyoBBS米游社相关脚本项目地址: https://gitcode.com/gh_mirrors/mi/MihoyoBBSToolsMihoyoBBSTools是一个基于Python3开发的米游社自动化签到工具通过stoken认证机制实现米游币自动获取、游戏签到、社区任务等功能的完整解决方案。该工具支持国服和国际服的崩坏学院2、崩坏3、未定事件簿、原神、崩坏星穹铁道、绝区零等游戏签到提供Docker、Kubernetes、青龙面板等多种部署方式帮助用户实现高效稳定的自动化签到流程。核心概念解析stoken认证机制与配置参数stoken认证体系详解stokenSession Token是米游社API认证体系中的核心凭证承担着用户身份验证与会话维持的双重职责。在MihoyoBBSTools项目中stoken通过加密Cookie形式存储用于访问高权限接口。认证参数作用说明获取方式配置必要性stoken核心会话令牌手机抓包或网页控制台提取必须stuid用户唯一标识从Cookie中提取必须mid设备指纹关联v2_stoken必需参数条件必需cookie完整认证Cookie浏览器开发者工具获取推荐配置文件结构解析项目的配置文件采用YAML格式位于config/config.yaml.example主要包含以下核心模块# 基础配置部分 enable: true # 控制整个配置文件是否启用 version: 15 # 配置文件版本号 push: # 推送通知配置 # 账户认证部分 account: cookie: # 完整Cookie可自动从stoken生成 stuid: 123456789 # 用户唯一标识 stoken: v2_xxx # 核心会话凭证 mid: abcdef1234 # v2_stoken必填参数 # 游戏签到配置 games: cn: enable: true # 国服签到开关 genshin: checkin: true # 原神签到开关 black_list: [] # 不签到的账号列表实战配置步骤从零搭建自动化签到系统第一步环境准备与项目部署首先克隆项目仓库到本地git clone https://gitcode.com/gh_mirrors/mi/MihoyoBBSTools cd MihoyoBBSTools pip install -r requirements.txt项目依赖主要包含httpx、PyYAML等第三方库确保Python版本在3.7以上。第二步配置文件初始化复制示例配置文件并重命名cp config/config.yaml.example config/config.yaml对于多用户场景可以创建多个配置文件cp config/config.yaml.example config/user1.yaml cp config/config.yaml.example config/user2.yaml脚本会自动扫描config目录下所有以.yaml为扩展名的文件并按名称顺序依次执行。第三步stoken获取与配置方法一浏览器开发者工具获取推荐打开浏览器无痕/隐身模式访问米游社官网https://www.miyoushe.com/ys/并登录按F12打开开发者工具切换到Network网络标签在Filter筛选器中输入getUserGameUnreadCount点击捕获到的请求在Headers中找到Cookie字段复制完整的Cookie内容方法二控制台快捷提取在米游社网页版控制台中执行以下JavaScript代码var cookies document.cookie.split(;).filter(c c.includes(stoken) || c.includes(stuid) || c.includes(mid) ); console.log(cookies.join(;));方法三v2_stoken特殊处理当stoken以v2_开头时必须同时配置mid参数。mid值通常以account_mid_v2开头可从Cookie中提取。第四步配置文件详细设置打开config.yaml文件按照以下示例配置关键参数account: cookie: login_ticketxxx;stokenxxx;stuidxxx;midxxx stuid: 123456789 stoken: v2_xxxxxxxxxxxxxxxx mid: account_mid_v2_xxxxxxxx mihoyobbs: enable: true checkin: true checkin_list: [5, 2] # 社区ID列表 games: cn: enable: true genshin: checkin: true black_list: [] honkai_sr: checkin: true black_list: []第五步运行测试与验证执行单用户测试python main.py执行多用户测试python main_multi.py查看运行日志确认签到任务执行成功。高级功能详解多环境部署与自动化运维Docker容器化部署项目提供完整的Docker支持适合需要长期稳定运行的场景# 构建并启动容器 docker-compose up -d # 查看运行日志 docker-compose logs -f # 修改定时任务时间默认每天9:30运行 # 编辑docker-compose.yml中的CRON_SIGNIN参数Docker部署的优势在于环境隔离和自动重启确保签到任务不会因系统重启而中断。Kubernetes集群部署对于需要高可用性的生产环境可以使用Kubernetes部署# 创建配置文件 cp config/config.yaml.example kube/config.yaml # 创建ConfigMap并启动服务 kubectl create cm mihoyo-conf --from-file config.yaml kubectl apply -f kube/deployment.yaml # 查看运行状态 kubectl get pods -l appmihoyo kubectl logs pod-name -f青龙面板集成青龙面板用户可以通过以下步骤快速集成拉取仓库ql repo https://github.com/Womsxd/MihoyoBBSTools.git ql_main.py error|mihoyo|log|push|req|set|tools|con|acc|captcha|main|gamecheckin|hoyo_checkin|competition|cloudgames|os_cloudgames|web_activity配置环境变量AutoMihoyoBBS_config_path: /ql/data/config/ AutoMihoyoBBS_config_multi: 1 # 多用户模式 AutoMihoyoBBS_config_prefix: mhy_ # 配置文件前缀复制配置文件cp /ql/data/repo/Womsxd_MihoyoBBSTools/config/config.yaml.example /ql/data/config/mhy_config1.yamlNix Home Manager集成对于使用Nix系统的用户可以通过Home Manager配置Systemd用户服务services.mihoyo-bbs-tools { enable true; settings.config { enable true; account { cookie 你的Cookie; stuid ; stoken ; mid ; }; mihoyobbs.enable false; }; onCalendar 04:00; # 每天4点运行 };常见问题排查指南stoken认证异常解决方案问题排查流程图开始 ├─ 检查配置文件格式 → YAML语法错误 → 修复语法 ├─ 验证stoken有效性 → stoken过期 → 重新获取 ├─ 检查mid参数 → v2_stoken缺少mid → 补充mid值 ├─ 测试网络连接 → 网络异常 → 检查代理设置 ├─ 查看运行日志 → 具体错误信息 → 针对性解决 └─ 成功运行 → 完成常见错误及解决方案错误1stoken缺失或无效症状无 Stoken 请手动填入 stoken或stoken 已失效请重新抓取 cookie解决方案清除本地Cookie缓存重新登录米游社获取新的stoken更新配置文件中的stoken值错误2v2_stoken缺少mid参数症状服务器返回认证失败日志显示缺少必要参数解决方案account: stoken: v2_xxxxxxxxxxxxxxxx mid: account_mid_v2_xxxxxxxx # 必须添加此参数错误3Cookie过期症状{retcode:-100,message:登录信息已过期}解决方案# 自动刷新机制示例 def refresh_cookie(): new_token get_cookie_token_by_stoken() config.config[account][cookie] new_token config.save_config()错误4多用户配置冲突症状多用户运行时只有一个账号生效解决方案确保每个配置文件有唯一名称检查配置文件路径设置确认多用户模式已启用AutoMihoyoBBS_config_multi1日志分析与调试技巧启用详细日志输出查看具体错误信息# 增加日志级别 python main.py --verbose # 查看特定模块日志 python main.py --log-level DEBUG关键日志信息包括Stoken验证成功认证通过开始执行签到任务任务启动签到成功任务完成错误代码: -100认证过期最佳实践与性能优化策略定时任务配置优化根据实际需求调整执行频率避免频繁请求# Docker定时配置每天9:30执行有1200秒随机延时 CRON_SIGNIN: 30 9 * * * # 系统crontab配置每天凌晨3点执行 0 3 * * * cd /path/to/MihoyoBBSTools python3 main_multi.py autorun多账号管理策略对于需要管理多个账号的用户建议采用以下目录结构config/ ├── user1.yaml # 账号1配置 ├── user2.yaml # 账号2配置 ├── user3.yaml # 账号3配置 └── common.yaml # 通用配置如有错误重试机制配置在配置文件中调整重试参数提高任务成功率games: cn: retries: 3 # 重试次数 useragent: Mozilla/5.0 (Linux; Android 12; Unspecified Device) AppleWebKit/537.36 (KHTML, like Gecko) Version/4.0 Chrome/103.0.5060.129 Mobile Safari/537.36监控与告警设置结合推送功能实现任务状态监控push: wecom # 支持企业微信、Server酱等推送方式配置推送后系统会在以下情况发送通知签到任务开始执行签到任务成功完成遇到错误需要人工干预定期运行状态报告性能优化建议资源占用优化使用Docker资源限制避免过度占用系统资源调整Python垃圾回收参数合理设置超时时间避免长时间等待网络请求优化使用连接池复用HTTP连接合理设置请求超时时间启用请求压缩减少数据传输量存储优化定期清理日志文件使用轻量级数据库存储运行状态配置日志轮转避免磁盘空间不足通过以上配置和优化MihoyoBBSTools可以实现稳定可靠的自动化签到服务大幅提升用户体验和任务完成率。无论是个人用户还是多账号管理都能找到合适的部署方案和配置策略。【免费下载链接】MihoyoBBSToolsWomsxd/AutoMihoyoBBS米游社相关脚本项目地址: https://gitcode.com/gh_mirrors/mi/MihoyoBBSTools创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
