Featured image of post WeRead2Notion-Pro使用文档

WeRead2Notion-Pro使用文档

Warning

Weread2Notion和Weread2Notion-Pro是两个不同的项目,模板也不相同,切勿用错模板。

WeRead2Notion-Pro不仅仅是将微信读书笔记同步到Notion,它是一个强大的管理系统。

WeRead2Notion和WeRead2Notion-Pro有什么区别主要有如下

  • WeRead2Notion不支持在笔记中添加自己的笔记,每次有新笔记会删除原有的笔记。WeRead2Notion-Pro支持添加自己的笔记,每次更新不会覆盖笔记。
  • WeRead2Notion功能更加简洁,同步速度更快。
  • WeRead2Notion-Pro支持按照年、月、周、日的阅读时长、笔记数阅读数的时间统计,支持数据可视化。所以选用哪个看个人喜好,也可以两个都用。

预览

预览

也可以打开网页版本查看效果:https://malinkang.notion.site/9a311b7413b74c8788752249edd0b256?pvs=74

下面给大家讲解一下如何使用:

Fork工程

打开Weread2Notion-Pro,点击右上角的Fork(顺便点个star谢谢)

获取微信读书Cookie

  1. 浏览器打开网页版微信读书扫码登录
  2. 按F12进入开发者模式,依次点网络->文档,然后选中weread.qq.com,下拉找到Cookie,复制Cookie值

Tip

如果没有内容显示,请刷新下浏览器。

建议使用Chrome浏览器,有的小伙伴使用QQ浏览器拿到的Cookie一直不能用。

授权

  1. 浏览器打开 https://api.notion.com/v1/oauth/authorize?client_id=f86ce456-f9cb-4cd5-8e4b-07bd9e18a8f8&response_type=code&owner=user&redirect_uri=https%3A%2F%2Fnotion-auth.malinkang.com%2Fweread2notionpro-oauth-callback

  2. 然后点击Next->Allow access

授权

授权

  1. 点击复制按钮,复制NOTION_TOKEN和NOTION_PAGE的值。

复制

在Github的Secrets中添加变量

  1. 打开你fork的工程,点击Settings->Secrets and variables->New repository secret

  1. Name输入WEREAD_COOKIE,Secret输入框中填入你前面获取的微信读书Cookie,然后点击Add secret

  1. 同理,继续点击New repository secret,分别增加变量NOTION_TOKEN和NOTION_PAGE。最终的结果如下图所示。

Warning

注意这三个变量名一定要填写正确,一个字母都不能错,否则会同步失败。

运行

上面配置完成之后,打开你Fork的项目,依次点击Actions->weread note sync-> Run workflow,就可以运行了。

以相同的方式运行read time sync。weread note sync主要用来同步书籍、笔记和划线。read time sync 用来生成热力图和同步阅读时长。

问题排查

  1. 可以点击你Fork项目的Action,查看运行状态,绿色是成功,红色是失败。

Warning

运行成功,只代表程序没有出错,不代表就一定同步数据,比如微信Cookie过期就不会报错。所以如果运行成功,Notion中没有数据的话,也可以通过下面第2步来查看日志

2.可以点进去查日志,来自行排查问题。

问题解答

  1. 如何自动运行

Github Action提供每日定时自动运行程序的功能。之前有的朋友会问,我关了电脑会同步吗,该脚本运行在Github的服务器上,并不是运行在你的电脑上,所以你关机并不会影响程序自动运行。

  1. 每天何时同步

笔记设置的是utc时间的0点同步,如果你在中国,那就是每天8点同步。不过据我观察,Github这个可能有延迟。时间同步是每3个小时运行一次。你也可以自行修改同步时间,具体参考这里。需要注意的是Github每个月2000分钟有免费的额度,如果改的过于频繁可能会导致额度不够。

  1. 模板中哪些可以修改

Database中的Formula和Rollup类型的属性名可以修改,其他的属性名不支持修改,因为代码中是通过属性的名字来增加修改这个属性的,修改了名字程序就无法正常运行。要修改数据库的名字需要按照以下步骤。 依次选择Settings->Secrets and variables -> variables-> New repository variable。

具体的变量名可以参考下表中的变量名,值为你想要修改的名字。

变量名 当前数据库的名字
BOOK_DATABASE_NAME 书架
REVIEW_DATABASE_NAME 笔记
BOOKMARK_DATABASE_NAME 划线
DAY_DATABASE_NAME
WEEK_DATABASE_NAME
MONTH_DATABASE_NAME
YEAR_DATABASE_NAME
CATEGORY_DATABASE_NAME 分类
AUTHOR_DATABASE_NAME 作者
CHAPTER_DATABASE_NAME 章节

除此之外,其他数据可以任意修改,包括页面的布局都不会影响程序运行。

  1. 年月周天中的进度是什么

这里的进度我设置的是每天1小时,每周7小时,每月30小时,每年365小时。你可以自行修改公式设置你的进度。

  1. 表中的时间是什么

如果这本书你读完了,时间是读完的时间,如果没有读完,就是你最后阅读的时间。表中的日,周,月,年都是根据这个时间来设置的。

升级

如果我添加了新功能,你需要将自己的代码与我的代码进行同步。打开你Fork的项目,点击Sync fork进行同步,如果有冲突可以点击Discard那个按钮 image-20240326113307149

捐赠

如果你觉得项目对你有帮助,可以捐赠。我也会不断的优化项目,并做出其他开源的项目。

微信

支付宝

付费解答

有问题先自行解决,往往失败都是一些小细节没注意导致的。我的文档写的已经足够详细,按照文档来操作基本都能成功。你也可以尝试在群里咨询。不要直接加我微信来让我来解答,这个项目我已经投入了大量时间来开发维护,实在没有更多的精力来一对一解答。如果实在解决不了,可以付费一对一咨询,30元一位。付完款可以微信私聊我。

欢迎加入微信群讨论。使用中遇到的任何问题,包括Notion的使用,微信读书组队打卡,后续的更新都会在群里讨论。

群

Built with Hugo
Theme Stack designed by Jimmy