📝 docs(trendradar): update configuration documentation and comments

apps/trendradar/5.2.0/config/ai_analysis_prompt.txt

@@ -3,96 +3,112 @@
 # ═══════════════════════════════════════════════════════════════
 #
 # 此文件定义 AI 分析热点新闻时使用的提示词模板
-# 你可以根据需要自定义分析角度和输出格式
 #
 # 可用变量（在分析时会被替换）：
-#   {report_mode}     - 当前报告模式 (daily/current/incremental)
+#   {language}        - 输出语言 (由 ai_analysis.language 配置)
+#   {report_mode}     - 当前报告模式
 #   {report_type}     - 报告类型描述
 #   {current_time}    - 当前时间
 #   {news_count}      - 热榜新闻条数
 #   {rss_count}       - RSS 新闻条数
 #   {keywords}        - 匹配的关键词列表
 #   {platforms}       - 数据来源平台列表
+#   {news_content}    - 热榜新闻内容
+#   {rss_content}     - RSS 订阅内容 (需开启 ai_analysis.include_rss)
 #
 # ═══════════════════════════════════════════════════════════════
 
 [system]
 你是一位专业的新闻分析师和趋势观察者。你的任务是分析热点新闻数据，提供有价值的洞察。
 
-分析原则：
-1. 客观中立 - 基于事实分析，避免主观臆断
-2. 深度洞察 - 挖掘表面现象背后的趋势和规律
-3. 实用价值 - 提供可操作的见解和建议
-4. 简洁明了 - 用精炼的语言表达核心观点
+## 核心原则
 
-## 数据来源说明
+1. 直击要害：避免废话，直接说"是什么"、"有多火"、"要注意什么"。
+2. 逻辑闭环：将"现象"、"原因"与"建议"打通，告诉读者信息背后的行动指南。
+3. 观点鲜明：明确指出是"泡沫"还是"机遇"，是"争议"还是"共识"。
+4. 通俗易懂：使用大众能理解的词汇（如"过热"、"降温"、"反转"、"出圈"），避免生造复杂概念。
+5. 辩证思维：运用矛盾论视角，识别热点背后的"主要矛盾"与"次要矛盾"，抓住事物发展的关键内因。
 
-本系统从多个热榜平台（如微博、知乎、今日头条等）和 RSS 订阅源抓取新闻数据。
-数据经过 frequency_words.txt 中定义的关键词过滤，只保留匹配的新闻。
+## 数据字段深度解读指南
 
-## 数据字段说明
+为了做出精准判断，请充分利用以下数据维度：
 
-### 热榜新闻字段
-每条热榜新闻包含以下维度：
-- 来源: 新闻所在的热榜平台（如微博热搜、知乎热榜、今日头条等）
-- 标题: 新闻标题内容
-- 排名: 该新闻在来源平台热榜中的排名范围，格式为"最高排名-最低排名"（如"1"表示排名稳定在第1，"3-8"表示最高冲到第3名、最低跌到第8名）
-- 时间: 该新闻在热榜上出现的时间段，格式为"首次出现时间~最后出现时间"（如"09:30~12:45"表示从9:30首次上榜到12:45最后一次出现）
-- 出现次数: 在监控时间段内，该新闻被抓取到的次数（次数越多说明在热榜上停留时间越长，热度越持久）
+### 1. 基础维度
+- 排名："1"为榜首，数字越小越热。"3-8"表示排名在第3到第8之间波动。
+- 出现次数：次数越多，说明在热榜由于停留时间越长，热度越持久。
+- 时间范围：如"09:30~12:45"，跨度越大说明话题生命力越强。
 
-### RSS 新闻字段
-每条 RSS 新闻包含：
-- 来源: RSS 订阅源名称
-- 标题: 文章标题
-- 发布时间: 文章的原始发布时间
+### 2. 轨迹量化分析 (重要)
+当数据包含轨迹信息（如 `1(09:30)→0(10:00)→2(10:30)`）时，请关注：
+- 急升/爆发：排名在短时间内大幅上升（如从20名升至3名），往往意味着重大突发事件。
+- 僵尸热搜：排名持续阴跌且无反弹（如 10→15→20），说明热度正在衰退。
+- 回榜/反转：脱榜（显示为0）后又重回高位，通常意味着有新爆料或反转剧情。
 
-## 分析要点
+### 3. 跨平台特征 (分级标准)
+- 全网霸屏：5 个及以上平台同时上榜。真正的“国民级”话题，无死角覆盖。
+- 破圈扩散：3-4 个平台同时上榜。话题已突破单一社区壁垒，正在向外蔓延。
+- 圈层热点：仅在 1-2 个平台火爆。属于特定人群的狂欢（如仅在技术社区或娱乐榜）。
 
-利用这些数据维度，你可以分析：
-1. 热度强度: 排名越靠前（数字越小）、出现次数越多，热度越高
-2. 持续时间: 时间跨度大、出现次数多，说明话题持续发酵
-3. 排名波动: 排名范围大（如"1-20"）说明热度不稳定，范围小（如"2-4"）说明热度稳定
-4. 跨平台热度: 同一话题在多个平台出现，说明影响力更广
-5. 新兴趋势: 排名快速上升或首次出现的话题
-6. 时效性: RSS 发布时间可判断信息新鲜度
+## 分析板块说明 (5个核心板块)
+
+1. 核心热点态势 (Core Trends & Momentum)
+   - 整合："趋势概述"、"热度走势"、"跨平台关联"。
+   - 任务：直接定性当前最火的话题。结合排名和跨平台数据，判断是"全网刷屏"还是"圈层热议"。
+   - 写法：避免简单罗列数据，而是总结态势。例如："某话题霸榜多平台，热度持续超6小时，呈现极速爆发态势。"
+
+2. 舆论风向争议 (Sentiment & Controversy)
+   - 任务：运用矛盾分析法挖掘公众情绪内核。识别舆论场中的"根本对立"（主要矛盾）与"转化趋势"，分析主流与非主流观点的博弈。
+   - 重点：是否存在观点对立？（如技术乐观派 vs 隐私担忧派）。情绪是正面（期待、兴奋）、负面（愤怒、担忧）还是复杂（调侃、质疑）？
+
+3. 异动与弱信号 (Signals)
+   - 任务：通过"轨迹"和"排名变化"捕捉异常。
+   - 关注：排名骤升的突发事件、首次出现的新鲜话题、或者反直觉的热度波动（如深夜突然高热）。
+
+4. RSS 深度洞察 (RSS Insights)
+   - 任务：分析 RSS 订阅源中的专业内容，提炼行业动态和深度信息。
+   - 关注：技术博客的前沿观点、行业媒体的独家报道、与热榜话题的关联或差异。
+   - 写法：突出 RSS 内容的"信息增量"——热榜没有但 RSS 有的独特视角或深度分析。
+
+5. 研判策略建议 (Outlook & Strategy)
+   - 整合："潜在影响"与"建议"。
+   - 任务：形成闭环。基于上述分析，预测后续走向（如"可能会引起监管注意"），并给出具体建议。
+   - 对象：建议可面向投资者、品牌方或普通大众，力求落地。
 
 [user]
 请分析以下热点新闻数据：
 
 ## 数据概览
-- 报告模式：{report_mode}
-- 报告类型：{report_type}
+- 报告模式：{report_mode} ({report_type})
 - 分析时间：{current_time}
-- 热榜新闻：{news_count} 条
-- RSS 新闻：{rss_count} 条
-- 数据来源：{platforms}
+- 数据量：{news_count}条热榜 + {rss_count}条RSS
+- 来源：{platforms}
 
 ## 匹配关键词
 {keywords}
 
-## 新闻内容
+## 热榜新闻
 {news_content}
 
+## RSS 订阅
+{rss_content}
+
 ---
 
-请基于上述数据进行多维度分析，以 JSON 格式返回结果：
+请基于上述数据撰写分析报告，以 JSON 格式返回结果：
 
 ```json
 {
-  "summary": "核心热点概况（用简练语言概括当前最主要的核心事件，避免提及具体排名数据，80字以内）",
-  "keyword_analysis": "热度走势分析（结合排名波动、出现次数和时间跨度，分析核心话题的爆发力与持久性，80字以内）",
-  "sentiment": "情感倾向分析（极其重要：深入分析公众对核心话题的情感反馈，如：正面、负面、担忧、中性或争议，并简述原因，80字以内）",
-  "cross_platform": "跨平台联动分析（分析话题在多平台同步热搜的程度及其影响力差异，60字以内）",
-  "impact": "潜在影响评估（评估话题对社会舆论、行业动态或公众决策的冲击，60字以内）",
-  "signals": "异常与弱信号捕捉（关注排名骤升、首次出现或反直觉的波动，60字以内）",
-  "conclusion": "结论与建议（给出1-2条具有参考价值的操作性建议，40字以内）"
+  "core_trends": "核心热点态势（200字以内）。语言要像"大白话"一样通俗，但要像"手术刀"一样精准。拒绝学术词汇。严格按以下格式分段（注意换行）：\n(一句话直击本质的开场白)\n\n【宏观主线】：\n(用通俗的话概括大势，如：国外巨头忙基建，国内市场炒应用...)\n\n【微观领域】：\n1. (细分点1)：(描述)\n2. (细分点2)：(描述)",
+  "sentiment_controversy": "舆论风向争议（100字以内）。先定性【整体】是褒是贬，再看【局部】有啥吵头。格式：\n【整体定性】：\n(如：全网都在骂，但也有人在这波流量里赚钱...)\n\n【争议焦点】：\n1. (焦点1)：...\n2. (焦点2)：...",
+  "signals": "异动与弱信号（100字以内）。按信号类型分点：\n1. 急升信号：...\n2. 异动信号：...\n3. 弱信号：...",
+  "rss_insights": "RSS 深度洞察（100字以内，无RSS数据时填"暂无RSS数据"）。突出RSS的信息增量：\n【独家视角】：\n(热榜没有但RSS有的独特观点或深度分析)\n\n【行业动态】：\n(技术博客、行业媒体的前沿信息)",
+  "outlook_strategy": "研判策略建议。分受众群体给出建议：\n1. 投资者：...\n2. 品牌方：...\n3. 公众：..."
 }
 ```
 
 要求：
 - 必须返回有效的 JSON 格式
-- 分析要结合排名、出现次数、时间跨度等数据维度
-- 情感倾向分析是重点，请确保能够准确捕捉舆论风向
-- 每个字段都要填写，如无明显发现可写"暂无明显特征"
-- 使用中文
-- 保持简洁，避免冗余内容在不同字段间重复
+- 使用 {language} 输出，语言简练专业
+- 确保 5 个板块不重叠，信息不冗余
+- 若某板块无明显内容，可简写"暂无显著异常"
+- 不要使用 Markdown 格式（如 **加粗**），仅使用纯文本

apps/trendradar/5.2.0/config/ai_translation_prompt.txt

@@ -0,0 +1,27 @@
+# ═══════════════════════════════════════════════════════════════
+#                    TrendRadar AI 翻译提示词配置
+# ═══════════════════════════════════════════════════════════════
+#
+# 此文件定义 AI 翻译内容时使用的提示词模板
+#
+# 可用变量：
+#   {target_language} - 目标语言
+#   {content}         - 需要翻译的文本内容
+#
+# ═══════════════════════════════════════════════════════════════
+
+[system]
+你是一位精通多语言的专业翻译助手。你的任务是将新闻内容翻译成目标语言，保持新闻的专业性、准确性和简洁性。
+
+要求：
+1. 准确传达原文含义，不要遗漏关键信息。
+2. 保持新闻标题的吸引力，但不要做标题党。
+3. 专有名词（人名、地名、机构名）若有通用译名请使用通用译名，否则保留原文或在括号内备注。
+4. 输出格式必须严格遵循要求，不要输出任何多余的解释性文字。
+
+[user]
+请将以下内容翻译成 {target_language}：
+
+{content}
+
+请直接输出翻译结果。

apps/trendradar/5.2.0/config/config.yaml

@@ -20,34 +20,38 @@ app:
 # ===============================================================
 # 2. 数据源 - 热榜平台
 #
-# id: 平台唯一标识（勿修改）
-# name: 显示名称（可自定义，修改后不影响运行）
+# enabled: 是否启用热榜抓取（总开关）
+# sources: 平台列表
+#   - id: 平台唯一标识（勿修改）
+#   - name: 显示名称（可自定义，修改后不影响运行）
+# 参考: https://github.com/sansan0/TrendRadar/issues/95
 # ===============================================================
-# name 可以定义任意名称，只具有显示作用，即使项目运行了几天后，忽然改掉 name 也不会影响代码的正常运行
-# references: https://github.com/sansan0/TrendRadar/issues/95
 platforms:
-  - id: "toutiao"
-    name: "今日头条"
-  - id: "baidu"
-    name: "百度热搜"
-  - id: "wallstreetcn-hot"
-    name: "华尔街见闻"
-  - id: "thepaper"
-    name: "澎湃新闻"
-  - id: "bilibili-hot-search"
-    name: "bilibili 热搜"
-  - id: "cls-hot"
-    name: "财联社热门"
-  - id: "ifeng"
-    name: "凤凰网"
-  - id: "tieba"
-    name: "贴吧"
-  - id: "weibo"
-    name: "微博"
-  - id: "douyin"
-    name: "抖音"
-  - id: "zhihu"
-    name: "知乎"
+  enabled: true                         # 是否启用热榜平台抓取
+  sources:
+    - id: "toutiao"
+      name: "今日头条"
+    - id: "baidu"
+      name: "百度热搜"
+    - id: "wallstreetcn-hot"
+      name: "华尔街见闻"
+    - id: "thepaper"
+      name: "澎湃新闻"
+    - id: "bilibili-hot-search"
+      name: "bilibili 热搜"
+    - id: "cls-hot"
+      name: "财联社热门"
+    - id: "ifeng"
+      name: "凤凰网"
+    - id: "tieba"
+      name: "贴吧"
+    - id: "weibo"
+      name: "微博"
+    - id: "douyin"
+      name: "抖音"
+    - id: "zhihu"
+      name: "知乎"
+
 
 
 # ===============================================================
@@ -73,6 +77,7 @@ rss:
   #    - 只有新鲜的文章会被推送到通知渠道
   freshness_filter:
     enabled: true                     # 是否启用新鲜度过滤（默认启用）
+
     max_age_days: 3                   # 最大文章年龄（天）
                                       # - 正整数：只推送 N 天内的文章
                                       # - 0：禁用过滤，推送所有文章
@@ -125,17 +130,72 @@ rss:
 # ===============================================================
 report:
   mode: "current"                     # 可选: daily | current | incremental
-  display_mode: "keyword"             # 可选: keyword | platform
+  display_mode: "keyword"             # 分组维度: keyword | platform
                                       # keyword: 按关键词分组显示（默认）
                                       # platform: 按平台/来源分组显示
+
+  # 关键词组排序方式（仅 display_mode: keyword 时生效）
+  # true: 按 frequency_words.txt 中的定义顺序排列
+  # false: 按匹配到的热点条数排序（条数多的在前）
+  sort_by_position_first: false
+
   rank_threshold: 5                   # 排名高亮阈值
-  sort_by_position_first: false       # true=按配置位置排序，false=按热点条数排序
+
   max_news_per_keyword: 0             # 每个关键词最大显示数量（0=不限制）
-  reverse_content_order: false        # false=热点词汇统计在前，true=新增热点新闻在前
 
 
 # ===============================================================
-# 5. 推送通知
+# 5. 推送内容控制
+#
+# 统一管理推送消息中显示哪些区域及其排列顺序
+# ===============================================================
+display:
+  # 📋 区域显示顺序
+  # 列表从上到下的顺序 = 推送消息中从上到下的显示顺序
+  # 想调整顺序？直接剪切粘贴整行即可，例如把 ai_analysis 移到最前面：
+  #   region_order:
+  #     - ai_analysis    ← 移到第一行，AI 分析就会显示在最顶部
+  #     - new_items
+  #     - hotlist
+  #     - ...
+  # 注意：区域需同时满足两个条件才会显示：
+  #   1. 在此列表中
+  #   2. 下方 regions 中对应开关为 true
+  region_order:
+    - new_items                       # 1️⃣ 新增热点区域
+    - hotlist                         # 2️⃣ 热榜区域（关键词匹配）
+    - rss                             # 3️⃣ RSS 订阅区域
+    - standalone                      # 4️⃣ 独立展示区
+    - ai_analysis                     # 5️⃣ AI 分析区域
+
+  # 推送区域开关
+  # 控制各区域是否启用（配合 region_order 使用）
+  regions:
+    hotlist: true                     # 热榜区域（关键词匹配的热点新闻）
+    new_items: true                   # 新增热点区域（含热榜新增 + RSS 新增）
+                                      # 注：热点词汇统计中的新增标记🆕不受此配置影响
+
+    rss: true                         # RSS 订阅区域
+                                      # 开启后将对 RSS 进行关键词分析并在通知中展示
+                                      # 关闭后跳过分析，但独立展示区不受影响
+
+    standalone: false                 # 独立展示区（完整热榜/RSS，不受关键词过滤）
+    ai_analysis: true                 # AI 分析区域
+
+  # 📋 独立展示区配置（仅在 regions.standalone: true 时生效）
+  # 用途：将指定平台的完整热榜/RSS 单独展示，不受关键词过滤影响
+  # 适用场景：
+  #   - 想完整查看某个平台的热榜排名
+  #   - RSS 源内容较少，希望全部展示而非只显示关键词匹配的
+  # 注意：同一新闻可能同时出现在关键词匹配区和独立展示区
+  standalone:
+    platforms: []                     # 热榜平台 ID 列表（如 ["zhihu", "weibo"]）
+    rss_feeds: []                     # RSS 源 ID 列表（如 ["hacker-news"]）
+    max_items: 20                     # 每个源最多展示条数（0=不限制）
+
+
+# ===============================================================
+# 6. 推送通知
 #
 # ⚠️ 重要安全警告 ⚠️
 #
@@ -160,28 +220,17 @@ notification:
   # 🕐 推送时间窗口控制（可选功能）
   # 用途：限制推送的时间范围，避免非工作时间打扰
   # 适用场景：
-  #   - 只想在工作日白天接收推送（如 09:00-18:00）
-  #   - 希望在晚上固定时间收到汇总（如 20:00-22:00）
-  # 注意：GitHub Actions 执行时间不稳定，时间范围建议至少留足 2 小时
-  #       如果想要精准的定时推送，建议使用 Docker 部署在个人服务器上
+  #   • 只想在工作日白天接收推送（如 09:00-18:00）
+  #   • 希望在晚上固定时间收到汇总（如 20:00-22:00）
+  # ⚠️ GitHub Actions 用户注意：
+  #   执行时间不稳定，时间范围建议至少留足 2 小时
+  # 💡 想要精准定时？建议使用 Docker 部署在个人服务器上
   push_window:
     enabled: false                    # 是否启用推送时间窗口控制
     start: "20:00"                    # 开始时间（北京时间）
     end: "22:00"                      # 结束时间（北京时间）
     once_per_day: true                # true=窗口内只推送一次，false=窗口内每次执行都推送
 
-  # 📋 独立展示区配置（可选功能）
-  # 用途：将指定平台的完整热榜/RSS 单独展示，不受关键词过滤影响
-  # 适用场景：
-  #   - 想完整查看某个平台的热榜排名
-  #   - RSS 源内容较少，希望全部展示而非只显示关键词匹配的
-  # 注意：同一新闻可能同时出现在关键词匹配区和独立展示区
-  standalone_display:
-    enabled: false                    # 是否启用独立展示区
-    platforms: []                     # 热榜平台 ID 列表（如 ["zhihu", "weibo"]）
-    rss_feeds: []                     # RSS 源 ID 列表（如 ["hacker-news"]）
-    max_items: 20                     # 每个源最多展示条数（0=不限制）
-
   # 推送渠道配置
   channels:
     feishu:
@@ -224,7 +273,7 @@ notification:
 
 
 # ===============================================================
-# 6. 存储配置
+# 7. 存储配置
 # ===============================================================
 storage:
   # 存储后端选择
@@ -249,6 +298,7 @@ storage:
   # 建议将敏感信息配置在 GitHub Secrets 或环境变量中
   remote:
     retention_days: 0                 # 保留天数（0=永久保留）
+
     # S3 兼容配置（或使用环境变量 S3_ENDPOINT_URL 等）
     endpoint_url: ""                  # 服务端点
                                       # Cloudflare R2: https://<account_id>.r2.cloudflarestorage.com
@@ -267,14 +317,12 @@ storage:
 
 
 # ===============================================================
-# 7. AI 分析功能
+# 8. AI 模型配置（共享）
 #
-# 使用 AI 大模型对推送内容进行深度分析
-# 支持 OpenAI、Anthropic、DeepSeek等兼容接口
+# ai_analysis 和 ai_translation 共用此模型配置
+# 支持 OpenAI、DeepSeek、Google Gemini 等兼容接口
 # ===============================================================
-ai_analysis:
-  enabled: true                    # 是否启用 AI 分析
-
+ai:
   # AI 提供商配置
   # 支持的提供商:
   #   - deepseek: DeepSeek（默认）
@@ -296,27 +344,91 @@ ai_analysis:
 
   timeout: 90                       # 请求超时（秒）
 
-  # 推送模式（仅在 enabled: true 时生效）
-  # - only_analysis: 仅推送 AI 分析结果（若开启了“独立展示区”则一并保留，屏蔽原始热榜/RSS 列表）
-  # - both: 两者都推送（分析追加在原始内容后）
-  # 注：如果不需要 AI 分析，请将上方 enabled 设为 false，无需使用 push_mode 控制
-  push_mode: "both"
+  # AI 参数配置
+  temperature: 1.0                  # 采样温度 (0.0-2.0)
+                                    # 注意：部分模型(如 gpt-5)可能要求必须为 1.0，否则会报错
 
-  # 分析选项
-  max_news_for_analysis: 50         # 参与分析的新闻数量上限（控制成本关键项）
-                                    # api 成本估算 (仅供参考)
-                                      # 按默认推送频率和模型
-                                      # GitHub Action 约 0.1 元/天
-                                      # Docker 部署约 0.2 元/天
+  max_tokens: 5000                  # 最大生成 token 数
+                                    # 注意：如果 API 不支持此参数(报 HTTP 400)，请设为 0 以禁用发送
 
-  include_rss: false                # 是否包含 RSS 内容进行分析
+  # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  # 额外自定义参数 (高级选项)
+  # ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  # 说明：用于向 AI 传递模型特定的高级生成参数。
+  # ⚠️ 警告：如果你不了解这些参数的含义，强烈建议【不要改动】，保持当前的注释状态。
+  #          填写了不符合模型要求的参数会导致 AI 分析报错并停止工作。
+  #
+  # 提示：不仅限于下方的示例，你可以根据模型 API 文档自行添加任何支持的字段。
+  #
+  # 操作：如果你确定需要修改，请删掉该行最前方的 "# " (井号和空格)。
+  # 注意：如果这几行都带着井号，则代表不使用额外参数（最推荐做法）。
+  # -------------------------------------------------------------
+  # extra_params:
+  #   top_p: 1.0            # [通用] 核采样：值越小生成结果越集中
+  #   topK: 40              # [Gemini 专用] 限制候选词数量
+  #   presence_penalty: 0.0 # [OpenAI 专用] 鼓励模型谈论新话题
+  #   # 你也可以在此继续添加模型支持的其他新字段，例如 stop, logit_bias 等
+
+
+# ===============================================================
+# 9. AI 分析功能
+#
+# 使用 AI 大模型对推送内容进行深度分析
+# 模型配置见上方 ai 配置段
+# ===============================================================
+ai_analysis:
+  enabled: true                     # 是否启用 AI 分析
+
+  # 分析报告输出语言
+  # 格式：自然语言描述
+  # 示例: "English", "Korean", "法语"
+  language: "Chinese"
 
   # 提示词配置文件路径（相对于 config 目录）
   prompt_file: "ai_analysis_prompt.txt"
 
+  # 分析内容配置
+  max_news_for_analysis: 50         # 参与分析的新闻数量上限（控制成本关键项）
+                                    # 当前默认的【报告模式】是【当前榜单模式】（current），也就是只分析当前在热榜的新闻
+                                    # 如果需要让报告呈现出更有参考价值的完整一天的趋势，且你的 token 充裕
+                                      # 可开启 daily（当日汇总模式）
+                                      # 同时调整 max_news_for_analysis 为 150(你自己视情况调整，推送消息顶部有 ai 分析数目供参考)
+
+                                    # api 成本估算 (仅供参考)
+                                      # 按默认推送频率和模型(deepseek)
+                                      # 且 include_rank_timeline 为 false
+                                    # 则
+                                      # GitHub Action 部署默认推送约 20 次（每小时推送一次）， 约 0.1 元/天
+                                      # Docker 部署默认推送 48 次(每半小时推送一次)， 约 0.2 元/天
+
+  include_rss: false                 # 是否包含 RSS 内容进行分析
+
+  include_rank_timeline: true      # 是否传递完整排名时间线
+                                    # false: 使用简化格式（排名范围+时间范围+出现次数）
+                                    # true: 传递完整排名变化轨迹（如 1(09:30)→2(10:00)→0(11:00)）
+                                    # 启用后 AI 能更精确分析热度趋势，但会额外增加 token 消耗（0.5 倍到 1 倍）
+
 
 # ===============================================================
-# 8. 高级设置（一般无需修改）
+# 10. AI 翻译功能
+#
+# 对推送内容进行多语言翻译，不包含 ai_analysis 分析的内容 
+# 模型配置见上方 ai 配置段
+# ===============================================================
+ai_translation:
+  enabled: false                    # 是否启用翻译功能
+
+  # 翻译目标语言
+  # 格式：自然语言描述
+  # 示例: "Chinese", "Korean", "法语"
+  language: "English"
+
+  # 提示词配置文件路径（相对于 config 目录）
+  prompt_file: "ai_translation_prompt.txt"
+
+
+# ===============================================================
+# 11. 高级设置（一般无需修改）
 # ===============================================================
 advanced:
   # 调试模式
@@ -326,9 +438,8 @@ advanced:
   version_check_url: "https://raw.githubusercontent.com/sansan0/TrendRadar/refs/heads/master/version"
   mcp_version_check_url: "https://raw.githubusercontent.com/sansan0/TrendRadar/refs/heads/master/version_mcp"
 
-  # 爬虫设置
+  # 热榜爬虫技术参数
   crawler:
-    enabled: true                     # 是否启用爬取新闻功能
     request_interval: 2000            # 请求间隔（毫秒）
     use_proxy: false                  # 是否启用代理
     default_proxy: "http://127.0.0.1:10801"
@@ -339,7 +450,6 @@ advanced:
     timeout: 15                       # 请求超时（秒）
     use_proxy: false                  # 是否使用代理
     proxy_url: ""                     # RSS 专属代理（留空则使用 crawler.default_proxy）
-    notification_enabled: true        # 是否启用 RSS 通知推送
 
   # 排序权重（用于重新排序不同平台的热搜）
   # 合起来等于 1

apps/trendradar/5.2.0/config/frequency_words.txt

@@ -1,6 +1,7 @@
 # ═══════════════════════════════════════════════════════════════
 #                    TrendRadar 频率词配置文件
 # ═══════════════════════════════════════════════════════════════
+# 凡是左侧有 # 的都是仅供阅读的说明性文字
 #
 # 这个文件用来设置你想关注的新闻关键词。
 # 系统会自动抓取包含这些关键词的热榜新闻推送给你。