# 网页阅读助手

**Repository Path**: jason1012/web-reading-assistant

## Basic Information

- **Project Name**: 网页阅读助手
- **Description**: 网页阅读助手
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-27
- **Last Updated**: 2026-07-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网页阅读助手（Web Read Assistant）

> 一个纯前端、零后端、零构建的浏览器扩展（Manifest V3），围绕「更好地消费网页内容」整合三大能力：收藏 / 稍后读、专注阅读模式、网页导出（Markdown / PDF）。数据全部存在你本机浏览器，**不联网、不上传、不追踪**。

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](./LICENSE)
[![Manifest](https://img.shields.io/badge/manifest-V3-brightgreen.svg)](./browser-read-tool/manifest.json)
[![Platform](https://img.shields.io/badge/platform-Chrome%20%2F%20Edge-blue.svg)](https://chrome.google.com/webstore/category/extensions)

---

## ✨ 功能一览

| 功能 | 说明 |
|------|------|
| **收藏 / 稍后读** | 一键收藏当前网页到本地列表，支持搜索、标签筛选、标记已读/未读、删除、点击回原页。 |
| **专注阅读模式** | 快捷键或弹窗按钮进入清爽阅读视图：自动隐藏广告/侧栏干扰，按你的偏好（字号、行距、背景、正文宽度、字体）重排正文；`Esc` 退出，原页完好保留。 |
| **网页导出** | 正文一键导出为 **Markdown**（存到下载目录 `web-reads/`）；或导出 **PDF**（浏览器原生打印，只保留清爽正文）。已收藏页导出时自动保存离线副本。 |
| **设置页** | 可视化调整阅读偏好、清空收藏/导出历史、恢复默认；数据管理一目了然。 |
| **本地优先** | 所有数据存于 `chrome.storage.local`，无任何网络请求、无账号、无第三方服务。 |

---

## 🚀 快速装载（开发者模式）

1. 打开 `chrome://extensions`（Edge 为 `edge://extensions`）。
2. 右上角开启 **开发者模式（Developer mode）**。
3. 点击 **加载已解压的扩展程序（Load unpacked）**，选择本仓库的 `browser-read-tool/` 目录。
4. 修改代码后，回到扩展页点刷新图标（↻）重新加载；若改了 `manifest.json` 需重新加载整个扩展。

> 开发者视角的完整说明（装载、调试日志、目录结构、各阶段实现）见 [`browser-read-tool/README.md`](./browser-read-tool/README.md)。
> 上架 Chrome Web Store 的文案与隐私政策见 [`docs/`](./docs)。

---

## 📂 仓库结构

```
.
├── README.md                       # 本文件（仓库主页）
├── LICENSE                        # MIT 许可证
├── .gitignore
├── browser-read-tool/             # 扩展源码（加载此目录到浏览器）
│   ├── manifest.json              # MV3 清单（commands / content_scripts / options_page）
│   ├── background/service-worker.js
│   ├── popup/                    # 收藏列表 + 阅读/导出入口 + 设置/快捷键引导
│   ├── content/                  # 专注阅读模式注入脚本与样式
│   ├── options/                  # 设置页：阅读偏好 + 数据管理
│   ├── lib/                      # 本地 vendor：Readability.js / turndown.js
│   └── assets/                  # 正式图标（16/48/128）
├── docs/
│   ├── STORE_LISTING.md          # Chrome Web Store 上架文案
│   └── PRIVACY.md               # 隐私政策（本地-only）
└── release/
    └── web-read-assistant-v1.1.0.zip   # 可直接上传商店的发布包
```

---

## 📦 发布产物

- 发布包：`release/web-read-assistant-v1.1.0.zip`（已含扩展全部源码与图标，`testzip()` 校验通过）。
- 版本：`1.1.0`（见 [`docs/STORE_LISTING.md`](./docs/STORE_LISTING.md)）。
- 想自己重新打包？进入 `browser-read-tool/` 目录后把该目录压缩即可，或用仓库根 `zip -r` 包含整个 `browser-read-tool`。

---

## 🔒 隐私

本扩展 **不发起任何网络请求**，所有收藏、阅读偏好、导出历史仅存于你本机的 `chrome.storage.local`。详见 [`docs/PRIVACY.md`](./docs/PRIVACY.md)。

---

## 📜 许可证

[**MIT**](./LICENSE) © 2026 网页阅读助手（Web Read Assistant）

---

## 🤝 贡献 / Issue

欢迎提 Issue 与 PR。本地装载方式见上方「快速装载」。如遇脚本报错，请附上浏览器控制台（popup / content / service worker）日志以便定位。