黑名单管理

功能说明

黑名单系统用于过滤不需要翻译的内容，包括：

• 调试信息
• 法律条款
• 艺术家署名
• Mojang特定内容

配置文件

黑名单配置存储在 data/blacklist.json：

{
  "patterns": [
    "debug.*",
    "*.legal",
    "artist.credits.*"
  ],
  "exact": [
    "gui.socialInteractions.server_label.mojang"
  ],
  "keywords": [
    "mojang",
    "copyright"
  ]
}

过滤规则

模式匹配 (patterns)

支持通配符 * 匹配：

• debug.* - 匹配所有以debug开头的键
• *.legal - 匹配所有以legal结尾的键

精确匹配 (exact)

完全匹配指定的翻译键

关键词匹配 (keywords)

匹配包含指定关键词的翻译键

管理命令

查看黑名单

pnpm run cli blacklist list

添加规则

pnpm run cli blacklist add --pattern "debug.*"
pnpm run cli blacklist add --exact "specific.key"
pnpm run cli blacklist add --keyword "mojang"

删除规则

pnpm run cli blacklist remove --pattern "debug.*"

测试过滤

pnpm run cli blacklist test "translation.key"

应用范围

黑名单过滤在以下场景中生效：

• 翻译进度统计
• 资源包构建
• 翻译验证