使用说明
克劳德的黑曜石第二大脑
一个由git支持的黑曜石库，Claude通过MCP进行读写操作，创建了一个持久的、相互连接的知识图，随着你的工作而增长。
运作原理
Claude Code ──► MCP Server ──► Obsidian REST API ──► Vault (markdown + wikilinks)
- 会话开始： 克劳德拉取最新笔记，搜索你当前工作的背景
- 工作期间： Claude将发现（API关系、架构决策、操作异常）添加到相关注释中
- 会话结束： 说“结束”，克劳德就会创建一个会话摘要，将所有涉及的内容联系起来
拱顶结构
services/ One note per repo/service, with tech stack, endpoints, relationships
architecture/ Cross-cutting design decisions and ADRs
operations/ Deployment patterns, infra, runbooks, environment setup
relationships/ Service maps connecting everything
sessions/<name>/ Per-user session summaries (episodic memory)
templates/ Note templates for consistency
笔记使用 YAML 前言 用于结构化过滤和 [[维基链接]] 用于图形连接。在Obsidian中打开vault以查看图形视图。
设置（5分钟）
先决条件
步骤
-
克隆此仓库 你想要你的保险库在哪里：
git clone https://github.com/farminglvl99osrs/obsidian-second-brain.git ~/Documents/my-vault cd ~/Documents/my-vault -
作为黑曜石拱顶打开：
- 打开Obsidian>“将文件夹作为vault打开”>选择克隆的目录
-
安装REST API插件：
- 设置>社区插件>启用社区插件
- 浏览>搜索“本地REST API”>安装（Adam Coddington）>启用
- 从插件设置中复制API密钥
-
运行安装脚本：
./setup.sh这将：
- 验证先决条件（Node.js、npx）
- 在中配置Obsidian MCP服务器
~/.claude/mcp.json - 创建您的个人会话目录
-
添加行为规则 到您的Claude自动内存中（安装脚本会打印出确切的文本）
-
重新启动Claude代码 加载MCP服务器
团队使用情况
这个保险库是为通过git进行团队共享而设计的：
- 每个人克隆仓库，并将其作为自己的黑曜石金库打开
- 每个人都跑
./setup.sh配置其本地MCP连接 - 会话目录是按用户命名的(
sessions/dylan/,sessions/alex/) - 架构决策可以通过公关审查
.obsidian/被忽略（个人设置保持在本地）
注释模板
服务说明(templates/service.md)
用于记录存储库和服务：概述、技术栈、端点、关系、操作说明。Frontmatter包括 type, status, repo, owner, tags, last_updated.
会话摘要(templates/session.md)
克劳德在“包装”时自动生成。捕捉上下文、学习、决策和开放式问题，并链接到服务和工单。
架构决策(templates/architecture-decision.md)
对于跨领域决策：决策、背景（为什么）和后果（对服务的影响）。
克劳德的行为准则
这些会进入你的克劳德汽车记忆(MEMORY.md):
## Obsidian Second Brain (Vault: <path-to-vault>)
- **Start:** Run `git pull` in the vault, then use Obsidian `search` tool for context.
- **During:** When discovering new API relationships, architecture decisions, or
operational quirks, use `append_content` or `patch_content` to update the relevant
note. Always update `last_updated` frontmatter.
- **End:** When I say "wrap it up", create a session summary in
`sessions/<your-name>/YYYY-MM-DD-<topic>.md`, then git add, commit, and push.
安全
- Obsidian REST API绑定到
127.0.0.1仅限（本地主机） - 承载令牌存储在环境变量中，从未提交
- 无外部网络访问
.obsidian/gitignored（个人设置保持在本地）
