WebMemex浏览器扩展使用教程

1. 项目介绍

WebMemex 是一个浏览器扩展，旨在将浏览器转变为一个离线优先的知识管理工具。它可以保存你访问的网页到本地计算机，通过去除脚本和大部分交互行为，同时内联所有图片和样式表，让你能以看到的样子保存页面。长期目标是让用户能够提取引用、创建笔记并在事物之间建立链接，真正地扩展个人网络。最终，用户应该能够发布（部分）个人网络，与他人分享知识，从而将浏览器从“网页浏览器”转变为“网页编织者”。

2. 项目快速启动

环境准备

• 克隆项目仓库到本地：

  git clone https://github.com/WebMemex/webmemex-extension.git
  

• 确保安装了 Node.js 和 NPM，版本要求 Node/NPM ≥10。

安装依赖

在项目根目录下运行以下命令安装依赖：

make

编译源文件

使用以下命令编译源文件：

make build

加载到浏览器

Firefox

运行以下命令来加载扩展到 Firefox：

npm run firefox

或者直接运行 web-ext 命令以获得更多控制选项。

也可以通过访问 about:debugging，选择“加载临时扩展”，然后选择本项目中的 extension/manifest.json 文件。

Chromium/Chrome/Opera/Brave

• 打开浏览器的扩展页面（如 Chrome 中为 chrome://extensions/）。
• 启用“开发者模式”。
• 点击“加载未封装的扩展”，然后选择本项目中的 extension/ 文件夹。

自动重新编译

如果上述步骤成功，运行以下命令将触发每次源文件修改后的快速重新编译：

npm run watch

如果通过 npm run firefox 或 web-ext 在 Firefox 中测试，扩展应该也会自动重新加载。否则，需要在扩展列表中手动点击重新加载按钮。

3. 应用案例和最佳实践

• 网页保存：对于重要的网页内容，使用 WebMemex 进行保存，确保即使原网站关闭，你也能访问这些信息。
• 知识管理：通过提取引用、创建笔记，构建个人知识库。
• 内容分享：发布个人网络的部分内容，与他人分享你的知识和见解。

4. 典型生态项目

WebMemex 作为浏览器扩展，可以与多种类型的开源项目配合使用，例如：

• PouchDB：一个轻量级的数据库，用于存储和管理网页数据。
• React + Redux：用于构建扩展的用户界面。
• WebExtensions：支持在 Firefox 和 Chrome/Chromium 浏览器上运行的扩展开发框架。

通过上述介绍，你可以开始探索 WebMemex 的功能，并将其集成到你的知识管理流程中。