Notebox — Chrome 扩展

为已添加的主站自动记录浏览条目，支持收藏与关闭即清理。以「主站」为单位管理页面，主站为 eTLD+1 顶级域名（如 docs.searxng.org → searxng.org）。

功能概览

• 添加主站：点击工具栏 Notebox 图标打开弹窗，或在任意页面点击右下角悬浮球打开页面内面板；点击「添加当前页主站」将当前页主站加入并创建第一条条目。所有已打开的面板/弹窗会监听存储变更，数据保持一致（在 A 页添加后，B 页打开的面板会自动刷新）。
• 自动记录：之后在同一主站下新开标签页或同一标签页内跳转/重定向到该主站的任意页面时，都会自动在该主站下新增或更新条目（地址一旦变化就更新，不等到页面加载完成）；只有用户主动关闭该标签页时，若条目未收藏才会被删除（整窗关闭不删）。
• 收藏：单个条目可标记为收藏；收藏的条目在关闭标签页时不会被删除。
• 关闭即清理：在扩展内点击条目的「关闭」，或直接关闭该标签页时，若条目未收藏则从列表中删除；整窗关闭时不处理（不删条目）。
• 主站图标：主站 favicon 在后台拉取并缓存到本地（chrome.storage.local），列表优先显示缓存图标，加载更快且不依赖外网。
• 主站排序与删除：主站列表支持拖拽调整顺序（持久化）；可将主站拖到「拖到这里删除主站」区域，确认后删除该主站及其下全部条目。主站仅能由用户显式删除，不会因条目被删或 tab 关闭而自动移除（即便该主站下已无条目也会保留）。

安装方式

1. 安装依赖并构建：

   cd plugin_notebox
   npm install
   npm run build

2. 打开 Chrome：chrome://extensions
3. 打开右上角「开发者模式」
4. 点击「加载已解压的扩展程序」
5. 选择项目下的 dist 目录

构建产物在 dist/，扩展会从该目录加载。

开发

• npm run dev — 开发模式（Vite）
• npm run build — 生产构建
• npm run build:icons — 从 public/icons/source-box-open.svg 生成 16/32/48/128 PNG 扩展图标（需先 npm install）
• npm run test — 运行单元测试
• npm run test:watch — 监听模式运行测试

技术栈

• 语言：TypeScript（popup + service worker）
• 构建：Vite，输出 Manifest V3 扩展
• 主站解析：tldts（Public Suffix List，eTLD+1）
• 存储：chrome.storage.local

更多实现逻辑与架构见 docs/architecture.md。