数据库参考(.base)

更新日期:2026-11-03

本页列出.base文件可以包含的全部内容,以及Plainva对每一部分的处理方式:每个顶层键、每种筛选写法、每种视图类型及其选项、汇总、排序、限制,Plainva不认识的键会怎样,以及Plainva与Obsidian Bases行为不同的地方。它描述的是Plainva的代码目前读取、计算和写入的内容,而不是Obsidian的文档。

日常使用请先阅读数据库(.base)。工具直接写入仓库文件时必须遵守的规则,以及完整的关联示例,见文件格式参考。

概览

文件中的部分Plainva的处理
filters读取并应用筛选下所列的数据来源(文件夹、标签)和条件
views读取全部八种视图类型,以及它们的顺序、排序、筛选和汇总
properties读取列的结构、显示名称和Plainva的plainva块
summaries(视图内)计算十四种内置汇总
formulas保留在文件中,不计算
summaries(顶层)保留自定义汇总公式,不计算
this暂不支持
其他键保留在文件中(见Plainva不认识的键)

顶层键

.base文件是YAML,带有以下顶层键。它们全部可选;没有views的文件会打开为一个表格。

键内容在Plainva中
filters哪些笔记属于该数据库(数据来源)读取并应用
properties每列一个条目,以属性ID为键读取;Plainva的附加内容存放在其plainva块中
views视图列表读取;每个视图都需要name
formulasObsidian公式,name: expression原样保留,不计算
summariesObsidian自定义汇总公式原样保留,不计算

Plainva从不写入其他顶层键:Obsidian会拒绝打开带有它不认识的键的.base。很旧的Plainva版本写入的顶层columns:键仍会被读取,并在下次保存文件时移入properties。

属性(properties)

属性ID

属性ID给一列命名。共有三种:

ID含义示例
note.<key>笔记Frontmatter中的一个键note.status
file.<field>关于文件的一项信息(见文件字段)file.mtime
formula.<name>formulas中的一个Obsidian公式formula.price_per_unit

properties的键、视图的order以及sort[].property都使用这些ID。在筛选表达式内部和plainva块内部,Frontmatter的键直接写作裸键(status);筛选表达式同样认得note.status。

当笔记中键的大小写与列不同时(Due对应列due),Plainva仍会在该列中显示这个值,并按笔记自己的写法把更改写回去。

显示名称

properties.<id>.displayName是Obsidian的列标签。Plainva把它显示为列标题并保留它。没有它时,Frontmatter的键会以首字母大写显示(仅在屏幕上);文件字段有各自的名称,例如名称、修改时间、大小、路径、待办清单和来自文件名的日期。

列的plainva块

Plainva为一列添加的所有内容都存放在properties.<id>.plainva之下。Obsidian会忽略它。

键值含义
input字段类型(见下方列表)该列的字段类型
ratingMax数字,1到10评分有多少个标记(默认为5)
ratingGlyph一个字符评分绘制的标记(默认为圆点)
options选项列表单选、状态和多选的固定值
relationBase相对于仓库的.base路径关联所指向的数据库
relationLimitone关联只保存恰好一个链接;缺省表示不限制
reverseOf{ base, property }计算得出的反向关联列
rollup{ through, of, fn, where }计算得出的汇总列(见关联汇总)
previousKeys最多8个旧名称的列表让评论在列被重命名后仍能找到它

字段类型(input)

text、number、rating、checkbox、date、datetime、select、status、multiselect、list、tags、url、email、phone、relation。

另外还会读取两种较旧的写法:multi-select按multiselect读取,link按relation读取。没有input的列——或者input的值不在此列表中的列——其类型由笔记中的值决定:true/false是复选框,数字是数字,[[links]]的列表是关联,2026-07-03是日期,网址是URL,依此类推。反向关联列和汇总列没有input。

选项与颜色

一个选项是{ value, label, color, group };只有value是必需的。color是调色板名称之一:gray、teal、blue、green、amber、coral、purple、pink——不认识的名称会退回到由该值推算出的颜色。group只用于状态:分组相同的选项构成一个阶段。单纯的字符串会被读作以该字符串为值的选项。

关联汇总

汇总列会根据本数据库中某个链接列所指向的笔记计算出一个值。这个值不存储在任何文件中。

缺少必需部分、或者所指函数不在此列表中的汇总会被忽略:该列保持为空,数据库仍然可以打开。通过另一个计算列得到的汇总同样保持为空。

文件字段(file.*)

这些值来自文件,而不是来自它的Frontmatter。数据库的每一行都带有以下内容:

字段值
file.name笔记的title属性(如果有),否则是不含.md的文件名
file.path相对于仓库的路径
file.mtime最后修改时间,以毫秒计
file.ctime创建时间,以毫秒计,前提是文件系统会报告它
file.size大小,以字节计
file.tags笔记的所有标签(Frontmatter和正文中的),每个都带#;在筛选、便签板或显示该列、按该列排序的视图需要时才会填充
file.tasks待办进度,格式为done/total;用于看板,以及显示该列的视图
file.day日记的文件名所代表的那一天,按仓库的文件夹和格式推算;只读,只有日历或时间轴的日期字段可以使用它
file.revision内部的变更标记;请勿依赖它

file.folder可以用作数据来源(见数据来源),但不是列。file.basename、file.ext、file.links、file.backlinks、file.embeds、file.properties和file.file不提供:使用其中任何一个的列保持为空,筛选会把它们读作空值。

筛选

筛选条件存放在哪里

顶层的filters保存数据来源——哪些笔记属于该数据库。每个视图还可以带有自己的filters,其中的条件只缩小该视图的范围;Plainva把条件写在那里。两个层级会同时生效。文件在顶层保留的条件依然有效;Plainva下一次保存时会把它们移入各个视图。

数据来源

来源表达式
文件夹file.folder == "Projects/Active"——该文件夹及其所有子文件夹;""和"/"都是整个仓库
标签file.hasTag("project")——笔记带有恰好这个标签;开头的#会被忽略

多个来源可以像其他条件一样用and或or组合。没有来源的数据库包含仓库中的每一篇笔记。附件、保留的index.md和log.md,以及名称以点开头的文件或文件夹,永远不会成为行。

条件

条件是一个字符串。值放在双引号中;\"和\\分别转义引号和反斜杠。属性可以写作裸键,也可以带note.。

条件表达式
是status == "Done"
不是status != "Done"
包含contains(labels, "urgent")或labels.contains("urgent")
不包含!contains(labels, "urgent")或!labels.contains("urgent")
大于、小于effort > "3"、effort < "8"
至少、至多due >= "2026-07-01"、due <= "2026-07-31"
为空status == ""或status.isEmpty()
不为空status != ""或!status.isEmpty()
带有标签file.tags.contains("#work"),用!取反
顶部色条、图标note.plainva.header_color == "#2a7f7b"、note.plainva.icon == "lucide:pin"

值如何比较

and、or、not

一个filters对象在每一层恰好带有and、or和not之一;它的条目是条件字符串或更深一层的筛选对象。

键匹配的情形
and每个条目都匹配
or至少一个条目匹配
not没有任何条目匹配

Plainva可以计算任意深度。筛选面板在全部或任一之下编辑一层分组(添加组);更深的结构会显示为 复杂筛选(不可编辑),保留在文件中并且会生效——其中Plainva无法读取的条件会在它下方标明为未生效。同一层上并排带有and和or的旧文件,会被读作“and全部满足,且or中满足一个”,并在下次保存时以有效的形式写出。

Plainva无法读取的内容

只有以上两张表中的写法能被识别。其他任何内容——file.inFolder(…)、file.hasLink(…)、file.hasProperty(…)、不带引号的数字(price > 2)、同一个字符串中的&&和||、算术运算、now()之类的日期函数,或者this——都会保留在文件中,并在筛选面板中按原样显示,同时附有提示 未生效:Plainva 无法读取此条件,因此它不会筛选任何内容。 这样一来,视图显示的笔记会比Obsidian中同一个筛选显示的更多。

公式

Plainva不计算Obsidian公式。formulas原样保留在文件中,视图order里的formula.<name>列显示时没有值。导出表格 → 公式 (.base) 会把一部分汇总写成公式,以便Obsidian可以计算它们(见数据库)。

视图

每个视图的键

键值在Plainva中
typetable、list、cards视图类型;见下一张表
name文本必需;没有名称的视图,Plainva会在保存时为它取一个
order属性ID的列表可见的列,按此顺序
sort{ property, direction }的列表排序规则,ASC或DESC
filters筛选对象该视图自己的条件
summaries属性ID → 汇总名称的映射每列的页脚
plainva映射Plainva的视图选项,见下文

八种视图类型

Obsidian认识table、list和cards。Plainva的其他视图类型存储为type: table加上plainva.render,因此Obsidian会把它们显示为表格。

视图类型磁盘上的typeplainva.render
表格(table)table—
列表(list)list—
画廊(gallery)cards—
看板(board)tableboard
日历(calendar)tablecalendar
时间轴(timeline)tabletimeline
关系图(graph)tablegraph
便签板(pinboard)tablepinboard

只有在允许对.base文件使用Plainva扩展功能开启时,看板、日历、时间轴、关系图和便签板才会作为视图类型提供。Plainva不认识的type会显示为表格,并按原样保留在文件中,直到你选择其他视图类型。

视图选项(views[i].plainva)

在plainva块内部,属性写作裸键(status),而不是note.status。

键视图类型值
render看板、日历、时间轴、关系图、便签板视图类型,见上文
groupBy看板构成各列的属性;没有它时,使用该视图中Obsidian自己的groupBy的属性
boardLaneBy看板用于泳道依据的第二个属性
boardWipLimits看板列的值 → 最多卡片数的映射(WIP限制),大于0的整数
boardColorMode看板column为整列着色;缺省 = 只有表头标签着色
boardColumnOrder看板手动指定的列顺序;__UNGROUPED__是没有值的那一列
colorBy看板、时间轴卡片和横条采用该属性的选项颜色(颜色依据)
dateField日历、时间轴开始日期(日期字段、开始日期);一个日期属性或file.day
endField日历、时间轴结束日期
coverImage画廊保存封面图的属性
subItemsProperty表格用于子项的父级关联
widths表格列 → 宽度(像素)的映射
dateFormat全部long、iso或relative;缺省 = 默认的短格式
graphEdges关系图作为边绘制的关联属性
graphColorBy关系图为节点着色的单选或状态属性
graphSizeBy关系图决定节点大小的数字属性
graphShowExternal关系图true会同时显示视图之外的链接目标
graphShowIncoming关系图true会同时显示来自其他数据库的传入链接
pinboardOrder便签板未固定卡片的路径,按手动顺序
pinboardPinned便签板已固定卡片的路径,按顺序
pinboardFilterBy便签板标签来源:一个多选属性;缺省 = 标签

全文件选项(仅第一个视图)

这些键属于整个数据库。Plainva只把它们写入第一个视图的plainva块,并读取每个键的第一个有效值。

键值
fileIconColor数据库图标的十六进制颜色(数据库图标颜色)
newItemFolder条目保存新条目的文件夹
newItemTemplate新条目使用的模板
contextFilters把嵌入的数据库限定在它所嵌入的笔记范围内的属性(当前笔记)
taskList新任务同时创建于其中的账户和清单("<account id> <list id>")

汇总

views[i].summaries把一列映射到以下名称之一;页脚会针对视图显示的行计算它。

名称在Plainva中结果
Average平均值数字的平均值
Min最小值最小的数字
Max最大值最大的数字
Sum求和数字的总和
Range极差最大数减最小数;对日期则是以天计的跨度
Median中位数数字的中间值
Stddev标准差所有数字的标准差(总体)
Earliest最早最早的日期
Latest最晚最晚的日期
Checked已勾选值为true或yes的行
Unchecked未勾选所有其他行
Empty没有值没有值的行
Filled有值有值的行
Unique不同值不同值的数量;列表条目逐个计数

数字四舍五入到两位小数,并且也会读取以逗号作小数点的写法。没有可用值的列显示的是空页脚,而不是0。其他任何名称都是顶层summaries中的自定义公式:Plainva会保留它,在菜单中显示为 自定义:…,但不计算任何值。

排序与分组

嵌入数据库与this

笔记中的![[Projects.base]]会在笔记内部显示该数据库,阅读视图和编辑器中都是如此。#之后的部分(视图名称,例如![[Projects.base#Board]])会被忽略:嵌入显示的是该数据库上次使用的视图。笔记中的 ```base 代码块显示为代码,而不是数据库。

this暂不支持。 使用this的筛选或公式会保留在文件中,但Plainva不会计算它。有两个办法涵盖了最常见的情形,即“显示属于这篇笔记的条目”:contextFilters(筛选面板中的当前笔记)会通过一个关联属性把嵌入的数据库限定在它所嵌入的笔记范围内;而与宿主笔记所在数据库相关联的嵌入数据库,会自动提供将此数据库筛选到当前笔记。两者都只在Plainva内部起作用;Obsidian会显示所有行。

限制

Plainva不认识的键

Plainva读取一个.base,只更改你在应用中更改的内容,然后把整个文件重新写出——格式为YAML,换行符为LF,不带BOM,因此手写文件中的注释和排版不会保留。对于它不认识的内容:

与Obsidian Bases的差异

主题ObsidianPlainva
公式、自定义汇总计算保留,不计算
this支持暂不支持
筛选表达式完整的表达式语言条件中的写法
file.folder == "X"仅直接位于X中的笔记X及其所有子文件夹
file.hasTag("x")同时包含#x/child恰好是#x
file.name文件名笔记有title属性时用它
视图limit、groupBy应用limit保留,不应用;groupBy对看板分组,不对表格分组
视图类型table、list、cards和插件类型八种类型;未知的显示为表格并保留在文件中
![[db.base#View]]打开该视图上次使用的视图
```base 代码块数据库代码块
Plainva的plainva块忽略看板、日历、时间轴、关系图、便签板、关联、汇总、字段类型

另请参阅