WebScrapBook：轻松捕获网页内容的完整指南

WebScrapBook是一款浏览器扩展工具，能帮助你将网页完整保存到本地或服务器，方便日后查阅、整理、添加注释和编辑。无论是研究资料、灵感素材还是重要网页，都能轻松留存，让你告别“找不到之前看过的网页”的烦恼。

核心功能价值：为什么选择WebScrapBook？

• 完整保存：不仅保存文字图片，还能保留网页布局和交互效果，还原网页原貌。
• 本地管理：所有内容存储在本地，无需依赖云端，保护隐私更安心。
• 标注编辑：支持添加注释、高亮文本，让保存的网页更具个人价值。
• 灵活组织：可按分类整理保存的网页，快速检索，打造个人知识库。

项目核心组件探秘

源代码目录（src/）

这是WebScrapBook的“大脑”，包含了实现各种功能的关键文件。

• background.js：后台“指挥官”，默默监听浏览器的各种操作，比如你点击保存按钮时，它就会启动捕获网页的流程。
• content.js：网页“交互员”，在你浏览的网页中工作，帮你选择要保存的区域、添加高亮和注释。
• lib/：工具“百宝箱”，存放了各种辅助功能的库文件，让WebScrapBook能处理压缩、日期格式化等任务。

存储与配置

• scrapbooks/：这是你保存的网页“仓库”，所有捕获的内容都会按一定结构存放在这里。
• config.json：个性化“设置面板”，你可以在这里调整默认保存路径、格式等参数。

3步完成浏览器扩展安装

1. 获取项目代码
   打开终端，输入以下命令克隆项目到本地：
   git clone https://gitcode.com/gh_mirrors/we/webscrapbook

2. 开启浏览器开发者模式
   以Chrome浏览器为例，打开“设置” → “更多工具” → “扩展程序”，然后勾选右上角的“开发者模式”。

3. 加载扩展
   点击“加载已解压的扩展程序”，选择你克隆下来的webscrapbook文件夹，完成安装。

💡 小贴士：安装后，浏览器工具栏会出现WebScrapBook的图标，点击即可开始使用核心功能。

图：WebScrapBook主界面，显示了保存的网页内容和注释功能示例

自定义存储路径的3种方法

通过修改配置文件config.json（通常在项目根目录或用户配置目录），你可以灵活设置网页的存储位置：

配置项	说明	示例值
scrapbook_dir	设置网页存储的根目录	"./my_scrapbooks"
format_default	默认保存格式，如html、mhtml	"html"
index_database	搜索索引数据库类型	"sqlite"

💡 小贴士：修改配置后，需要重启浏览器扩展才能生效哦！

常见问题解答

Q：安装扩展时提示“程序包无效”怎么办？

A：检查是否开启了开发者模式，确保选择的是项目根目录下的src文件夹（部分浏览器可能需要直接选择manifest.json文件）。

Q：保存的网页图片显示不出来？

A：这可能是图片链接失效或保存时网络问题。尝试重新保存网页，或检查网络连接。

Q：如何批量管理已保存的网页？

A：在WebScrapBook的主界面左侧，有“ScrapBook”分类列表，你可以在这里创建文件夹、移动或重命名保存的网页。

通过WebScrapBook，你可以像拥有一个私人网页图书馆一样，轻松管理和利用网络上的有价值信息。开始探索，让网页保存变得简单高效吧！