# 双语支持

Claude Code SEO Assistant 原生支持中文和英文两种语言，提供差异化的 SEO 优化建议。

---

## 🌏 支持的语言

### 🇨🇳 简体中文（zh-CN）
- **主要搜索引擎：** 百度、搜狗、Google
- **字符集：** UTF-8
- **标点符号：** 中文标点

### 🇺🇸 英语（en-US）
- **主要搜索引擎：** Google、Bing
- **字符集：** UTF-8
- **标点符号：** 英文标点

---

## 🔍 自动语言检测

工具会自动检测内容语言，使用以下方法：

### 1. 中文字符比例分析

```javascript
// 检测逻辑
const chineseCharRatio = (chineseChars / totalChars) * 100;

if (chineseCharRatio > 30%) {
  language = 'zh-CN';
} else {
  language = 'en-US';
}
```

### 2. HTML lang 属性

```html
<html lang="zh-CN">  <!-- 中文 -->
<html lang="en">     <!-- 英文 -->
```

### 3. URL 结构识别

```
/zh/about/    → 中文
/en/about/    → 英文
/about/       → 自动检测
```

---

## 📊 差异化建议

### Title 标题

| 语言 | 建议长度 | 关键词位置 | 示例 |
|------|---------|-----------|------|
| **中文** | 20-30 字符 | 靠前 | "Claude Code SEO - Next.js SEO 优化助手" |
| **英文** | 50-60 字符 | 靠前 | "Claude Code SEO - Next.js SEO Optimization Assistant" |

**中文示例：**
```typescript
{
  title: 'Claude Code SEO - Next.js SEO 优化助手 \u6559\u7A0B'  // 28 字符 ✅
}
```

**英文示例：**
```typescript
{
  title: 'Claude Code SEO - Complete Next.js SEO Optimization Guide for 2025'  // 68 字符 ⚠️ 过长
}
```

---

### Description 描述

| 语言 | 建议长度 | 内容重点 | 示例 |
|------|---------|---------|------|
| **中文** | 70-80 字符 | 核心价值 + 行动号召 | "强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持。立即提升搜索排名！" |
| **英文** | 150-160 字符 | 核心价值 + 行动号召 | "Powerful Claude Code SEO plugin providing comprehensive SEO optimization for Next.js projects. Boost your search rankings today!" |

**中文示例：**
```typescript
{
  description: '强大的 Claude Code SEO 插件，为 Next.js 项目提供全面的 SEO 优化支持。自动审计、元数据生成、结构化数据。立即提升排名！'  // 75 字符 ✅
}
```

**英文示例：**
```typescript
{
  description: 'Powerful Claude Code SEO plugin providing comprehensive SEO optimization for Next.js projects. Features include automated audits, metadata generation, and structured data. Boost your rankings now!'  // 185 字符 ⚠️ 过长
}
```

---

### 关键词密度

| 语言 | 建议密度 | 计算方式 | 注意事项 |
|------|---------|---------|---------|
| **中文** | 2-4% | (关键词字数 / 总字数) × 100 | 不要过度堆砌 |
| **英文** | 1-2% | (关键词出现次数 / 总词数) × 100 | 自然融入为主 |

**中文示例：**
```markdown
# SEO 优化（关键词出现 6 次）
SEO 优化是提升网站排名的关键。通过 SEO 优化技术，
可以改善网站在搜索引擎中的表现。SEO 优化包括...
```

**英文示例：**
```markdown
# SEO Optimization (keyword appears 4 times)
SEO optimization is key to improving website rankings.
Through SEO optimization techniques, you can enhance...
```

---

### 标题结构（H1-H6）

| 语言 | 建议层级 | 标题特点 |
|------|---------|---------|
| **中文** | H1-H4 | 通常不需要太深的层级 |
| **英文** | H1-H6 | 可以使用更深的层级 |

**中文结构：**
```markdown
# SEO 优化指南           ← H1
## 什么是 SEO            ← H2
### SEO 的重要性         ← H3
#### 如何实施 SEO        ← H4（通常到此为止）
```

**英文结构：**
```markdown
# SEO Optimization Guide    ← H1
## What is SEO              ← H2
### Importance of SEO       ← H3
#### How to Implement       ← H4
##### Step 1: Audit         ← H5
###### Tools to Use         ← H6（可以使用更深层级）
```

---

### 搜索引擎差异

| 搜索引擎 | 主要语言 | 特殊要求 | 优化重点 |
|---------|---------|---------|---------|
| **百度** | 中文 | 需要备案 | 国内访问速度、中文内容质量 |
| **搜狗** | 中文 | 微信生态 | 社交信号 |
| **Google** | 通用 | 无特殊要求 | 内容质量、用户体验 |
| **Bing** | 英文 | 无特殊要求 | 社交媒体、域名年龄 |

---

## 🛠️ 多语言网站优化

### hreflang 标签

为多语言网站设置正确的 hreflang：

```typescript
// app/layout.tsx
export const metadata = {
  alternates: {
    canonical: 'https://example.com',
    languages: {
      'zh-CN': 'https://example.com/zh',
      'en': 'https://example.com/en',
    },
  },
}
```

### URL 结构建议

```
# 推荐：子目录
/zh/about/
/en/about/

# 或：子域名
zh.example.com/about/
en.example.com/about/

# 避免：URL 参数
/about?lang=zh  ← 不推荐
```

---

## 📝 内容优化差异

### 中文内容特点

**优点：**
- ✅ 关键词密度更容易控制
- ✅ 标题长度更灵活
- ✅ 搜索竞争相对较小

**注意：**
- ⚠️ 避免关键词堆砌
- ⚠️ 注意同义词使用
- ⚠️ 关注百度移动优先索引

**示例：**
```markdown
# 优化建议
- 使用"搜索引擎优化"和"SEO"交替出现
- 标题控制在 30 字符以内
- Description 突出核心价值
```

### 英文内容特点

**优点：**
- ✅ 更多的 SEO 工具支持
- ✅ Google 算法更成熟
- ✅ 国际受众更广

**注意：**
- ⚠️ 关键词竞争激烈
- ⚠️ 注意拼写和语法
- ⚠️ 关注搜索意图（Search Intent）

**示例：**
```markdown
# Optimization Tips
- Mix "search engine optimization" and "SEO"
- Keep titles under 60 characters
- Focus on search intent (informational, navigational, transactional)
```

---

## 🔧 实用命令

### 检测语言

```bash
# 自动检测当前项目语言
/seo-check

# 输出会显示检测到的语言
✅ 检测到中文内容 (zh-CN)
```

### 语言特定优化

```bash
# 中文内容优化
/seo-audit  # 自动使用中文 SEO 标准

# 英文内容优化
/seo-audit  # 自动使用英文 SEO 标准
```

---

## 💡 最佳实践

### 1. 保持语言一致性

```typescript
// ❌ 混合语言
{
  title: 'SEO 优化 Guide - Best Practices'  // 不推荐
}

// ✅ 纯粹语言
{
  title: 'SEO 优化指南 - 最佳实践',  // 推荐
}
```

### 2. 使用正确的字符编码

```html
<head>
  <meta charset="UTF-8">
  <meta http-equiv="Content-Language" content="zh-CN">
</head>
```

### 3. 针对不同搜索引擎优化

**针对百度：**
```typescript
{
  // 百度更看重
  title: '简洁明确的标题',
  description: '详细描述',
  keywords: ['关键词1', '关键词2'],  // 百度仍关注 keywords
}
```

**针对 Google：**
```typescript
{
  // Google 更看重
  title: '包含关键词的自然标题',
  description: '用户友好的描述',
  // Google 忽略 keywords 标签
}
```

---

## 📚 相关资源

### 中文 SEO 资源

- [百度搜索资源平台](https://ziyuan.baidu.com/)
- [百度搜索优化指南](https://ziyuan.baidu.com/college/courseinfo?id=268)
- [搜狗站长平台](http://zhanzhang.sogou.com/)

### 英文 SEO 资源

- [Google Search Central](https://developers.google.com/search)
- [Bing Webmaster Guidelines](https://www.bing.com/webmasters/help/webmaster-guidelines)
- [Moz SEO Guide](https://moz.com/beginners-guide-to-seo)

---

## 🎯 快速参考

| 维度 | 中文 SEO | 英文 SEO |
|------|---------|---------|
| **Title 长度** | 20-30 字符 | 50-60 字符 |
| **Description 长度** | 70-80 字符 | 150-160 字符 |
| **关键词密度** | 2-4% | 1-2% |
| **标题层级** | H1-H4 | H1-H6 |
| **主要搜索引擎** | 百度、搜狗、Google | Google、Bing |
| **特殊要求** | 百度备案 | 无 |

---

**相关文档：**
- [功能特性](features.md) - 所有功能介绍
- [评分系统](scoring-system.md) - 评分标准详解
- [命令参考](commands.md) - 命令使用说明

---

**需要帮助？** 访问 [GitHub Issues](https://github.com/huifer/claude-code-seo/issues)
