PYTHON · DISCORD.PY · SQLITE

一个完整的 AI Discord 机器人，已为启动做好准备。

浏览运行架构，检查每个源文件，并下载一个可在本地运行或部署的纯净异步启动项目。

—项目文件

4Discord cogs

3异步服务

100%env 已配置

系统图谱

小模块，清晰的边界。

全程异步

斜杠命令、提及、权限、输入状态和可读的嵌入内容都位于专注的 Cogs 中。

cogs/

一个兼容 OpenAI 的 HTTP 客户端，增加了超时、重试策略、提供商配置和安全的错误消息。

services/ai_service.py

SQLite 确保服务器设置以及每个用户/频道的对话相互隔离、有上限、可过期且可重置。

database.py

垃圾邮件、屏蔽词、链接过滤、警告和管理员日志通过明确的验证规则运行。

cogs/moderation.py

源文件资源管理器

从项目树中选择一个文件进行检查。

启动清单

将 .env.example 复制为 .env。添加 Discord 令牌、AI 密钥、提供商 URL 和模型。切勿提交 .env 文件。

使用 bot 和 applications.commands 权限范围。仅启用 Message Content，然后根据需要授予 Send Messages、Embed Links、Read History 和 Moderate Members 权限。

运行一次机器人以同步全局命令，或设置 DEV_GUILD_ID 以实现即时开发同步。观察日志以检查权限或意图错误。

使用 Railway、Render、Fly.io 的 worker 或小型 VPS。为 SQLite 挂载持久化存储并配置健康检查重启。

套件包含内容包含真实的 Python 模块、测试、环境模板、README、管理规则以及优雅停机处理。