附录G：文档链接验证

📋 链接检查：本附录列出教程中所有外部链接和内部链接的验证状态

📊 链接统计

最后验证时间：2026年2月14日

🔗 外部链接清单

官方资源

安装脚本

API服务商

中转API服务

云服务商

视频教程

社区资源

开放平台

工具和依赖

📄 内部链接清单

第一部分：零基础入门

第二部分：核心功能

第三部分：进阶技能

第四部分：实战案例

附录

其他文档

🖼️ 图片链接清单

配置截图

架构图

🔍 链接验证方法

自动验证脚本

#!/bin/bash
# 文件名：check-links.sh

echo "开始验证链接..."

# 提取所有Markdown文件中的链接
find . -name "*.md" -exec grep -oP '\[.*?\]\(\K[^)]+' {} \; | sort -u > all-links.txt

# 验证外部链接
while IFS= read -r url; do
  if [[ $url == http* ]]; then
    status=$(curl -o /dev/null -s -w "%{http_code}" "$url")
    if [ "$status" -eq 200 ]; then
      echo "✅ $url"
    else
      echo "❌ $url (HTTP $status)"
    fi
  fi
done < all-links.txt

# 验证内部链接
while IFS= read -r path; do
  if [[ $path != http* ]] && [[ $path != \#* ]]; then
    if [ -f "$path" ]; then
      echo "✅ $path"
    else
      echo "❌ $path (文件不存在)"
    fi
  fi
done < all-links.txt

echo "验证完成！"

使用方法

# 赋予执行权限
chmod +x check-links.sh

# 运行验证
./check-links.sh

# 或使用现成工具
npm install -g markdown-link-check
markdown-link-check README.md

📝 链接维护规范

1. 外部链接

规范：

• ✅ 使用HTTPS协议
• ✅ 使用官方域名
• ✅ 避免使用短链接
• ✅ 定期检查有效性

示例：

<!-- ✅ 正确 -->
[OpenClaw官网](https://openclaw.ai)

<!-- ❌ 错误 -->
[OpenClaw官网](http://openclaw.ai)  <!-- 使用HTTP -->
[OpenClaw官网](https://bit.ly/xxx)  <!-- 使用短链接 -->

2. 内部链接

规范：

• ✅ 使用相对路径
• ✅ 包含文件扩展名
• ✅ 使用小写和连字符
• ✅ 锚点使用中文或英文

示例：

<!-- ✅ 正确 -->
[第1章](docs/01-basics/01-introduction.md)
[安装配置](#安装配置问题)

<!-- ❌ 错误 -->
[第1章](/docs/01-basics/01-introduction)  <!-- 缺少.md -->
[第1章](../01-basics/01-introduction.md)  <!-- 路径错误 -->

3. 图片链接

规范：

• ✅ 使用相对路径或CDN
• ✅ 提供alt文本
• ✅ 指定宽度（可选）
• ✅ 使用WebP格式（推荐）

示例：

<!-- ✅ 正确 -->
![OpenClaw架构图](images/architecture.png)
<img src="images/screenshot.png" alt="配置截图" width="600">

<!-- ❌ 错误 -->
![](images/screenshot.png)  <!-- 缺少alt文本 -->

🔄 更新记录

📞 报告问题

如果发现链接失效，请：

1. 提交Issue：在仓库的 Issues 中提交
2. 标题格式：[链接失效] 章节名称 - 链接描述
3. 提供信息：
   • 失效链接的完整URL
   • 所在文档和行号
   • 错误信息（如404、超时等）
   • 建议的替代链接（如有）

最后更新：2026年2月14日