英文原文正文为项目原始 README（英文），本站后续会翻译为中文，当前仅剔除图片与无关章节并统一排版。

单文件

SingleFile 帮助您将完整的网页保存为单个 HTML 文件。SingleFile 是一个 Web 扩展（以及命令行工具），兼容 Chrome、Firefox（桌面和移动端）、Microsoft Edge、Safari、Vivaldi、Brave、Waterfox、Yandex 浏览器和 Opera。

演示

https://user-images.githubusercontent.com/396787/156664907-cc458e35-f41b-45ca-91eb-372213812b44.mp4

安装

SingleFile 可以从以下商店安装：

• Firefox: https://addons.mozilla.org/firefox/addon/single-file
• Android 版 Firefox: https://addons.mozilla.org/android/addon/single-file
• Chrome: https://chromewebstore.google.com/detail/singlefile/mpiodijhokgodhhofbcjdecpffjipkle
• Safari（macOS 和 iOS）: https://apps.apple.com/us/app/singlefile-for-safari/id6444322545
• Microsoft Edge: https://microsoftedge.microsoft.com/addons/detail/efnbkdcfmcmnhlkaijjjmhjjgladedno

你也可以下载项目的压缩文件 ( https://github.com/gildas-lormeau/SingleFile/archive/master.zip) 并手动安装，方法是将其解压到磁盘上的某个位置，然后按照以下说明操作：

• Firefox: https://extensionworkshop.com/documentation/develop/temporary-installation-in-firefox
• Chrome 和 Microsoft Edge: https://github.com/gildas-lormeau/SingleFile-MV3
• Safari: https://github.com/gildas-lormeau/SingleFile-Safari-Extension

入门指南

• 点击扩展工具栏中的 SingleFile 按钮以保存页面。
• 在处理页面时，你可以再次点击该按钮以取消操作。

附加说明

• 通过在扩展工具栏或网页上的 SingleFile 按钮右键单击打开上下文菜单。它允许您保存：
  • 当前标签页，
  • 所选内容，
  • 所选框架。
• 您还可以一次处理多个标签页并保存：
  • 所选标签页，
  • 未固定的标签页，
  • 所有标签页。
• 在上下文菜单中选择“注释并保存页面...”以：
  • 突出显示文本，
  • 添加备注，
  • 删除内容。
• 上下文菜单还允许您激活自动保存：
  • 当前标签页，
  • 未固定的标签页，
  • 所有标签页。
• 启用自动保存后，每次页面加载后（如果未加载，则在卸载前）页面将被自动保存。
• 右键单击 SingleFile 按钮并选择“管理扩展”（Firefox）/“选项”（Chrome）以打开选项页面。
• 启用“目标 > 保存到 Google Drive”或“目标 > 上传到 GitHub”选项，以分别将页面上传到 Google Drive 或 GitHub。
• 启用“杂项 > 添加存在证明”选项，通过将页面的 SHA256 链接到区块链来证明保存的页面的存在。
• 您可以使用可自定义的快捷键 Ctrl Shift Y 来保存当前标签页或所选标签页。要在 Firefox 中更改它，请进入 about:addons 并在齿轮菜单中选择“管理扩展快捷键”。要在 Chrome 中更改它，请进入 chrome://extensions/shortcuts。
• 默认保存文件夹是浏览器中配置的下载文件夹，参见 Firefox 的 about:addons 和 Chrome 的 chrome://settings。
• 有关选项和技术说明的更多详细信息，请参阅扩展选项页面中的帮助。

常见问题解答

请参见 https://github.com/gildas-lormeau/SingleFile/blob/master/faq.md

版本说明

请参考 https://addons.mozilla.org/firefox/addon/single-file/versions/

已知问题与故障排除

请参考 https://github.com/gildas-lormeau/SingleFile/blob/master/known-issues.md

命令行界面（SingleFile CLI）

您可以通过命令行界面将网页保存为 HTML。更多信息请参见：https://github.com/gildas-lormeau/single-file-cli.

与用户脚本的集成

您可以在 SingleFile 保存页面之前（和之后）执行用户脚本。欲了解更多信息，请参见 https://github.com/gildas-lormeau/SingleFile/wiki/How-to-execute-a-user-script-before-a-page-is-saved。

文件格式比较

脚注：

¹ 使用“通用”自解压文件格式时

² 仅在基于 Chromium 的浏览器和 Internet Explorer 中

³ 仅在 Safari 中

⁴ 扩展中必须启用一个选项

使用/兼容 SingleFile 的项目

• ArchiveBox - 开源自托管网页归档：https://github.com/ArchiveBox/ArchiveBox
• htmls-to-datasette - 将 HTML 文件索引到 Sqlite 数据库的工具：https://github.com/pjamar/htmls-to-datasette
• Karakeep - 带有 AI 功能的自托管书签应用：https://karakeep.app
• KOReader - 面向电子墨水阅读器的文档查看器：https://github.com/koreader/koreader
• linkding - 可自托管的书签管理器，设计简约、快速，并可通过 Docker 轻松设置：https://github.com/sissbruecker/linkding
• Linkwarden - 自托管的协作书签管理器，可收集、阅读、注释并完全保留重要内容，一站式管理：https://github.com/linkwarden/linkwarden
• obsidian-html-plugin - 用于在 Obsidian 中读取 HTML 页面插件: https://github.com/nuthrash/obsidian-html-plugin
• Org-Dex.el - 一个 Emacs 包，旨在通过集成 SingleFile CLI 来增强 Org-mode: https://github.com/nitincodery/org-dex.el
• Petal Cite Web Importer - 在 Petal Cite 中保存 PDF 并捕获网页的浏览器扩展: https://github.com/ks-collab/cite-extension
• Pocket Search Engine - 一个完全离线工作的 Android 语义搜索应用: https://play.google.com/store/apps/details?id=com.pocketsearchengine.app
• Readeck - 书签管理器及稍后阅读工具: https://codeberg.org/readeck/readeck
• singlefile2trilium - 使用 SingleFile 将网页保存为 Trilium 笔记的工具: https://github.com/nil0x42/singlefile2trilium
• SingleFile MV3 CDP Patched - SingleFile 分支版本，已修补以允许通过 Chrome DevTools 协议进行编程控制: https://github.com/Cosmologist/SingleFile-MV3-CDP-Patched
• SingleFile MCP - 模型上下文协议（MCP）服务器，使用 single-file 和 trafilatura 提供智能网页内容提取: https://github.com/kwinsch/singlefile-mcp
• Trilium-SingleFile - Trilium Notes 插件，用于轻松导入 SingleFile HTML 页面: https://github.com/rauenzi/Trilium-SingleFile
• Trilium Simple SingleFile Renderer - 一个插件，为 Trilium 添加新模板笔记以渲染由 SingleFile 创建的文件: https://github.com/xnohat/trilium-simple-singlefile-renderer
• web document - 浏览器扩展，用于本地保存网页文档，允许离线访问并快速搜索网页: https://github.com/wvit/web-document
• Zotero Connector - Zotero 浏览器扩展，帮助收集、组织、引用和分享你的研究资源: https://github.com/zotero/zotero-connectors

隐私政策

请参阅 https://github.com/gildas-lormeau/SingleFile/blob/master/privacy.md

源自第三方项目的代码

• csstree: https://github.com/csstree/csstree
• postcss-media-query-parser: https://github.com/dryoma/postcss-media-query-parser
• postcss-selector-parser: https://github.com/postcss/postcss-selector-parser
• UglifyCSS: https://github.com/fmarcia/UglifyCSS
• parse-srcset: https://github.com/albell/parse-srcset
• parse-css-font: https://github.com/jedmao/parse-css-font
• Readability: https://github.com/mozilla/readability
• whatwg-mimetype: https://github.com/jsdom/whatwg-mimetype

图标

• 图标由 Kiranshastry 从 Flaticon 制作，依据 CC 3.0 BY 许可。

许可证

SingleFile 根据 AGPL 许可证授权。源自第三方项目的代码根据 MIT 许可证授权。如果您有兴趣将 SingleFile 代码用于商业服务或产品，请通过 gildas.lormeau <at> gmail.com 联系我。

欢迎提出建议 :)