使用GitHub Actions审核内容

在此页面上

注意：这仍在进行中，目前功能可用，但我们正在努力简化它。请在这里关注更新。

概述

随着您的网站内容开始扩展，保持旧内容的更新可能会变得困难。

本指南包含设置GitHub Actions工作流的说明，以使用AI检查过时内容并提出GitHub问题。

安装GitHub操作

我们有一个公共仓库，其中包含一个您可以直接使用的GitHub操作来审核您的内容。按照安装步骤进行设置。

配置您的仓库

权限

启用GitHub Actions的权限

前往：您的仓库 | ⚙️ 设置 | Actions | 常规 | 工作流权限
启用您仓库内工作流的读取权限
允许GitHub Actions创建和批准拉取请求

GitHub上的工作流权限设置

Figure: GitHub上的工作流权限设置

为您的仓库启用GitHub模型：

前往：您的仓库 | ⚙️设置 | 模型
确保您已为您的仓库启用模型

为您的仓库启用GitHub模型

Figure: 为您的仓库启用GitHub模型

变量

您需要添加在运行GitHub操作时将使用的配置设置。要配置设置，请前往您的仓库 | ⚙️设置 | 秘密和变量。

秘密

名称	描述
TINA_TOKEN	您的TinaCloud API令牌。TinaCloud \| <your-project> \| Tokens \| Content (Readonly)
TINA_CLIENT_ID	您项目的Tina客户端ID。您可以在TinaCloud \| Projects \| <your-project> \| ⚙️ 项目详情 \| 客户端ID中找到它

变量

名称	描述
TINA_AUDITOR_CONTENT_WINDOW	一个数字，表示运行操作时将检查多少过时的内容项。（例如：5）
TINA_AUDITOR_EXPIRY_DAYS	在您的内容被重新评估之前将经过的天数。
TINA_AUDITOR_SYSTEM_PROMPT (可选)	将内容传递给GitHub模型时用于评估内容的提示。
TINA_AUDITOR_COLLECTION	审核查询将针对的集合。

系统提示（可选）

您可以选择通过提供自己的GitHub变量来覆盖默认的系统提示。要覆盖的值是TINA_AUDITOR_SYSTEM_PROMPT。

默认的系统提示如下：

您是一名专家内容审核员。您的任务是审查提供的Markdown内容，并对其质量、清晰度、相关性和吸引力提供建设性反馈。您应突出并建议具体的改进区域。忽略lastChecked日期。

准备您的内容

TinaCloud将用于定位和过滤您的内容。我们需要在您选择的集合中添加几个字段以启用内容检查。

const MyCollection : Collection = {
  label: '我的集合'
  name: 'myCollection'
  format: 'mdx'
  fields: [
    // 新字段
    {
      type: 'datetime',
      name: 'lastChecked',
      ui: {
        component: 'hidden',
      }
    },
    //...
  ]

}

在添加新字段后，请确保重新生成并提交您的tina-lock.json。

为了运行脚本，我们需要为您所有现有内容添加一个lastChecked字段。

导航到工作流的目录。

cd ./github/scripts/tina-helpers

您需要在此位置添加一个.env文件，并保存您的Collection、Tina Token和Tina Client ID。这些是您在GitHub设置中添加的相同属性。

TINA_TOKEN=<your-tina-token>
TINA_CLIENT_ID=<your-tina-client-id>
TINA_AUDITOR_COLLECTION=<your-tina-collection>

然后运行以下命令以迁移您的内容。

pnpm install
pnpm run migrate-content

输出应如下所示：

updated: content/posts/future-of-remote-work-2025.mdx 
updated: content/posts/learning-about-components.mdx 
updated: content/posts/june/learning-about-tinacloud.mdx 
updated: content/posts/artificial-intelligence-explained.mdx