感谢竹白，以及如何支持竹白用户的迁移 | 歌词经理

2 月竹白发布下线公告的当天，我发了「🚚 指南：从竹白（zhubai.love）迁移到 Quaily」。

倒不是手有多快，而是 Quaily 很早就支持从竹白导入了~

截止到 2025 年 3 月 31 日，共计迁移了 31 个频道，1715 篇文章，9845 位订阅者。

他们是：

竹白的网站是一个 Web App，所以常规的爬虫抓不到内容。

所以用了 headless chrome 来抓取内容。

例如，如果要获得文章的标题，发布日期等内容，就在 headless chrome 里运行这一段：

function get() {
  const h1 = document.querySelector('h1');
  const meta = h1.nextElementSibling;
  const content = meta.nextElementSibling;
  const metaSpans = meta.querySelectorAll('span');
  let dateString = '';
  let premium = '0';
  if (metaSpans.length >= 2) {
    dateString = metaSpans[1].innerText;
  }
  if (meta.innerText.indexOf('付费内容') !== -1) {
    premium = '1';
  }

  const cover = content.querySelector('figure');
  let img = null;
  if (cover) {
    img = cover.querySelector('img');
  }

  return {
    title: h1.innerText,
    date: dateString,
    content: content.innerHTML,
    cover: img ? img.src: '',
    premium: premium,
  }
}

而要获得文章列表，则运行这一段：

function getArticles() {
  const links = document.querySelectorAll('.PublicationPage_item__38S6L');
  let freeLinks = [];
  let paidInfo = [];
  for (let i = 0; i < links.length; i ++) {
    const slug=links[i].href.substring(8, links[i].href.indexOf('.zhubai.love'))
    freeLinks.push(`./quail-prod -c ../../config.prod.yaml import -t zhubai -l ${slug} --url='${links[i].href}'`);
    const timeEl = links[i].querySelector('.PublicationPage_time__1xXKG')
    let time = timeEl.innerText.trim()
    // check the first character is digit or not
    if (!/^\d+$/.test(time[0])) {
      time = time.substring(1).trim()
    }
    const paidTagEl = links[i].querySelector('.PublicationPage_paidTag__vwcz8')
    const titleEl = links[i].querySelector('.PublicationPage_title__1pSF4')
    if (paidTagEl && titleEl) {
      paidInfo.push({
        slug,
        title: titleEl.innerText.trim(),
        time
      })
    }
  }

  let paidSql = [];
  for (let i = 0; i < paidInfo.length; i ++) {
    paidSql.push(`update posts set first_published_at = '${paidInfo[i].time}' where title = '${paidInfo[i].title}' and slug='${paidInfo[i].slug}';`)
  }
  return {
    freeLinks,
    paidSql
  }
}

NOTE

这里对收费文章区分对待，是因为爬虫抓不到收费文章的内容，但是可以抓到收费文章的时间。
把时间记录一下是有用的，看到后面就知道了。

于是，对于免费文章，无论是否有竹白提供的导出数据，只要得到了作者授权，就可以无缝迁移到 Quaily 了。

三月开始，竹白提供了数据导出，可以导出订阅数据和文章数据。

文章数据里也包括付费的文章，但是实际使用这些数据的时候有两个问题：

于是上一个脚本中，抓取付费文章的发布时间就有用了：

使用竹白导出数据完成收费文章的导入以后，再更新一下付费文章的发布时间，那么文章排序才是正确的。

最终完整的文章导入流程变成：

相比内容导入，订阅者导入要简单得多。

竹白导出的订阅信息是一个 csv 文件，大概是这样的格式：

我有一个专门的脚本来转换各类订阅信息到 Quaily 的 JSON 订阅格式，其中也包括竹白导出的 csv。

但大量导入很容易命中 ESP 的风控，所以这个脚本会把订阅信息拆分成很多份，每一份都是一个单独的 json 文件。

然后这些 json 文件会被提交给 Quaily 的任务调度程序，这个程序会自己去安排导入任务。

调度程序部署好任务以后，会返回预计完成时间，我会把这个时间通过邮件回复给让我帮迁移的作者。

最后，我自己维护了一个 Google Sheets 来记录迁移的进展

一些作者在竹白上发了迁移公告，还没有邮件联系我，我已经把内容给迁移完毕了。

于是当他们给 Quaily 发邮件时，我会回复内容已经迁移完了，他们会很开心。

这是因为对于新创建的 Quaily 频道，我会得到通知。然后我会去看看竹白上有没有同名的。如果有的话，并且作者声明授权的迁移目的地也对得上，就可以直接迁移了。

这样的体验比较好。

观察了一些作者的使用习惯以后我发现：

最后挑选了一些中文作者可能感兴趣的话题，在文章「✉️ 给中文创作者朋友的信」一起集中介绍，并在迁移邮件中推荐作者阅读和订阅。

Quaily 刚刚起步时，就收到了不少竹白作者的信任——像 一石千浪，DEX 周刊 和 AIGC Weekly，都是最初就选择了 Quaily 的几位。也正因为大家的鼓励，我才有了更多前进的动机。

没想到到了最后，Quaily 的导入在竹白下线时也帮到了更多作者。

感谢竹白和竹白的创作者，有了大家，Quaily 才像今天这样具备一定的承载力，也让我有机会遇见你们。

以上。