AICDO 站点 · 部署与维护指南

本站为具身智能公众号的官网存档站，基于 VitePress 构建，部署到 Cloudflare Pages（境外托管，无需 ICP 备案）。

本地开发

npm install     # 首次安装依赖
npm run dev     # 本地预览 http://localhost:5173
npm run build   # 构建，产物在 .vitepress/dist

上线步骤（共 4 步，全程约 30 分钟 + DNS 生效时间）

第 1 步：把代码推到 GitHub

1. 在 GitHub 新建一个仓库（如 aicdo-site，私有仓库也可以，Cloudflare Pages 有 GitHub 授权读取）
2. 把本项目推上去：

git init
git add .
git commit -m "init: aicdo site"
git remote add origin https://github.com/<你的用户名>/aicdo-site.git
git push -u origin main

第 2 步：Cloudflare Pages 创建项目

1. 注册/登录 Cloudflare（建议用香港创复集团的邮箱注册，不需要企业认证）
2. 左侧菜单 Workers & Pages → Create → Pages → Connect to Git，选择刚推的仓库
3. 构建配置填：

配置项	值
Framework preset	VitePress
Build command	npm run build
Build output directory	.vitepress/dist
环境变量	NODE_VERSION = 22

4. 点 Save and Deploy，约 2 分钟后得到一个临时域名 xxx.pages.dev（此域名在大陆可能打不开，属正常，下一步绑自有域名后就没问题）

第 3 步：绑定 AICDO.COM

1. Cloudflare Pages 项目 → Custom domains → Set up a custom domain，输入 aicdo.com，再添加一个 www.aicdo.com
2. Cloudflare 会给出需要添加的 DNS 记录（一般是 CNAME 到 xxx.pages.dev）

第 4 步：GoDaddy 修改 DNS（二选一）

方案 A（推荐）：把域名 NS 交给 Cloudflare托管

• Cloudflare 控制台 Add a site 输入 aicdo.com（Free 套餐即可）→ Cloudflare 给你两个 NS 地址
• GoDaddy → 域名管理 → DNS → Nameservers → Change → 选 Custom → 填入 Cloudflare 的两个 NS
• 之后所有解析都在 Cloudflare 里管理，Pages 绑定域名自动完成，免维护

方案 B：保留 GoDaddy DNS，手动加记录

• GoDaddy DNS 管理页添加：
  • 类型 CNAME，名称 www，值 <你的项目>.pages.dev
  • 类型 A，名称 @，值 192.0.2.1（以 Cloudflare Pages 提示为准，或在 Cloudflare 里用 Redirect 规则把根域跳转到 www）

注意：GoDaddy 添加 CNAME 后记得把冲突的默认 A 记录/转发删掉。NS 切换全球生效约 2-24 小时，通常几小时内就能访问 https://aicdo.com 。

之后的日常：如何发布新文章

1. 公众号文章定稿后，整理成 Markdown
2. 放入对应栏目目录：changai/（场景拆解）、shujutan/（数据谈）
3. 更新两个索引页：posts/index.md（存档表格）和对应栏目的 index.md
4. git push，Cloudflare Pages 自动构建，约 1 分钟后线上生效

免备案说明

• Cloudflare Pages 服务器在境外，网站面向海外/微信内访问，不涉及大陆服务器，无需 ICP 备案
• 域名注册在 GoDaddy（境外注册商）同样不影响
• 提醒：微信内打开自定义域名网页目前可正常访问；但站内如涉及小程序跳转等微信能力需另走微信侧认证

目录结构

aicdo-site/
├── .vitepress/
│   ├── config.mts        # 导航、侧边栏、搜索配置
│   └── theme/            # 品牌色与样式
├── changai/              # 《场景拆解》文章
├── shujutan/             # 《数据谈》文章
├── posts/index.md        # 全站文章存档页
├── crowdfund.md          # 《场景众筹》
├── about.md              # 关于页
├── index.md              # 首页
└── public/               # logo、robots.txt 等静态资源

双语预留（暂不启用）

网站当前仅中文（根目录 = zh）。VitePress 的 i18n 是纯增量配置，现有文件无需任何调整。未来开通英文版的触发条件：采访栏目启动 + 后台出现明显海外访问信号。届时三步：

1. 新建 en/ 目录，放英文页（建议先只译首页 + 四个栏目介绍页，文章不强制双语）
2. config.mts 增加 locales 配置：现有 nav/sidebar/themeConfig 移入 root: {...}，新增 en: {...}（VitePress 自带语言切换下拉 localeDropdown）
3. URL 策略固定为：根 = 中文，/en/ = 英文；sitemap 会自动包含双语页面