AI时代的入门基础架构:三层工具栈

AI时代的入门基础架构：三层工具栈

不是让你追最新的模型，也不是比较哪家API便宜——而是先把底层基建搭好。这三层工具，构成了AI时代个人效率的最小完备集。

为什么是”三层架构”？

很多人用AI的方式是：打开网页，问完关掉，下次从零开始。

这样用，AI永远只是一个搜索引擎的替代品。

真正让AI持续为你创造价值的方式，是给它一个可以操作的环境：一个存放你知识的地方、一个管理版本和同步的系统、一个能真正执行任务的入口。

这三层，缺一不可。

第一层：Obsidian / Markdown编辑器   ← 知识存储与管理
第二层：GitHub / 版本控制平台        ← 同步、备份、版本历史
第三层：Claude Code / AI CLI工具    ← AI执行层，连接一切

第一层：Obsidian（或任何强大的 Markdown 编辑器）

是什么

Obsidian 是一款本地优先的 Markdown 笔记软件，支持双向链接、知识图谱、插件扩展。类似的选择还有 Logseq、Notion（部分功能）、Typora、VSCode + 插件等。

核心原则只有一个：用 Markdown 格式存储你的内容。

为什么 Markdown 是 AI 时代的基础格式

Markdown 是纯文本。纯文本意味着：

AI 可以直接读写，不需要任何格式转换
跨平台、跨工具，十年后依然能打开
体积极小，几千篇笔记也不超过几十 MB
版本控制友好，Git 可以精确追踪每一行改动

当你把笔记存成 .md 文件，Claude Code、本地模型、任何 AI Agent 都可以像操作代码一样操作你的知识库——读取、修改、生成、索引。这是 Word 文档、Notion 数据库、印象笔记永远给不了你的自由度。

优点

数据自主：文件在本地，不依赖任何云服务存活
AI 友好：Markdown 是主流大模型的原生格式，读写无障碍
双向链接：把碎片知识连成网络，而不是一个文件夹堆砌
插件生态：Obsidian 有丰富的插件（Git 同步、Dataview 数据库视图、Canvas 白板等）
跨平台：Mac / Windows / Linux / iOS / Android 全覆盖
免费核心功能：基础功能完全免费，同步功能可自建解决

局限

多设备同步需要付费订阅官方同步，或自己配置 Git / iCloud / WebDAV
协作功能薄弱，偏向个人使用
初次上手需要花时间建立笔记结构

与 AI 结合能做什么

场景	做法
AI 直接读写你的笔记	Claude Code 指向 Obsidian vault 目录，直接读取 / 修改 `.md` 文件
构建个人知识库	将 AI 对话输出、文章摘要、项目记录统一存入 vault，AI 可检索引用
自动整理笔记	用 AI 对零散笔记重新归类、补充标签、生成摘要
生成博客文章	AI 读取多篇笔记，综合生成可发布的文章草稿
项目记忆	把项目背景、决策记录存入 Obsidian，AI 每次工作前先读取，保持上下文连贯

第二层：GitHub（或任何 Git 版本控制平台）

是什么

GitHub 是基于 Git 的代码托管平台，但它能管理的远不止代码——任何文本文件都可以用它做版本控制。类似选择还有 GitLab、Gitea（自部署）、Forgejo 等。

为什么版本控制是 AI 时代的基础设施

AI 会帮你大量生成和修改内容。没有版本控制，你不知道改了什么、改对了没有、能不能回退。

Git 给了你一个完整的操作历史：每一次 AI 修改了你的文件，都有记录。出了问题，一条命令回到昨天。

更重要的是：GitHub 是 AI Agent 最理想的外部记忆和协作中枢。 Claude Code、OpenClaw、HermesAgent 都可以通过 Git 操作来读写你的知识库、配置文件、项目文档——这是把 AI 接入你工作流的标准接口。

优点

版本历史：每次改动有据可查，随时回滚
云端备份：本地 + 远端双重保险，不怕硬盘损坏
不只是代码仓库：笔记、文档、配置、prompt 模板全都可以管理
AI Agent 的标准接口：主流 AI 工具都原生支持 Git 操作
自动化能力：GitHub Actions 可以触发自动化工作流（自动发布博客、自动同步、自动部署）
免费：个人私有仓库完全免费，存储慷慨

局限

国内访问速度有时不稳定，需要代理或镜像
命令行操作有一定学习门槛（可用图形客户端 GitHub Desktop 降低门槛）
不适合存储大型二进制文件（图片、视频需配合 Git LFS 或外部图床）

与 AI 结合能做什么

场景	做法
Obsidian 笔记云端备份	用 Obsidian Git 插件自动 commit，笔记有了完整版本历史
AI 修改有记录	Claude Code 每次操作文件后 commit，清楚知道 AI 改了什么
个人配置版本管理	CLAUDE.md、prompt 模板、工作流配置统一存入 GitHub
静态博客托管	配合 GitHub Pages，写完直接发布，零成本
自动化工作流	GitHub Actions 监听 push 事件，自动触发构建、发布、通知
多设备同步	Mac、Windows、手机、服务器，所有设备共享同一份最新内容

第三层：Claude Code / AI CLI 工具

是什么

这一层是整个架构的执行层——真正让 AI 动起来、做事情的工具。

代表性工具：

Claude Code（Anthropic 官方 CLI，agentic 能力最强）
Codex CLI（OpenAI 出品，类似定位）
Gemini CLI（Google 出品）
Cursor / Windsurf（IDE 级 AI 编程工具，有图形界面）
OpenClaw / HermesAgent（开源 AI Agent 平台，支持多渠道、自部署）

核心特征：这些工具可以操作你的文件系统、执行命令、调用 API——而不只是在聊天窗口里输出文字。

为什么 CLI / Agent 工具是关键

网页版 AI 的边界是：你把内容复制进去，它输出文字，你再复制出来。

CLI 和 Agent 工具打破了这个边界：

直接读你硬盘上的文件
直接写入修改
执行 shell 命令
调用外部 API
提交 Git commit
发送消息、触发流程

AI 不再是一个你去找它的工具，而是一个在你的工作环境里运转的协作者。

优点

通用优点（所有 CLI / Agent 工具）：

直接操作本地文件系统，无需复制粘贴
可与 Obsidian vault 和 GitHub 仓库深度集成
支持长任务、多步骤自动化
可编写脚本，批量处理大量内容
非程序员也能通过自然语言完成复杂任务

Claude Code 特有优点：

支持 CLAUDE.md 自定义 AI 行为和身份
MCP（Model Context Protocol）扩展外部服务接入
Agentic 能力强，适合复杂多步骤任务
多平台：Mac / Windows / Linux / 云服务器

OpenClaw / HermesAgent 特有优点：

开源，完全可定制
支持多渠道接入（微信、Telegram、QQ、Discord、飞书等）
持久化记忆，跨对话保持上下文
服务器部署，7×24 小时在线
数据完全自主，不依赖第三方平台

局限

国内使用需要代理（访问海外 API）
按 token 计费，高频使用有成本
操作权限较大，需要谨慎配置权限范围
OpenClaw / HermesAgent 部署门槛相对高，需要一定的服务器运维能力

与 AI 结合能做什么

场景	做法
批量处理 Obsidian 笔记	AI 遍历 vault 中所有文件，自动整理标签、补充摘要、重新分类
自动发布博客	AI 读取笔记 → 生成文章 → commit 到 GitHub → 触发 Pages 构建
代码开发	描述需求，AI 写代码、测试、修 bug、提交，全流程自动化
文档处理	批量 OCR、格式转换、内容提取，AI 直接输出成品文件
个人助理（OpenClaw）	在微信 / Telegram 里直接调用 AI，AI 记得你的历史和偏好
知识问答	AI 以你的 Obsidian 笔记为知识库，回答关于你自己项目的问题
自动化工作流	AI 监听文件变化、定时执行任务、跨服务数据同步

三层架构的完整工作流

你的想法 / 信息输入
        ↓
  Obsidian（记录、整理、存储为 Markdown）
        ↓
  GitHub（版本控制、云端同步、自动化触发）
        ↓
  Claude Code / AI Agent（读取、执行、生成、输出）
        ↓
  成品输出（博客文章、代码、报告、自动化结果…）

这三层的关系是：

Obsidian 是你的知识大脑，存放所有原材料
GitHub 是神经网络，连接所有设备和工具，保存所有历史
Claude Code / Agent 是手和脚，真正执行任务、产出结果

缺了第一层，AI 没有可以调用的知识背景。缺了第二层，AI 的操作没有记录，无法回溯，多设备也无法同步。缺了第三层，你还是在手动复制粘贴，效率的天花板很低。

入门建议

如果你刚开始搭建，按这个顺序来：

先装 Obsidian，把现有的笔记、文档迁移成 Markdown 格式，养成用 Markdown 记录的习惯
注册 GitHub，创建一个私有仓库，把 Obsidian vault 用 Git 同步上去
安装 Claude Code 或 Cursor，先从简单任务开始——让 AI 读你的笔记、帮你整理一篇文章
逐步扩展——当你感受到这套工作流的效率之后，再考虑部署 OpenClaw / HermesAgent，把 AI 接入你的日常通讯

不需要一次全部搭好。每一层单独用都有价值，组合起来价值成倍放大。

最后一句话：AI 模型每隔几个月就会更新换代，但你搭建的这套基础架构会一直在——而且会随着你的使用越来越”懂你”。这才是 AI 时代真正值得投入的地方。