🚀 双构建部署快速开始

一分钟快速开始

1️⃣ 验证配置

node scripts/verify-dual-build.js

2️⃣ 本地开发

# 开发中文站
npm run dev:cn

# 开发英文站（另开一个终端）
npm run dev:en

3️⃣ 构建站点

# 构建所有站点
npm run build:all

# 或者分别构建
npm run build:cn  # 输出到 dist-cn/
npm run build:en  # 输出到 dist-en/

4️⃣ 本地预览

# 预览中文站
npm run preview:cn
# 访问 http://localhost:4173

# 预览英文站
npm run preview:en
# 访问 http://localhost:4174

---

📦 可用命令

命令	说明
npm run dev:cn	开发中文站
npm run dev:en	开发英文站
npm run build:cn	构建中文站 → dist-cn/
npm run build:en	构建英文站 → dist-en/
npm run build:all	构建所有站点
npm run preview:cn	预览中文站（端口 4173）
npm run preview:en	预览英文站（端口 4174）

---

🎯 核心文件

文件	说明
.vitepress/config-cn.ts	中文站配置
.vitepress/config-en.ts	英文站配置
.vitepress/config/shared.ts	共享配置
public/scripts/crossDomainMapping.js	跨域语言切换配置

---

📂 内容结构

项目根目录
├── index.md              # 中文首页
├── docs/                 # 中文文档
├── blog/                 # 中文博客
└── en/                   # 英文内容
    ├── index.md          # 英文首页
    ├── docs/             # 英文文档
    └── blog/             # 英文博客

---

✨ 构建产物

中文站 (dist-cn/)

dist-cn/
├── index.html            # ls-ai.cn/
├── docs/
│   └── installation.html # ls-ai.cn/docs/installation
├── blog/
└── assets/

英文站 (dist-en/)

dist-en/
├── index.html            # flareseek.com/
├── docs/
│   └── installation.html # flareseek.com/docs/installation
├── blog/
└── assets/

重点: 两个站点的 URL 结构完全相同！

---

🌐 URL 映射关系

源文件	中文站 URL	英文站 URL
/index.md	ls-ai.cn/	-
/en/index.md	-	flareseek.com/
/docs/installation.md	ls-ai.cn/docs/installation	-
/en/docs/installation.md	-	flareseek.com/docs/installation

语言切换: 点击切换器时，路径保持不变，只切换域名

• 从 ls-ai.cn/docs/installation
• 到 flareseek.com/docs/installation

---

🔧 常见操作

添加新页面

1. 中文页面

   创建: docs/new-page.md
   URL: ls-ai.cn/docs/new-page

2. 英文页面（对应中文页面）

   创建: en/docs/new-page.md
   URL: flareseek.com/docs/new-page

注意: 文件路径必须完全对应！

修改导航菜单

• 中文导航: 编辑 .vitepress/config-cn.ts 的 nav 配置
• 英文导航: 编辑 .vitepress/config-en.ts 的 nav 配置

修改SEO配置

• 中文SEO: .vitepress/config-cn.ts 的 head 部分
• 英文SEO: .vitepress/config-en.ts 的 head 部分

---

🚨 注意事项

⚠️ 静态资源共享

/public/ 目录会被两个站点共享，如果需要：

方案1: 将 /public/ 复制到 /en/public/

cp -r public en/

方案2: 使用软链接（推荐，Linux/Mac）

cd en
ln -s ../public public

⚠️ 路径一致性

确保中英文文件路径完全对应：

✅ 正确
/docs/installation.md
/en/docs/installation.md

❌ 错误
/docs/installation.md
/en/docs/install.md      # 文件名不一致

⚠️ 构建顺序

如果使用 scripts/copy-cover-images.js，确保：

npm run build:cn  # 先构建中文站（会复制图片）
npm run build:en  # 再构建英文站

---

📚 详细文档

查看完整文档: DUAL_BUILD_DEPLOYMENT.md

包含：

• 详细配置说明
• Nginx 配置示例
• SEO 优化指南
• 部署流程
• 常见问题解答

---

✅ 验证清单

部署前检查：

• [ ] 运行 node scripts/verify-dual-build.js 通过
• [ ] 本地预览中文站正常
• [ ] 本地预览英文站正常
• [ ] 语言切换功能测试通过
• [ ] 所有页面路径一一对应
• [ ] 静态资源加载正常

---

需要帮助？ 查看 DUAL_BUILD_DEPLOYMENT.md 的常见问题部分