TelePost

语言 / Language: 中文 · English

Telegram 频道投稿、审核与发布平台。

用户可以从 Bot 或 Mini App 投稿，外部程序可以通过 HTTP API 投递内容；不同入口共用同一套流程。

✨ 功能

• Bot 投稿 — 预览、编辑、发布，支持图片、视频、音频与文件
• Mini App — 投稿、浏览内容、审核与后台管理；审核队列空态附「最近处理」与审核历史入口
• 审核队列 — 审核、编辑后发布、剧透等
• 小说在线阅读 — TXT 小说可选生成 Telegraph 在线阅读页；频道主贴保留完整标题/简介/tags，在线阅读入口独立且不重复；TelePost 2.76.2 配置 TelePress 0.16.4 后，长文单页目标约 20,000 字符，阅读中断更少
• 媒体代理重写 — 受限图床链接可经自建公网反代重写后投递
• 频道搜索 — 历史搜索、标签、投稿记录
• HTTP API — Bearer Token、幂等提交，方便脚本与自动化
• 多 Bot 隔离 — 一个进程运行多个互不干扰的 Bot
• 灵活运行 — Polling / Webhook / 自动模式
• SQLite 持久化 — 长期稳定运行，重启可恢复

🔁 工作方式

Telegram Bot ─────┐
Telegram Mini App ├──→ TelePost ──→ Telegram Channel
HTTP API ─────────┘

投稿、审核和发布共用同一套流程；审核策略可按入口（Chat / Mini App / HTTP API）分别配置。

🚀 快速开始

四步跑起来：

1. 用 @BotFather 创建（或已有）一个 Bot
2. 把 Bot 加进目标频道，并授予发帖权限
3. 从 Releases 下载对应平台版本
4. 运行一次，按向导填写 Bot Token、频道 ID、Owner ID

Linux 首次启动：

chmod +x telepost-linux-x64
./telepost-linux-x64

启动后，向 Bot 发送 /start，再用 /submit 发布第一条投稿。

或使用 Docker：

docker compose up -d

完整的安装、配置与升级步骤见 安装与部署。

🌐 HTTP API

方便脚本与自动化：先在 Bot 中用 /gen_token 生成 Token，再提交内容：

curl -X POST 'https://example.com/api/v1/submissions' \
  -H 'Authorization: Bearer tp_xxxx' \
  -F 'files=@image.jpg' \
  -F 'tags=illustration' \
  -F 'title=Example' \
  -F 'idempotency_key=example:123'

完整接口与字段见 HTTP API。

TelePost 不依赖特定上游程序。RSS、爬虫、CI、自有脚本，以及 PixivFlow 等工具都能通过 HTTP API 接入。

📱 Mini App

Mini App 是可选前端：普通用户投稿、查看自己的投稿；审核员和管理员使用对应的审核与管理功能。

它与 Bot 共用 TelePost 后端和业务流程，不维护独立的数据或审核系统。配置见 Mini App。

🏢 多 Bot 与部署

• 多 Bot：一个进程运行多个相互隔离的 Bot，各自拥有独立的配置、数据目录与 Telegram 入口。
• 部署环境：本地服务器、VPS、Docker、Fly.io 或任何支持 Python / 容器的环境。
• 运行模式：没有公网 HTTPS 时用 Polling；需要接收 Webhook 时用 Webhook 模式。

详见 安装与部署 · 配置参考 · Webhook · Fly.io 部署。

📚 文档

🔗 相关项目

• PixivFlow —— 独立的 Pixiv 内容下载与处理工具，可通过 TelePost HTTP API 投递内容。
• pixivflow-telepost-deploy —— PixivFlow 与 TelePost 的组合部署与工作流配置。

以上均为可选集成，不是 TelePost 的运行依赖。

📄 许可证

MIT License