零代码第 1 天：用 Cursor 接上博客仓库，终于知道该动哪里

我不是程序员。今天在 Cursor 和 Obsidian 里折腾了一整天，终于把「博客网站」和「我该怎么写字」这两件事分清楚了。写下来，一是给自己备忘，二是希望对其他 零代码、用 AI 学建站 的朋友有点用。

我原来卡在哪里

• 网站已经在 Vercel 上能打开，但 Cursor 里打开的是空文件夹，和真正项目对不上。
• 代码在 Codex 上连着 Git，本地其实有一份，路径是：文稿/nodeaitry.com。
• 想用 Obsidian 写文章，却不知道要打开哪个文件夹，左侧也看不到 content/posts。

本质问题：工具很多，但不知道「唯一真相」在本机哪个目录。

今天在 Cursor 里做了什么

1. 确认本地仓库位置
   项目叫 Idea Vault，文件夹名是 nodeaitry.com，完整路径：

   /Users/zhiwen/Documents/nodeaitry.com
   

2. 让 Cursor 和 Codex 对齐
   以后改网站样式、修 bug、加功能，应该在 Cursor 里 打开这个文件夹，而不是空的 test 或其它目录。

3. 和 AI 一起整理了写作要用的东西（已放进仓库）：

   • content/TAGS.md：标签说明
   • Templates/：Obsidian 新建文章用的模板
   • Obsidian入门.md：Obsidian 打开库、插模板、发布步骤
   • 一篇示例文：obsidian-git-workflow.md

4. 搞懂技术栈分工（仍然不全会写代码，但知道谁干什么）：

   服务	干什么
   GitHub 私有仓	存代码 + Markdown 文章
   Vercel	自动构建、上线网站
   Cloudflare D1	评论、用户等动态数据
   Cloudflare R2	图片等大文件
   Obsidian	写 content/posts 里的文章
   Cursor / Codex	改 src 等代码

Obsidian：我只需要动这几处

用 Obsidian 打开整个 nodeaitry.com 文件夹（不是子文件夹，也不是新建空库）。打开成功后，左侧应能看到：

content/posts/     ← 平时写文章（最重要）
Templates/         ← 插入模板
content/TAGS.md    ← 查标签
Obsidian入门.md    ← 操作说明

平时不要动（交给 Cursor / Codex / AI）：

• src/、scripts/、migrations/、node_modules/、.env.local 等

一句话：写文章只碰 content/posts + 模板；改网站别在 Obsidian 里乱改代码。

一篇文章长什么样

每篇文是 Markdown，最上面有一段配置（frontmatter），网站靠它显示标题、标签、是否发布：

---
title: 文章标题
slug: url-英文名
date: 2026-05-22
category: note
tags:
  - site-build
  - ai-learning
excerpt: 列表页显示的一两句摘要
draft: false
---

正文从这里开始……

• draft: true：草稿，不会出现在博客
• draft: false：推送部署后会公开
• slug 对应网址：/blog/你的-slug

标签用英文 slug，例如 site-build、ai-learning、obsidian，完整列表见 content/TAGS.md。

写完怎么推到博客（小白版）

方式一：终端（我现在会用这个）

在项目文件夹执行：

cd ~/Documents/nodeaitry.com
git add content/posts/你的文章.md
git commit -m "post: 简短说明写了啥"
git push

然后等 1～3 分钟，Vercel 会自动构建。打开网站刷新 /blog 或首页，能看到新文章就成功了。

方式二：Obsidian Git 插件（可选）

装好 Obsidian Git 并配置 GitHub 后，可以在 Obsidian 里一键提交、推送，原理和上面一样，只是不用开终端。

方式三：Codex

在 Codex 里改完内容后走它自带的 Git 推送，也会触发 Vercel 部署。关键是：改的文件要在 nodeaitry.com 这个仓里，且文章在 content/posts/。

给同样零基础的人的几条建议

1. 先找到本机那一个文件夹，在访达里确认路径，再交给 Obsidian / Cursor 打开。
2. 不要同时在 Obsidian 和 Cursor 里改同一篇代码文件，文章归 Obsidian，代码归 Cursor。
3. 第一篇先复制示例文改几个字，走通 push → 网站出现，比一上来写长文更有信心。
4. 大图别塞进 Git，用 R2 的链接写在正文里。
5. 善用 AI：描述你想写什么，让 AI 帮你检查 frontmatter 和 draft 有没有填对。

我接下来的计划

• 熟练 Obsidian 模板 + content/posts 写作节奏
• 试着配置 Obsidian Git，少开终端
• 网站侧：RSS、sitemap、首页搜索等（交给 Cursor 改 src）
• 开始写 AI 工具、硬件、crypto 观察类笔记，而不只是建站日记

如果你也是用 AI 从零搭博客，欢迎在评论区说说你卡在哪一步（评论会进审核）。能自己在 /blog 列表里看到这篇文章，就说明 Obsidian / Cursor → Git → Vercel 这条链路对我已经通了。