一个为 Typecho 博客系统设计的 AI 对话插件，适用于所有 Typecho 主题。支持创建独立 AI 对话页面和在文章/页面中使用短代码嵌入聊天窗口。
本插件基于Xuan's blog改善，适用了所用Typecho主题，原项目地址见：https://blog.ybyq.wang/archives/836.html
✨ 功能特性
- 🔌 全主题通用：不依赖任何特定主题，兼容所有 Typecho 主题
- 📝 两种使用方式：独立页面模板 + 文章短代码嵌入
- 🤖 多模型支持：支持所有 OpenAI 兼容格式的 API
- 💾 对话历史：登录用户云端同步，游客本地存储
- 📱 响应式设计：完美适配桌面和移动端
- 🎨 独立样式：自带美观的聊天界面，不与主题样式冲突
- 🚀 零依赖：移除 jQuery 依赖，纯原生 JavaScript
- ⚙️ 丰富配置：系统提示词、窗口高度、嵌入方式等可自定义
插件下载：
https://github.com/chenyuwebwawa/AiChat/
🚀 安装方法
1. 上传插件
将整个 AiChat 文件夹上传到 Typecho 的 usr/plugins/ 目录下。
2. 激活插件
- 登录 Typecho 后台
- 进入"控制台" → "插件管理"
- 找到"AiChat"插件，点击"激活"
3. 配置插件
在插件设置页面配置以下参数：
| 参数 | 说明 | 默认值 |
|---|---|---|
| AI API接口地址 | OpenAI 兼容格式的 API 地址 | https://api.deepseek.com/v1/chat/completions |
| AI API Key | 您的 API 密钥 | - |
| AI 模型 | 使用的模型名称 | deepseek-chat |
| 温度参数 | 控制回复随机性 0.0-1.0 | 0.7 |
| 最大回复长度 | 单次回复最大 token 数 | 2000 |
| 系统提示词 | 设置 AI 的角色和行为 | - |
| 嵌入方式 | 选择插件的使用方式 | 同时支持 |
| 聊天窗口高度 | 聊天区域高度（像素） | 450 |
📖 使用方法
方法一：创建独立对话页面（推荐）
- 在 Typecho 后台进入 管理 → 独立页面
- 点击 新增页面
- 在右侧 自定义模板 下拉框中选择 "AI Chat Plugin (通用版)"
- 填写页面标题（如："AI助手"）
- 发布页面即可
方法二：在文章/页面中嵌入聊天窗口
在任何文章或页面的内容中，使用短代码：
[aichat]即可在文章内容中嵌入聊天窗口！
示例：
## 欢迎与我对话
如果您有任何问题，欢迎使用下方的 AI 助手：
[aichat]
感谢您的访问！方法三：若以上方法都不适用
开启插件后访问：您的域名/ai-chat
🔌 支持的 API 服务
插件支持所有 OpenAI Chat API 兼容格式的服务，包括但不限于：
| 服务商 | API 地址 | 模型示例 |
|---|---|---|
| DeepSeek | https://api.deepseek.com/v1/chat/completions | deepseek-chat |
| OpenAI | https://api.openai.com/v1/chat/completions | gpt-3.5-turbo, gpt-4 |
| Kimi | https://api.moonshot.cn/v1/chat/completions | moonshot-v1-8k |
| 通义千问 | https://dashscope.aliyuncs.com/compatible-mode/v1/chat/completions | qwen-turbo |
| 文心一言 | https://aip.baidubce.com/rpc/2.0/ai_custom/v1/wenxinworkshop | ernie-bot |
| 其他 | 任意兼容 OpenAI 格式的接口 | - |
📋 系统要求
- Typecho 1.2+
- PHP 7.2+ （推荐 7.4+）
- 服务器支持 cURL 扩展
- MySQL 5.6+ / MariaDB 10.1+
🔧 故障排除
问题1：自定义模板不显示
解决方案：
- 重新激活插件
- 清除浏览器缓存后刷新后台页面
问题2：短代码不生效
解决方案：
- 确保短代码拼写正确：
[aichat]（小写，无空格） - 在插件设置中确认"嵌入方式"设置为"短代码嵌入"或"同时支持"
问题3：API 请求失败
解决方案：
- 检查 API Key 是否正确
- 确认服务器可以访问外网
- 检查 cURL 扩展是否启用
- 查看 PHP 错误日志获取详细信息
问题4：聊天窗口样式异常
解决方案：
- 这是新版 v2.0 的重点优化！现在应该不会出现了
- 如仍有问题，请在插件设置中调整聊天窗口高度
问题5：对话历史无法保存
解决方案：
- 游客：检查浏览器是否禁用了 localStorage
- 登录用户：检查数据库表是否创建成功
🆚 v2.0 改进说明
相比旧版本，v2.0 通用版做了以下重大改进：
- 主题兼容性：彻底移除 Handsome 主题依赖，适用于 所有 Typecho 主题
两种嵌入方式：
- 独立页面模板（原方式）
[aichat]短代码，可嵌入任意文章/页面
技术优化：
- 移除 jQuery 依赖，使用纯原生 JS
- 独立的 CSS 命名空间，避免样式冲突
- 自动注入 CSS 和 JS，无需修改主题
新增配置项：
- 系统提示词配置
- 聊天窗口高度自定义
- 嵌入方式选择
- 代码优化：更规范、更高效、更易维护
📄 更新日志
v2.0.0 🌟 通用版重大更新
- ✨ 全主题通用：移除对 Handsome 主题的依赖，兼容所有 Typecho 主题
- ✨ 短代码支持：新增
[aichat]短代码，可在文章中嵌入聊天窗口 - ✨ 移除 jQuery：纯原生 JavaScript 实现，减少依赖
- ✨ 自动注入：CSS 和 JS 自动注入页面，无需手动修改主题
- ✨ 系统提示词：新增自定义系统角色配置
- ✨ 独立命名空间：所有 CSS 类加前缀，避免样式冲突
- ✨ 新增配置：聊天窗口高度自定义、嵌入方式选择
- 🔧 代码重构：优化代码结构，提升可维护性
v1.3.1
- 优化 PJAX 兼容性（Handsome 主题专用）
- 重构前后端分离架构
v1.0.0
- 初始版本发布
📞 技术支持
如遇到问题，请：
- 检查插件配置是否正确
- 查看浏览器控制台（F12）是否有错误
- 检查 PHP 错误日志
- 确认 API 服务可正常访问
享受您的 AI 对话之旅！ 🎉
UP主创作不易，点个赞评论支持一下吧~
本文来自投稿，不代表本站立场，如若转载，请注明出处：
