用 OpenCode-Obsidian 打造第二大脑：AGENTS.md 配置与个人知识库工作流最佳实践

【免费下载链接】opencode-obsidianEmbed OpenCode AI assistant directly in Obsidians sidebar.项目地址https://gitcode.com/gh_mirrors/op/opencode-obsidian点击查看免费下载OpenCode-Obsidian 是一款免费的 Obsidian 插件它把 OpenCode AI 助手直接嵌入 Obsidian 侧边栏让你不必切换窗口就能总结长文、检索个人知识库、生成结构化笔记。本文带你用 AGENTS.md 设定 AI 的行为规则并搭建一套可长期复用的第二大脑工作流从安装、配置到 4 个高效用法一次讲清。一、OpenCode-Obsidian 是什么为什么适合做第二大脑传统 Obsidian AI 插件大多只提供一个简单的聊天框而 OpenCode-Obsidian 走了另一条路它在你本地启动一个 OpenCode 服务器进程再用 iframe 把 OpenCode 的完整 Web 界面嵌进 Obsidian 窗口里。这意味着你获得的是 OpenCode 的全部能力而不是一个受限的对话窗口。核心特点完整嵌入复用 OpenCode 原生界面无需额外开发聊天 UI本地运行数据留在自己的机器上服务器按需自动启动上下文注入自动把当前打开的笔记和选中文本喂给 AIAGENTS.md 驱动用一份约定文件告诉 AI 你的知识库规则提示该插件仅支持桌面版依赖 Node.js 子进程安装前请确认你用的是 Desktop 版本详见 manifest.json。二、5 分钟上手安装与打开 OpenCode 面板安装前提依赖说明桌面版 Obsidian最低 1.4.0OpenCode CLI需在本机安装Bun用于构建开发者需要方式一通过 BRAT 安装推荐新手从 Obsidian 社区插件安装BRATBeta Reviewers Auto-update Tool打开 BRAT 设置点击Add Beta plugin输入mtymek/opencode-obsidian点击Add PluginBRAT 会自动安装最新 release在Settings Community Plugins中启用 OpenCode 插件方式二开发者安装把仓库克隆到 vault 的.obsidian/plugins/obsidian-opencode子目录git clone https://gitcode.com/gh_mirrors/op/opencode-obsidian .obsidian/plugins/obsidian-opencode然后进入该目录执行bun install bun run build最后在 Obsidian 中启用插件即可。两种打开面板的方式点击左侧 Ribbon 上的终端图标或按快捷键Cmd/Ctrl Shift O切换面板打开面板时服务器会自动启动懒加载无需手动操作。面板入口逻辑见 src/ui/ViewManager.ts。三、核心配置用 AGENTS.md 让 AI 真正懂你的知识库这是打造第二大脑最关键的一步。OpenCode 会读取项目根目录下的AGENTS.md文件把它当作工作守则。你在 Obsidian 的 vault 根目录创建一份AGENTS.md就等于给 AI 立了一套专属你知识库的规则。AGENTS.md 能定义什么知识库的目录结构如Inbox/、Notes/、Projects/命名与标签规范常用术语表 / 缩写回答风格语言、语气、是否先给文件路径敏感信息处理边界一份面向个人知识库的 AGENTS.md 模板参考项目自带的 AGENTS.md下面这份模板可以直接改用# AGENTS.md - 我的知识库 ## 知识库结构 - Inbox/ 未整理的临时笔记 - Notes/ 已沉淀的主题笔记 - Projects/ 进行中的项目 - Journal/ 每日记录 ## 回答规则 - 始终用简体中文回答 - 优先引用 Notes/ 里的已有内容避免凭空编造 - 涉及多个文件时先给出文件路径列表 - 不确定时明确说明不要猜测 ## 术语表 - 第二大脑 个人知识管理体系 - ZK 知识卡片ZettelkastenProject directory决定 AI 的工作范围插件默认把vault 根目录作为 OpenCode 的工作目录因此会自动找到根目录的AGENTS.md。若你希望 AI 只在某个子目录活动可在设置里指定Project directory覆盖默认值。项目目录的解析逻辑见 src/main.ts。四、上下文注入让 AI 自动看到你打开的笔记这是 OpenCode-Obsidian 最实用的特性之一。开启后插件会自动把你当前打开的笔记路径和选中的文本注入到 OpenCode 会话中让 AI 回答时看得到你的上下文。三个关键开关在设置面板里设置项作用默认值Inject workspace context是否注入工作区上下文开启Max notes in context最多注入多少条打开的笔记20Max selection length选中文本的最大长度2000 字符注入格式长这样obsidian-context Currently open notes in Obsidian: - Notes/AI/第二大脑.md - Projects/写作计划.md Selected text (from Notes/AI/第二大脑.md): 你选中的那段文字…… /obsidian-context 注入是替换式的新上下文会覆盖上一条不会在会话历史里越堆越多。上下文采集与格式化逻辑见 src/context/WorkspaceContext.ts 与 src/context/ContextManager.ts。注意上下文注入目前是实验功能从 OpenCode 界面新建会话时可能不生效。五、个人知识库工作流4 个高效用法结合 AGENTS.md 与上下文注入下面 4 个场景最能体现第二大脑的价值。1. 长文摘要与提炼打开一篇长笔记或选中一段直接问 AI帮我提炼核心观点和待办事项。得益于上下文注入AI 会自动知道你正在读哪篇笔记。2. 查询与探索知识库问关于 X 我记录过什么AI 会基于你的笔记内容作答相当于给知识库配了一个懂你语境的检索助手。3. 生成大纲与结构化笔记把零散的 Idea 丢给 AI让它按你 AGENTS.md 里定义的目录结构生成大纲或卡片再落回 Obsidian。4. 草稿打磨与改写选中一段草稿让 AI 按你设定的回答规则改写、润色或压缩风格始终保持一致。六、进阶设置自定义命令与服务器管理Custom Command Mode当你想给 OpenCode 启动加上额外参数、用自定义包装脚本或通过容器 / 虚拟环境运行时可启用Use custom command。⚠️ 使用自定义命令时注意主机名和端口必须与上面设置一致必须包含--cors app://obsidian.md否则 Obsidian 无法嵌入界面示例opencode serve --port 14096 --hostname 127.0.0.1 --cors app://obsidian.md服务器状态管理设置面板底部有实时的Server Status显示当前状态Stopped / Starting / Running / Error及服务器 URL并可直接Start / Stop / Restart。进程生命周期管理见 src/server/ServerManager.ts。七、常见问题与最佳实践清单Windows 提示 Executable not found at opencode这是 Electron 在 Windows 上未完整继承 PATH 导致的。先运行where opencode.cmd找到完整路径再把该路径填入设置的OpenCode path即可。常见疑问面板打不开 / 显示报错打开面板会自动启动服务器若失败到设置面板查看错误详情并点Retry为什么移动端不可用插件依赖 Node.js 的child_process.spawn()移动端不支持仅限桌面版改了设置没生效部分设置修改后会自动重启服务器属于正常现象✅ 最佳实践清单在 vault 根目录建立AGENTS.md写清知识库结构与回答规则保持AGENTS.md精简规则聚焦、可执行开启上下文注入按需调整笔记数量与选中文本长度常用场景用固定提问句式让 AI 输出更稳定定期回顾并更新 AGENTS.md让第二大脑与你共同成长声明本插件为第三方软件作者与 OpenCode、Obsidian 官方无隶属关系。赞分享【免费下载链接】opencode-obsidianEmbed OpenCode AI assistant directly in Obsidians sidebar.项目地址https://gitcode.com/gh_mirrors/op/opencode-obsidian点击查看免费下载相关推荐7个高效Obsidian模板技巧打造你的第二大脑知识库想象一下当你面对海量的学习资料、工作笔记和创意想法时是否曾感到无从下手传统的文件夹分类法往往让知识变得支离破碎而Obsidian Templates项目知识管理Hivemind与Git集成技能版本与代码仓库同步方案完全指南 Hivemind与Git集成技能版本与代码仓库同步方案完全指南 Hivemind 作为一款强大的AI代理共享记忆系统通过 Git集成 实现了智能化的技人工智能AI AgentAgent 记忆AI 技能RAGMCP 服务Obsidian知识管理革命用模板库打造你的第二大脑 Obsidian知识管理革命用模板库打造你的第二大脑 还在为笔记杂乱无章而烦恼吗想要拥有一个真正属于自己的知识管理系统吗今天我要为你介绍一个改变游戏知识管理创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考