# web-bookmark

**Repository Path**: wxweven/web-bookmark

## Basic Information

- **Project Name**: web-bookmark
- **Description**: chrome 网页收藏管理插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: 001-bookmark-core
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-03
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 网页收藏夹 - Chrome 扩展

一款轻量级 Chrome 浏览器扩展，支持一键收藏网页、分类管理、标签标注、关键字搜索和数据导入导出。所有数据存储在本地，无需联网，隐私安全。

## 功能特性

- **一键收藏**：浏览网页时点击扩展图标，即可保存当前页面的标题和摘要
- **分类管理**：支持自定义分类，收藏时可选择或新建分类
- **标签标注**：为书签添加多个标签，便于归类和检索
- **关键字搜索**：通过标题、摘要、URL、标签进行快速搜索
- **导入导出**：支持 JSON 格式导出，支持 JSON 和 Chrome HTML 书签格式导入
- **全页面管理**：在新标签页中打开收藏管理页面，提供更宽敞的浏览和管理体验

## 安装方式

1. 下载或克隆本仓库
2. 打开 Chrome 浏览器，访问 `chrome://extensions/`
3. 开启右上角的 **开发者模式**
4. 点击 **加载已解压的扩展程序**，选择项目中的 `src` 目录
5. 扩展安装完成，浏览器工具栏会出现扩展图标

## 使用方法

### 收藏网页

1. 浏览想要收藏的网页
2. 点击工具栏中的扩展图标
3. 点击「收藏此页」按钮
4. 选择分类（可直接新建），输入标签（回车确认），点击「保存」

### 管理收藏

1. 点击扩展弹窗中的「打开收藏管理 →」按钮
2. 在新标签页中浏览所有书签
3. 通过左侧分类导航筛选，或使用顶部搜索框查找
4. 悬停书签可进行编辑或删除操作

### 导入导出

1. 在收藏管理页面，点击左下角的「导出」按钮，将书签导出为 JSON 文件
2. 点击「导入」按钮，选择 JSON 或 Chrome HTML 书签文件进行导入

## 技术栈

- Chrome Extension Manifest V3
- 原生 JavaScript (ES2020+)
- Chrome Storage Local API
- 无框架依赖，轻量高效

## 项目结构

```
src/
├── manifest.json          # 扩展配置
├── background/
│   └── service-worker.js  # 后台服务（消息处理、页面信息提取）
├── popup/
│   ├── popup.html         # 弹窗页面
│   ├── popup.css          # 弹窗样式
│   └── popup.js           # 弹窗逻辑（收藏操作）
├── manager/
│   ├── manager.html       # 全页面管理页
│   ├── manager.css        # 管理页样式
│   └── manager.js         # 管理页逻辑（浏览、搜索、编辑、删除）
├── utils/
│   ├── storage.js         # 数据存储层（CRUD 操作）
│   ├── exporter.js        # 导出功能
│   └── importer.js        # 导入功能（JSON / Chrome HTML）
├── styles/
│   └── variables.css      # CSS 变量（主题配色、间距等）
└── icons/                 # 扩展图标
```

## 许可证

MIT