创建和编辑包含视图、过滤器、公式和摘要的 Obsidian Bases（.base 文件）。在处理 .base 文件、创建类似数据库的笔记视图，或用户在 Obsidian 中提及 Bases、表视图、卡片视图、过滤器或公式时使用。

Obsidian Bases 技能

工作流程

创建文件：在 vault 中创建具有有效 YAML 内容的 .base 文件
定义范围：添加 filters 以选择显示哪些笔记（按标签、文件夹、属性或日期）
添加公式（可选）：在 formulas 部分定义计算属性
配置视图：添加一个或多个视图（table、cards、list 或 map），并使用 order 指定显示哪些属性
验证：验证文件是有效的 YAML 且没有语法错误。检查所有引用的属性和公式都存在。常见问题：包含特殊 YAML 字符的未引用字符串、公式表达式中的引号不匹配、引用 formula.X 而未在 formulas 中定义 X
在 Obsidian 中测试：在 Obsidian 中打开 .base 文件以确认视图正确渲染。如果显示 YAML 错误，请检查下面的引用规则

模式

Base 文件使用 .base 扩展名并包含有效的 YAML。

# 全局过滤器应用于 base 中的所有视图
filters:
  # 可以是单个过滤器字符串
  # 或递归过滤器对象，仅包含 and、or、not 三者之一作为唯一键
  and:
    - 'status == "active"'
    - not:
        - 'file.hasTag("archived")'

# 定义可在所有视图中使用的公式属性
formulas:
  formula_name: 'expression'

# 配置属性的显示名称和设置
properties:
  property_name:
    displayName: "显示名称"
  formula.formula_name:
    displayName: "公式显示名称"
  file.ext:
    displayName: "扩展名"

# 定义自定义摘要公式
summaries:
  custom_summary_name: 'values.mean().round(3)'

# 定义一个或多个视图
views:
  - type: table | cards | list | map
    name: "视图名称"
    limit: 10                    # 可选：限制结果
    groupBy:                     # 可选：分组结果
      property: property_name
      direction: ASC | DESC
    filters:                     # 视图特定过滤器遵循相同的规则
      and:
        - 'status == "active"'
    order:                       # 按顺序显示的属性
      - file.name
      - property_name
      - formula.formula_name
    summaries:                   # 将属性映射到摘要公式
      property_name: 平均值

过滤器语法

过滤器缩小结果范围。可以全局应用或按视图应用。

过滤器结构

# 单个过滤器
filters: 'status == "done"'

# AND - 所有条件必须为 true
filters:
  and:
    - 'status == "done"'
    - 'priority > 3'

# OR - 任何条件可以为 true
filters:
  or:
    - 'file.hasTag("book")'
    - 'file.hasTag("article")'

# NOT - 排除匹配项
filters:
  not:
    - 'file.hasTag("archived")'

# 嵌套过滤器
filters:
  or:
    - file.hasTag("tag")
    - and:
        - file.hasTag("book")
        - file.hasLink("Textbook")
    - not:
        - file.hasTag("book")
        - file.inFolder("Required Reading")

过滤器运算符

| 运算符 | 描述 |

|----------|-------------|

| == | 等于 |

| != | 不等于 |

| > | 大于 |

| < | 小于 |

| >= | 大于或等于 |

| <= | 小于或等于 |

| && | 逻辑与 |

| \|\| | 逻辑或 |

| <code>!</code> | 逻辑非 |

属性

三种属性类型

笔记属性 - 来自 frontmatter：note.author 或仅 author
文件属性 - 文件元数据：file.name、file.mtime 等
公式属性 - 计算值：formula.my_formula

文件属性参考

| 属性 | 类型 | 描述 |

|----------|------|-------------|

| file.name | 字符串 | 文件名 |

| file.basename | 字符串 | 不带扩展名的文件名 |

| file.path | 字符串 | 文件的完整路径 |

| file.folder | 字符串 | 父文件夹路径 |

| file.ext | 字符串 | 文件扩展名 |

| file.size | 数字 | 文件大小（字节） |

| file.ctime | 日期 | 创建时间 |

| file.mtime | 日期 | 修改时间 |

| file.tags | 列表 | 文件中的所有标签 |

| file.links | 列表 | 文件中的内部链接 |

| file.backlinks | 列表 | 链接到此文件的文件 |

| file.embeds | 列表 | 笔记中的嵌入 |

| file.properties | 对象 | 所有 frontmatter 属性 |

`this` 关键字

在主要内容区域：引用 base 文件本身
嵌入时：引用嵌入文件
在侧边栏中：引用主要内容中的活动文件

公式语法

公式从属性计算值。在 formulas 部分定义。

formulas:
  # 简单算术
  total: "price * quantity"

  # 条件逻辑
  status_icon: 'if(done, "✅", "⏳")'

  # 字符串格式化
  formatted_price: 'if(price, price.toFixed(2) + " 美元")'

  # 日期格式化
  created: 'file.ctime.format("YYYY-MM-DD")'

  # 计算自创建以来的天数（对 Duration 使用 .days）
  days_old: '(now() - file.ctime).days'

  # 计算距离到期日期的天数
  days_until_due: 'if(due_date, (date(due_date) - today()).days, "")'

关键函数

最常用的函数。有关所有类型的完整参考（日期、字符串、数字、列表、文件、链接、对象、正则表达式），请参阅 FUNCTIONS_REFERENCE.md。

| 函数 | 签名 | 描述 |

|----------|-----------|-------------|

| date() | date(string): date | 将字符串解析为日期（YYYY-MM-DD HH:mm:ss） |

| now() | now(): date | 当前日期和时间 |

| today() | today(): date | 当前日期（时间 = 00:00:00） |

| if() | if(condition, trueResult, falseResult?) | 条件 |

| duration() | duration(string): duration | 解析持续时间字符串 |

| file() | file(path): file | 获取文件对象 |

| link() | link(path, display?): Link | 创建链接 |

Duration 类型

当减去两个日期时，结果是 Duration 类型（不是数字）。

Duration 字段： duration.days、duration.hours、duration.minutes、duration.seconds、duration.milliseconds

重要： Duration 不支持 .round()、.floor()、.ceil() 直接访问。先访问数字字段（如 .days），然后应用数字函数。

# 正确：计算日期之间的天数
"(date(due_date) - today()).days"                    # 返回天数
"(now() - file.ctime).days"                          # 自创建以来的天数
"(date(due_date) - today()).days.round(0)"           # 四舍五入的天数

# 错误 - 将导致错误：
# "((date(due) - today()) / 86400000).round(0)"      # Duration 不支持除法然后四舍五入

日期算术

# Duration 单位：y/year/年、M/month/月、d/day/天、
#                 w/week/周、h/hour/时、m/minute/分、s/second/秒
"now() + \"1 天\""       # 明天
"today() + \"7天\""        # 从今天起一周
"now() - file.ctime"      # 返回 Duration
"(now() - file.ctime).days" # 获取天数作为数字

视图类型

表格视图

views:
  - type: table
    name: "我的表格"
    order:
      - file.name
      - status
      - due_date
    summaries:
      price: 总和
      count: 平均值

卡片视图

views:
  - type: cards
    name: "画廊"
    order:
      - file.name
      - cover_image
      - description

列表视图

views:
  - type: list
    name: "简单列表"
    order:
      - file.name
      - status

地图视图

需要纬度/经度属性和 Maps 社区插件。

views:
  - type: map
    name: "位置"
    # 地图特定设置，用于纬度/经度属性

默认摘要公式

| 名称 | 输入类型 | 描述 |

|------|------------|-------------|

| Average | 数字 | 数学平均值 |

| Min | 数字 | 最小数字 |

| Max | 数字 | 最大数字 |

| Sum | 数字 | 所有数字的总和 |

| Range | 数字 | 最大值 - 最小值 |

| Median | 数字 | 数学中位数 |

| Stddev | 数字 | 标准差 |

| Earliest | 日期 | 最早日期 |

| Latest | 日期 | 最新日期 |

| Range | 日期 | 最新日期 - 最早日期 |

| Checked | 布尔值 | true 值的计数 |

| Unchecked | 布尔值 | false 值的计数 |

| Empty | 任意值 | 空值的计数 |

| Filled | 任意值 | 非空值的计数 |

| Unique | 任意值 | 唯一值的计数 |

完整示例

任务追踪 Base

filters:
  and:
    - file.hasTag("task")
    - 'file.ext == "md"'

formulas:
  days_until_due: 'if(due, (date(due) - today()).days, "")'
  is_overdue: 'if(due, date(due) < today() && status != "done", false)'
  priority_label: 'if(priority == 1, "🔴 高", if(priority == 2, "🟡 中", "🟢 低"))'

properties:
  status:
    displayName: 状态
  formula.days_until_due:
    displayName: "距离到期天数"
  formula.priority_label:
    displayName: 优先级

views:
  - type: table
    name: "活跃任务"
    filters:
      and:
        - 'status != "done"'
    order:
      - file.name
      - status
      - formula.priority_label
      - due
      - formula.days_until_due
    groupBy:
      property: status
      direction: ASC
    summaries:
      formula.days_until_due: 平均值

  - type: table
    name: "已完成"
    filters:
      and:
        - 'status == "done"'
    order:
      - file.name
      - completed_date

阅读列表 Base

filters:
  or:
    - file.hasTag("book")
    - file.hasTag("article")

formulas:
  reading_time: 'if(pages, (pages * 2).toString() + " 分钟", "")'
  status_icon: 'if(status == "reading", "📖", if(status == "done", "✅", "📚"))'
  year_read: 'if(finished_date, date(finished_date).year, "")'

properties:
  author:
    displayName: 作者
  formula.status_icon:
    displayName: ""
  formula.reading_time:
    displayName: "预计时间"

views:
  - type: cards
    name: "图书馆"
    order:
      - cover
      - file.name
      - author
      - formula.status_icon
    filters:
      not:
        - 'status == "已放弃"'

  - type: table
    name: "阅读列表"
    filters:
      and:
        - 'status == "待阅读"'
    order:
      - file.name
      - author
      - pages
      - formula.reading_time

每日笔记索引

filters:
  and:
    - file.inFolder("每日笔记")
    - '/^\d{4}-\d{2}-\d{2}$/.matches(file.basename)'

formulas:
  word_estimate: '(file.size / 5).round(0)'
  day_of_week: 'date(file.basename).format("dddd")'

properties:
  formula.day_of_week:
    displayName: "星期"
  formula.word_estimate:
    displayName: "~字数"

views:
  - type: table
    name: "最近笔记"
    limit: 30
    order:
      - file.name
      - formula.day_of_week
      - formula.word_estimate
      - file.mtime

嵌入 Bases

在 Markdown 文件中嵌入：

![[MyBase.base]]

<!-- 特定视图 -->
![[MyBase.base#视图名称]]

YAML 引用规则

对包含双引号的公式使用单引号：'if(done, "是", "否")'
对简单字符串使用双引号："我的视图名称"
正确转义复杂表达式中的嵌套引号

故障排除

YAML 语法错误

未引用的特殊字符：包含 :、{、}、[、]、,、&、*、#、?、|、-、<、>、=、!、%、@、` 必须被引用。

# 错误 - 未引用字符串中的冒号
displayName: 状态：活跃

# 正确
displayName: "状态：活跃"

公式中的引号不匹配：当公式包含双引号时，将整个公式用单引号包裹。

# 错误 - 双引号内包含双引号
formulas:
  label: "if(done, "是", "否")"

# 正确 - 用单引号包裹双引号
formulas:
  label: 'if(done, "是", "否")'

常见公式错误

没有字段访问的 Duration 数学运算：减去日期返回的是 Duration，不是数字。始终访问 .days、.hours 等。

# 错误 - Duration 不是数字
"(now() - file.ctime).round(0)"

# 正确 - 先访问 .days，然后四舍五入
"(now() - file.ctime).days.round(0)"

缺少 null 检查：属性可能不存在于所有笔记。使用 if() 进行保护。

# 错误 - 如果 due_date 为空会崩溃
"(date(due_date) - today()).days"

# 正确 - 用 if() 保护
'if(due_date, (date(due_date) - today()).days, "")'

引用未定义的公式：确保 order 或 properties 中的每个 formula.X 在 formulas 中都有匹配的条目。

# 如果 'total' 未在 formulas 中定义，这将静默失败
order:
  - formula.total

# 修复：定义它
formulas:
  total: "price * quantity"

Obsidian Bases 技能