思源笔记插件开发记录(一)

作者在2025年初从Obsidian转向国产笔记软件思源笔记,认为其多端同步、数据库、双链系统和开源特性更符合需求。由于软件功能较为简陋且插件生态不成熟,作者开始自主开发插件。首款插件“空文档清理”解决了日记插件留下的空白文档问题。随后开发了“读书笔记”插件,支持书籍信息导入、模板生成和微信读书同步,极大便利了阅读记录需求。此后又推出“主页”插件,集成常用文档、快捷功能等组件,成为日常使用频率最高的工具。作者希望通过分享开发历程,推动思源笔记生态的建设。

背景介绍

第一次接触思源笔记这款软件是去年(2025)年初寒假在家。

那时候还在用 Obsidian 做笔记,但前前后后用了三年多感觉还是不满意,中间甚至有过好几个月没打开 Obsidian 的情况。

那时在家无聊所以就看了一下笔记软件相关的东西。发现思源笔记这款软件似乎还不错,就下载来体验了一下。

同时这款软件是国产的,在操作和适配方面感觉就更加适合我了。

很多人可能对国产软件存在"鄙视"的心理,这也不怪,都是国产软件过去这么多年种下的果子。

但是最近几年在我尝试了各种国产的替代软件后发现已经很不错了,完全不比国外差,反而更好,操作逻辑我也更加喜欢。

上手思源笔记后几乎就是一瞬间我就决定完全由 Obsidian 叛变了。

  • 很方便的多端同步
  • 数据库系统(虽然比不上 Notion,但是满足我个人需求了)
  • 双链系统(可以完全替代 Obsidian)
  • 完全开源可自定义

上面几点单独拿出来可能都有更好的软件替代,但是这几个加在一起,虽然没一个可能会差一点,但我感觉完全够用了。

开发动机

用了一段时间后,感觉思源笔记最大的缺点就是:简陋

很多想要的功能都没有,要实现一个功能很麻烦。加上思源笔记的插件社区还很薄弱(目前也只有两百多个,而 Obsidian 有近三千个),所以渐渐的就萌生了自己开发插件的想法。

插件介绍

空文档清理

当时开始用思源笔记,在使用一款日记插件的时候会遇到一个问题。这款插件可以在每天自动创建并打开今日日记,但是有时候我不会去记录,这一天就是空着的。久而久之就会多出来很多空的日记文档。

虽然里面啥也没有,但也是会占用少量空间的。在插件市场搜索一番无果后就开启了插件的开发路程。

所以我开发发布了的第一个插件为空文档清理

GitHub - Glaube-TY/siyuan-empty-doc-cleaner
Contribute to Glaube-TY/siyuan-empty-doc-cleaner development by creating an account on GitHub.
github.com
空文档清理.webp

通过这款软件的开发,我逐渐熟悉了思源笔记的代码逻辑。

读书笔记

不久后我就开始了开发我一直想要的读书笔记插件(一开始叫豆瓣读书):

GitHub - Glaube-TY/siyuan-douban: 为思源笔记提供便捷的读书笔记管理功能,包括豆瓣书籍信息获取、自动生成读书笔记、同步微信读书笔记。Provide convenient reading note management features for Siyuan Notes, including Douban book information fetching, auto
为思源笔记提供便捷的读书笔记管理功能,包括豆瓣书籍信息获取、自动生成读书笔记、同步微信读书笔记。Provide convenient reading note management features for Siyuan Notes, including Douban book information fetching, automatic reading note generation, ...
github.com
读书笔记.webp

我平时很喜欢看书,在用 Obsidian 的时候就一直在做读书笔记。

迁移过来的一个原因也是因为思源笔记的数据库可以很方便的管理书籍。

之前在 Obsidian 的时候,我就已经使用 Quicker 软件为其开发了一个读书笔记的动作。

读书笔记 - by Glaube_TY - 动作信息 - Quicker
Quicker,Windows效率工具。快速触发 + 自动化。
getquicker.net

来到思源笔记后催使我开发插件的最大动力就是这个书籍的一键导入。

因此我就开发了这样一款插件。这款插件以上线就获得了大家的一致好评。

插件一开始只有书籍信息导入数据库的功能,后面逐步完善实现了读书笔记模板、同步微信读书等功能,也算是完全符合了我个人阅读做笔记的习惯了。

主页插件

在这之后使用思源笔记的过程中也遇到了一些不方便的地方,比如收藏打开常用文档、查看最近文档、以及一些其他的快捷功能。

思源笔记中有组件可以实现部分,但是需要用单独的文档放置,这也增加了不便利性。

所以后面就慢慢萌生了制作一个多功能的快捷插件。

经过一段时间的思索尝试后,便有了主页插件:

GitHub - Glaube-TY/siyuan-homepage: 为思源笔记提供一个可高度定制的信息聚合页面 Provide a highly customizable information aggregation page for Siyuan
为思源笔记提供一个可高度定制的信息聚合页面 Provide a highly customizable information aggregation page for Siyuan - Glaube-TY/siyuan-homepage
github.com
主页插件.webp

主页插件中通过不同的组件实现不同的功能,所以我可以在里面随意添加想要的功能。

对于这个插件我平时用的时候其实也不会用到所有的组件,只用到了其中一部分必须的组件。

开发其他看似没啥作用的组件,一方面是对自己编程能力的训练,另一方面也肯定有人会用得到。

这个插件将会是我持续开发下去的插件了,也是我每天用的最多的插件。


以上就是我目前开发出来的思源笔记插件,除此之外还有一个彩色图标库,就不具体赘述了。

这里我打算把我的开发历程一点点写出来,供大家参考学习~