彻底解决账号误签问题：MihoyoBBSTools黑名单字段终极配置指南-优快云博客

彻底解决账号误签问题：MihoyoBBSTools黑名单字段终极配置指南

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

你是否曾因脚本自动签到了不想参与的游戏账号而烦恼？是否希望精准控制哪些账号参与米游社自动签到？本文将系统讲解MihoyoBBSTools中black_list字段的配置方法，帮你实现账号签到的精细化管理，杜绝误签漏签问题。

读完本文你将掌握：

black_list字段的工作原理与应用场景
多维度黑名单配置实战（游戏/服务器/账号）
常见配置错误排查与最佳实践
配置模板与迁移方案

1. 黑名单字段核心原理

black_list（黑名单）是MihoyoBBSTools中用于排除特定账号参与自动签到的核心配置项，通过在YAML配置文件中定义账号UID列表，实现对签到范围的精准控制。

1.1 工作流程图

mermaid

1.2 配置位置解析

在config/config.yaml文件中，black_list字段按游戏类型和服务器区域分层组织，形成三维控制结构：

games:
  cn:  # 国服游戏
    genshin:          # 原神
      checkin: true   # 启用签到
      black_list: []  # 原神国服黑名单
    honkai_sr:        # 星穹铁道
      checkin: true
      black_list: []  # 星穹铁道国服黑名单
  os:  # 国际服游戏
    genshin:
      checkin: false
      black_list: []  # 原神国际服黑名单

2. 基础配置方法

2.1 单账号屏蔽

最常用的配置方式，在对应游戏的black_list中添加需要排除的账号UID：

games:
  cn:
    genshin:
      checkin: true
      # 屏蔽单个原神账号
      black_list: ["100000000"]  # UID为字符串格式

2.2 多账号批量屏蔽

同时排除多个账号时，以逗号分隔UID字符串：

games:
  cn:
    honkai_sr:
      checkin: true
      # 屏蔽多个星穹铁道账号
      black_list: ["100000001", "100000002", "100000003"]

2.3 全游戏账号屏蔽

如需暂时禁用某个游戏的所有签到，推荐直接设置checkin: false，而非批量添加所有账号到黑名单：

games:
  cn:
    zzz:  # 绝区零
      checkin: false  # 禁用整个游戏签到
      black_list: []  # 无需填写

3. 高级应用场景

3.1 按服务器区域屏蔽

针对同时玩多个服务器的用户，可分别配置不同区域的黑名单：

games:
  cn:  # 国服
    genshin:
      black_list: ["100000000"]  # 屏蔽国服1区账号
  os:  # 国际服
    genshin:
      checkin: true
      black_list: ["800000000"]  # 屏蔽国际服美区账号

3.2 云游戏账号特殊处理

云游戏账号通过独立配置项控制，需在cloud_games节点下设置：

cloud_games:
  cn:
    enable: true
    genshin:
      enable: true
      token: ["token1", "token2"]  # 云原神token列表
      # 注意：云游戏暂无独立black_list，需通过主游戏black_list控制

3.3 多维度组合屏蔽

实现"除特定账号外全部签到"的反向逻辑（需结合代码层实现）：

# gamecheckin.py核心过滤逻辑
if account[1] in config.config["games"]["cn"][self.game_mid]["black_list"]:
    continue  # 命中黑名单则跳过

4. 配置模板与实例

4.1 标准配置模板

# 推荐的黑名单配置模板
version: 15
games:
  cn:
    enable: true
    useragent: "Mozilla/5.0 (Linux; Android 12) AppleWebKit/537.36"
    retries: 3
    # 原神配置
    genshin:
      checkin: true
      # 屏蔽测试服账号和不常用小号
      black_list: ["100000000", "100000001"]
    # 星穹铁道配置
    honkai_sr:
      checkin: true
      # 只屏蔽特定账号
      black_list: ["800000000"]
    # 其他游戏配置...
    zzz:
      checkin: false
      black_list: []
  os:
    enable: false
    # 国际服配置...

4.2 典型用户场景配置

场景1：多账号玩家（主玩原神+星穹铁道）

games:
  cn:
    genshin:
      checkin: true
      black_list: ["100000002"]  # 屏蔽原神3号小号
    honkai_sr:
      checkin: true
      black_list: []  # 所有星穹账号都签到
    # 其他游戏全部禁用
    honkai3rd:
      checkin: false
    zzz:
      checkin: false

场景2：仅参与特定活动

games:
  cn:
    # 只开启当前有活动的游戏
    genshin:
      checkin: true
      black_list: []
    # 其他游戏全部屏蔽
    honkai2:
      checkin: true
      black_list: ["所有账号UID"]  # 实际配置时替换为真实UID
    honkai3rd:
      checkin: true
      black_list: ["所有账号UID"]

5. 错误排查与最佳实践

5.1 常见配置错误

错误类型	错误示例	正确写法
类型错误	`black_list: [100000000]`	`black_list: ["100000000"]`
格式错误	`black_list: "100000000"`	`black_list: ["100000000"]`
路径错误	在`cloud_games`下配置black_list	在对应游戏节点下配置
语法错误	`black_list: [100000000, ]`	`black_list: ["100000000"]`

5.2 调试与验证方法

配置验证：使用YAML验证工具检查格式正确性

# 使用Python内置工具验证配置
python -c "import yaml; yaml.safe_load(open('config/config.yaml'))"

日志检查：查看执行日志确认屏蔽效果

# 成功屏蔽时的日志
2023-10-01 08:00:00 INFO 正在为旅行者「账号1」进行签到...
2023-10-01 08:00:05 INFO 旅行者「账号2」已在黑名单中，跳过签到

5.3 性能优化建议

精简列表：只保留需要屏蔽的账号，避免冗余
按游戏分组：不同游戏独立配置，提高可读性
定期清理：每月检查一次黑名单，移除已注销/不再使用的账号

6. 配置迁移与版本兼容

6.1 版本差异说明

配置版本	变化内容	兼容性处理
v12及以下	无black_list字段	需手动添加字段
v13-v14	基础black_list支持	仅支持国服游戏
v15+	全游戏类型支持	包含国际服和云游戏

6.2 从旧版本迁移

备份原配置文件

添加新版本必要字段

# 从v14迁移到v15需添加国际服配置
games:
  os:
    genshin:
      checkin: false
      black_list: []

验证配置有效性

7. 总结与展望

black_list字段作为MihoyoBBSTools的核心配置项，为用户提供了精细化的账号管理能力。通过本文介绍的配置方法，你可以轻松实现：

多账号选择性签到
服务器区域隔离
活动期间临时调整
账号生命周期管理

未来版本可能新增的功能：

正则表达式匹配账号
按角色等级/成就屏蔽
定时自动更新黑名单

掌握黑名单配置，让米游社自动签到更智能、更贴合个人需求。如有任何配置问题，欢迎在项目Issue区交流讨论。

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

创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考