# 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-01-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 书签管家 (Bookmark Manager)

一个功能强大的 Chrome 书签管理扩展程序，集成了重复清理、死链检测、智能归档以及 Cloudflare 云同步功能。旨在帮助用户从杂乱无章的书签库中重获秩序。

## ✨ 核心功能

### 1. 🔍 深度搜索与验证
*   **多维搜索**：支持按标题、URL 或仅小写文本组合搜索。
*   **有效性验证**：对搜索结果或全库进行后台 HTTP 请求验证（并发检测）。
*   **快捷清理**：直观展示有效/无效状态（颜色标记），支持对检测出的死链（404/Timeout）进行“直接删除”操作，无需进回收站。

### 2. 🧹 智能整理
*   **重复书签清洗**：
    *   **完全重复**：精确检测 URL 完全一致的冗余书签。
    *   **相似书签**：基于 Dice 系数相似度算法，智能识别同一域名下标题或路径高度相似的“伪重复”书签。
    *   **智能选择策略**：支持一键“保留最新”、“保留最旧”、“保留 URL 最长/最短”或“保留标题最长/最短”。
    *   **秒级响应**：优化的状态管理逻辑，批量删除后界面即时更新，无需重复扫描。
*   **空文件夹清理**：递归扫描目录树，识别并一键清理不包含任何有效书签的空层级。
*   **异常书签扫描**：批量扫描书签库，识别空链接、无效格式、超时及错误状态码的书签。

### 3. 📂 智能归档
*   **高性能预览引擎**：深度优化的渲染逻辑，即使面对数千条书签也能秒级生成归档预览，告别卡顿。
*   **多种归档模式**：
    *   **按域名归档**：自动提取 URL 主域名进行聚合。
    *   **按文件类型**：自动识别 PDF, Docs, Code, Images 等特定文件类型。
    *   **按来源目录**：基于原有的文件夹结构进行合并整理。
*   **灵活控制**：支持关键词过滤、按分组筛选，并可手动调整特定书签的归档目标。

### 4. ☁️ 云同步与导航 (Cloudflare集成)
*   **Serverless 后端**：配套 Cloudflare Worker 脚本 (`bookmark-sync-worker.js`)，无需购买服务器。
*   **多端同步**：配合扩展程序实现浏览器书签的实时云备份。
*   **Web 导航站**：自动将您的书签数据渲染为美观的在线导航页，支持无限层级目录展示。
*   **时光机**：后端自动保留最近 10 个版本的快照，支持随时回滚。

### 5. 🛡 安全与体验
*   **回收站机制**：默认的整理删除操作会将书签移动到专用的“❌ 书签回收站”文件夹，防止误删（支持“直接删除”选项）。
*   **操作撤销**：关键整理操作（如移动、归档）支持“撤销上一步”功能。
*   **隐私保护**：支持配置“屏蔽词”，敏感文件夹在 Web 导航端自动隐藏。
*   **个性化定制**：
    *   **主题切换**：内置深色 (Dark) / 浅色 (Light) / 跟随系统主题。
    *   **多语言**：支持简体中文和 English。

## 🛠 技术架构
*   **Extension**：Manifest V3, Pure JavaScript (ES Modules), CSS Variables.
*   **Backend**：Cloudflare Workers, KV Storage.

---

## 🚀 后端部署 (Cloudflare Worker)

如果您需要使用云同步和 Web 导航功能，请按照以下步骤部署后端：

### 1. 创建 Worker
1.  登录 [Cloudflare Dashboard](https://dash.cloudflare.com/)。
2.  进入 **Workers & Pages** -> **Create Application** -> **Create Worker**。
3.  命名为 `bookmark-sync`，点击 **Deploy**。
4.  点击 **Edit code**，将本项目 `bookmark-sync-worker.js` 的内容完整复制粘贴到编辑器中。
5.  点击 **Save and deploy**。

### 2. 配置 KV 存储
1.  在 Cloudflare 控制台侧边栏点击 **KV**。
2.  点击 **Create a Namespace**，命名为 `BOOKMARKS`。
3.  回到 Worker 设置页，**Settings** -> **Variables/Bindings**。
4.  在 **KV Namespace Bindings** 下点击 **Add binding**：
    *   Variable name: `BOOKMARKS`
    *   KV Namespace: 选择刚才创建的 `BOOKMARKS`

### 3. 环境变量配置
在 Worker 的 **Settings** -> **Variables/Bindings** -> **Environment Variables** 中可配置：
*   `d`: 后台管理入口路径 (默认 `/admin`)，建议修改以隐藏入口。
*   `p`: 后台管理密码 (默认 `admin`)，**请务必修改**。
*   `w`: 屏蔽词列表 (逗号分隔)，例如 `Secret,Private`。

## 📦 安装扩展
1.  打开 Chrome 浏览器，进入 `chrome://extensions/`。
2.  开启右上角的 **开发者模式 (Developer mode)**。
3.  点击 **加载已解压的扩展程序 (Load unpacked)**。
4.  选择本项目的根目录即可使用。

## 🤝 致谢 (Credits)

本项目的部分核心逻辑（如书签去重算法、相似度计算）参考或衍生自开源项目：
*   [SmartMarkr-PRO](https://github.com/afei8732/SmartMarkr-PRO) by @afei8732

感谢原作者的开源贡献。