如何本地跑通 AI RSS 阅读器：Folo 完整指南
【免费下载链接】follow🧡 Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/follow
Folo 是一个开源的 AI RSS 阅读器，官方定位是"AI 替你读互联网"。它把来自订阅源、视频、图片、音频的海量内容压进一条无噪音的时间线，再叠加 AI 翻译与摘要能力。它适合两类人：想安静读信息流的读者，以及想二次开发的信息工具作者。下文以仓库源码为准，讲清它的界面、本地开发方式与命令行工具。
Folo 界面：一条时间线装下四类内容
传统 RSS 阅读器把订阅源排成平铺列表，用户得一个个点开。Folo 的设计是"一条时间线"，把所有来源并进同一个连续流，界面支持多种视图，文本、图片、视频、音频都能内联渲染。
AI 能力内置在阅读流里，而不是挂在旁边。翻译和摘要可以直接在阅读页触发，处理长文和技术文档时尤其省事。官方视觉图也点明了产品方向——一个新一代信息浏览器：
值得注意的是，四类内容走的是同一条渲染管线，而不是四套独立模块。这正是它区别于老式 RSS 工具的地方。
Folo 本地开发：4 种环境任选
Folo 是一个 monorepo，用 pnpm workspaces 加 Turbo 管理。apps/下挂了三个应用，packages/下是共享包。仓库根目录的 AGENTS.md 写清了标准开发命令，照做即可。
按角色选环境
- 浏览器：
pnpm run dev:web，直接起浏览器，反馈最快，前端贡献者首选 - Electron：
pnpm run dev:electron，需先cp .env.example .env并把VITE_API_URL指向线上接口 - 移动端：React Native（Expo），需要 macOS 加 Xcode
- SSR：
apps/ssr是轻量站点，用于外部分享
首次进入仓库根目录执行pnpm install。开发时若登录报错，把浏览器里的会话 Cookie 拷进应用即可，细节见 CONTRIBUTING.md。
folocli 命令行：终端里管理 RSS 订阅
不是所有人都开着桌面端。Folo 提供 folocli，让你在终端里跑通整个 RSS 流程，走npx调用，免全局安装。命令清单见 skill.md。
登录与时间线
登录会拉起浏览器自动完成授权，令牌缓存在本地。
npx --yes folocli@latest login npx --yes folocli@latest timeline --limit 10输出默认是 JSON，可用--format table或--format plain切换；分页靠nextCursor加hasNext，脚本能自动翻页。
OPML 迁移与收藏
从别的 RSS 工具搬内容时，OPML 是通用格式，Folo 支持双向操作；collection命令则用来收藏条目。
npx --yes folocli@latest opml export --output backup.opml npx --yes folocli@latest collection add <entryId>脚本里若返回UNAUTHORIZED，重新登录或设置FOLO_TOKEN环境变量即可，skill.md 的错误恢复一节列了三种处理法。
给 Folo 提代码：3 道质量门禁
Folo 强制 TypeScript strict，禁用any，注释要求英文。提 PR 前必须按顺序过三道门禁：
pnpm run typecheck，类型检查pnpm run lint:fix，Lint 加自动修复pnpm run test，单元测试
状态层用 Jotai 加 Zustand，服务端状态用 TanStack Query，本地库是 Drizzle 加 SQLite。共享组件统一放在packages/internal/components。若只是修 bug，先定位组件，再对该包单独跑 typecheck 即可，不必全量。
Folo 把"读信息流到 AI 处理"整条链路做进了一个开源项目，既能当阅读器用，也能用 CLI 驱动或直接改源码。下一步可以pnpm install后跑dev:web看效果，或先用 folocli 的 OPML 把旧订阅搬进来。
【免费下载链接】follow🧡 Folo is the AI RSS Reader项目地址: https://gitcode.com/GitHub_Trending/fol/follow
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
