QUICK REFERENCE CARD.md

# 快速参考卡片 (Quick Reference Card)

**用途**: 博客生成日常操作速查表
**适用**: 已熟悉完整SOP的用户

---

## 🚀 一键检查命令

```bash
# 检查CTA组件 (必须都=1)
FILE="content/blog/tutorials/xxx.mdx"
echo "HeroMini: $(grep -c '<HeroMini' $FILE)" && \
echo "HeroFull: $(grep -c '<HeroFull' $FILE)"

# 检查HeroFull的3个CTA
grep -A 25 "<HeroFull" $FILE | grep -c "CTA="  # 必须>=3

# 构建测试
pnpm build

# 检查图片存在
IMAGE=$(grep "^image:" $FILE | cut -d'"' -f2)
ls -la "public$IMAGE"
```

---

## 📝 Frontmatter模板

```yaml
---
title: '[关键词] Complete Guide: [副标题] (2026)'
description: 'Learn [技能] with [工具]. Step-by-step guide for [目标用户] - free tutorial with examples.'
date: '2026-01-24'
author: 'Team Name'
image: '/images/blog/tutorials/[slug]-featured.jpg'
categories: ['tutorials']
tags: ['keyword1', 'keyword2', 'keyword3']
published: true
---
```

---

## 🎯 CTA组件模板

### HeroMini (开头)

```jsx
<HeroMini
  title="[10-15词标题]"
  subtitle="[15-20词副标题]"
  primaryCTA="Start Now"
  primaryLink="#section"
  secondaryCTA="View Tutorials"
  secondaryLink="/blog?category=tutorials"
/>
```

### HeroFull (结尾)

```jsx
<HeroFull
  title="Ready to [行动]?"
  subtitle="Join [数字]+ users"
  features={[
    { icon: '🚀', title: 'Quick Setup', description: '描述1' },
    { icon: '⚡', title: 'Fast', description: '描述2' },
    { icon: '💰', title: 'Free', description: '描述3' },
    { icon: '🎯', title: 'Accurate', description: '描述4' },
    { icon: '📖', title: 'Documented', description: '描述5' },
    { icon: '🤝', title: 'Support', description: '描述6' },
  ]}
  stats={{ users: '10,000+', videos: '500K+', rating: '4.9/5' }}
  primaryCTA="🎯 Start Now"
  primaryLink="/"
  secondaryCTA="📚 Tutorials"
  secondaryLink="/blog?category=tutorials"
  tertiaryCTA="💬 Support"
  tertiaryLink="/support"
/>
```

---

## 📊 文章结构速查

```
1. Frontmatter
2. <HeroMini />
3. ## TL;DR (5-8点)
4. ## 🔑 Key Takeaways (5-10点)
5. ## [H2 章节1-6]
6. ## ❓ FAQ (5-10问题)
7. <HeroFull />
8. ## 🔗 Related Resources
```

---

## 🎨 图片Prompt模板

```
[主体描述], [风格描述]. [颜色方案] with [光线效果].
[构图说明]. [技术细节].
Style: [风格], 4K quality, 16:9 aspect ratio, sharp details.

Negative: text, labels, watermark, logo, low quality, blurry,
people, faces, hands, UI elements
```

**颜色选择**:

- 教程 → 蓝色/青色
- 分析 → 紫色
- 优化 → 绿色
- 新功能 → 橙色

---

## 📤 发布命令

```bash
# 添加文件
git add content/blog/tutorials/xxx.mdx public/images/blog/tutorials/xxx-featured.jpg

# 提交
git commit -m "feat: add Blog #XX - [标题] (X,XXX words)

Co-Authored-By: Claude <[email protected]>"

# 推送
git push origin main

# 验证上线
curl -I https://site.com/blog/tutorials/xxx-2026 | head -1
```

---

## ✅ 发布前检查清单

- [ ] HeroMini存在 (1个)
- [ ] HeroFull存在 (1个) + 3个CTA
- [ ] 字数 ≥ 2000
- [ ] FAQ ≥ 5个问题
- [ ] 图片文件存在
- [ ] `pnpm build` 通过
- [ ] 无404链接

---

## 🔗 重要文档链接

| 文档                                   | 用途     |
| -------------------------------------- | -------- |
| `MASTER-SOP-VIDEO-TO-BLOG-WORKFLOW.md` | 完整流程 |
| `seoskill.md`                          | SEO规范  |
| `CHECKLIST.md`                         | 质量清单 |
| `AI-IMAGE-GENERATION-GUIDE.md`         | 图片生成 |
| `GSC-URL-SUBMISSION.md`                | 索引提交 |

---

## ⚠️ 常见错误速修

| 错误               | 原因     | 修复          |
| ------------------ | -------- | ------------- |
| YAML duplicate key | 重复字段 | 删除重复行    |
| Build failed       | MDX语法  | 检查JSX标签   |
| Image not found    | 路径错误 | 检查image字段 |
| 404 links          | 假链接   | 替换为真实URL |

---

**版本**: v1.0 | **更新**: 2026-01-24

本文档为站内渲染。原始文件本地路径：saas/source/seo-llm/raw-seo知识库-TXT整理-seo方法论-seo-knowledge-base-Guideline-QUICK-R-502d85.txt（仅本地保留，不入库不部署）