telepost-bot 2.84.2__tar.gz → 2.84.3__tar.gz

{telepost_bot-2.84.2 → telepost_bot-2.84.3}/CHANGELOG.md

@@ -8,6 +8,15 @@
 > 发布说明面向普通用户：写「对用户有什么改变」，不写内部实现细节（模块名、函数名、配置键）；
 > 技术细节放进代码注释或 `docs/`。每个 Release 的正文由本文件对应版本段自动生成。
 
+## [2.84.3](https://github.com/redtidev1918/TelePost/compare/v2.84.2...v2.84.3) (2026-10-24)
+
+
+### Bug Fixes
+
+* preserve publication uncertainty and prevent unrelated-forward rollback ([cf22cdf](https://github.com/redtidev1918/TelePost/commit/cf22cdf4614cbc3c7df892726f112273548d2b8c))
+* preserve uncertain publication outcomes and reject uncorrelated forwards ([5f7851a](https://github.com/redtidev1918/TelePost/commit/5f7851a15928048e61e4fd4874631b33f7935208))
+* translate uncertainty recovery guidance ([bd47a7f](https://github.com/redtidev1918/TelePost/commit/bd47a7f8009f0819e2b679709d99d3e7c874ffe0))
+
 ## [2.84.2](https://github.com/redtidev1918/TelePost/compare/v2.84.1...v2.84.2) (2026-10-22)
 
 

telepost_bot-2.84.3/PKG-INFO

@@ -0,0 +1,166 @@
+Metadata-Version: 2.4
+Name: telepost-bot
+Version: 2.84.3
+Summary: Telegram submission, review, and publication bot with a Mini App, HTTP API, and multi-bot supervisor.
+Author: redtidev1918
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/redtidev1918/TelePost
+Project-URL: Repository, https://github.com/redtidev1918/TelePost
+Project-URL: Documentation, https://github.com/redtidev1918/TelePost/tree/main/docs
+Project-URL: Issues, https://github.com/redtidev1918/TelePost/issues
+Project-URL: Changelog, https://github.com/redtidev1918/TelePost/blob/main/CHANGELOG.md
+Keywords: telegram,bot,submission,review,publication,miniapp,telepost,moderation
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Environment :: Console
+Classifier: Framework :: AsyncIO
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: System Administrators
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Communications :: Chat
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: python-telegram-bot[job-queue]>=22.8
+Requires-Dist: aiohttp>=3.14.3
+Requires-Dist: python-dotenv>=1.2.3
+Requires-Dist: aiosqlite>=0.22.1
+Requires-Dist: psutil>=5.9.8
+Requires-Dist: Pillow>=10.0.0
+Requires-Dist: pyvips>=2.2.0
+Requires-Dist: whoosh>=2.7.4
+Requires-Dist: init-data-py>=1.0.0
+Requires-Dist: telepress>=0.17.2
+Provides-Extra: mcp
+Requires-Dist: mcp<3,>=2.2; extra == "mcp"
+Provides-Extra: dev
+Requires-Dist: Babel>=2.16.0; extra == "dev"
+Requires-Dist: pytest>=7.4.0; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
+Requires-Dist: pytest-mock>=3.11.0; extra == "dev"
+Requires-Dist: coverage>=7.3.0; extra == "dev"
+Dynamic: license-file
+
+# TelePost
+
+**语言 / Language:** 中文 · [English](https://github.com/redtidev1918/TelePost/blob/main/README.en.md)
+
+TelePost 是开源、自托管的 Telegram 频道投稿与审核 Bot，支持私聊、Mini App 和 HTTP API 投稿。
+用户可上传、预览和编辑内容，管理员可在审核群中处理待审稿件并发布到频道。
+
+[![Release](https://img.shields.io/github/v/release/redtidev1918/TelePost)](https://github.com/redtidev1918/TelePost/releases/latest) [![PyPI](https://img.shields.io/pypi/v/telepost-bot.svg)](https://pypi.org/project/telepost-bot/) [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/redtidev1918/TelePost/blob/main/LICENSE) [![Documentation](https://img.shields.io/badge/docs-redtidev1918.github.io-6366f1)](https://redtidev1918.github.io/TelePost/)
+
+[下载](https://github.com/redtidev1918/TelePost/blob/main/docs/download.md) · [安装与部署](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md) · [完整文档](https://redtidev1918.github.io/TelePost/)
+
+## 主要功能
+
+| 功能 | 说明 |
+| --- | --- |
+| 投稿 | 支持图片、视频、GIF、音频、文档和纯文字，提交前可预览、编辑，支持匿名与剧透。 |
+| 审核与发布 | 在独立审核群中预览、修改、批准或拒绝投稿，支持内容遮罩；可选接入 AI Agent 辅助审核。 |
+| Mini App | 可选网页界面：用户可浏览、投稿和查询状态，管理员可处理审核队列。 |
+| 搜索与热榜 | 关键词与标签搜索、热门内容、个人投稿查询和统计。 |
+| 定时发布 | `/schedule add weekly-hot` 等命令按计划发布热榜内容。 |
+| 自动化投稿 | 提供 HTTP API，供脚本和其他程序提交稿件，支持重复请求保护。 |
+| 重启与恢复 | 投稿和审核状态持久保存，服务重启后可继续处理未完成的审核。 |
+| 多 Bot | 通过统一入口在同一台机器运行多个 Bot，各自使用独立的频道、审核群、语言和数据目录。 |
+
+## 如何工作
+
+<details>
+<summary>查看 Bot 界面</summary>
+
+![Bot 私聊主菜单](https://raw.githubusercontent.com/redtidev1918/TelePost/main/docs/assets/screenshots/bot-menu.jpg)
+
+</details>
+
+用户在 Bot 私聊或 Mini App 上传内容，在预览中确认标签、标题、简介、链接及匿名、剧透设置后提交。
+是否进入审核由投稿入口决定：
+
+| 投稿入口 | 默认行为 |
+| --- | --- |
+| Bot 私聊 | 确认后直接发布；`CHAT_REVIEW_REQUIRED=true` 时先审核 |
+| Mini App | 默认先审核；由 `MINIAPP_REVIEW_REQUIRED` 单独控制 |
+| HTTP API | 固定先提交审核，必须人工批准 |
+
+默认配置需要独立审核群（`REVIEW_CHAT_ID`），且不能与发布频道相同。
+如需私聊投稿也先审核，设置 `CHAT_REVIEW_REQUIRED=true`；Mini App 的审核行为由
+`MINIAPP_REVIEW_REQUIRED` 单独控制。更多设置见[配置参考](https://github.com/redtidev1918/TelePost/blob/main/docs/CONFIGURATION.md#审核)。
+
+## 下载与安装
+
+需要一台可持续运行且能访问 Telegram 的电脑或服务器。仅使用 Bot 时可选 Polling 模式，无需域名；Mini App 需要 Webhook 模式和公网 HTTPS。
+
+选择一种安装方式：
+
+| 方式 | 适用情况 | 入口 |
+| --- | --- | --- |
+| 独立程序 | Windows x64、Linux x64、macOS Apple Silicon；无需安装 Python | [下载最新版程序](https://github.com/redtidev1918/TelePost/releases/latest) |
+| pip | 已有 Python 3.10+ 环境 | `python -m pip install telepost-bot` |
+| Docker / Compose | 服务器或长期部署 | [Docker / Compose 安装](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md#3-docker--compose) |
+
+独立程序下载后加 `--setup` 运行配置向导；pip 安装后执行 `telepost --setup`。
+完整安装、升级与备份步骤见[安装指南](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md)。
+
+## 首次使用
+
+1. **创建 Bot**：在 [@BotFather](https://t.me/BotFather) 创建 Bot 并取得 Token。
+2. **准备频道和审核群**：将 Bot 设为发布频道的管理员并授予发帖权限，再加入一个
+   **独立**的私有审核群，确认 Bot 有发送消息的权限。频道 ID 支持 `@频道用户名` 或
+   `-100` 开头的数字 ID；Owner ID 应填写 Bot 所有者的数字 Telegram User ID，不得填写群或频道 ID。
+3. **补齐配置并启动**：配置向导只收集 Token、频道和 Owner ID，审核群需手动补齐。打开生成的
+   `config.ini`，保留已有内容，在 `[BOT]` 节添加审核群 ID（保存为 UTF-8）：
+
+   ```ini
+   [BOT]
+   REVIEW_CHAT_ID = -1001234567890
+   ```
+
+   将示例 ID 替换为审核群的实际数字 ID。如需私聊投稿也先审核，在同一 `[BOT]` 节追加
+   `CHAT_REVIEW_REQUIRED = true`。Windows 独立程序可双击启动；Linux / macOS 运行对应的
+   `./telepost-linux-x64` 或 `./telepost-macos-arm64`；pip 用 `telepost`。
+   Docker 用户按安装指南配置环境变量，无需运行向导或编辑 `config.ini`。
+4. **发起第一次投稿**：私聊 Bot 发送 `/start`，点击「📝 开始投稿」或发送 `/submit`；
+   上传图片、视频、GIF、音频或文件，完成后发送 `/done_media` 进入预览；纯文字投稿用
+   `/skip_media` 跳过上传。在预览中填写标签和文字内容，确认后点击「✅ 确认发布」
+   （开启聊天审核后为「✅ 提交审核」）。发送 `/cancel` 可取消当前投稿。
+
+全部命令见[命令参考](https://github.com/redtidev1918/TelePost/blob/main/docs/COMMANDS.md)。
+
+## 可选功能
+
+- [Mini App](https://github.com/redtidev1918/TelePost/blob/main/docs/MINIAPP.md)：在 Telegram 内完成网页投稿、进度查询和审核；需配置 HTTPS 地址及登录密钥。
+- [HTTP API](https://github.com/redtidev1918/TelePost/blob/main/docs/API.md)：供脚本和其他程序投稿，支持幂等提交，避免重试产生重复稿件。
+- [AI 辅助审核（MCP）](https://github.com/redtidev1918/TelePost/blob/main/docs/MCP_REVIEW.md)：通过 MCP 连接外部 AI Agent 查看稿件、提供建议。建议使用只读模式；开启写入权限后，程序不强制要求额外的人工确认。
+- [在线阅读](https://github.com/redtidev1918/TelePost/blob/main/docs/CONFIGURATION.md)：可选启用 TelePress，为 TXT 小说生成 Telegraph 阅读页。
+
+## 文档
+
+完整文档站：<https://redtidev1918.github.io/TelePost/>
+
+- 安装、升级与卸载：[安装与部署](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md)
+- 配置项、审核默认值与多 Bot：[配置参考](https://github.com/redtidev1918/TelePost/blob/main/docs/CONFIGURATION.md)
+- 投稿、审核及管理命令：[命令参考](https://github.com/redtidev1918/TelePost/blob/main/docs/COMMANDS.md)
+- 网页投稿与审核界面：[Telegram Mini App](https://github.com/redtidev1918/TelePost/blob/main/docs/MINIAPP.md)
+- 脚本与自动化投稿：[HTTP API](https://github.com/redtidev1918/TelePost/blob/main/docs/API.md)
+- 常见运行问题：[故障排查](https://github.com/redtidev1918/TelePost/blob/main/docs/TROUBLESHOOTING.md)
+- 本地开发、测试与贡献：[贡献指南](https://github.com/redtidev1918/TelePost/blob/main/CONTRIBUTING.md)
+
+Webhook 部署、Fly.io、运维手册与性能容量等文档见[文档站](https://redtidev1918.github.io/TelePost/)。
+
+## 相关项目
+
+- [PixivFlow](https://github.com/redtidev1918/PixivFlow)：按条件检索和收集 Pixiv 作品，提交至 TelePost 审核发布。
+- [TelePress](https://github.com/redtidev1918/TelePress)：为 TXT 小说生成在线阅读页面；库随 TelePost 一并安装，启用在线阅读需另行配置。
+- [pixivflow-telepost-deploy](https://github.com/redtidev1918/pixivflow-telepost-deploy)：在独立服务中部署 PixivFlow 与 TelePost 的指南和工具。
+
+TelePost 可以独立使用，无需部署 PixivFlow 或整套生态。
+
+## 许可证
+
+[MIT License](https://github.com/redtidev1918/TelePost/blob/main/LICENSE)

telepost_bot-2.84.3/README.en.md

@@ -0,0 +1,130 @@
+# TelePost
+
+**Language / 语言:** [中文](https://github.com/redtidev1918/TelePost/blob/main/README.md) · English
+
+TelePost is an open-source, self-hosted submission and moderation bot for Telegram channels.
+It accepts submissions through private chat, a Mini App and an HTTP API. Users can upload, preview
+and edit content; administrators can review pending submissions and publish them to a channel.
+
+[![Release](https://img.shields.io/github/v/release/redtidev1918/TelePost)](https://github.com/redtidev1918/TelePost/releases/latest) [![PyPI](https://img.shields.io/pypi/v/telepost-bot.svg)](https://pypi.org/project/telepost-bot/) [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/redtidev1918/TelePost/blob/main/LICENSE) [![Documentation](https://img.shields.io/badge/docs-redtidev1918.github.io-6366f1)](https://redtidev1918.github.io/TelePost/#/en/)
+
+[Download](https://github.com/redtidev1918/TelePost/blob/main/docs/en/download.md) · [Install and deploy](https://github.com/redtidev1918/TelePost/blob/main/docs/en/INSTALL.md) · [Documentation](https://redtidev1918.github.io/TelePost/#/en/)
+
+## What it does
+
+| Feature | Description |
+| --- | --- |
+| Submissions | Photos, videos, GIFs, audio, documents and plain text; preview and edit before submitting, with anonymous and spoiler modes. |
+| Review and publishing | Preview, revise, approve or reject submissions in a separate review group, with content masking; optionally connect an AI agent for review suggestions. |
+| Mini App | Optional web interface: users browse, submit and track their work; admins handle the review queue. |
+| Search and rankings | Keyword and tag search, popular content, personal submission history and statistics. |
+| Scheduled posts | Commands such as `/schedule add weekly-hot` publish rankings on a schedule. |
+| Automated submissions | An HTTP API for scripts and other programs, with protection against duplicate submissions on retries. |
+| Restart and recovery | Submission and review state is persisted; pending reviews continue after a restart. |
+| Multiple bots | Run several bots on one machine through a single entry point, each with its own channel, review group, language and data directory. |
+
+## How it works
+
+<details>
+<summary>View the bot interface</summary>
+
+![Bot private-chat main menu](https://raw.githubusercontent.com/redtidev1918/TelePost/main/docs/assets/screenshots/bot-menu.jpg)
+
+</details>
+
+A reader uploads content in the bot's private chat or the Mini App, then confirms tags, title, note,
+link and the anonymous and spoiler settings in the preview before submitting. Whether it goes
+through review depends on the entry point:
+
+| Entry point | Default |
+| --- | --- |
+| Bot private chat | Published after the reader confirms; `CHAT_REVIEW_REQUIRED=true` requires review |
+| Mini App | Review by default; controlled separately by `MINIAPP_REVIEW_REQUIRED` |
+| HTTP API | Always submitted for review; a human must approve |
+
+The default setup requires a review group (`REVIEW_CHAT_ID`) separate from the publishing channel.
+To review private-chat submissions too, set `CHAT_REVIEW_REQUIRED=true`; the Mini App is controlled
+separately by `MINIAPP_REVIEW_REQUIRED`. More settings are in
+[Configuration](https://github.com/redtidev1918/TelePost/blob/main/docs/en/CONFIGURATION.md#review).
+
+## Download and install
+
+Use a computer or server that can remain running and access Telegram. Bot-only use supports Polling without a domain. The Mini App requires Webhook mode and public HTTPS.
+
+Choose one installation method:
+
+| Method | Suitable for | Getting started |
+| --- | --- | --- |
+| Standalone program | Windows x64, Linux x64, macOS Apple Silicon; no Python needed | [Download the latest build](https://github.com/redtidev1918/TelePost/releases/latest) |
+| pip | Python 3.10+ already installed | `python -m pip install telepost-bot` |
+| Docker / Compose | Servers and long-running deployments | [Docker / Compose installation](https://github.com/redtidev1918/TelePost/blob/main/docs/en/INSTALL.md#3-docker--compose) |
+
+Run the standalone program with `--setup` to open the configuration wizard. For pip, run `telepost --setup`.
+See the [Installation guide](https://github.com/redtidev1918/TelePost/blob/main/docs/en/INSTALL.md) for full setup, upgrade and backup instructions.
+
+## First run
+
+1. **Create the bot**: Create it with [@BotFather](https://t.me/BotFather) and keep the token.
+2. **Prepare the channel and review group**: Add the bot to the publishing channel as an
+   administrator with permission to post, then add it to a **separate** private review group and
+   check that it can send messages there. The channel ID is either `@username` or a numeric ID
+   starting with `-100`; the owner ID is your own numeric Telegram user ID, not a group or channel
+   ID.
+3. **Complete the configuration and start**: The setup wizard collects only the token, the channel
+   and the owner ID; the review group is added by hand. Open the generated `config.ini`, keep what
+   is there, and add the review group under `[BOT]` (save the file as UTF-8):
+
+   ```ini
+   [BOT]
+   LANGUAGE = en
+   REVIEW_CHAT_ID = -1001234567890
+   ```
+
+   Replace the example ID with your review group's numeric ID. To review private-chat submissions
+   too, add `CHAT_REVIEW_REQUIRED = true` under the same `[BOT]` section. Start commands:
+   double-click the Windows standalone program, or run `./telepost-linux-x64` /
+   `./telepost-macos-arm64` on Linux / macOS; `telepost` for pip. Docker users configure
+   environment variables as described in the installation guide; no wizard or `config.ini` is required.
+4. **Make a first submission**: Send `/start` to the bot, tap **📝 New submission** or send
+   `/submit`, then upload photos, videos, GIFs, audio or files and send `/done_media` when done to
+   reach the preview; for a text-only submission, `/skip_media` skips the upload. Fill in tags and
+   text, adjust what you need, and tap **✅ Publish** (the button reads **✅ Submit for review**
+   when chat review is on). Send `/cancel` at any point to cancel.
+
+All commands: [Command reference](https://github.com/redtidev1918/TelePost/blob/main/docs/en/COMMANDS.md).
+
+## Optional features
+
+- [Mini App](https://github.com/redtidev1918/TelePost/blob/main/docs/MINIAPP.md) (Chinese): submit, track and review content inside Telegram. Requires an HTTPS address and a session secret.
+- [HTTP API](https://github.com/redtidev1918/TelePost/blob/main/docs/en/API.md): accept submissions from scripts and services, with idempotent submissions to prevent duplicates on retries.
+- [AI-assisted review (MCP)](https://github.com/redtidev1918/TelePost/blob/main/docs/MCP_REVIEW.md) (Chinese): connect an external AI agent through MCP to inspect submissions and suggest decisions. Read-only mode is recommended; with write access enabled, the program does not enforce additional human confirmation.
+- [Online reading](https://github.com/redtidev1918/TelePost/blob/main/docs/en/CONFIGURATION.md): optionally enable TelePress to generate Telegraph reading pages for TXT novels.
+
+## Documentation
+
+Documentation site: <https://redtidev1918.github.io/TelePost/#/en/>
+
+- Install, upgrade, remove: [Install and deploy](https://github.com/redtidev1918/TelePost/blob/main/docs/en/INSTALL.md)
+- Settings, review defaults, multiple bots: [Configuration](https://github.com/redtidev1918/TelePost/blob/main/docs/en/CONFIGURATION.md)
+- Commands and required permissions: [Command reference](https://github.com/redtidev1918/TelePost/blob/main/docs/en/COMMANDS.md)
+- Web submission and review UI: [Telegram Mini App](https://github.com/redtidev1918/TelePost/blob/main/docs/MINIAPP.md) (Chinese)
+- Scripts and automated submissions: [HTTP API](https://github.com/redtidev1918/TelePost/blob/main/docs/en/API.md)
+- Common runtime problems: [Troubleshooting](https://github.com/redtidev1918/TelePost/blob/main/docs/TROUBLESHOOTING.md) (Chinese)
+- Local development, testing and contributing: [Contributing](https://github.com/redtidev1918/TelePost/blob/main/CONTRIBUTING.md) (Chinese)
+
+Webhook deployment, Fly.io, operations and performance guides are on the
+[documentation site](https://redtidev1918.github.io/TelePost/#/en/).
+
+## Related projects
+
+- [PixivFlow](https://github.com/redtidev1918/PixivFlow): find and collect Pixiv works matching your
+  filters, then send them to TelePost for review and publishing.
+- [TelePress](https://github.com/redtidev1918/TelePress): generate online reading pages for TXT novels; the library ships with TelePost, and online reading must be enabled separately.
+- [pixivflow-telepost-deploy](https://github.com/redtidev1918/pixivflow-telepost-deploy): guides and
+  tools for deploying PixivFlow and TelePost as separate services.
+
+TelePost works independently; deploying PixivFlow or the full ecosystem is optional.
+
+## License
+
+[MIT License](https://github.com/redtidev1918/TelePost/blob/main/LICENSE)

telepost_bot-2.84.3/README.md

@@ -0,0 +1,118 @@
+# TelePost
+
+**语言 / Language:** 中文 · [English](https://github.com/redtidev1918/TelePost/blob/main/README.en.md)
+
+TelePost 是开源、自托管的 Telegram 频道投稿与审核 Bot，支持私聊、Mini App 和 HTTP API 投稿。
+用户可上传、预览和编辑内容，管理员可在审核群中处理待审稿件并发布到频道。
+
+[![Release](https://img.shields.io/github/v/release/redtidev1918/TelePost)](https://github.com/redtidev1918/TelePost/releases/latest) [![PyPI](https://img.shields.io/pypi/v/telepost-bot.svg)](https://pypi.org/project/telepost-bot/) [![Python](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/) [![License](https://img.shields.io/badge/license-MIT-blue.svg)](https://github.com/redtidev1918/TelePost/blob/main/LICENSE) [![Documentation](https://img.shields.io/badge/docs-redtidev1918.github.io-6366f1)](https://redtidev1918.github.io/TelePost/)
+
+[下载](https://github.com/redtidev1918/TelePost/blob/main/docs/download.md) · [安装与部署](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md) · [完整文档](https://redtidev1918.github.io/TelePost/)
+
+## 主要功能
+
+| 功能 | 说明 |
+| --- | --- |
+| 投稿 | 支持图片、视频、GIF、音频、文档和纯文字，提交前可预览、编辑，支持匿名与剧透。 |
+| 审核与发布 | 在独立审核群中预览、修改、批准或拒绝投稿，支持内容遮罩；可选接入 AI Agent 辅助审核。 |
+| Mini App | 可选网页界面：用户可浏览、投稿和查询状态，管理员可处理审核队列。 |
+| 搜索与热榜 | 关键词与标签搜索、热门内容、个人投稿查询和统计。 |
+| 定时发布 | `/schedule add weekly-hot` 等命令按计划发布热榜内容。 |
+| 自动化投稿 | 提供 HTTP API，供脚本和其他程序提交稿件，支持重复请求保护。 |
+| 重启与恢复 | 投稿和审核状态持久保存，服务重启后可继续处理未完成的审核。 |
+| 多 Bot | 通过统一入口在同一台机器运行多个 Bot，各自使用独立的频道、审核群、语言和数据目录。 |
+
+## 如何工作
+
+<details>
+<summary>查看 Bot 界面</summary>
+
+![Bot 私聊主菜单](https://raw.githubusercontent.com/redtidev1918/TelePost/main/docs/assets/screenshots/bot-menu.jpg)
+
+</details>
+
+用户在 Bot 私聊或 Mini App 上传内容，在预览中确认标签、标题、简介、链接及匿名、剧透设置后提交。
+是否进入审核由投稿入口决定：
+
+| 投稿入口 | 默认行为 |
+| --- | --- |
+| Bot 私聊 | 确认后直接发布；`CHAT_REVIEW_REQUIRED=true` 时先审核 |
+| Mini App | 默认先审核；由 `MINIAPP_REVIEW_REQUIRED` 单独控制 |
+| HTTP API | 固定先提交审核，必须人工批准 |
+
+默认配置需要独立审核群（`REVIEW_CHAT_ID`），且不能与发布频道相同。
+如需私聊投稿也先审核，设置 `CHAT_REVIEW_REQUIRED=true`；Mini App 的审核行为由
+`MINIAPP_REVIEW_REQUIRED` 单独控制。更多设置见[配置参考](https://github.com/redtidev1918/TelePost/blob/main/docs/CONFIGURATION.md#审核)。
+
+## 下载与安装
+
+需要一台可持续运行且能访问 Telegram 的电脑或服务器。仅使用 Bot 时可选 Polling 模式，无需域名；Mini App 需要 Webhook 模式和公网 HTTPS。
+
+选择一种安装方式：
+
+| 方式 | 适用情况 | 入口 |
+| --- | --- | --- |
+| 独立程序 | Windows x64、Linux x64、macOS Apple Silicon；无需安装 Python | [下载最新版程序](https://github.com/redtidev1918/TelePost/releases/latest) |
+| pip | 已有 Python 3.10+ 环境 | `python -m pip install telepost-bot` |
+| Docker / Compose | 服务器或长期部署 | [Docker / Compose 安装](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md#3-docker--compose) |
+
+独立程序下载后加 `--setup` 运行配置向导；pip 安装后执行 `telepost --setup`。
+完整安装、升级与备份步骤见[安装指南](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md)。
+
+## 首次使用
+
+1. **创建 Bot**：在 [@BotFather](https://t.me/BotFather) 创建 Bot 并取得 Token。
+2. **准备频道和审核群**：将 Bot 设为发布频道的管理员并授予发帖权限，再加入一个
+   **独立**的私有审核群，确认 Bot 有发送消息的权限。频道 ID 支持 `@频道用户名` 或
+   `-100` 开头的数字 ID；Owner ID 应填写 Bot 所有者的数字 Telegram User ID，不得填写群或频道 ID。
+3. **补齐配置并启动**：配置向导只收集 Token、频道和 Owner ID，审核群需手动补齐。打开生成的
+   `config.ini`，保留已有内容，在 `[BOT]` 节添加审核群 ID（保存为 UTF-8）：
+
+   ```ini
+   [BOT]
+   REVIEW_CHAT_ID = -1001234567890
+   ```
+
+   将示例 ID 替换为审核群的实际数字 ID。如需私聊投稿也先审核，在同一 `[BOT]` 节追加
+   `CHAT_REVIEW_REQUIRED = true`。Windows 独立程序可双击启动；Linux / macOS 运行对应的
+   `./telepost-linux-x64` 或 `./telepost-macos-arm64`；pip 用 `telepost`。
+   Docker 用户按安装指南配置环境变量，无需运行向导或编辑 `config.ini`。
+4. **发起第一次投稿**：私聊 Bot 发送 `/start`，点击「📝 开始投稿」或发送 `/submit`；
+   上传图片、视频、GIF、音频或文件，完成后发送 `/done_media` 进入预览；纯文字投稿用
+   `/skip_media` 跳过上传。在预览中填写标签和文字内容，确认后点击「✅ 确认发布」
+   （开启聊天审核后为「✅ 提交审核」）。发送 `/cancel` 可取消当前投稿。
+
+全部命令见[命令参考](https://github.com/redtidev1918/TelePost/blob/main/docs/COMMANDS.md)。
+
+## 可选功能
+
+- [Mini App](https://github.com/redtidev1918/TelePost/blob/main/docs/MINIAPP.md)：在 Telegram 内完成网页投稿、进度查询和审核；需配置 HTTPS 地址及登录密钥。
+- [HTTP API](https://github.com/redtidev1918/TelePost/blob/main/docs/API.md)：供脚本和其他程序投稿，支持幂等提交，避免重试产生重复稿件。
+- [AI 辅助审核（MCP）](https://github.com/redtidev1918/TelePost/blob/main/docs/MCP_REVIEW.md)：通过 MCP 连接外部 AI Agent 查看稿件、提供建议。建议使用只读模式；开启写入权限后，程序不强制要求额外的人工确认。
+- [在线阅读](https://github.com/redtidev1918/TelePost/blob/main/docs/CONFIGURATION.md)：可选启用 TelePress，为 TXT 小说生成 Telegraph 阅读页。
+
+## 文档
+
+完整文档站：<https://redtidev1918.github.io/TelePost/>
+
+- 安装、升级与卸载：[安装与部署](https://github.com/redtidev1918/TelePost/blob/main/docs/INSTALL.md)
+- 配置项、审核默认值与多 Bot：[配置参考](https://github.com/redtidev1918/TelePost/blob/main/docs/CONFIGURATION.md)
+- 投稿、审核及管理命令：[命令参考](https://github.com/redtidev1918/TelePost/blob/main/docs/COMMANDS.md)
+- 网页投稿与审核界面：[Telegram Mini App](https://github.com/redtidev1918/TelePost/blob/main/docs/MINIAPP.md)
+- 脚本与自动化投稿：[HTTP API](https://github.com/redtidev1918/TelePost/blob/main/docs/API.md)
+- 常见运行问题：[故障排查](https://github.com/redtidev1918/TelePost/blob/main/docs/TROUBLESHOOTING.md)
+- 本地开发、测试与贡献：[贡献指南](https://github.com/redtidev1918/TelePost/blob/main/CONTRIBUTING.md)
+
+Webhook 部署、Fly.io、运维手册与性能容量等文档见[文档站](https://redtidev1918.github.io/TelePost/)。
+
+## 相关项目
+
+- [PixivFlow](https://github.com/redtidev1918/PixivFlow)：按条件检索和收集 Pixiv 作品，提交至 TelePost 审核发布。
+- [TelePress](https://github.com/redtidev1918/TelePress)：为 TXT 小说生成在线阅读页面；库随 TelePost 一并安装，启用在线阅读需另行配置。
+- [pixivflow-telepost-deploy](https://github.com/redtidev1918/pixivflow-telepost-deploy)：在独立服务中部署 PixivFlow 与 TelePost 的指南和工具。
+
+TelePost 可以独立使用，无需部署 PixivFlow 或整套生态。
+
+## 许可证
+
+[MIT License](https://github.com/redtidev1918/TelePost/blob/main/LICENSE)

{telepost_bot-2.84.2 → telepost_bot-2.84.3}/services/review_service.py

@@ -869,7 +869,7 @@ class ReviewService:
         if isinstance(error, DiscussionPublishError):
             if getattr(error, "uncertain", False):
                 return (
-                    tr('评论区发布结果不确定：请到频道确认首贴、到该帖评论串确认图片是否齐；确认缺图后再点重试（重试只补发，重复请手动删多余相册）')
+                    tr('发布结果不确定，已阻止自动重发；请管理员核验频道与发布账本后恢复。')
                 )
             return tr('发布失败，已自动重试一次仍未成功，可再点重试')
         if isinstance(error, NetworkError):

{telepost_bot-2.84.2 → telepost_bot-2.84.3}/telepost/build_info.py

@@ -8,7 +8,7 @@ to the entry points; when present it overrides these committed defaults.
 # Bumped automatically by release-please (extra-files in
 # release-please-config.json). Release bundles and images override it at build
 # time with the exact version/commit; this constant is the local-dev fallback.
-RELEASE_VERSION = "2.84.2"  # x-release-please-version
+RELEASE_VERSION = "2.84.3"  # x-release-please-version
 RELEASE_COMMIT = "dev"
 BUILD_DATE = "dev"
 SERVICE = "telepost"

{telepost_bot-2.84.2 → telepost_bot-2.84.3}/telepost/telegram/delivery/discussion.py

@@ -11,9 +11,9 @@ Workflow (previously embedded in ``handlers/publish._deliver_discussion``):
    exist; never blindly retry a request whose response was lost (that could
    duplicate an album Telegram actually accepted).
 
-Determinate failures are rolled back and retried exactly once. An
-*uncertain* failure (response lost after the comment album was sent) rolls
-back whatever is known and stops: a human must verify the channel/discussion.
+Determinate root failures with no confirmed progress are retried once.
+An uncertain root stops without deletion or resend and preserves checkpoints
+for the publication ledger. Confirmed roots survive discussion failures.
 """
 from __future__ import annotations
 
@@ -47,9 +47,10 @@ class DiscussionDeliveryError(RuntimeError):
     """
 
     def __init__(self, message: str, *, uncertain: bool = False,
-                 sent: Optional[dict] = None):
+                 sent: Optional[dict] = None, known_messages=None):
         super().__init__(message)
         self.uncertain = uncertain
+        self.known_messages = list(known_messages or [])
         self.sent = sent if sent is not None else {"cover": [], "anchor": [], "rest": []}
 
 
@@ -161,18 +162,22 @@ class DiscussionStrategy:
             )
         )
         if cover_result.is_uncertain:
-            found = await self._scan(int(request.chat_id))
-            if found is not None:
-                cover_id, dchat, dmsg = found
-                sent["cover"] = [(int(request.chat_id), cover_id)]
-                sent["anchor"] = [(dchat, dmsg)]
-                raise DiscussionDeliveryError(
-                    "频道首贴发送响应丢失，已反查到帖子并回滚", sent=sent
-                )
+            # A recent forward from this channel is not evidence for this
+            # publication. Preserve uncertainty and confirmed checkpoints;
+            # never delete or resend based on a channel-only cache match.
+            logger.warning("Channel root delivery uncertain: channel=%s reason=%s error_type=%s",
+                           request.chat_id, cover_result.reason,
+                           type(cover_result.error).__name__)
             raise DiscussionDeliveryError(
-                "频道首贴发送响应丢失，未在讨论区发现转发，重发一次", sent=sent
-            )
+                "频道首贴发送结果不确定，未自动重发或回滚；请先核验频道",
+                uncertain=True, known_messages=cover_result.known_messages,
+            ) from (cover_result.error if isinstance(cover_result.error, BaseException) else None)
         if not cover_result.ok:
+            if cover_result.known_messages:
+                raise DiscussionDeliveryError(
+                    f"频道首贴部分送达，需核验后恢复：{cover_result.reason}",
+                    uncertain=True, known_messages=cover_result.known_messages,
+                )
             raise DiscussionDeliveryError(
                 f"频道首贴发送失败：{cover_result.reason}", sent=sent
             )
@@ -316,7 +321,6 @@ class DiscussionStrategy:
             except DiscussionDeliveryError as exc:
                 last = exc
                 if exc.uncertain:
-                    await self._do_rollback(exc.sent)
                     raise
                 if not await self._do_rollback(exc.sent):
                     raise DiscussionDeliveryError(

{telepost_bot-2.84.2 → telepost_bot-2.84.3}/telepost/telegram/delivery/gateway.py

@@ -104,4 +104,10 @@ class PTBTelegramDeliveryGateway:
         strategy = self._discussion or discussion_mod.DiscussionStrategy(
             self, self._bot
         )
-        return await strategy.deliver(request)
+        try:
+            return await strategy.deliver(request)
+        except discussion_mod.DiscussionDeliveryError as exc:
+            factory = DeliveryResult.uncertain if exc.uncertain else DeliveryResult.failed
+            result = factory(str(exc), known_messages=exc.known_messages)
+            result.error = exc
+            return result

{telepost_bot-2.84.2 → telepost_bot-2.84.3}/telepost/telegram/delivery/registry.py

@@ -1,10 +1,8 @@
 """In-memory registry of channel→discussion automatic forwards.
 
 ``capture_discussion_forward`` is fed every Telegram update by the channel
-listener. When the channel cover post is sent but the HTTP response is lost,
-the delivery strategy scans this bounded registry to discover whether Telegram
-actually accepted the post (and auto-forwarded it to the linked discussion),
-which makes a safe rollback + retry possible.
+listener. It correlates a confirmed channel message ID to its discussion
+anchor. It cannot identify a publication whose send response was lost.
 
 Deliberately a bounded process-local structure: at most ~200 entries / 60 s of
 history, matching the uncertainty window. No external cache is introduced.
@@ -90,18 +88,22 @@ class ForwardRegistry:
                 self._waiters.pop(key, None)
 
     async def scan_recent(self, channel_id: int, *,
+                          message_id: Optional[int] = None,
                           deadline_seconds: float = 6.0,
                           interval: float = 1.0) -> Optional[Tuple[int, int, int]]:
-        """Poll recent forwards after a cover-post response loss.
+        """Look up an already-confirmed channel message, never guess its ID.
 
-        Returns ``(source_message_id, discussion_chat_id, discussion_message_id)``
-        for the newest forward from this channel, or ``None`` on timeout.
+        Missing message identity cannot establish publication success. The
+        returned forward is only a discussion anchor, not delivery evidence.
         """
+        if message_id is None:
+            return None
         deadline = self._now() + deadline_seconds
         while self._now() < deadline:
+            self._prune()
             for i in range(len(self._recent) - 1, -1, -1):
                 cid, mid, dchat, dmsg, _t = self._recent[i]
-                if cid == channel_id:
+                if cid == channel_id and mid == message_id:
                     self._recent.pop(i)
                     return mid, dchat, dmsg
             await asyncio.sleep(interval)

{telepost_bot-2.84.2 → telepost_bot-2.84.3}/telepost/telegram/delivery/sender.py

@@ -204,7 +204,7 @@ class PTBSender:
     async def send_album(self, batch: Batch, *, reply_to: Optional[int],
                          caption: Optional[str],
                          reply_markup: Optional[object] = None) -> List[DeliveredMessage]:
-        from telegram.error import NetworkError
+        from telegram.error import BadRequest, NetworkError
 
         media_group = [
             self._input_media(item, caption if i == 0 else None)
@@ -219,6 +219,10 @@ class PTBSender:
         try:
             try:
                 messages = await self._bot.send_media_group(**kwargs)
+            except BadRequest:
+                # PTB BadRequest subclasses NetworkError, but is an explicit
+                # Telegram rejection, not a lost response.
+                raise
             except NetworkError as exc:
                 raise NetworkFailure(str(exc), original=exc) from exc
             finally:
@@ -235,7 +239,7 @@ class PTBSender:
     async def send_single(self, item: MediaItem, *, reply_to: Optional[int],
                           caption: Optional[str],
                           reply_markup: Optional[object] = None) -> DeliveredMessage:
-        from telegram.error import NetworkError
+        from telegram.error import BadRequest, NetworkError
 
         kw = self._single_kwargs(item, caption, reply_markup)
         method_name = kw.pop("method")
@@ -248,6 +252,8 @@ class PTBSender:
                     **self._timeouts,
                     **kw,
                 )
+            except BadRequest:
+                raise
             except NetworkError as exc:
                 raise NetworkFailure(str(exc), original=exc) from exc
         finally: