Skip to content

AI 资源指南

本指南说明如何在网站中添加和管理 AI 资源。

目录结构

每个 AI 资源都应该放在独立的目录中，结构如下：

content/zh/ai/
├── _index.md                    # AI 资源列表页面
├── resource-name/               # 资源目录（使用短横线命名）
│   ├── index.md                # 资源主文件
│   ├── image1.png              # 相关图片
│   ├── image2.jpg              # 相关图片
│   └── other-files/            # 其他相关文件

创建新资源

1. 使用 Hugo 命令创建

hugo new content/zh/ai/resource-name/index.md

这会使用 archetypes/ai.md 模板创建新的资源文件。

2. 手动创建

  1. 创建资源目录：mkdir content/zh/ai/resource-name
  2. 复制模板文件到 content/zh/ai/resource-name/index.md
  3. 根据需要修改内容

Front Matter 字段说明

---
title: "资源名称"                    # 资源标题
description: "资源描述"              # 简短描述，用于卡片显示
date: 2025-01-20T00:00:00Z          # 发布日期
link: "https://example.com"         # 官方网站链接
github: "https://github.com/..."    # GitHub 仓库链接（可选）
demo: "https://demo.example.com"    # 演示链接（可选）
author: "作者名称"                   # 作者或组织名称
tags:                               # 标签（多选，首字母大写，无重复语义）
  - "Project"      # 类型标签：项目（可选）
  - "Tool"         # 类型标签：工具（可选）
  - "Product"      # 类型标签：产品（可选）
  - "Course"       # 类型标签：教程（可选）
  - "Collection"   # 类型标签：资源库（可选）
  - "Model"        # 类型标签：模型（可选）
  - "LLM"          # 功能标签：大语言模型
  - "Prompt Engineering"  # 功能标签：提示工程
  - "Image Generation"    # 功能标签：图像生成
  - "RAG"          # 功能标签：检索增强生成
  - "AI Agent"     # 功能标签：Agent 与工作流
  - "Deployment"   # 功能标签：部署与 API 接入
  - "Dev Tools"    # 功能标签：开发与调试工具
  - "Data"         # 功能标签：数据与训练
  featured: false                     # 是否为推荐资源
  thumbnail: ""                       # 缩略图文件名（可选）
---

资源分类标准

标签规范

  • 首字母大写（Title Case），如 “Dev Tools”、“Image Generation”
  • 避免重复语义：使用统一的规范标签，例如用 “Data” 代替 “Data Training”
  • 类型与功能均通过 tags 表达：如 “Project”、“Tool”、“LLM”、“RAG”

推荐标签集合（示例）：LLM、Prompt Engineering、Image Generation、RAG、AI Agent、Deployment、Dev Tools、Data、OSS、Vibe Coding、Utility、TTS、MCP，以及类型标签：Project、Product、Course、Collection。

添加图片和文件

  1. 将图片文件放在资源目录中
  2. 在 Markdown 中使用相对路径引用：
![图片描述](image-name.png "图片标题")

最佳实践

  1. 目录命名：使用短横线分隔的小写英文名称
  2. 图片优化：使用适当的图片格式和大小
  3. 内容结构：遵循模板的章节结构
  4. 标签选择：准确选择类型和标签，便于筛选
  5. 链接检查：确保所有外部链接有效

示例

参考现有资源：

  • content/zh/ai/chatgpt/ - 产品类型示例
  • content/zh/ai/stable-diffusion/ - 项目类型示例
  • content/zh/ai/openai-cookbook/ - 资源库类型示例

迁移现有资源

如果有现有的单文件 AI 资源需要迁移到新结构，可以使用提供的迁移脚本：

./scripts/migrate-ai-resources.sh

该脚本会自动：

  1. 备份原文件
  2. 创建新的目录结构
  3. 移动文件到正确位置
  4. 提供迁移报告