免责声明：该项目已不再处于积极开发状态。

项目 Fib

在当前的媒体环境中，分发渠道的控制权几乎与内容创作本身同样重要，这也使得 Facebook 拥有了巨大的影响力。Facebook 的信息流对现实世界中人们观点形成的影响极为深远，甚至可能影响了 2016 年的选举结果，然而这些信息流并不完全准确。我们的解决方案？FiB——因为拥有 15 亿用户，算法中的每一次细微调整都可能带来改变，而我们绝不会止步于此。

安装

简单方式

前往 Chrome 网上应用店，将我们的扩展程序添加到您的浏览器。

较难方式

（适合希望体验最新功能的用户）

1. 从我们的仓库下载“extension”文件夹。
2. 打开浏览器的扩展程序管理页面，勾选“开发者模式”。
3. 点击“加载已解压的扩展程序…”。
4. 找到您下载扩展程序的目录并选择它。
5. 扩展程序现在应该已经成功添加。

后端服务器 Docker 容器

为了在本地构建后端 Python 服务器并与扩展程序配合使用，本仓库包含 backend/Dockerfile。

构建 Docker 镜像：

cd backend/
docker build -t hackprincetonf16 .

在本地端口 5000 上运行 Docker 容器：

docker run -it --rm -p 5000:5000 hackprincetonf16

在手动安装扩展程序之前，请将 extension/myScript.js 中的 var server 更新为 http://localhost:5000。

关于我们

该项目目前仍在开发中（需要大量工作，并且我们也在持续投入）。我们都是大学生，致力于帮助解决社交媒体面临的问题。作为学生团队，我们有时可能需要一些时间来修复问题或审核 Pull Request，请大家多多包涵。我们始终在寻找该项目的赞助商，因为我们是非营利组织，需要资金来维持服务器运行并支付 API 使用费用。

参与贡献

我们非常欢迎贡献者。本项目是开源的，每一份贡献都很有价值。请阅读 CONTRIBUTE.md，了解如何参与我们的项目。

许可协议

本项目受开放软件许可证 3.0 版保护。

请阅读 License.md。

Project Fib 快速上手指南

注意：本项目目前已停止活跃开发，仅供学习与研究参考。Project Fib 是一款旨在通过算法干预来平衡 Facebook 新闻推送内容的浏览器扩展。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：Windows、macOS 或 Linux
• 浏览器：Google Chrome 或基于 Chromium 的浏览器（如 Edge）
• 前置依赖（仅针对本地后端开发）：
  • Docker：用于构建和运行后端 Python 服务器容器。
  • Git：用于克隆代码仓库。

安装步骤

您可以选择直接安装扩展（简单模式），或下载源码并配置本地后端（开发者模式）。

方式一：直接安装扩展（推荐普通用户）

这是最快捷的使用方式，无需配置环境。

1. 访问 Chrome Web Store。
2. 点击 "Add to Chrome"（添加到 Chrome）按钮。
3. 在弹出的确认框中点击 "Add extension"。
4. 安装完成后，刷新 Facebook 页面即可生效。

方式二：本地源码安装（适合开发者）

如果您需要体验最新功能或修改代码，请按以下步骤操作：

1. 获取源码

从仓库下载 extension 文件夹到本地。

2. 加载未打包的扩展

1. 在 Chrome 浏览器地址栏输入 chrome://extensions/ 并回车。
2. 右上角开启 "Developer mode"（开发者模式）开关。
3. 点击左上角的 "Load unpacked..."（加载已解压的扩展程序）。
4. 选择您下载的 extension 文件夹。

3. 配置本地后端服务器（可选）

若需连接本地后端进行测试，请使用 Docker 构建并运行服务：

构建 Docker 镜像：

cd backend/
docker build -t hackprincetonf16 .

运行 Docker 容器（映射端口 5000）：

docker run -it --rm -p 5000:5000 hackprincetonf16

修改扩展配置： 在加载扩展前，请编辑 extension/myScript.js 文件，将 var server 的值更新为本地地址：

var server = "http://localhost:5000";

基本使用

安装完成后，Project Fib 会自动在您访问 Facebook 时介入新闻推送流程。

1. 登录 Facebook：使用您的账号正常登录。
2. 浏览动态：当您滚动浏览 News Feed（新闻推送）时，扩展会根据预设算法对内容进行微调或标记。
3. 观察变化：无需额外操作，您将会看到经过算法调整后的内容呈现，旨在打破信息茧房，提供更平衡的视角。

提示：由于项目已停止维护，部分功能可能无法适应 Facebook 最新的界面更新。如遇失效，建议检查浏览器控制台（F12）中的报错信息。