🤖 源码七号站AI助手

让你的 emlog 博客拥有一个会"读懂自己文章"的科幻风 AI 智能体。

✨ 这个插件能做什么？

在博客右下角放一个浮窗 AI 助手。用户提问时，插件会：

1. 先从你的博客文章里搜索相关内容（站内知识库 RAG）
2. 需要时再去联网搜索补充外部信息
3. 把这些资料喂给 AI，让它给出准确、有来源的回答
4. 在回答下方标注参考来源，附带原文链接

简单说：让你的博客文章不再"沉睡"，变成一个会聊天的智能体。

🚀 主要特性

• 🎨 6 套科幻风皮肤：赛博蓝紫 / 霓虹荧光 / 全息投影 / 像素复古 / 极简白瓷 / 自定义
• 📚 站内知识库：自动检索博客文章，支持中文分词、按分类筛选
• 🌐 多搜索引擎：SearXNG / Tavily / Bing / SerpAPI / DuckDuckGo 一键切换
• 🧠 AI 服务商一键预设：DeepSeek / 智谱 GLM / 硅基流动 / Moonshot / OpenAI 等
• 🎙️ 语音输入：浏览器原生语音识别（免费）
• 📋 复制 / 重新生成：每条回答都有操作按钮
• 🔒 权限与限流：游客/用户/管理员分级，IP 黑名单（支持 CIDR/通配符），关键词过滤
• 📊 日志面板：每日提问统计、知识库命中率、联网调用次数
• ⚡ 流式 SSE 输出：打字机式实时响应
• 🛡️ 完全独立：不依赖任何模板，任何 emlog 主题都能用

⚙️ 5 分钟配置流程

第一步：配置 AI 模型（必须）

进入设置页 → AI模型 Tab：

最省钱方案：用智谱 GLM-4-Flash

1. 点击 智谱AI · GLM 卡片，自动填充 URL 和模型名
2. 去 https://bigmodel.cn/ 注册账号，创建 API Key
3. 把 Key 填进"API Key"输入框
4. 点击 "测试 AI 接口" 按钮，看到 ✅ 即可

速度更快方案：DeepSeek

1. 点击 DeepSeek 深度求索 卡片
2. 去 https://platform.deepseek.com/ 注册
3. 填入 API Key，测试

第二步：配置知识库范围（可选）

进入 知识库 Tab：

• 选择要参与检索的文章分类（按住 Ctrl 多选，不选=全部）
• "最多召回文章数"建议 5
• "单篇截取字符数"建议 800

第三步：联网搜索（可选）

⚠️ 重要提示：免费公共搜索接口非常不稳定，请认真阅读设置页中的警告说明。

最佳方案（按推荐度）：

1. 自建 SearXNG（最稳定）：Docker 一键部署，官方教程
2. Tavily AI（最省心）：注册免费 1000 次/月，专为 AI 设计
3. Bing Search API：微软出品，每月 1000 次免费（需绑卡）
4. SearXNG 公共实例：仅供测试

如果你只用站内知识库就够了，关闭联网搜索即可。

第四步：外观定制

进入 外观 Tab：

• 选择一套皮肤
• 自定义机器人名字、头像（emoji 或图片 URL）、欢迎语
• 调整主色辅色、背景风格、动效级别

第五步：保存，回到前台体验！

🔒 安全建议

• 把 AI API Key 当作密码看待，不要分享
• 务必在 权限 Tab 配置：
  • "游客每日上限"建议 10-20，防滥用
  • "登录用户每日上限"建议 30-100
  • "单次间隔"建议 5 秒
• 如有恶意用户，把其 IP 加入黑名单（支持 CIDR）

🐛 常见问题

Q: AI 回答不准？ A: 检查 System Prompt 是否合理，或者降低 Temperature 到 0.1-0.3

Q: 联网搜索老失败？ A: 看 联网搜索 Tab 顶部的警告 ⚠️，免费公共实例就是不稳定

Q: 没显示悬浮按钮？ A: 检查"启用插件"开关，刷新前台页面（清缓存），看浏览器控制台报错

Q: 移动端体验差？ A: 适当减小窗口宽高，或在 基础 Tab 直接关闭移动端

Q: 怎么知道用户都问了什么？ A: 进 日志 Tab，选日期查看