Obsidian探索与配置

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

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

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

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

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

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

🔗 完整对话记录（WorkBuddy 任务分享）：将工具记忆保存到 Obsidian

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记忆方案

06-Obsidian探索与配置