项目地址

GitHub

gitee

功能概述

• 🔐 卡密验证系统：通过文本文件管理一次性卡密
• 📁 多功能文件分发：支持发送任意类型文件（危险类型除外）
• 📦 智能文件匹配：自动识别目录结构
• ⚡ 自动核销机制：成功发送后自动失效卡密
• 🛡️ 安全防护：过滤危险文件类型，防止恶意传播
• 🖱️ 多种下载方式： 识别到多文件时用户可自由选择逐条发送文件下载还是打包(.zip)下载(限打包后体积不超50Mb)
• 📃 日志保存： 日志自动实时保存至 bot.log 文件
• 🎞 演示视频：https://www.bilibili.com/video/BV1FbV7zeEzv/

部署步骤

1. 安装依赖

pip install -r requirements.txt

2. 文件结构配置

mkdir -p km file  # 创建卡密和文件目录
tree
# 应显示如下结构：
# .
# ├── main.py
# ├── km/
# └── file/

3. 设置机器人Token

直接修改代码
TOKEN = "YOUR_BOT_TOKEN"  # 修改main.py第20行

4. 运行机器人

python main.py

使用指南

用户使用流程

1. 向机器人发送卡密
2. 接收文件列表确认
3. 自动接收所有文件
4. 获得使用授权提示

管理员操作指南

1. 卡密文件管理

• 命名规则：备注.txt​ (例: test.txt​)
• 文件内容：每行一个卡密

# 示例：km/test.txt
ABC123-XYZ789
DEF456-UVW321

2. 文件存储规则

目录结构

file/
└── test/         # 与卡密文件同名目录
    ├── 教程视频.mp4
    ├── 说明书.pdf
    └── 素材包.zip

3. 文件命名建议

• 使用英文/数字命名
• 避免特殊字符：* \ / : ? " < > |​
• 示例：project_docs_v1.2.zip​

注意事项

安全规范

文件限制：

• 最大文件尺寸：50MB
• 禁止类型：.exe .bat .sh .dll​

最佳实践

• 📅 定期备份：建议每日备份km​目录
• 🔄 压力测试：正式使用前进行并发测试

法律声明

⚠️ 本工具仅限用于合法文件的授权分发，使用者需自行承担由文件内容引起的法律责任。

常见问题处理

卡密相关问题

文件发送问题

版本更新

• v1.1.0 (2025-05-30)

  • 修复文件过多导致消息过长超过官方限制无法发送的bug
  • 新增 打包下载
  • 新增日志保存 bot.log
  • 视频秒懂：https://b23.tv/PF7TRG8
• v1.0 (2025-05-03) 初始发布

‍