MarksVault

快速入口

下载：https://github.com/rbetree/MarksVault/releases

开源仓库：https://github.com/rbetree/MarksVault

一句话介绍

MarksVault 是一个面向现代浏览器的书签管理扩展：在保留浏览器原生书签体系的前提下，提供更友好的管理界面，并把书签数据安全备份到你自己的 GitHub 私有仓库，做到“可整理、可追溯、可恢复、可自控”。

解决什么

浏览器自带书签常见痛点是：大量书签难以整理、跨设备迁移成本高、误删后恢复困难、以及缺少可审计的备份链路。MarksVault 将 GitHub 作为用户自有的远端存储：Token 连接后即可在扩展内一键备份/恢复，并支持把书签推送到指定仓库；同时引入任务系统，把“书签变更”“浏览器启动”等事件作为触发器，自动执行备份或同步动作，减少手工操作。对希望把书签纳入个人知识管理与版本控制的人来说，它相当于一个“书签保险箱”。

工程实现上，MarksVault 使用 WXT（Vite）做构建与多浏览器打包，核心入口包括后台 Service Worker（监听书签事件、执行任务）以及 Popup/Options 等 React 页面。数据存储策略也做了分层：GitHub Token 存在 browser.storage.sync 便于跨设备同步，其余业务数据落在 browser.storage.local；同时通过 host_permissions 将网络访问边界限制在 https://api.github.com/*，避免无关域名被误用。

核心亮点

• React + TypeScript + MUI 的 Popup/Options UI，支持列表/网格视图与基础编辑
• GitHub 集成：使用个人 Token 操作私有仓库，实现备份/恢复/推送
• 自动化任务系统：事件触发 + 执行状态跟踪，适配 MV3 Service Worker 生命周期
• 多浏览器支持：Chrome/Edge（Manifest V3）与 Firefox（Manifest V2）分别构建
• 权限与边界清晰：核心权限 bookmarks/storage，GitHub 访问限定 https://api.github.com/*
• 与 MeNav 联动：可将书签推送到导航站仓库，驱动静态站点自动更新书签页

快速开始

git clone https://github.com/rbetree/MarksVault.git
cd MarksVault
npm install
npm run dev

开发模式下在浏览器扩展管理页加载构建产物：Chromium 系为 .output/chrome-mv3-dev（Firefox 见 README 的对应路径）。

需要切换浏览器目标时可用脚本 npm run dev:edge / npm run dev:firefox；生产构建输出目录与 zip 打包方式也在 README 中给出了对应命令与路径，便于发布与分发。