# Bookmark

**Repository Path**: q8080713/Bookmark

## Basic Information

- **Project Name**: Bookmark
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-31
- **Last Updated**: 2026-02-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 书签管家 (Bookmark Manager) 📘

一款轻量、安全且强大的浏览器伴侣，为您提供跨设备的书签、标签页及历史记录同步服务。基于 Cloudflare Workers 构建，无需自建服务器，利用端到端加密技术全方位保护您的数据隐私。

兼容 **Google Chrome** 和 **Microsoft Edge** 浏览器，支持深色模式。

## ✨ 核心亮点

### 1. 🔄 全能云同步 (Sync Everything)
告别浏览器同步功能的局限性，在一个仪表盘中管理您的所有浏览数据：
*   **书签同步**：一键上传/下载书签库，支持增量更新与自动同步。
*   **云标签页**：在办公室保存当前打开的所有标签页，回家后一键恢复现场。
*   **历史备份**：将浏览历史加密存储于云端，不再担心重装系统后记录丢失。
*   **Web 浏览**：生成的专属 Web 导航站，让您在手机或其他设备上也能随时访问书签。

### 2. 🛡️ 零信任安全 (Zero-Trust Security)
您的数据只属于您自己。
*   **端到端加密 (E2EE)**：所有数据（书签、标签、历史）在上传前均在本地使用 **AES-GCM** 军用级算法加密。
*   **隐私保护**：Cloudflare 服务器仅存储加密后的乱码，管理员也无法查看您的原始内容。
*   **安全验证**：凭正确的“同步加密密码”才能解密数据，确保密钥掌握在您手中。

### 3. 🧹 强大的本地整理工具 (Bookmark Manager)
扩展内置了独立的 **书签管理器**（点击插件“工具箱” -> “打开书签管理器”进入），提供专业级的数据清洗能力：

*   **🔍 深度搜索**：
    *   绝非简单的关键词匹配，支持按 **标题**、**URL** 组合搜索。
    *   支持“仅小写文本”模式，方便查找难以记忆的大小写混合书签。
*   **👯‍♀️ 重复书签清洗**：
    *   **精准重复**：毫秒级找出 URL 完全一致的冗余条目。
    *   **智能相似**：基于算法识别同一网站下标题高度相似的“伪重复”书签。
    *   **清理策略**：提供“保留最新”、“保留最旧”、“保留路径最短”等一键处理方案。
*   **🔗 死链与异常检测**：
    *   后台并发验证书签有效性，自动标记 404、500 或连接超时的僵尸链接。
    *   支持一键批量删除失效书签，节省手动检查时间。
*   **📂 智能归档与整理**：
    *   **按域名归档**：一键将杂乱的书签按 `google.com`、`github.com` 等域名自动分类进文件夹。
    *   **空文件夹清理**：递归扫描目录树，一键移除所有不包含有效书签的空文件夹。
*   **🛡️ 安全操作**：
    *   **回收站机制**：删除的书签默认移动到 `❌ 书签回收站`，防止手滑误删。
    *   **撤销功能**：支持撤销上一步操作。
*   **📦 数据导入导出**：
    *   支持将书签、当前打开的标签页导出为 JSON 格式备份。

### 5. 🧑‍💻 强大的管理后台 (Admin Dashboard)
访问 `您的Worker地址/admin` 即可进入管理后台，掌握一切数据动向。
*   **客户端解密预览**：
    *   **安全查看**：直接在后台输入“同步密码”，即可在浏览器本地解密并预览已加密的 **书签**、**标签页 (Tabs)** 和 **历史快照**。密码仅保存在本地，绝不上传。
    *   **书签查看器**：实时查看用户当前的云端书签树结构。
*   **历史版本时光机**：
    *   **详细差异对比**：直观展示历史版本与当前版本的差异，包括 **新增数量**、**删除数量** 以及具体的 **变更日志**（如 "+ Google", "- 百度"）。
    *   **一键回滚**：支持将云端数据强制回滚到任意历史时间点，并自动触发客户端同步，找回误删数据。
*   **用户管理**：
    *   查看所有用户状态，支持批准/禁用用户或将其设为默认展示用户。
    *   清理幽灵数据，扫描修复数据库异常。

---

## 🚀 快速开始

### 第一步：部署后端 (Cloudflare Worker)

[![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](https://deploy.workers.cloudflare.com/?url=https://github.com/8080713/Bookmark)

> **关于一键部署**：
> “Deploy to Cloudflare” 一键搭建的核心是关联代码仓库与 Cloudflare Pages/Workers，实现自动构建部署。
> *   静态网站优先用 Pages
> *   服务端脚本优先用 Workers
> *   均可通过控制台或 CLI 完成一键部署。
>
> 只需要替换自定义一键部署按钮中的仓库地址，即可降低他人部署门槛。

**手动部署方式**：
本项目依赖 Cloudflare Worker 作为数据中转站（完全免费）：
1.  登录 [Cloudflare Dashboard](https://dash.cloudflare.com/) 并在 **Workers & Pages** 中创建一个新 Worker。
2.  将本项目 `bookmark-sync-worker.js` 的代码完整复制到 Worker 编辑器中并部署。
3.  **配置 KV 存储**：
    *   在 Cloudflare 创建一个 KV Namespace（命名为 `BOOKMARKS`）。
    *   在 Worker 设置 (`Settings -> Variables/Bindings`) 中绑定该 KV，变量名设为 `BOOKMARKS`。
4.  **配置环境变量**：
    *   `p`: 管理面板密码 (用于登录 `/admin`)。
    *   `w`: Web 导航中需要隐藏的文件夹名称（如 `Private,Secret`）。
    *   `SYNC_PASSWORD`: (可选) 后端强制校验密码。

### 🐳 私有化部署 (飞牛 OS / NAS / Docker)
如果您不想使用 Cloudflare，也支持部署在自己的服务器或 NAS (如飞牛 OS、群晖) 上。

#### 方法一：极简一键脚本 (推荐) ✨
无需下载代码，在飞牛 OS (Feiniu OS) 或 NAS 的 **SSH 终端** 执行以下命令即可。
脚本支持**自定义安装路径**（可指定存储卷如 `/vol1/...`）及端口设置。

```bash
# 一键安装/更新脚本
curl -sL https://raw.githubusercontent.com/8080713/Bookmark/main/install.sh | bash
```

> **💡 飞牛OS 用户提示**：
> 运行脚本后，系统会询问**安装路径**。为了方便文件管理，建议输入 `/vol1/1000/docker/bookmark-sync` (根据您的实际卷名调整) 作为安装位置。这样即使重装系统，数据依然保留在存储卷中。

#### 方法二：手动 Docker Compose
如果您更喜欢手动管理容器，可以在任意目录下创建 `docker-compose.yml`：
2.  将文件夹上传至 NAS。
3.  在文件夹根目录运行 `docker-compose up -d --build`。

`docker-compose.yml` 参考内容：
```yaml
version: '3'
services:
  bookmark-sync:
    image: bookmark-sync-server:latest
    build: 
      context: .
      dockerfile: Dockerfile
    container_name: bookmark-sync
    restart: unless-stopped
    ports:
      - "8787:8787"
    volumes:
      - ./data:/app/data
    environment:
      - ADMIN_PASSWORD=admin         # 管理后台密码
      - SYNC_PASSWORD=change_me_please # 同步加密密码
```

### 第二步：安装扩展
1.  下载本项目代码。
2.  打开 Chrome 或 Edge 浏览器的扩展管理页面 (`chrome://extensions/` 或 `edge://extensions/`)。
3.  开启 **开发者模式**。
4.  点击 **加载已解压的扩展程序**，选择本项目文件夹。

### 第三步：配置与使用
1.  点击浏览器右上角的插件图标，展开底部 **“⚙️ 设置 & 高级选项”**。
2.  **Worker API URL**：填入您部署的 Worker 地址 (例如 `https://xxx.your-name.workers.dev`)。
3.  **用户 ID**：任意设置一个标识（多台设备需保持一致以便同步）。
4.  **同步加密密码**：设置一个强密码（**重要：多台设备必须完全一致才能解密数据**）。
5.  点击“保存配置”，即可开始使用！

---

## 🛠 技术栈
*   **Frontend**: Native JavaScript (ES Modules), HTML5, CSS3 Grid.
*   **Backend**: Cloudflare Workers (Serverless), KV Storage.
*   **Cryptography**: Web Crypto API (AES-GCM).
*   **Compatibility**: Manifest V3, Chrome/Edge/Brave.

## ⚠️ 注意事项
*   **密码安全**：请务必牢记您的同步密码。由于采用端到端加密，一旦丢失密码，云端数据将无法找回。
*   **自动同步**：建议在设置中开启“自动同步”。您可以自定义同步间隔（默认每 30 分钟），插件还会在检测到书签变动 60 秒后智能触发同步。

---

**开源贡献**: 本项目部分书签整理算法参考自 SmartMarkr-PRO。欢迎提交 Issue 或 PR 改进功能！