Skip to content

About

TranslateDigest is a powerful FreshRSS extension designed to enhance your RSS reading experience through AI technology. It can automatically translate article titles and generate summaries

Resources

Stars

12 stars

Watchers

0 watching

Forks

Latest commit

 

History

28 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 

Repository files navigation

TranslateDigest

中文 | English


中文

📋 更新日志

2025-12-04

✨ 功能改进

  • 修复配置保存问题(移除 initializeDefaultConfig 导致的冲突)
  • 改进摘要服务的 Fallback 策略(支持多级兜底)
  • 增强 Google Provider 的摘要能力(智能在句末截断)
  • 优化 API Key 验证日志(显示具体验证结果)

🔧 技术优化

  • 添加错误分类机制(避免浪费 Token 重试永久性错误)
  • 实现完整的 Fallback 链(翻译和摘要都有兜底方案)
  • 改进 TextUtil 文本处理(HTML 实体解码、标点空格修复)

📖 简介

TranslateDigest 是一个功能强大的 FreshRSS 扩展插件,旨在通过 AI 技术提升您的 RSS 阅读体验。它能够自动翻译订阅源的文章标题以及生成摘要

✨ 核心功能

  • 🌍 多语言标题翻译
    支持自动翻译文章标题为中文、英文、日文、法文或德文

  • 🤖 AI 智能摘要
    集成 DeepSeek、通义千问(Qwen)以及 Gemini 对文章进行摘要(抓取内容不全面仅作速览使用)

  • ⚙️ 灵活的订阅源管理
    支持按订阅源粒度控制,可为特定 Feed 单独开启翻译或摘要功能

  • 🔌 多服务提供商支持

    • Google 翻译:免费、快速,适用于基础标题翻译
    • DeepSeek:强大的 AI 模型,支持翻译和摘要
    • 通义千问:阿里云 AI 服务,支持翻译和摘要
    • Google Gemini:Google 最新 AI 模型,支持翻译和摘要(免费)
  • 🛡️ 智能容错机制

    • API 失败自动 Fallback 到 Google 服务
    • 摘要功能永不失败(多级兜底策略)
    • 智能错误分类,避免浪费 Token(永久性错误不重试)

📦 安装

  1. 下载插件

    • 下载 TranslateDigest 文件夹
    • 移动该文件夹到/FreshRSS/extensions 文件夹
  2. 启用插件

    • 登录 FreshRSS
    • 进入 设置 → 扩展
    • 找到 TranslateDigest 并点击启用

⚙️ 配置

在 FreshRSS 扩展管理页面找到 TranslateDigest 并点击配置。

1️⃣ 选择翻译服务

  • Google 翻译(默认)

    • 无需 API Key
    • 仅支持标题翻译
    • 完全免费
  • DeepSeek / 通义千问 / Gemini(使用摘要功能时请注意 token 消耗)

    • 需要申请并填写 API Key
    • 支持标题翻译和内容摘要
    • 支持自定义模型(如 deepseek-chat, qwen-plus, gemini-2.0-flash-exp)

2️⃣ 通用设置

选项 说明
目标语言 选择翻译目标语言(默认:中文)
同语言跳过 自动检测并跳过已是目标语言的文章,节省资源
最大字符数 限制发送给 AI 的文本长度(建议 3000-5000)

3️⃣ 订阅源设置

在配置页面底部的订阅源列表中:

  • ✅ 翻译标题:勾选后自动翻译该订阅源的标题
  • ✅ 生成摘要:勾选后为文章生成 AI 摘要

💡 提示:建议仅对重要的或外语订阅源开启,以节省 API 调用 ⚠️ 警告:慎用内容摘要功能,该功能会消耗大量 Token,可能产生较高的 API 调用费用。

🚀 使用

配置完成后,插件会自动运行:

  1. FreshRSS 抓取新文章时,插件自动处理
  2. 在文章列表查看翻译后的标题
  3. 打开文章详情查看 AI 生成的摘要(显示在文章开头)

🔍 诊断日志

使用 docker compose 命令查看动态日志

docker compose logs -f

配置页面提供详细的诊断信息帮助排查问题:

API Key 状态验证

  • 保存配置时:自动验证每个 API Key 的有效性
  • 验证结果显示:
    • ✓ VALID:Key 有效,可正常使用
    • ✗ INVALID:Key 格式错误或已过期,显示具体错误信息
    • ✗ ERROR:验证过程中发生异常,显示错误详情
    • EMPTY:未设置 API Key
    • SKIPPED:提供的 Key 为空

智能容错信息

  • 翻译出错自动 Fallback:当首选服务失败时,自动尝试 Google 翻译
  • 摘要多级兜底:
    1. 尝试首选服务(DeepSeek/Qwen/Gemini)
    2. 失败 → 尝试 Google 智能截断
    3. 仍失败 → 最终简单截断(保证摘要可用)

⚠️ 注意事项

  • API 成本:AI 调用会产生调用费用,请查看对应服务商的费率
  • 处理时间:AI 摘要功能会增加少量抓取时间
  • 依赖环境:需要 PHP mbstring 扩展(一般已默认安装)

🙏 致谢

本项目受到 FreshRSS-TranslateTitlesCN 的启发,感谢 @jacob2826

📝 许可证

MIT License


English

📋 Changelog

2025-12-04

✨ Feature Improvements

  • Fix configuration saving issue (removed initializeDefaultConfig conflict)
  • Enhanced summary service fallback strategy (supports multi-level fallback)
  • Improved Google Provider summary capability (intelligent truncation at sentence end)
  • Optimized API Key validation logs (show specific validation results)

🔧 Technical Optimizations

  • Added error classification mechanism (avoid wasting tokens retrying permanent errors)
  • Implemented complete fallback chain (both translation and summary have fallback solutions)
  • Improved TextUtil text processing (HTML entity decoding, punctuation space repair)

📖 Introduction

TranslateDigest is a powerful FreshRSS extension designed to enhance your RSS reading experience through AI technology. It can automatically translate article titles and generate summaries.

✨ Key Features

  • 🌍 Multi-language Title Translation
    Automatically translate article titles to Chinese, English, Japanese, French, or German

  • 🤖 AI-Powered Summaries
    Integrates DeepSeek, Qwen, and Gemini to summarize articles (crawled content may be incomplete, for quick overview only)

  • ⚙️ Flexible Feed Management
    Granular control per feed - enable translation or summarization for specific feeds

  • 🔌 Multiple Service Providers

    • Google Translate: Free, fast, suitable for basic title translation
    • DeepSeek: Powerful AI model supporting both translation and summarization
    • Qwen (Tongyi Qianwen): Alibaba Cloud AI service with translation and summary capabilities
    • Google Gemini: Google's latest AI model with translation and summary features (Free)
  • 🛡️ Intelligent Fault Tolerance

    • Automatic Fallback to Google service on API failure
    • Summarization never fails (multi-level fallback strategy)
    • Smart error classification to avoid wasting tokens (permanent errors not retried)

📦 Installation

  1. Download the Extension

    • Download the TranslateDigest folder
    • Move the folder to /FreshRSS/extensions folder
  2. Enable the Extension

    • Log into FreshRSS
    • Navigate to Settings → Extensions
    • Find TranslateDigest and enable it

⚙️ Configuration

Go to the FreshRSS extension management page and click configure for TranslateDigest.

1️⃣ Choose Translation Service

  • Google Translate (Default)

    • No API Key required
    • Title translation only
    • Completely free
  • DeepSeek / Qwen / Gemini (Please note token consumption when using summary function)

    • Requires API Key
    • Supports both translation and summarization
    • Customizable models (e.g., deepseek-chat, qwen-plus, gemini-2.0-flash-exp)

2️⃣ General Settings

Option Description
Target Language Choose translation target language (default: Chinese)
Skip Same Language Auto-detect and skip articles already in target language
Max Characters Limit text length sent to AI (recommended: 3000-5000)

3️⃣ Feed Settings

In the feed list at the bottom of the configuration page:

  • ✅ Translate Title: Auto-translate titles for this feed
  • ✅ Generate Summary: Generate AI summaries for articles

💡 Tip: Enable only for important or foreign-language feeds to save API calls ⚠️ Warning: Use the content summary feature with caution as it consumes a large number of tokens and may result in high API call costs.

🚀 Usage

After configuration, the extension runs automatically:

  1. When FreshRSS fetches new articles, the plugin processes them
  2. View translated titles in the article list
  3. Open article details to see AI-generated summaries (displayed at the beginning)

🔍 Diagnostic Logs

View Real-time Logs with Docker Compose Command

docker compose logs -f

The configuration page provides detailed diagnostic information to troubleshoot issues:

API Key Status Verification

  • On Configuration Save: Automatically validate each API Key
  • Validation Result Display:
    • ✓ VALID: Key is valid and ready to use
    • ✗ INVALID: Key format error or expired, with specific error message
    • ✗ ERROR: Exception during validation, with error details
    • EMPTY: API Key not set
    • SKIPPED: Provided Key is empty

Intelligent Fault Tolerance Information

  • Translation Error Auto-Fallback: When primary service fails, automatically try Google Translate
  • Multi-level Summarization Fallback:
    1. Try primary service (DeepSeek/Qwen/Gemini)
    2. Failure → Try Google intelligent truncation
    3. Still failure → Final simple truncation (ensure summary availability)

⚠️ Notes

  • API Costs: DeepSeek and Qwen services incur usage fees - check provider pricing
  • Processing Time: AI summary feature adds slight delay to feed fetching
  • Requirements: Requires PHP mbstring extension (usually pre-installed)

🙏 Acknowledgments

This project is inspired by FreshRSS-TranslateTitlesCN. Thanks to @jacob2826

📝 License

MIT License

For issues or suggestions, please submit an Issue

About

TranslateDigest is a powerful FreshRSS extension designed to enhance your RSS reading experience through AI technology. It can automatically translate article titles and generate summaries

Resources

Stars

12 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages