SingleFile 项目技术文档

1. 安装指南

1.1 从应用商店安装

SingleFile 支持多种浏览器，可以通过以下应用商店进行安装：

• Firefox: Firefox Add-ons
• Firefox for Android: Firefox Add-ons for Android
• Chrome: Chrome Web Store
• Safari (macOS 和 iOS): App Store
• Microsoft Edge: Microsoft Edge Add-ons

1.2 手动安装

你也可以通过下载项目的 zip 文件并手动安装：

1. 下载 SingleFile 的 zip 文件。
2. 解压文件到你的硬盘上的某个目录。
3. 根据以下说明进行手动安装：
   • Firefox: 参考 Firefox 临时安装指南。
   • Chrome 和 Microsoft Edge: 参考 SingleFile-MV3 项目。
   • Safari: 参考 SingleFile-Safari-Extension 项目。

2. 项目的使用说明

2.1 基本使用

• 点击浏览器工具栏中的 SingleFile 按钮，保存当前网页为一个 HTML 文件。
• 如果页面正在处理中，你可以再次点击按钮取消保存操作。

2.2 高级功能

• 右键菜单: 右键点击 SingleFile 按钮或网页，可以保存当前标签页、选中的内容或选中的框架。
• 多标签处理: 可以一次性保存选中的标签页、未固定的标签页或所有标签页。
• 注释和保存: 选择“注释并保存页面...”可以在保存前高亮文本、添加注释或删除内容。
• 自动保存: 可以激活自动保存功能，页面加载后自动保存。

2.3 选项设置

• 右键点击 SingleFile 按钮，选择“管理扩展”（Firefox）或“选项”（Chrome）打开选项页面。
• 启用“目的地 > 保存到 Google Drive”或“目的地 > 上传到 GitHub”可以将页面上传到 Google Drive 或 GitHub。
• 启用“杂项 > 添加存在证明”可以通过链接到区块链来证明保存页面的存在。

3. 项目API使用文档

3.1 命令行接口 (SingleFile CLI)

SingleFile 提供了命令行接口，可以从命令行保存网页为 HTML 文件。更多信息请参考 SingleFile CLI 项目。

3.2 用户脚本集成

你可以在 SingleFile 保存页面之前或之后执行用户脚本。更多信息请参考 如何执行用户脚本。

4. 项目安装方式

4.1 浏览器扩展安装

通过浏览器的应用商店安装 SingleFile 扩展。

4.2 手动安装

下载项目的 zip 文件并手动解压安装，具体步骤参考 手动安装指南。

4.3 命令行安装

使用 SingleFile CLI 从命令行安装和使用 SingleFile。

通过以上文档，你可以轻松安装和使用 SingleFile 项目，并了解其高级功能和 API 的使用方法。