1. 用 Claude Code + OrbitOS 把 Obsidian 改造成 AI 笔记大脑

1.1. 核心要点

• 自然语言交互：通过 Claude Code 实现能听懂自然语言的 Obsidian 库。
• AI 自动化管家：利用 OrbitOS 规则集，实现每日规划、归档和深度研究自动化。
• 结构化知识库：建立清晰的目录体系（项目、研究、知识库、日记），实现知识的原子化管理。
• 高效斜杠命令：内置 /start-my-day、/research、/kickoff 等强大命令。

1.2. 📖 这篇教程能给你带来什么

读完之后，你会得到：

• 一个能听懂自然语言的 Obsidian 库
• 一个 AI 管家：每天早上帮你列待办、晚上帮你归档
• 一套结构清晰的目录：项目、研究、知识库、日记一目了然
• 几个超好用的斜杠命令：/start-my-day、/research、/kickoff……

适合人群：

• 用过 Obsidian 但觉得“整理太累”的人
• 想试试 AI Agent 但不知道怎么落地的人
• 喜欢折腾、追求效率的知识工作者

预计耗时：30 分钟（含安装 + 上手第一个工作流）

1.3. 🧩 整体架构

简单说：你说话 → Claude Code 听 → 按 OrbitOS 的规则 → 在 Obsidian 里写文件。

1.4. 🛠 第一步：安装“三件套”

1. 安装 Obsidian
2. 安装 Node.js（Claude Code 的依赖）
3. 安装 Claude Code

1.5. 📦 第二步：拉取 OrbitOS 模板

OrbitOS 是一套现成的“规则集”，包含目录结构、斜杠命令、提示词模板。我们直接拉中文版。

打开终端，切到你想放 Obsidian 库的位置（比如 ~/Documents）：

cd ~/Documents

拉取模板（不带 git 历史，保持干净）：

npx degit MarsWang42/OrbitOS/CN my-vault

备用方案（Git 克隆）：

git clone --filter=blob:none --sparse https://github.com/MarsWang42/OrbitOS.git my-vault
cd my-vault
git sparse-checkout set CN
mv CN/* CN/.* . 2>/dev/null; rmdir CN

拉取完成后，my-vault 文件夹的结构如下：

my-vault/
├── 00_收件箱/    ← 灵感先扔这里
├── 10_日记/      ← 每日日志
├── 20_项目/      ← 活跃项目
├── 30_研究/      ← 深度研究笔记
├── 40_知识库/    ← 原子化概念
├── 50_资源/      ← 通讯、参考资料
├── 90_计划/      ← 执行方案
└── 99_系统/
    ├── 归档/
    ├── 提示词/    ← AI 人设
    └── 模板/

这种结构通过数字排序，可以一眼看清楚什么是核心、什么是辅助。

1.6. 🔗 第三步：连接 Obsidian

1. 打开 Obsidian。
2. 点击左下角的 “打开其他库”。
3. 选择 “打开本地库” → 找到刚才那个 my-vault 文件夹。
4. 信任作者（OrbitOS 模板里有一些社区插件配置）。

打开后，你会看到左侧已经有完整的文件夹结构。

1.7. 🤖 第四步：启动 Claude Code

这一步是关键。 Claude Code 会把当前目录当作工作区，所以必须在 Vault 根目录启动它。

在终端中执行：

cd ~/Documents/my-vault
claude

Claude 会扫描目录，加载 OrbitOS 自带的提示词和命令配置（通常位于 .claude/ 或 99_系统/提示词/）。

成功启动后，你将进入交互界面。

1.7.1. 🎁 推荐：安装 Obsidian Terminal 插件

为了避免频繁切换窗口，建议安装内嵌终端插件：

1. Obsidian 设置 → 第三方插件 → 关闭“安全模式”。
2. 浏览社区插件，搜索 Terminal（作者：polyipseity）。
3. 安装并启用。
4. 使用快捷键打开终端面板，直接运行 claude。

1.8. 🌅 第五步：运行你的第一个工作流

1.8.1. 场景：每日规划

在 Claude Code 中输入：

/start-my-day

AI 将会：

1. 扫描 00_收件箱/。
2. 汇总 20_项目/ 中的活跃进展。
3. 在 10_日记/ 中创建今日日志（如 2026-05-17.md）。
4. 列出今日重点和推荐任务。

1.8.2. 场景：捕捉灵感

在 00_收件箱/ 创建文件 临时想法.md：

想做一个 X 平台的爆款内容监控工具，能自动识别正在变热的推文，分析它们的话题、句式、情绪，给我推送可参考的模板。

1.8.3. 场景：启动项目

输入命令：

/kickoff

AI 将自动：

1. 识别收件箱中的想法。
2. 引导你完善项目背景（MVP 范围、时间等）。
3. 在 20_项目/ 下创建标准的 C.A.P. 结构（背景 / 行动 / 进展）文档。

1.8.4. 场景：深度研究

/research X 平台爆款内容的共性

AI 将在 30_研究/ 创建笔记，并提取核心概念到 40_知识库/，自动建立 [[双向链接]]。

1.8.5. 场景：快问快答

/ask Obsidian 的 dataview 插件能查询 frontmatter 吗？

直接获取答案，不污染知识库。

1.8.6. 场景：周期性归档

/archive

自动将超过 30 天未更新的内容移至 99_系统/归档/。

1.9. 📋 命令速查表

1.10. 🎨 锦上添花的细节

1.10.1. 双向链接是灵魂

OrbitOS 的价值核心在于 [[双向链接]]：

• [[项目名]]：直接链接。
• [[项目名|显示文本]]：别名链接。
• ![[日期]]：嵌入日记内容。

1.10.2. C.A.P. 项目结构

每个项目文档遵循以下结构：

• Context（背景）：目标是什么？
• Actions（行动）：待办清单。
• Progress（进展）：带日期记录的流转日志。

1.11. 🐛 常见问题

• Q：不认识命令？ 确认终端运行路径为库根目录。
• Q：支持本地模型？ 官方主推 Claude/Gemini，本地模型需自行配置。
• Q：存量笔记如何迁移？ 建议用 /parse-knowledge 逐步喂给 AI 重新整理。

1.12. 🌟 一周使用建议

1.13. 📚 延伸阅读

• OrbitOS 官方仓库
• Claude Code 官方文档
• Obsidian Terminal 插件

1.14. 💬 结语

OrbitOS 的设计哲学非常深刻：“AI 不是工具，而是理解你的系统、帮你维护它的协作者。”

AI 接管了繁琐的整理工作，让我们得以将精力还给思考本身。

去试试吧，跑一周，感受知识库自动“生长”的魅力。