Skip to content

Tracker 插件使用指南

Tracker 是 Obsidian 中用于数据可视化和指标追踪的插件,可以将笔记中的数据转化为折线图、柱状图、进度条等可视化图表。

插件特点

特性说明
📈 多图表类型支持折线图、柱状图、面积图、饼图等
🎯 习惯追踪可视化追踪每日习惯和目标
💪 进度条直观展示完成进度
🔄 数据绑定从笔记 YAML 或 Dataview 自动提取数据
🎨 高度可定制颜色、标签、轴配置等均可自定义

安装插件

  1. 打开「设置」→「第三方插件」→ 关闭「安全模式」
  2. 点击「浏览」→ 搜索「obsidian-tracker」→ 安装并启用

基础语法

简单折线图

tracker
type: line
date: 2026-06-01
days: 30
data:
  - path: Journal/Daily
    filter: 正则表达式匹配
    value:

实际示例

tracker
type: line
yAxisLabel: 小时
xAxisLabel: 日期
dateRange: 2026-06-01 to 2026-06-30
folder: Journal/Daily
dataType: number
content: 
  - query: '\d+'
    mode: sum

图表类型

折线图

适合追踪趋势变化:

tracker
```tracker
type: line
title: 每日阅读时长
dateRange: 2026-06-01 to 2026-06-30
folder: Journal/Daily
dataType: number
query: '\d+(?=h)'
lineColor: #4CAF50
showLegend: true
```

柱状图

适合比较不同类别的数据:

tracker
```tracker
type: bar
title: 每周完成任务数
dateRange: 2026-W23
folder: Journal/Daily
dataType: task
xAxisLabel: 星期
yAxisLabel: 任务数
barColor: #2196F3
```

面积图

适合展示累积趋势:

tracker
```tracker
type: area
title: 累计阅读页数
dateRange: 2026-01-01 to 2026-06-30
folder: Book Notes
dataType: number
query: '\d+(?=页)'
fillColor: rgba(76, 175, 80, 0.3)
lineColor: #4CAF50
```

进度条

适合追踪目标完成度:

tracker
```tracker
type: progress
title: 月度目标进度
value: 75
max: 100
showLabel: true
color: green
```

饼图

适合展示占比分布:

tracker
```tracker
type: pie
title: 本周时间分配
data:
  - 深度工作: 20
  - 会议: 8
  - 邮件: 5
  - 休息: 27
```

数据来源

从 YAML 提取数据

在日记中记录数据:

markdown
---
date: 2026-06-09
reading: 2h
exercise: 1h
work: 6h
sleep: 7h
---

# 2026-06-09 日记

Tracker 查询配置:

tracker
```tracker
type: line
title: 每日睡眠时长
dateRange: 2026-06-01 to 2026-06-30
folder: Journal/Daily
dataType: frontmatter
key: sleep
lineColor: #9C27B0
```

从文本提取数据

使用正则表达式匹配:

tracker
```tracker
type: line
title: 每日步数
dateRange: 2026-06-01 to 2026-06-30
folder: Journal/Daily
dataType: text
query: '(\d+)(?= 步)'
lineColor: #FF5722
```

从任务提取数据

tracker
```tracker
type: bar
title: 每日完成任务数
dateRange: 2026-06-01 to 2026-06-30
folder: Journal/Daily
dataType: task-done
barColor: #4CAF50
```

习惯追踪示例

每日习惯追踪

tracker
```tracker
type: panel
title: 习惯追踪
dateRange: 2026-06-01 to 2026-06-30
folders:
  - Journal/Daily
dateFormat: YYYY-MM-DD
items:
  - name: 运动
    path: Journal/Daily
    dataType: checkbox
    value: 1
  - name: 阅读
    path: Journal/Daily
    dataType: checkbox
    value: 1
  - name: 冥想
    path: Journal/Daily
    dataType: checkbox
    value: 1
```

进度仪表盘

tracker
```tracker
type: gallery
title: 本周目标
dateRange: 2026-W24
items:
  - type: progress
    title: 阅读
    value: 4
    max: 7
  - type: progress
    title: 运动
    value: 3
    max: 5
  - type: progress
    title: 冥想
    value: 6
    max: 7
```

使用场景

健康数据追踪

markdown
---
date: 2026-06-09
weight: 70.5
sleep-hours: 7.5
steps: 8500
mood: 4
---

# 2026-06-09 健康日志

财务追踪

markdown
---
date: 2026-06-09
income: 500
expense: 200
savings: 300
---

# 2026-06-09 财务日志

学习追踪

markdown
---
date: 2026-06-09
pages-read: 30
words-written: 500
courses-completed: 1
---

配置选项

选项说明示例
title图表标题title: 每日步数
dateRange日期范围dateRange: 2026-06-01 to 2026-06-30
folder数据来源文件夹folder: Journal/Daily
type图表类型type: line
lineColor线条颜色lineColor: #4CAF50
showLegend显示图例showLegend: true
xAxisLabelX 轴标签xAxisLabel: 日期
yAxisLabelY 轴标签yAxisLabel: 小时

常见问题

Q: 图表不显示?

  1. 确认插件已启用
  2. 检查代码块格式是否正确(```tracker)
  3. 确认数据来源文件存在且包含相应数据

Q: 数据不准确?

  1. 检查正则表达式是否正确匹配
  2. 确认日期格式一致
  3. 检查 YAML 键名是否匹配

Q: 如何自定义样式?

在 Tracker 设置中或通过代码块参数配置颜色、字体等样式。