跳转至

AI 资源指南

本指南说明如何在网站中添加和管理 AI 资源（基于数据文件）。

数据结构

AI 资源统一维护在数据文件中：

  • data/zh/ai_resources.yaml
  • data/en/ai_resources.yaml

每条资源包含元数据与正文内容（Markdown）。

创建新资源

  1. 在 data/zh/ai_resources.yaml 与 data/en/ai_resources.yaml 中新增条目。
  2. 保持中英文 slug 一致。
  3. content 字段使用 Markdown，可包含短代码。

示例：

- slug: resource-name
  title: 资源名称
  description: 简短描述
  date: 2025-01-20T00:00:00Z
  github: https://github.com/owner/repo
  tags:
    - OSS
    - Dev Tools
  thumbnail: https://opengraph.githubassets.com/1/owner/repo
  content: |
    ## 简介

    这里是正文内容。

字段说明

  • slug：URL 标识，中英文保持一致
  • title：标题
  • description：卡片展示摘要
  • date：收录日期
  • github / link / demo：项目链接
  • tags：标签数组
  • thumbnail：缩略图
  • content：完整 Markdown 正文

最佳实践

  1. slug 命名：小写短横线
  2. 标签规范：Title Case，避免语义重复
  3. 正文结构：保持现有章节结构与标题层级
  4. 链接检查：确保外链有效