{"id":42436137,"url":"https://github.com/xiongsircool/aurora-rss-reader","last_synced_at":"2026-04-01T19:30:29.051Z","repository":{"id":324026976,"uuid":"1095588377","full_name":"xiongsircool/aurora-rss-reader","owner":"xiongsircool","description":" Aurora RSS Reader - AI 增强的跨平台桌面 RSS 阅读器，支持多语言翻译、智能摘要和现代化阅读体验.","archived":false,"fork":false,"pushed_at":"2026-03-20T09:55:01.000Z","size":56841,"stargazers_count":76,"open_issues_count":3,"forks_count":4,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-03-20T21:12:59.110Z","etag":null,"topics":["ai","summary","translation"],"latest_commit_sha":null,"homepage":"https://rss.526339.xyz","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/xiongsircool.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2025-11-13T08:52:53.000Z","updated_at":"2026-03-20T09:55:06.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/xiongsircool/aurora-rss-reader","commit_stats":null,"previous_names":["xiongsircool/aurora-rss-reader"],"tags_count":10,"template":false,"template_full_name":null,"purl":"pkg:github/xiongsircool/aurora-rss-reader","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiongsircool%2Faurora-rss-reader","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiongsircool%2Faurora-rss-reader/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiongsircool%2Faurora-rss-reader/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiongsircool%2Faurora-rss-reader/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/xiongsircool","download_url":"https://codeload.github.com/xiongsircool/aurora-rss-reader/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/xiongsircool%2Faurora-rss-reader/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31291143,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T13:12:26.723Z","status":"ssl_error","status_checked_at":"2026-04-01T13:12:25.102Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","summary","translation"],"created_at":"2026-01-28T05:37:04.720Z","updated_at":"2026-04-01T19:30:29.043Z","avatar_url":"https://github.com/xiongsircool.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aurora RSS Reader\n\n![Banner](images/banner_sharp_aurora.png)\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/xiongsircool/aurora-rss-reader\"\u003e\n    \u003cimg alt=\"GitHub stars\" src=\"https://img.shields.io/github/stars/xiongsircool/aurora-rss-reader?style=social\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/xiongsircool/aurora-rss-reader\"\u003e\n    \u003cimg alt=\"GitHub forks\" src=\"https://img.shields.io/github/forks/xiongsircool/aurora-rss-reader?style=social\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/xiongsircool/aurora-rss-reader/issues\"\u003e\n    \u003cimg alt=\"GitHub issues\" src=\"https://img.shields.io/github/issues/xiongsircool/aurora-rss-reader\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/xiongsircool/aurora-rss-reader/blob/main/LICENSE\"\u003e\n    \u003cimg alt=\"License: GPL v3\" src=\"https://img.shields.io/badge/License-GPLv3-blue.svg\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"README_ZH.md\"\u003e🇨🇳 中文\u003c/a\u003e • \u003ca href=\"README.md\"\u003e🇺🇸 English\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg alt=\"Aurora RSS Reader\" src=\"images/带版本号和软件名图标.png\" height=\"120\" /\u003e\n\u003c/div\u003e\n\n## 🎉 v0.1.9 Latest Release | 最新版本\n\n**Background Summary Queue, Modernized MCP \u0026 Deployment Polish | 后台摘要队列、MCP 现代化与部署完善**\n\n- 🤖 **Background Summary Queue** - Unread articles can now enter a saved local summary queue and reuse generated summaries after restart\n- 📊 **Runtime Status Panel** - Added live queue status in settings so you can inspect queued, running, succeeded and failed summary jobs\n- 🔌 **Modernized MCP Surface** - Reworked MCP into split resource tools, added AI/tag/digest workflows, and moved MCP into its own settings section\n- 📚 **MCP Usability Upgrade** - Recommended tools are grouped, legacy aliases are marked for removal, and search now supports cursor pagination\n- 🕒 **Time Semantics Aligned** - MCP list/search defaults now follow the app's current `date_range + time_field` settings\n- 🐳 **Docker Backend Port Exposure** - Local Docker deployment now exposes the backend directly on `15432`, including `/api` and `/mcp`\n\n---\n\n## Introduction\n\nAurora RSS Reader is a cross-platform desktop RSS reader integrated with AI translation and summarization features. It supports multiple layout modes, local data storage, and rich customization options.\n\n**Current Version: v0.1.9**\n\n## Key Features\n\n### Reading Experience\n- **Multiple Layout Modes** - Support for three-column and single-column layouts\n- **Group Management** - Organize RSS feeds by categories\n- **Full-text Search** - Quick search in titles and content\n- **Favorites Feature** - Bookmark important articles for later reading\n- **Time Filtering** - Filter articles by publication date\n\n### Smart Features\n- **Article Summaries** - Automatically generate key points for quick understanding\n- **Multi-language Translation** - Support full-text and title translation for barrier-free reading\n- **Multi-language Interface** - Chinese, English, Japanese, Korean interface support\n- **Flexible Configuration** - Support multiple translation and summarization services\n\n### System Features\n- **Local Storage** - SQLite database, offline available\n- **OPML Import/Export** - Easy data migration\n- **Auto Refresh** - Periodically fetch latest articles\n- **Dark Mode** - Support dark and light themes\n- **RSSHub Support** - Extend RSS feed coverage\n\n## Interface Preview\n\n### Current UI Highlights\n\u003cdiv align=\"center\"\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;vertical-align:bottom;\"\u003e\n    \u003cimg src=\"images/v.0.1.9/MCP功能升级.png\" alt=\"Dedicated MCP settings\" style=\"width:440px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eDedicated MCP Settings\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;vertical-align:bottom;\"\u003e\n    \u003cimg src=\"images/v.0.1.9/增加支持后台summary.png\" alt=\"Background summary queue\" style=\"width:440px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eBackground Summary Queue\u003c/figcaption\u003e\n  \u003c/figure\u003e\n\u003c/div\u003e\n\n\u003cdiv align=\"center\"\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;vertical-align:bottom;\"\u003e\n    \u003cimg src=\"images/v.0.1.9/支持单个订阅和分组的日报功能.png\" alt=\"Scope summary and digest\" style=\"width:280px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eScope Summary \u0026 Digest\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;vertical-align:bottom;\"\u003e\n    \u003cimg src=\"images/v.0.1.9/增加rsshub预选.png\" alt=\"RSSHub preset selection\" style=\"width:280px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eRSSHub Preset Selection\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;vertical-align:bottom;\"\u003e\n    \u003cimg src=\"images/v.0.1.9/AI摘要支持makedown渲染.png\" alt=\"Markdown summary rendering\" style=\"width:280px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eMarkdown Summary Rendering\u003c/figcaption\u003e\n  \u003c/figure\u003e\n\u003c/div\u003e\n\n### Media Feed Support\n\u003cdiv align=\"center\"\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;vertical-align:bottom;\"\u003e\n    \u003cimg src=\"images/v0.1.6/视频订阅显示增强.png\" alt=\"Video feed display\" style=\"width:440px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eVideo Feed Display\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;vertical-align:bottom;\"\u003e\n    \u003cimg src=\"images/v0.1.6/图像订阅显示增强.png\" alt=\"Image feed display\" style=\"width:440px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eImage Feed Display\u003c/figcaption\u003e\n  \u003c/figure\u003e\n\u003c/div\u003e\n\n### Blog \u0026 Article Enhancement\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"images/v0.1.6/博客订阅增强.png\" alt=\"Blog feed enhancement\" style=\"width:88%;max-width:980px;border-radius:14px;box-shadow:0 6px 28px rgba(15,17,21,.18);\" /\u003e\n\u003c/div\u003e\n\n### Context Menu \u0026 Collections\n\u003cdiv align=\"center\"\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;\"\u003e\n    \u003cimg src=\"images/v0.1.6/右键功能增强feeds.png\" alt=\"Feed context menu\" style=\"width:320px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eFeed Context Menu\u003c/figcaption\u003e\n  \u003c/figure\u003e\n  \u003cfigure style=\"display:inline-block;margin:0 12px 18px;text-align:center;\"\u003e\n    \u003cimg src=\"images/v0.1.6/右键将订阅记录添加到书签组.png\" alt=\"Add to collection\" style=\"width:320px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n    \u003cfigcaption\u003eAdd to Collection\u003c/figcaption\u003e\n  \u003c/figure\u003e\n\u003c/div\u003e\n\n### MCP Status Display\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"images/v0.1.6/MCP服务显性检测.png\" alt=\"MCP status indicator\" style=\"width:320px;border-radius:12px;box-shadow:0 6px 24px rgba(15,17,21,.18);\" /\u003e\n\u003c/div\u003e\n\n### Zotero Integration\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"images/v0.1.6/发送到zotero支持.png\" alt=\"Send to Zotero\" style=\"width:88%;max-width:980px;border-radius:14px;box-shadow:0 6px 28px rgba(15,17,21,.18);\" /\u003e\n\u003c/div\u003e\n\n### Workspace Advanced Search\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"images/v0.1.6/工作区域高级检索标签组.png\" alt=\"Workspace advanced search\" style=\"width:88%;max-width:980px;border-radius:14px;box-shadow:0 6px 28px rgba(15,17,21,.18);\" /\u003e\n\u003c/div\u003e\n\n## Quick Start\n\n### System Requirements\n- Node.js 22\n- pnpm 8+\n\n### Installation and Running\n```bash\n# Clone the repository\ngit clone https://github.com/xiongsircool/aurora-rss-reader.git\ncd aurora-rss-reader\n\n# Recommended: Node.js backend\ncd backend-node\nnpm install\ncd ../rss-desktop\npnpm install\npnpm dev\n\n# Quick start (Node.js backend)\ncd ..\nchmod +x start.sh\n./start.sh\n```\n\n### Development Setup (Manual)\nRecommended (backend-node):\n- `cd backend-node \u0026\u0026 npm install`\n- `cd rss-desktop \u0026\u0026 pnpm install`\n- `pnpm dev` (from `rss-desktop`)\n\n### Troubleshooting\n### macOS Compatibility\n**Initial Setup:**\n1. **Download the `.zip` version** if the `.dmg` fails to mount (common on some systems for unsigned apps).\n2. Unzip and drag `Aurora RSS Reader.app` to your Applications folder.\n3. If you see **\"App is damaged and can't be opened\"** (or \"cannot open\"):\n   - This is normal for unsigned open-source apps on macOS.\n   - Open Terminal and run:\n     ```bash\n     sudo xattr -rd com.apple.quarantine /Applications/AuroraRSSReader.app\n     ```\n   - Then open the app again.\n\n**Update Limitation:**\n1. The current macOS build is still distributed as an unsigned app.\n2. Built-in version checking can work, but automatic in-place installation through ShipIt may fail signature validation.\n3. For macOS users, the recommended update path is still to download the latest `.dmg` or `.zip` from GitHub Releases manually.\n\n### Performance\n**Q: The app is slow to start?**\nA: Check the backend service logs if possible. First launch may take longer to initialize the database.\n- Initialize database\n- Launch Electron application\n\n### Access URLs\n- **Desktop App**: Electron window opens automatically\n- **Web Interface**: http://localhost:5173\n- **API Service**: http://127.0.0.1:15432\n\n### Configuration\nSet environment variables for the Node.js backend to configure AI and RSSHub:\n\n```env\n# RSSHub\nRSSHUB_BASE_URL=https://rsshub.app\n\n# AI Configuration\nGLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4/\nGLM_MODEL=glm-4-flash\nGLM_API_KEY=your_api_key_here\n```\n\n## 🐳 Docker Deployment\n\n```bash\n# Quick start with Docker Compose\ngit clone https://github.com/xiongsircool/aurora-rss-reader.git\ncd aurora-rss-reader\ndocker-compose up -d\n\n# Access Web UI: http://localhost:8080\n# Access Backend API: http://localhost:15432/api\n# Access MCP Endpoint: http://localhost:15432/mcp\n```\n\nFor detailed Docker configuration, see [Docker README](docker/README.md).\n\n\u003e **Note**: Docker image only supports `linux/amd64` architecture.\n\n## Build and Release\n\n```bash\n# Build installation package\nchmod +x build-release-app.sh\n./build-release-app.sh\n```\n\nGenerated files:\n- macOS: `AuroraRSSReader-Mac-0.1.9.dmg`\n- Windows: `AuroraRSSReader-Windows-0.1.9-x64-Setup.exe`\n- Linux: `AuroraRSSReader-Linux-0.1.9-x64.AppImage`\n\n### Public Packaging Notes\n- Bump `rss-desktop/package.json` to the target release version before any public packaging or tagging.\n- Run the packaging preflight on `main` first with `workflow_dispatch`; this validates the build without creating a GitHub Release.\n- Only create the public tag after macOS, Windows, and Linux builds all pass.\n- Use a fresh tag such as `v0.1.9`; do not reuse an occupied release tag like `v0.1.8`.\n- Auto-update continues to work only after the public GitHub Release is created with installers and `latest*.yml`.\n- For the current unsigned macOS build, in-app version checking is available, but users should still update via GitHub Releases manually.\n\n## 📋 Documentation | 文档\n\n- **[Chinese Version](README_ZH.md)** - Complete documentation in Chinese | 中文完整文档\n\n## Tech Stack\n\n- **Frontend**: Vue 3 + Vite + Pinia + TypeScript\n- **Backend**: Fastify + TypeScript + SQLite\n- **Desktop App**: Electron\n- **Build Tools**: electron-builder\n\n## Project Structure\n\n```\naurora-rss-reader/\n├── rss-desktop/          # Frontend code\n│   ├── src/             # Vue source code\n│   └── electron/        # Electron main process\n├── backend-node/        # Node.js backend (Fastify)\n├── images/              # Image resources\n└── start.sh            # Startup script\n```\n\n## Support\n\n- **Issue Reporting**: [GitHub Issues](https://github.com/xiongsircool/aurora-rss-reader/issues)\n- **Feature Suggestions**: [GitHub Discussions](https://github.com/xiongsircool/aurora-rss-reader/discussions)\n- **Email Contact**: 1666526339@qq.com\n\n## License\n\nThis project uses [GNU General Public License v3.0](LICENSE), which is a copyleft open source license requiring derivative works to also be open source.\n\n---\n\n## 🎯 Future Roadmap\n\n### Short-term Plans (v0.2)\n- [x] **AI Daily Briefing / Scope Summary** - Tag digest, feed/group scope summaries, automation and rerun flows are already available ✅\n- [x] **Podcast Support** - Support for audio podcast subscription and playback ✅\n- [ ] **Reading Analytics** - Personal reading habits analysis and data visualization\n- [x] **RSSHub Support** - RSSHub URL configuration, mirror switching and RSSHub feed access are already supported ✅\n- [ ] **Browser Extension** - Use AI to analyze sites and generate RSSHub subscription rules\n\n### Mid-term Plans (v0.3)\n- [ ] **Data Synchronization** - Cross-device data sync and cloud backup\n- [ ] **Plugin System** - Support for third-party plugin extensions\n\n---\n\nGive it a ⭐ if you find it useful!\n## Changelog\n\n### v0.1.9 (Current Version)\n**Background Summary Queue + MCP Modernization + Docker Access**\n\n- Background summary queue can persist generated summaries locally and reuse them after restart\n- Added queue runtime status panel in settings for live inspection of summary jobs\n- MCP moved out of AI provider config into a dedicated settings section\n- MCP tool surface modernized with grouped recommended tools, deprecation hints and cursor-based search pagination\n- MCP time defaults now follow the app's current date range and time field settings\n- Docker deployment now exposes the backend directly on `15432` for local `/api` and `/mcp` access\n\n### v0.1.8 (Previous Version)\n**Published release baseline before the current packaging cycle**\n\n### v0.1.7\n**Digest Intelligence, Tag Workflow Polish \u0026 Update Experience**\n\n- Digest 2.0 with history, manual regenerate and locale-aligned language\n- Latest + Week digest modes\n- Analyze-all full pagination fix\n- Summary prompting quality upgrade\n- Manual update-check entry in settings\n\n## Star History\n\n[![Star History Chart](https://api.star-history.com/svg?repos=xiongsircool/aurora-rss-reader\u0026type=Date)](https://www.star-history.com/#xiongsircool/aurora-rss-reader\u0026Date)\n\n## Community\n\nIf you want to discuss product ideas, report usage feedback, or join the user community, you can scan the QQ code below.\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"images/二维码/QQ537546690.jpeg\" alt=\"Aurora RSS Reader QQ community\" width=\"260\" /\u003e\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiongsircool%2Faurora-rss-reader","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fxiongsircool%2Faurora-rss-reader","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fxiongsircool%2Faurora-rss-reader/lists"}