在线访问

前往 GitHub 仓库 查看源码。

项目概述

书签浏览器以文件管理器的方式管理书签：使用文件夹、选择、拖拽排序与标准编辑快捷键。所有数据都保存在浏览器 LocalStorage 中，收藏私密且可离线使用。这是无后端、无账号体系的单页 React 前端。

功能概览

• 文件管理器式交互：单选、多选、Shift 范围选择、双击打开、内联重命名。
• 三种视图（卡片 / 列表 / 平铺），可选按文件夹记忆视图。
• 拖拽与循环检测，支持同级排序与跨文件夹移动。
• 属性面板编辑标题、URL、颜色、封面与图标，支持元信息抓取。
• 收藏夹 / 稍后阅读 / 回收站，支持软删除与恢复。
• 撤销 / 重做历史、Netscape HTML 导入导出、中英国际化。

架构

单页 React 应用，持久化到 LocalStorage。无框架领域逻辑位于 src/core/（存储、选择、排序、循环检测、导入导出、元信息、校验）；src/components/ 中的 UI 使用 HeroUI、Tailwind 与 Iconify。完整设计见架构文档。

项目结构

BookmarkHarbor/
├── src/
│   ├── App.tsx               # 应用外壳、状态与编排
│   ├── components/           # React UI 组件
│   ├── core/                 # 无框架领域逻辑与 hooks
│   ├── i18n/                 # i18next 资源（zh、en）
│   ├── styles/               # Tailwind 4、HeroUI 样式、主题变量
│   └── test/                 # Vitest 单元测试
├── docs/                     # 项目文档
├── vite.config.ts            # Vite 8（Rolldown）配置
├── wrangler.jsonc            # Cloudflare 静态资源配置
└── package.json

文档

指南	内容
系统架构	数据模型、领域模块、状态、设计决策、主题。
前端指南	视图、布局、交互、键盘快捷键、设置、无障碍。
开发指南	本地搭建、规范、测试、提交约定。
部署指南	生产构建、Cloudflare Pages、静态托管。