简体中文 | English

# RSSFlow > Local-first AI RSS reader for Chrome / Edge > Subscribe, read, summarize, chat, graph, schedule briefings, and push — data stays on your machine by default.

Chrome Chrome Web Store  ·  Edge Edge Add-ons  ·  Site Website

MV3 React Rspack SQLite AI SDK

Changelog · Product changelog · Help · Report demo blog.oinchain.com · Privacy

--- ## What this repository is **RSSFlow-doc** is the product website, help center, and public release-notes repo. It is **not** the extension install-package repository. | Path | Role | | --- | --- | | `website/` | Site source (Next.js static export) | | `help/` | Help markdown sources | | `docs/` | Built static site (e.g. Cloudflare Pages) | | [CHANGELOG.md](./CHANGELOG.md) | Full release history (mirrors the site) | Install the extension from the store links above. Current public version: **v1.1.5** (2026-08-10). --- ## Product overview RSSFlow runs as a browser **sidebar** (not a tiny popup): manage feeds, scan unread, open immersive reading, and jump to full-screen Flow / Graph / Discovery / Chat. A typical path: 1. **Subscribe & store locally** 2. **Optional AI pre-read** (summary, tags, scores in the background) 3. **Read & chat** with citations 4. **Discovery & graph** 5. **Scheduled workflows & push** (briefings, Telegram / Feishu, report publish) 6. **Optional MCP** so external tools can use local reading context AI uses **your own API keys**. Without keys, it still works as a normal RSS reader. Chapter-level docs: https://rssflow.oinchain.com/help --- ## Features ### 1. Feeds & subscription management - **Add feeds via** - Manual RSS URL - OPML / XML import - One-click import from companion [SnagFlow](https://snagflow.oinchain.com) (extension messaging, no external hop) - Recommended catalogs by language/topic (including Japanese / Korean) - **Per-feed controls** - **Auto AI** toggle for automatic summaries - Failure / error indicators - Delete removes the feed and its history - **Why auto-summary helps** Structured points, tags, and scores feed Flow filters, graph, workflows, and citation chat. Sending raw full text into heavy jobs hits length limits faster and loses detail. Help: [Adding feeds](https://rssflow.oinchain.com/help/adding-feeds) · [Feed management](https://rssflow.oinchain.com/help/feed-management) · [SnagFlow](https://rssflow.oinchain.com/help/snagflow-overview) ### 2. Sidebar, Flow, and Zen Reader **Sidebar tabs** | Tab | Role | | --- | --- | | Inbox | Default unread list, infinite scroll, toolbar badge | | Favorites | Bookmarks | | Graph | Opens knowledge graph in a **new tab** | | Flow | Opens Flow (by day / by tag) in a **new tab** | **Interaction** - Single-click card → Zen Reader - Double-click → mark read (optional wooden-bell sound) and collapse - Standard / Mini density for scanning - Cards prefer AI summary; hover shows bullet points **Flow** - **Dayflow**: date → tags, including “last 24 hours” - **Tagflow**: tag-first grouping - Dot rail jumps groups; per-group AI chat - Bottom ticker can scroll / speak summaries (one audio owner across tabs) - Multi-column layout; scroll path pauses idle prefetch / optimistic merge to reduce viewport jumps (v1.1.5) **Zen Reader** - Full-screen article + AI rail (summary, bullets, tags, score) - Dark starfield / light theme; narrow viewports use a bottom AI drawer - Shortcuts: `J`/`K` next/prev, `Space` page, `F` favorite, `R` read+next, `Enter`/`S` summary, `Esc` close - Prefetches neighbors while you move through the list Help: [Interface](https://rssflow.oinchain.com/help/interface-guide) · [Flow](https://rssflow.oinchain.com/help/flow-view) · [Zen Reader](https://rssflow.oinchain.com/help/zen-reader) · [Shortcuts](https://rssflow.oinchain.com/help/reader-shortcuts) ### 3. AI auto-summary - New articles can enqueue for background processing with spacing between jobs - Writes summary, points, tags, scores locally; cards refresh when ready - **Dual profiles** (Settings → AI) - **Basic**: light work (summary, scoring, tags) - **Advanced** (optional): chat, workflows, discovery; copy-from-basic supported - Providers include DeepSeek, OpenAI, OpenAI-compatible, Anthropic, Gemini, local compatible hosts, … - Turn on **Enable AI Features**, validate, and set the active profile Help: [AI keys](https://rssflow.oinchain.com/help/ai-key-config) · [Auto-summary](https://rssflow.oinchain.com/help/ai-auto-summary) · [Providers](https://rssflow.oinchain.com/help/provider-config) ### 4. Chat & expert commands - **Entry points** - Sidebar **AI Chat** (new tab) - Flow group chat (uses that date/tag group as context) - Graph page and Discovery can continue into chat from results - Ask over filtered article sets (date, tags, feeds, …) - Answers carry **citation chips**: hover for title/summary, click to jump to the source passage - **Expert commands**: **23** built-in analysis roles (research, macro, risk, writing, crypto, daily pulse, …); same capability surface as “AI Commands”, plus custom prompts - V3 chat: SmartInput, command palette, session handling; clearing a session aborts in-flight generation and resets filter residue (v1.1.5) - Shared **search kernel** with discovery / automation; keyword normalization and unread integrity improved Help: [Citation chat](https://rssflow.oinchain.com/help/ai-chat-citation) · [Expert commands](https://rssflow.oinchain.com/help/expert-commands) · [Commands](https://rssflow.oinchain.com/help/ai-commands) ### 5. Discovery & knowledge graph **Discovery** - Clusters recent articles into hot topics - Charts + topic briefs (phenomenon → logic → second-order effects, depending on model output) - Optional refresh cadence and browser notifications **Graph** - Tag co-occurrence / entity-keyword visualization - Combinatorial search; results can seed scheduled workflows - Graph prompts and reader-related strings are localized Help: [Discovery](https://rssflow.oinchain.com/help/ai-discovery) · [Graph](https://rssflow.oinchain.com/help/graph-view) ### 6. Scheduled workflows & report publish - **Access:** **Settings → Workflow** - Enable / disable, edit, delete, or **run now**; journal keeps roughly the last 50 runs - Multiple workflows **queue serially** by default to avoid hammering APIs - Pipeline: build context (often existing AI summaries) → run commands → compile a briefing - **Execution modes** - **Single**: one command aggregates many articles (daily roundups) - **Sequential chain**: each step consumes the previous output (extract → rewrite / translate) - **Split-merge**: parallel dimensional analyses, then a final synthesis - **Report publish** (**Publish Settings** above the task list — global channels) 1. **Default (official hosting)** — zero-config, mobile-friendly pages 2. **Custom (self-hosted)** — your URL + security key; optional retention (e.g. ~180 days) 3. **Blog portal (`rssflow_ai_report`)** — push to a standalone site with category / series / author / tag archives - **Public demo (see what published reports look like):** [blog.oinchain.com](https://blog.oinchain.com) - Flow: workflow generates a briefing → extension pushes with site URL + auth token → portal publishes a shareable page - Cross-device reading without opening the extension - Combines with Telegram / Feishu / desktop notifications, tag/date filters, and retry Help: [Workflows](https://rssflow.oinchain.com/help/workflow-overview) · [Execution modes](https://rssflow.oinchain.com/help/execution-modes) · [Publish modes](https://rssflow.oinchain.com/help/report-modes) · [Cloud portal](https://rssflow.oinchain.com/help/cloud-report-portal) ### 7. Multi-channel push - **Access:** **Settings → Notifications** - **Telegram bot** / **Feishu webhook**: master switch + per-type toggles (article summaries, scheduled briefings, discovery alerts, …); both channels can be on together - **Browser notifications** for desktop alerts - Payload is based on already-processed local results; the full library is not bulk-uploaded except to channels you configure Help: [Telegram](https://rssflow.oinchain.com/help/telegram-push) · [Feishu](https://rssflow.oinchain.com/help/feishu-push) ### 8. MCP bridge - Expose local feeds/summaries to tools such as Cursor or Claude via MCP - Companion `rssflow-mcp-bridge` (Cloudflare Workers); extension side handles bridge state and permissions - Useful when reading stays in the browser and analysis moves to an IDE / agent Help: [MCP bridge](https://rssflow.oinchain.com/help/mcp-bridge) ### 9. Settings, languages, theme - Options areas typically include General, Feeds, AI, Notifications, Sync, Automation, Theme, … - **General**: fetch interval, list query window, retention, UI language, sounds - **Languages**: UI and AI output (EN / ZH / JA / KO and more; set may grow) - **Theme**: light / dark / system - **Tag scope**: locale-aware default tag sets with broader coverage (v1.1.5) Help: [General](https://rssflow.oinchain.com/help/general-settings) · [Languages](https://rssflow.oinchain.com/help/supported-languages) · [Tag scope](https://rssflow.oinchain.com/help/tag-scope) · [Theme](https://rssflow.oinchain.com/help/theme) ### 10. Local storage & privacy - Heavier search / stats / graph paths use **SQLite (WASM + OPFS) + db.worker**; settings and some state still use extension storage - Reading library is not uploaded by default; only enabled features (AI APIs, push, publish, MCP, …) go online - See [Privacy policy](https://rssflow.oinchain.com/privacy) and [Privacy help](https://rssflow.oinchain.com/help/privacy-statement) --- ## Architecture (sketch) ```mermaid graph TD subgraph Browser["Browser extension (local)"] UI["UI
Sidebar / Flow / Reader / Chat / Discovery / Graph"] State["Zustand"] BG["Service Worker
fetch · summary queue · workflows · notify"] DB["SQLite WASM + OPFS
+ db.worker"] UI <--> State State <--> DB BG <--> DB BG <--> State end subgraph LLM["Your AI providers (optional)"] AISDK["Vercel AI SDK
DeepSeek / OpenAI / Anthropic / Gemini / compatible / local"] end subgraph CloudOpt["Optional cloud pieces"] Report["rssflow_ai_report
portal · demo blog.oinchain.com"] MCP["rssflow-mcp-bridge
MCP gateway"] end subgraph Push["Optional push"] TG["Telegram"] FS["Feishu"] BN["Browser notifications"] end RSS["RSS / OPML / SnagFlow rules"] --> BG RSS --> UI UI --> AISDK BG --> AISDK BG --> Push BG --> Report MCP <--> BG UI --> User["You"] Push --> User Report --> User ``` **Related projects** (separate; not install packages in this repo) | Project | Role | | --- | --- | | RSSFlow extension | Store-listed reader | | `rssflow_ai_report` | Cloud report portal; public demo [blog.oinchain.com](https://blog.oinchain.com) | | `rssflow-mcp-bridge` | MCP gateway | | SnagFlow | Webpage → RSS companion | --- ## Tech stack (extension, summary) | Layer | Choice | | --- | --- | | Extension | Manifest V3 · Service Worker · Side Panel | | UI | React 18 · Tailwind · Framer Motion, … | | Build | Rspack | | State | Zustand | | Local DB | SQLite WASM + OPFS · background worker | | AI | Vercel AI SDK · multi-provider · precompiled prompts | | Rendering | Streaming markdown · virtualized long lists | This docs site: Next.js static export on Cloudflare Pages (`rssflow.oinchain.com`), etc. --- ## Releases - **30 versions** from `v0.1.0` (2024-12) to `v1.1.5` (2026-08) - [CHANGELOG.md](./CHANGELOG.md) · https://rssflow.oinchain.com/changelog **v1.1.5 highlights** - Unified article search kernel - Keyword normalization & unread / retrieval integrity - Flow scroll stability & session cleanup - JA/KO recommended feeds & catalog refactor - Locale-aware default tag sets --- ## Install 1. Install from [Chrome](https://chromewebstore.google.com/detail/rssflow-ai-powered-rss-in/mefbfkpippglgoanjcbdjnkelcbdjija) or [Edge](https://microsoftedge.microsoft.com/addons/detail/rssflow-aipowered-rss-/khgllclaeabkjgoblcipfpgaejblcelf) (help docs assume store installs) 2. Pin the icon for unread badges 3. Open the **sidebar** 4. Optional: Settings → AI → enable, add key, validate, set active 5. Settings → Feeds: URL / OPML / SnagFlow / recommended Walkthrough: https://rssflow.oinchain.com/help/installation-setup --- ## Develop this website ```bash cd website npm install npm run dev npm run build # → website/out/ npm run generate-help # when regenerating help site content ``` Deploy tree used online is `docs/` at the repo root (e.g. Cloudflare Pages project `rssflow-landing`). --- ## Links | | | | --- | --- | | Website | https://rssflow.oinchain.com | | Help | https://rssflow.oinchain.com/help | | Changelog | [CHANGELOG.md](./CHANGELOG.md) · https://rssflow.oinchain.com/changelog | | **Report portal demo** | **https://blog.oinchain.com** (real pages from workflows → `rssflow_ai_report`) | | SnagFlow | https://snagflow.oinchain.com | | Privacy | https://rssflow.oinchain.com/privacy | Feedback: GitHub Issues or contacts on the site footer. --- ## License Docs and site code follow this repository’s notices. Extension install/use follows Chrome / Edge store terms.