插件介绍

AiChat是一款专为Typecho博客设计的AI聊天插件,它可以让您轻松地在博客中添加一个AI对话界面。该插件具有以下特点:

  • 美观的聊天界面,支持Markdown渲染
  • 完美适配PC端和移动端
  • 支持深色模式
  • 支持本地存储聊天记录
  • 注册用户可在多设备间同步对话历史
  • 支持一键复制对话内容
  • 兼容主流Typecho主题(本文以Handsome主题为例)
    2026-01-30T03:20:45.png

安装步骤

1. 下载插件

首先,您需要下载AiChat插件。您可以通过以下方式获取:

  • 迅雷网盘下载:
    此处内容需要评论回复后(审核通过)方可阅读。

下载完成后,您将得到一个名为AiChat.rar的压缩包。

2. 上传并解压插件

将下载好的压缩包解压,您会得到一个AiChat文件夹。将这个文件夹上传到您的Typecho博客的/usr/plugins/目录下。
然后将ai-chat.php文件放置在handsome主题目录下。

3. 激活插件

登录到您的Typecho后台,进入"控制台 > 插件"页面,找到"AiChat"插件,点击"启用"按钮激活插件。

配置插件

1. 基本配置

激活插件后,点击"设置"按钮进入插件配置页面:

在配置页面中,您需要填写以下信息:

  • AI API接口地址:默认为https://api.deepseek.com/v1/chat/completions,您也可以使用其他兼容的API接口
  • AI API Key:您的API密钥,可以从相应的AI服务提供商获取
  • AI 模型:默认为deepseek-chat,也可以根据您的需求选择其他模型
  • 温度参数:控制AI回复的随机性,值越高回复越多样,默认为0.7
  • 最大回复长度:控制AI回复的最大token数量,默认为2000
    2026-01-30T03:34:10.png

填写完成后,点击"保存设置"按钮。

2. 创建聊天页面

配置完插件后,您需要创建一个独立页面来展示AI聊天界面:

  1. 进入Typecho后台的"管理 > 创建 > 创建页面"
  2. 填写页面标题,如"AI聊天"
  3. 在"自定义模板"下拉菜单中选择"AI聊天"
  4. 点击"发布页面"按钮
    2026-01-30T03:35:02.png

使用体验

1. 界面展示

创建完成后,访问您刚才创建的页面,您将看到一个精美的AI聊天界面:
2026-01-30T03:36:38.png

界面主要包括以下部分:

  • 顶部提示区:显示使用说明和当前登录状态
  • 聊天区域:展示对话内容
  • 输入区域:输入您想问的问题
  • 功能按钮:包括发送按钮、清空对话按钮和查看历史记录按钮(仅登录用户可见)

2. 功能特点

2.1 一键复制

当您将鼠标悬停在任何一条消息上时,会出现一个复制按钮。点击该按钮可以一键复制该条消息的内容,非常方便引用或分享。

2.2 聊天记录同步

  • 游客用户:聊天记录会保存在浏览器的本地存储中,清除浏览器数据后将丢失
  • 注册用户:聊天记录会同时保存在服务器,可以在任何设备登录账号后通过"查看历史记录"按钮加载

2.3 清空对话

如果您想开始新的对话,可以点击右上角的清空按钮,系统会询问确认后清空当前的对话记录。

3. 深色模式适配

AiChat插件完美适配深色模式,当您的博客切换到深色模式时,聊天界面也会自动切换到相应的深色样式。

常见问题解答

1. 为什么我看不到"AI Chat Plugin"模板选项?

如果您在创建页面时没有看到"AI Chat Plugin"模板选项,可能是因为:

  • 插件没有正确安装或激活
  • 您的主题不完全兼容

解决方法:尝试禁用后重新启用插件,或者联系插件作者获取支持。

2. 为什么AI回复很慢或者失败?

可能的原因包括:

  • API密钥配置错误
  • 网络连接问题
  • API服务商限流或额度用尽

解决方法:检查API配置,确保网络连接稳定,或者考虑更换API服务商。

3. 如何自定义聊天界面样式?

如果您想进一步自定义聊天界面的样式,可以通过修改主题的CSS文件或使用自定义CSS插件来实现。主要的CSS类名包括:

  • .ai-chat-container:整个聊天容器
  • .ai-chat-messages-area:消息显示区域
  • .ai-chat-input-area:输入区域
  • .message.user:用户消息
  • .message.bot:AI回复消息

总结

通过AiChat插件,您可以轻松地为Typecho博客添加一个功能强大、界面美观的AI聊天功能。无论是用于回答访客问题,还是作为博客的特色功能,它都能为您的网站增添不少亮点。

希望本教程对您有所帮助!如果您在使用过程中遇到任何问题,欢迎在评论区留言或者联系插件作者获取支持。

最后修改:2026 年 01 月 30 日
如果觉得我的文章对你有用,请随意赞赏
END
本文作者:
文章标题:Typecho handsome 博客添加AI聊天功能 - AiChat插件
本文地址:https://blog.ybyq.wang/archives/836.html
版权说明:若无注明,本文皆Xuan's blog原创,转载请保留文章出处。