给Halo网站添加AI功能

Halo简介

Halo 是一款强大易用的开源建站工具，从个人博客、知识库，到企业官网、在线商城，Halo 都能助您轻松实现，一站式满足您的多样化建站需求。

官网链接：Halo - 强大易用的开源建站工具

部署方式：安装指南 | Halo 文档

本文中示范的Halo版本为2.25

AI简介

AI是人工智能（Artificial Intelligence）的缩写，它是一种模拟人类智能的技术，使机器能够像人一样学习、思考和做出决策，从而能够自主地执行各种任务。人工智能不仅仅是一种单一的技术，还包括了深度学习、机器学习、计算机视觉、自然语言处理等多种技术和算法。

本文中使用的AI为deepseek-v4-flash

API简介

API，全称为 Application Programming Interface，即“应用程序编程接口”。它是一组预先定义的接口规范，允许不同的软件系统、模块或组件之间进行通信和数据交换。通俗地说，API 就像是不同软件之间的“翻译官”，让它们能够“听懂”彼此的请求和响应。

举个例子：

你在手机 App 上查询天气，App 并不直接拥有天气数据，而是通过 API 向天气服务商请求数据，获取后再展示给你。这个过程中，API 就是 App 和天气服务之间的桥梁。

Token简介

1. 官方权威定义
2026年3月，国家数据局正式将Token的标准中文译名定为“词元”，明确其在AI领域的核心定位：Token（词元）是大模型处理、理解、生成人类语言的最小信息单元，也是AI世界可计量、可定价、可交易的核心标准。简单来说，Token是AI“识字、说话、思考”的基本单位，所有文本输入、模型运算、内容生成，最终都要拆解为Token进行处理。
2. 通俗类比：AI的“识字积木”与“数字货币”
可以把Token理解为两个核心角色：

• 识字积木：人类阅读以“字/词”为单位，而AI会将文本拆分成一个个“词块”（Token），可能是一个汉字、一个英文单词、一个词根，甚至是标点符号、空格、emoji，AI通过组合这些积木理解语义、生成内容。

• 数字货币：AI的所有服务都按Token计费，输入多少Token、输出多少Token，直接决定使用成本，就像现实世界中用货币购买商品一样，Token是AI服务的“通用货币”。

3. Token与字数/单词数的核心区别
很多人误以为Token就是汉字或英文单词，这是最常见的认知误区。两者的本质差异在于：

• 人类视角：字数/单词数是语言的自然单位，固定且直观，如1个汉字=1字，1个英文单词=1词。

• AI视角：Token是模型训练与推理的技术单位，粒度不固定，会根据语言、内容自动拆分，中文1个汉字≈1 Token，英文4个字母≈1 Token，复杂词汇可能拆分为多个Token。

• 核心差异：字数统计仅关注文本长度，而Token统计直接关联模型算力消耗与成本，是AI交互的核心计量标准。

部署Halo

上文中提到了部署Halo的官网链接，我们使用docker部署作为演示（真实使用过程中不推荐使用此方式，因为H2数据库很容易导致数据丢失，如必须使用请及时备份），在部署和使用过程中需注意以下问题：

• 使用宝塔面板部署时需要先安装docker环境，没有安装时点击图片所示处即可安装

  

• 命令中“docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 -e JVM_OPTS="-Xmx256m -Xms256m" registry.fit2cloud.com/halo/halo-pro:2.25”中结尾的“halo-pro:2.25”需要删除“-pro”，否则下载下来的是专业版本 最终命令：docker run -it -d --name halo -p 8090:8090 -v ~/.halo2:/root/.halo2 -e JVM_OPTS="-Xmx256m -Xms256m" registry.fit2cloud.com/halo/halo:2.25

• 下载完成之后可以通过“你的服务器的IP地址:8090/console”进入注册页面设置网站参数

• 在每次服务器重启后都需要手动启动docker容器，命令是"docker start $(docker ps -aq)"（此命令为启动所有docker容器）

启用插件功能

在Halo中使用插件需要有“应用市场”这个插件，这个插件一般是默认携带的，不需要自己操作。

在对插件执行安装、卸载或管理等功能时需要进入“插件”这个页面，一般情况下在网页左侧的侧边栏中，如果没有可以往下滑找一找

打开插件页面后我们需要下载几个插件，点击右上角的“安装”即可打开“应用市场”中的各种插件，我们需要下载以下插件

安装好之后会显示需要重载页面，意思就是需要刷新一下页面，然后点击这些插件右边的按钮，即可启用你安装的插件

如果你想要下载插件，请点击这个插件右边的“···”按钮，然后选择你要操作的

现在你已经掌握了插件的基本方法

选择AI提供商

我们现在打开“AI Foundation”插件（安装好此插件后左侧侧栏会新增AI Foundation页面，点击进入即可），会发现里面空空如也，这是因为你还没有选择你的AI提供商，现在市面上的AI有许多，以下列举出一些

本文使用deepseek作为演示

注册

首先让我们打开deepseek的官网DeepSeek | 深度求索，在这个页面的右侧有一个API开放平台的按钮，我们点击进入，在这里会让你注册或登录，按提示进行操作即可

进来之后我们会看到类似于这样的页面

但先不要着急操作，请先仔细阅读deepseek Token的收费标准模型 & 价格 | DeepSeek API Docs 和他的API文档首次调用 API | DeepSeek API Docs

阅读完之后如果你认为你的经济实力可以支撑此功能，即可进行下一步操作

获取API

我们回到刚才的页面，点击左侧侧栏的“API keys”，点击右上角的创建API keys，输入你想要起的名称（可以随便起），接着会弹出一个弹窗，上面记录了你的API key，你需要妥善保存，它只会在创建时显示一次，创建完后你需要充值一些钱才可以正常使用，最低充值1块钱（此API key仅作为演示，无法正常使用）

回到Halo中的“AI Foundation”页面，点击右上角的“+”以添加你的API key

进来之后我们会看到这样的页面

—供应商类型—

选择你使用的供应商

—显示名称—

这个不用管

—Base URL—

留空使用默认地址即可

—API Key—

点击右侧的“+”号，添加刚才你在deepseek中获取的API Key

—代理主机、端口—

这个不用管

上述步骤操作完后我们就会发现我们的AI被添加进来了，这时在“模型列表”中点击右侧的添加模型、从供应商获取就可以看到模型了，我选择的是deepseek-v4-flash，它比pro的价格便宜一些，到这一步我们的AI配置就完了

一般情况下插件可以自动使用AI，详情可以咨询插件开发者

注意，在使用插件时请注意Token消耗量，例如：某插件可以为文章生成简介和图谱，但是你的博客文章较多，那么他就会消耗极大的Token，同时我们也需做好一些防护措施，例如在插件中设置用户几十秒内最多可调用的次数，可以减少一部分恶意消耗Token数量