用途:在 Obsidian 个人知识库与 Claude Code 会话之间建立集成,用于查找相关笔记、加载项目上下文,并管理来自 Telegram 的内容捕捉。据资料,其工作流包括加载上下文、搜索笔记、处理收件内容与直接写入捕捉。
主要能力:通过 obs CLI 进行全文搜索、标签搜索与语义相似度搜索,读取或新建笔记,浏览标签、最近修改与未处理收件项,加载项目上下文,构建与更新嵌入并查看嵌入统计;通过 ingest CLI 轮询、处理、查看、重试或清除 Telegram 消息。
使用方式:常用命令包括 obs search、obs semantic、obs read、obs write、obs tags、obs recent、obs incoming、obs context、obs embed、obs stats,以及 ingest poll、ingest process、ingest status、ingest retry、ingest clear。路由示例:加载项目上下文、按语义搜索笔记、查看收件箱、把内容保存到笔记。配置需在 ~/.claude/.env 中设置 OBSIDIAN_VAULT_PATH 与 OPENAI_API_KEY;嵌入数据库为 ~/.claude/embeddings.db,ingest 状态库为 ~/.claude/ingest-state.db。
适用场景与限制:适合在编码会话开始、过程中和结束后加载项目上下文、检索参考资料并回写研究结果;vault 预期包含 Inbox、Projects、Reference、Archive、attachments,标签约定如 project/<name>、incoming、decision、meeting、reference、todo。资料未说明具体平台、收费与价格;语义搜索依赖 OPENAI_API_KEY,Telegram 捕捉需相应连接。排查语义搜索可先 obs stats 再 obs embed,Telegram 捕捉异常可用 ingest test/poll/status。