✨ 功能改进
- 修复配置保存问题(移除 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(永久性错误不重试)
-
下载插件
- 下载 TranslateDigest 文件夹
- 移动该文件夹到/FreshRSS/extensions 文件夹
-
启用插件
- 登录 FreshRSS
- 进入 设置 → 扩展
- 找到 TranslateDigest 并点击启用
在 FreshRSS 扩展管理页面找到 TranslateDigest 并点击配置。
-
Google 翻译(默认)
- 无需 API Key
- 仅支持标题翻译
- 完全免费
-
DeepSeek / 通义千问 / Gemini(使用摘要功能时请注意 token 消耗)
- 需要申请并填写 API Key
- 支持标题翻译和内容摘要
- 支持自定义模型(如
deepseek-chat,qwen-plus,gemini-2.0-flash-exp)
| 选项 | 说明 |
|---|---|
| 目标语言 | 选择翻译目标语言(默认:中文) |
| 同语言跳过 | 自动检测并跳过已是目标语言的文章,节省资源 |
| 最大字符数 | 限制发送给 AI 的文本长度(建议 3000-5000) |
在配置页面底部的订阅源列表中:
- ✅ 翻译标题:勾选后自动翻译该订阅源的标题
- ✅ 生成摘要:勾选后为文章生成 AI 摘要
💡 提示:建议仅对重要的或外语订阅源开启,以节省 API 调用
⚠️ 警告:慎用内容摘要功能,该功能会消耗大量 Token,可能产生较高的 API 调用费用。
配置完成后,插件会自动运行:
- FreshRSS 抓取新文章时,插件自动处理
- 在文章列表查看翻译后的标题
- 打开文章详情查看 AI 生成的摘要(显示在文章开头)
docker compose logs -f
配置页面提供详细的诊断信息帮助排查问题:
- 保存配置时:自动验证每个 API Key 的有效性
- 验证结果显示:
- ✓ VALID:Key 有效,可正常使用
- ✗ INVALID:Key 格式错误或已过期,显示具体错误信息
- ✗ ERROR:验证过程中发生异常,显示错误详情
- EMPTY:未设置 API Key
- SKIPPED:提供的 Key 为空
- 翻译出错自动 Fallback:当首选服务失败时,自动尝试 Google 翻译
- 摘要多级兜底:
- 尝试首选服务(DeepSeek/Qwen/Gemini)
- 失败 → 尝试 Google 智能截断
- 仍失败 → 最终简单截断(保证摘要可用)
- API 成本:AI 调用会产生调用费用,请查看对应服务商的费率
- 处理时间:AI 摘要功能会增加少量抓取时间
- 依赖环境:需要 PHP mbstring 扩展(一般已默认安装)
本项目受到 FreshRSS-TranslateTitlesCN 的启发,感谢 @jacob2826
✨ 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)
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.
-
🌍 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)
-
Download the Extension
- Download the TranslateDigest folder
- Move the folder to
/FreshRSS/extensionsfolder
-
Enable the Extension
- Log into FreshRSS
- Navigate to Settings → Extensions
- Find TranslateDigest and enable it
Go to the FreshRSS extension management page and click configure for TranslateDigest.
-
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)
| 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) |
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.
After configuration, the extension runs automatically:
- When FreshRSS fetches new articles, the plugin processes them
- View translated titles in the article list
- Open article details to see AI-generated summaries (displayed at the beginning)
docker compose logs -f
The configuration page provides detailed diagnostic information to troubleshoot issues:
- 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
- Translation Error Auto-Fallback: When primary service fails, automatically try Google Translate
- Multi-level Summarization Fallback:
- Try primary service (DeepSeek/Qwen/Gemini)
- Failure → Try Google intelligent truncation
- Still failure → Final simple truncation (ensure summary availability)
- 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)
This project is inspired by FreshRSS-TranslateTitlesCN. Thanks to @jacob2826
For issues or suggestions, please submit an Issue