- 主要特色 :全自动化安装,你只需要输入Bot Token和Chat ID即可,其他部署全靠自动化
- 多平台集成: 目前支持
Acck和Akile平台的自动签到。脚本内置时区检测并一键设置时区为Asia/Shanghai - 沉浸式对话: 通过独立的命令(如
/acck,/akile)引导用户完成账号配置,体验流畅 - 数据持久化:
- 用户凭证(账号、密码、TOTP)在首次配置后将加密保存在服务器,后续可实现"一键签到"。
- 所有用户数据按模块和用户ID隔离存储,确保安全。
推荐使用如下命令一键安装/管理(自动适配全局/本地):
bash <(curl -fsSL https://raw.githubusercontent.com/xymn2023/qiandao/main/start.sh)- 首次运行会自动下载项目、安装依赖、注册快捷命令,并提示输入 Bot Token 和 Chat ID。
- 后续只需输入
qiandao-bot(全局)或bash start.sh(本地)即可进入管理菜单。 - 一键脚本默认安装在python虚拟环境下,避免不必要的错误。
- 安装脚本会提示输入 Bot Token 和 Chat ID,并自动写入项目根目录的
.env文件。
- 如需更换配置,直接编辑
.env文件:
TELEGRAM_BOT_TOKEN=你的BotToken
TELEGRAM_CHAT_ID=你的ChatID
- 注意:
.env文件不会被升级/重装/更新覆盖,配置永久有效。 注意: 建议使用脚本的退出功能,默认脚本安装成功界面已屏蔽ctrl+c,之前使用ctrl+c退出会产生莫名其妙的bug.
bot.py顶部自动加载.env文件,无需手动修改代码:
from dotenv import load_dotenv
import os
load_dotenv()
TELEGRAM_BOT_TOKEN = os.getenv("TELEGRAM_BOT_TOKEN")
TELEGRAM_CHAT_ID = os.getenv("TELEGRAM_CHAT_ID")
if not TELEGRAM_BOT_TOKEN or not TELEGRAM_CHAT_ID:
print("❌ 配置错误:请在项目根目录新建 .env 文件,并填写 TELEGRAM_BOT_TOKEN 和 TELEGRAM_CHAT_ID")
exit(1)- 如缺少 .env 或配置为空,程序会自动报错并退出。
更多功能具体以bot为准。
- 升级/重装/拉取新代码时,.env 文件不会被覆盖,配置始终有效。
- 如需迁移到新服务器,只需拷贝
.env文件和数据文件(如 allowed_users.json 等)即可。 - 更换 Bot Token/Chat ID 只需编辑
.env文件,无需修改任何代码。
- 检查
.env文件是否存在于项目根目录,内容是否填写正确。
- 直接编辑
.env文件,保存后重启机器人即可。
- 不会丢失,.env 文件不会被覆盖。
- 进入管理菜单选择"检查并安装更新",或手动激活虚拟环境后
pip install -r requirements.txt。
- 当时就是闲得发慌没事做想找个东西琢磨琢磨,俗称闲得蛋疼。
.
├── Acck/
│ ├── qiandao.py
│ └── users/ # 存储Acck平台的用户凭证
├── Akile/
│ ├── qiandao.py
│ └── users/ # 存储Akile平台的用户凭证
└── bot.py # 机器人主逻辑文件
欢迎通过 Pull Request 或 Issues 为此项目做出贡献。如果你有想要集成的新签到模块,也欢迎提出!
本项目采用 MIT License 开源。
- 如有问题可在 GitHub 提 issue 或联系开发者。