我给我的 Obsidian 实践写了一个插件

leyang · 2023 年7 月 16 日 06:38

本文内容已经过时，更多内容请参考官网 LifeOS！

为一种实用新型 Obsidian 实践之构建我的第二大脑实现 Obsidian 插件！

背景

最近将这个我的 Obsidian 实践（一种实用新型 Obsidian 实践之构建我的第二大脑）分享后，帮助到了几个人

一个不认识的同事用上后，表示『像开启了新大陆』，并给我发了个红包，说请我喝咖啡
一个不认识的网友用上后，表示『满足了她对个人知识管理的全部需求』，甚至还为此写了一篇上手文档

当然，除了陌生人以外，我也推荐给不少熟悉的同事和朋友，收到了不少反馈，比如上手成本高、更新难以跟进、关系图谱中无法区分项目（所有都是 README.md）等。

目标

因此考虑到上述问题，我决定实现一个插件，主要有如下几个目标

降低上手成本，特别针对非程序员群体
更新及时触达，无论是新功能还是问题修复
增加受众，以获得反馈，共建并完善流程

文末我还介绍了一种渐进的使用这个插件的方式！

旧的方式

在未使用插件的示例模版里，存在如下几类的『程序代码』

脚本类

日期解析 date
根据周期笔记的文件名，解析出日期
根据解析出的日期，获取日期范围
根据解析出的日期，获取文件列表
任务查询 task
根据日期范围，获取任务列表
项目查询 project
获取当前项目列表的快照
根据日期范围内，获取项目列表
计算日期范围内，项目的耗时及其占比
领域查询 area
获取当前领域列表的快照
根据日期范围内，获取领域列表

视图类

任务完成视图 taskDoneList
放到周期笔记中，可获取当前日期范围内完成的任务列表
任务记录视图 taskRecordList
放到周期笔记中，可获取当前日期范围内收集的任务列表
项目列表视图 projectList
放到周期笔记中，可获取当前日期范围内项目耗时的占比
领域列表视图 areaList
放到周期笔记中，可获取当前日期范围内领域列表

直接将代码跟随示例模版输出给用户，这大大增加了用户的上手成本，且用户无法更新这些脚本。

新的方式

因此我决定实现一个插件封装上述两类『程序代码』，通过提供『markdown 代码块』的方式提供『视图』，这样用户只要会 Markdown，就能读懂并使用，那么我的插件实现了哪些视图呢？

在上一篇文章中，提到我的实践有两个上下文，让我保持聚焦

一个是基于时间的（周期笔记），即我到达某个时间节点，我就基于对应周期笔记作业，且笔记中有足够的上下文；
另一个是基于主题的（PARA），即我想对某个主题进行调查研究的时候，我就基于对应主题的索引（README.md）作业，且笔记中已经收集了不少上下文；

因此，插件需要实现的视图也是基于这两个上下文，举个例子，比如一篇月记（2023-07），它所拥有的上下文应包含7月份所有的日记和周记内的任务（目前只有任务，但是我觉得可以有其它的）；再举个例子，比如一个 PARA 的项目（分享-2023-WOT 分享会），它所拥有的上下文应包含所有被打上 #WOT 标签的任务和记录；

目前插件提供的视图有如下三大类：

根据时间上下文查询

即下面同一个代码块，放在不同的周期笔记中（月记、周记、日记），均会解析并获得对于时间范围内的『完成任务列表（TaskDoneListByTime）』、『记录任务列表（TaskRecordListByTime）』、『涉及的项目列表（ProjectListByTime）』、『涉及的领域列表（AreaListByTime）』。


```PeriodicPARA

TaskDoneListByTime

```


```PeriodicPARA

TaskRecordListByTime

```


```PeriodicPARA

ProjectListByTime

```


```PeriodicPARA

AreaListByTime

```

根据 PARA 上下文查询

即下面同一个代码块，放在不同的 PARA 目录的 README.md 中（比如 1. Projects/分享-2023-WOT 分享会/README.md），均会查询并获取 README.md 声明的 Metadata tags 字段，并根据这些 tag 查询出『打上该 tag 的任务列表（TaskListByTag）』、『打上该 tag 的记录列表（BulletListByTag）』


```PeriodicPARA

TaskListByTag

```


```PeriodicPARA

BulletListByTag

```

根据目录查询

为了总览当前 PARA，还有一类基于目录的视图，比如查询『当前项目目录下的所有项目（ProjectListByFolder）』、『当前领域目录下的所有有领域（AreaListByFolder）』、『当前资源目录下的所有有资源（ResourceListByFolder）』、『当前归档目录下的所有有归档（ArchiveListByFolder）』


```PeriodicPARA

ProjectListByFolder

```


```PeriodicPARA

AreaListByFolder

```


```PeriodicPARA

ResourceListByFolder

```


```PeriodicPARA

ArchiveListByFolder

```

除了上述视图，插件还提供了在周期笔记模版中使用的辅助函数，目前只有一个，即生成指定目录下的 README.md 文件列表，比如

模版中的如下语句


<% PeriodicPARA.File.list('1. Projects') %>

将会替换为


1. [[1. Projects/x-project/README|x-project]]

2. [[1. Projects/y-project/README|y-project]]

这样项目列表将在日记笔记创建时，被作为快照固化下来，有几个作用

保留每个项目都经历了哪些日子，而且能手动统计每日项目耗时
未来基于日记能统计周记、月记等时间范围内，都有哪些项目，也能统计每周、每月的项目耗时

如何渐进使用这套系统？

在上一篇文章中，提到我的实践是有两套系统的，一个是周期笔记，另一个是 PARA；后来我发现，一上来就两个一起实践，其实上手成本挺高，特别是从未使用过 Obsidian，且不了解 PARA 的用户，我对这类用户的建议是，你大可先只使用周期笔记，把模版中关于 PARA 的一切都剔除，这样你仍能享受到『DailyLog』以及『基于时间的上下文』，即你只管每天记录日记，剩余的汇总和回顾都交给『周记』、『月记』、『季记』、『年记』，等你实践下来有自己的看法和感觉的时候，你可以考虑自顶向下在『周记』和『月记』中安排任务，在『季记』、『年记』设定目标！