findscripter 何时使用
- 在 Obsidian 中创建或编辑
.base文件，把笔记聚合成类数据库视图（表格 / 卡片 / 列表 / 地图）。 - 需要按 tag、文件夹、frontmatter 属性或日期过滤笔记，并叠加公式列、汇总统计或分组。
- 用户明确提到 Obsidian Bases、
.base、表格/卡片视图、过滤器或公式。
不该用的边界：
- 不要用于 Dataview / DataviewJS 查询（语法不同）、非 Obsidian 的数据库或电子表格。
.base仅是「视图」，不修改笔记本身的 frontmatter；要批量改属性请用其他手段。- 地图视图依赖 latitude/longitude 属性与社区 Maps 插件，缺失时不可用。
步骤
- 建文件：在 vault 中创建
.base文件，内容为合法 YAML。 - 定范围：用
filters选定哪些笔记入表（按 tag / 文件夹 / 属性 / 日期）。 - 加公式（可选）：在
formulas段定义计算列。 - 配视图：在
views下添加一个或多个视图，用order指定显示哪些列及顺序。 - 校验：确认 YAML 无语法错误；所有引用的属性与
formula.X都已定义。常见坑：含特殊字符的字符串未加引号、公式内引号嵌套不匹配、order引用了未在formulas中定义的公式。 - 在 Obsidian 中打开
.base验证渲染。若报 YAML 错误，回到引号规则排查。
指令
整体骨架（顶层 filters 作用于全部视图）：
filters: # 全局过滤：单条字符串，或 and/or/not 递归对象
and: []
formulas: # 计算属性，跨视图可用
formula_name: 'expression'
properties: # 配置列显示名
property_name: { displayName: "显示名" }
formula.formula_name: { displayName: "公式列名" }
summaries: # 自定义汇总公式
custom_name: 'values.mean().round(3)'
views:
- type: table | cards | list | map
name: "视图名"
limit: 10 # 可选：限制条数
groupBy: { property: status, direction: ASC } # 可选：分组
filters: { and: [] } # 视图级过滤
order: [file.name, property_name, formula.formula_name]
summaries: { property_name: Average }
过滤器（可全局或按视图）：
filters: 'status == "done"' # 单条
filters: { and: ['status == "done"', 'priority > 3'] } # 全部满足
filters: { or: ['file.hasTag("book")', 'file.hasTag("article")'] } # 任一满足
filters: { not: ['file.hasTag("archived")'] } # 排除
# 可嵌套：or 下可再写 and / not 子对象
运算符：== != > < >= <=，逻辑 && || !。
三类属性：
- 笔记属性（frontmatter）：
note.author或直接author。 - 文件属性：
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。 - 公式属性：
formula.my_formula。 this关键字：正文区指 base 文件本身；被嵌入时指嵌入它的文件；侧栏中指主区活动文件。
公式与常用函数：
formulas:
total: "price * quantity" # 算术
status_icon: 'if(done, "✅", "⏳")' # 条件
created: 'file.ctime.format("YYYY-MM-DD")' # 日期格式化
days_old: '(now() - file.ctime).days' # 距今天数
days_until_due: 'if(due, (date(due) - today()).days, "")' # 距截止天数（带空值守卫）
核心函数：date(string) 解析日期（YYYY-MM-DD HH:mm:ss）、now() 当前时刻、today() 今日零点、if(cond, a, b?)、duration(string)、file(path)、link(path, display?)。完整函数表见源仓库 references/FUNCTIONS_REFERENCE.md。
Duration 约束（关键）：两日期相减得到的是 Duration 而非数字，不支持直接 .round()/.floor()/.ceil()。必须先取数值字段（.days/.hours/.minutes/.seconds/.milliseconds）再做数字运算：
"(date(due_date) - today()).days.round(0)" # 正确
# "((date(due) - today()) / 86400000).round(0)" # 错误：Duration 不支持先除后取整
日期加减的时长单位：y/year、M/month、d/day、w/week、h/hour、m/minute、s/second，如 'now() + "1 day"'、'today() + "7d"'。
默认汇总公式（用于 summaries）：数值类 Average/Min/Max/Sum/Range/Median/Stddev；日期类 Earliest/Latest/Range；布尔类 Checked/Unchecked；通用 Empty/Filled/Unique。
嵌入到 Markdown：![[MyBase.base]]，指定视图 ![[MyBase.base#View Name]]。
示例
任务追踪 Base（过滤 + 公式 + 分组 + 汇总 + 多视图）：
filters:
and:
- file.hasTag("task")
- 'file.ext == "md"'
formulas:
days_until_due: 'if(due, (date(due) - today()).days, "")'
priority_label: 'if(priority == 1, "🔴 High", if(priority == 2, "🟡 Medium", "🟢 Low"))'
properties:
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]
每日笔记索引（正则匹配文件名 + 派生列 + limit）：
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")'
views:
- type: table
name: "Recent Notes"
limit: 30
order: [file.name, formula.day_of_week, formula.word_estimate, file.mtime]
阅读清单可用卡片视图（type: cards，order 首项放封面图属性如 cover）；纯标题列表用 type: list。
注意事项
YAML 引号规则：
- 含双引号的公式整体用单引号包裹：
'if(done, "Yes", "No")'。 - 普通字符串用双引号：
"My View Name"。 - 含
: { } [ ] , & * # ? | - < > = ! % @ \`` 等特殊字符的字符串必须加引号，例如displayName: "Status: Active"（不可写裸的Status: Active`）。
常见公式错误：
- Duration 未取字段就调用数字函数 —— 先
.days再.round()。 - 缺空值守卫：属性可能在部分笔记不存在，用
if(prop, ..., "")兜底，否则空值会报错。 - 引用未定义公式：
order/properties中每个formula.X都要在formulas中有对应定义，否则静默失效。
通用边界：仅在任务明确落在上述范围内时使用；输出不能替代在真实 Obsidian 环境中的验证；若缺少必要属性、权限或成功标准，先停下来澄清。
互见
- Obsidian 官方文档：Bases Syntax / Functions / Views / Formulas（help.obsidian.md/bases）。
- 完整函数参考：源仓库
references/FUNCTIONS_REFERENCE.md。
采编自 sickn33/antigravity-awesome-skills（MIT），原 skill obsidian-bases，源 https://github.com/kepano/obsidian-skills。