john
4e21ca937a
Deploy Documentation / deploy (push) Has been cancelled
Canary / Prepare Version (push) Has been cancelled
Canary / build-cli (push) Has been cancelled
Canary / Upload Install Script (push) Has been cancelled
Canary / bundle-desktop (push) Has been cancelled
Canary / bundle-desktop-intel (push) Has been cancelled
Canary / bundle-desktop-linux (push) Has been cancelled
Canary / bundle-desktop-windows (push) Has been cancelled
Canary / bundle-desktop-windows-cuda (push) Has been cancelled
Canary / Release (push) Has been cancelled
Unused Dependencies / machete (push) Has been cancelled
CI / changes (push) Has been cancelled
CI / Check Rust Code Format (push) Has been cancelled
CI / Build and Test Rust Project (push) Has been cancelled
CI / Build Rust Project on Windows (push) Has been cancelled
CI / Check MSRV (push) Has been cancelled
CI / Lint Rust Code (push) Has been cancelled
CI / Check Generated Schemas are Up-to-Date (push) Has been cancelled
CI / Test and Lint Electron Desktop App (push) Has been cancelled
CI / H5 Plaza Tests and Build (push) Has been cancelled
Live Provider Tests / check-fork (push) Has been cancelled
Live Provider Tests / changes (push) Has been cancelled
Live Provider Tests / Build Binary (push) Has been cancelled
Live Provider Tests / Smoke Tests (push) Has been cancelled
Live Provider Tests / Smoke Tests (Code Execution) (push) Has been cancelled
Live Provider Tests / Compaction Tests (push) Has been cancelled
Live Provider Tests / goose server HTTP integration tests (push) Has been cancelled
Publish Ask AI Bot Docker Image / docker (push) Has been cancelled
Publish Docker Image / docker (push) Has been cancelled
Scorecard supply-chain security / Scorecard analysis (push) Has been cancelled
Fork goose with custom MCP widgets, platform extensions (aider, git, web, search), MindSpace H5 backend/frontend, Plaza/Ops UIs, and deploy scripts for tkmind.cn. Co-authored-by: Cursor <cursoragent@cursor.com>
8.3 KiB
8.3 KiB
sidebar_position, title, sidebar_label, description
| sidebar_position | title | sidebar_label | description |
|---|---|---|---|
| 8 | SEO 策略 | SEO | Plaza 的 SEO 架构、Open Graph 规范、sitemap 生成、静态化策略和爬虫优化 |
SEO 策略
权威文档：本页是 Plaza 所有 HTML meta、Open Graph、JSON-LD、robots 规范的唯一来源；03-frontend 通过
lib/metadata.ts引用此处约定。
核心目标
- 广场每个帖子、每个分类页、每个用户主页都能被搜索引擎完整收录。
- 微信/微博/钉钉等社交平台分享时展示封面图、标题和摘要。
- 新帖发布后 24 小时内可被 Googlebot 和百度蜘蛛发现。
渲染策略
| 页面 | 渲染方式 | 缓存策略 | 说明 |
|---|---|---|---|
| /plaza 首页 | SSR（force-dynamic） |
fetch revalidate 60s + Redis Feed 缓存 |
服务端每次渲染，API 层缓存热门列表 |
| /plaza/cat/:slug 分类 | SSR（force-dynamic） |
fetch revalidate 300s |
分类元数据预生成 generateStaticParams |
| /plaza/p/:id 帖子详情 | SSR（force-dynamic） |
no-store |
互动数实时显示 |
| /u/:slug 用户主页 | SSR | revalidate: 300 |
5 分钟 ISR |
| 404 页面 | 静态 | - | Next.js 默认 |
说明：Plaza 首页/分类页使用 dynamic = 'force-dynamic'，通过 lib/api.ts 的 next.revalidate 控制上游 API 缓存，而非 Next.js 页面级 ISR。用户主页保留 revalidate: 300。加载态使用 loading.tsx + PostGridSkeleton。
HTML meta 规范
帖子详情页（最重要）
// app/plaza/p/[id]/page.tsx
export async function generateMetadata({ params }: { params: { id: string } }): Promise<Metadata> {
const post = await fetchPost(params.id);
if (!post) {
return { title: 'Page Not Found' };
}
const url = `https://go.tkmind.cn/plaza/p/${post.id}`;
const image = post.cover_url || 'https://go.tkmind.cn/og-default.png';
return {
title: `${post.title} - Plaza | MindSpace`,
description: post.summary || `${post.author.display_name} 用 MindSpace 创作的作品`,
keywords: post.tags.join(', '),
// Open Graph（微信、Facebook、钉钉）
openGraph: {
title: post.title,
description: post.summary,
url,
siteName: 'MindSpace Plaza',
images: [
{
url: image,
width: 1200,
height: 630,
alt: post.title,
},
],
type: 'article',
publishedTime: post.published_at,
authors: [`https://go.tkmind.cn/u/${post.author.slug}`],
tags: post.tags,
},
// Twitter Card（X / 微博）
twitter: {
card: 'summary_large_image',
title: post.title,
description: post.summary,
images: [image],
creator: `@${post.author.slug}`,
},
// 规范 URL（防止重复内容）
alternates: {
canonical: url,
},
// 爬虫指令
robots: {
index: true,
follow: true,
},
};
}
用户主页
openGraph: {
type: 'profile',
firstName: user.display_name,
username: user.slug,
images: [{ url: user.avatar_url, width: 400, height: 400 }],
}
广场首页
openGraph: {
type: 'website',
title: 'Plaza - 发现 AI 创作的精彩内容',
description: '浏览来自全球用户用 MindSpace 创作的报告、作品和页面',
images: [{ url: 'https://go.tkmind.cn/plaza-og.png', width: 1200, height: 630 }],
}
结构化数据（JSON-LD）
帖子详情页在 <head> 中注入 Article Schema：
// app/plaza/p/[id]/page.tsx
export default async function PostPage({ params }) {
const post = await fetchPost(params.id);
const jsonLd = {
'@context': 'https://schema.org',
'@type': 'Article',
headline: post.title,
description: post.summary,
image: post.cover_url,
datePublished: post.published_at,
author: {
'@type': 'Person',
name: post.author.display_name,
url: `https://go.tkmind.cn/u/${post.author.slug}`,
},
publisher: {
'@type': 'Organization',
name: 'MindSpace',
logo: {
'@type': 'ImageObject',
url: 'https://go.tkmind.cn/logo.png',
},
},
};
return (
<>
<script
type="application/ld+json"
dangerouslySetInnerHTML={{ __html: JSON.stringify(jsonLd) }}
/>
{/* 页面内容 */}
</>
);
}
Sitemap 生成
Next.js 动态生成 sitemap，百度蜘蛛和 Googlebot 可以发现所有公开内容。
// app/sitemap.ts
export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
const baseUrl = 'https://go.tkmind.cn';
// 静态页面
const staticPages = [
{ url: `${baseUrl}/plaza`, lastModified: new Date(), changeFrequency: 'hourly', priority: 1.0 },
];
// 分类页
const categories = await fetchCategories();
const categoryPages = categories.map((cat) => ({
url: `${baseUrl}/plaza/cat/${cat.slug}`,
lastModified: new Date(),
changeFrequency: 'hourly' as const,
priority: 0.8,
}));
// 帖子详情页（最近 1000 条已发布帖子）
const posts = await fetchRecentPosts(1000);
const postPages = posts.map((post) => ({
url: `${baseUrl}/plaza/p/${post.id}`,
lastModified: new Date(post.updated_at),
changeFrequency: 'weekly' as const,
priority: 0.6,
}));
// 用户主页（有发布内容的用户）
const users = await fetchActiveCreators(500);
const userPages = users.map((user) => ({
url: `${baseUrl}/u/${user.slug}`,
lastModified: new Date(user.last_post_at),
changeFrequency: 'weekly' as const,
priority: 0.5,
}));
return [...staticPages, ...categoryPages, ...postPages, ...userPages];
}
Sitemap URL：https://go.tkmind.cn/sitemap.xml，在 robots.txt 中声明。
robots.txt
// app/robots.ts
export default function robots(): MetadataRoute.Robots {
return {
rules: [
{
userAgent: '*',
allow: ['/plaza', '/u/'],
disallow: ['/ops', '/api', '/_next'],
},
],
sitemap: 'https://go.tkmind.cn/sitemap.xml',
};
}
OG 封面图生成
帖子必须有封面图才能在社交平台获得好的分享展示效果。
策略（优先级从高到低）
- 创作者手动上传封面：发布到广场时可以选择或上传封面图。
- publication 的封面：MindSpace 发布时生成的页面封面。
- 自动生成 OG 图：用
@vercel/og或 Next.js Image Response API 动态生成。
动态 OG 图生成（兜底）
// app/plaza/p/[id]/opengraph-image.tsx
import { ImageResponse } from 'next/og';
export default async function Image({ params }: { params: { id: string } }) {
const post = await fetchPost(params.id);
return new ImageResponse(
(
<div
style={{
width: '1200px',
height: '630px',
background: 'linear-gradient(135deg, #667eea 0%, #764ba2 100%)',
display: 'flex',
flexDirection: 'column',
justifyContent: 'center',
padding: '60px',
}}
>
<div style={{ color: 'white', fontSize: '48px', fontWeight: 'bold', marginBottom: '20px' }}>
{post.title}
</div>
<div style={{ color: 'rgba(255,255,255,0.8)', fontSize: '24px' }}>
{post.author.display_name} · MindSpace Plaza
</div>
</div>
),
{ width: 1200, height: 630 },
);
}
页面加载性能与 SEO
Google Core Web Vitals 是搜索排名因素，以下措施保证达标：
| 措施 | 目标 |
|---|---|
| 首屏 SSR 直出 HTML | LCP < 2.5s |
图片使用 next/image 自动 WebP + lazy |
CLS < 0.1 |
字体使用 next/font 避免布局偏移 |
CLS < 0.1 |
| 帖子列表图片预加载第一屏 | LCP < 2.5s |
| PostCard 骨架屏占位 | CLS < 0.1 |
百度 SEO 特别注意
- 百度蜘蛛对 JavaScript 渲染支持差，必须服务端渲染，不能依赖客户端 hydration 生成内容。
- 百度不抓取
noindex页面，帖子详情必须确保没有误加noindex。 - 百度对外链有延迟，新帖发布后主动通过百度搜索资源平台 API 推送 URL。
// 新帖发布后，主动推送到百度
async function pingBaidu(url: string) {
await fetch('http://data.zz.baidu.com/urls?site=go.tkmind.cn&token=YOUR_TOKEN', {
method: 'POST',
headers: { 'Content-Type': 'text/plain' },
body: url,
});
}