Obsidian 插件：Tracker 图形化笔记的维护状态

概述

将笔记中的变化收集起来，并且提供不同预设的图形分析模板。

效果&特性

使用

1. 在每日笔记中添加一些您想要跟踪的目标。
2. 添加一个新的笔记来显示跟踪器。
3. 手动添加跟踪器代码块（示例）或使用 命令。
4. 将文档视图模式切换为“预览”，然后代码块将被渲染。

有关更多用例，请下载并打开已安装并启用此插件的 Obsidian 中的 示例 文件夹。

您可能想了解的更多细节

• 安装：从 Obsidian 安装插件或手动安装
• 概念：解释此插件的工作原理和设置方法
  • 目标评估
  • 输入参数
  • 表达式
• 示例
• 插件设置
• 发布说明
• 路线图
• 常见问题

基本概念和类型

8 种追踪类型

• tag: 标签

• YAML

• text: 文本

• dvField 的 A:: B 字段

• 字段多值的 A:：B@C

• table

不搜索指定文件夹中的文件，而是直接定位到你给的表，并可以从表中指定的列中检索数据

在这种情况下，“data/Tables”是相关文件的路径。路径（[0]）后第一个括号中的数字是文件中感兴趣的表的索引，从 0 开始。第二个括号中的数字是包含目标数据的列的索引。如果表格单元格中有多个值，您可以提供第三个索引来标识它们。

• 文件元数据

• task

6 种显示方式

• line
• bar
• bullet
• pie
• summary

• month

基本语法结构

最低要求是 searchType, searchTarget 和至少一个输出参数（line, bar, summary, bullet, month, or pie）。

对于输出形式而言，会有一个 X 轴，但是可以有两个 Y 轴。你可以设定轴的最大值，最小值，以及单位，

tracker 的参数

根参数（适用于所有的显示类型）

line 和 bar 图的共用参数

line 的专用参数

bar 的专用参数

Summary 的专用参数

Bullet 的专用参数

month 视图的专用参数

Pie 图的专用参数

追踪类型&追踪目标

追踪多目标

• 如下的代码将可以实现多目标同时追踪，target0 对应 type0,对应 dataset0 对应 red.

searchTarget: target0, target1, target2, ...... 
searchType: type0, type1, type2, .....
datasetName: dataset0, dataset1, dataset2, ......
line:
    lineColor: red, blue, yellow

• 追踪一个字段里设置多个值，比如血压：A/B，则可以分别追踪到血压[0] 和血压[1]。而两者的分割符号，可以通过 separator 来设定从而识别。
• yaml里的嵌套键值对，如：

deepValue:
very:
deep: 2

则追踪该类型时可以写为：

searchTarget: deepValue.very.deep

基本代码书写规范示例

以健康记录，跟踪血压为例

blood-pressure: 120/80

dvTarget:: 120/80

dvTarget:: 120,80

YAML 内 bp: [120,80]

[[journal]]

⭐

搜索多个类似 test@mail,com 这种邮箱结构

后写成.+ 或者.+\都是等价的

搜索文本中的数值，如 weightlifting: 50

数值用括号括起来，并且以 ?\<value> 起头表示

具体来说，weightlifting: (?\<value>[\\-]?[0-9]+[\\.][0-9]+|[\\-]?[0-9]+) 这个正则表达式可以分为两个部分，以|为分界线：

• [\\-]?[0-9]+[\\.][0-9]+：匹配带小数点的数值，其中 [\\-]? 表示可选的负号，[0-9]+ 表示一到多个数字，[\\.] 表示匹配小数点，[0-9]+ 表示一到多个数字。
• |：表示逻辑上的 ” 或 “，用于连接两个不同的匹配模式。
• [\\-]?[0-9]+：匹配不带小数点的数值，其中 [\\-]? 表示可选的负号，[0-9]+ 表示一到多个数字。

其中，(?\<value>...) 表示一个捕获组，用于提取匹配结果中的数值部分，因为 tracker 需要从匹配结果中获取数值来进行跟踪和可视化。

所以，这段代码的含义是匹配文本中以 “weightlifting: ” 开头，后跟一个带或不带负号的数值，其中可能包含小数点，提取其中的数值部分作为跟踪目标。

搜索带数值的一句文本,且使用数字

如：I walked 10000 steps today.

感觉\s+ 代表空格；同时留意整个句子是单引号括起来的

：today is 2009-05-02 取值日期，{4}表示这里有四位数

搜索文本中的多值 ，如 nyvalues 1/2/3

具体来说，正则表达式中的“\s+”表示匹配一个或多个空格。而“[0-9]”表示匹配任意一个数字，“[0-9]+”表示匹配一个或多个数字，“(?<value>[0-9]+)”表示将匹配到的数字串作为一个名为“value”的捕获组，以便在后续的代码中进行引用。另外，“/”字符也需要用“/”来转义，因为“/”在正则表达式中是一个特殊字符。而上文则是分别返回该数字串的第一个，第二个和第三个值（留意 value 的位置。

table,如下：

第一个数字代表该文档的第几个表格，第二个数字代表该表格的第几列，如果表格单元格中有多个值的话，可以增加第三列。如下则会返回该表的第一列日期和 A 列。

task 的检索

searchTarget：后直接写任务名字即可，如果要进一步筛选做没做，则是再 searchType 里写入 task.done/task.notdone

表达式的用法

基本用法

• 运算符（+、-、*、/、% 求余数）和函数（dataset()、sum()、maxStreak()、…etc）

template: ‘Maximum value: {{max() +-*/% 10::i}}

• 使用需要在大括号内
• 如果一个表达式的解析输出是一个字符串，我们可以给它分配一个格式字符串。格式字符串应该放在表达式后面的大括号里，后面有两个冒号。例如，表达式 ”{{sum()::i}}” 将强制输出以整数表示的数字（i 代表整数）。
• 数据集&数据集的运算

Dataset[i] = Dataset1[i] + Dataset2[i]

template: ’ 最大值 (组里的某数 + 组里的某数): {{max(dataset(0) + dataset(0))::i}}’

日期格式

• 除了常规的 YYYY-MM-DD 及其变形日期格式外，还可以输入相对日期

相对日期输入的参考日期是 ‘today’（你电脑的当前日期），所以

• 0d ==> 今天
• 1d ==> 昨天
• 1w ==> 上周
• 1M ==>上个月
• 1y ==> 去年

searchType: tag
searchTarget: weight
folder: diary
startDate: -1M
endDate: 0d
line:
    title: Weight Log
    yAxisLabel: Weight
    yAxisUnit: kg
    lineColor: yellow

• 移除原文中日期的前后缀，输出正确的日期格式

如下文，则原文的日期写法是 D-,那么 D-2021-01-01 显然不是一个正确的日期格式，必须把前面的前缀去除，所以用到这个。同理,suffix-D

searchType: tag
searchTarget: weight
folder: diary
dateFormat: YYYYMMDD
dateFormatPrefix: D-
startDate: D-20210101
endDate: D-20210105
line:
    title: Weight Log
    yAxisLabel: Weight
    yAxisUnit: kg
    lineColor: yellow

以下的例子前后缀都有的日期如何提取

如

• a-20211001-b
• c-20211002-d
• searchType: tag
• searchTarget: weight
• folder: examples/diary
• **dateFormat: YYYYMMDD
• dateFormatPrefix: ‘(a-|c-)’
• dateFormatSuffix: ’(-b|-d)’
• startDate: 20210101
• endDate: 20210105**
• line:

多文本映射 textValueMap

“textValueMap”: { ” 良好 ”: 80, ” 一般 ”: 60, ” 不及格 ”: 40 }

当探测到文本“良好”时，会返回数值 80。

实例

抬头格式

searchType: frontmatter 定义追踪类型

searchTarget: bloodpressure[0], bloodpressure[1]

追踪的具体键 (明显是一个键,多个值,所以用 0,1 来进一步锁定)

• datasetName: systolic, diastolic 把追踪到的数据集分别起名
• folder: examples/diary 追踪的文件定位,如果全选则/
• accum: true 为真则起到叠加累计的效果
• startDate: 2021-01-01 起止日期,也可以只写冒号然后空着
• endDate: 2021-01-31
• fixedScale: 1.0 图标尺寸，默认 1，可以缩放，配合下行
• fitPanelWidth: false 是否将尺寸自适应屏幕宽度
• margin: 10, 10, 10, 0 图表的上右底左边缘空隙

line/Bar: 折线图

折线图单 Y 轴双 Y 值为基础增改

• title: Blood Pressures 图表名称
• yAxisLabel: BP Y 轴的含义
• yAxisUnit: mmHg Y 轴的单位
• yAxisLocation: left, right 如果指定该行，则会显示为左右两个 Y 轴，不指定的话就只显示一个
• yAxisTickInterval: 5 Y 轴的刻度间隔
• yAxisTickLabelFormat: .2f/i Y 轴的小数点保留几位/整数，留意那个点必须写
• yAxisTickLabelFormat: H---m Y 轴坐标格式,如左则为 10---00
• yMin: 55 Y 轴的最小值
• yMax: 100 Y 轴最大值
• reverseYAxis: true 是否将 Y 轴的上下值反转
• xAxisTickInterval: 1w/7d X 轴默认是日期,你可以设置其间隔
• xAxisTickLabelFormat: M-DD X 轴的格式,如左则为 1-15
• showLine: false 只显示点 而不显示线
• showPoint: true
• pointColor: green 点的颜色
• pointSize: 5 点的尺寸
• pointBorderWidth: 2 点的边缘的宽度
• pointBorderColor: “#d65d0e” 点的边缘的颜色
• fillGap: false 可以决定是否链接缺失的点
• lineColor: black, red 折线的颜色
• lineWidth: 4 可以设置线宽,增粗线条
• showLegend: true 是否显示图例
• legendPosition: bottom 图例的放置位置

summary: 文本概述

• ==template: “Average: 模板:” 所用函数== {{average(dataset(0))}}/{{average(dataset(1))}}”

{{ average(键) }},因为原键就是用的 A/B,所以这里沿用,呈现效果

结果 如:

Average: 170.4/116.5

• ==最大连续天数,最大中断天数,当前坚持天数==

template: “Longest Streak: {{maxStreak()}} day(s)\nLongest Breaks: {{maxBreaks()}} day(s)\nLast streak: {{currentStreak()}} day(s)”

• ==进一步 设定 summary 样式==

template: “I have {{sum()}} stars in total.”

style: “font-size:20px;color:black;margin-left: 50px;margin-top:00px;”

• ==最小值出现的日期,最小值,最大值出现的日期,最大值出现的日期==

template: “minDate: {{minDate()}}\nminValue: {{min()}}\nmaxDate: {{maxDate()}}\nmaxValue: {{max()}}”

Bullet 子弹图

searchType: tag
searchTarget: clean-up
folder: examples/diary
endDate: 2021-01-31
fixedScale: 1.1 **整体的大小,包括文字,数字,图表**
bullet:
title: "Clean Up"

dataset: 0 从搜索目标中返回的数据储存在其中,但是该题因为只有一个 X 值,所以似乎不需要储存,删掉该句也可以显示

• orientation: horizontal / vertical 决定了子弹图的方向
• range: 10, 20, 40 对应子弹图的范围划分
• rangeColor: darkgray, silver, lightgray 范围颜色
• value: 12.5 手动输入实际值

or

value: “{{currentBreaks()}}” 记录当前最大的中断天数,日记中是仅仅打了一个 clean-up 的标签,不是一个数值型的键,通过这种方式,展示一个数值型的值

• valueUnit: times 只有一个轴,所以是轴值的单位
• valueColor: ‘#69b3a2’/steelblue 实际值的颜色
• showMarker: true 是否显示目标值
• markerValue: 30 目标值的值
• markerColor: black 目标值小竖线的颜色

Calendar 日历视图

searchType: tag
searchTarget: meditation
datasetName : Meditation **日历的名称**
folder: examples/diary
month: **只挂一个日历的名字也可以**
startWeekOn: 'Sun' **指定某周第一天**
color: tomato **圈圈&年份的颜色**
headerMonthColor: orange **抬头月份的颜色**
dimNotInMonth: false **是否减弱非当前月份的颜色**
todayRingColor: orange **今日圈圈的颜色**
selectedRingColor: steelblue **鼠标点击的日期的颜色**
threshold: 40 **某个数值型的值超过某个门槛后显示圈圈**
circleColorByValue: true **是否根据值区别颜色,也就是达到门槛是正色,没达到就弱色**
showSelectedValue: true **是否显示被挑选日期的值**
initMonth: 2021-09 **如果没有指定月份,则初始月份为 YYYY-MM 格式**

or

initMonth: -1M 以相关月份指定初始月份

• ==多目标的日历追踪==

searchType: tag
searchTarget: exercise-pushup, meditation
datasetName: PushUp(**数值型**), Meditation(**纯标签**) **两个数据集的名字**
folder: examples/diary
month:
mode: annotation 日历注释模式**
startWeekOn: 'Sun'
threshold: 40, 0 **门槛也是俩,但是这里第二个是非数值型**
color: green
headerMonthColor: orange
dimNotInMonth: false
annotation: 💪,🧘‍♂️ **达标后显示为图标**
showAnnotationOfAllTargets**: false **如果为 ture 则会两个图标都显示,如果 false,则仅仅显示第一个图片的情况**
dataset: 0, 1 **如果你是圆圈形式,而非注释形式,则本身的储存和显示的都是一个数组,则应把想将追踪的两个目标放入这两个集**,示例中该句放到了 startWeekOn 上面作为 month 下第一句

• ==追踪表格多数据，显示为日历==

searchType: table
searchTarget: examples/data/Tables\[0]\[0], examples/data/Tables\[0]\[1], examples/data/Tables\[0]\[2], examples/data/Tables\[0]\[3]
xDataset: 0
datasetName: null, Jeffrey, Lucas, Anne X 轴对应的名字就是 null，空。出现日历后点击日历的名字，则三个集合可切换展示**
month:
threshold: 0, 62.2, 20.8, 18.2 **X 轴自然门槛是 0，其他三个参数分别别有门槛**

Pie 图的显示

searchType: **task.done, task.notdone**
searchTarget: Say I love you, Say I love you
datasetName: Done, NotDone
pie:
title: Manual Input Data
label: '{{2/30\*100}}%, {{4/30\*100}}%, {{6/30\*100}}%,{{8/30\*100}}%, {{10/30\*100}}%' **确定扇形上显示的文字是什么**
extLabel: 'DataA {{0.5/28.5*\100}}%, DataB, DataC, DataD, DataE' **长臂标注，可以和 label 同在**
hideLabelLessThan: 0.03 **如果扇形的比例小于某个值，则选择不在其表面标注文本**
showExtLabelOnlyIfNoLabel: true **如果 true,则当某个扇形的比例小于某值时，由于太小不便于显示文本，则启用长臂标注**
data: '2, 4, 6, 8, 10' **确定显示是扇形图形分割，直接输入数字，它就会自动划分好蛋糕，但是不会标注百分比上去，所以需要 label**

or

data: '{{sum(dataset(0))}},{{sum(dataset(1))}}' **这样可以把任务自动传递给 dataset 数据集，并利用 sum 进行统计。同样也可以在 sum()::i ,用个取整数，也对，不影响**
dataColor: '#4daf4a,#377eb8,#ff7f00,#984ea3,#e41a1c'
dataName: Data1, Data2, Data3, Data4, Data5
ratioInnerRadius: 0.5 **内部有圈说明是个甜甜圈图形**
showLegend: true
legendPosition: right
legendOrientation: vertical

追踪表格

examples/data 下文档 Tables 的第二个表格如下：

第一个是指第二个表格的第一列为 X 轴的数据（因为下文未指定其为 Y 轴，

searchType: table

searchTarget: examples/data/**Tables\[1]\[0]**, examples/data/Tables\[1]\[1]\[0], examples/data/Tables\[1]\[1]\[1]
xDataset: 0
separator: "@"
line:
yAxisLocation: none, left, right
lineColor: none, yellow, red

追踪任务

searchType: **task**==or== **task.all**,task.done, task.notdone
searchTarget: Say I love you, Say I love you, Say I love you
folder: examples/diary
summary:
template: " 总计:**{{sum(dataset(0))::i}}**\nHow many days I said love: {{sum(dataset(1))::i}}\nHow many days I didn't say love: {{sum(dataset(2))::i}}"

这里如果不加::i 的话就是显示 31.0，加上就是 31.而至于 dataset(0),dataset(1),dataset(2) 以此往下传递就行，在这里就是起名，并不是从上面那里拿来用的 dataset.

or

template: “Total count: {{sum()}}” 如果是单纯统计总任务，仅仅写 sum 即可。

显示效果如下：

总计的任务:31

How many days I said love: 15

How many days I didn’t say love: 16

追踪文本

• 追踪文本格式如 “weightlifting: 10“.

searchType: text
searchTarget: 'weightlifting:\s+(?<\value>\[\-]?\[0-9]+\[\.]\[0-9]+|\[\-]?\[0-9]+)'
folder: examples/diary
startDate: 2021-01-01
endDate: 2021-01-31
line:
title: Weight Lifting
yAxisLabel: Count
lineColor: yellow

会默认是统计文本出现的次数，但是如果你的里面有值的话，则需要利用（？<\value>XXXXXX）传入才会显示该数值的图 同理 dvField 也是一种文本，只不过冒号改为双冒号，写法一样，你的追踪类型也可以写 text

• 追踪格式如 dataviewTarget:: 76@23

dataviewTarget2::\s+(?<\value>[-]?[0-9]+[.][0-9]+|[-]?[0-9]+)\s+@\s+([-]?[0-9]+[.][0-9]+|[-]?[0-9]+),

中间就是一个@，两边是两个空格\s+

• ==追踪文本中的链接内的信息==

• 在一个名为 MTG-Deck-1 的文档中有四个链接文档
• MTG-Card-1 x1--- 链接文档点开后的内容：{R}{R}
• MTG-Card-2 x2--- 链接文档点开后的内容：{B}{B}{R}{2}
• MTG-Card-3 x2--- 链接文档点开后的内容：{G}{G}{G}{G}{G}{0}
• MTG-Card-4 x5--- 链接文档点开后的内容：{W}

则

searchType: fileMeta, **text**
searchTarget: 'cDate, **{W}, {R}, {G}, {B}, {(?\<value>\[0-9]+)}**'
fileContainsLinkedFiles: examples/data/MTG-Deck-1 **指定限定是搜索指定文档内的链接到的文件**
specifiedFilesOnly: true **意义不明，似乎是只限定在指定的文档中**
fileMultiplierAfterLink: 'x(?\<value>\[0-9]+)' **当从搜索目标返回时，再继续乘以某个参数，这里设定的是指定文档的后缀参数，也就是上文的 x1，x2，x5**
xDataset: 0
pie:
label: '{{sum(dataset(1))::i}},{{sum(dataset(2))::i}},{{sum(dataset(3))::i}}, {{sum(dataset(4))::i}},{{sum(dataset(5))::i}}'
data: '{{sum(dataset(1))}},{{sum(dataset(2))}}, {{sum(dataset(3))}}, {{sum(dataset(4))}},{{sum(dataset(5))}}'
dataColor: lightgray, firebrick, yellowgreen, lightblue, gray

W 在第四个链接里有,一个 W，并返回它前面的乘数 5，相乘，得到 w 对应数字 5.

R 在第一链接里有，2 个 R，返回并乘以前面的 1，等于 2.再加上，R 在第二个链接里，有 1 个，返回并乘以前面的 2，等于 2，2+2=4.诸如此类。这里主要关注如果要在文档内的链接内搜索内容，应该如何写

• 追踪文本转换映射地图，抬头上加一句如下。是原文的 emoji 表情转换为数字显示

textValueMap:

😀: 5

🙂: 4

😐: 3

🙁: 2

😞: 1

追踪字数

searchType: **fileMeta**
searchTarget: **numWords, numChars** **字数，字符串**
folder: examples/diary
startDate: 2021-01-01
endDate: 2021-01-05
datasetName: words, chars
summary:
template: 'Total number of words: {{sum(dataset(0))}}\nTotal number of characters: {{sum(dataset(1))}}'

如果不限定文件夹的话，就会统计全部字数

searchType: fileMeta
searchTarget: cDate, numWords
xDataset: 0
folder: /
summary:
template: "Total word count: {{sum(dataset(1))}}"

更新内容

版本 1.10.0

• 为月视图添加注释模式（示例）
• 为线图和柱状图添加参数 xAxisTickInterval、yAxisTickInterval、xAxisTickLabelFormat 和 yAxisTickLabelFormat（示例）
• 允许在参数 dateFormatPrefix 和 dateFormatSuffix 中使用正则表达式（示例）
• 添加参数 file、specifiedFilesOnly、fileContainsLinkedFiles 和 fileMultiplierAfterLink，以从指定文件中获取数据（示例）
• 添加参数 textValueMap，将文本或表情符号转换为指定的值（示例）
• 修复了一些错误
• 增强了错误信息

版本 1.10.1

• 修复了 iOS 上的“加载插件失败”问题

版本 1.10.2

• 修复了某些 macOS 设备上插件无法渲染的问题

版本 1.10.3

• 允许在输出类型为 month 和 pie 时使用参数 fitPanelWidth
• 修复了图表工具提示的调整大小和定位问题

版本 1.10.4

• 允许在参数 textValueMap 的键中使用正则表达式
• 添加参数 shiftOnlyValueLargerThan，以确定何时进行 valueShift
• 修复了用户报告的错误
• 修复了插件设置中的拼写错误

版本 1.10.5

• 允许在月视图的 initMonth 中使用相对日期值

版本 1.10.6

• 修复了月视图中缺失数据的着色问题

版本 1.10.7

• 允许使用 HTML 图像标签作为表情符号输入

版本 1.10.8

• 修复了将 startDat/endDate 错误地解读为相对日期的问题

版本 1.10.9

• 将制表符替换为空格
• 在 dvField 中接受更多的 Unicode 字符
• 允许文件夹路径中包含表情符号
• 修复了一些错误

!!! 破坏性变更 !!!

从版本 1.9.0 开始，模板变量，例如 ‘{{sum}}‘，已被弃用。相反，Tracker 提供了运算符（+，-，*，/，%）和函数（dataset()，sum()，maxStreak()，…等）来帮助我们进行数据处理。对于之前版本中存在代码块的用户，请将 ‘{{sum}}’ 替换为 ‘{{sum()}}’ 或将 ‘{{sum(1)}}’ 替换为 ‘{{sum(dataset(1))}}‘。有关新表达式的更多信息，请参见 此处。

讨论

若阁下有独到的见解或新颖的想法，诚邀您在文章下方留言，与大家共同探讨。