内链检查工具指南#
为了确保 SEO 效果和用户体验，我们开发了专门的工具来检测 Creation Lab 内容（Prompts, Skills, Workflows）中的内部链接有效性。
这些工具能够检测以下场景：
- 标准 HTML 中的
<a>标签。 - React Server Components (RSC) Payload 中的 JSON 数据链接。
- Markdown 内容中的链接格式
[text](url)。 - Client-side Rendering (CSR) 后生成的链接（Playwright 版）。
🔧 工具概览#
我们在 scripts/creation-lab/ 目录下提供了两个版本的检测工具：
| 工具 | 文件名 | 适用场景 | 依赖 | 优点 |
|---|---|---|---|---|
| Python 版 | check-links.py | 快速、轻量扫描 | Python 3, requests | 速度快，无需安装浏览器 |
| Playwright 版 | check-links-playwright.js | 精准、深度检测 | Node.js, playwright | 100% 模拟用户行为，能检测 JS 渲染内容和控制台错误 |
🐍 1. Python 脚本 (check-links.py)#
这是一个轻量级的爬虫脚本，使用多线程并发检测链接状态。它经过专门优化，可以通过正则表达式识别 Next.js 的 RSC Payload 和 Markdown 链接。
前置要求#
确保已安装 Python 3，并安装 requests 库：
pip install requests使用方法#
基本用法 (检查默认地址 http://localhost:4000)
python scripts/check-links.py指定起始页面 (例如检查某个 页面路径)
python scripts/check-links.py --start /example/page1查看详细输出 (显示每个扫描到的链接)
python scripts/check-links.py -v完整参数
--url: 指定基础 URL（默认为http://localhost:3000，开发环境通常需改为http://localhost:4000）。--start: 指定起始扫描路径。--workers: 并发线程数（默认 10）。--timeout: 请求超时时间（秒）。-v / --verbose: 详细模式。
🎭 2. Playwright 脚本 (check-links-playwright.js)#
这是一个基于无头浏览器的检测工具。它会真实地渲染页面，等待 React Hydration 完成，然后提取 DOM 中的链接。这是最接近 Googlebot 和真实用户体验的检测方式。
前置要求#
需要 Node.js 环境。
如果你没有在项目中安装 playwright，可以使用全局安装的版本：
npm install -g playwright使用方法#
运行脚本 (使用全局 Playwright)
注意：Windows PowerShell 中可能需要设置
NODE_PATH环境变量指向全局模块目录。
# 设置全局模块路径 (请根据实际安装位置调整)$env:NODE_PATH="D:\Development\Nodejs\nodejs\node_modules"
# 运行脚本node scripts/check-links-playwright.js --start /example/page1 --max 20 -v参数说明
--url: 基础 URL (默认http://localhost:4000)。--start: 起始路径 (默认/)。--max: 最大扫描页面数 (防止无限爬取，默认 30)。--timeout: 页面加载超时时间 (毫秒)。-v / --verbose: 详细模式，显示已访问的页面列表。
📥 文件下载#
check-links.zip - 包含两个版本：
check-links.py- Python 版本check-links-playwright.js- Playwright 版本
如何验证修复？#
使用上述任意一个工具扫描详情页。如果扫描报告中包含了该页面内部的链接（即”有效链接”数量 > 0），说明 SSR 配置正确，SEO 友好。