功能介绍
TG-SignPulse 是 Telegram 多账号自动化管理面板，把签到、消息交互、关键词监听和 AI 辅助验证收敛到同一套 Web 控制台。
核心能力
账号管理
- 验证码登录 / 扫码登录 / 会话导入（Telethon·Pyrogram
.session、Pyrogram StringSession、TData.zip） - 代理与会话模式（file / string）；可强制 Telegram 走代理并校验代理出口 IP 是否泄漏宿主机 IP
- 设备管理、设备保活、官方消息查看
- 一键清退其他设备、派生独立 SessionString 导出
- 设备指纹画像（desktop / android / macos / ios 预设）
- 账号历史运行日志一键导出（
GET /api/accounts/{account_name}/logs/export） - 批量状态检查
详见 账号管理。
任务编排（sign-tasks）
- 固定 Cron 或时间段执行
- Jitter 错峰（
jitter_seconds，0–3600） - 自适应动态冷却调度：解析机器人回复中的冷却倒计时，自动调整下次运行时间
- 多账号共享同一套动作流程
- 发送文本、骰子、点按钮、AI 识图/计算、关键词监听等动作
- 目标会话支持按 Telegram 对话文件夹筛选、论坛话题（Forum Topics）选择
- 批量启用/停用/触发
- 11 类细粒度失败分类体系（包含会话失效、频率限制、AI 超时、按钮未找到、消息内容未变化等）
面板与 API 请使用
/api/sign-tasks。旧版 ORM/api/tasks已移除。
详见 任务编排。
AI 验证
- 图片 OCR / 选按钮
- 计算题回复
- 计算后点击
- OpenAI 兼容接口（含本地 LLM）
详见 AI 动作。
关键词监听
- exact / contains / regex
- 命中后推送、转发、继续动作
- 多实例可配置监听分片
详见 关键词监听。
通知与设置
- 签到间隔、任务超时/冷却/流程重试、AI 视觉参数可在面板「系统设置」覆盖
- Bot 测试发送、任务成功通知（全局 + 任务级开关）、静默时段
- 监听推送支持 Server酱（任务表单通道）
运维与可观测
/healthz、/readyz（含调度锁、旧 API 只读状态）- 版本信息与更新检查（Settings / 侧栏；
/api/ops/version） - Dashboard SSE 实时日志
- 任务 WebSocket 日志（含运行 phase：等锁 / 冷却 / 执行中）
- 任务运行状态：
GET /api/sign-tasks/runs/active、/run/status、/run/cancel（state+phase+failure_category） - Dashboard 活跃运行摘要与失败分类聚合（可点筛选日志 / 会话失效跳转账号）
- 任务列表：冷却倒计时、多账号 phase、停止运行、账号失效提示
- 备份目标策略（
backup_target）：支持智能选择（auto，配置 WebDAV 时自动上传，未配置时提供本地归档下载）、仅 WebDAV（webdav） - WebDAV 远端备份：内置坚果云/Nextcloud 等快捷预设、测试连接、列出远端、逐条下载、灾难恢复指引弹窗、自动备份失败 Bot 告警
- 完整数据归档与迁移：支持直接下载当前系统完整
.tar.gz备份包，以及轻量配置 JSON 导入导出与 dry-run 预览 - 配置导入预览（dry-run）
- 任务克隆与内置模板（文本/按钮/时段/骰子/关键词监听；预填动作后须选会话）
- 系统设置未保存提示与「保存全部」
- 旧任务 ORM 残留盘点：
tools/check_legacy_tasks.py
适合场景
- 多账号机器人签到、日常打卡
- 验证码、诗句填空、数学题、按钮验证
- 群组/频道长期监听与通知
- VPS / Docker 长期托管
不适合 / 注意
- 多副本共享同一个 Telegram session 文件（易损坏会话）
- 把面板直接裸奔在公网且无 HTTPS / 访问控制
- 依赖已移除的旧
/api/tasks接口