Ekko Agent 的 Obsidian 技能指南：使用官方 CLI 管理 Vault 笔记、任务与属性

AI 应用人工智能AI Agent本地部署前端后端工作流自动化【免费下载链接】ekko-studioEkko Studio is a local-first AI workspace for multi-agent chat, coding, and visual workflows, available on desktop and the web.项目地址https://gitcode.com/gh_mirrors/he/ekko-studio点击查看免费下载导读本文围绕 Ekko AgentEkko Studio 的本地优先多智能体工作台内置的obsidian技能展开讲解如何通过 Obsidian 官方命令行接口CLI完成 Vault 笔记的读取、搜索、创建、编辑、移动、删除、任务处理与属性/链接维护。读完本文你将掌握obsidian command [namevalue] [flag]的完整命令范式与安全边界并理解 Ekko Agent 的技能加载、Frontmatter 校验与关键词路由机制如何在底层支撑这份指令文档生效。技能文档在仓库中的位置与定位该技能的指令文档位于 packages/ekko-agent/skills/obsidian/SKILL.md。它的 YAML Frontmatter 声明了技能名称与用途--- name: obsidian description: Read, search, create, edit, organize, and inspect Obsidian vault notes, tasks, links, properties, and plugins with the official CLI. metadata: keywords: - obsidian vault - obsidian cli - obsidian notes ---其中metadata.keywords并非装饰性字段。从 技能路由实现 的resolveSkillRouting可以看出Ekko Agent 会基于用户消息与技能名称、名称变形连字符/下划线替换为空格以及显式声明的keywords做确定性匹配长描述与技能正文不参与自动选择。也就是说当用户提到 obsidian vault、obsidian cli 等关键词时本技能才会被路由命中并注入指令。每个技能本质上是一个实现了AgentSkill接口的对象其instructions字段承载这份 SKILL.md 文本定义见 packages/ekko-agent/src/skills/types.ts。技能按 Profile 注册与隔离通过EkkoSkillManagerpackages/ekko-agent/src/skills/manager.ts暴露skill_list、skill_view、skill_manage等工具本技能属于随包发布的只读内置技能Agent 通过skill_view nameobsidian即可加载其完整指令。前置条件让 CLI 可用且可验证使用obsidian技能前需满足四个前提缺一不可Obsidian 1.12.7 或更新版本已安装——官方 CLI 自该版本起随桌面应用提供。Settings General Command line interface开关已启用——CLI 是可选能力默认关闭。obsidian命令已注册到PATH——安装器通常自动完成但需以obsidian version实测确认。Obsidian 桌面应用正在运行——CLI 通过连接桌面应用进程工作不直接操作文件系统。在不改动 Vault 的前提下可用下面两条命令做连通性检查obsidian version obsidian help技能文档明确了一条纪律若 CLI 缺失应解释如何在 Obsidian 中启用官方 CLI而不是静默安装第三方obsidian-cli包。这避免了向用户环境引入来源不明的二进制属于技能的安全底线。Vault 选择显式优于猜测Obsidian 用户常同时打开多个 Vault因此目标不明确时必须显式指定vaultname在多个 Vault 之间指定目标名称有歧义时应询问用户而不是猜测。pathFolder/Note.md使用 Vault 内相对路径做精确解析优先推荐。filename使用 Obsidian 基于名称的解析适合名称唯一且路径未知的场景。同时文档划定了两条隐私与配置红线不要编辑.obsidian/配置除非用户明确要求修改设置或插件避免读取或暴露私人 Vault 中与任务无关的笔记。命令模式统一的 namevalue 语法所有 CLI 操作遵循同一范式obsidian command [namevalue] [flag] obsidian vaultNotes search querymeeting notes formatjson要点参数采用namevalue形式含空格的值必须加引号优先使用结构化输出例如formatjson便于程序解析支持flag形式的开关如newtab、verbose、counts、all、todo、done等。打开与读取在 Obsidian 中定位笔记obsidian open fileRecipe obsidian open pathInbox/Idea.md newtab obsidian read obsidian read fileRecipeopen在 Obsidian 中打开指定笔记file按名称解析path按 Vault 相对路径精确解析追加newtab可在新标签页打开。read读取当前活动笔记带file时读取指定笔记。由于 Vault 笔记本质是 Markdown文档也给出了补充策略当已知精确的 Vault 路径、且操作不需要 Obsidian 更新链接或元数据时可以直接用文件工具读写笔记内容。搜索查询与结构化结果obsidian search queryTODO matches obsidian search querystatus::active formatjson obsidian search:open queryproject notessearch query...执行 Vault 内全文搜索matches输出匹配位置formatjson输出结构化结果。search:open在 Obsidian 界面中打开搜索结果视图适合需要人机协作确认的场景。搜索同样遵循namevalue参数规范多词查询务必整体加引号。创建与修改受控的写操作obsidian create nameNew Note obsidian create pathInbox/Idea.md content# Idea obsidian append fileNote contentNew line obsidian prepend fileNote contentAfter frontmattercreate新建笔记可用name由 Obsidian 决定存放位置或path指定 Vault 内完整路径并附带content初始正文。append/prepend在既有笔记末尾或 Frontmatter 之后追加内容。技能文档对写操作给出两条强约束仅当用户提出要求时才创建或修改笔记——技能不主动产生写入副作用。多行或用户提供的内容要避免脆弱的 Shell 插值——优先采用基于文件的安全工作流或在解析出精确 Vault 路径后使用 Agent 的文件工具完成。移动与删除交给 Obsidian 维护链接obsidian move fileNote toArchive/ obsidian move pathInbox/Old.md toProjects/New.md obsidian delete fileNotemove支持file按名称或path按路径指定源to指定目标目录或完整新路径。优先使用 Obsidian 的移动命令以便其同步更新笔记间的引用链接。执行前必须核对确切的源与目标避免误移。delete会永久移除笔记若删除目标并非用户请求中已明确的对象删除前必须向用户确认。日记与任务高频个人知识管理场景obsidian daily obsidian daily:read obsidian daily:append content- [ ] Review inbox obsidian tasks all todo obsidian task fileNote line8 donedaily/daily:read/daily:append分别用于打开、读取、追加今日日记日记模板由 Obsidian 日记插件配置决定。tasks all todo列出所有未完成任务task fileNote line8 done将指定笔记第 8 行的任务标记为完成。文档特别提醒完成任务会修改笔记内容因此应用更改前必须先解析确切的文件与任务行号防止改错目标。属性与链接Frontmatter 与双向链接运维obsidian tags all counts obsidian property:read fileNote namestatus obsidian property:set fileNote namestatus valuedone obsidian backlinks fileNote obsidian unresolved verbose countstags all counts统计全部标签及其出现次数。property:read/property:set读取/写入笔记属性对应笔记 Frontmatter 字段是批量维护元数据的安全途径——例如把任务状态status从todo更新为done。backlinks fileNote查询反向链接unresolved verbose counts定位未被解析的链接悬空链接便于清理断链。插件与开发者命令诊断与插件开发专用obsidian plugin:reload my-plugin obsidian dev:errors obsidian dev:screenshot fileshot.png obsidian eval app.vault.getFiles().lengthplugin:reload重载指定插件适合插件开发调试。dev:errors查看应用运行时错误日志dev:screenshot对当前窗口截图。eval在应用上下文执行 JavaScript 表达式如统计 Vault 文件数。技能文档对这类命令划出明确边界插件重载与eval可能改变或窥探大范围应用状态仅限明确的插件开发或诊断任务使用对于用户提供的任意 JavaScript未经审查其影响前不得通过obsidian eval执行——这是本文档中仅次于删除确认的又一道安全闸门。文件模型Vault 的构成与操作选择Vault 内部存在多种文件类型操作方式应区别对待类型后缀/位置说明笔记*.mdMarkdown 文本可直接读写画布*.canvasJSON 格式的 Canvas 画布文件附件Vault 配置的附件目录图片、音视频等资源配置.obsidian/Vault 级配置目录非明确要求不修改据此形成操作分派原则有界的批量文本修改定位正确 Vault 后可直接进行 Markdown 编辑需要 Obsidian 感知的行为链接维护、属性变更、任务勾选、移动删除一律走 CLI 的move、delete、property、task等命令。源码视角这份指令如何被校验、路由与执行Frontmatter 校验约束Ekko Agent 对每个技能的 SKILL.md 有严格的 Frontmatter 校验见 packages/ekko-agent/src/tools/skills.ts 中的validateSkillContent必须以 YAML Frontmatter 开头且name必须与目录名一致必须提供非空descriptionmetadata.keywords至少 1 条、最多 8 条每条不超过 80 字符且必须为英文 ASCII 文本或技术标识符Frontmatter 之后必须存在 Markdown 正文。本技能文档完全满足上述约束3 条关键词、紧凑的英文描述、完整的 Markdown 正文因此校验状态为valid可被纳入关键词路由。校验失败的技能会被标记为needs_metadata或invalid从而被排除在自动路由之外相关行为可参考 tests/ekko-agent/skill-tools.test.ts 中无 Frontmatter 技能被判invalid的用例。从发现到注入的调用链obsidian技能从磁盘到模型上下文经过以下链路discoverSkills递归扫描技能目录读取每个目录下的SKILL.md解析出name、description、keywords、category、来源local/external/builtin与校验状态listSkillNames/matchSkillsForUserMessage依据用户消息与关键词做确定性匹配resolveSkillRouting命中后把技能名注入系统提示Agent 在运行中通过skill_view nameobsidian加载完整指令正文——工具返回内容同时携带baseDirectory、字符数与 sha256 指纹便于后续校验与审计若用户需要观察 CLI 输出Agent 依据指令文档执行obsidian命令并解析formatjson等结构化结果。外部技能目录如团队共享的~/shared-skills同样受支持配置解析见 packages/ekko-agent/src/skills/external-directories.ts支持~、~/...与环境变量$VAR/${VAR}展开外部目录被视为只读来源不会被skill_manage修改。内置技能含obsidian通过.ekko-builtin-skills.json清单标识不能被删除修改内置技能会被拒绝这是保护随包技能完整性的机制。安全边界小结不安装第三方obsidian-cliCLI 缺失时引导用户启用官方 CLIVault 歧义时询问用户不猜测不碰.obsidian/配置不读无关私有笔记写操作仅在用户要求时执行多行内容避免 Shell 插值删除前确认、移动前核对源与目标插件重载与eval仅在明确任务下使用用户提供的脚本需先审查影响。这些边界与 Ekko Agent 技能体系的设计一脉相承技能既是能力的注入也是行为约束的载体——obsidian技能用一份 120 余行的指令文档把「读取、搜索、创建、编辑、组织、检视」Vault 的能力与「不越权、不猜测、先确认」的执行纪律同时固化下来。赞分享AI 应用人工智能AI Agent本地部署前端后端工作流自动化【免费下载链接】ekko-studioEkko Studio is a local-first AI workspace for multi-agent chat, coding, and visual workflows, available on desktop and the web.项目地址https://gitcode.com/gh_mirrors/he/ekko-studio点击查看免费下载相关推荐如何一键下载整个抖音主页Douyin Downloader 教程如何一键下载整个抖音主页Douyin Downloader 教程 Douyin Downloader 是一个开源的抖音批量下载工具贴上一个作者的主页链接它网页爬虫CLI3个超实用技巧用Dataview批量管理你的Obsidian笔记属性3个超实用技巧用Dataview批量管理你的Obsidian笔记属性 你是否曾经面对成百上千的Obsidian笔记却为逐一修改属性而感到头疼手动更新不仅耗前端知识管理数据分析OpenProject实战指南10分钟掌握开源项目管理平台部署与高效使用OpenProject实战指南10分钟掌握开源项目管理平台部署与高效使用 OpenProject作为领先的开源项目管理软件为你提供从项目规划到团队协作的全套后端前端项目管理企业应用协同办公创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考