Miniflux as Reeder

Tue, 10 Mar 2026 00:00:00 +0000

从 Reeder 迁移到 Miniflux 大概是去年的事。理由很简单：Reeder 只在 Apple 生态里活着，而我越来越需要在 Windows 和 Linux 上也能刷 RSS。自建 Miniflux，浏览器打开就能用，这件事本身没什么好说的。

但有一个功能一直让我有点别扭。

Reeder 里有个手势，长按某条条目，会弹出「标记此条及以上为已读」。这在实际用起来非常顺手——早上堆了一堆，往下翻到昨天看过的地方，长按一下，上面全消。干净。Miniflux 没有这个，每次要么全部标为已读（太粗暴），要么一条条点（太麻烦）。

忍了挺久。前几天终于坐下来看了一眼能不能自己加。

Miniflux 有个功能叫 Custom JavaScript，在设置里，可以往每个页面注入自定义脚本。这给了很大的空间。

思路其实不复杂：监听右键（桌面）和长按（手机），在条目上触发时弹出一个自定义菜单，点击后调用 Miniflux 内置的接口批量标记已读。

接口本身不需要 API Key，Miniflux 页面里已经把 CSRF token 放在 document.body.dataset.csrfToken 里，批量标记的 URL 也能从页面 DOM 里找到（entriesStatusUrl）。换句话说，权限问题已经解决了，剩下的只是怎么触发。

桌面端比较简单，监听 contextmenu 事件，阻止默认菜单，显示自己的就好。

手机端麻烦一点。长按在 iOS 上会和系统的文字选择、链接预览冲突。解决方法是两步：CSS 加上 -webkit-touch-callout: none 禁掉系统的长按菜单，然后事件监听要用 passive: false 加上 preventDefault()，才能真正拦住系统行为。调试这个花了点时间，主要是第一次忘了 passive: false，死活没效果。

最终的逻辑大概是这样：

// 注入到 Miniflux Custom JavaScript
(function () {
  let longPressTimer = null;
  const LONG_PRESS_MS = 600;

  function getEntryId(el) {
    const article = el.closest('article[data-id]');
    return article ? article.dataset.id : null;
  }

  function getAllEntryIds() {
    return [...document.querySelectorAll('article[data-id]')]
      .map(a => a.dataset.id);
  }

  function markAboveAsRead(targetId) {
    const ids = getAllEntryIds();
    const idx = ids.indexOf(targetId);
    if (idx === -1) return;
    const toMark = ids.slice(0, idx + 1);

    const csrfToken = document.body.dataset.csrfToken;
    const url = document.body.dataset.entriesStatusUrl;
    if (!url || !csrfToken) return;

    fetch(url, {
      method: 'POST',
      headers: {
        'Content-Type': 'application/x-www-form-urlencoded',
        'X-Csrf-Token': csrfToken,
      },
      body: new URLSearchParams({ status: 'read', entryIDs: toMark.join(',') }),
    }).then(() => {
      toMark.forEach(id => {
        const el = document.querySelector(`article[data-id="${id}"]`);
        if (el) el.style.opacity = '0.4';
      });
    });
  }

  function showMenu(x, y, targetId) {
    document.querySelectorAll('.custom-ctx-menu').forEach(e => e.remove());
    const menu = document.createElement('div');
    menu.className = 'custom-ctx-menu';
    menu.style.cssText = `position:fixed;z-index:9999;background:#fff;border:1px solid #ccc;
      border-radius:6px;padding:6px 0;box-shadow:0 4px 12px rgba(0,0,0,.15);font-size:14px;`;
    menu.innerHTML = `<div style="padding:8px 16px;cursor:pointer;white-space:nowrap">标记此条及以上为已读</div>`;
    menu.querySelector('div').addEventListener('click', () => {
      markAboveAsRead(targetId);
      menu.remove();
    });
    menu.style.left = `${Math.min(x, window.innerWidth - 220)}px`;
    menu.style.top = `${Math.min(y, window.innerHeight - 60)}px`;
    document.body.appendChild(menu);
    const dismiss = (e) => { if (!menu.contains(e.target)) { menu.remove(); document.removeEventListener('click', dismiss); } };
    setTimeout(() => document.addEventListener('click', dismiss), 10);
  }

  // 桌面右键
  document.addEventListener('contextmenu', (e) => {
    const id = getEntryId(e.target);
    if (!id) return;
    e.preventDefault();
    showMenu(e.clientX, e.clientY, id);
  });

  // 移动端长按
  document.addEventListener('touchstart', (e) => {
    const id = getEntryId(e.target);
    if (!id) return;
    const touch = e.touches[0];
    longPressTimer = setTimeout(() => {
      showMenu(touch.clientX, touch.clientY, id);
    }, LONG_PRESS_MS);
  }, { passive: false });

  document.addEventListener('touchend', () => clearTimeout(longPressTimer));
  document.addEventListener('touchmove', () => clearTimeout(longPressTimer));

  // 禁用 iOS 系统长按菜单
  const style = document.createElement('style');
  style.textContent = 'article { -webkit-touch-callout: none; }';
  document.head.appendChild(style);
})();

贴进去，保存，刷新。右键一条条目，菜单出来了。手机上长按，也出来了。

给 RSS 装了个摘要机器

Mon, 09 Mar 2026 00:00:00 +0000

Miniflux 已经用了挺久了。

订阅了虎嗅、晚点、爱范儿、Hacker News，加上几个英文 newsletter，每天进来三四百条，积压着，像一个永远清不完的待办列表。

读不完是正常的。问题是你根本不知道哪些值得点进去——光靠标题判断，经常要么被骗进去，要么真正有意思的漏掉了。

于是就想：能不能先让 AI 读一遍，告诉我这篇讲了什么？

最初的弯路

最开始想着本地跑个 LLM，省事省钱。sl3 那台机器有 16GB 内存，试了几个量化版本，gemma2-2b 跑得动，但生成速度慢到让人抓狂——处理一篇文章要十几秒，有时候直接超时，摘要还缺斤少两。换 mistral-7b-Q4，吃内存，系统直接开始 swap，基本废了。

本地 LLM 这条路，至少在我这个配置上，做不到每篇文章都处理得过去。

然后想到了 GitHub Copilot。已经在用，API 可以调，后端挂的是 gpt-4o-mini，速度快，token 限制也够用，关键是不用另外付费。就这么定了。

rss_summarizer.py

服务不复杂，一个 Python 脚本，跑在 sl3 上，用 systemd 守护：

每 2 分钟轮询一次 Miniflux API，拉取未读文章
取出正文，喂给 gpt-4o-mini，要求生成 300~500 字的中文摘要，分段
摘要写回文章顶部，用一个带蓝色左边框的 div 包起来，Miniflux 渲染出来有种读内部报告的感觉
原文折叠在 <details> 里，不想看正文就不展开

HN 的处理单独写了逻辑：除了原文，还会把评论区一并抓下来，分两个部分总结——“文章说了什么"和"HN 在聊什么”。两件事有时候差很远。比如某篇介绍新数据库的文章，评论区全在骂作者没提到某个竞品，这种信息只看原文是感知不到的。

有个细节处理起来有点麻烦：Miniflux 有时候拉回来的是全文，有时候只有摘要，得先判断正文长度，太短就去原 URL 再抓一次。网站防爬虫的程度参差不齐，爱范儿直接给全文，虎嗅要带 Cookie，偶尔还是会失败，这种情况就只用摘要凑合。

跑起来之后

每天早上打开 Miniflux，文章顶部已经有一段蓝色的摘要在等着你。

读起来快了很多。很多文章看完摘要就够了，知道发生了什么，不需要点进去；真正有意思的，摘要会让你更容易判断值不值得细读。

有几次摘要比原文写得好——可能模型把废话过滤掉了，核心反而更清楚。这让我有一丝复杂的感受。

HN 的双摘要比较有意思。有时候文章本身很普通，但评论区冒出来一个真在这个领域干了十年的人，随手写了几段干货，比文章值钱多了。现在这些也被收进摘要里了，不容易错过。

然后有一天摘要全没了

用了几天，感觉挺好。然后有一天早上打开，摘要全没了。