YYCircle空间

文档名

Thu, 07 May 2026 00:00:00 GMT

按实际宽度就ask的按时间啊手机打开撒娇的卡死喀什觉得阿萨

喀什觉得凯撒觉得啥#

啊手机打开觉得

MocLab 博客系统维护说明

Tue, 05 May 2026 00:00:00 GMT

MocLab 博客系统维护说明这份文档只介绍当前项目里的博客系统，不包含学术页部分。

1. 博客内容放在哪里#

博客文章统一放在：

1
src/content/posts/

支持的文章格式是：

1
.md
2
.mdx

也就是说，你平时发博客，最常见的做法就是直接在 src/content/posts/ 下面新建一个 Markdown 文件。

例如：

1
src/content/posts/why-moclab.md
2
src/content/posts/agent-security-notes.md
3
src/content/posts/aigc-detection-log.mdx

如果你想用脚本快速创建文章，也可以直接运行：

Terminal window

1
pnpm new-post your-post-name

这个命令对应的脚本在：

1
scripts/new-post.js

它会自动在 src/content/posts/ 下生成一篇带基础 frontmatter 的新文章。

2. 文章的基本格式#

当前博客文章的数据结构定义在：

1
src/content.config.ts

最常用的写法如下：

1
---
2
title: 为什么我要搭建 MocLab
3
published: 2026-05-05
4
description: 记录搭建个人技术博客的原因、定位与长期计划。
5
image: ""
6
tags: ["Blog", "Research", "Personal"]
7
category: "Reflection"
8
draft: false
9
lang: "zh-CN"
10
---
11

12
这里开始写正文。

常用字段说明：

1
title        文章标题，必填
2
published    发布时间，必填
3
description  文章简介，列表页和 SEO 会用到
4
image        封面图，可留空
5
tags         标签数组，可写多个
6
category     分类，只写一个
7
draft        是否草稿，true 时生产环境不会显示
8
lang         语言标记，可留空
9
updated      更新时间，可选
10
pinned       是否置顶，可选
11
author       作者，可选
12
sourceLink   原文链接，可选
13
licenseName  许可名称，可选
14
licenseUrl   许可链接，可选
15
comment      是否开启评论，可选
16
password     文章密码，可选
17
passwordHint 密码提示，可选

展开收起

3. 发博客的原理#

这个博客使用的是 Astro Content Collection。

简单理解就是：

你把文章写进 src/content/posts/
src/content.config.ts 负责校验文章 frontmatter 格式
Astro 在构建时读取这些文章
首页、归档、标签页、分类页、文章详情页都会自动使用这些内容

所以平时新增文章时，一般不需要手动去改路由或页面组件，只需要：

新建文章文件
填好 frontmatter
写正文
运行 pnpm build 或 pnpm dev

4. 标签和分类的逻辑#

标签怎么写#

标签来自文章 frontmatter 里的：

1
tags: ["AI Agent", "Memory", "Security"]

特点：

tags 是数组，所以一篇文章可以有多个标签
标签名按你写的字符串原样统计
同名标签会自动聚合到标签页

标签统计逻辑在：

1
src/utils/content-utils.ts

对应函数：

1
getTagList()

标签页入口在：

1
src/pages/tags.astro

点击标签后，实际会跳到归档页并带查询参数：

1
/archive/?tag=xxx

对应逻辑在：

1
src/utils/url-utils.ts

分类怎么写#

分类来自文章 frontmatter 里的：

1
category: "AI Agent"

特点：

category 是单个字符串，不是数组
一篇文章通常只属于一个分类
如果为空，会被归到“未分类”

分类统计逻辑也在：

1
src/utils/content-utils.ts

对应函数：

1
getCategoryList()

分类页入口在：

1
src/pages/categories.astro

点击分类后，实际会跳到：

1
/archive/?category=xxx

如果文章没有分类，会走：

1
/archive/?uncategorized=true

5. 文章 URL 的规则#

文章详情页路由在：

1
src/pages/posts/[...slug].astro

文章链接是根据你在 src/content/posts/ 里的文件路径生成的。

例如：

1
src/content/posts/why-moclab.md

通常会生成：

1
/posts/why-moclab/

如果你用了子目录：

1
src/content/posts/research/agent-memory.md

通常会生成：

1
/posts/research/agent-memory/

6. 头像和个人信息在哪里改#

最核心的个人资料入口在：

1
src/config/moclabSite.ts

这里集中维护了：

1
siteName
2
name
3
identity
4
blogTagline
5
description
6
blogBio
7
avatar
8
avatarFallback
9
github
10
email
11
blogNavigation

你平时最常改的是这些字段：

1
siteName: "MocLab"
2
name: "Zhongxu / Moc"
3
identity: "Computer Science Graduate Student"
4
blogTagline: "..."
5
blogBio: "..."
6
avatar: "/assets/images/icon3.jpg"
7
github: "https://github.com/..."
8
email: "mailto:your-email@example.com"

博客左侧个人卡片真正读取的配置在：

1
src/config/profileConfig.ts

不过它本身只是从 moclabSite.ts 映射过去，所以一般你直接改：

1
src/config/moclabSite.ts

就够了。

头像显示组件在：

1
src/components/widget/Profile.astro

7. 网站标题、导航和基础站点信息在哪里改#

站点级配置主要在：

1
src/config/siteConfig.ts

这里控制的内容包括：

1
站点标题
2
副标题
3
站点 URL
4
SEO 描述
5
主题色相
6
默认明暗模式
7
导航栏 logo
8
页面开关
9
文章列表布局
10
分页数量
11
分析统计

当前导航菜单的数据来源在：

1
src/config/moclabSite.ts

导航配置会被：

1
src/config/navBarConfig.ts
2
src/components/layout/Navbar.astro

读取并渲染。

如果你要修改博客导航项，优先改：

1
src/config/moclabSite.ts

8. 壁纸、横幅和主题色在哪里改#

主题色相#

主题色相配置在：

1
src/config/siteConfig.ts

对应字段：

1
themeColor: {
2
  hue: 250,
3
  fixed: false,
4
  defaultMode: "system",
5
}

其中：

1
hue          主题色相
2
fixed        是否锁定色相
3
defaultMode  默认明暗模式

壁纸和横幅#

壁纸、横幅、首页大图相关配置在：

1
src/config/backgroundWallpaper.ts

这里控制的内容包括：

1
壁纸模式
2
桌面端和移动端图片
3
首页横幅标题和副标题
4
导航栏在横幅上的透明/模糊表现
5
轮播
6
波浪动画
7
遮罩透明度

你平时最常改的字段有：

1
mode: "banner"
2
switchable: true
3
src: {
4
  desktop: [...],
5
  mobile: [...],
6
}
7
banner: {
8
  homeText: {
9
    title: "MocLab",
10
    subtitle: [...],
11
  }
12
}

壁纸图片放哪里#

当前配置里引用的壁纸图片主要在：

1
src/assets/images/DesktopWallpaper/

如果你要替换首页横幅图片，通常有两种做法：

把新图放进 src/assets/images/DesktopWallpaper/
然后去 src/config/backgroundWallpaper.ts 改 src.desktop 和 src.mobile

如果你想完全不要横幅图，只保留纯色背景，也是在这个文件里改 mode。

9. 明暗模式和文章布局在哪里改#

博客当前保留的可调项主要是：

1
明暗模式
2
文章列表/网格布局

10. 公告在哪里改#

首页公告卡片配置在：

1
src/config/announcementConfig.ts

可改内容包括：

1
公告标题
2
公告正文
3
跳转按钮文案
4
跳转链接
5
是否允许关闭

例如：

1
title: "公告"
2
content: "欢迎来到 MocLab..."
3
link: {
4
  enable: true,
5
  text: "了解更多",
6
  url: "https://academic.moclab.top",
7
}

11. 友链在哪里改#

友链页面配置在：

1
src/config/friendsConfig.ts

这个文件里有两部分：

页面级配置#

1
friendsPageConfig: {
2
  title,
3
  description,
4
  showCustomContent,
5
  showComment,
6
  randomizeSort,
7
}

友链列表数据#

1
friendLinks: [
2
  {
3
    title,
4
    imgurl,
5
    desc,
6
    siteurl,
7
    tags,
8
    weight,
9
    enabled,
10
  }
11
]

字段含义：

1
title    站点名称
2
imgurl   站点图标或头像
3
desc     简介
4
siteurl  链接地址
5
tags     标签
6
weight   排序权重，越大越靠前
7
enabled  是否显示

友链页面本体在：

1
src/pages/friends.astro

12. 赞赏在哪里改#

赞赏页面配置在：

1
src/config/sponsorConfig.ts

你可以在这里改：

1
页面标题
2
说明文案
3
赞赏用途
4
是否在文章页显示赞赏按钮
5
赞赏方式列表

最重要的是：

1
methods: [
2
  {
3
    name,
4
    icon,
5
    qrCode,
6
    link,
7
    description,
8
    enabled,
9
  }
10
]

字段含义：

1
name         赞赏方式名称
2
icon         图标
3
qrCode       收款码图片
4
link         外链方式，例如 GitHub Sponsors
5
description  说明
6
enabled      是否显示

赞赏页面本体在：

1
src/pages/sponsor.astro

如果你要换支付宝或微信收款码，通常是：

把新图片放到合适的静态资源目录
修改 src/config/sponsorConfig.ts 里的 qrCode 路径

13. About 页面在哪里改#

博客里的关于页内容来自：

1
src/content/spec/about.md

如果你只是想改“关于我”的正文，一般直接改这个文件即可。

14. 常改文件速查表#

发文章#

1
src/content/posts/

改文章字段规则#

1
src/content.config.ts

快速新建文章脚本#

1
scripts/new-post.js

改个人信息#

1
src/config/moclabSite.ts

改头像映射#

1
src/config/profileConfig.ts

改网站基础配置#

1
src/config/siteConfig.ts

改壁纸和横幅#

1
src/config/backgroundWallpaper.ts

改公告#

1
src/config/announcementConfig.ts

改友链#

1
src/config/friendsConfig.ts

改赞赏#

1
src/config/sponsorConfig.ts

改导航#

1
src/config/moclabSite.ts

改关于页#

1
src/content/spec/about.md

15. 本地预览和构建#

开发时常用命令：

Terminal window

1
pnpm dev

构建检查命令：

Terminal window

1
pnpm build

建议你每次改完以下内容后都跑一次构建：

新文章 frontmatter
导航配置
头像路径
壁纸图片路径
友链图片路径
赞赏二维码路径

16. 最简单的日常维护流程#

如果只是普通发文，最常见流程就是：

在 src/content/posts/ 新建一篇 .md
按 frontmatter 格式补全标题、时间、标签、分类、简介
写正文
跑 pnpm dev 本地看效果
最后跑 pnpm build

如果只是改个人资料，最常见流程就是：

改 src/config/moclabSite.ts
如果换头像，确认图片路径有效
跑 pnpm build

如果只是改首页横幅或壁纸，最常见流程就是：

改 src/config/backgroundWallpaper.ts
如有需要替换图片资源
跑 pnpm build

Astro + Vercel 博客部署记录

Sat, 02 May 2026 00:00:00 GMT

这篇文章专门记录 MocLab 这套博客系统的实际部署流程。目标不是只把站点“跑起来”，而是把从模板到正式上线的整条路径说明白，方便后面自己复现，也方便别人直接照着做。

这套流程适合下面这种起点：

先直接使用现成模板仓库：https://github.com/Zhong0118/moclabdemo.git
在本地把它跑起来并改成自己的内容
创建一个你自己的 GitHub 仓库来托管修改后的博客
使用 Vercel 做静态部署
买一个自己的域名
用 Cloudflare 做 DNS 和后续管理

一、先拿到模板代码#

第一步是把模板仓库拉到本地。

Terminal window

1
git clone https://github.com/Zhong0118/moclabdemo.git
2
cd moclabdemo

如果你更习惯先在 GitHub Desktop 里下载也可以，但命令行方式通常最直接。

拉下来之后，先不要急着部署，建议先在本地跑通。

二、本地环境准备#

这套项目使用的是 Node.js + pnpm + Astro。

如果你本地第一次跑前端项目，经常会遇到这几类问题：

npm 版本太低
pnpm 没安装
node 版本太旧
安装依赖时报错

最省事的处理方式通常是：

先安装一个新的 Node.js 版本
再更新 npm
再安装或更新 pnpm

建议直接安装当前可用的 Node.js LTS 版本。装好以后，先检查版本：

Terminal window

1
node -v
2
npm -v
3
pnpm -v

如果 pnpm 没有安装，可以执行：

Terminal window

1
npm install -g pnpm

如果 pnpm 太旧，也可以更新：

Terminal window

1
npm install -g pnpm@latest

如果你本地之前装过很老的 Node，最常见的现象是：

pnpm install 过程中报语法错误
Astro 相关依赖安装失败
构建时提示 Node 版本不满足要求

这时候不要死磕旧环境，直接把 Node 换新通常最快。

三、安装依赖并本地运行#

环境准备好以后，在项目根目录执行：

Terminal window

1
pnpm install

安装完成后，先本地启动开发环境：

Terminal window

1
pnpm dev

如果只是验证构建是否正常，也可以直接跑：

Terminal window

1
pnpm build

只要 pnpm build 能通过，就说明这套博客的核心静态构建链路是通的，后面接 Vercel 时会顺很多。

四、把模板改成你自己的博客#

模板拉下来之后，至少要先改下面几类内容。

1. 改个人信息#

最核心的站点信息配置在：

1
src/config/moclabSite.ts

这里通常要改：

网站名称
你的名字
身份介绍
简介
GitHub 链接
邮箱
导航菜单

2. 改网站基础配置#

站点级设置在：

1
src/config/siteConfig.ts

这里通常会改：

站点标题
副标题
site_url
主题色配置
默认明暗模式
页面开关

如果后面你换成自己的域名，这里的 site_url 最好也同步改成正式地址。

3. 改头像和个人卡片#

头像路径和个人卡片信息主要来自：

1
src/config/moclabSite.ts
2
src/config/profileConfig.ts

4. 改博客文章#

文章写在：

1
src/content/posts/

你可以删掉默认示例文章，也可以保留一部分再慢慢替换。

5. 改 About、友链、赞赏、公告#

常见内容入口如下：

1
关于页：src/content/spec/about.md
2
友链：src/config/friendsConfig.ts
3
赞赏：src/config/sponsorConfig.ts
4
公告：src/config/announcementConfig.ts
5
壁纸与横幅：src/config/backgroundWallpaper.ts

如果你后面只想维护博客内容，不想每次都翻代码，可以直接看我前面写的维护说明：

1
docs/blog-system-guide.md

五、把这个项目放到你自己的 GitHub#

当你在本地改完自己的内容后，不建议一直继续推原模板仓库，最好建立一个属于你自己的 GitHub 仓库。

方案一：新建自己的空仓库，然后绑定远程#

先去 GitHub 上新建一个新的 repository，例如：

1
my-blog

然后在本地项目目录执行：

Terminal window

1
git remote -v

如果当前远程还是模板仓库，你可以改成自己的仓库：

Terminal window

1
git remote remove origin
2
git remote add origin https://github.com/你的用户名/你的仓库名.git

然后提交并推送：

Terminal window

1
git add .
2
git commit -m "init my blog"
3
git branch -M main
4
git push -u origin main

方案二：直接在 GitHub 上导入模板后再拉本地#

如果你不想手动改远程，也可以先在 GitHub 上创建自己的仓库，再把本地代码推上去，本质上是一样的。

六、什么时候适合开始接 Vercel#

建议满足下面几件事后再接 Vercel：

本地 pnpm install 正常
本地 pnpm build 能过
站点标题、个人信息、基础配置至少已经改成自己的
代码已经推到你自己的 GitHub 仓库

只要这几件事都满足，Vercel 那边一般就比较顺。

七、用 Vercel 部署博客#

1. 登录 Vercel#

打开：

1
https://vercel.com/

建议直接用 GitHub 账号登录，这样后面导入仓库最方便。

2. 导入你的 GitHub 仓库#

登录后：

点击 Add New...
选择 Project
授权 Vercel 访问你的 GitHub
选择你刚才新建的博客仓库

3. 检查构建配置#

像这种 Astro 静态站点，一般 Vercel 会自动识别。

通常重点只要确认：

1
Framework Preset: Astro
2
Install Command: pnpm install
3
Build Command: pnpm build
4
Output Directory: dist

如果它已经自动识别好了，通常不需要额外改。

4. 开始部署#

确认没问题后直接点部署。

部署成功后，你会先拿到一个 Vercel 提供的默认域名，例如：

1
your-project.vercel.app

这时候你就已经可以先访问站点了。

建议先用这个默认域名检查：

首页能不能打开
文章页能不能打开
分类、标签、归档是否正常
图片资源是否正常
自定义页面是否正常

八、买自己的域名#

如果你想正式长期使用，下一步通常就是买域名。

域名在哪里买都可以，常见平台都行。买的时候有几个简单建议：

优先选择短、容易记的域名
尽量避免太复杂的拼写
如果是个人站，.com、.top、.xyz 之类都比较常见
如果你以后要长期使用，尽量一开始就确定好主域名

比如你最后可能会用：

1
www.example.com
2
example.com

九、把域名接到 Cloudflare#

Cloudflare 在这套流程里主要负责：

DNS 管理
域名解析
HTTPS 辅助
后续缓存、安全和规则管理

1. 注册并登录 Cloudflare#

打开：

1
https://www.cloudflare.com/

注册账号并登录。

2. 把域名添加到 Cloudflare#

在 Cloudflare 后台添加你的站点，例如：

1
example.com

Cloudflare 会扫描你当前已有的 DNS 记录。如果你是新域名，没有太多记录也没关系。

3. 修改域名注册商的 Nameserver#

这是 Cloudflare 接入里最关键的一步。

Cloudflare 会给你两条 Nameserver，例如：

1
xxx.ns.cloudflare.com
2
yyy.ns.cloudflare.com

你需要回到你买域名的平台，在域名管理面板里，把原来的 Nameserver 改成 Cloudflare 提供的这两条。

这一步完成后，域名的 DNS 控制权才真正切到 Cloudflare。

注意：

Nameserver 生效通常需要一点时间
有时几分钟，有时几个小时
不同注册商传播时间不一样

十、把域名绑定到 Vercel#

等 Cloudflare 接管好域名之后，就可以回到 Vercel 里绑定正式域名。

1. 在 Vercel 项目里添加 Domain#

进入你的 Vercel 项目后台：

打开项目
进入 Settings
找到 Domains
添加你的域名

例如：

1
example.com
2
www.example.com

2. 按照 Vercel 提示配置 DNS#

如果你使用的是 Cloudflare，通常需要在 Cloudflare 的 DNS 里添加 Vercel 要求的记录。

常见情况一般是下面两类：

根域名#

可能需要：

A 记录
或 ALIAS / CNAME Flattening 形式

`www` 子域名#

通常更常见的是：

CNAME

Vercel 后台会明确告诉你应该填什么值，你按它给的值填就可以，不要死记固定 IP。

3. 在 Cloudflare 里添加 DNS 记录#

到 Cloudflare 的 DNS 页面，把 Vercel 要求的记录补上。

一个常见思路是：

@ 指向主站
www 指向 Vercel 分配的目标

如果你不确定是否要开 Cloudflare 代理，前期建议先使用更稳妥的方式：

先保证解析正确
先让站点稳定可访问
后续再决定要不要开代理、缓存和其他安全规则

十一、域名生效后要同步改项目配置#

一旦正式域名确定了，记得把项目里的站点地址也改掉。

配置位置：

1
src/config/siteConfig.ts

重点改这个字段：

1
site_url: "https://你的正式域名"

例如：

1
site_url: "https://www.moclab.top"

这样会影响：

sitemap
RSS
部分 SEO 元信息
站点分享链接

改完后重新提交并推送，Vercel 会自动重新部署。

十二、后续更新博客的日常流程#

当站点已经跑通以后，后面的更新其实就很简单了。

平时你大概只需要做下面这些事：

本地改文章或配置
本地运行 pnpm dev
本地检查无误后执行 pnpm build
提交到你自己的 GitHub
Vercel 自动触发重新部署

也就是说，后面真正的更新链路通常是：

1
本地修改 -> git commit -> git push -> Vercel 自动部署

十三、最容易遇到的坑#

1. Node 或 pnpm 版本太旧#

这是最常见的问题之一。

现象通常包括：

依赖装不上
构建报错
某些包语法不兼容

处理方式通常就是：

更新 Node
更新 npm
更新 pnpm

Windows 新手最常见报错排查#

如果你是在 Windows 上第一次跑这个项目，下面这些问题最常见。

1. `node`、`npm` 或 `pnpm` 命令找不到#

现象通常是：

1
'node' 不是内部或外部命令
2
'pnpm' 不是内部或外部命令

这一般说明：

Node.js 还没安装
安装了但没有正确加入系统环境变量
终端还没有重新打开

建议处理顺序：

重新安装最新的 Node.js LTS
安装完后关闭当前终端，再重新打开
重新执行 node -v、npm -v
如果 pnpm 还没有，再执行 npm install -g pnpm

2. 安装依赖时卡住或报网络错误#

现象可能包括：

pnpm install 很慢
下载某些包失败
registry 连接异常

这类问题很多时候不是项目本身坏了，而是网络或镜像源问题。可以先检查你的网络环境，再重新执行：

Terminal window

1
pnpm install

如果你之前切过奇怪的镜像源，也建议顺手检查一下 npm 和 pnpm 的 registry 配置。

3. 执行脚本时报 PowerShell 权限或策略问题#

有些 Windows 环境里，PowerShell 可能会对脚本执行更敏感。

如果你遇到的不是代码报错，而是系统层面的执行限制，最稳妥的方式通常是：

改用普通终端重新执行
或者用管理员身份重新打开终端
或者优先用 cmd / Windows Terminal 测试是不是 PowerShell 环境问题

不要一上来就怀疑项目代码有问题，先把终端环境和权限分开排查。

4. `pnpm install` 后仍然跑不起来#

这时建议按下面顺序排查：

先确认 Node 版本是不是过旧
再确认 pnpm -v 是否正常
删除失败后残留的依赖缓存再重新安装
重新执行 pnpm build

如果换了新版 Node 和新版 pnpm 之后还是不行，通常再看具体报错信息定位会更有效。

5. 本地能打开，但样式或图片不对#

这类问题通常优先检查：

图片路径是否真实存在
配置里的路径是不是写错
是否改动了 src/config/ 下的关键文件
是否有文章 frontmatter 写错导致页面结构异常

建议优先用：

Terminal window

1
pnpm build

去检查最终构建结果，因为很多内容层问题会在构建阶段直接暴露出来。

2. 本地能跑，Vercel 构建失败#

常见原因：

有资源路径写错
配置文件改坏
frontmatter 格式不合法
某些图片路径不存在
环境和本地依赖缓存不一致

所以每次上线前，最好先本地跑：

Terminal window

1
pnpm build

3. 域名加上后打不开#

常见原因：

Cloudflare 的 Nameserver 还没完全生效
DNS 记录没有按 Vercel 要求填写
根域名和 www 只配了一部分
HTTPS 证书还在签发中

这类问题通常不是代码问题，而是域名解析和 DNS 配置问题。

Cloudflare 和 Vercel 的 DNS 示例#

这一段不写死某一个固定值，因为 Vercel 后台给出的目标值才是最终标准，但可以先理解常见配置长什么样。

例子 1：根域名 `example.com`#

在 Vercel 里添加：

1
example.com

然后 Vercel 可能会提示你在 Cloudflare 里添加根域名解析记录。常见形式类似：

1
Type: A
2
Name: @
3
Value: 76.76.21.21

或者 Vercel 也可能根据你的项目类型给出别的建议。这里最重要的原则是：

以 Vercel 后台提示为准
不要死记某一个旧教程里的固定 IP

例子 2：`www.example.com`#

在 Vercel 里再添加：

1
www.example.com

Cloudflare 里常见会配置成：

1
Type: CNAME
2
Name: www
3
Value: cname.vercel-dns.com

同样，这里的目标值也应以 Vercel 后台当时给你的内容为准。

例子 3：主域名跳转到 `www`#

有些人喜欢统一把：

1
example.com

跳到：

1
www.example.com

也有人反过来统一到裸域名。这个没有绝对标准，但建议你只保留一个主入口，避免：

搜索引擎收录分散
分享链接不统一
自己后续维护混乱

通常可以在 Vercel 的域名设置里指定首选域名。

在 Cloudflare 后台里你通常会看到什么#

一个比较常见的 DNS 结果可能长这样：

1
A      @      76.76.21.21
2
CNAME  www    cname.vercel-dns.com

有时你还会看到：

1
TXT
2
CAA
3
MX

这些不一定都和博客本身直接相关，不要看到记录多就慌。对博客站点来说，最关键的是先把：

根域名
www

这两个访问入口跑通。

Cloudflare 代理要不要开#

Cloudflare 里每条记录旁边一般会有代理开关。

前期建议是：

先按 Vercel 的要求把解析配正确
先确认站点可以正常打开
再决定是否开启代理、缓存和其他规则

如果一开始就同时改很多开关，后面出问题时不容易判断是：

Vercel 绑定问题
Cloudflare DNS 问题
Cloudflare 代理问题

一个更稳的实际顺序#

如果你第一次做这套流程，我建议 DNS 相关就按这个节奏来：

在 Vercel 里先添加域名
看 Vercel 明确要求你填什么记录
去 Cloudflare 一条一条照着填
等解析生效
确认 example.com 和 www.example.com 都能访问
再决定哪个作为主域名
最后回项目里同步修改 site_url

4. 改了配置但线上没更新#

先检查：

代码是不是已经 push 到自己的 GitHub
Vercel 是否触发了新的 deploy
改的是不是正确的配置文件

十四、我自己建议的实际顺序#

如果从零开始，我会建议按下面顺序做：

克隆模板仓库 https://github.com/Zhong0118/moclabdemo.git
安装新的 Node.js
安装或更新 pnpm
执行 pnpm install
执行 pnpm dev 和 pnpm build
把站点标题、个人信息、头像、文章、友链、赞赏先改成自己的
创建自己的 GitHub 仓库并 push
在 Vercel 导入仓库并完成第一次部署
买域名
把域名接到 Cloudflare
在 Vercel 绑定域名
在 Cloudflare 按 Vercel 提示配置 DNS
回项目里把 site_url 改成正式域名
再次 push，等待 Vercel 自动重建

十五、最后的理解#

这套博客真正的核心并不是“如何点一下部署按钮”，而是把下面这条链路稳定下来：

1
模板代码
2
-> 本地可运行
3
-> 内容和配置改成自己的
4
-> 托管到自己的 GitHub
5
-> Vercel 自动部署
6
-> Cloudflare 管理 DNS
7
-> 绑定自己的正式域名

只要这条链路打通，后面维护博客其实就会轻松很多。

对我来说，部署不是项目的终点，而是开始稳定写作和持续迭代的起点。

为什么我要搭建 MocLab

Fri, 01 May 2026 00:00:00 GMT

MocLab 对我来说，不只是一个博客模板的改造项目，而是一个长期的研究与工程记录空间。

为什么需要它#

在做研究和工程实验时，很多真正重要的东西并不只存在于论文结论里，而是存在于过程里：

为什么这个问题值得做
我如何拆解一个方向
我尝试过哪些方案
哪些实现细节会影响最终结果

如果这些内容没有被系统地记录下来，过一段时间就会丢失。

这个站点会承载什么#

MocLab 主要用于沉淀以下几类内容：

AI Agent 与系统安全相关笔记
AIGC 检测与模型归因实验记录
RAG、记忆系统和评测相关工程实践
论文阅读、项目复盘与部署记录

我希望它保持什么风格#

我不想把它做成一个过度装饰的展示页，而更希望它具备下面几个特征：

清楚
克制
可维护
适合长期写作

Academic 页面负责正式展示，博客部分负责持续积累，这也是这次改造的核心思路。

AIGC 检测与模型溯源项目记录

Fri, 01 May 2026 00:00:00 GMT

AIGC 检测与模型溯源的难点并不只是分类精度，更在于开放环境下的稳定性和泛化能力。

我正在关注的方法线#

当前比较关注的信号包括：

Neural Classifier
Perplexity-based Features
Stylometric Signals
Open-set Rejection

这些方法各有优点，但单独使用时也各自存在局限。

工程实现里常见的问题#

在真正搭实验平台时，我最常碰到的问题反而不是模型本身，而是：

数据来源和标注标准不一致
不同模型家族风格差异带来的偏移
推理速度与特征提取成本之间的权衡
开集样本和分布外样本的处理方式

接下来会继续记录什么#

这个方向后续会继续记录：

数据组织与实验协议
特征工程与模型选择
归因任务和检测任务的拆分
面向真实场景的失败案例

我希望最终把它沉淀成一个既能做研究、也能支撑工程实验的平台。

五月一号日记

Fri, 01 May 2026 00:00:00 GMT

测测测测测恶恶是时候hi阿萨撒谎Iasi不显示

AI Agent 学习路线与研究笔记

Thu, 30 Apr 2026 00:00:00 GMT

AI Agent 相关工作非常容易被“产品形态”带着走，但如果从研究角度看，还是需要先把问题空间拆清楚。

我目前的学习路线#

我把学习内容大致分成四层：

Agent 基础能力：规划、工具调用、反思、工作流编排
记忆系统：短期上下文、长期记忆、检索更新与遗忘
运行边界：权限、工具沙箱、状态一致性、失败恢复
安全与评测：Prompt Injection、工具滥用、记忆污染、系统级评测

当前最关心的问题#

几个我认为值得持续跟踪的问题：

长上下文和长期记忆如何影响安全边界
工具调用链中哪些位置最容易形成提权
多 Agent 协作时，错误和风险如何传播
如何设计更贴近真实运行环境的 Agent Evaluation

记录方式#

后续我会把这一方向拆成更细的专题，包括：

Agent Memory 风险
Prompt Injection 与防护
Tool Use Security
Runtime Safeguards

MocLab 的意义之一，就是把这些零散的笔记逐步变成结构化的研究材料。

YYCircle空间

文档名

喀什觉得凯撒觉得啥#

MocLab 博客系统维护说明

1. 博客内容放在哪里#

2. 文章的基本格式#

3. 发博客的原理#

4. 标签和分类的逻辑#

标签怎么写#

分类怎么写#

5. 文章 URL 的规则#

6. 头像和个人信息在哪里改#

7. 网站标题、导航和基础站点信息在哪里改#

8. 壁纸、横幅和主题色在哪里改#

主题色相#

壁纸和横幅#

壁纸图片放哪里#

9. 明暗模式和文章布局在哪里改#

10. 公告在哪里改#

11. 友链在哪里改#

页面级配置#

友链列表数据#

12. 赞赏在哪里改#

13. About 页面在哪里改#

14. 常改文件速查表#

发文章#

改文章字段规则#

快速新建文章脚本#

改个人信息#

改头像映射#

改网站基础配置#

改壁纸和横幅#

改公告#

改友链#

改赞赏#

改导航#

改关于页#

15. 本地预览和构建#

16. 最简单的日常维护流程#

Astro + Vercel 博客部署记录

一、先拿到模板代码#

二、本地环境准备#

三、安装依赖并本地运行#

四、把模板改成你自己的博客#

1. 改个人信息#

2. 改网站基础配置#

3. 改头像和个人卡片#

4. 改博客文章#

5. 改 About、友链、赞赏、公告#

五、把这个项目放到你自己的 GitHub#

方案一：新建自己的空仓库，然后绑定远程#

方案二：直接在 GitHub 上导入模板后再拉本地#

六、什么时候适合开始接 Vercel#

七、用 Vercel 部署博客#

1. 登录 Vercel#

2. 导入你的 GitHub 仓库#

3. 检查构建配置#

4. 开始部署#

八、买自己的域名#

九、把域名接到 Cloudflare#

1. 注册并登录 Cloudflare#

2. 把域名添加到 Cloudflare#

3. 修改域名注册商的 Nameserver#

十、把域名绑定到 Vercel#

1. 在 Vercel 项目里添加 Domain#

2. 按照 Vercel 提示配置 DNS#

根域名#

www 子域名#

3. 在 Cloudflare 里添加 DNS 记录#

十一、域名生效后要同步改项目配置#

十二、后续更新博客的日常流程#

十三、最容易遇到的坑#

1. Node 或 pnpm 版本太旧#

Windows 新手最常见报错排查#

1. node、npm 或 pnpm 命令找不到#

2. 安装依赖时卡住或报网络错误#

3. 执行脚本时报 PowerShell 权限或策略问题#

4. pnpm install 后仍然跑不起来#

5. 本地能打开，但样式或图片不对#

2. 本地能跑，Vercel 构建失败#

`www` 子域名#

1. `node`、`npm` 或 `pnpm` 命令找不到#

4. `pnpm install` 后仍然跑不起来#

例子 1：根域名 `example.com`#

例子 2：`www.example.com`#

例子 3：主域名跳转到 `www`#