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          # 发布日期
type: "ai"                          # 固定为 "ai"
link: "https://example.com"         # 官方网站链接
github: "https://github.com/..."    # GitHub 仓库链接（可选）
demo: "https://demo.example.com"    # 演示链接（可选）
author: "作者名称"                   # 作者或组织名称
ai_type:                            # 资源类型（单选）
  - "course"      # 教程
  - "project"     # 项目
  - "tool"        # 工具
  - "product"     # 产品
  - "collection"  # 资源库
tags:                               # 功能标签（多选）
  - "llm"         # 大语言模型
  - "prompt"      # 提示工程
  - "image-gen"   # 图像生成
  - "rag"         # RAG 检索增强生成
  - "agent"       # Agent & AI 工作流
  - "deployment"  # 部署与 API 接入
  - "devtools"    # 开发与调试工具
  - "data-train"  # 数据与训练
featured: false                     # 是否为推荐资源
thumbnail: ""                       # 缩略图文件名（可选）
---

资源分类标准

类型分类（ai_type）- 单选

类型 英文标识 说明 示例
教程 course 系统性学习资料 PyTorch 教程、Prompt 工程课程
项目 project 开源代码库或框架 LangGraph、Stable Diffusion
工具 tool 命令行或桌面工具 Gemini CLI、Jupyter Notebook
产品 product SaaS 平台或服务 ChatGPT、Claude AI
资源库 collection 资料和链接合集 Awesome AI Books

功能标签（tags）- 多选

标签 英文标识 说明
大语言模型 llm GPT、Claude、Gemini 等
提示工程 prompt Prompt 教程、策略、评估
图像生成 image-gen Stable Diffusion、DALLE
RAG 检索增强生成 rag LangChain、RAGFlow、向量数据库
Agent & AI 工作流 agent LangGraph、智能体、工作流
部署与 API 接入 deployment OpenRouter、API 代理、部署
开发与调试工具 devtools 开发环境、调试工具
数据与训练 data-train 数据集、训练、微调

添加图片和文件

  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. 提供迁移报告