1实现原理 · 为什么它能做到
纯知识注入型技能：SKILL.md 把 Obsidian Bases 的完整 YAML schema 与语义写进模型上下文，模型据此产出合法 .base 文件——目录内无脚本、无 CLI、无网络资源参与。
skills/obsidian-bases/SKILL.md
This skill enables skills-compatible agents to create and edit valid Obsidian Bases (`.base` files) including views, filters, formulas, and all related configurations.
注：这里在做什么：一句话给出技能边界（创建/编辑 .base），实现完全靠文本规范而非代码。
先定义文件性质与承载形式：Bases 是 YAML，可独立成 .base 文件，也可内嵌 Markdown 代码块。
skills/obsidian-bases/SKILL.md
Obsidian Bases are YAML-based files that define dynamic views of notes in an Obsidian vault.
注：这里在做什么：让模型先建立「Bases = YAML 声明」的模型，再进入具体字段。
给出可复制的完整 schema 骨架（filters/formulas/properties/summaries/views 五段），并说明全局过滤器作用于所有视图。
skills/obsidian-bases/SKILL.md
# Global filters apply to ALL views in the base
注：这里在做什么：用注释标出作用域语义，避免模型把 filters 误当视图级。
过滤语法为递归 and/or/not 结构，可全局或按视图施加。
skills/obsidian-bases/SKILL.md
Filters narrow down results. They can be applied globally or per-view.
注：这里在做什么：确立过滤器的两个作用域与可嵌套特性。
公式语言从 properties 取值计算，统一在 formulas 段定义后可跨视图复用。
skills/obsidian-bases/SKILL.md
Formulas compute values from properties. Defined in the `formulas` section.
注：这里在做什么：把公式定位成可复用的派生属性。
this 关键字随上下文改变指代对象（主区=base 文件本身，嵌入=嵌入文件，侧栏=主区活动文件）。
skills/obsidian-bases/SKILL.md
In main content area: refers to the base file itself
注：这里在做什么：消解 this 的多义性，这是 Bases 公式里最容易出错的语义点。
视图类型四种：table/cards/list/map；map 视图依赖经纬度属性与 Maps 社区插件。
skills/obsidian-bases/SKILL.md
Requires latitude/longitude properties and the Maps community plugin.
注：这里在做什么：标注 map 视图的外部前提，防止模型无脑生成不可用视图。
交付形态支持嵌入 Markdown：既可整份 base 嵌入，也可只嵌某个视图。
skills/obsidian-bases/SKILL.md
Embed in Markdown files:
注：这里在做什么：衔接 Bases 与普通笔记的使用方式，给出 ![MyBase.base#View Name] 语法。
2核心能力
01完整 .base YAML schema：filters/formulas/properties/summaries/views 五段及各自字段
02递归过滤语法：单条件、and/or/not 嵌套与视图级 filters
03公式语法：算术、条件、字符串格式化、日期运算与复杂表达式
04九类函数库参考：全局/日期/字符串/数字/列表/文件/链接/对象/正则
05四种视图类型（table/cards/list/map）及其 limit/groupBy/order/summaries 配置
06默认汇总公式表（Average/Min/Max/Sum/Median/Stddev 等 15 项）与自定义 summaries
07嵌入 Markdown：整份嵌入或指定视图嵌入
08YAML 引号规则与常见过滤模式（按标签/文件夹/日期范围/属性值/组合条件）
4风险提醒 风险提醒：绿色 · 放心使用
风险提醒：绿色 · 放心使用
- 语法随 Obsidian 版本演进，技能无版本锚定。 — SKILL.md 未写适用 Bases 版本；上游变更可能导致示例失效，需按官方文档复核。
- 不生成/不校验 .base 文件，正确性依赖宿主模型遵循度。 — 无 lint/validator 步骤，错误 YAML 可能被直接写入用户 vault。
- map 视图依赖 Maps 社区插件，技能不提供。 — SKILL.md 自述 map 视图需要经纬度属性与社区插件，技能本身不含该插件。
纯指令型：SKILL.md 全文为 markdown 规范与 yaml 示例，§3 扫描确认无脚本执行、无网络请求、无凭证读取、无写盘、无危险旗标。目录仅 SKILL.md 一个文件。风险提醒：绿色，放心使用。注意 .base 语法随 Obsidian 版本演进，技能未标适用版本，示例可能滞后。
5第二遍独立确认
- [ok] 文件面核对（是否有未列脚本/资产） — §1 清单仅 skills/obsidian-bases/SKILL.md 一个文件（16442 字节 / 619 行），无 scripts/references/assets；bundle 未标「已截断」，无需额外 read。
- [ok] 外部资源条目复核 — §3 的 4 条 URL 全为文末 References 段的 help.obsidian.md 文档链接（syntax/functions/views/formulas），非运行时调用，故 external_deps 判空。
- [ok] 安全结论反例搜索 — §3 显示凭证/外部程序/写盘/网络请求/危险旗标/沙箱均无命中；全文为文本，无代码执行面。
- [ok] 能力清单是否夸大 — description 声称的 views/filters/formulas/summaries 均可在 §2 找到对应章节与示例；技能只产出 YAML，不生成渲染结果，无越界承诺。
- [ok] 档位判定复核 — 按 §4 口径，纯指令型且无任何脚本/网络/写盘 → 🟢 green 成立。
6结论
适合：需要创建或编辑 Obsidian Bases（.base）的用户：搭建任务追踪、阅读清单、项目看板等数据库式笔记视图；把 Bases 语法作为规范注入模型以避免幻觉字段。
不适合：不使用 Obsidian Bases 的场景；需要技能直接生成渲染结果或自动安装 Maps 插件的场合；对 Bases 版本敏感、要求与上游最新语法同步的场景。
安装 agent 直装可复制
① 本站镜像 更新 2026-10-10
方式 A · 人下载镜像包下载 obsidian-bases.tar.gz
sha256:
方式 B · JSON 格式安装指南，复制给 agent3c2cb6921fd69419…agent 读 JSON 指南后会自动从本站下载安装，无需更多说明。
② 上游 GitHub · 原始来源
来源信息 GitHub 原始
作者 / 仓库freestylefly / freestylefly/canghe-skills
原始 GitHubfreestylefly/canghe-skills ↗
本 skill commit
dd0bf35595许可MIT（仓库根 LICENSE）
本站信息
收录日期2026-09-06
分类内容创作
侦查报告AI 侦查 · 2 遍 · 2026-09-06
本站镜像与 GitHub 原始是不同来源：本站锁定 commit 快照经 /r2 分发；GitHub 为实时上游，内容可能已更新。