Folo教程系列：从入门到精通全指南

你是否还在被碎片化信息淹没？是否希望有一个工具能帮你高效整理和获取有价值的内容？Folo（全称Follow）作为新一代信息浏览器（Next generation information browser），能够将各类内容整合到一个时间线中，让你专注于重要信息，远离噪音干扰。本教程将带你从入门到精通，全面了解Folo的安装、核心功能及高级使用技巧。

一、Folo简介与安装

1.1 Folo是什么

Folo是一款致力于打造个性化信息中心的开源项目，它允许用户订阅海量的Feed和精选列表，将分散的信息聚合到一处，让你轻松获取感兴趣的内容。无论是文章、视频、图片还是音频，Folo都能为你提供无干扰的浏览体验。

官方文档：README.md

1.2 安装方法

Folo支持多种操作系统，你可以根据自己的设备选择合适的安装方式。

1.2.1 直接下载安装

操作系统	下载来源
Any	网页版
iOS	App Store
Android	Google Play 或 GitHub Releases
macOS	Mac App Store 或 GitHub Releases
Windows	Microsoft Store 或 GitHub Releases
Linux	GitHub Releases

1.2.2 社区维护的安装方式

• Arch Linux用户：可安装AUR包folo-appimage，由timochan和grtsinry43维护。
• Nix用户：可安装包follow，由iosmanthus维护。
• macOS用户（使用Homebrew）：可安装caskfolo，由realSunyz维护。
• Windows用户（使用Scoop）：可安装manifestfolo，由cscnk52维护。

1.2.3 从源码构建安装

如果你是开发者，也可以选择从源码构建安装Folo。首先需要克隆仓库：

git clone https://gitcode.com/GitHub_Trending/fol/follow.git
cd follow

然后按照CONTRIBUTING.md中的指引进行构建。

二、Folo核心功能详解

2.1 个性化信息中心

Folo允许你订阅各种Feed和精选列表，将你感兴趣的内容聚合到一个时间线中，方便你随时掌握重要信息。你可以轻松管理自己的订阅源，打造专属的信息空间。

相关模块：apps/ssr/src/

2.2 AI辅助功能

Folo集成了强大的AI功能，为你提供更智能、高效的浏览体验。例如AI翻译、AI摘要等，帮助你快速理解和处理内容。

AI功能相关配置：locales/ai/

2.3 动态内容支持

Folo不仅支持文本内容，还能处理视频、图片、音频等多种类型的内容，让你在一个应用中享受丰富多样的信息。

媒体处理模块：packages/readability/

2.4 社区互动

Folo不仅仅是一个应用，更是一个社区。你可以分享列表、探索精选内容，与其他用户交流互动，共同打造开放的信息平台。

社区功能相关：CONTRIBUTING.md

三、高级使用技巧

3.1 开发环境搭建

如果你希望参与Folo的开发或进行自定义修改，可以搭建开发环境。以下是不同开发场景的设置方法：

3.1.1 浏览器中开发

cd apps/desktop && pnpm run dev:web

该命令会在浏览器中打开https://app.folo.is/__debug_proxy，方便你进行在线API环境的开发和调试。

3.1.2 Electron中开发

1. 进入apps/desktop目录：

   cd apps/desktop
   

2. 复制环境变量示例文件：

   cp .env.example .env
   

3. 在.env文件中设置VITE_API_URL为https://api.follow.is。
4. 运行开发服务器：

   pnpm run dev:electron
   

开发配置文件：apps/desktop/electron.vite.config.ts

3.1.3 移动应用开发

[!NOTE] 开发移动应用需要Mac设备，并已安装Xcode和必要的依赖。

1. 进入apps/mobile目录：

   cd apps/mobile
   

2. 复制环境变量示例文件：

   cp .env.example .env
   

3. 在.env文件中添加EXPO_PUBLIC_APP_CHECK_DEBUG_TOKEN="xxx"（xxx为任意字符串）。
4. 构建并安装开发版Folo应用（仅需执行一次）：

   pnpm expo prebuild --clean # 可选
   pnpm run ios
   

5. 运行开发服务器：

   pnpm run dev
   

移动应用图标：apps/mobile/assets/icon.png

3.2 自定义主题与图标

Folo提供了一些自定义主题和图标的选项，你可以根据自己的喜好进行设置。应用中使用的图标位于icons/mgc/目录下，例如添加图标icons/mgc/add_cute_re.svg、AI图标icons/mgc/ai_cute_re.svg等。

四、常见问题与解答

4.1 安装问题

Q：在Linux系统上安装Folo时遇到依赖问题怎么办？

A：可以尝试使用社区维护的AUR包或从源码构建，具体可参考CONTRIBUTING.md中的开发环境搭建部分。

4.2 使用问题

Q：如何解决登录问题？

A：如果遇到登录问题，可以从浏览器的Cookie中复制__Secure-better-auth.session_token到应用中。

4.3 开发问题

Q：开发移动应用时，如何开发原生iOS模块？

A：1. 进入apps/mobile/ios目录；2. 用Xcode打开项目：open Folo.xcworkspace；3. 在左侧边栏中打开Pods并选择FollowNative；4. 构建并运行项目。

五、总结与展望

通过本教程，你已经了解了Folo的基本安装、核心功能和高级使用技巧。Folo作为一款开源的信息浏览器，仍在不断发展中，欢迎你提出任何问题或建议，共同推动项目的进步。

如果你觉得Folo对你有帮助，不妨给项目点个Star，以便及时获取最新的发布通知。也欢迎你加入我们的社区，与其他用户和开发者交流心得。

未来，Folo将继续优化用户体验，增加更多实用功能，为你打造更优质的信息浏览平台。让我们一起期待Folo的成长！

社区参与：CONTRIBUTING.md