基于 LLM 的 Telegram 群聊智能机器人
🧠 智能决策 · 🛡️ 内容审核 · 🔐 入群验证 · 📝 永久记忆 · 🎭 贴纸系统 · 🔍 联网搜索 · 🎵 音乐点播 · 🗣️ TTS 语音
消息进入
│
├─ 全局封禁拦截（外层中间件，命中即删+封）
│
├─ 资料筛查（外层中间件，改名/改简介后自动复查）
│
├─ 内容审核 (keyword / regex / LLM 三级检测，带置信度)
│ ├─ 高置信度命中 → warn / delete / ban（按规则独立配置）
│ └─ 低置信度命中 → 删消息 + 可选验证码真人质询
│
├─ 管理意图路由 (manage_intent)
│ └─ memory_manage / rule_manage → 直接执行
│
├─ 决策模型 (decision)
│ ├─ skip → 结束
│ └─ casual → 进入回复流程
│
├─ 回复流程 (skill tool-calling loop)
│ ├─ 主模型自主选择技能调用
│ ├─ 贴纸决策模块独立判断是否发送贴纸
│ └─ 回复模式选择 (reply / message)
│
└─ 输出
项目通过 LiteLLM 接入多供应商，支持 fallback 链自动降级。以下角色均可在设置中心独立选择供应商、模型、推理强度和回退链；未指定的辅助角色自动复用上级模型：
| 角色 | 用途 | 默认模型 |
|---|---|---|
| main | 聊天回复、技能工具调用 | 必须配置 |
| decision | 判断是否回复（skip / casual） | 复用 main |
| moderation | 内容审核 | 复用 decision |
| vision | 图片/贴纸理解 | 复用 main |
| compress | 上下文压缩摘要、风格蒸馏 | 复用 main |
| embed | 向量嵌入（预留） | text-embedding-004 |
决策模型接收消息上下文（是否 @bot、是否回复 bot、发送者身份、最近历史等），输出 skip 或 casual。被 @ 或回复 bot 消息时强制响应；群友互聊时优先保持沉默。
支持三种规则类型，每种规则可独立配置命中动作：
| 规则类型 | 说明 |
|---|---|
keyword |
关键词字面匹配 |
regex |
正则表达式匹配 |
llm |
LLM 语义判断（同义词、变体、谐音等） |
命中动作：warn（警告）、delete（删除消息）、ban（累计 3 次警告后踢出）。支持按用户设置 AI 审核豁免，支持全群「仅审核不回复」模式。管理员可用 /clearwarnings 清空某用户的累计违规次数。
置信度分级：审核模型输出 0.0–1.0 的置信度。高置信度（默认 ≥0.9）命中直接执行规则动作；低置信度命中不直接处罚，而是删除消息并发起真人质询（可在 Mini App 中切换 Cloudflare Turnstile/hCaptcha）——通过质询即恢复，超时未通过则封禁。审核输出不可解析时按不违规处理且不写入已审核缓存。
bot 消息审核：部分广告机借助 Telegram bot（如 guest 模式）在群内发广告，其他 bot 发送的消息同样进入内容审核。每个 bot 在每个群累计通过配置数量（默认 5 条）的干净消息后自动加入白名单，之后不再审核；只有携带可审核内容的消息（文本、caption、可识别图片、文件名、联系人卡片）才计入累计，纯占位媒体（无字幕语音/视频等）既不计数也不调用审核模型。违规会删除消息、清零累计并计入警告，累计达到警告阈值自动封禁该 bot；高置信度命中 ban 规则时立即封禁。群管理员 bot 与人工豁免的 bot 自动跳过。/unaiexempt（回复消息或 /unaiexempt <ID>）可撤销已获得的白名单。bot 消息只做审核，不进入回复/决策管线，也不发起真人质询（bot 无法完成验证）。注意：要收到其他 bot 的群消息，需在 @BotFather 中为本 bot 开启 Bot-to-Bot Communication Mode（Bot API 10.0+）；本 bot 已要求以管理员身份运行，开启该模式后即可收到群内其他 bot 的全部消息。
入群验证按群配置：每个群都能单独关闭、开启或继承全局默认，并可选择 Cloudflare Turnstile、hCaptcha，或「Turnstile + hCaptcha」双重验证。新成员入群后会先被禁言，需点击群内按钮跳转 bot 私聊，在 Telegram Mini App 内完成该群所选验证码后恢复权限；超时被移出群聊（可重进重试）。身份由 Telegram initData 签名（HMAC bot token）保证。需要 bot 是带「封禁用户」权限的群管理员（启动时自检并警告）。
双重验证模式下，Mini App 页面同时展示两个验证组件并引导按顺序完成：先完成第 1 步 Turnstile（完成前 hCaptcha 步骤置灰锁定），再完成第 2 步 hCaptcha，两个 token 一并提交，服务端依次经两家 siteverify 校验，全部通过才放行。该模式要求 Turnstile 和 hCaptcha 两套 Site/Secret Key 均已配置。
新成员入群时用群规审查其昵称/用户名/简介，命中即自动加入全局封禁名单；此后每条群消息都会复查发送者可见资料（含 /help、视频、纯媒体消息），改名无法逃避。全局封禁的用户在任意授权群发言即被删消息并封禁。/ban、/unban 现在对所有群管理员开放，默认只操作当前群；最高管理员使用时会收到「仅本群 / 全局」内联选择。/banlist 和 Mini App 全局名单仍仅最高管理员可见。
成员处置语义：永久封禁和「仅移出群聊」统一直接调用 banChatMember(revoke_messages=True)；仅移出随后调用 unbanChatMember，不留下封禁记录，用户之后可重新加入。按 Telegram 官方说明，这会撤销被移除账号对旧群历史的访问，但不会删除该账号过去发出的消息；Bot API 目前没有按成员删除全部发言的方法（同名能力只存在于仅用户账号可调用的 MTProto API）。
每天在设定时间（默认 04:30，Asia/Shanghai）自动分批复查群内所有已知成员的昵称/用户名/简介是否违反群规（默认每批 500 人，批间停顿可配）。成员名单由入群/退群事件和消息流量自动维护，并从保留的对话历史一次性回填。已通过且资料未变的成员会被缓存跳过，修改群规后自动全员重查。
巡检发现违规后：违规者被禁言，bot 发出一条 @全部违规成员 的警告消息，附带共享的「真人质询」内联按钮——仅被点名成员可点击，点击后跳转 bot 私聊，在 Mini App 内完成人机验证即恢复权限；超时未完成的成员会被移出群聊但不封禁，可以重新进群。管理员、审核豁免用户和其他 bot 不参与巡检。
Mini App 的「审核验证」页可配置全局开关、每日巡检时间、批大小、质询超时等；群组页支持逐群覆盖开关，并可点击「立即巡检」手动触发。需要已配置 Turnstile/hCaptcha 真人验证服务，否则巡检不会执行（避免禁言后无法解除）。
短时间批量入群达到阈值时自动锁定群组，锁定期间新加入者会被临时移出但不永久封禁；触发与解除通知都长期保留。系统会追溯近期加入者并发送真人质询：第一行是被点名成员的验证按钮，第二行是仅管理员可用的「一键移除被追溯用户」。锁定到期后无需等待下一次入群，bot 会主动发送解除通知。
管理员可用 /raidguard on 无限期手动开启、/raidguard 30 或 /raidguard on 30 按分钟限时开启、/raidguard off 解除、/raidguard status 查看状态。手动状态会持久化，Bot 重启后仍继续生效；限时状态到期时只发送一次持久的解除通知。
Mini App 群组页可读取并完整编辑 Telegram 当前 ChatPermissions 全部字段。每个群独立保存基础权限、IANA 时区和多个定时时段；时段可跨午夜、选择星期、设置优先级，并只覆盖指定权限。例如基础权限允许图片，配置 23:00–07:00 的「禁止发送图片」覆盖后，夜间自动关闭图片，早上自动恢复基础权限。保存后立即下发，后台会在切换点、重启后及周期校准时重新应用。
在 Mini App 群组页逐群配置关键词触发的固定回复，支持「包含 / 完全匹配 / 正则」三种匹配方式。回复内容支持换行、可拉伸编辑和安全 Markdown。每条规则还可携带自定义内联按钮（跳转链接、复制文字、分享、管理员删除并可横向排列），并单独选择置顶、自动删除和启用状态。
在 Mini App 群组页逐群配置定时发送的群消息，支持两种节奏：「每天定时」按 HH:MM（Asia/Shanghai）每天发送一次，「固定间隔」按分钟数循环发送（最短 5 分钟）。内容支持换行、可拉伸编辑、安全 Markdown 和与关键词回复相同的自定义内联按钮；同时支持置顶、取消上一条置顶、自动删除和启用状态。
在 Mini App 群组页逐群配置入群欢迎语，留空则不发送。支持 {name}（新成员名称）和 {mention}（可点击提及）占位符、换行、安全 Markdown 与自定义内联按钮。开启入群验证的群，欢迎语在成员通过验证后（含管理员直接通过）才发送；未开启验证的群在完成资料筛查后发送。
群成员发送 @admin（或 @admins）即可一键呼叫群管理员：机器人发送一条真实 @ 提及管理员的通知（可附带说明文字；回复某条消息发送则同时附上被举报消息内容并锚定回复）。审核不通过的消息不会触发呼叫。全局可配置开关与呼叫冷却时间；Mini App 群组页可逐群覆盖开关，并勾选要 @ 的目标管理员（默认全部勾选，全选状态下新晋管理员自动包含）。通知消息属于独立的「呼叫管理员」自动删除类别。
任何群成员回复骚扰消息并发送 /voteban [举报理由]，即对被回复用户发起民主投票；也可在回复目标消息时直接要求 Bot 发起，由 vote_ban 技能执行。投票消息带内联「投票封禁」按钮，每人一票（发起人自动投出第一票），达到本群设定票数后立即在本群封禁该用户（同步写入警告/封禁名单，Mini App 可见）。投票消息同时带「取消投票」「直接封禁」两个管理员按钮：群管理员及以上可提前终止投票或跳过计票直接封禁，结果通知与审计账本会记录执行的管理员身份。管理员、最高管理员、机器人与匿名身份不可被投票；同一目标同时只能有一个进行中/执行中的投票；超过有效期自动失效。
命令与 AI 技能共享持久化的单用户触发额度，默认每群每位用户 3 次 / 3600 秒，重启后不会清零；全局与每群均可覆盖次数和统计窗口。额度耗尽时技能向主模型返回结构化错误，主模型必须拒绝并说明恢复时间，不得建议改用命令绕过。封禁/解封决定与 Telegram 实际执行结果写入审计账本，Bot 的可信上下文会包含当前封禁对象、原因、发起人、投票票数和成功/失败状态。进行中的投票消息不会被定时删除，结束后的结果通知按「民主投票」类别清理。
管理员通过自然语言或 /lm 命令维护群组永久记忆。回复时自动注入 [permanent-memory] 上下文。支持列表翻页和内联按钮删除。存储于 SQLite，重启不丢失。
群组长时间沉默后，bot 可自动抛出一个结合群记忆的话题。通过 /proactive on|off|status 控制，支持静默时段配置。
管理员回复目标用户消息后发送 /mimic，bot 开始采样该用户的群消息（滚动窗口 200 条、总上限 1000 条），每约 50 条由 compress 模型蒸馏一次风格画像，并以 [SPEECH_STYLE_PROFILE] 注入回复提示词。/mimic status 查看进度，/mimic off 停止并清理样本。
主模型通过 function calling 自主决定调用哪些技能，无独立技能规划模型：
| 技能 | 说明 |
|---|---|
memory_manage |
查看/新增/修改永久记忆（删除走 /lm） |
rule_manage |
查看/新增群规（删除走 /rules） |
send_sticker |
语义匹配发送贴纸 |
websearch |
DuckDuckGo 联网搜索 |
webfetch |
抓取网页正文内容 |
music_search |
GD Studio 音乐 API：搜索、点播、歌词、专辑封面 |
bilibili_search |
B站视频/UP主搜索、热门、排行榜 |
weibo_search |
微博热搜、内容搜索、Feed 流 |
movie_info |
TMDB / 官方 IMDb 电影搜索、详情、独立评分和上映状态（需配置） |
sub2api_query |
Sub2API 网关查询：模型列表、模型测活（需配置） |
doubao_tts |
豆包 TTS 语音合成（需配置） |
vote_ban |
明确请求且回复目标消息时发起民主投票；与命令共用用户额度 |
movie_info 的供应商凭证在设置中心配置，只有至少一个合规可用的供应商才会注册。IMDb 实时接口仅指官方 AWS Data Exchange GraphQL API，需要相应商业订阅与许可；不会抓取 IMDb 网页。TMDB 也必须先取得适用于当前用途的 API 授权，尤其是 AI / chatbot 或商业场景，不应仅凭普通 developer key 默认上线。
凭据申请、授权范围与接口字段以官方文档为准：IMDb API Getting Access、IMDb API Calling、TMDB Application Authentication、TMDB API Terms of Use。
收到贴纸后自动记录 file_id、emoji、贴纸包和视觉描述到 sticker_library 表。回复时由独立的贴纸决策模块判断是否发送，优先按语义从已学习贴纸中选择，支持默认贴纸池兜底。
支持按番号直查、按演员/关键词搜索，来源覆盖 JAVBUS / MADOUQU / DMM / FC2。每群独立开关（/av enable|disable）；群内仅在已授权且已启用时可用，私聊仅最高管理员可用。支持内联翻页浏览详情和种子。
日志行携带流程上下文（trace_id），支持彩色输出和文件轮转。应用级别、第三方库级别、颜色、文件路径、轮转大小和保留数量均在设置中心管理。
| 命令 | 说明 |
|---|---|
/help |
查看完整帮助 |
/settings |
最高管理员打开可视化设置中心 |
/lm |
永久记忆列表（翻页 + 内联删除） |
/lm add <内容> |
新增永久记忆 |
/lm replace <#ID或关键词> => <新内容> |
修改永久记忆 |
/addrule <自然语言> |
新增群规 |
/rules |
群规列表（翻页 + 内联删除） |
/av <番号/演员/关键词> |
搜索 AV 资源 |
/voteban [举报理由] |
回复用户消息后发起民主投票封禁（受单用户额度限制） |
@admin [说明] |
呼叫群管理员（可回复消息举报） |
| 命令 | 说明 |
|---|---|
/warnings |
查看警告/封禁名单 |
/clearwarnings [用户ID] |
清空某用户的累计违规次数（也可回复消息） |
/ban [用户ID] [原因] |
本群封禁（最高管理员可在内联键盘选择全局） |
/unban [用户ID] |
本群解封（最高管理员可在内联键盘选择全局） |
/raidguard on [分钟]|off|status |
手动控制爆破防护；数字单位为分钟 |
/aiexempt |
回复用户消息后豁免其 AI 审核（bot 亦可豁免） |
/unaiexempt |
回复用户消息后取消审核豁免；对 bot 同时撤销其审核白名单 |
/mute |
回复用户消息后忽略其后续回复 |
/mute all |
全群仅审核，不再回复 |
/unmute |
回复用户消息后恢复其回复 |
/unmute all |
恢复全群正常回复 |
/proactive on|off|status |
主动话题开关/状态 |
/mimic [status|off] |
回复用户后学习其说话风格 |
/compact |
立即把本群临时对话历史压缩进背景摘要 |
| 命令 | 说明 |
|---|---|
/authgroup [群ID] |
授权群组 |
/unauthgroup [群ID] |
撤销群组授权 |
/authlist |
授权群组列表 |
/banlist |
查看封禁名单 |
/authadmin [群ID] [用户ID] |
授权群管理 |
/unauthadmin [群ID] [用户ID] |
撤销群管理 |
/adminlist [群ID] |
群管理列表 |
/atreply [enable|disable] |
仅 @ 才回复模式 |
/tts [enable|disable|always] |
TTS 语音模式 |
/av enable|disable |
每群 AV 查询开关 |
- Python 3.12+
- Telegram Bot Token
- 至少一个大模型 API（支持 OpenAI / Anthropic / Gemini / OpenAI Compatible 等）
git clone https://github.com/Hamster-Prime/Smart_Group_Bot.git
cd Smart_Group_Bot
# 安装依赖
pip install -e .
# 配置
cp .env.example .env
# 编辑 .env，只填写启动所需的 BOT_TOKEN、SUPER_ADMIN_ID、
# CONFIG_MASTER_KEY、DATABASE_URL、MINIAPP_*，以及可选的 WEBHOOK_* 配置
# 启动
python start.pyAPP_UID="$(id -u)" APP_GID="$(id -g)" docker compose up -d --buildCompose 默认只把后端端口绑定到 127.0.0.1:8480，适合同机 HTTPS 反向代理；如确需让其他主机或容器直接访问，请显式设置 MINIAPP_BIND_ADDRESS 并同时配置防火墙。APP_UID / APP_GID 应与宿主机 ./data 目录所有者一致，容器进程不会以 root 运行。停止宽限期为 8 分钟，确保在途更新、LLM 回复及 Telegram 清理任务能完成有界落盘。
uv.lock 与由其导出的 requirements.lock 均纳入版本控制；镜像只安装锁定版本。依赖变更后运行：
uv lock
uv export --frozen --no-dev --no-emit-project --no-hashes \
--no-annotate --no-header --output-file requirements.lock启动后，最高管理员私聊 bot 发送 /settings，在 Telegram Mini App 中配置：
- 模型供应商、API 密钥、角色模型、fallback、推理等级和重试参数
- Bot 回复、流式输出、上下文、主动话题和按消息类别配置的自动删除策略（每个类别可选「定时自动删除」或「内联删除按钮」二选一；定时删除可单独设置秒数，留空继承全局秒数；删除按钮仅群管理员可用）
- 审核、Cloudflare Turnstile/hCaptcha、TTS、音乐、Sub2API、AV 和贴纸池
- 日志输出、全部 LLM 提示词，以及每个授权群的完整默认权限/定时时段、消息模板/按钮、功能开关、群规、永久记忆、带用户名的警告/封禁与审核豁免、回复静默名单和说话风格画像
配置保存在数据库中并对后续请求热生效。第三方密钥使用 CONFIG_MASTER_KEY 加密，API 只返回“已配置”状态，不回传明文。全局配置使用 revision 防止多个页面互相覆盖。
被授权的群管理员也可在私聊中发送 /settings。其 Mini App 只返回自己负责的群组和群级资源，无法读取其他群组、全局运行配置、密钥、授权关系或全局封禁名单。
.env 只保留无法由 Mini App 自举的项目：
BOT_TOKEN=
SUPER_ADMIN_ID=
CONFIG_MASTER_KEY=
DATABASE_URL=sqlite+aiosqlite:///./data/bot.db
MINIAPP_PUBLIC_BASE_URL=https://bot.example.com
MINIAPP_LISTEN_HOST=0.0.0.0
MINIAPP_LISTEN_PORT=8480
WEBHOOK_URL=https://bot.example.com/telegram/webhook
WEBHOOK_SECRET=replace_with_at_least_32_random_charactersCONFIG_MASTER_KEY 可用 openssl rand -hex 32 生成，并需随数据库备份一起妥善保管。
配置 WEBHOOK_URL 和 WEBHOOK_SECRET 后，Telegram 更新会通过现有 Mini App HTTP 监听器接收。反向代理需要把 WEBHOOK_URL 的完整路径转发到 MINIAPP_LISTEN_HOST:MINIAPP_LISTEN_PORT；密钥需为 32-256 位字母、数字、下划线或连字符，可用 openssl rand -hex 32 生成。启动时会从 bot 所在主机探测该公网地址，运行中也会监控 Telegram 投递错误。Webhook 未配置、自检失败、URL/密钥格式错误、Telegram 注册失败或投递异常时，bot 会在日志中写明原因，清理远端 webhook，并自动降级为长轮询；运行中降级会保留已经积压的更新。
升级旧版本时，如果数据库尚无运行时配置，现有 .env 和 config.toml 业务项会导入一次；创建数据库配置记录后，后续启动不再用文件覆盖 Mini App 设置。确认设置中心内容无误后，可清理旧文件中的模型、功能和第三方密钥值；Docker 部署保留空的 config.toml 占位即可。
Smart_Group_Bot/
├── bot/
│ ├── __main__.py # 入口（python -m bot）
│ ├── config.py # 启动配置和模型配置类型
│ ├── loader.py # Bot / Dispatcher 初始化
│ ├── handlers/
│ │ ├── commands.py # 命令处理（/start /help /lm /av 等）
│ │ ├── admin.py # 管理命令（授权、群规、审核、封禁、TTS 等）
│ │ ├── membership.py # 入群/离群事件（筛查、验证）
│ │ └── group.py # 群消息主流程（审核→决策→回复）
│ ├── middlewares/
│ │ ├── db.py # 数据库会话注入
│ │ ├── logging_mw.py # 日志追踪
│ │ ├── global_ban.py # 全局封禁拦截（外层）
│ │ ├── profile_screen.py # 发言时资料复查（外层）
│ │ └── member_roster.py # 成员名单维护（供自动巡检，外层）
│ ├── services/
│ │ ├── llm.py # LLM 调用封装（LiteLLM + fallback + 流式合并）
│ │ ├── decision.py # 决策引擎
│ │ ├── moderation.py # 内容审核（置信度分级）
│ │ ├── memory.py # 记忆服务（对话历史 + 上下文压缩）
│ │ ├── memory_holder.py # 全局记忆持有者
│ │ ├── manage_intent.py # 管理意图路由
│ │ ├── reply_mode.py # 回复模式选择（reply / message）
│ │ ├── reply_output.py # 回复解析与输出
│ │ ├── proactive.py # 主动话题
│ │ ├── keyword_reply.py # 关键词回复（分群规则 + 可选置顶/自动删除）
│ │ ├── call_admin.py # 呼叫管理员（@admin 触发 + 分群目标选择）
│ │ ├── vote_ban.py # 民主投票封禁（分群阈值/时长/用户额度 + 投票会话）
│ │ ├── ban_audit.py # 封禁审计账本与主模型可信上下文
│ │ ├── scheduled_messages.py # 定时消息（每天定时/固定间隔 + 定时置顶）
│ │ ├── welcome.py # 入群欢迎语（分群模板 + 验证后发送）
│ │ ├── join_screening.py # 入群资料筛查 + 全局封禁
│ │ ├── join_verification.py# 入群验证 / 审核质询（Turnstile / hCaptcha）
│ │ ├── patrol.py # 自动巡检（定时全员资料复查 + 真人质询）
│ │ ├── verify_web.py # 内置验证页服务（aiohttp + Mini App）
│ │ ├── runtime_config.py # 数据库运行时配置、加密和热应用
│ │ ├── speech_style.py # 说话风格模仿（/mimic）
│ │ ├── admin_status.py # 管理员身份缓存（仅缓存非管理员结果）
│ │ ├── sticker_decision.py # 贴纸决策模块
│ │ ├── sticker_library.py # 贴纸学习库
│ │ ├── at_reply.py # 仅 @ 回复模式
│ │ ├── authz.py # 权限管理
│ │ ├── av_search.py # AV 搜索
│ │ ├── doubao_tts.py # 豆包 TTS 服务
│ │ └── skills/
│ │ ├── service.py # 技能调度（tool-calling loop）
│ │ ├── base.py # 技能基类
│ │ ├── memory_manage.py
│ │ ├── rule_manage.py
│ │ ├── vote_ban.py
│ │ ├── send_sticker.py
│ │ ├── websearch.py
│ │ ├── webfetch.py
│ │ ├── music_search.py
│ │ ├── bilibili_search.py
│ │ ├── weibo_search.py
│ │ ├── movie_info.py
│ │ ├── sub2api_query.py
│ │ └── doubao_tts.py
│ ├── db/
│ │ ├── models.py # ORM 模型
│ │ ├── engine.py # 数据库引擎
│ │ └── sqlite_session.py # SQLite 并发处理
│ ├── utils/
│ │ ├── bot_identity.py # 运行时 bot 身份块
│ │ ├── command_catalog.py # 命令注册表
│ │ ├── conversation_context.py
│ │ ├── logging_setup.py # 日志配置
│ │ ├── prompts.py # 提示词加载
│ │ ├── runtime_context.py # 运行时上下文构建
│ │ ├── security.py # 输入安全处理
│ │ ├── telegram.py # Telegram 工具函数
│ │ └── timezone.py # 时区工具
│ └── web/ # 设置 Mini App 页面、鉴权和 API
├── prompt/ # 各模块提示词（Markdown）
│ ├── persona.md # 人设
│ ├── decision.md # 决策提示词
│ ├── moderation.md # 审核提示词（含置信度）
│ ├── skill_tools_v2.md # 技能系统提示词
│ ├── manage_intent.md # 管理意图路由提示词
│ ├── reply_mode.md # 回复模式提示词
│ ├── sticker_decision.md # 贴纸决策提示词
│ ├── proactive_topic.md # 主动话题提示词
│ ├── style_distill.md # 风格蒸馏提示词
│ └── compress.md # 上下文压缩提示词
├── tests/ # 测试（pytest）
├── config.toml # 旧版本一次性迁移输入，导入后忽略
├── .env.example # 最小启动配置模板
├── pyproject.toml
├── Dockerfile
├── docker-compose.yml
└── start.py # 一键启动脚本
| 组件 | 用途 |
|---|---|
| aiogram 3.x | Telegram Bot API |
| LiteLLM | 多供应商 LLM 抽象层 |
| SQLAlchemy 2.x (async) | 数据库 ORM |
| aiosqlite | SQLite 异步驱动 |
| Pydantic v2 | 配置模型 |
| cryptography | 数据库密钥加密 |
| DuckDuckGo (ddgs) | 联网搜索 |
| aiohttp | HTTP 客户端 |