ARTICLE DETAIL

资讯详情

深耕郑州网站建设与运营推广的一线实战洞察。

Hermes Agent + Obsidian 打造第二大脑(五):Templater、Dataview、QuickAdd 插件配置与效率提升完整指南

Hermes Agent + Obsidian 打造第二大脑(五):Templater、Dataview、QuickAdd 插件配置与效率提升完整指南 1. 为什么你的 Obsidian 笔记库需要这三个插件Obsidian 本体只是一个本地 Markdown 编辑器它把文件读写、双链、图谱这些基础能力做得很扎实但真正让它从「记笔记的软件」变成「第二大脑」的是插件生态。我见过太多人装了一堆插件结果每天打开库还是手动敲 frontmatter、手动翻文件夹找项目、手动复制粘贴会议模板效率没提升反而更乱。问题不在插件本身而在于没有把「捕获—组织—检索」这条链路串起来。这一篇聚焦三个核心插件Templater 负责模板自动化解决「每次新建笔记都要重复写元数据」的问题Dataview 负责数据查询解决「笔记存进去就找不回来」的问题QuickAdd 负责快速捕获解决「灵感来了要切三次窗口才能记下来」的问题。三者配合 Hermes Agent 的本地 API 能力才能让笔记库真正跑起来。适合已经建好 Obsidian 库、装过几个插件但没形成工作流的人也适合刚接触第二大脑概念、想一次性把基础打牢的读者。我试过只装 Dataview 不装 Templater 的阶段结果是查询语句写得再漂亮源数据格式不统一查出来的表格全是空列。后来才明白模板是数据质量的入口查询是数据价值的出口捕获是数据流入的闸门缺一个都转不动。下面按「先配环境、再写配置、后验证、最后排障」的顺序展开每一步都给可复制的片段。2. TaoToken 与 Hermes Agent 的前置准备Hermes Agent 要读写 Obsidian 库走的是 Local REST API 这条本地通道而 Agent 本身在调用模型做摘要、分类、生成模板建议时需要一个稳定的模型接入点。这里用 TaoToken 作为统一入口它的 API 地址是 https://taotoken.net/api 兼容 OpenAI 风格的请求格式配置起来不用改代码结构。先说清楚它是什么、能做什么。TaoToken 是一个模型调用聚合服务你拿到一个 Key 之后可以用同一套 Base URL 和鉴权方式调用不同厂商的模型适合在 Hermes Agent 这种需要频繁切换模型做不同任务的场景里减少配置成本。适合谁适合已经在用 Obsidian 做知识管理、想让 Agent 自动整理笔记但不想为每个模型单独维护一套环境变量的人。前置准备分三步。第一步在 TaoToken 控制台创建一个 API Key地址是 https://taotoken.net/api-keys 创建后复制保存后面配置里要用。第二步确认你的 Obsidian 库已经装好 Local REST API 插件并启用了 1973 端口这个在下一节会详细写。第三步确认 Hermes Agent 的配置文件位置通常在用户目录下的.hermes/config.toml或项目根目录的hermes.toml具体看你安装方式。这里要提醒一个容易踩的坑很多人把模型 Key 和 Obsidian 的 API Token 搞混。前者是给 Hermes Agent 调模型用的走 https://taotoken.net/api 后者是给 Agent 读写 Obsidian 用的走http://localhost:1973。两者完全独立配置时不要写进同一个字段。我见过有人把 TaoToken 的 Key 填到 Obsidian 的 api.token 里结果请求一直 401排查了半天才发现是两套鉴权。如果你还没决定用哪个模型可以先在模型对话页面试一下不同模型对中文笔记摘要的效果地址是 https://taotoken.net/models 选一个响应速度和摘要质量都合适的再写进 Hermes Agent 配置。长期做编码和 Agent 任务的话Coding Plan 页面 https://taotoken.net/coding-plan 有更详细的套餐说明按自己的调用量选就行。3. 可复制的插件配置与模板片段这一节是全文的核心所有片段都可以直接复制到你的库里。先给目录结构再给每个插件的配置项最后给模板文件内容。路径统一用templates/作为模板文件夹0_临时、1_日记/每日、2_项目、3_知识作为主要分区你可以按自己的习惯改名但改完要同步改配置里的路径。3.1 Templater 配置与模板Templater 装好后进入设置把「Template folder location」设为templates打开「Trigger Templater on new file creation」这样用 Templater 新建文件时才会自动渲染。核心语法是% %包裹表达式%* %包裹 JavaScript 代码块。每日日记模板templates/daily.md--- title: % tp.date.now(YYYY-MM-DD) % date: % tp.date.now(YYYY-MM-DD) % day: % tp.date.now(dddd) % tags: [日记, 每日] created: % tp.date.now(YYYY-MM-DD HH:mm) % --- # % tp.date.now(YYYY-MM-DD) % % tp.date.now(dddd) % ## 今日重点 1. ## 记录 ### 工作 - ### 学习 - ## 明日计划 - [ ] --- *由 Templater 创建于 % tp.date.now(YYYY-MM-DD HH:mm) %*项目模板templates/project.md用 suggester 让用户选优先级--- title: % await tp.system.prompt(项目名称) % date: % tp.date.now(YYYY-MM-DD) % status: 进行中 importance: % await tp.system.suggester([高, 中, 低], [high, medium, low]) % tags: [项目] created: % tp.date.now(YYYY-MM-DD HH:mm) % --- # % await tp.system.prompt(项目名称) % ## 目标 1. ## 里程碑 - [ ] 阶段一 - [ ] 阶段二 ## 经验教训 ---会议模板templates/meeting.md--- title: % await tp.system.prompt(会议名称) % date: % tp.date.now(YYYY-MM-DD) % time: % tp.date.now(HH:mm) % tags: [会议] type: meeting --- # % await tp.system.prompt(会议名称) % **时间**% tp.date.now(YYYY-MM-DD HH:mm) % **参会人**% await tp.system.prompt(参会人逗号分隔) % ## 议程 1. ## 讨论 ## 决策 1. ## 待办 - [ ] ---3.2 Dataview 配置与查询Dataview 装好后在设置里打开「Enable JavaScript Queries」和「Enable Inline Queries」缓存间隔保持默认即可。查询写在代码块里语言标记为dataview。项目看板查询放在2_项目/看板.mdTABLE status AS 状态, importance AS 优先级, file.mtime AS 最后更新 FROM 2_项目 WHERE status 进行中 SORT importance DESC本周新增笔记查询TABLE file.ctime AS 创建时间, tags AS 标签 WHERE file.ctime date(today) - dur(7 days) SORT file.ctime DESC LIMIT 20待办任务汇总TASK WHERE !completed AND file.folder 2_项目 SORT file.mtime DESC3.3 QuickAdd 配置QuickAdd 装好后添加一个 Template 类型的 Choice命名为「快速捕获」模板路径选templates/inbox.md目标文件夹设为0_临时打开「Create in same folder as active file」关闭。再添加一个 Capture 类型的 Choice命名为「追加到今日日记」目标文件设为1_日记/每日/{{date:YYYY-MM-DD}}.md捕获格式选「Append to bottom」。templates/inbox.md内容--- title: % await tp.system.prompt(标题) % date: % tp.date.now(YYYY-MM-DD HH:mm) % tags: [临时, 收集] type: inbox --- # % await tp.system.prompt(标题) % ## 内容 % await tp.system.prompt(内容) % ## 待处理 - [ ] --- *由 QuickAdd 捕获于 % tp.date.now(YYYY-MM-DD HH:mm) %*3.4 Hermes Agent 接入配置Hermes Agent 的配置文件里模型部分指向 TaoTokenObsidian 部分指向本地 API。以 TOML 为例[model] base_url https://taotoken.net/api api_key 你的_TaoToken_Key model_id 你选的模型ID [obsidian] enabled true api_url http://localhost:1973 api_token 你的_Obsidian_API_Token vault_path /你的库绝对路径 [obsidian.folders] inbox 0_临时 daily 1_日记/每日 projects 2_项目 knowledge 3_知识三件套对照Base URL 填https://taotoken.net/apiKey 填 TaoToken 控制台创建的 KeyModel ID 填你在模型对话页面选定的模型标识。这三个字段缺一不可写错任何一个都会在验证阶段报错。4. 验证请求与成功结果配置写完不算完要跑一遍验证。先验证 Obsidian 本地 API 通不通再验证 Hermes Agent 能不能通过 TaoToken 调模型并读写笔记。第一步确认 Local REST API 插件已启用端口 1973 监听正常。在终端执行curl http://localhost:1973/api/notes如果返回一个 JSON 数组里面是你库里的笔记路径列表说明本地 API 通了。如果返回Connection refused说明插件没启用或端口被占去插件设置里检查。第二步验证写入。执行curl -X POST http://localhost:1973/api/notes \ -H Content-Type: application/json \ -H Authorization: Bearer 你的_Obsidian_API_Token \ -d {path: 0_临时/验证.md, content: # 验证\n\n写入成功}返回{success: true}或类似结构去 Obsidian 里看0_临时/验证.md是否出现内容是否正确。第三步验证 Hermes Agent 调模型。在 Agent 里发一条指令让它读取0_临时/验证.md并生成一句摘要。如果 Agent 返回了摘要内容说明模型调用和 Obsidian 读写两条链路都通了。这一步如果报 401检查 TaoToken Key 是否填对如果报local proxy failed检查api_url是不是写成了https而不是http本地 API 默认不走 TLS。第四步验证 Dataview 查询。在任意笔记里插入一段dataview代码块查询0_临时文件夹下的文件LIST FROM 0_临时切到阅读视图如果能看到刚才写入的验证.md说明 Dataview 索引正常。如果显示「No results」检查文件夹路径拼写以及 Dataview 设置里的「Enable JavaScript Queries」是否打开。第五步验证 QuickAdd 快捷键。按你设置的快捷键看是否弹出模板选择或直接创建笔记。如果没反应去设置里的快捷键面板搜索 QuickAdd确认没有冲突。全部通过后你的链路就是QuickAdd 捕获 → Templater 渲染元数据 → Dataview 检索 → Hermes Agent 通过 TaoToken 调模型做摘要和分类。这条链路跑通一次后面就是重复使用。5. 本篇常见错误排查这一节按真实报错来写遇到对应错误直接对照处理。401 Unauthorized。两种可能一是 TaoToken Key 填错或过期去控制台重新创建二是 Obsidian API Token 没填或填错去 Local REST API 插件设置里复制正确的 Token。注意两个 Token 不要混用模型请求走 TaoToken笔记读写走本地 API。local proxy failed / connection refused。Hermes Agent 连不上 Obsidian先确认 Local REST API 插件已启用再确认端口是 1973 且没有被其他程序占用。macOS 上可以用lsof -i :1973查看占用情况。另外确认api_url写的是http://localhost:1973不要写成https。reading choices / 模型返回空。Agent 调模型时返回结构里没有 choices 字段通常是 Base URL 写错。确认填的是https://taotoken.net/api不要多加/v1或漏掉/api。如果用的是兼容模式检查请求体里的 model 字段是否和你在模型对话页面选的 ID 一致。OAuth / 鉴权失败。如果你用的是 Claude Code 或类似工具接入鉴权方式可能不是简单的 Bearer Token。这种情况下确认你用的是 API Key 模式而不是 OAuth 模式TaoToken 的接入文档里有详细说明地址是 https://taotoken.net/doc 。Dataview 查询无结果。先确认源笔记的 frontmatter 格式正确YAML 里冒号后面要有空格标签用数组或逗号分隔。再确认查询的文件夹路径和实际路径一致大小写敏感。最后确认 Dataview 设置里「Enable JavaScript Queries」已打开否则部分查询语法不生效。Templater 模板不渲染。必须用 Templater 的「新建文件」功能创建笔记普通方式新建不会触发模板。另外确认模板文件夹路径设置正确模板文件确实在templates/下。语法上%* %是代码块% %是表达式不要写反。QuickAdd 快捷键冲突。去设置里的快捷键面板搜索 QuickAdd看是否有红色冲突提示。有冲突就换一个组合键推荐CmdShiftD给日记CmdShiftN给捕获CmdShiftP给项目。插件装多了卡顿。核心插件保持 5 个以内Templater、Dataview、QuickAdd、Local REST API、Git。界面类插件按需装资源密集型插件如 Graph Analysis 在大库上要限制计算范围。超过 20 个插件基本会明显卡顿。6. 把链路用起来从捕获到检索的日常动作配置跑通之后日常使用其实就三个动作。灵感来了按 QuickAdd 快捷键选「快速捕获」填标题和内容笔记落到0_临时。每天固定时间打开日记模板Templater 自动填好日期和元数据你只管写内容。每周打开项目看板Dataview 自动列出进行中的项目和高优先级任务不用手动翻文件夹。Hermes Agent 在这里的角色是自动整理。你可以让它每天定时读取0_临时里的笔记通过 TaoToken 调模型做摘要和分类然后写回3_知识对应主题下。这一步的配置在 Agent 的定时任务里模型部分复用前面写的[model]配置Obsidian 部分复用[obsidian]配置。如果你还没拿到 TaoToken 的 Key先去 https://taotoken.net/api-keys 创建一个再按第三节的配置填进 Hermes Agent。接入文档在 https://taotoken.net/doc 里面有不同工具的完整配置示例。长期做编码和 Agent 任务的话Coding Plan 页面 https://taotoken.net/coding-plan 可以看套餐详情。最后给一个实用技巧模板文件本身也用 Git 管理这样换电脑或者重装 Obsidian 时templates/和.obsidian/plugins/一起同步配置不会丢。.gitignore里排除workspace.json和缓存文件只保留插件配置和模板库体积小、同步快。
返回列表