AI 翻译

AI 翻译功能可以将推送内容翻译成任意语言，帮助你打破语言壁垒。无论是阅读国内热点新闻，还是订阅海外 RSS 源，都可以用你熟悉的语言获取内容。

启用翻译

在 config/config.yaml 中添加以下配置即可开启翻译功能：

ai_translation:
  enabled: true
  language: "English"  # 目标语言，填写你想翻译成的语言

前提条件

AI 翻译功能与 AI 分析功能共享模型配置。请确保你已经在 config.yaml 的 ai 部分配置了 api_key。如果你已经在使用 AI 分析推送，无需额外配置模型参数，直接启用翻译即可。

环境变量支持

翻译配置也可以通过环境变量设置：AI_TRANSLATION_ENABLED=true 和 AI_TRANSLATION_LANGUAGE=English。 GitHub Actions 用户可将这些值配置为 Secrets，无需修改配置文件。

支持的语言

你可以将 language 字段设置为以下常用语言，也可以填写其他任意语言名称：

语言值	说明
`English`	英语
`Korean`	韩语
`Japanese`	日语
`French`	法语
`Spanish`	西班牙语
`German`	德语
...	你可以填写任意语言名称，AI 会尝试翻译

功能特点

特性	说明
一键开启	只需在配置文件中设置 enabled: true 和目标语言，即可启用翻译功能
智能批量处理	大量标题翻译时自动分批处理，减少 API 调用次数，节省成本（v6.10.0 新增）
自定义翻译风格	通过 ai_translation_prompt.txt 文件自定义翻译提示词，调整翻译风格和语气
共享模型配置	与 AI 分析功能共用同一个模型配置，只需配置一次 ai.api_key 即可
分段控制	可以单独控制热榜、RSS、独立推送等各部分是否启用翻译
智能跳过	未启用展示的推送部分会自动跳过翻译，节省 Token 用量

批量处理机制

从 v6.10.0 开始，AI 翻译引入了智能批量处理机制。当需要翻译大量标题时，系统会自动将翻译请求分批发送，避免单次请求超出模型限制，同时减少 API 调用次数以降低使用成本。

你可以通过以下配置项调整批量处理的行为：

ai_translation:
  batch_size: 100     # 每批发送给 AI 的标题数（默认 100）
  batch_interval: 2   # 分批间隔秒数，避免触发 API 限流（默认 2）

默认配置已经适合大多数场景，通常无需调整。如果你使用的 AI 服务有更严格的速率限制，可以适当减小 batch_size 或增大 batch_interval。

自定义翻译风格

如果你对默认的翻译效果不满意，可以通过编辑 config/ai_translation_prompt.txt 文件来调整翻译提示词。例如，你可以要求 AI 使用更口语化的表达，或者保留特定术语不翻译。

提示词文件格式说明

分段翻译控制

翻译功能支持对不同推送部分进行独立控制。你可以选择只翻译热榜内容、只翻译 RSS 内容，或者只翻译独立推送部分。未启用展示的部分会被自动跳过，不会浪费 Token。

ai_translation:
  scope:
    hotlist: false    # 不翻译热榜标题（默认关闭）
    rss: true         # 翻译 RSS 标题（默认开启）
    standalone: true  # 翻译独立展示区标题（默认开启）

各字段的默认值：hotlist 默认为 false（关闭），rss 和 standalone 默认为 true（开启）。你可以根据需要自行调整。

前提：display.regions 必须开启

翻译的前提是 display.regions 中对应区域已开启。例如 scope.rss=true 要生效，需要 display.regions.rss=true。如果某个区域的展示被关闭，即使翻译 scope 设为 true 也不会翻译该部分。

节省 Token 的技巧

如果你只关注某一类推送内容（例如只看 RSS），可以在配置中关闭其他部分的展示。翻译功能会自动跳过未展示的部分，有效减少 API 调用和 Token 消耗。

成本极低

翻译标题的 token 消耗非常少。以 DeepSeek 为例，翻译 100 条新闻标题的成本不到 0.01 元。即使每天多次推送，月度翻译成本也几乎可以忽略不计。

注意事项

关于海外内容翻译

部分海外媒体内容可能涉及敏感话题，AI 模型可能会拒绝翻译此类内容。建议在订阅 RSS 源时注意筛选来源，避免订阅可能包含敏感内容的源。

RSS 源推荐

如果你正在寻找优质的海外 RSS 订阅源，以下两个开源项目整理了大量高质量的 RSS 源列表，可以配合翻译功能使用：

awesome-tech-rss

科技、创业、编程相关的博客 RSS 合集

awesome-rss-feeds

全球主流新闻媒体的 RSS 源收录