Skip to content

README.md

Latest commit

 

History

History
122 lines (99 loc) · 4 KB

README.md

File metadata and controls

122 lines (99 loc) · 4 KB

LinuxDo Star ⭐ - 收藏助手

学 AI 上 L 站，好帖不错过。

为 linux.do 打造的浏览器扩展，让你轻松收藏帖子和评论。

功能

核心收藏

  • 帖子收藏 — 标题旁 + 操作栏都有星标按钮，一键收藏
  • 评论收藏 — 每条评论操作栏（❤️ 旁边）都有星标，收藏评论自动关联帖子
  • 收藏夹分类 — 创建多个收藏夹（技术、职场、生活…），归类管理
  • 悬浮选择器 — 鼠标悬停星标 500ms 弹出收藏夹选择器，支持搜索和快速新建

管理

  • Popup 预览 — 点击扩展图标快速浏览收藏，按收藏夹分组，可折叠展开
  • 独立管理页 — 完整的收藏管理：搜索、排序、标签、备注、详情面板
  • 导入/导出 — JSON 格式，方便备份和迁移

同步

  • GitHub Gist 同步 — 通过私有 Gist 跨设备同步收藏数据
  • 自动同步 — 收藏变更 30s 后自动上传 + 每 30 分钟定时拉取
  • 智能合并 — 多设备冲突时取并集，单条目以最新修改为准，不丢数据

安装

  1. Clone 本仓库
  2. 打开 Chrome，访问 chrome://extensions/
  3. 开启右上角「开发者模式」
  4. 点击「加载已解压的扩展程序」→ 选择本项目目录
  5. 访问 linux.do 任意帖子页面即可使用

使用

收藏操作

操作 效果
点击星标按钮 收藏到默认收藏夹
悬停 500ms 弹出收藏夹选择器
选择器中选择收藏夹 收藏到指定收藏夹
再次点击已收藏的星标 取消收藏

同步设置

  1. 打开管理页面（popup 右上角网格图标 → "管理全部"）
  2. 点击侧边栏「☁️ 同步设置」
  3. 输入 GitHub Personal Access Token（需要 gist scope）
  4. 点击「连接 GitHub」
  5. 完成！之后会自动同步

Token 创建：GitHub Settings → Tokens → New，勾选 gist 权限即可

项目结构

LinuxDoStar/
├── manifest.json       # Chrome MV3 扩展配置
├── storage.js          # 数据结构 & 持久化
├── sync.js             # GitHub Gist 同步模块
├── background.js       # Service Worker (badge + 同步调度)
├── content.js          # 内容脚本 (注入星标到页面)
├── content.css         # 注入样式
├── popup.html/css/js   # 弹窗预览
├── manage.html/css/js  # 独立管理页面
└── icons/              # 扩展图标

数据结构

{
  "collections": {
    "default": { "id": "default", "name": "默认收藏夹", "icon": "⭐", ... },
    "col_xxx": { "id": "col_xxx", "name": "技术文章", "icon": "💻", ... }
  },
  "bookmarks": {
    "topic_2066807": {
      "topicId": 2066807,
      "topicTitle": "帖子标题",
      "topicUrl": "https://linux.do/t/topic/2066807",
      "collectionId": "default",
      "starred": true,
      "tags": ["标签"],
      "note": "我的备注",
      "posts": {
        "post_12": {
          "postNumber": 12,
          "author": "username",
          "excerpt": "评论内容摘要..."
        }
      }
    }
  }
}

技术细节

Discourse 虚拟滚动适配

Discourse 使用虚拟滚动回收 DOM 节点，传统 MutationObserver 不够可靠。本扩展使用三重检测策略：

  1. MutationObserver — 监听 #main-outlet 子树变化
  2. Scroll 监听 — 滚动时 300ms 防抖扫描缺失的星标
  3. 定时轮询 — 每 5 秒兜底检查

合并算法

同步时使用 union-merge 策略：

  • Collections 和 Bookmarks 取并集
  • 同一条目冲突时比较 updatedAt 时间戳，保留较新版本
  • 不会丢失任何一端的数据

权限说明

权限 用途
storage 本地存储收藏数据
activeTab 读取当前页面信息
alarms 定时同步调度
linux.do 注入收藏按钮
api.github.com Gist 同步 API

License

MIT