vault-context

Hermes Agent 插件 — 将 Obsidian vault 知识库注入对话上下文。

每次用户消息自动检索 vault 相关内容并注入 pre_llm_call hook，同时提供 vault_recall（语义搜索）和 vault_context（健康检查）两个工具。

安装

hermes plugins install git@github.com:argwa299/hermes-vault-context.git
hermes plugins enable vault-context

配置

本地模式（vault-daemon 在本机运行）

无需额外配置，默认连接 http://127.0.0.1:8643。

远程模式（vault-daemon 在另一台服务器）

设置两个环境变量：

export VAULT_DAEMON_URL=https://asdf.xin/vault-search
export VAULT_API_TOKEN=<your-bearer-token>

如果使用 Hermes 的 .env 文件（~/.hermes/.env），直接追加：

VAULT_DAEMON_URL=https://asdf.xin/vault-search
VAULT_API_TOKEN=<your-bearer-token>

提供的工具

工具	说明
vault_recall	语义搜索 vault 知识库，支持 hybrid 检索（向量 + FTS5 + reranker）
vault_context	获取 vault-daemon 状态（索引数、模型版本、健康状态）

Hooks

Hook	说明
pre_llm_call	每次用户消息自动检索 vault 并注入匹配内容到上下文

架构

Hermes Agent (任意设备)
    │
    ├── hermes memory setup hindsight → memory.asdf.xin (长期记忆)
    │
    └── vault-context 插件 → asdf.xin/vault-search (知识库检索)
                                  │
                          vault-daemon (BGE-Small-ZH)
                                  │
                          /var/www/obsidian/argwa/

所有设备共享同一套 vault 文件，通过 Bearer token 认证。