豆伴（Tofu）：豆瓣数据备份与导出工具使用指南

了解豆伴核心功能

豆伴（Tofu）是一款专为豆瓣用户设计的Chrome扩展程序，核心价值在于提供安全可靠的个人数据备份方案。通过该工具，用户可一键备份豆瓣账号中的电影评分、书籍评论、关注列表等重要数据，并支持导出为Excel格式文档，有效防止数据丢失风险。

准备开发与运行环境

安装源代码

执行以下命令克隆项目仓库到本地：

git clone https://gitcode.com/gh_mirrors/tofu1/tofu

环境要求

• Google Chrome浏览器（版本80+）
• 本地开发环境需支持ES6+ JavaScript语法
• 无需额外依赖安装，扩展程序采用纯前端技术实现

注意：确保克隆仓库后完整保留项目目录结构，特别是chrome/extension/目录下的核心文件。

解析核心功能模块

数据采集模块

位于extension/tasks/目录下的系列脚本文件（如annotation.js、follower.js等）负责不同类型数据的采集逻辑。该模块通过模拟用户操作，从豆瓣网页中提取结构化数据，支持包括：

• 影音书评分与评论（影/音/书/游标签页数据）
• 社交关系数据（关注/被关注列表、黑名单）
• 内容创作数据（日记、广播、相册）

任务调度系统

extension/services/目录下的Job.js和Task.js实现了任务队列管理，支持：

• 多任务并行处理
• 任务状态跟踪（通过StateChangeEvent.js）
• 错误处理与重试机制（TaskError.js）

用户界面组件

extension/ui/目录包含导航栏（navbar.js）、分页器（paginator.js）等UI组件，提供直观的操作界面。典型界面如下所示：

配置扩展程序

基础配置文件

核心配置文件为chrome/extension/manifest.json，该文件定义了扩展的基础信息和权限设置。关键配置项说明：

{
  "name": "豆伴",
  "version": "1.0",
  "manifest_version": 2,
  "permissions": ["activeTab", "storage"],
  "background": {
    "scripts": ["background.js"]
  }
}

权限配置场景

• 当需要访问用户本地存储时，需确保"storage"权限已添加
• 若需与豆瓣网站交互，需在"permissions"中添加相应域名
• 背景脚本变更后需重新加载扩展程序才能生效

提示：修改配置文件后，通过Chrome扩展管理页面的"重新加载"按钮应用更改。

执行数据备份与导出

启动备份任务

1. 在Chrome浏览器中加载已解压的扩展程序（指向chrome/extension/目录）
2. 点击浏览器工具栏中的豆伴图标，选择「新建任务」
3. 在弹出的任务配置面板中勾选需要备份的数据类型
4. 点击「开始」按钮启动备份进程

导出Excel文件

备份完成后，执行以下步骤导出数据：

1. 在扩展界面中切换到「服务」标签页
2. 点击「导出数据」按钮，打开导出配置窗口
3. 选择需要导出的项目（可通过"全选"快速勾选所有数据类型）
4. 点击「导出」按钮生成并下载Excel文件

查看备份历史

通过「浏览备份」菜单可查看所有历史备份记录，系统会自动保留每次备份的时间戳和数据完整性信息。对于已从豆瓣删除的内容，会以灰色标识显示在备份列表中。

获取帮助与支持

如遇使用问题，可通过以下途径获取帮助：

• 扩展程序内「帮助」标签页查看使用指南
• 检查extension/services/Logger.js生成的日志文件定位问题
• 项目许可证信息可在根目录LICENSE文件中查看