# bookmark-manager

**Repository Path**: deepplayer/bookmark-manager

## Basic Information

- **Project Name**: bookmark-manager
- **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-08-12
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bookmark Manager

前端书签管理工具：合并多个 Chrome 导出的书签文件，去重统计，编辑与批量管理书签，一键下载合并结果。全部在浏览器本地完成，书签数据不会上传到任何服务器。

## 功能

- **多文件上传**：点击或拖拽上传多个 Chrome / Firefox / Safari 导出的书签 HTML（Netscape Bookmark 格式）
- **解析容错**：兼容 Firefox/Safari 的 `<HR>`、`<DD>`、`ICON_URI`、`SHORTCUTURL` 等扩展；未闭合标签按层级自动收尾；非法文件/解析错误会标记为无效文件并显示原因
- **合并去重**：同名文件夹递归合并，书签按 URL 去重（忽略 `#` 锚点片段），并记录每条去重来源
- **增量编辑保持**：删除、移动、新建文件夹、排序等编辑在**增删文件后不会丢失**（编辑覆盖层自动重放）；合并树与源文件解析结果相互隔离
- **统计**：读取书签总数 / 合并后书签数 / 去重数量 / 合并后文件夹 / 合并文件大小
- **去重明细抽屉**：点击「去重数量」卡片查看每条被去重的书签（名称、URL、来源文件、所在文件夹、保留自谁）
- **单条编辑**：修改书签名称、网址、所在文件夹（支持自定义路径，自动创建文件夹）
- **批量修改**：
  - 树形结构展示（书签行两行：名称 / 网址 · 来源文件），文件夹展开/收起，点击行或勾选选择
  - 删除、移动到文件夹（含 A/B 两种迁移模式：保留结构 / 平铺，选项卡选择）
  - 文件夹重命名；拖拽排序（同级按悬停位置插入）、拖拽跨文件夹移动
  - 书签网站 favicon 展示（优先站点 `favicon.ico`，超时降级第三方图标服务，支持多协议）
- **下载**：合并结果导出为 `bookmarks-merged_年_月_日.html`，可直接在 Chrome / Edge 导入
- **主题**：浅色 / 深色 / 跟随系统，选择持久化到本地
- **多协议支持**：书签 URL 不限于 http/https（ftp/ws/mailto/chrome 等），tooltip 与 favicon 均兼容
- **tooltip 增强**：截断内容悬停显示完整文本，支持复制按钮、跳转链接（新标签页打开），悬停浮层不消失，带出现/消失动效
- **移动端适配**：响应式布局，触屏可点击查看被截断内容的 tooltip

## 技术栈

- Vue 3（`<script setup>`）+ TypeScript + Vite
- 书签解析/合并/序列化为纯 TypeScript 库，无 DOM 与第三方依赖（`src/lib/bookmarks/`）
- 无 UI 框架、无后端，全部本地处理
- 复用组件：`BaseDrawer`（底部抽屉，拖拽关闭）/ `ConfirmDialog` / `FolderPicker` / `SegmentedControl` / `TooltipTrigger` / `StatCard` / `BaseModal` 等

## 开发

```sh
pnpm install
pnpm dev        # 本地开发
pnpm build      # 类型检查 + 生产构建
pnpm test       # 单元测试（Vitest）
pnpm preview    # 预览构建产物
```

## 目录结构

```
src/
  components/       UI 组件（抽屉/树/列表/弹窗/主题切换等）
  composables/      组合式函数（useMerge/useTooltip/useFavicon/useTheme）
  lib/bookmarks/    书签解析、合并、树操作、序列化（纯 TS 库）
  styles/base.css   全局样式（含暗色主题覆盖）
  types.ts          共享类型
  utils/            URL 工具（链接识别等）
```