Documentation
IntroductionThe 5-Step WorkflowThe Raw HTML StrategyJSON Drop-in SystemDynamic SitemapWhy Cryptomus?Anti-Spam LogicCommon Errors

pSEO Wizard 手册 🧙‍♂️

欢迎来到 pSEO Wizard 完整技术指南。本文档将数周的架构决策浓缩成单一工作流程，帮助您安全地发布1000+页面。

💡 Quick Tip: 使用侧边栏导航在章节间跳转，或滚动浏览完整指南。

🚀 第一部分：核心工作流程

在深入代码之前，了解'工厂'是如何工作的：

1. 项目配置

仔细选择您的目标语言。这将设置JSON输出中的locale标志。

2. 模式逻辑

使用像 {City} 或 {Service} 这样的变量。保持模式简短以获得更好的SEO。

3. 数据生成

我们使用笛卡尔积逻辑。10个服务 × 10个城市 = 100页面。

🛡️ 4. '安全'警告

在步骤4，我们警告您在 /blog 下发布。在根域名发布程序化内容是被Google取消索引的快速方式。

👨‍💻 第二部分：开发者集成

黄金标准

📘 Note: 以下指南为您的 Next.js 应用推荐最佳架构来处理我们的导出文件。

'Raw HTML' 策略

由于 pSEO Wizard 生成完整的样式化HTML页面，将它们包装在标准React布局中会导致样式冲突。

✅ 解决方案：我们使用 Next.js Route Handler 来提供原始HTML。

// src/app/[locale]/blog/[slug]/route.ts
export async function GET(request, { params }) {
  const post = getPostBySlug(params.slug);
  if (post.locale !== params.locale) return 404;
  
  const finalHtml = `<head><script src="https://cdn.tailwindcss.com"></script></head>
    <body>${post.body_html}</body>`;

  return new Response(finalHtml, { headers: { 'Content-Type': 'text/html' } });
}

JSON Drop-in 系统

忘记数据库迁移。我们基于文件系统聚合构建了一个系统。

  • 📁
    目录： src/app/data/posts-json/
  • 🔄
    工作流程：只需将导出的JSON文件'拖放'到这里。
  • ✨
    魔法：blog-posts.ts 聚合器自动读取所有文件并立即发布。

动态'智能' Sitemap

您的 sitemap.ts 支持语言环境。它扫描JSON文件并生成特定语言环境的URL。

这可以防止来自Google的'重复内容'惩罚。

🏛️ 第三部分：技术架构

为什么选择 Cryptomus？

我们基于特定战略原因选择 Cryptomus 而非 Stripe：

🌍 全球覆盖

接受来自任何地方的加密货币支付（解决区域银行限制并实现全球访问）。

⚡ 即时解锁

Webhook系统在交易确认后立即解锁'导出'按钮。

反垃圾邮件架构

我们的系统旨在保护您的域名权威：

  • 所有程序化内容都位于 /blog 子目录下
  • 每个页面都有独特的AI生成内容
  • 内部链接遵循SEO最佳实践
  • 多语言内容的正确 lang 和 dir 属性

🚑 第四部分：故障排除

常见问题及其解决方案：

❌ 白屏 / 无样式文本

原因：Tailwind CDN 被阻止。

解决方案：检查 next.config.js 中的CSP头。

⚠️ 内部链接损坏

原因：AI生成工件。

解决方案：确保您的 route.ts 有 "Smart Regex" 清理器。

🔍 生成帖子404错误

原因：Slug 不匹配。

解决方案：使用 decodeURIComponent(slug)。

✅ CTA按钮跳转到 /blog

原因：Regex 替换所有链接。

解决方案：对主页链接和博客链接使用不同的模式。

由 pSEO Wizard 团队用 ❤️ 制作

最后更新：2024年12月

Documentation | pSEO Wizard