常见问题

SageGuard是什么？如何工作的？

SageGuard是一款基于AI深度学习的智能Telegram群管理机器人。它采用先进的自然语言处理和行为模式分析技术，能够智能识别垃圾信息、验证新用户，并提供自动化的群组管理功能。与传统规则机器人不同，SageGuard能够学习和适应新的威胁模式，提供持续有效的防护。

SageGuard与传统群管机器人有什么区别？

传统机器人主要依赖固定关键词匹配和规则设置，容易被绕过。SageGuard采用AI深度学习技术，能够理解语义和上下文，自动学习新的垃圾模式，提供智能验证和自适应防护。准确率更高，误报率更低。

如何开始使用SageGuard？

访问快速开始页面，按照5分钟部署指南操作：获取Bot Token、安装依赖、配置环境、启动服务即可。整个过程非常简单，即使是技术新手也能完成。

SageGuard是免费的吗？

是的，SageGuard是开源免费项目，采用MIT许可证。您可以自由使用、修改和分发。我们相信开源是推动AI技术发展的重要方式。

如何打开 SageGuard 的 Mini App（群组设置）？

「垃圾信息公示」页面是做什么的？对判断反垃圾效果有用吗？

SageGuard支持哪些AI功能？

AI反垃圾检测的准确率如何？

SageGuard的反垃圾检测准确率超过98.5%，误报率低于0.5%。通过持续学习，系统会自动适应新的垃圾模式，准确率会随时间推移而提升。相比传统规则方法，准确率提升了40%以上。

如何配置AI检测的敏感度？

SageGuard支持动态敏感度调节。系统会根据群组特点自动调整检测策略，也可以通过配置文件手动调整参数。对于高流量群组，建议使用默认设置；对于专业群组，可以适当降低敏感度以减少误报。

AI学习是否会侵犯用户隐私？

不会。SageGuard采用联邦学习技术，数据在本地处理，不会上传到服务器。所有AI学习都在您的服务器上进行，保护用户隐私和数据安全。

Telegram 群里能做定时发消息或定时广播吗？

·

支持关键词或规则自动回复吗？

群内签到功能在哪里打开？

只有关键词拉黑的群管和 SageGuard 有什么本质区别？

·

如何获取Telegram Bot Token？

在Telegram中搜索并打开 @BotFather，发送 /newbot 命令，按照提示创建新机器人。创建完成后，BotFather会提供Token。请妥善保存Token，不要分享给他人。

Ollama连接失败怎么办？

检查OLLAMA_BASE_URL配置是否正确（默认http://localhost:11434），确保Ollama服务正在运行。可以通过 curl http://localhost:11434/api/tags 命令测试连接。如果是远程部署，需要配置正确的网络访问权限。

数据库连接失败的解决方案？

确认PostgreSQL服务正在运行，检查DATABASE_URL配置格式是否正确。确保数据库用户具有足够权限，可以通过psql命令直接测试连接：psql postgresql://user:password@localhost:5432/mtphelper

机器人无响应如何排查？

检查BOT_TOKEN是否正确，确保机器人已被添加到群组并具有管理员权限。可以通过发送/start命令测试。查看控制台日志是否有错误信息。确认网络连接正常，Telegram API可访问。

Mini App 打不开、一直转圈或报错怎么办？

什么是克隆 Bot？如何管理套餐？

如何查看和分析日志？

开发模式直接查看控制台输出；生产模式使用PM2查看：pm2 logs mtphelper。日志包含详细的处理信息、错误信息和性能统计，帮助诊断问题。

SageGuard的性能表现如何？

SageGuard采用优化的AI推理引擎，平均响应时间小于100毫秒。支持高并发处理，能够轻松应对数千用户同时在线的群组。内存占用约200-500MB，CPU使用率根据负载动态调整。

如何优化大群组的性能？

为大群组推荐使用Redis缓存队列，增加服务器内存到4GB以上。可以通过配置参数调整并发处理数量。定期清理历史数据，避免数据库过大影响性能。

支持哪些部署方式？

支持多种部署方式：1) Docker容器化部署（推荐）；2) PM2进程管理；3) 直接Node.js运行；4) Nginx反向代理。生产环境建议使用Docker+PM2组合，确保高可用性和易维护性。

如何监控SageGuard的运行状态？

提供内置健康检查接口 /health，包含系统状态、数据库连接、AI服务状态等信息。建议配置监控告警，及时发现和处理异常情况。