# page-clone-ext

**Repository Path**: lunxian8/page-clone-ext

## Basic Information

- **Project Name**: page-clone-ext
- **Description**: 📦 Chrome extension to save complete web pages as offline single-file HTML. Inline images, CSS, fonts, and JavaScript. Supports deep crawl with ZIP packaging. | 一键保存完整网页为离线单文件 HTML
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-21
- **Last Updated**: 2026-04-21

## Categories & Tags

**Categories**: Uncategorized

**Tags**: 浏览器插件, 谷歌, 扒站

## README



# 📦 PageClone

**一键保存完整网页为离线单文件 HTML**

图片内嵌 · 样式保留 · 脚本内联 · 离线可用

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Chrome](https://img.shields.io/badge/Chrome-Manifest%20V3-brightgreen.svg)

---

## 🎯 解决了什么问题？

- 局域网内的文档想拷到另一台电脑看？
- 想离线查阅技术文档但页面依赖大量外部资源？
- 保存的网页总是丢样式、图片裂开、按钮点不了？

**PageClone** 把所有外部资源（CSS、图片、字体、JavaScript）全部内嵌进一个 HTML 文件，双击就能看，不需要联网，不需要搭环境。

## ✨ 功能特性

| 功能 | 说明 |
|------|------|
| 📄 **单页保存** | 一键保存当前页面为独立 HTML 文件 |
| 🕸️ **深度抓取** | 自动爬取当前页面所有同域链接，打包为 ZIP |
| 🖼️ **图片内嵌** | 所有图片转为 Base64 嵌入，不再依赖外部链接 |
| 🎨 **CSS 内联** | 外部样式表 + 字体文件全部内联 |
| ⚡ **JS 内联** | 外部脚本内联到 HTML，保留页面交互功能 |
| 🔗 **链接保留** | 超链接保持可点击，深度模式下子页面互链 |
| 📦 **ZIP 打包** | 多页面自动打包为 ZIP，含 index.html 目录页 |
| ⚙️ **灵活配置** | 5 个开关按需开关，适应不同场景 |

## 🚀 安装方法

### 方法一：从源码安装（推荐）

1. 克隆仓库：
```bash
git clone https://gitee.com/lunxian8/page-clone-ext.git
```

2. 打开 Chrome 扩展管理页面（`chrome://extensions/`）

3. 开启右上角 **「开发者模式」**

4. 点击 **「加载已解压的扩展程序」**

5. 选择 `page-clone-ext` 文件夹

6. 工具栏出现 📦 图标即安装成功！

### 方法二：从 Release 安装

1. 前往 [Releases](https://gitee.com/lunxian8/page-clone-ext/releases) 页面
2. 下载最新版 `.zip` 文件
3. 解压后按上述步骤 2-6 加载

## 📖 使用指南

### 单页保存

1. 打开要保存的网页
2. 点击工具栏 📦 图标
3. 根据需要配置选项（图片内嵌、CSS内联等）
4. 点击 **「保存当前页面」**
5. 选择保存位置，得到 `.html` 文件

### 深度抓取

1. 打开文档的**首页或目录页**
2. 点击 📦 图标 → **「深度抓取（含子页面）」**
3. 自动收集当前页面上所有同域链接（最多 50 页）
4. 打包下载为 `.zip` 文件
5. 解压后打开 `index.html` 即可浏览

### 配置选项

| 选项 | 默认 | 说明 |
|------|------|------|
| 内嵌图片 | ✅ 开 | 图片转 Base64 嵌入 |
| 内嵌 CSS | ✅ 开 | 外部样式表 + 字体内联 |
| 保留链接 | ✅ 开 | 超链接保持可点击 |
| 移除脚本 | ❌ 关 | 删除 JS（仅静态文档） |
| 内嵌脚本 | ✅ 开 | 外部 JS 内联 |

## ⚠️ 注意事项

- **CORS 限制**：部分跨域资源可能无法内嵌
- **SPA 页面**：React/Vue 等需开启「内嵌脚本」
- **需要登录的页面**：请先登录后再保存
- **文件大小**：图片和脚本内嵌后可能较大
- **深度抓取限制**：仅抓取同域链接，最多 50 页

## 📝 更新日志

### v1.0.0 (2025-01)

- 🎉 初始版本发布
- 📄 支持单页面完整保存
- 🕸️ 支持深度抓取 + ZIP 打包
- 🖼️ 图片 / CSS / JS / 字体全部内嵌
- ⚡ 自动转义