---
title: "06-Obsidian探索与配置"
created: 2026-08-27
tags:
  - 小技能
---

# Obsidian探索与配置

> 📚 从 2026-08-27 装 Obsidian 到现在，我对它做的探索、配置和迁移全记录：从"GitHub 全端同步"一个念头，到 Trilium 4000 篇大搬家，再到把它升级成 AI 跨工具的记忆底座。技术约定细节见 [[04-Obsidian使用技巧]]，同步操作见 [[05-Obsidian-Git多端同步]]，记忆系统本身见 [[07-AI记忆方案]]。

## 起点：一次对话装好的整套东西

2026-08-27 凌晨，我在 WorkBuddy 里说了一句"obsidian 我还没下载 帮我下载"，十几分钟内完成的事：

1. **安装 Obsidian v1.13.7**：DMG 拖进 Applications
2. **创建 Vault**：`/Users/zhouwei5/Documents/Obsidian Vault`
3. **注册命令行 CLI**：Settings → General → 打开「命令行界面」→ 按提示注册（需管理员密码，自动创建 `/usr/local/bin/obsidian` 符号链接）
4. 然后我问了一个改变后续所有走向的问题：**"使用 GitHub 建立仓库的方式来维护自己的笔记，做到全端同步，可行性如何？"**

CLI 注册后终端可直接操作笔记：

```bash
obsidian vault="Obsidian Vault" daily                  # 打开今日日记
obsidian vault="Obsidian Vault" search query="关键词"   # 搜索笔记
obsidian vault="Obsidian Vault" create name="新笔记"    # 创建笔记
```

> 🔗 完整对话记录（WorkBuddy 任务分享）：[将工具记忆保存到 Obsidian](https://workbuddy.cc/agents/tasks/share/xRWPShekeU?platform=workbuddy-ai&ext2=copy_link)

## Git 私有仓与多端同步

- 私有仓库：`git@github.com:Userwei0418/obsidian-notes.git`（GitHub CLI 浏览器 OAuth 登录，全程不碰 token）
- 端内用 obsidian-git 插件定时 commit + push，多端自动同步——配置与踩坑见 [[05-Obsidian-Git多端同步]]

## Trilium → Obsidian 大迁移（2026-08-27 完成）

我 2023 年起的全部笔记都在 Trilium（SQLite 单文件库），迁移动机与结果：

| 项目 | 数量 |
| --- | --- |
| Trilium 源笔记总数 | 4062 篇 |
| 成功迁移为 Markdown | ~2900 篇（text 2883 + code 60 + mermaid 2 + 存根 163） |
| 提取附件/图片 | 10410 个 → `attachments/` |
| 转换内部链接 | 1802 个，全部转为 wiki 双链 |
| 跳过：系统节点 / 加密笔记 / 空笔记 | 1498 / 17 / 325 |
| 最终库 | 3142 个 .md，attachments 约 1.4 GB |

**目录映射**：Note → `2-Learning`；Blog → `7-Blog/Trilium`；求职/面试 → `5-Career`；工作 → `3-Work`；日历 → `1-Daily`；思考/记账 → `6-Life`；简历 → `5-Career/Resume`。

迁移细节（存根扩展名按内容识别修复 113 个、HTML→MD 转换规则、frontmatter 约定）记录在 `ai-sessions/projects/P001-obsidian-memory/artifacts/P001-A002-trilium-migration-report.md`。

**我的 Trilium 使用心得单独成篇**：[[03-Trilium笔记]]。

## Vault 结构与模板系统

顶层按用途分区（数字前缀=学习/优先顺序，规则详见 [[04-Obsidian使用技巧]]）：

| 目录 | 用途 |
| --- | --- |
| `0-Inbox` | 收件箱，未整理 |
| `1-Daily` | 日记 |
| `2-Learning` / `2-Learning` | 旧学习库 / 重制版学习库 |
| `3-Work` · `5-Career` | 工作 / 求职 |
| `4-Projects` | 项目文档 |
| `6-Life` | 思考、记账 |
| `7-Blog` | 博客内容 |
| `_templates` | 模板 |
| `ai-sessions` | AI 记忆（项目/会话/产物，见 [[07-AI记忆方案]]） |

模板 7 个：`ai-session`（AI 会话记录）、`blog-article`、`blog-publish-properties`、`daily-note`、`default-note`、`general`、`meeting`——新建笔记按类型套用，保证 frontmatter 一致。

## Obsidian 私有仓库驱动个人博客（设计中）

Trilium 博客方案（见 [[03-Trilium笔记]] 第八节）的升级设想：**以 Obsidian 私有 Git 仓库为唯一事实源，自动发现候选文章 → 准入审核 → Node 后端同步引擎 → 公开网站**。2249 行详细设计已完成（`4-Projects/个人博客/Obsidian私有仓库驱动个人博客-详细设计.md`），覆盖产品边界、权限、发布闭环、同步引擎、Markdown 解析、SQLite 数据模型、搜索与缓存。

核心卖点：写作工具只有 Obsidian 一个，发布是仓库的副产品；文章有稳定身份（内容契约），附件随仓库走。

## 这套探索的下一步

Obsidian 对我只是**载体**；真正的目标是让任何 AI 工具都能读写这套笔记作为长期记忆——那就是 [[07-AI记忆方案]] 的故事了。

---
⬅️ [[05-Obsidian-Git多端同步]] 🏠 [[00-小技能]] ➡️ [[07-AI记忆方案]]