企业官网建设流程全解析

给AI智能体定规矩：Agent Client for Obsidian如何用Context Files定制专属上下文

【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client

Agent Client for Obsidian 是一款把 Claude Code、Codex、Gemini CLI 等 AI 智能体直接接入 Obsidian 的插件，基于 ACP（Agent Client Protocol）协议与智能体通信。而Context Files（上下文文件）就是给这些智能体"定规矩"的方式：一个放在库根目录的 Markdown 文件，智能体每次开启新会话时都会自动读取它，从而始终遵循你的写作偏好、目录约定和库结构。下面带你用 3 步定制出专属的 AI 上下文 📝

什么是 Context Files？一分钟理解原理

Context Files 是存放指令、偏好或背景信息的特殊 Markdown 文件。它的作用相当于给 AI 智能体发一份"入职手册"：

• ✅自动生效：智能体在每次会话开始时自动读取，无需你手动粘贴
• ✅持久生效：写一次，之后所有会话都遵循其中的规则
• ⚠️注意：这是智能体自身的功能（Agent 功能，而非插件功能），具体行为请参照所用智能体的官方文档

换句话说：插件负责把智能体"请进"Obsidian，Context Files 负责告诉它"在这个库里该怎么做事"。官方文档详见 docs/usage/context-files.md。

哪个智能体读哪个文件？对照表一次看全

不同智能体使用各自专属的上下文文件，这是新手最容易踩坑的地方。把文件放对位置（库根目录），智能体才会自动读取：

💡 小技巧：多智能体用户可以在聊天头部菜单中随时切换，而每个智能体只会认自己那份文件——所以混用时建议各写一份，或按主用智能体配置。

本项目仓库本身就用到了这套机制：根目录下的 CLAUDE.md、AGENTS.md 和 GEMINI.md 就是写给不同智能体看的开发者指南，可以直接打开看看真实例子。

3步写出你的第一份 Context File

第 1 步：在库根目录创建文件

按上表为所用智能体建一个文件，比如 Claude Code 用户就新建CLAUDE.md。

第 2 步：写入你的"规矩"

官方推荐的经典结构是"总览 → 偏好 → 重点目录 → 约定"四段式：

# Vault Context ## Overview 本库用于存放我的个人笔记和研究资料。 ## Preferences - 使用简洁、清晰的风格写作 - 列表使用无序列表 - 优先使用 Markdown 格式 ## Important Notes - `Templates/` - 笔记模板目录 - `Daily/` - 每日笔记目录 ## Conventions - 日期统一使用 YYYY-MM-DD 格式 - 笔记使用相关主题标签

第 3 步：开启新会话验证

Context Files 在会话开始时加载——修改文件后，打开一个新的聊天视图即可让新规则生效。

进阶玩法：Context Files 与插件功能如何配合

Context Files 解决"长期背景"，插件的其它功能则补齐"即时上下文"，两者组合威力最大：

• @ 提及（Note Mentions）：会话级补充。用@引用具体笔记，选中文字甚至可以精确到某几行（如@My Note:5-10）。全局规则交给 Context File，临时任务交给 @ 提及。
• 提示注入（Prompt Injection）：插件可在每条会话的首条消息自动追加 Obsidian 格式化指令（Wiki 链接、LaTeX 数学公式、表格空行），让智能体输出"Obsidian 原生味道"的 Markdown。在Settings → Agent Client → Prompt injection中可按项开关：

• 任意目录对话：用New chat in directory把聊天指向任意文件夹时，智能体会自动加载该文件夹的上下文文件和项目配置——Context Files 的思路同样适用于代码库，实现"一个项目一份规矩"。

相关文档：Mentions · Prompt Injection

4个最佳实践，让 AI 真正"听话"

官方文档给出的经验法则，建议直接照做：

1. 保持聚焦（Keep it focused）—— 只写与你的库相关的内容，别把 Context File 写成说明书
2. 定期更新（Update regularly）—— 目录结构变了就同步修改，规则过时比没有更糟
3. 具体明确（Be specific）—— 给出真实示例和明确偏好，"简洁点"不如"回答控制在 3 行内"
4. 避开这些雷区：
   • 🚫 敏感信息（API 密钥、密码）——上下文会随消息发给 AI 服务商
   • 🚫 超长文件——智能体有上下文窗口限制，太长会被截断
   • 🚫 过时信息——会直接误导智能体的判断

写在最后

Context Files 是成本最低、见效最快的一步"驯化"：一份几十行的 Markdown，就能让 Claude Code、Codex 或 Gemini CLI 在你的 Obsidian 库里按你的规矩工作。先按对照表放对文件，再套用四段式模板，五分钟就能拥有一个真正懂你笔记库的 AI 智能体 🚀

完整说明请阅读 Context Files 官方文档，更多功能可浏览 Usage 文档目录。

【免费下载链接】obsidian-agent-clientBring AI agents into Obsidian via Agent Client Protocol (ACP), such as Claude Code, Codex and Gemini CLI.项目地址: https://gitcode.com/gh_mirrors/ob/obsidian-agent-client