Obsidian Bases 技能详解：创建编辑 .base 文件，实现动态视图、过滤器与公式配置

obsidian-bases by freestylefly/canghe-skills

102 周安装量

191 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/freestylefly/canghe-skills --skill obsidian-bases

文件管理生产力知识管理

🇨🇳中文介绍

Obsidian Bases 技能

此技能使兼容技能的代理能够创建和编辑有效的 Obsidian Bases（.base 文件），包括视图、过滤器、公式及所有相关配置。

概述

Obsidian Bases 是基于 YAML 的文件，用于定义 Obsidian 知识库中笔记的动态视图。一个 Base 文件可以包含多个视图、全局过滤器、公式、属性配置和自定义摘要。

文件格式

Base 文件使用 .base 扩展名并包含有效的 YAML。它们也可以嵌入到 Markdown 代码块中。

完整架构

# 全局过滤器应用于 base 中的所有视图
filters:
  # 可以是单个过滤器字符串
  # 或者是一个包含 and/or/not 的递归过滤器对象
  and: []
  or: []
  not: []

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

# 配置属性的显示名称和设置
properties:
  property_name:
    displayName: "Display Name"
  formula.formula_name:
    displayName: "Formula Display Name"
  file.ext:
    displayName: "Extension"

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

# 定义一个或多个视图
views:
  - type: table | cards | list | map
    name: "View Name"
    limit: 10                    # 可选：限制结果数量
    groupBy:                     # 可选：对结果进行分组
      property: property_name
      direction: ASC | DESC
    filters:                     # 视图特定的过滤器
      and: []
    order:                       # 按顺序显示的属性
      - file.name
      - property_name
      - formula.formula_name
    summaries:                   # 将属性映射到摘要公式
      property_name: Average

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

运算符	描述
`==`	等于
`!=`	不等于
`>`	大于
`<`	小于
`>=`	大于或等于
`<=`	小于或等于
`&&`	逻辑与
`
!	逻辑非

属性	类型	描述
`file.name`	String	文件名
`file.basename`	String	不带扩展名的文件名
`file.path`	String	文件的完整路径
`file.folder`	String	父文件夹路径
`file.ext`	String	文件扩展名
`file.size`	Number	文件大小（字节）
`file.ctime`	Date	创建时间
`file.mtime`	Date	修改时间
`file.tags`	List	文件中的所有标签
`file.links`	List	文件中的内部链接
`file.backlinks`	List	链接到此文件的文件
`file.embeds`	List	笔记中的嵌入内容
`file.properties`	Object	所有 frontmatter 属性

函数	签名	描述
`date()`	`date(string): date`	将字符串解析为日期。格式：`YYYY-MM-DD HH:mm:ss`
`duration()`	`duration(string): duration`	解析持续时间字符串
`now()`	`now(): date`	当前日期和时间
`today()`	`today(): date`	当前日期（时间 = 00:00:00）
`if()`	`if(condition, trueResult, falseResult?)`	条件判断
`min()`	`min(n1, n2, ...): number`	最小数字
`max()`	`max(n1, n2, ...): number`	最大数字
`number()`	`number(any): number`	转换为数字
`link()`	`link(path, display?): Link`	创建链接
`list()`	`list(element): List`	如果尚未是列表则包装为列表
`file()`	`file(path): file`	获取文件对象
`image()`	`image(path): image`	创建用于渲染的图像
`icon()`	`icon(name): icon`	按名称获取 Lucide 图标
`html()`	`html(string): html`	渲染为 HTML
`escapeHTML()`	`escapeHTML(string): string`	转义 HTML 字符

函数	签名	描述
`isTruthy()`	`any.isTruthy(): boolean`	强制转换为布尔值
`isType()`	`any.isType(type): boolean`	检查类型
`toString()`	`any.toString(): string`	转换为字符串

日期函数和字段

字段： date.year、date.month、date.day、date.hour、date.minute、date.second、date.millisecond

函数	签名	描述
`date()`	`date.date(): date`	移除时间部分
`format()`	`date.format(string): string`	使用 Moment.js 模式格式化
`time()`	`date.time(): string`	获取时间字符串
`relative()`	`date.relative(): string`	人类可读的相对时间
`isEmpty()`	`date.isEmpty(): boolean`	对于日期始终为 false

# 持续时间单位：y/year/years, M/month/months, d/day/days, 
#                 w/week/weeks, h/hour/hours, m/minute/minutes, s/second/seconds

# 添加/减去持续时间
"date + \"1M\""           # 添加 1 个月
"date - \"2h\""           # 减去 2 小时
"now() + \"1 day\""       # 明天
"today() + \"7d\""        # 从今天起一周后

# 减去日期以获得毫秒差
"now() - file.ctime"

# 复杂的持续时间算术
"now() + (duration('1d') * 2)"

字段： string.length

函数	签名	描述
`contains()`	`string.contains(value): boolean`	检查子字符串
`containsAll()`	`string.containsAll(...values): boolean`	所有子字符串都存在
`containsAny()`	`string.containsAny(...values): boolean`	任一子字符串存在
`startsWith()`	`string.startsWith(query): boolean`	以查询内容开头
`endsWith()`	`string.endsWith(query): boolean`	以查询内容结尾
`isEmpty()`	`string.isEmpty(): boolean`	为空或不存在
`lower()`	`string.lower(): string`	转换为小写
`title()`	`string.title(): string`	转换为标题大小写
`trim()`	`string.trim(): string`	移除空白字符
`replace()`	`string.replace(pattern, replacement): string`	替换模式
`repeat()`	`string.repeat(count): string`	重复字符串
`reverse()`	`string.reverse(): string`	反转字符串
`slice()`	`string.slice(start, end?): string`	子字符串
`split()`	`string.split(separator, n?): list`	分割为列表

函数	签名	描述
`abs()`	`number.abs(): number`	绝对值
`ceil()`	`number.ceil(): number`	向上取整
`floor()`	`number.floor(): number`	向下取整
`round()`	`number.round(digits?): number`	四舍五入到指定位数
`toFixed()`	`number.toFixed(precision): string`	定点表示法
`isEmpty()`	`number.isEmpty(): boolean`	不存在

字段： list.length

函数	签名	描述
`contains()`	`list.contains(value): boolean`	元素存在
`containsAll()`	`list.containsAll(...values): boolean`	所有元素都存在
`containsAny()`	`list.containsAny(...values): boolean`	任一元素存在
`filter()`	`list.filter(expression): list`	按条件过滤（使用 `value`、`index`）
`map()`	`list.map(expression): list`	转换元素（使用 `value`、`index`）
`reduce()`	`list.reduce(expression, initial): any`	归约为单个值（使用 `value`、`index`、`acc`）
`flat()`	`list.flat(): list`	展平嵌套列表
`join()`	`list.join(separator): string`	连接为字符串
`reverse()`	`list.reverse(): list`	反转顺序
`slice()`	`list.slice(start, end?): list`	子列表
`sort()`	`list.sort(): list`	升序排序
`unique()`	`list.unique(): list`	移除重复项
`isEmpty()`	`list.isEmpty(): boolean`	无元素

函数	签名	描述
`asLink()`	`file.asLink(display?): Link`	转换为链接
`hasLink()`	`file.hasLink(otherFile): boolean`	有指向文件的链接
`hasTag()`	`file.hasTag(...tags): boolean`	具有任一标签
`hasProperty()`	`file.hasProperty(name): boolean`	具有属性
`inFolder()`	`file.inFolder(folder): boolean`	在文件夹或子文件夹中

函数	签名	描述
`asFile()`	`link.asFile(): file`	获取文件对象
`linksTo()`	`link.linksTo(file): boolean`	链接到文件

函数	签名	描述
`isEmpty()`	`object.isEmpty(): boolean`	无属性
`keys()`	`object.keys(): list`	键列表
`values()`	`object.values(): list`	值列表

正则表达式函数

函数	签名	描述
`matches()`	`regexp.matches(string): boolean`	测试是否匹配

views:
  - type: table
    name: "My Table"
    order:
      - file.name
      - status
      - due_date
    summaries:
      price: Sum
      count: Average

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

views:
  - type: list
    name: "Simple List"
    order:
      - file.name
      - status

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

views:
  - type: map
    name: "Locations"
    # 针对经纬度属性的地图特定设置

名称	输入类型	描述
`Average`	Number	算术平均值
`Min`	Number	最小数字
`Max`	Number	最大数字
`Sum`	Number	所有数字的总和
`Range`	Number	最大值 - 最小值
`Median`	Number	算术中位数
`Stddev`	Number	标准差
`Earliest`	Date	最早日期
`Latest`	Date	最晚日期
`Range`	Date	最晚 - 最早
`Checked`	Boolean	真值计数
`Unchecked`	Boolean	假值计数
`Empty`	Any	空值计数
`Filled`	Any	非空值计数
`Unique`	Any	唯一值计数

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

formulas:
  days_until_due: 'if(due, ((date(due) - today()) / 86400000).round(0), "")'
  is_overdue: 'if(due, date(due) < today() && status != "done", false)'
  priority_label: 'if(priority == 1, "🔴 High", if(priority == 2, "🟡 Medium", "🟢 Low"))'

properties:
  status:
    displayName: Status
  formula.days_until_due:
    displayName: "Days Until Due"
  formula.priority_label:
    displayName: Priority

views:
  - type: table
    name: "Active Tasks"
    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: Average

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

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

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

properties:
  author:
    displayName: Author
  formula.status_icon:
    displayName: ""
  formula.reading_time:
    displayName: "Est. Time"

views:
  - type: cards
    name: "Library"
    order:
      - cover
      - file.name
      - author
      - formula.status_icon
    filters:
      not:
        - 'status == "dropped"'

  - type: table
    name: "Reading List"
    filters:
      and:
        - 'status == "to-read"'
    order:
      - file.name
      - author
      - pages
      - formula.reading_time

filters:
  and:
    - file.inFolder("Projects")
    - 'file.ext == "md"'

formulas:
  last_updated: 'file.mtime.relative()'
  link_count: 'file.links.length'
  
summaries:
  avgLinks: 'values.filter(value.isType("number")).mean().round(1)'

properties:
  formula.last_updated:
    displayName: "Updated"
  formula.link_count:
    displayName: "Links"

views:
  - type: table
    name: "All Projects"
    order:
      - file.name
      - status
      - formula.last_updated
      - formula.link_count
    summaries:
      formula.link_count: avgLinks
    groupBy:
      property: status
      direction: ASC

  - type: list
    name: "Quick List"
    order:
      - file.name
      - status

filters:
  and:
    - file.inFolder("Daily Notes")
    - '/^\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: "Day"
  formula.word_estimate:
    displayName: "~Words"

views:
  - type: table
    name: "Recent Notes"
    limit: 30
    order:
      - file.name
      - formula.day_of_week
      - formula.word_estimate
      - file.mtime

嵌入到 Markdown 文件中：

![[MyBase.base]]

<!-- 特定视图 -->
![[MyBase.base#View Name]]

对于包含双引号的公式使用单引号：'if(done, "Yes", "No")'
对于简单字符串使用双引号："My View Name"
在复杂表达式中正确转义嵌套引号

filters:
  and:
    - file.hasTag("project")

filters:
  and:
    - file.inFolder("Notes")

按日期范围过滤

filters:
  and:
    - 'file.mtime > now() - "7d"'

filters:
  and:
    - 'status == "active"'
    - 'priority >= 3'

filters:
  or:
    - and:
        - file.hasTag("important")
        - 'status != "done"'
    - and:
        - 'priority == 1'
        - 'due != ""'

🇺🇸English

Obsidian Bases Skill

This skill enables skills-compatible agents to create and edit valid Obsidian Bases (.base files) including views, filters, formulas, and all related configurations.

Overview

Obsidian Bases are YAML-based files that define dynamic views of notes in an Obsidian vault. A Base file can contain multiple views, global filters, formulas, property configurations, and custom summaries.

File Format

Base files use the .base extension and contain valid YAML. They can also be embedded in Markdown code blocks.

Complete Schema

# Global filters apply to ALL views in the base
filters:
  # Can be a single filter string
  # OR a recursive filter object with and/or/not
  and: []
  or: []
  not: []

# Define formula properties that can be used across all views
formulas:
  formula_name: 'expression'

# Configure display names and settings for properties
properties:
  property_name:
    displayName: "Display Name"
  formula.formula_name:
    displayName: "Formula Display Name"
  file.ext:
    displayName: "Extension"

# Define custom summary formulas
summaries:
  custom_summary_name: 'values.mean().round(3)'

# Define one or more views
views:
  - type: table | cards | list | map
    name: "View Name"
    limit: 10                    # Optional: limit results
    groupBy:                     # Optional: group results
      property: property_name
      direction: ASC | DESC
    filters:                     # View-specific filters
      and: []
    order:                       # Properties to display in order
      - file.name
      - property_name
      - formula.formula_name
    summaries:                   # Map properties to summary formulas
      property_name: Average

Filter Syntax

Filters narrow down results. They can be applied globally or per-view.

Filter Structure

# Single filter
filters: 'status == "done"'

# AND - all conditions must be true
filters:
  and:
    - 'status == "done"'
    - 'priority > 3'

# OR - any condition can be true
filters:
  or:
    - 'file.hasTag("book")'
    - 'file.hasTag("article")'

# NOT - exclude matching items
filters:
  not:
    - 'file.hasTag("archived")'

# Nested filters
filters:
  or:
    - file.hasTag("tag")
    - and:
        - file.hasTag("book")
        - file.hasLink("Textbook")
    - not:
        - file.hasTag("book")
        - file.inFolder("Required Reading")

Filter Operators

Operator	Description
`==`	equals
`!=`	not equal
`>`	greater than
`<`	less than
`>=`	greater than or equal
`<=`	less than or equal
`&&`

Properties

Three Types of Properties

Note properties - From frontmatter: note.author or just author
File properties - File metadata: file.name, file.mtime, etc.
Formula properties - Computed values: formula.my_formula

File Properties Reference

Property	Type	Description
`file.name`	String	File name
`file.basename`	String	File name without extension
`file.path`	String	Full path to file
`file.folder`	String	Parent folder path
`file.ext`	String	File extension

The `this` Keyword

In main content area: refers to the base file itself
When embedded: refers to the embedding file
In sidebar: refers to the active file in main content

Formula Syntax

Formulas compute values from properties. Defined in the formulas section.

formulas:
  # Simple arithmetic
  total: "price * quantity"
  
  # Conditional logic
  status_icon: 'if(done, "✅", "⏳")'
  
  # String formatting
  formatted_price: 'if(price, price.toFixed(2) + " dollars")'
  
  # Date formatting
  created: 'file.ctime.format("YYYY-MM-DD")'
  
  # Complex expressions
  days_old: '((now() - file.ctime) / 86400000).round(0)'

Functions Reference

Global Functions

Function	Signature	Description
`date()`	`date(string): date`	Parse string to date. Format: `YYYY-MM-DD HH:mm:ss`
`duration()`	`duration(string): duration`	Parse duration string
`now()`	`now(): date`	Current date and time

Any Type Functions

Function	Signature	Description
`isTruthy()`	`any.isTruthy(): boolean`	Coerce to boolean
`isType()`	`any.isType(type): boolean`	Check type
`toString()`	`any.toString(): string`	Convert to string

Date Functions & Fields

Fields: date.year, date.month, date.day, date.hour, date.minute, date.second, date.millisecond

Function	Signature	Description
`date()`	`date.date(): date`	Remove time portion
`format()`	`date.format(string): string`	Format with Moment.js pattern
`time()`	`date.time(): string`	Get time as string
`relative()`

Date Arithmetic

# Duration units: y/year/years, M/month/months, d/day/days, 
#                 w/week/weeks, h/hour/hours, m/minute/minutes, s/second/seconds

# Add/subtract durations
"date + \"1M\""           # Add 1 month
"date - \"2h\""           # Subtract 2 hours
"now() + \"1 day\""       # Tomorrow
"today() + \"7d\""        # A week from today

# Subtract dates for millisecond difference
"now() - file.ctime"

# Complex duration arithmetic
"now() + (duration('1d') * 2)"

String Functions

Field: string.length

Function	Signature	Description
`contains()`	`string.contains(value): boolean`	Check substring
`containsAll()`	`string.containsAll(...values): boolean`	All substrings present
`containsAny()`	`string.containsAny(...values): boolean`	Any substring present

Number Functions

Function	Signature	Description
`abs()`	`number.abs(): number`	Absolute value
`ceil()`	`number.ceil(): number`	Round up
`floor()`	`number.floor(): number`	Round down
`round()`

List Functions

Field: list.length

Function	Signature	Description
`contains()`	`list.contains(value): boolean`	Element exists
`containsAll()`	`list.containsAll(...values): boolean`	All elements exist
`containsAny()`	`list.containsAny(...values): boolean`	Any element exists
`filter()`

File Functions

Function	Signature	Description
`asLink()`	`file.asLink(display?): Link`	Convert to link
`hasLink()`	`file.hasLink(otherFile): boolean`	Has link to file
`hasTag()`	`file.hasTag(...tags): boolean`	Has any of the tags
`hasProperty()`

Link Functions

Function	Signature	Description
`asFile()`	`link.asFile(): file`	Get file object
`linksTo()`	`link.linksTo(file): boolean`	Links to file

Object Functions

Function	Signature	Description
`isEmpty()`	`object.isEmpty(): boolean`	No properties
`keys()`	`object.keys(): list`	List of keys
`values()`	`object.values(): list`	List of values

Regular Expression Functions

Function	Signature	Description
`matches()`	`regexp.matches(string): boolean`	Test if matches

View Types

Table View

views:
  - type: table
    name: "My Table"
    order:
      - file.name
      - status
      - due_date
    summaries:
      price: Sum
      count: Average

Cards View

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

List View

views:
  - type: list
    name: "Simple List"
    order:
      - file.name
      - status

Map View

Requires latitude/longitude properties and the Maps community plugin.

views:
  - type: map
    name: "Locations"
    # Map-specific settings for lat/lng properties

Default Summary Formulas

Name	Input Type	Description
`Average`	Number	Mathematical mean
`Min`	Number	Smallest number
`Max`	Number	Largest number
`Sum`	Number	Sum of all numbers
`Range`	Number	Max - Min

Complete Examples

Task Tracker Base

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

formulas:
  days_until_due: 'if(due, ((date(due) - today()) / 86400000).round(0), "")'
  is_overdue: 'if(due, date(due) < today() && status != "done", false)'
  priority_label: 'if(priority == 1, "🔴 High", if(priority == 2, "🟡 Medium", "🟢 Low"))'

properties:
  status:
    displayName: Status
  formula.days_until_due:
    displayName: "Days Until Due"
  formula.priority_label:
    displayName: Priority

views:
  - type: table
    name: "Active Tasks"
    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: Average

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

Reading List Base

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

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

properties:
  author:
    displayName: Author
  formula.status_icon:
    displayName: ""
  formula.reading_time:
    displayName: "Est. Time"

views:
  - type: cards
    name: "Library"
    order:
      - cover
      - file.name
      - author
      - formula.status_icon
    filters:
      not:
        - 'status == "dropped"'

  - type: table
    name: "Reading List"
    filters:
      and:
        - 'status == "to-read"'
    order:
      - file.name
      - author
      - pages
      - formula.reading_time

Project Notes Base

filters:
  and:
    - file.inFolder("Projects")
    - 'file.ext == "md"'

formulas:
  last_updated: 'file.mtime.relative()'
  link_count: 'file.links.length'
  
summaries:
  avgLinks: 'values.filter(value.isType("number")).mean().round(1)'

properties:
  formula.last_updated:
    displayName: "Updated"
  formula.link_count:
    displayName: "Links"

views:
  - type: table
    name: "All Projects"
    order:
      - file.name
      - status
      - formula.last_updated
      - formula.link_count
    summaries:
      formula.link_count: avgLinks
    groupBy:
      property: status
      direction: ASC

  - type: list
    name: "Quick List"
    order:
      - file.name
      - status

Daily Notes Index

filters:
  and:
    - file.inFolder("Daily Notes")
    - '/^\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: "Day"
  formula.word_estimate:
    displayName: "~Words"

views:
  - type: table
    name: "Recent Notes"
    limit: 30
    order:
      - file.name
      - formula.day_of_week
      - formula.word_estimate
      - file.mtime

Embedding Bases

Embed in Markdown files:

![[MyBase.base]]

<!-- Specific view -->
![[MyBase.base#View Name]]

YAML Quoting Rules

Use single quotes for formulas containing double quotes: 'if(done, "Yes", "No")'
Use double quotes for simple strings: "My View Name"
Escape nested quotes properly in complex expressions

Common Patterns

Filter by Tag

filters:
  and:
    - file.hasTag("project")

Filter by Folder

filters:
  and:
    - file.inFolder("Notes")

Filter by Date Range

filters:
  and:
    - 'file.mtime > now() - "7d"'

Filter by Property Value

filters:
  and:
    - 'status == "active"'
    - 'priority >= 3'

Combine Multiple Conditions

filters:
  or:
    - and:
        - file.hasTag("important")
        - 'status != "done"'
    - and:
        - 'priority == 1'
        - 'due != ""'

References

Weekly Installs

102

Repository

freestylefly/ca…e-skills

GitHub Stars

191

First Seen

Feb 24, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykPass

Installed on

github-copilot101

gemini-cli101

codex101

kimi-cli101

cursor101

opencode101

Python PDF处理教程：合并拆分、提取文本表格、创建PDF文件

62,800 周安装

Obsidian Bases 技能详解：创建编辑 .base 文件，实现动态视图、过滤器与公式配置

🇨🇳中文介绍

Obsidian Bases 技能

概述

文件格式

完整架构

相关 Skills

过滤器语法

过滤器结构

过滤器运算符

属性

三种属性类型

文件属性参考

this 关键字

公式语法

函数参考

全局函数

任意类型函数

日期函数和字段

日期算术

字符串函数

数字函数

列表函数

文件函数

链接函数

对象函数

正则表达式函数

视图类型

表格视图

卡片视图

列表视图

地图视图

默认摘要公式

完整示例

任务追踪 Base

阅读清单 Base

项目笔记 Base

每日笔记索引

嵌入 Bases

YAML 引用规则

常见模式

按标签过滤

按文件夹过滤