diff --git a/README.md b/README.md
new file mode 100644
index 0000000..69c3d13
--- /dev/null
+++ b/README.md
@@ -0,0 +1,45 @@
+# Obsidian — 刘航宇的知识库
+
+这是我的 [Obsidian](https://obsidian.md) vault，包含博客文章草稿和自研插件。
+
+## 内容
+
+- **博客/** — 已发布和草稿中的博客文章（发布到 [blog.liuhangyv.top](https://blog.liuhangyv.top)）
+- **obsidian-halo/** — Obsidian 社区插件，一键发布笔记到 Halo 博客平台
+- **Club-Service-Guide/** — 河南理工大学人工智能协会内部知识库（独立仓库）
+
+## 博客分类
+
+| 分类 | 内容 |
+|------|------|
+| 技术思考 | 技术架构、编程工具、基础设施 |
+| 行业望远镜 | AI 行业趋势与分析 |
+| 协会进行时 | 协会活动与动态 |
+| 校园AI日记 | 校园场景下的 AI 实践 |
+| 竞赛能量站 | 竞赛资讯与备赛指南 |
+| 成长实验室 | 学习成长与经验分享 |
+| 智能体前沿 | AI Agent 前沿技术 |
+
+## 使用方式
+
+```bash
+# 用 Obsidian 打开本目录作为 vault
+git clone git@lhy-git.liuhangyv.top:Serendipity/Obsidian.git
+# 在 Obsidian 中选择「打开本地 vault」→ 选择该目录
+```
+
+## obsidian-halo 插件
+
+在 `obsidian-halo/` 目录下开发：
+
+```bash
+cd obsidian-halo
+pnpm install
+pnpm run dev      # 开发模式
+pnpm run build    # 生产构建
+pnpm test:run     # 运行测试
+```
+
+## 许可
+
+博客文章版权所有。obsidian-halo 插件见其独立许可。