telepost-bot 2.78.0__tar.gz

telepost_bot-2.78.0/CHANGELOG.md

@@ -0,0 +1,2273 @@
+# 更新日志
+
+所有重要的项目更改都会记录在此文件中。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+本项目遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+> 发布说明面向普通用户：写「对用户有什么改变」，不写内部实现细节（模块名、函数名、配置键）；
+> 技术细节放进代码注释或 `docs/`。每个 Release 的正文由本文件对应版本段自动生成。
+
+## [2.78.0](https://github.com/redtidev1918/TelePost/compare/v2.77.0...v2.78.0) (2026-10-03)
+
+
+### Features
+
+* add PyPI distribution packaging and CI publish workflow ([9ed57ef](https://github.com/redtidev1918/TelePost/commit/9ed57efd54416b1fba44f7808e76561f663c5b7a))
+
+## [2.77.0](https://github.com/redtidev1918/TelePost/compare/v2.76.2...v2.77.0) (2026-10-03)
+
+
+### Features
+
+* **channel:** show online reading as a channel-root inline button ([#289](https://github.com/redtidev1918/TelePost/issues/289)) ([a1f476a](https://github.com/redtidev1918/TelePost/commit/a1f476a2429dcec5069b62232659d8879fc1141c))
+
+## [2.76.2](https://github.com/redtidev1918/TelePost/compare/v2.76.1...v2.76.2) (2026-10-02)
+
+
+### Bug Fixes
+
+* **deps:** bump telepress to 0.16.4 ([#286](https://github.com/redtidev1918/TelePost/issues/286)) ([d7582a3](https://github.com/redtidev1918/TelePost/commit/d7582a38f700ffd2c998861bd30ef479ff3db897))
+
+## [2.76.1](https://github.com/redtidev1918/TelePost/compare/v2.76.0...v2.76.1) (2026-10-02)
+
+
+### Bug Fixes
+
+* **channel:** keep single-novel root caption while deduping read-online entrance ([#283](https://github.com/redtidev1918/TelePost/issues/283)) ([aef75a6](https://github.com/redtidev1918/TelePost/commit/aef75a6e6f46568a46c39f2dffe3611874fb20b7))
+
+## [2.76.0](https://github.com/redtidev1918/TelePost/compare/v2.75.0...v2.76.0) (2026-10-02)
+
+
+### Features
+
+* **channel:** read-online Instant View preview via trailing text bare link ([#279](https://github.com/redtidev1918/TelePost/issues/279)) ([0668ad8](https://github.com/redtidev1918/TelePost/commit/0668ad8b7d3501116da1e2e051499348cafc7c93))
+
+## [2.75.0](https://github.com/redtidev1918/TelePost/compare/v2.74.0...v2.75.0) (2026-10-02)
+
+
+### Features
+
+* **api:** source-neutral work_id with deprecated pixiv_id alias ([#275](https://github.com/redtidev1918/TelePost/issues/275)) ([ff05b1d](https://github.com/redtidev1918/TelePost/commit/ff05b1d2bf85624a9218fe5b0261a3a219975b2e))
+
+## [2.74.0](https://github.com/redtidev1918/TelePost/compare/v2.73.12...v2.74.0) (2026-10-02)
+
+
+### Features
+
+* **miniapp:** explain empty review queue with recent terminal records ([#273](https://github.com/redtidev1918/TelePost/issues/273)) ([5a74282](https://github.com/redtidev1918/TelePost/commit/5a74282264feb9ddbc2a3a151d8a67c503f64a80))
+
+## [2.73.12](https://github.com/redtidev1918/TelePost/compare/v2.73.11...v2.73.12) (2026-10-02)
+
+
+### Bug Fixes
+
+* **preview:** bridge TelePost media-proxy config into in-process TelePress ([#269](https://github.com/redtidev1918/TelePost/issues/269)) ([588a1fa](https://github.com/redtidev1918/TelePost/commit/588a1faf2954157624eab20d452f4cdb422d1d17))
+
+## [2.73.11](https://github.com/redtidev1918/TelePost/compare/v2.73.10...v2.73.11) (2026-10-02)
+
+
+### Bug Fixes
+
+* **api:** report real per-bot release version for dual-bot diagnostics ([2620e8e](https://github.com/redtidev1918/TelePost/commit/2620e8e502ddcba46fe73e550194917408798e29))
+
+## [2.73.10](https://github.com/redtidev1918/TelePost/compare/v2.73.9...v2.73.10) (2026-10-01)
+
+
+### Bug Fixes
+
+* **miniapp:** restore Bot entry capability and reviewer history surface ([654d76e](https://github.com/redtidev1918/TelePost/commit/654d76e61f16933acdc7c90779d7b32326509612))
+
+## [2.73.9](https://github.com/redtidev1918/TelePost/compare/v2.73.8...v2.73.9) (2026-10-01)
+
+
+### Bug Fixes
+
+* **review:** pace review-group preview re-mask edits to avoid Telegram flood control ([49898f0](https://github.com/redtidev1918/TelePost/commit/49898f004cbef331d14a3f5632a9868df2d95d2a))
+
+## [2.73.8](https://github.com/redtidev1918/TelePost/compare/v2.73.7...v2.73.8) (2026-10-01)
+
+
+### Bug Fixes
+
+* **review:** return real channel link on duplicate publish echo; add publish/spoiler diagnostics ([1fe1163](https://github.com/redtidev1918/TelePost/commit/1fe116321252e61ef0334f64a3d4693923bd2619))
+
+## [2.73.7](https://github.com/redtidev1918/TelePost/compare/v2.73.6...v2.73.7) (2026-10-01)
+
+
+### Bug Fixes
+
+* **miniapp:** restore authenticated Mini App entry architecture ([6356221](https://github.com/redtidev1918/TelePost/commit/63562218e338be749775ad2e374af4c9e301c9a9))
+
+## [2.73.4](https://github.com/redtidev1918/TelePost/compare/v2.73.3...v2.73.4) (2026-09-30)
+
+
+### Bug Fixes
+
+* **miniapp:** never lock outside_telegram on a delayed Telegram bridge ([1c2dca3](https://github.com/redtidev1918/TelePost/commit/1c2dca32e11e667f19f1ef8066a2824663a8d728))
+
+## [2.73.3](https://github.com/redtidev1918/TelePost/compare/v2.73.2...v2.73.3) (2026-09-30)
+
+
+### Bug Fixes
+
+* **media:** preserve originals conditionally, count visible review media ([#260](https://github.com/redtidev1918/TelePost/issues/260)) ([6e43939](https://github.com/redtidev1918/TelePost/commit/6e439397779b37343bf6b4494eb48632e5d015f0))
+
+## [2.73.2](https://github.com/redtidev1918/TelePost/compare/v2.73.1...v2.73.2) (2026-09-30)
+
+
+### Bug Fixes
+
+* **media:** preserve originals when using supplied previews ([2fb57c3](https://github.com/redtidev1918/TelePost/commit/2fb57c34f9b96aa62207034ed75b8a7e6108cfd2))
+* **media:** preserve originals when using supplied previews ([5490db6](https://github.com/redtidev1918/TelePost/commit/5490db628d8175d2bd0d783b2de79ae56fd83eb5))
+
+## [2.73.1](https://github.com/redtidev1918/TelePost/compare/v2.73.0...v2.73.1) (2026-09-30)
+
+
+### Bug Fixes
+
+* **media:** stream oversized page downscale via libvips to avoid OOM ([#252](https://github.com/redtidev1918/TelePost/issues/252)) ([3fbb1c9](https://github.com/redtidev1918/TelePost/commit/3fbb1c9881c63f73d1b8c336e59644af6cd0dc59))
+
+## [2.73.0](https://github.com/redtidev1918/TelePost/compare/v2.72.0...v2.73.0) (2026-09-30)
+
+
+### Features
+
+* **review:** 新增 POST /api/v1/reviews/{id}/rerender 重新渲染审核卡 ([#250](https://github.com/redtidev1918/TelePost/issues/250)) ([ef13777](https://github.com/redtidev1918/TelePost/commit/ef137772e5ba517892da063f8e3738f65a89b83b))
+
+## [2.72.0](https://github.com/redtidev1918/TelePost/compare/v2.71.5...v2.72.0) (2026-09-30)
+
+
+### Features
+
+* **delivery,review:** 漫画大图不再重复为文档 + 保留原图标注「原图」 ([c533c37](https://github.com/redtidev1918/TelePost/commit/c533c37cee83b86f4a11eb7192bb32bfb21d0c1d))
+* **delivery:** 解码内存预算改为容量感知且完全环境变量可配 ([e885279](https://github.com/redtidev1918/TelePost/commit/e885279b00144d953bc600ee200a7c25060c18e9))
+* **review:** 审核卡标注保留原图并格式化文件计数 ([1debf6b](https://github.com/redtidev1918/TelePost/commit/1debf6bcf95874f4c56a1aca7b64160a0b5f8dec))
+
+## [2.71.5](https://github.com/redtidev1918/TelePost/compare/v2.71.4...v2.71.5) (2026-09-29)
+
+> 本次只含缺陷修复，两端协议保持兼容，无需强制升级执行端。
+
+
+### Bug Fixes
+
+* **审核队列:** 点审核卡片上的「🔇 遮罩」按钮后，如果审核群里按钮文字的刷新失败（例如审核群被移走或消息过旧），此前虽然遮罩已经立即在画面上生效，但按钮可能停在未更新的文字且没有提示；这次修复会在刷新失败时向审核人弹出一条可见提醒，说明遮罩状态实际已切换，避免按钮文字与实际状态不符而误判 ([a1ed4f7](https://github.com/redtidev1918/TelePost/commit/a1ed4f7ae8f7da9ce17b775f7aa397a069c47bb5))
+
+---
+
+## [2.71.4](https://github.com/redtidev1918/TelePost/compare/v2.71.3...v2.71.4) (2026-09-28)
+
+> 本次只含缺陷修复，两端协议保持兼容，无需强制升级执行端。
+
+
+### Bug Fixes
+
+* **审核队列:** 点审核卡片上的「🔇 遮罩」按钮时，审核群里已经发出去的图片现在会立即上遮罩（再点一次立即撤下）——此前只改了按钮文字，画面上的图并不会立刻被遮住，要等下次重发才会生效；这次修复让遮罩切换即时作用于审核群里已发送的照片/视频/动图 ([ed64c3e](https://github.com/redtidev1918/TelePost/commit/ed64c3ea3a218eb56035e5e7d8be6b28aed9d5ea))
+
+---
+
+## [2.71.3](https://github.com/redtidev1918/TelePost/compare/v2.71.2...v2.71.3) (2026-09-28)
+
+> 本次只含缺陷修复与重抓卡片状态调整，两端协议保持兼容，无需强制升级执行端。
+
+
+### Bug Fixes
+
+* **审核队列:** 「重抓」提交时的能力协商不再受 10 秒状态读预算限制——审核员点「重抓」会唤醒一台停机的执行端（冷启动实测约 10.2 秒），此前用 10 秒预算去等它会把一次合法的重抓误判成失败（审核 #142）；现在提交路径用独立的宽裕预算，状态轮询仍保持 10 秒紧凑预算，不会拖慢 ([f36112a](https://github.com/redtidev1918/TelePost/commit/f36112a33b868f2a4e52dc59e84d8becc5333d04))
+
+* **审核卡片:** 点过「重抓」的卡片，如果这次没找到新的可替换作品，卡片不再退回成一个「可照样发布/拒绝」的普通卡——点重抓即视为已拒绝当前作品，卡片保持「已作废」，只留下「重抓/换一张」和原链接，让你在下一张新作品上继续重抓（序号递增） ([f36112a](https://github.com/redtidev1918/TelePost/commit/f36112a33b868f2a4e52dc59e84d8becc5333d04))
+
+---
+
+## [2.71.2](https://github.com/redtidev1918/TelePost/compare/v2.71.1...v2.71.2) (2026-09-28)
+
+> 升级顺序：先升执行端 PixivFlow 到 3.4.2，再升本服务到 2.71.2。本次只含缺陷修复，两端协议保持兼容，顺序不强制。
+
+
+### Bug Fixes
+
+* **审核队列:** 「清理测试数据」不再可能误删真实审核：真实数据与测试数据现在各带显式标记，清理只删测试行，且同一条重抓链里只要还挂着真实数据就整条拒绝清理（此前按用户名匹配的清理曾把一条真实审核当成测试数据删掉） ([ed10c1a](https://github.com/redtidev1918/TelePost/commit/ed10c1aa85e4876acd86bbf27adce12803704e01))
+
+* **审核队列:** 测试链里混进来的真实投稿不再被套上测试身份：重抓替换时，真实候选保留自己的投稿人身份与数据分类，不再继承测试夹具的用户名与 ID ([ed10c1a](https://github.com/redtidev1918/TelePost/commit/ed10c1aa85e4876acd86bbf27adce12803704e01))
+
+* **审核卡片:** 审核群的预览不再继承投稿者勾选的「🔞 剧透」——审核群一律显示未遮罩的内容（审核员必须看清要审的东西，而 Telegram 无法对已发消息事后补上遮罩）；频道发布仍按审核时保存的遮罩值，审核员可在发布前用卡片上的「🔇 遮罩」按钮更改 ([ed10c1a](https://github.com/redtidev1918/TelePost/commit/ed10c1aa85e4876acd86bbf27adce12803704e01))
+
+---
+
+## [2.71.1](https://github.com/redtidev1918/TelePost/compare/v2.71.0...v2.71.1) (2026-09-27)
+
+> 升级顺序：先升执行端 PixivFlow 到 3.4.1，再升本服务到 2.71.1。两端协议保持兼容，旧版本仍可互操作。
+
+
+### Bug Fixes
+
+* **refetch:** 重抓结束的通知不再可能「静默丢失」——由执行端直接回传的终态结果此前绕过了「同一次重抓只通知一次」的通道，既可能不通知也可能不留记录；现在所有终态来源走同一条通道，通知里一律带上任务ID，便于对着执行端排查 ([d8b23a5](https://github.com/redtidev1918/TelePost/commit/d8b23a5a05ccd7347596eb55268c81d571532240))
+
+* **refetch:** 重抓失败的原因不再把执行端的技术报错原文（例如上游返回的 HTML 错误页）显示到审核卡片和小程序里，只保留一句简洁的中文说明 ([d8b23a5](https://github.com/redtidev1918/TelePost/commit/d8b23a5a05ccd7347596eb55268c81d571532240))
+
+---
+
+## [2.71.0](https://github.com/redtidev1918/TelePost/compare/v2.70.1...v2.71.0) (2026-09-27)
+
+
+### ⚠ Breaking-ish: PixivFlow 协作通道换成 Workflow Protocol v1
+
+审核群「重抓」改走稳定的远程作业 API（`POST /jobs` + 事件回调 +
+调和拉取），取代旧的内部路径。**升级顺序不可交换**：
+先升执行端 PixivFlow 到 3.3.0，再升本服务到 2.71.0。若临时需要切旧通道，
+用 `PIXIVFLOW_JOB_TRANSPORT=legacy` 回滚——旧入口仍保留，但不再默认。
+
+### Features
+
+* **refetch:** 重抓改为持久化作业（心跳、退避、重启可恢复），任何终态
+  （替换稿到达 / 无候选 / 失败 / 超时 / 已取消）都会在审核卡上明确显示原因
+  并允许再次重抓，不再出现「无限处理中」。事件通道到达即更新，无须等待轮询
+  ([a57a7bb](https://github.com/redtidev1918/TelePost/commit/a57a7bb74047c0afaf6b713a3d78ce61f47356ad))
+* **protocol:** 消费执行端作业事件，提供事件入口与调和循环，回调/调和都只
+  应用一次终态、最多发一次终态通知，绝不二次通知 ([0b1b73a](https://github.com/redtidev1918/TelePost/commit/0b1b73a2e80c09875befef511109438b1e877120))
+
+---
+
+## [2.70.1](https://github.com/redtidev1918/TelePost/compare/v2.70.0...v2.70.1) (2026-09-27)
+
+
+### Bug Fixes
+
+* **observability:** 自检不再把「历史投递记录」误报为异常——投递账本记录的是已确认发布，行越老不代表有问题（此前每次自检都会恒定报一条无意义的告警，掩盖真实积压）；现在只检查尚未确认的记录 ([95ddc64](https://github.com/redtidev1918/TelePost/commit/95ddc647b206e4d26d9048a9bcb32e5228278854))
+
+---
+
+## [2.70.0](https://github.com/redtidev1918/TelePost/compare/v2.69.0...v2.70.0) (2026-09-27)
+
+
+### Features
+
+* **miniapp:** 小程序「审核详情」显示重抓任务ID、当前阶段与已等待时长，重抓进行中时按钮保持不可点击（此前只识别旧状态词，进行中的重抓在页面上仍显示为可点击），并显示终止原因 ([3e1950c](https://github.com/redtidev1918/TelePost/commit/3e1950c350042ed90c9679a0a5b442f0dbb81f8d))
+
+---
+
+## [2.69.0](https://github.com/redtidev1918/TelePost/compare/v2.68.1...v2.69.0) (2026-09-27)
+
+
+### Features
+
+* **review:** 重抓全过程可见：审核卡显示任务ID、当前阶段（搜索 / 筛选 / 准备替换）与已等待时长，超过 2 分钟自动再次提醒；请求未被接受 20 分钟、阶段停滞 10 分钟、总时长超过 30 分钟都以明确的终态收尾并交还可操作卡片（不再出现无限「仍在处理中」），候选替换历史随时可查 ([69849e2](https://github.com/redtidev1918/TelePost/commit/69849e2644ff85b140c4ac9b8d4570198bfa26db))
+* **observability:** 新增只读自检：检查数据库完整性、卡住或异常的重抓、孤儿审核、卡住的发布、待投递队列与近期审计记录，输出明确结论与退出码，绝不改动数据、绝不打印令牌 ([266017d](https://github.com/redtidev1918/TelePost/commit/266017d40372798a90f3f5fb71d54e1e63d1dfbd))
+
+---
+
+## [2.68.1](https://github.com/redtidev1918/TelePost/compare/v2.68.0...v2.68.1) (2026-09-27)
+
+
+### Bug Fixes
+
+* **review:** 点击「重抓」后审核卡立即变成「重抓中」形态（隐藏 发布/拒绝/遮罩，保留 重抓 与查看原链接），进度提醒改为 2 分钟并在同一张卡上显示已等待时长；替换稿、无候选、失败、超时结束都会交还可正常操作的卡片。源稿件不会被提前判为拒绝——那会让自己的替换稿作废（此前表现为点击后长时间没有任何变化，容易被误判为卡死） ([60616f8](https://github.com/redtidev1918/TelePost/commit/60616f8bef8fe38e63ee8826ee1b0ff99a619250))
+
+---
+
+## [2.68.0](https://github.com/redtidev1918/TelePost/compare/v2.67.0...v2.68.0) (2026-09-26)
+
+
+### Features
+
+* **review:** 审核群预览小说封面：有真实封面的小说在审核群里先显示封面图、再显示 TXT 文档，与频道发布结构一致；封面只用于预览展示，不写入审核记录 ([c8d7048](https://github.com/redtidev1918/TelePost/commit/c8d7048ff383d9d5da5952eff9ef5ff2c6869ef2))
+
+---
+
+## [2.67.0](https://github.com/redtidev1918/TelePost/compare/v2.66.0...v2.67.0) (2026-09-24)
+
+
+### Bug Fixes
+
+* **publication:** 混合图档投稿的频道归档保留全部图片和文件；多文件投稿的说明文字单独发送，不再被误读为首份文件的标注 ([e138973](https://github.com/redtidev1918/TelePost/commit/e1389734829cad5e9131d81d6b119b3ce3eec0c4))
+
+---
+
+## [2.66.0](https://github.com/redtidev1918/TelePost/compare/v2.65.0...v2.66.0) (2026-09-24)
+
+
+### Features
+
+* **novel:** 有真实封面的小说「封面主帖 + TXT 回复」；正文插图只进在线阅读页，不再发频道 ([4896d80](https://github.com/redtidev1918/TelePost/commit/4896d80b93d1c8c2614e5610a0dfe7c34e332f47))
+* **novel:** 无封面小说自动生成轻量 fallback 卡片作频道 root（`NOVEL_FALLBACK_CARD_ENABLED`，默认开）；生成失败降级为纯文本 root，发布永不因卡片失败而失败 ([4896d80](https://github.com/redtidev1918/TelePost/commit/4896d80b93d1c8c2614e5610a0dfe7c34e332f47))
+
+(https://github.com/redtidev1918/TelePost/compare/v2.64.3...v2.65.0) (2026-09-24)
+
+
+### Features
+
+* **miniapp:** 新增「热门」内容浏览入口（首页推荐、全部/本周热榜、帖子详情与媒体预览），与 Bot `/hot` 共用同一套热榜数据 ([6ab7fc0](https://github.com/redtidev1918/TelePost/commit/6ab7fc036fba93b327f924d0a3ad06a5679e68c9))
+* **webapp:** 热门内容页、帖子详情页与底部导航「热门」入口 ([55861fd](https://github.com/redtidev1918/TelePost/commit/55861fde6bbe7f98b7cdf09f5bc1740173c30c9e))
+
+
+### Bug Fixes
+
+* **hot:** 修复热榜分页偏移导致第一页结果被跳过 ([6ab7fc0](https://github.com/redtidev1918/TelePost/commit/6ab7fc036fba93b327f924d0a3ad06a5679e68c9))
+
+(https://github.com/redtidev1918/TelePost/compare/v2.64.2...v2.64.3) (2026-09-24)
+
+
+### Bug Fixes
+
+* **delivery:** compress oversized images before document fallback ([10e9481](https://github.com/redtidev1918/TelePost/commit/10e94811ab56582e19347c7ec85c36d8a493aa4e))
+* **publication:** keep novel TXT in asset delivery plan ([10e9481](https://github.com/redtidev1918/TelePost/commit/10e94811ab56582e19347c7ec85c36d8a493aa4e))
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+
+
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))## [2.64.0](https://github.com/redtidev1918/TelePost/compare/v2.63.0...v2.64.0) (2026-09-23)
+
+
+### Features
+
+* **hot,automation,help:** add /hotweek, /schedule, reorganize help & menus ([66e1257](https://github.com/redtidev1918/TelePost/commit/66e125764addff7b9c6d646d401c89c561e1af0a))
+
+
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))## [2.64.0](https://github.com/redtidev1918/TelePost/compare/v2.63.0...v2.64.0) (2026-09-24)
+
+
+### Features
+
+* **hot:** redesign /hot and add /hotweek — natural-week hot ranking with stable sort
+* **automation:** add /schedule for admin-defined recurring tasks (SQLite persistent, hot-reload, idempotent runs)
+* **help:** reorganize /help and /start; split user vs admin command menus via Telegram scopes
+
+## [2.63.0](https://github.com/redtidev1918/TelePost/compare/v2.62.4...v2.63.0) (2026-09-22)
+
+
+### Features
+
+* **moderation:** add manual ban commands for users and api tokens ([0326cf8](https://github.com/redtidev1918/TelePost/commit/0326cf8f6532d9a9b61ddcc1a562b1bb02300ed3))
+
+## [2.62.4](https://github.com/redtidev1918/TelePost/compare/v2.62.3...v2.62.4) (2026-09-22)
+
+
+### Bug Fixes
+
+* **notify:** keep anonymous submitter id visible in admin alerts ([241de35](https://github.com/redtidev1918/TelePost/commit/241de350acb698780989e9586e826e01bcf5d08e))
+
+## [2.62.3](https://github.com/redtidev1918/TelePost/compare/v2.62.2...v2.62.3) (2026-09-22)
+
+
+### Bug Fixes
+
+* **delivery:** anchor discussion overflow to album roots ([cad09dd](https://github.com/redtidev1918/TelePost/commit/cad09ddb377dd056c334f2bff88cae863880a70f))
+* **review:** default review albums to Telegram media group capacity ([3a2bda1](https://github.com/redtidev1918/TelePost/commit/3a2bda11c4c512f72d0ba6df47a1a929b2562bbb))
+
+## [2.62.2](https://github.com/redtidev1918/TelePost/compare/v2.62.1...v2.62.2) (2026-09-21)
+
+
+### Bug Fixes
+
+* **delivery:** route discussion publishing through shared strategy ([d82d0f9](https://github.com/redtidev1918/TelePost/commit/d82d0f9cb3b6a8723725173596f9c1607de75e35))
+
+## [2.62.1](https://github.com/redtidev1918/TelePost/compare/v2.62.0...v2.62.1) (2026-09-21)
+
+
+### Bug Fixes
+
+* **preview:** regenerate legacy rich-marked text-only pages ([3528297](https://github.com/redtidev1918/TelePost/commit/35282975f3e05d2bb18cb955d9240eebe11e83e5))
+
+## [2.62.0](https://github.com/redtidev1918/TelePost/compare/v2.61.1...v2.62.0) (2026-09-21)
+
+
+### Features
+
+* **delivery:** novel images preview-only and family-aware overflow ([2b6506f](https://github.com/redtidev1918/TelePost/commit/2b6506f513ccec1ce51e44be3ac1e6d28dc7aa40))
+
+## [2.61.1](https://github.com/redtidev1918/TelePost/compare/v2.61.0...v2.61.1) (2026-09-21)
+
+
+### Bug Fixes
+
+* **delivery:** materialize remote media before Telegram album send ([c764f0c](https://github.com/redtidev1918/TelePost/commit/c764f0c0e59d13d2d1535d9f0a994ee83a3d65d5))
+
+## [2.61.0](https://github.com/redtidev1918/TelePost/compare/v2.60.1...v2.61.0) (2026-09-21)
+
+
+### Features
+
+* **preview:** include inline novel images in online reading page ([e9d7cce](https://github.com/redtidev1918/TelePost/commit/e9d7cced0f0d192fb162fdb1ca34ac35c8cd37da))
+
+## [2.60.1](https://github.com/redtidev1918/TelePost/compare/v2.60.0...v2.60.1) (2026-09-21)
+
+
+### Bug Fixes
+
+* **delivery:** fall back to local upload when Telegram cannot fetch remote media ([2814b27](https://github.com/redtidev1918/TelePost/commit/2814b271364926a4900ec68a6ecc31fde654cc5d))
+
+## [2.60.0](https://github.com/redtidev1918/TelePost/compare/v2.59.0...v2.60.0) (2026-09-21)
+
+
+### Features
+
+* **reactions:** add operator history backfill script ([fa64205](https://github.com/redtidev1918/TelePost/commit/fa6420582e7d9965c7abd4dc45b4a8b54769b51d))
+
+## [2.59.0](https://github.com/redtidev1918/TelePost/compare/v2.58.1...v2.59.0) (2026-09-21)
+
+
+### Features
+
+* **observability:** record media delivery strategy ([#228](https://github.com/redtidev1918/TelePost/issues/228)) ([3bc533f](https://github.com/redtidev1918/TelePost/commit/3bc533f93f91da62aef50fe9fff40acef8d30aaa))
+
+## [2.58.1](https://github.com/redtidev1918/TelePost/compare/v2.58.0...v2.58.1) (2026-09-21)
+
+
+### Bug Fixes
+
+* **media:** align documents to trailing novel assets ([#225](https://github.com/redtidev1918/TelePost/issues/225)) ([9b1044d](https://github.com/redtidev1918/TelePost/commit/9b1044d51a3f09f57e9de30734384e95d6f04f61))
+
+## [2.58.0](https://github.com/redtidev1918/TelePost/compare/v2.57.1...v2.58.0) (2026-09-21)
+
+
+### Features
+
+* **media:** typed MediaAsset domain model (Batch 5, RFC telepost-media-asset-model) ([#223](https://github.com/redtidev1918/TelePost/issues/223)) ([addbf77](https://github.com/redtidev1918/TelePost/commit/addbf7783c43344060401ec26be18ec1e62fab9f))
+
+## [2.57.1](https://github.com/redtidev1918/TelePost/compare/v2.57.0...v2.57.1) (2026-09-21)
+
+
+### Bug Fixes
+
+* **reviews:** anchor review_chain_id at insert so media_asset_refs persist ([#221](https://github.com/redtidev1918/TelePost/issues/221)) ([fb0c2f4](https://github.com/redtidev1918/TelePost/commit/fb0c2f4c05cfa0bba474085b9c11fe64c635c13b))
+
+## [2.57.0](https://github.com/redtidev1918/TelePost/compare/v2.56.2...v2.57.0) (2026-09-20)
+
+
+### Features
+
+* **delivery:** proxy remote media sources ([#212](https://github.com/redtidev1918/TelePost/issues/212)) ([97f1dbd](https://github.com/redtidev1918/TelePost/commit/97f1dbd3325e7c9ae3191e196319d79dc16d3ef8))
+
+## [2.56.2](https://github.com/redtidev1918/TelePost/compare/v2.56.1...v2.56.2) (2026-09-20)
+
+
+### Bug Fixes
+
+* **footer:** open Main Mini App directly without BotFather short name ([#217](https://github.com/redtidev1918/TelePost/issues/217)) ([551c047](https://github.com/redtidev1918/TelePost/commit/551c047110f9e516e9db02943a394995d3045038))
+
+## [2.56.1](https://github.com/redtidev1918/TelePost/compare/v2.56.0...v2.56.1) (2026-09-20)
+
+
+### Bug Fixes
+
+* **health:** aggregate reaction ingestion from bot workers ([53b336f](https://github.com/redtidev1918/TelePost/commit/53b336f3732b356524b2f0e721f2633509847fda))
+* **health:** aggregate reaction ingestion from bot workers ([ae5e155](https://github.com/redtidev1918/TelePost/commit/ae5e155bcc81acb7180f03c954744b45f5510bed))
+
+## [2.56.0](https://github.com/redtidev1918/TelePost/compare/v2.55.4...v2.56.0) (2026-09-20)
+
+
+### Features
+
+* **ux:** make Mini App primary and expose reaction ingestion ([507fbbb](https://github.com/redtidev1918/TelePost/commit/507fbbbc7a1ff1d13cec80816fbbd8a3e5768db2))
+* **ux:** make Mini App primary and expose reaction ingestion ([90af281](https://github.com/redtidev1918/TelePost/commit/90af2813af454d6b74c9b57d2846da927edb941f))
+
+## [2.55.4](https://github.com/redtidev1918/TelePost/compare/v2.55.3...v2.55.4) (2026-09-20)
+
+
+### Bug Fixes
+
+* **bot:** improve submission UX ([224e197](https://github.com/redtidev1918/TelePost/commit/224e1975ad6b8f350c1cf6838be250cbf74ad37f))
+* **ux:** suppress preview links and restore menu after cancel ([69e7bd0](https://github.com/redtidev1918/TelePost/commit/69e7bd099dad2f1e3ae790243b4f6d6cfb12e52b))
+
+## [2.55.3](https://github.com/redtidev1918/TelePost/compare/v2.55.2...v2.55.3) (2026-09-20)
+
+
+### Bug Fixes
+
+* **bot:** preserve command menu and miniapp entry ([#208](https://github.com/redtidev1918/TelePost/issues/208)) ([a913e6d](https://github.com/redtidev1918/TelePost/commit/a913e6d96b90fb0c1d3d8b8ae0c2fe5a1fceeb76))
+
+## [2.55.2](https://github.com/redtidev1918/TelePost/compare/v2.55.1...v2.55.2) (2026-09-20)
+
+
+### Bug Fixes
+
+* **bot:** pass menu button by keyword ([#206](https://github.com/redtidev1918/TelePost/issues/206)) ([6b961be](https://github.com/redtidev1918/TelePost/commit/6b961bedee7be5eab182e460cb6eb3c0c984d543))
+
+## [2.55.1](https://github.com/redtidev1918/TelePost/compare/v2.55.0...v2.55.1) (2026-09-20)
+
+
+### Bug Fixes
+
+* **ux:** align previews, restore menu, add bulk history delete ([#204](https://github.com/redtidev1918/TelePost/issues/204)) ([6ce5a4e](https://github.com/redtidev1918/TelePost/commit/6ce5a4ecf94b7c16cda654617a609270404e42dc))
+
+## [2.55.0](https://github.com/redtidev1918/TelePost/compare/v2.54.2...v2.55.0) (2026-09-20)
+
+
+### Features
+
+* **api:** accept media assets via multipart ([#202](https://github.com/redtidev1918/TelePost/issues/202)) ([850e298](https://github.com/redtidev1918/TelePost/commit/850e29868368bd548ea7e71e9cd6aa11982cd0da))
+
+## [2.54.2](https://github.com/redtidev1918/TelePost/compare/v2.54.1...v2.54.2) (2026-09-20)
+
+
+### Bug Fixes
+
+* **stats:** accept context in reaction handler ([#200](https://github.com/redtidev1918/TelePost/issues/200)) ([9679248](https://github.com/redtidev1918/TelePost/commit/9679248a98ef84d584b06ab156ed13376785b374))
+
+## [2.54.1](https://github.com/redtidev1918/TelePost/compare/v2.54.0...v2.54.1) (2026-09-20)
+
+
+### Bug Fixes
+
+* **reviews:** strip HTML from note at insert (Pixiv <br> leak) ([#196](https://github.com/redtidev1918/TelePost/issues/196)) ([5371689](https://github.com/redtidev1918/TelePost/commit/5371689483c4a505bb207d72d79681991aba417b))
+
+## [2.54.0](https://github.com/redtidev1918/TelePost/compare/v2.53.0...v2.54.0) (2026-09-19)
+
+
+### Features
+
+* **stats:** hide views/forwards entirely; Step 14 reuse test ([#194](https://github.com/redtidev1918/TelePost/issues/194)) ([32e89c8](https://github.com/redtidev1918/TelePost/commit/32e89c85ccb6ac11388cbc3cb782c9740776c23a))
+
+## [2.53.0](https://github.com/redtidev1918/TelePost/compare/v2.52.0...v2.53.0) (2026-09-19)
+
+
+### Features
+
+* **stats:** reaction-based heat from message_reaction_count ([#192](https://github.com/redtidev1918/TelePost/issues/192)) ([84f6aa1](https://github.com/redtidev1918/TelePost/commit/84f6aa1ff7cabffc38defe39a7e625f88a3e6102))
+
+## [2.52.0](https://github.com/redtidev1918/TelePost/compare/v2.51.0...v2.52.0) (2026-09-19)
+
+
+### Features
+
+* **delivery:** Step 12/13 planner adoption + TelegramMediaCache capture ([#190](https://github.com/redtidev1918/TelePost/issues/190)) ([c071e1a](https://github.com/redtidev1918/TelePost/commit/c071e1aee7bfae8b402d27c1a1f7ed74cd94ff08))
+
+## [2.51.0](https://github.com/redtidev1918/TelePost/compare/v2.50.0...v2.51.0) (2026-09-19)
+
+
+### Features
+
+* **delivery:** Step 12 TelegramMediaCache ([ffbc20f](https://github.com/redtidev1918/TelePost/commit/ffbc20fe1b593a9ca2c6eb7c65f083887134a501))
+* **delivery:** Step 12 TelegramMediaCache foundation ([21a1122](https://github.com/redtidev1918/TelePost/commit/21a1122c82ef4a08327ca118078f2c32ce183494))
+
+## [2.50.0](https://github.com/redtidev1918/TelePost/compare/v2.49.0...v2.50.0) (2026-09-19)
+
+
+### Features
+
+* **delivery:** Step 11 DeliveryPlanner ([878c75d](https://github.com/redtidev1918/TelePost/commit/878c75d82ccce7c5bcdd52464a489e28c7ed78e7))
+* **delivery:** Step 11 DeliveryPlanner foundation ([fab63b6](https://github.com/redtidev1918/TelePost/commit/fab63b6400cc3c46d662c81d4a451b6dca4aafbd))
+
+## [2.49.0](https://github.com/redtidev1918/TelePost/compare/v2.48.0...v2.49.0) (2026-09-19)
+
+
+### Features
+
+* **api:** delivery asset contract (Step 10) ([ce4087b](https://github.com/redtidev1918/TelePost/commit/ce4087b02d5264563ca0e44ac26c39aaff2ce487))
+* **api:** introduce delivery asset contract (Step 10) ([7a5b56e](https://github.com/redtidev1918/TelePost/commit/7a5b56e16e098a72fefe8671a219357c502e2985))
+
+## [2.48.0](https://github.com/redtidev1918/TelePost/compare/v2.47.0...v2.48.0) (2026-09-19)
+
+
+### Features
+
+* **miniapp:** soft-delete own submission history ([2c286d3](https://github.com/redtidev1918/TelePost/commit/2c286d3eccb3da5243a213af0e4d4ce50e662a16))
+
+## [2.47.0](https://github.com/redtidev1918/TelePost/compare/v2.46.0...v2.47.0) (2026-09-19)
+
+
+### Features
+
+* **miniapp:** Admin Control Plane panel (status/policy/roles/blacklist) ([5adaa85](https://github.com/redtidev1918/TelePost/commit/5adaa85a7266bca24f5e1eab28b814b662f15ff3))
+
+## [2.46.0](https://github.com/redtidev1918/TelePost/compare/v2.45.2...v2.46.0) (2026-09-19)
+
+
+### Features
+
+* **rbac:** SQLite role bindings for Admin Control Plane ([#179](https://github.com/redtidev1918/TelePost/issues/179)) ([d62ab71](https://github.com/redtidev1918/TelePost/commit/d62ab715e0c5d258c04348d54540d80d0bd8a50d))
+
+## [2.45.2](https://github.com/redtidev1918/TelePost/compare/v2.45.1...v2.45.2) (2026-09-19)
+
+
+### Bug Fixes
+
+* **miniapp:** let reviewers/admins submit alongside review queue ([#177](https://github.com/redtidev1918/TelePost/issues/177)) ([855de4c](https://github.com/redtidev1918/TelePost/commit/855de4c9bcc3df9c4c2cd48a100ef19cb0f3cfec))
+
+## [2.45.1](https://github.com/redtidev1918/TelePost/compare/v2.45.0...v2.45.1) (2026-09-18)
+
+
+### Bug Fixes
+
+* **chat:** add /cancel to /about quick commands ([350d370](https://github.com/redtidev1918/TelePost/commit/350d370c6538db8d8ec7b35d8debc185d0410740))
+
+## [2.45.0](https://github.com/redtidev1918/TelePost/compare/v2.44.0...v2.45.0) (2026-09-18)
+
+
+### Features
+
+* **chat:** register /about and /stats commands ([c1dcbc8](https://github.com/redtidev1918/TelePost/commit/c1dcbc8056aad8583b7cd4b61dcd9da16bd0c513))
+
+
+### Bug Fixes
+
+* **chat:** keep /commands clickable by removing <code> wrappers ([654d983](https://github.com/redtidev1918/TelePost/commit/654d9839c99b450aef38e20b6e04dee24f7f5db8))
+
+## [2.44.0](https://github.com/redtidev1918/TelePost/compare/v2.43.0...v2.44.0) (2026-09-18)
+
+
+### Features
+
+* **chat:** redesign private-chat submission copy and flow guidance ([114ed64](https://github.com/redtidev1918/TelePost/commit/114ed641d264914533ac9705283d21e1f73bbfbd))
+
+## [2.43.0](https://github.com/redtidev1918/TelePost/compare/v2.42.0...v2.43.0) (2026-09-18)
+
+
+### Features
+
+* **miniapp:** split user space and admin space (distinct preview/send UX) ([dafaa0a](https://github.com/redtidev1918/TelePost/commit/dafaa0a304c5e09abc366a51f1ad25e5c2d4f9df))
+* **miniapp:** split user space and admin space, distinct preview/send UX ([c3641e1](https://github.com/redtidev1918/TelePost/commit/c3641e1f7250c0b69360156974a84a5380a044b3))
+
+## [2.42.0](https://github.com/redtidev1918/TelePost/compare/v2.41.0...v2.42.0) (2026-09-18)
+
+
+### Features
+
+* **chat:** send real media preview in private chat (distinct from Mini App local preview) ([ba65182](https://github.com/redtidev1918/TelePost/commit/ba65182e0564472f8ae4ba1f397d98b22993c740))
+* **chat:** send real media preview in private chat (distinct from Mini App) ([0b96ca3](https://github.com/redtidev1918/TelePost/commit/0b96ca3661f67de27e469703747c832a63115eff))
+
+## [2.41.0](https://github.com/redtidev1918/TelePost/compare/v2.40.1...v2.41.0) (2026-09-18)
+
+
+### Features
+
+* **chat:** polished private-chat submission UX (prompts, formatting, progress, preview) ([263e98d](https://github.com/redtidev1918/TelePost/commit/263e98dbbd3e5f552e32a21e6fe670d3576768cb))
+* **chat:** polished private-chat submission UX (prompts, formatting, progress, preview) ([e93d7a5](https://github.com/redtidev1918/TelePost/commit/e93d7a598929cfad181a7fb0b28809ec4376b2be))
+
+## [2.40.1](https://github.com/redtidev1918/TelePost/compare/v2.40.0...v2.40.1) (2026-09-18)
+
+
+### Bug Fixes
+
+* **recovery:** use UUID format PixivFlow accepts and surface real failure reason ([ae25cd0](https://github.com/redtidev1918/TelePost/commit/ae25cd033e0e780f7fcb8dd9e625a5b89fae454a))
+
+## [2.40.0](https://github.com/redtidev1918/TelePost/compare/v2.39.1...v2.40.0) (2026-09-18)
+
+
+### Features
+
+* **ops:** /status and /pin_status Telegram commands ([#163](https://github.com/redtidev1918/TelePost/issues/163)) ([fa4ca7b](https://github.com/redtidev1918/TelePost/commit/fa4ca7b465f824f7b130b815c4fb67a1a98a9b5c))
+
+## [2.39.1](https://github.com/redtidev1918/TelePost/compare/v2.39.0...v2.39.1) (2026-09-18)
+
+
+### Bug Fixes
+
+* **ops:** schedule/status + watchdog use latest-notification status ([#161](https://github.com/redtidev1918/TelePost/issues/161)) ([8d8c30b](https://github.com/redtidev1918/TelePost/commit/8d8c30bf37243a478ef928ab0b6239b2e7b535ac))
+
+## [2.39.0](https://github.com/redtidev1918/TelePost/compare/v2.38.0...v2.39.0) (2026-09-18)
+
+
+### Features
+
+* **ops:** public /status page + schedule observability docs ([#159](https://github.com/redtidev1918/TelePost/issues/159)) ([3ed5faf](https://github.com/redtidev1918/TelePost/commit/3ed5fafcf2cb701b3bee914f8b036c8a02053411))
+
+## [2.38.0](https://github.com/redtidev1918/TelePost/compare/v2.37.0...v2.38.0) (2026-09-18)
+
+
+### Features
+
+* **ops:** schedule watchdog + preannouncement + status ([#157](https://github.com/redtidev1918/TelePost/issues/157)) ([452dc0b](https://github.com/redtidev1918/TelePost/commit/452dc0b319b8da1a80dcd123136ad61773960be7))
+
+## [2.37.0](https://github.com/redtidev1918/TelePost/compare/v2.36.0...v2.37.0) (2026-09-18)
+
+
+### Features
+
+* **schedule-ux:** render candidate inventory 待发池 line ([627c195](https://github.com/redtidev1918/TelePost/commit/627c1955609345aaac7906b0ba1f848217e18e47))
+* **schedule-ux:** render 待发池 inventory line ([6d1954b](https://github.com/redtidev1918/TelePost/commit/6d1954b66ffbc0a70de9667bf2355ae85e42243a))
+
+## [2.36.0](https://github.com/redtidev1918/TelePost/compare/v2.35.1...v2.36.0) (2026-09-18)
+
+
+### Features
+
+* **observability:** candidate supply funnel + target-labeled recovery buttons ([#153](https://github.com/redtidev1918/TelePost/issues/153)) ([8810f73](https://github.com/redtidev1918/TelePost/commit/8810f73008ec07492093bf86b14df375cc177ac7))
+
+## [2.35.1](https://github.com/redtidev1918/TelePost/compare/v2.35.0...v2.35.1) (2026-09-17)
+
+
+### Bug Fixes
+
+* **recovery:** PixivFlow UUID format + real error surfacing ([#151](https://github.com/redtidev1918/TelePost/issues/151)) ([219c9a7](https://github.com/redtidev1918/TelePost/commit/219c9a7f025db561c59fa0d5188f8ae069f69c3d))
+
+## [2.35.0](https://github.com/redtidev1918/TelePost/compare/v2.34.0...v2.35.0) (2026-09-18)
+
+
+### Features
+
+* 投稿审核按来源可信度决定：API 自动化投稿固定进入审核；Mini App 由独立的 MINIAPP_REVIEW_REQUIRED 控制；聊天直发维持默认直接发布。审核通知与审核策略分离，所有来源都进入管理员通知 ([#148](https://github.com/redtidev1918/TelePost/issues/148))
+
+## [2.34.0](https://github.com/redtidev1918/TelePost/compare/v2.33.0...v2.34.0) (2026-09-18)
+
+
+### Features
+
+* 管理员控制面：统一投稿通知（来源 / 投稿人 / 状态 / 链接）、快速封禁用户与禁用 API、恢复失败结构化提示；治理基于 actor identity，不依赖审核记录 ([#146](https://github.com/redtidev1918/TelePost/issues/146))
+
+## [2.33.0](https://github.com/redtidev1918/TelePost/compare/v2.32.0...v2.33.0) (2026-09-17)
+
+
+### Dependencies
+
+* bump `telepress` 0.6.1 → 0.9.0 (rich novel Telegraph preview: local Catbox image upload + inline Telegraph renderer) ([#144](https://github.com/redtidev1918/TelePost/issues/144)) ([94650f3](https://github.com/redtidev1918/TelePost/commit/94650f36def6e40cff9e819099258e4b7bba3623))
+
+## [2.32.0](https://github.com/redtidev1918/TelePost/compare/v2.31.4...v2.32.0) (2026-09-17)
+
+
+### Features
+
+* **review:** submission resubmit outcome model ([#141](https://github.com/redtidev1918/TelePost/issues/141)) ([533824b](https://github.com/redtidev1918/TelePost/commit/533824b6042c119c3e512e32ad3ed8f8116a5c6a))
+
+## [2.31.4](https://github.com/redtidev1918/TelePost/compare/v2.31.3...v2.31.4) (2026-09-16)
+
+
+### Bug Fixes
+
+* semantic channel navigation footer and tag separator UX ([#137](https://github.com/redtidev1918/TelePost/issues/137)) ([#137](https://github.com/redtidev1918/TelePost/issues/137)) ([fa13b44](https://github.com/redtidev1918/TelePost/commit/fa13b44f82aab7588e80ec494be2121f0eba14aa))
+
+## [2.31.3](https://github.com/redtidev1918/TelePost/compare/v2.31.2...v2.31.3) (2026-09-16)
+
+
+### Bug Fixes
+
+* make submission updates exclusive ([#135](https://github.com/redtidev1918/TelePost/issues/135)) ([c42cfe4](https://github.com/redtidev1918/TelePost/commit/c42cfe47fb217542c589c770f3a825b87a1b9042))
+
+## [2.31.2](https://github.com/redtidev1918/TelePost/compare/v2.31.1...v2.31.2) (2026-09-15)
+
+
+### Bug Fixes
+
+* **publication:** notify-once, preview link, review-CTA, discussion-root ([#132](https://github.com/redtidev1918/TelePost/issues/132)) ([f16ae04](https://github.com/redtidev1918/TelePost/commit/f16ae040c0e49f5fab34ed1e55ba7aefbae12a23))
+
+## [2.31.1](https://github.com/redtidev1918/TelePost/compare/v2.31.0...v2.31.1) (2026-09-15)
+
+
+### Bug Fixes
+
+* **run:** propagate per-bot MINIAPP_SUBMIT_CTA into child env ([#130](https://github.com/redtidev1918/TelePost/issues/130)) ([e20f69e](https://github.com/redtidev1918/TelePost/commit/e20f69ea29b3506280386fe0b22e89db0624b202))
+
+## [2.31.0](https://github.com/redtidev1918/TelePost/compare/v2.30.0...v2.31.0) (2026-09-15)
+
+
+### Features
+
+* **publication:** optional TelePress novel preview enrichment ([#127](https://github.com/redtidev1918/TelePost/issues/127)) ([8413430](https://github.com/redtidev1918/TelePost/commit/84134307ef445d03375ec389bdf247ad67706862))
+* **review-cta:** review/main post submission CTA as inline URL button ([#128](https://github.com/redtidev1918/TelePost/issues/128)) ([6da1afe](https://github.com/redtidev1918/TelePost/commit/6da1afe91679a9be3743ffc51e11d18e40c9fd12))
+
+## [2.30.0](https://github.com/redtidev1918/TelePost/compare/v2.29.0...v2.30.0) (2026-09-15)
+
+
+### Features
+
+* **publication:** channel submission CTA opens owning bot's Mini App submit page ([#125](https://github.com/redtidev1918/TelePost/issues/125)) ([31602e9](https://github.com/redtidev1918/TelePost/commit/31602e91851e3fa9341108f40de9de6f0c0d66b6))
+
+## [2.29.0](https://github.com/redtidev1918/TelePost/compare/v2.28.0...v2.29.0) (2026-09-15)
+
+
+### Features
+
+* **recovery-ux, packing-ssot:** manual recovery buttons + reason rendering + media capacity SSOT ([#123](https://github.com/redtidev1918/TelePost/issues/123)) ([56fff95](https://github.com/redtidev1918/TelePost/commit/56fff95424bec25e6ac389f9dd9c05beb7ec8ce5))
+
+## [2.28.0](https://github.com/redtidev1918/TelePost/compare/v2.27.4...v2.28.0) (2026-09-15)
+
+
+### Features
+
+* **publication:** harden human submission delivery ([#121](https://github.com/redtidev1918/TelePost/issues/121)) ([329d1eb](https://github.com/redtidev1918/TelePost/commit/329d1eb8ba9697c5239333fcc39d320137b57d7d))
+
+## [2.27.4](https://github.com/redtidev1918/TelePost/compare/v2.27.3...v2.27.4) (2026-09-15)
+
+
+### Bug Fixes
+
+* postRelease deploy-docs dispatches on default branch (Pages needs branch ref) ([467a97e](https://github.com/redtidev1918/TelePost/commit/467a97eb1f6fc606f5f7804abfe86700e8c1d788))
+* **refetch:** generation replacement — harden stale guard, invalidate old card ([#120](https://github.com/redtidev1918/TelePost/issues/120)) ([0caef1a](https://github.com/redtidev1918/TelePost/commit/0caef1a298e93cb1fcfbbcadc7b40008e5db9585))
+
+## [2.27.3](https://github.com/redtidev1918/TelePost/compare/v2.27.2...v2.27.3) (2026-09-15)
+
+
+### Bug Fixes
+
+* **publication:** presentation SSOT — media actions and submitter identity ([#117](https://github.com/redtidev1918/TelePost/issues/117)) ([5bd77e7](https://github.com/redtidev1918/TelePost/commit/5bd77e7a9cbe4f14f741608888d269a00ba3b057))
+
+## [2.27.2](https://github.com/redtidev1918/TelePost/compare/v2.27.1...v2.27.2) (2026-09-15)
+
+
+### Bug Fixes
+
+* **editorial:** draft edits are PATCH semantics — accumulate on the draft ([#115](https://github.com/redtidev1918/TelePost/issues/115)) ([c6157ab](https://github.com/redtidev1918/TelePost/commit/c6157ab0c00362b2031f7e2b42c95afb8d0c7f25))
+
+## [2.27.1](https://github.com/redtidev1918/TelePost/compare/v2.27.0...v2.27.1) (2026-09-15)
+
+
+### Bug Fixes
+
+* **editorial:** empty-chain reviews are their own chain head ([#113](https://github.com/redtidev1918/TelePost/issues/113)) ([6849803](https://github.com/redtidev1918/TelePost/commit/6849803d24e6beef74f4c3a1be10fab7c882c3cf))
+
+## [2.27.0](https://github.com/redtidev1918/TelePost/compare/v2.26.1...v2.27.0) (2026-09-15)
+
+
+### Features
+
+* **publication:** reviewer-edited publication + submitter publication notification ([#110](https://github.com/redtidev1918/TelePost/issues/110)) ([3b14613](https://github.com/redtidev1918/TelePost/commit/3b146132901ef3dc1dfc36aa94a0697625df420f))
+
+## [2.26.1](https://github.com/redtidev1918/TelePost/compare/v2.26.0...v2.26.1) (2026-09-15)
+
+
+### Bug Fixes
+
+* refetch terminal visibility — obsolete outcome notifies, watchdog wakes + hard stalls ([#108](https://github.com/redtidev1918/TelePost/issues/108)) ([4dd0de7](https://github.com/redtidev1918/TelePost/commit/4dd0de767317935ce9ea7a672180581594c25f5c))
+
+## [2.26.0](https://github.com/redtidev1918/TelePost/compare/v2.25.0...v2.26.0) (2026-09-14)
+
+
+### Features
+
+* local media preview, tag hint and explicit submission disposition ([#106](https://github.com/redtidev1918/TelePost/issues/106)) ([dee1e85](https://github.com/redtidev1918/TelePost/commit/dee1e859e826fa0098648360faa0cd71a236eb11))
+
+## [2.25.0](https://github.com/redtidev1918/TelePost/compare/v2.24.2...v2.25.0) (2026-09-14)
+
+
+### Features
+
+* owner-safe media endpoints and attachment UI in the Mini App ([#104](https://github.com/redtidev1918/TelePost/issues/104)) ([62dea47](https://github.com/redtidev1918/TelePost/commit/62dea477037f55e7f1cf0041d59407f4a5f87f5e))
+
+## [2.24.2](https://github.com/redtidev1918/TelePost/compare/v2.24.1...v2.24.2) (2026-09-14)
+
+
+### Bug Fixes
+
+* terminal schedule outcome notifications and remove ghost mention entities ([ae7e64b](https://github.com/redtidev1918/TelePost/commit/ae7e64b656f01b9bf7912aafc659f381083f4306))
+
+## [2.24.1](https://github.com/redtidev1918/TelePost/compare/v2.24.0...v2.24.1) (2026-09-14)
+
+
+### Bug Fixes
+
+* **api:** own-submission detail 404 semantics ([80c07a9](https://github.com/redtidev1918/TelePost/commit/80c07a9d46c2e142a76f3f9eb3fdf77ceafdd074))
+* **api:** own-submission detail returns 404 (not 409) for missing/not-owned rows ([0b7c989](https://github.com/redtidev1918/TelePost/commit/0b7c9895aa4c666a63b5060310ee2bf3a48c6429))
+
+## [2.24.0](https://github.com/redtidev1918/TelePost/compare/v2.23.1...v2.24.0) (2026-09-14)
+
+
+### Features
+
+* **identity:** idempotent audited backfill for legacy submission attribution ([bf02eab](https://github.com/redtidev1918/TelePost/commit/bf02eab3838e2ea501e0c94f74be9a0093f6cf20))
+* **identity:** separate actor, submitter and source for submission ownership ([a7a1d65](https://github.com/redtidev1918/TelePost/commit/a7a1d6522992c96e3c05a755e720c3f161072c52))
+* **submissions:** logical human-owned submissions + admin service ([443586d](https://github.com/redtidev1918/TelePost/commit/443586d631838cf01a92d33dd89d0b127f3a23eb))
+
+
+### Bug Fixes
+
+* **webapp:** framework-first layout, Uppy React integration, logical Mine ([96f94af](https://github.com/redtidev1918/TelePost/commit/96f94af5ebe1557c67626c1d829d71aa71f167c0))
+* **webapp:** layout safe-area, Uppy React upload, logical My Submissions ([1e312b2](https://github.com/redtidev1918/TelePost/commit/1e312b2abc104bb8cf0e44aeeeb27ed4b104650d))
+* **webapp:** measure BottomNav with a callback ref (mounts after auth) ([f13e93f](https://github.com/redtidev1918/TelePost/commit/f13e93fba800678dd154d9e0bae0420f451458f9))
+
+## [2.23.1](https://github.com/redtidev1918/TelePost/compare/v2.23.0...v2.23.1) (2026-09-14)
+
+
+### Bug Fixes
+
+* **refetch:** provenance-validated replacement + durable-slot watchdog; webapp SDK launch initData ([9c822a8](https://github.com/redtidev1918/TelePost/commit/9c822a8393fdda9c462e11d67e335ab3cb361697))
+* **refetch:** reconcile admitted attempts against PixivFlow durable slot ([ad91d9a](https://github.com/redtidev1918/TelePost/commit/ad91d9ae73577464919eb7876ec30a81af9d5a48))
+* **refetch:** validate provenance and finalize replacement after staging ([4944454](https://github.com/redtidev1918/TelePost/commit/49444548e852408ee5e24bcd6e454c40593a33eb))
+* **webapp:** read Telegram launch initData from the SDK, classify auth errors ([5728a68](https://github.com/redtidev1918/TelePost/commit/5728a6892284d52c9936cc06aae4572293e4de3c))
+
+## [2.23.0](https://github.com/redtidev1918/TelePost/compare/v2.22.0...v2.23.0) (2026-09-14)
+
+
+### Features
+
+* **publish:** append 点击投稿 channel footer link on real publish ([b557e06](https://github.com/redtidev1918/TelePost/commit/b557e0664c2c266698d01526223aa8c51bfce3d3))
+
+## [2.22.0](https://github.com/redtidev1918/TelePost/compare/v2.21.1...v2.22.0) (2026-09-14)
+
+
+### Features
+
+* **review:** refetch progress reminders and stale-timeout failure notice ([#91](https://github.com/redtidev1918/TelePost/issues/91)) ([af83951](https://github.com/redtidev1918/TelePost/commit/af83951992738aa1788751f8f44f744d7db418b0))
+
+## [2.21.1](https://github.com/redtidev1918/TelePost/compare/v2.21.0...v2.21.1) (2026-09-14)
+
+
+### Bug Fixes
+
+* **webapp:** use per-bot API prefix from ?bot= launch param ([#89](https://github.com/redtidev1918/TelePost/issues/89)) ([5162182](https://github.com/redtidev1918/TelePost/commit/5162182f47d7c479895d9d3ea18c099d643a51bf))
+
+## [2.21.0](https://github.com/redtidev1918/TelePost/compare/v2.20.4...v2.21.0) (2026-09-14)
+
+
+### Features
+
+* **review:** auto-clean superseded old review cards after retention ([#87](https://github.com/redtidev1918/TelePost/issues/87)) ([ac53e30](https://github.com/redtidev1918/TelePost/commit/ac53e30dda6641913036d832bd07c33800c42e8f))
+
+## [2.20.4](https://github.com/redtidev1918/TelePost/compare/v2.20.3...v2.20.4) (2026-09-13)
+
+
+### Bug Fixes
+
+* **webapp:** override valibot to 1.5.0 (ReDoS GHSA-vqpr-j7v3-hqw9) ([#85](https://github.com/redtidev1918/TelePost/issues/85)) ([fc0f3a8](https://github.com/redtidev1918/TelePost/commit/fc0f3a81978ca247ed5a5bd31abea73d51d3835d))
+
+## [2.20.3](https://github.com/redtidev1918/TelePost/compare/v2.20.2...v2.20.3) (2026-09-13)
+
+
+### Bug Fixes
+
+* **api:** Mini App human review writes are not gated by readonly mode ([#83](https://github.com/redtidev1918/TelePost/issues/83)) ([56466c7](https://github.com/redtidev1918/TelePost/commit/56466c7a409010cb50e5dc77718c9b1c517244d9))
+
+## [2.20.2](https://github.com/redtidev1918/TelePost/compare/v2.20.1...v2.20.2) (2026-09-13)
+
+
+### Bug Fixes
+
+* **webapp:** serve /app/* via one handler (static + SPA fallback) ([#81](https://github.com/redtidev1918/TelePost/issues/81)) ([241643b](https://github.com/redtidev1918/TelePost/commit/241643b39acf5f594823e54097019c9e644d1240))
+
+## [2.20.1](https://github.com/redtidev1918/TelePost/compare/v2.20.0...v2.20.1) (2026-09-13)
+
+
+### Bug Fixes
+
+* **docker:** webapp-builder needs api/openapi.yaml for generate:api ([#79](https://github.com/redtidev1918/TelePost/issues/79)) ([2852572](https://github.com/redtidev1918/TelePost/commit/2852572582236bc08359d205539e179fb4437d78))
+
+## [2.20.0](https://github.com/redtidev1918/TelePost/compare/v2.19.0...v2.20.0) (2026-09-13)
+
+
+### Features
+
+* **webapp:** same-domain static hosting for the Mini App (dist → /app/) ([#77](https://github.com/redtidev1918/TelePost/issues/77)) ([9c718e0](https://github.com/redtidev1918/TelePost/commit/9c718e02ad372a74769be77a583348a17b961bfd))
+
+## [2.19.0](https://github.com/redtidev1918/TelePost/compare/v2.18.0...v2.19.0) (2026-09-13)
+
+
+### Features
+
+* **miniapp:** Telegram Mini App submission & moderation platform ([#74](https://github.com/redtidev1918/TelePost/issues/74)) ([0d05ff2](https://github.com/redtidev1918/TelePost/commit/0d05ff2fbe6934c01df830c9d425f534919113c2))
+
+## [2.18.0](https://github.com/redtidev1918/TelePost/compare/v2.17.6...v2.18.0) (2026-09-13)
+
+
+### Features
+
+* **review:** remote, repeatable, stateful review refetch ([#73](https://github.com/redtidev1918/TelePost/issues/73)) ([80ee189](https://github.com/redtidev1918/TelePost/commit/80ee1899a22a185cc12c012e8b4f3da986e050d0))
+
+## [2.17.6](https://github.com/redtidev1918/TelePost/compare/v2.17.5...v2.17.6) (2026-09-13)
+
+
+### Bug Fixes
+
+* **delivery:** classify media from the final artifact, not from source metadata ([8f9519f](https://github.com/redtidev1918/TelePost/commit/8f9519ff3d5600a03c23e3c019073f7045f6e29f))
+* **delivery:** keep artwork order in album plans and retry rejected photos once ([6196833](https://github.com/redtidev1918/TelePost/commit/619683397778e9dbdc1c686c003e137b30f1b413))
+* **delivery:** 依据最终产物分类媒体，让压缩后达标的大图回到 photo 而不是 document ([87fbd07](https://github.com/redtidev1918/TelePost/commit/87fbd0716a96f5c144c783d14c94de5fb72d93e5))
+
+## [2.17.5](https://github.com/redtidev1918/TelePost/compare/v2.17.4...v2.17.5) (2026-09-12)
+
+
+### Bug Fixes
+
+* **submission:** keep slow submissions decidable and idempotent ([#67](https://github.com/redtidev1918/TelePost/issues/67)) ([ca72763](https://github.com/redtidev1918/TelePost/commit/ca72763038c294f590996974ae13f97dd5992c8e))
+
+## [2.17.4](https://github.com/redtidev1918/TelePost/compare/v2.17.3...v2.17.4) (2026-09-12)
+
+
+### Bug Fixes
+
+* **security:** 脱敏 main 上的生产 chatId 并加入全历史凭据门禁 ([cde20e2](https://github.com/redtidev1918/TelePost/commit/cde20e20096f34db6f1d93185dfc65b07b768597))
+* **security:** 补齐 Telegram bot token / chat id 检测规则 ([ba91b0e](https://github.com/redtidev1918/TelePost/commit/ba91b0efc9cec41077c57da765816d0303c4ba71))
+
+## [2.17.3](https://github.com/redtidev1918/TelePost/compare/v2.17.2...v2.17.3) (2026-09-11)
+
+
+### Bug Fixes
+
+* **handlers:** 菜单命中后中止后续 group，消除「关于」等按钮的双重回复 ([#63](https://github.com/redtidev1918/TelePost/issues/63)) ([f1f380b](https://github.com/redtidev1918/TelePost/commit/f1f380b25f219515931300e3b6162dda52d855ed))
+
+## [2.17.2](https://github.com/redtidev1918/TelePost/compare/v2.17.1...v2.17.2) (2026-09-10)
+
+
+### Bug Fixes
+
+* **router:** probe PixivFlow trigger health ([#54](https://github.com/redtidev1918/TelePost/issues/54)) ([e3eff81](https://github.com/redtidev1918/TelePost/commit/e3eff810e339b3c77376e13c6e46d4765bdbb186))
+
+## [2.17.1](https://github.com/redtidev1918/TelePost/compare/v2.17.0...v2.17.1) (2026-09-10)
+
+
+### Fixed
+
+- 宽 + 高超过 Telegram 照片上限（10000）的图片不再按照片发送而失败：体积很小但尺寸很大的原图会自动改为以原图文档发送，投稿与审核照常进行。
+- 每张图片的处理结果都会写进审计记录，包含这次按什么方式发送以及原因（例如「尺寸超过照片上限」），便于事后核对。
+
+## [2.17.0](https://github.com/redtidev1918/TelePost/compare/v2.16.1...v2.17.0) (2026-09-10)
+
+
+### Added
+
+- 投稿、审核、发布全流程留痕：每一步的状态变化都写入本机审计库，日志轮转或进程重启后依然可查，出问题能直接看到某次投稿卡在哪一环。
+- 同一次投稿在下载、投递、审核、发布之间用同一个标识串联，跨环节对账不再靠猜；「依赖尚未就绪」与「真正失败」分开记录，前者不消耗重试次数。
+- 每张图片单独留痕：记录尺寸、体积、解码预算、最终处理方式（原图直发 / 安全压缩 / 使用预览图 / 降级为原图文档）及原因，便于区分是资源不足还是素材本身的问题。
+- 审核与发布状态可直接查询，新增命令行工具查看某条审核的完整流水；当前运行的版本号与提交号在 `/version` 与 `/health` 中可见，便于确认线上跑的是哪个版本。
+- 发布包除原始可执行文件外，同时提供带版本号的 tar.gz / zip 压缩包。
+- 日志与审计记录中的令牌、密钥、请求头等敏感信息统一脱敏后再落盘。
+
+## [2.16.1](https://github.com/redtidev1918/TelePost/compare/v2.16.0...v2.16.1) (2026-09-10)
+
+### Fixed
+
+- 图片在解码前按像素模式和尺寸执行资源预算；超预算原图不再进入 Pillow 全量解码，审核使用可选预览，最终发布安全降级为原图文档。
+- 图片压缩改为生成临时派生文件，原始素材保持不变，成功、失败和重试路径都会清理临时文件。
+- 审核记录先于 Telegram 预览落库；控制消息失败会补偿清理，进程重启会修复未完成记录，避免永久留下无按钮预览。
+- `/ready` 仅在数据库迁移、Bot、投稿与审核恢复完成后返回成功，供上游 outbox 冷启动屏障使用。
+
+## [2.16.0](https://github.com/redtidev1918/TelePost/compare/v2.15.1...v2.16.0) (2026-09-09)
+
+
+### Features
+
+* **api:** idempotent direct publish + reuse envelope (idempotent_replay vs duplicate_existing), reconciliation lookup, fast startup, stable webhook secret ([91eaa48](https://github.com/redtidev1918/TelePost/commit/91eaa489d768839f15a7762b0273edd5742302cb))
+* **api:** idempotent direct publish + reuse envelope, /live /ready probes, fast startup, stable webhook secret ([9e4a861](https://github.com/redtidev1918/TelePost/commit/9e4a861f8449bc2521d3f99ced8169554328dd37))
+* **startup:** /live vs /ready probes, bounded router child-readiness gate, background post-ready init ([61ee99f](https://github.com/redtidev1918/TelePost/commit/61ee99ffc3ef2791f17593d1ebde86caad26bcb3))
+
+## [2.15.1](https://github.com/redtidev1918/TelePost/compare/v2.15.0...v2.15.1) (2026-09-09)
+
+
+### Bug Fixes
+
+* **submit:** allow 100 files in chat uploads ([#25](https://github.com/redtidev1918/TelePost/issues/25)) ([9d7937a](https://github.com/redtidev1918/TelePost/commit/9d7937a2dd8f0cce4681d45b91a96d5153592a91))
+
+## [2.15.0](https://github.com/redtidev1918/TelePost/compare/v2.14.0...v2.15.0) (2026-09-08)
+
+
+### Features
+
+* **review:** add AI review MCP facade ([62a2ae7](https://github.com/redtidev1918/TelePost/commit/62a2ae706f4110aaba1ca3c9f8862daffc8de9a9))
+
+## [2.14.0](https://github.com/redtidev1918/TelePost/compare/v2.13.0...v2.14.0) (2026-09-08)
+
+
+### Features
+
+* **api:** generic bounded source provenance, replacing PixivFlow slot enum ([ee70b42](https://github.com/redtidev1918/TelePost/commit/ee70b42c6aa101235736cd19b094199954740516))
+
+## [2.13.0](https://github.com/redtidev1918/TelePost/compare/v2.12.0...v2.13.0) (2026-09-08)
+
+
+### Features
+
+* **api:** label scheduled submissions with their slot + proxy internal trigger ([f7c3a5e](https://github.com/redtidev1918/TelePost/commit/f7c3a5ecdfbade1cbb6f557eb9ab522cee42c781))
+
+## [2.12.0](https://github.com/redtidev1918/TelePost/compare/v2.11.2...v2.12.0) (2026-09-08)
+
+
+### Features
+
+* **review:** 点发布后立即显示「正在发布…」并移除按钮 ([1127628](https://github.com/redtidev1918/TelePost/commit/112762865a0422a0d52424f3fdaa281b7771d973))
+
+## [2.11.2](https://github.com/redtidev1918/TelePost/compare/v2.11.1...v2.11.2) (2026-09-08)
+
+
+### Bug Fixes
+
+* **review:** 评论区发布完整回滚+自动重试+僵尸解锁+准确失败提示 ([068ad32](https://github.com/redtidev1918/TelePost/commit/068ad3296af69e4f0e5c94b265f9f2c48aac3a47))
+
+## [2.11.1](https://github.com/redtidev1918/TelePost/compare/v2.11.0...v2.11.1) (2026-09-08)
+
+
+### Bug Fixes
+
+* **publish:** discussion 评论模式在非 Webhook 模式启动时明确告警 ([dbf0ab0](https://github.com/redtidev1918/TelePost/commit/dbf0ab0358b98471eee260fae05b7a3d42657df8))
+* **review:** 发布失败后主按钮显示为「🔄 重试发布」 ([33153d2](https://github.com/redtidev1918/TelePost/commit/33153d2468a0a5f5fe54ea6cac7fd125b8142345))
+
+## [2.11.0](https://github.com/redtidev1918/TelePost/compare/v2.10.44...v2.11.0) (2026-09-08)
+
+
+### Features
+
+* discussion 模式把多图其余部分发到频道关联讨论组评论串 ([4925211](https://github.com/redtidev1918/TelePost/commit/4925211e8b57d3876ae7c9b9a5f634239996f175))
+
+## [2.10.44](https://github.com/redtidev1918/TelePost/compare/v2.10.43...v2.10.44) (2026-09-06)
+
+
+### Bug Fixes
+
+* **docker:** install ffmpeg in runtime-pixivflow stage for ugoira GIF conversion ([cf6a143](https://github.com/redtidev1918/TelePost/commit/cf6a14325f692b7b50258f51f0d3057da35efeae))
+
+
+### Documentation
+
+* **site:** 独立自动化的下载页（发版自动更新，始终指向最新 Release） ([4b7c53a](https://github.com/redtidev1918/TelePost/commit/4b7c53adbe3209981f36c43dad2637e5adfe94d6))
+* **site:** 首页顶部新增「下载」区块（带二进制发布的项目） ([b094528](https://github.com/redtidev1918/TelePost/commit/b0945280e9ab4b294ee0fe1d20e1ff20ec30c49b))
+
+## [2.10.43] - 2026-09-06
+
+### 修复
+- 相册降级为单张发送时，继续保持所选的回复层级，避免图片脱离主贴或回复错位。
+- 修复聊天直接投稿时开启剧透遮罩却未生效的问题，单张和相册均正确显示遮罩。
+- 修复图片与文档混合投稿后保存的文件类型、文件编号及文件名错配。
+
+### 文档
+- 补充相册降级时的回复规则、频道回复与讨论区评论的区别，以及升级验证说明。
+
+## [2.10.42] - 2026-09-05
+
+### 新增（可配置）
+- **多图投稿的频道展示方式可调**：超过一组相册（>10 张）时，默认每个相册回复上一个相册（逐级链）；设
+  `CHANNEL_ALBUM_REPLY=post` 后改为「后续相册都回复第一条主贴」，整组跟着主贴走，频道里不再嵌套成一串回复。
+- **投稿文件数上限可调**：默认单次 50 个文件；设 `API_MAX_FILES`（如 100）可支持超大图集整本投稿（发布侧仍按每组 ≤10 自动分批）。
+
+### 文档
+- 配置参考补充两项配置说明，以及已部署实例的调整方法（`fly secrets set` 后自动重启生效）。
+
+## [2.10.41] - 2026-09-05
+
+### 修复
+- **大投稿不再超时失败**：审核通过后发布超时提高到 120 秒，20 图等大投稿在网络慢时也能稳定发出。
+- **不再重复投稿**：发布结果不确定（网络超时）时，不再自动降级重发相册，避免同一作品被重复投进频道；改为提示先到频道确认是否已发出。
+
+## [2.10.40] - 2026-09-04
+
+### 修复
+- 修复关闭 API 审核时自动化投稿误报 502；直接发布与审核投稿均可正常使用。
+- 重复投稿复用既有审核记录时，会在审核群提示原审核编号和当前状态，不再静默返回成功；
+  API 同时返回 `reused=true`，并补齐旧审核记录缺失的 `target_id`。
+- 多 Bot 路由在自动唤醒时会短暂等待子进程就绪，避免首个请求过早返回 502。
+
+### 文档
+- 重写安装、配置、命令、API、Webhook、Fly.io、运维、性能、测试与故障排查文档；
+  明确推荐的低成本 Fly 拆分拓扑，并移除过期、重复或未经当前版本验证的部署说明。
+
+## [2.10.39] - 2026-09-04
+
+### 修复
+- **Fly.io 自动休眠后机器人永久失联**：休眠时不再注销 Telegram Webhook，冷启动时
+  也不再丢弃待处理消息；继续使用 auto-stop 省钱时，用户消息和 PixivFlow 投递均可
+  正常唤醒 TelePost。
+
+## [2.10.38] - 2026-09-04
+
+### 优化
+- **「重抓/换一张」只重跑单个 target**：投稿新增 `target_id` 字段（由 PixivFlow 通过
+  `{{targetId}}` 传递），`pending_reviews` 增加 `target_id` 列；审核员点「重抓」时
+  只重跑产生该审核的那一个 target（`pixivflow run-once --target <id>`），从全量
+  schedule（最坏 2×30 分钟）压到单 target（秒级～分钟级）。
+
+## [2.10.37] - 2026-09-04
+
+### 修复
+- **审核「重抓/换一张」超时误报**：`run-once` 串行跑完所有启用 schedule，每个受
+  `plan.timeout`（生产 1800s）watchdog 保护，2 个 schedule 最坏约 3600s；TelePost 侧
+  子进程超时从 1500s 提到 3900s，避免在下载途中掐断并误报 `timed out after 1500 seconds`。
+- **已发布作品软去重**：同一 `idempotency_key` 的 `published` 记录在 7 天内再次投递时
+  直接跳过（返回已发布记录），防止 PixivFlow 去重失效把已发布作品重新投进审核群造成
+  「审核完了又转发」；`rejected` / 更早的 `published` 仍允许重建审核（换一张/重新考虑）。
+
+## [2.10.36] - 2026-09-04
+
+### 新增（开箱即用部署：零依赖可执行文件）
+- **免安装单文件版**：Linux / Windows / macOS（Apple Silicon）各出一个 `telepost` 单文件，
+  下载即用，**不需要装 Python、Docker 或 WSL**；Intel Mac 请用 install.sh 或 Docker。
+- **首次运行向导**：第一次启动自动引导填写 Token / 频道 / 所有者三项，填完即用；
+  也可随时 `telepost --setup` 重新配置。
+- **Windows 原生支持**：新增 `install.bat` / `run.bat`，Windows 直接双击即可，无需 WSL 或 Docker。
+
+### 改进（安装更顺滑）
+- `install.sh`：Debian / Ubuntu 缺组件时自动补装，不再直接失败。
+- Docker 默认配置改为开箱可用的生产默认值，配置改由 `.env` 注入，不再需要手动改网络 / DNS。
+
+---
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+## [2.10.33] - 2026-09-03
+
+### 改进（超大图片压缩投稿，不再降级成文件）
+- **超过 Telegram 照片上限（约 10 MiB）的本地原图自动压缩**：新增
+  `handlers.publish._compress_photo`（Pillow）——尺寸先缩到 4096px，再逐级降
+  JPEG 质量（92→60），压到阈值内后**仍按图片发送**，频道里直接看图；
+  压缩失败（无法解码/极端情况）才回退为文档发送兜底。
+- `reclassify_oversized_photos` 语义从"超限即降级 document"改为"先压缩、
+  失败才降级"；压缩后文件名统一 `.jpg`。覆盖 API 投稿与审核暂存两条路径。
+- 新增依赖 `Pillow>=10`；新增回归测试 `test_oversized_photo_is_compressed_not_demoted`
+  （433 项全过）。
+
+## [2.10.32] - 2026-09-03
+
+### 修复（投稿状态机从未真正注册——"半套流程"最终根因）
+- **ConversationHandler `persistent=True` 但 Application 未配置 persistence**：
+  PTB 直接抛 `ValueError`，被 `setup_application` 的 try/except 吞掉，导致
+  投稿状态机**从未成功注册**。这是"点开始投稿按钮只建 DB 会话、发媒体
+  掉出状态机静默无响应/会话已过期"的最终根因。现移除 `persistent=True`
+  （此前无 persistence 时它一直无效且致命）。
+- 状态机构建抽到 `handlers/conversation.py`（`build_submission_conversation`），
+  生产与测试复用同一份注册。
+- 新增**端到端集成测试** `tests/test_conversation_flow.py`：用真实
+  ConversationHandler + 真实 DB 跑 `/submit → 媒体 → 文档 → /done_media →
+  编辑标签 → 发布` 全链路；432 项测试全过。
+
+## [2.10.31] - 2026-09-03
+
+### 重构（投稿流程收敛，消除双轨状态与重复归类）
+- **状态机收敛为三态**：`UPLOAD`（上传）→ `PREVIEW`（预览面板）→ `EDIT`
+  （快速编辑，`context.user_data['edit_field']` 区分字段）。删除
+  `START_MODE/DOC/DONE_MEDIA/TAG/LINK/TITLE/NOTE/SPOILER/TEXT/IMAGE/EXTRA`
+  及 5 个 `EDIT_*` 状态号——此前 0–18 共十余个状态里大半是死状态，
+  且与 DB `submissions.mode` 双轨漂移导致"半套流程"（按钮只建 DB 行、
+  不进状态机）。
+- **媒体/文档合一**：`media_handlers`/`document_handlers` 的互转逻辑合并为
+  `handlers/upload.py` 的 `handle_upload`；删除 `submit_handlers.py`
+  （老"标签→链接→标题→简介"逐项问答，已被预览面板取代）。
+- **归类单一实现**：消息→`type:file_id` 的归类收敛到
+  `utils.submission.classify_message`，新增会话读写
+  `get_session/create_session/append_entry/update_fields`，替代散落在
+  4 个文件里的重复 SQL。
+- **删除死代码**：`select_mode`、`show_*_welcome` 多分支、
+  `Keyboards.submission_confirm` 及 `handle_submit_*` 回调（旧投稿确认流程）。
+- 测试同步收敛：新增 `tests/test_upload.py`，重写 `test_preview_pagination`/
+  `test_handlers`/`test_logic_flow`；431 项全过。
+
+## [2.10.30] - 2026-09-03
+
+### 修复（聊天投稿"发媒体无响应"）
+- **底部菜单「📝 开始投稿」按钮不进状态机**：此前 `handle_menu_shortcuts` 直接
+  调 `submit()`，只建 DB 会话、不建立 ConversationHandler 内存状态，用户随后
+  发送的媒体/文件会掉出状态机、静默无响应。现将该按钮文本作为
+  ConversationHandler 的 entry（`Regex 开始投稿$`），点按钮与 `/submit` 命令
+  走完全相同的状态机入口。
+- **会话外媒体不再石沉大海**：新增 `orphan_media_guard`（group 997）——状态机
+  因重启/超时/误操作丢失时，用户直接发媒体会收到明确提示"请先 /submit"，
+  而不是没有任何回应；有活跃会话时不打扰流程。
+- **埋点**：`validate_state` 无会话行、`end_conversation_with_message` 现在记录
+  `user_id` 与触发函数，复现"❌ 会话已过期"时可从日志精确定位来源。
+- 430 项测试全过。
+
+## [2.10.29] - 2026-09-02
+
+### 修复（实机压测暴露）
+- **审核"控制消息"裸 send_message 导致整条投稿偶发回滚**：控制消息紧跟在
+  媒体相册之后发送，正落在 Telegram flood 窗口内；此前未走限流包装、用 PTB
+  默认 5s read 超时，Telegram 慢回复（flood 排队/网络抖动）时 ReadTimeout，
+  `_create_review` 把已全部发出的预览相册删除并回滚，API 返回 502
+  `review_queue_failed: Timed out`。现控制消息与预览相册一样走
+  `_send_preview_throttled`（RetryAfter 感知 + 指数退避重试），并给足
+  `REVIEW_PREVIEW_TIMEOUT_SECONDS` 超时。
+- **审核预览限流退避指数化**：Telegram flood 窗口较长时（如多投稿并发涌入，
+  `Retry after 18 seconds`），此前每次只等 `retry_after+1s`、固定 5 次仍会被
+  拒。现按 `retry_after × 2^attempt` 退避（上限 60s/次），长 flood 窗口可自愈。
+- 新增回归测试：控制消息遇 RetryAfter 自动重试且不误删预览（430 项全过）。
+
+## [2.10.28] - 2026-09-02
+
+### 修复
+- **API 直发（`API_REVIEW_REQUIRED=false`）媒体/文档全部丢失**：`publish_from_files`
+  构造 `InputFile` 时漏传 `attach=True`，python-telegram-bot 序列化媒体组时
+  丢掉每个 `InputMedia` 的 `media` 字段（无 `attach://` 引用），Telegram 回
+  `media not found`——表现为 API 直投的插画相册发不出去/图片不可见、小说
+  `.txt` 文档组同样失败。审核路径（`queue_review_from_files`）此前已有
+  同名修复，但直发路径一直漏修。现在两条路径一致使用 `attach=True`。
+
+### 重构（层级统一）
+- **频道发布与审核群预览共用一套主贴/回复层级**：此前"聊天投稿直发、
+  API 本地文件直发、API file_id 直发、审核群暂存"四处各写一份相册分组/
+  caption/回复链逻辑，规则互相打架（相册成员混入 GIF、文档组 caption 位置
+  不一致、组大小阈值不同）。现统一到 `handlers.publish` 的
+  `deliver_items_to_chat` / `_run_item_batches`，规则唯一：
+  1) photo/video 每 10 个一组相册；
+  2) GIF/音频不能进相册，逐条发送；
+  3) document（小说 .txt、ugoira .zip、超 10 MiB 图片页）按文档相册发送，
+     投稿含媒体时整段作为主贴的回复；
+  4) caption 只挂整条投递的第一条消息（`build_caption` 已按 1024 上限
+     截断，不再单独发"文本头"造成多余主贴/回复）；
+  5) 各段之间按回复链串联；相册失败自动降级逐条。
+- 聊天投稿/直发/审核共用的"超 10 MiB 图片自动改按文档发送"逻辑提取为
+  `handlers.publish.reclassify_oversized_photos`，阈值单一来源。
+- **启动防呆**：`REVIEW_CHAT_ID` 若等于 `CHANNEL_ID`（审核预览、控制消息、
+  PixivFlow 通知会以"奇怪回复/散帖"混进频道），启动直接报错拒绝；
+  `/botconfig` 面板也拒绝把审核群切到频道。
+
+## [2.10.27] - 2026-09-02
+
+### 清理（审计驱动）
+- 移除 `main.py` 未使用的 `blacklist_filter` 导入，以及 4 个处理器中从未使用的
+  `user_id` 局部变量赋值。仅清理死代码，零行为变更；419 测试全过。
+
+## [2.10.26] - 2026-09-02
+
+### 修复
+
+- 审核群「🔄 重抓/换一张」按钮此前调用 `pixivflow scheduler run`——那是
+  PixivFlow 调度**守护进程**的别名，进程永不退出，导致 TelePost 的 1500 秒
+  子进程超时并报「重抓任务出错」。现改用 PixivFlow 新增的一次性命令
+  `pixivflow run-once`（跑完全部启用计划即退出，行为与定时任务一致），
+  重抓在下载完成后会正常结束并回执「✅ 重抓完成」。
+
+## [2.10.25] - 2026-09-02
+
+### 修复
+
+- API 的 `title`/`note` 字段统一在 multipart 与 JSON 共用入口解析字面量
+  `\\n`、`\\r\\n`，避免配置模板中的换行被原样显示；同时删除两个未使用的 UI/处理器残留，
+  并移除 Python 标准库已提供的 `configparser` 生产依赖。
+- 移除统计刷新和删帖检测中“把频道帖子临时转发给 OWNER 再删除”的探测方式，避免私聊中
+  偶发闪现审核/频道内容；同时停止每个 Bot 的两项无效轮询，降低 Telegram API 请求和日志噪音。
+- 热榜刷新仅重读本地统计。Telegram Bot API 无法无副作用获取任意频道帖的浏览、转发统计，
+  也不会推送频道删帖事件；TelePost 自身删帖仍会同步软删除，外部删帖需用 `/delete_posts` 同步。
+- 修复混合聊天投稿只有 1 个文档时错误调用 `sendMediaGroup`、GIF/音频被放入不受支持的
+  相册、11/21/31 张媒体的单张尾组导致发布失败，以及长说明单独发送失败后内容被静默
+  丢弃；非相册媒体与尾组改为回复链发送，已知的中途失败会回滚已发送片段。
+- 索引重建失败时会删除残缺目录并恢复旧索引，不再因新目录已创建而跳过备份恢复。
+- SIGTERM/SIGINT 改由主协程顺序完成清理，不再用 `loop.stop()` 中断 `asyncio.run()`；
+  OWNER 通知发生不确定网络错误时不再盲目补发，避免可能的重复私聊。
+
+## [2.10.24] - 2026-09-01
+
+### 新增
+
+- 新增仅 `OWNER_ID` 可用的 Telegram `/botconfig` 面板，可修改当前 Bot 的投稿频道、
+  审核群、API/聊天审核开关和频道署名总开关；运行策略原子保存在各 Bot 持久目录，
+  应用后只重载当前 Bot 子进程，不重启另一个 Bot、PixivFlow 或 Fly Machine。
+
+### 安全与稳定性
+
+- 频道和审核群会通过 Telegram 校验类型、Bot 管理员身份及频道发帖权限；存在待审核
+  投稿时拒绝切换频道、审核群或恢复部署配置，避免旧稿误发到新频道。
+- Bot Token、Owner、管理员列表和 Webhook 密钥不进入聊天配置面板；
+  `/botconfig reset` 可删除运行时覆盖并恢复部署环境变量。
+
+### 文档与测试
+
+- 更新配置、命令和运维文档，说明双 Bot 单进程重载语义与完整命令用法。
+- 新增运行策略白名单、原子写入、权限边界、链接解析和多 Bot 隔离回归测试；
+  完整测试 413 项通过、1 项按预期跳过。
+
+## [2.10.23] - 2026-09-01
+
+### 修复
+
+- `/health` 不再因 Node.js 24 把 Linux 线程名显示为 `MainThread` 而漏报
+  PixivFlow RSS；采集器会用进程 cmdline 识别 Node，512 MiB 内存余量重新可信。
+
+### 测试
+
+- 新增 Node 进程名变化的 `/proc` RSS 采集回归测试。
+
+## [2.10.22] - 2026-09-01
+
+### 修复
+- 🐛 **搜索/热榜翻页按钮失效**：`/search` 与 `/hot` 多页结果的 ⬅️/➡️ 翻页按钮
+  此前接到一个未实现的空壳处理函数，点击只弹“跳转到第 N 页”却不刷新内容。
+  现已按存储的查询上下文重新渲染对应页（复用既有 `render_search_page` /
+  `get_hot_posts`），上下文过期时优雅降级为提示。
+
+### 维护
+- 🧹 全仓死代码清理（零行为变化，pyflakes/pytest 双重把关）：删除从未注册的
+  错误处理函数与 `if False:` 调试块、4 个零调用的 `*_safe` 包装、重复的
+  `calculate_heat_score`、不可达的 TEXT/IMAGE/EXTRA 会话状态及其 no-op
+  lambda 占位、一批未使用导入；`health.py` 作为对外保留的旧轮询入口保留。
+- 📝 文档：API.md 补充审核群「🔇 遮罩开关」「🔄 重抓/换一张」按钮说明与审核
+  记录状态机（含 `expired`/`deleted`）；修正路由限额注释（50 文件 / 500 MiB）；
+  移除 COMMANDS.md 中已不存在的 `/done_img` 旧图片流程。
+
+## [2.10.21] - 2026-09-01
+
+### 安全与维护
+
+- 联合运行镜像改用 Node.js 24 LTS，并把内置 PixivFlow 从 2.8.0
+  更新到 2.10.21；生产依赖不再建立在已结束安全维护的 Node.js 20 上。
+- 发布工作流升级到当前 `actions/checkout` 主版本。
+
+### 文档
+
+- Fly 双 Bot 模板与 Docker 默认构建参数统一固定 PixivFlow 2.10.21，
+  避免直接使用仓库 Dockerfile 时静默部署旧版调度器。
+
+## [2.10.20] - 2026-09-01
+
+### 改进
+
+- `POST /api/v1/notifications` 的幂等键由进程内存改为 SQLite 原子占位：
+  Bot 重启后仍可识别重复通知，发送失败会释放占位供 PixivFlow outbox
+  重试；异常中断的 pending 占位 5 分钟后可恢复。
+- 通知幂等记录与已决审核记录共用 `REVIEW_RETENTION_DAYS`
+  的定期清理周期，避免 SQLite 表无限增长。
+- 修正 `GET /api/v1/me` 查询限额时使用 token ID，而投稿计数使用
+  Telegram user ID 的键不一致问题。
+
+### 测试
+
+- 新增 API 通知跨重启幂等、失败释放与过期清理回归测试。
+
+## [2.10.19] - 2026-08-31
+
+### 新增
+- 🔇 **审核群可决定频道遮罩**：审核键盘新增"遮罩：开/关"按钮，审核员可在发布前
+  翻转该投稿的 `has_spoiler`，初始值沿用投稿者设置；发布以数据库当前值为准。
+- 🔄 **审核群"重抓/换一张"**：对 Pixiv 自动投稿（HTTP API + Pixiv 链接）新增
+  "重抓/换一张"按钮，审核员点击后在后台触发一次 `pixivflow scheduler run`，
+  已下载作品自动跳过并选取下一张，新稿作为新审核记录进群；不影响已发布的旧稿。
+  仅管理员可用，PixivFlow 未启用时按钮不触发。
+
+## [2.10.18] - 2026-08-31
+
+### 新增
+
+- 新增鉴权端点 `POST /api/v1/notifications`，供 PixivFlow 等自动化在没有候选时
+  向当前 Bot 的 `REVIEW_CHAT_ID` 发送纯文本运维通知，不创建空投稿或频道消息。
+- 支持最长 240 字符的 `idempotency_key`；同一进程 24 小时内的网络重试返回
+  `duplicate`，避免审核群重复提示。通知复用投稿 Bearer Token，Bot Token 不外泄。
+
+## [2.10.17] - 2026-08-31
+
+### 安全
+
+- Webhook Secret Token 校验改用恒定时间比较 `hmac.compare_digest`，替代普通
+  `!=` 逐字节比较，避免通过响应耗时差异逐字节推断 token（时序侧信道）。
+  错误 / 缺失 / 前缀相似的 token 仍一律返回 401；新增对应鉴权测试。
+
+## [2.10.16] - 2026-08-31
+
+### 修复
+
+- 修正 JobQueue 每天 03:00 执行同步日志清理回调时产生的
+  `TypeError: object NoneType can't be used in 'await' expression`；日志清理与
+  04:00 PixivFlow 维护现均为真正的异步回调，阻塞文件/子进程操作移到工作线程。
+- 多 Bot 模式只由主 Bot 注册日志清理和 PixivFlow 维护，避免同一目录被重复清理；
+  每个 Bot 自己的审核队列清理仍保持独立运行。
+- 03:00/04:00 维护时间显式使用 `TZ`（默认 `Asia/Shanghai`）。此前无时区的时间被
+  JobQueue 按 UTC 解释，东八区实际会延后到 11:00/12:00；无效 `TZ` 现安全回退 UTC。
+
+## [2.10.15] - 2026-08-31
+
+### 修复
+
+- 频道消息软删除（`published_posts.is_deleted=1`）时，同步将对应审核记录从
+  `published` 更新为 `deleted`；数据库初始化会自动回填旧版已经错位的历史数据。
+  `published` 现在只表示当前仍未标记删除的已发布审核结果。
+- `/health` 的 `storage.review_queue.by_bot` 增加 `deleted` 历史终态计数，
+  避免运维时把已删除稿误判为当前在线发布。
+
+## [2.10.14] - 2026-08-31
+
+### 改进
+
+- 新增 `PENDING_REVIEW_RETENTION_DAYS`（默认 `0`，不自动过期）与
+  `PENDING_REVIEW_CLEANUP_BATCH_SIZE`（默认 `100`）：部署者可让长期无人处理的
+  `pending` 投稿自动变为 `expired`，同步删除审核群中的媒体、文档与控制消息。
+- 过期不会直接抹掉数据库审计记录；`expired` 记录与其他终态记录一样，之后再由
+  `REVIEW_RETENTION_DAYS`（默认 30 天）清理。原始上传文件在进入审核群后仍立即删除，
+  因此等待审核不会占用常驻内存或本地媒体存储。
+- Telegram Bot API 只保证删除发送后 48 小时内的消息；希望自动清理审核群时建议将
+  待审核保留期设为 `1` 天。更长保留期仍会正确过期数据库记录，但旧群消息可能需手动删除。
+
+## [2.10.13] - 2026-08-30
+
+### 修复
+
+- 多 Bot 模式只由 Bot1 注册每日 PixivFlow 全局维护任务；其余 Bot 明确跳过，避免
+  多个子进程在 04:00 同时清缓存和 `VACUUM` 同一个数据库。单 Bot 模式行为不变。
+
+## [2.10.12] - 2026-08-30
+
+### 修复
+
+- **`api_uploads` 目录泄漏**：上传会话清理原来依赖 aiohttp 任务 done-callback，
+  并非所有执行路径都会触发（实测多页大上传后残留 90MB 级孤儿目录）。
+  现在新增后台清扫器：每小时删除超过 `UPLOAD_SESSION_MAX_AGE_SECONDS`
+  （默认 1 小时）的孤儿会话目录，配合原有回调双保险，持久卷不再被慢速累积占满。
+
+### 改进
+
+- 定期清理扩展到 `pending_reviews`：已决（rejected/published/failed）且超过
+  `REVIEW_RETENTION_DAYS`（默认 30 天）的审核记录自动删除；pending 记录绝不动。
+- 每天 04:00 自动执行 `pixivflow maintain`（子进程）：清理日志/备份、VACUUM
+  优化 SQLite，配合 `deleteAfterDelivery=false` 的缓存保留策略控制存储增长。
+
+## [2.10.11] - 2026-08-30
+
+### 改进
+
+- 超大图片自动按文档发送（参考 t.me/Pixiv_bot 的传输策略）：Telegram 图片
+  （含相册）单张上限 10 MiB，超过会被拒绝；现在本地暂存阶段对超过
+  `PHOTO_MAX_BYTES`（默认 9.5 MiB）的页面自动改按 document 发送（document
+  上限 50 MiB），大尺寸原图不再导致整份投稿进不了审核群。
+
+## [2.10.10] - 2026-08-30
+
+### 修复
+
+- 审核群相册上传真正生效：此前相册里的本地文件 `InputFile` 未启用 `attach` 模式，
+  python-telegram-bot 会把每个 `InputMedia` 的 `media` 字段丢弃（没有 `attach://` URI），
+  Telegram 返回 `Can't parse inputmedia: media not found`，相册每次都会静默降级为
+  逐张发送——多页作品虽然能进审核群，但一直是一张一张的消息而不是相册。
+  现在 `attach=True` 保留 `attach://` 引用，5 张一组的小相册 + 组间回复链真正生效；
+  降级逐张逻辑仍作为相册发送失败时的兜底保留。
+
+## [2.10.9] - 2026-08-30
+
+### 修复
+
+- 幂等键语义修正：`idempotency_key` 只在审核仍处于 `pending`/`failed` 时去重；
+  已被**拒绝或已发布**的旧记录不再阻断同一 key 的新投稿——例如 PixivFlow 定时任务
+  次日又选中同一作品时，会删除旧记录与旧预览并创建全新的审核记录，
+  而不是静默返回旧结果（此前会导致新投稿不进审核群）。
+
+## [2.10.8] - 2026-08-30
+
+### 改进
+
+- 审核群相册预览改为「小相册 + 自动降级」，避免小内存机器 OOM：
+  - 新增 `REVIEW_ALBUM_SIZE`（默认 5，合法范围 1–10），控制每条 media group 打包的媒体数；
+    512 MiB 机器用小相册即可把 Telegram 上传阶段的 RSS 峰值压在单张量级。
+  - 相册发送失败（超时 / 连接中断 / 限流重试耗尽）时自动**降级为逐张发送**，整份投稿不会
+    因为相册一次性上传失败而整体失败；逐张之间保留原有 `RetryAfter` 退避与节流。
+  - 相册返回消息数不一致时先把已发送消息记入清理列表再报错，避免失败时残留部分预览。
+
+## [2.10.7] - 2026-08-30
+
+### 修复
+
+- 标签净化：Telegram hashtag 只接受字母、数字、下划线和中文/假名/韩文等非 ASCII 字母，
+  包含 `-`、`/`、`()` 等字符的标签不会被官方客户端识别为可点击标签
+  （如 `#r-18` 只会解析成 `#r`）。`process_tags` 现在按逗号/空白/斜杠拆分后去除所有
+  非法字符，并把 `r-18 / r 18 / r_18` 统一归一为 `#r18`、`r-18g` 归一为 `#r18g`；
+  数字开头的 Pixiv 标签保持原名。PixivFlow 传入的 `中文/中国語/chinese`、
+  `カフカ(スターレイル)` 等作品标签现在都能正确渲染为可点击标签。
+- 审核群多页预览改为「相册 + 回复链」：同一投稿的图片/文件按每批 ≤10 组包成 Telegram
+  media group（相册）发送，29 页作品显示为 3 个相册而不是 29 条散消息；相册之间、以及
+  小说 `.txt` 等单文件消息都会回复上一条，群内仍是一组完整回复链。单文件投稿（如小说）
+  仍带完整 caption，保留 `file_id` 复用与限速/退避。`REVIEW_PREVIEW_THREAD=0` 可关闭回复链。
+- 相册仅组合 Telegram 允许的媒体类型（图片/视频、音频、文档），GIF/animation 保持单发；
+  遇到限流会重新打开本地文件再重试，返回数量异常时整单回滚，避免空上传或静默丢页。
+
+### 新增
+
+- 审核群预览回复链（2.10.6）：多页图集进入审核群时后续预览回复上一条消息。
+- 自动投稿 caption 模板 `{{link}}` / `{{spoiler}}` 变量（配合 PixivFlow 2.10.5）。
+
+## [2.10.5] - 2026-08-30
+
+### 修复
+
+- 多页插画进入审核群时，对每个 Telegram 预览上传显式使用 120 秒读写超时，避免 24 页等大型作品在默认短超时下返回 HTTP 502；可通过 `REVIEW_PREVIEW_TIMEOUT_SECONDS` 调整。
+
+### 改进
+
+- 保留逐页限速、`RetryAfter` 退避和 Telegram `file_id` 持久化；批准后仍复用已上传文件，不重复消耗媒体上行带宽。
+
+## [2.10.4] - 2026-08-30
+
+### 修复
+
+- 修复审核预览遭遇 `RetryAfter` 后重复等待同一个已完成协程、导致重试失败的问题；每次重试现在都会重新创建发送请求并重新打开本地文件。
+- 多页审核预览按可配置的 0.75 秒间隔稳定发送，并完整遵守 Telegram 返回的限流等待时间。
+- Topic 投稿不再因来源主题为空而只保留 `#pixiv`；配合 PixivFlow 2.10.4 可接收计划主题与作品 Pixiv 标签，重复标签会按原顺序去重。
+
+### 改进
+
+- 保留 50 文件上限，同时把单次累计文件体积限制为 500MB，避免一个请求占满低配实例持久卷；父路由和子 API 继续分块流式处理。
+- 修正 Bot/API 自报版本，并在 tag 发布流程校验 tag 与代码版本一致。
+
+## [2.10.3] - 2026-08-29
+
+### 修复
+
+- 审核队列预览逐张发送时增加节流与 Telegram flood 退避（`RetryAfter` 等待后重试）：多页图集（如 24 页 Pixiv 作品）入审核队列不再触发 `Flood control exceeded` 502。
+
+## [2.10.2] - 2026-08-29
+
+### 修复
+
+- 投稿入站文件数上限从 10 放宽到 50：多页插画/图集（如 Pixiv 24 页作品）此前会因 `too_many_files` 400 被拒；发布侧本就支持按每组 ≤10 自动拆成多个 Telegram media group，整本内容完整发出。
+
+## [2.10.1] - 2026-08-29
+
+### 修复
+
+- 修复多 Bot 父路由在守护线程中启动失败的问题：`web.AppKey` 的模块名解析在非模块级调用上下文（daemon 线程）下抛 `UnboundLocalError: module`，导致 8080 路由完全不可用（`/health` 与 `/api/botN/v1` 全部失效）。改用普通字符串 key 存储 aiohttp client session，行为不变。
+
+## [2.10.0] - 2026-08-29
+
+### 改进
+
+- 多 Bot 父路由改为 64 KiB 分块流式转发并复用 aiohttp 连接池，不再把最高 500 MiB 的 multipart 投稿完整复制到内存
+- TelePost 向 Telegram 上传本地媒体时保持文件句柄流式读取，避免媒体组在 Python 进程内形成第二份大字节缓存
+- API 临时上传目录现在覆盖成功、参数校验失败和 Telegram 异常等全部退出路径，避免持久卷长期积累孤立文件
+- 父路由与子 API 显式支持 10 × 50 MiB 的请求上限，同时保留逐文件与文件数量校验
+- tag 发布工作流新增完整 pytest 门禁，测试未通过时不再构建镜像或创建 Release
+
+## [2.9.0] - 2026-08-29
+
+### 新增
+
+- Polling 模式现在与 Webhook 模式提供相同的 `/api/v1/*` 投稿接口，无公网机器也能接收本机或内网 PixivFlow 投稿
+- 多 Bot 父路由在两种运行模式下都固定提供 `/api/botN/v1/*`，切换 Polling、AUTO 或 Webhook 时无需修改投递地址
+
+### 改进
+
+- Polling 的健康检查与投稿 API 和 Bot 运行在同一事件循环，关闭时会完成异步清理
+- 多 Bot 子进程健康/API 端口固定错开为 8081、8082……，避免继承父端口后发生监听冲突
+
+## [2.8.0] - 2026-08-29
+
+### 新增
+
+- `/health` 新增持久卷、PixivFlow cache、delivery outbox 与 API 临时上传指标；outbox 同时报告重试次数、错误文件数和最老任务年龄
+- 新增 Mac 端 `update_telepost_policy.sh`，用非敏感 JSON 校验并一次更新多 Bot 的频道、审核群与审核来源策略
+
+### 改进
+
+- Docker 改为多阶段构建，生产镜像不再包含编译器、npm 和测试工具；Fly 联合档仅保留 Node 运行时与 PixivFlow
+- 生产与测试依赖拆分为 `requirements.txt` 和 `requirements-dev.txt`
+- PixivFlow 远程原子更新脚本固定使用联合部署配置，避免仓库默认 Fly 配置缺失时产生误导警告
+
+## [2.7.3] - 2026-08-29
+
+### 修复
+
+- 兼容新版 python-telegram-bot 使用 tuple 返回图片尺寸，修复 multipart 图片进入审核群后 API 返回 502
+- 审核预览上传后若无法提取 Telegram file_id，会自动删除已上传消息，避免群内残留孤立预览
+
+## [2.7.2] - 2026-08-29
+
+### 修复
+
+- 同步机器人和 HTTP API 自报版本，避免 2.7 系列部署仍显示 2.6.0
+
+## [2.7.1] - 2026-08-29
+
+### 安全
+
+- Webhook Secret Token 不再以明文或截断形式写入启动日志，避免托管平台日志泄露凭据
+
+## [2.7.0] - 2026-08-29
+
+### 新增
+
+- **PixivFlow 联合运行档**：Docker 可选安装 PixivFlow 2.7，现有多 Bot supervisor 同时监督单个 Node 多计划调度进程，异常退出自动重启
+- **Fly 512 MiB 模板**：双 Bot Webhook + PixivFlow 缓存投稿共用一台 Machine，默认关闭搜索、限制 Node heap/SQLite cache，并使用持久卷保存配置与 outbox
+- **SSH 原子热更新脚本**：`scripts/update_pixivflow_config.sh` 校验本地 JSON，SFTP 上传临时文件后同卷替换，无需 WebUI或重启
+
+### 改进
+
+- `/health` 在保留 `python_rss_mb` 的同时新增 `process_rss`，同时展示 Python 与 Node 子进程内存
+- PixivFlow 子进程不会继承 Telegram Bot Token，只接收独立投稿 token 与自身配置
+
+## [2.6.0] - 2026-08-29
+
+### 新增
+
+- **运行模式自适应**：新增默认 `RUN_MODE=AUTO`；有效公网 HTTPS `WEBHOOK_URL` 自动选择 Webhook，否则选择 Polling，Webhook 注册失败时自动安全回退
+- **可选投稿来源审核**：`API_REVIEW_REQUIRED` 与 `CHAT_REVIEW_REQUIRED` 可独立控制 HTTP API 和 Telegram `/submit` 投稿是否进入私有审核群，管理员点击通过/拒绝
+- **审核持久化与幂等**：待审核媒体保存 Telegram file_id，SQLite 记录状态；`idempotency_key` 防止网络重试生成重复审核项
+- **聊天审核结果通知**：聊天投稿通过或拒绝后，Bot 私聊通知原投稿人
+
+### 修复
+
+- API file_id 直投的单个媒体/文档不再错用 `send_media_group`
+
+### 安全
+
+- `/gen_token` 现在仅允许 `OWNER_ID` 对应的 Bot 所有者使用，防止普通用户生成可用于 HTTP API 投稿的访问令牌
+
+## [2.5.0] - 2026-08
+
+### 新增
+
+- **HTTP API（/api/v1）**：token 鉴权的自动化投稿接口——multipart 上传媒体/文档（≤10 个、单文件 ≤50MB），支持标签/标题/简介/链接/匿名/剧透字段，与聊天投稿共用发布、记录、搜索索引与频控链路
+
+- **token 管理**：/gen_token 生成（明文仅显示一次，服务端只存哈希）、/tokens 查看、/revoke_token 吊销；API 投稿按绑定 Telegram 身份记账与限频
+
+- **多 bot API 寻址**：/api/botN/v1/* 按路径转发到对应子进程，各 bot token 体系独立
+
+- **/health 内存自报**：进程 RSS 与系统可用内存（容量观测）
+
+### 文档
+
+- 新增 docs/API.md（接口参考）；README 增加致谢章节并精简措辞
+
+## [2.4.0] - 2026-08
+
+### 新增
+
+- **多 bot 部署形态**：新增 run.py 启动器与多 bot webhook 路由——一台机承载任意数量的频道 bot（BOT1_TOKEN/BOT2_TOKEN/… 各自独立数据目录与回调路径），配合 auto_stop 空闲停机，把两个 bot 的运行成本压到一台机的钱
+
+- **匿名投稿**：发布预览页一键切换匿名，开启后频道内 caption 不再显示投稿人
+
+- **投稿流程精简**：剧透与匿名全部按钮化（预览页开关），砍掉两轮打字往返；未识别输入不再静默，catch_all 兜底引导
+
+- **会话持久化**：投稿会话状态落盘（PicklePersistence），auto_stop 停机/重启/发版后用户可从原步骤继续，根治对话中途失忆
+
+## [2.3.0] - 2026-08
+
+### 修复（2026-08）
+- 修复 20+ 处核心缺陷：发布回调路径失效、删帖功能因 sqlite3.Row.get() 崩溃、帖子统计/原帖查询不存在的列、文档模式切换无法推进会话状态、Webhook 优雅退出中断、caption 未做 HTML 转义导致含 <>& 的投稿发布失败、时间筛选按钮传字符串导致搜索为空、消息存在性检查转发给机器人自身空转、会话超时机制读取从未写入的数据等
+- 恢复被误 ignore 的 health.py（Polling 模式 /health 健康检查，Docker HEALTHCHECK 依赖）
+- 环境变量统一为 `TOKEN`，新增 `BOT_TOKEN` / `TELEGRAM_BOT_TOKEN` 别名兼容（修复按旧文档配置导致启动失败）
+- 新增 `SUBMIT_LIMIT_PER_HOUR` 投稿频率限制（默认 10 次/小时，0 关闭）
+
+
重命名（2026-08）
+- **项目更名为 TelePost**（原 TeleSubmit-v2）：与上游同名项目区分，名称更贴合"频道投稿"主题。仓库地址改为 `redtidev1918/TelePost`，Docker 服务/容器名、systemd 单元名（telepost.service）、健康检查 service 标识同步更新；CHANGELOG 中更早条目保留历史名称。
+
+
新增（2026-08）
+- **发布流水线**：新增 tag 驱动的 GitHub Actions——构建 amd64/arm64 镜像推送 GHCR（x.y.z / x.y / latest 标签），自动创建带 CHANGELOG 摘录的 GitHub Release；docker-compose 内置官方镜像名
+- **发布前编辑流程**：投稿最后一步改为预览确认页，支持发布前快速修改标签/简介、补充媒体或取消（新增 EDIT_TAG/EDIT_NOTE/EDIT_MEDIA 会话状态）
+- **结果列表分页**：/search 与 /hot 支持按钮翻页（⬅️/页码/➡️），查询上下文跨回调保持
+- **投稿频率限制** SUBMIT_LIMIT_PER_HOUR（每用户每小时上限，默认 10，0 关闭）
+
+
变更（2026-08）
+- 投稿发布失败时保留会话数据，避免重传全部媒体
+- 剧透确认步骤严格校验"是/否"，避免错字被静默当作"否"直接发布
+- 搜索功能禁用时不再误建索引目录
+
+
文档（2026-08）
+- 文档体系重构：新增 INSTALL / CONFIGURATION / COMMANDS / OPERATIONS / PERFORMANCE / TROUBLESHOOTING / TESTING 与 internals/moderation.md，重写 README，移除重复与失效文档
+
+
新增
+- **频道消息监听器增强**
+  - 增强频道消息监听器的鲁棒性和错误处理
+  - 支持处理非本项目 bot 发布的不规范帖子
+  - 自动提取和规范化标签（支持 #标签 和 [标签] 格式）
+  - 智能文本清理（移除控制字符、规范化换行、限制长度）
+  - 并发控制机制，防止重复处理同一消息
+  - 完善的错误处理和日志记录
+  - 支持多种消息格式和媒体类型
+  - 自动同步到搜索索引
+- **中文部分匹配搜索支持**
+  - 使用 SimpleAnalyzer 时，支持中文关键词的部分匹配
+  - 搜索"卫宫"可以匹配"卫宫士郎"等包含该关键词的内容
+  - 自动检测中文查询并使用通配符查询优化
+  - 在标题、描述、标签、文件名等多个字段中搜索
+  - 提升中文搜索体验，无需完整输入即可找到相关内容
+- **Webhook 模式支持**
+  - 新增 Webhook 运行模式，与 Polling 模式并存
+  - 支持通过配置文件或环境变量切换模式
+  - 响应速度更快（<1秒），资源消耗更低
+  - 适用于生产环境和云服务器部署
+  - 内置 Secret Token 验证机制
+  - 支持多种部署方式（VPS、Docker、PaaS 平台）
+- **安装脚本增强**
+  - `install.sh` 新增运行模式选择向导
+  - 自动引导用户选择 Polling 或 Webhook 模式
+  - Webhook 模式自动验证 URL 格式
+  - 配置完成后显示摘要信息
+
+
文档
+- 新增 `docs/WEBHOOK_MODE.md` - Webhook 模式完整指南
+  - 两种模式详细对比
+  - 多种部署方式示例（通用/Docker/PaaS）
+  - 模式切换步骤说明
+  - 故障排查指南
+- `README.md` 新增运行模式章节
+- `SCRIPTS_GUIDE.md` 计划更新（待添加）
+- 更新 `DELETE_POST_GUIDE.md` - 删除功能实现原理说明
+  - 详细说明标记删除（Soft Delete）机制
+  - 数据库字段设计和查询过滤机制
+  - 双向同步删除机制
+  - 数据保留策略和恢复方法
+
+
技术细节
+- 新增 `handlers/channel_listener.py` - 频道消息监听器模块（增强版）
+  - 并发控制机制（`_processing_messages` 和 `_processing_lock`）
+  - 文本清理和规范化函数（`clean_text`、`extract_tags_from_text`）
+  - 字段长度限制常量（防止数据库溢出）
+  - 完善的错误处理和日志记录
+- 新增 `utils/webhook_server.py` - Webhook 服务器模块
+- 更新 `config/settings.py` - 支持 Webhook 配置项
+- 更新 `main.py` - 双模式启动逻辑
+- 新增依赖：`aiohttp>=3.9.0`（用于 Webhook）
+- 新增配置项：`RUN_MODE`、`WEBHOOK_URL`、`WEBHOOK_PORT`、`WEBHOOK_PATH`、`WEBHOOK_SECRET_TOKEN`
+
+
改进
+- **删除功能优化：标记删除机制**
+  - 采用标记删除（Soft Delete）替代物理删除，保留所有历史数据
+  - 数据库记录永久保留，仅标记 `is_deleted = 1` 状态
+  - 所有用户查询自动过滤已删除的帖子（`is_deleted = 0`）
+  - 统计数据保留在数据库中，可用于历史分析
+  - 支持双向同步删除（机器人删除 ↔ 频道删除）
+  - 添加 `is_deleted` 字段索引，提升查询性能
+  - 添加删除状态检查，避免重复删除已标记的帖子
+  - 误删的帖子可以通过数据库操作恢复
+  - 更新 `DELETE_POST_GUIDE.md` 文档，详细说明实现原理
+
+
修复
+- **频道消息监听器** - 增强错误处理，防止异常导致监听器崩溃
+- **消息重复处理** - 添加并发控制，防止同一消息被重复处理
+- **文本长度限制** - 添加字段长度限制，防止数据库溢出
+- **标签提取** - 改进标签提取逻辑，支持多种格式
+- **搜索索引为空问题** - 修复索引为空时搜索无结果的问题，自动重建索引
+- **中文搜索部分匹配** - 修复使用 SimpleAnalyzer 时中文无法部分匹配的问题
+- **端口冲突问题** - health.py 仅在 Polling 模式启动，避免与 Webhook 服务器冲突
+- **Webhook 服务器** - 使用 aiohttp 同时处理 `/webhook` 和 `/health` 端点
+- **优雅关闭** - 正确清理 Webhook 服务器和 Telegram webhook 设置
+
+
测试
+- 本地测试：Polling 和 Webhook 模式均通过
+- 生产部署：256MB 内存环境下稳定运行
+- Telegram Webhook：成功设置并接收消息
+- 健康检查：两种模式均正常响应
+- 验证平台：PaaS 平台、VPS 服务器、Docker 容器
+---
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+## [2.2.0] - 2025-10-25
+
+### 新增
+
+- **一键安装脚本** (`install.sh`):
+  - 自动检测系统环境（Linux/macOS）
+  - 智能检查并安装依赖（Docker/Python）
+  - 交互式选择部署方式（Docker/Systemd/直接运行）
+  - 集成配置向导，引导完成初始配置
+  - 支持多种 Linux 发行版（Ubuntu/Debian/CentOS/RHEL）
+
+- **更新脚本** (`update.sh`):
+  - 自动备份数据和配置
+  - 检测当前部署方式并智能更新
+  - 显示更新内容预览
+  - 支持暂存和恢复本地更改
+  - 自动重启服务
+
+- **重启脚本** (`restart.sh`):
+  - 智能查找并停止所有运行中的机器人进程
+  - 优雅停止（SIGTERM）+ 强制终止（SIGKILL，超时10秒）
+  - 配置文件验证（可选，与 `check_config.py` 集成）
+  - 支持 `--stop` 参数仅停止不重启
+  - 兼容 macOS 和 Linux 系统
+  - 自动处理多个进程实例
+
+- **卸载脚本** (`uninstall.sh`):
+  - 优雅停止所有服务
+  - 可选择保留或删除数据
+  - 自动备份数据（如果选择删除）
+  - 清理 Systemd/Docker 相关配置
+
+### 文档
+
+- **README.md 全面优化**:
+  - 全新的视觉设计，使用表格和图标
+  - 添加项目亮点展示区域
+  - 更清晰的快速开始指南
+  - 优化命令列表展示
+  - 增加详细的使用示例
+  - 使用 Shields.io 徽章
+  - 更清晰的项目结构展示
+
+- **新增 DEPLOYMENT.md**:
+  - 详细的部署指南
+  - 四种部署方式完整说明
+  - 配置说明和示例
+  - 更新和维护指南
+  - 故障排查手册
+  - 安全建议
+
+### 改进
+
+- **部署脚本增强**:
+  - 所有脚本添加彩色输出（红/绿/黄/蓝）
+  - 统一的错误处理和用户反馈
+  - 更详细的进度提示
+  - 支持非交互式运行（Docker 环境）
+  - 添加执行权限检查
+
+- **Makefile 扩展**:
+  - 新增 `check` 命令（检查配置）
+  - 新增 `update` 命令（更新到最新版本）
+  - 优化 `backup` 命令（包含时间戳）
+  - 改进 `status` 命令（显示资源使用）
+
+### 新增文件
+
+- `install.sh` - 一键安装脚本（支持多平台）
+- `update.sh` - 智能更新脚本
+- `uninstall.sh` - 优雅卸载脚本
+- `DEPLOYMENT.md` - 完整部署文档
+
+### 优化
+
+- README 使用更专业的排版和布局
+- 添加更多视觉元素（图标、徽章、表格）
+- 统一文档风格和格式
+- 改进代码示例的可读性
+- 优化移动端阅读体验
+
+### 文档清理
+
+- **精简 README.md**（从 918 行减少到 ~500 行）：
+  - 移除与 DEPLOYMENT.md 重复的部署细节
+  - 移除详细的故障排查内容（指向部署指南）
+  - 移除冗长的配置示例（保留最小配置）
+  - 移除重复的 Docker、更新、安全建议章节
+  - 精简使用示例和依赖列表
+  - 保持核心功能展示和命令参考
+
+- **删除重复/过时文档**：
+  - `DEPLOY_GUIDE.md`（与 DEPLOYMENT.md 重复）
+  - `PROJECT_READY.md`（临时项目状态文件）
+  - `PRIVACY_PROTECTION_SUMMARY.md`（临时总结文件）
+  - `GITHUB_FILES.md`、`GITHUB_UPLOAD_GUIDE.md`、`PUSH_TO_GITHUB.md`（开发临时文件）
+  - `隐私保护完成.md`（中文临时文件）
+
+- **文档结构优化**：
+  - README：项目介绍、快速开始、核心功能、命令参考
+  - DEPLOYMENT.md：详细部署、配置、更新、故障排查
+  - ADMIN_GUIDE.md：管理功能详解
+  - CHANGELOG.md：版本历史记录
+
+---
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+## [2.1.0] - 2025-10-28
+
+### 新增
+
+- **搜索引擎自动适配功能**
+  - 启动时自动检测索引兼容性
+  - 自动备份和重建不兼容的索引
+  - 智能分词器切换（jieba ↔ simple）
+  - 优雅降级处理，确保服务稳定性
+  - 修改配置后重启即可，无需手动重建索引
+
+- **内存优化增强**
+  - 支持移除 jieba 依赖以节省 ~140MB 内存
+  - 优化 Docker 健康检查机制
+  - 改进错误处理和日志输出
+
+### 优化
+
+- **搜索引擎初始化**
+  - 添加 `index.exists_in()` 异常捕获
+  - 改进索引重建流程的错误处理
+  - 更好的备份和恢复机制
+  
+- **文档更新**
+  - 更新 MEMORY_USAGE.md 添加自动适配说明
+  - 优化 README.md 内存优化部分
+  - 整合部署相关文档
+
+### 修复
+
+- **索引兼容性问题**
+  - 修复分词器不可用时的索引加载错误
+  - 修复索引检查失败导致启动失败的问题
+  - 改进备份失败时的降级处理
+
+---
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+
+### 新增
+
+- **搜索引擎**: 集成 Whoosh 全文搜索引擎，支持中文分词（基于 jieba）
+  - 按关键词搜索投稿内容
+  - 按标签快速查找
+  - 搜索结果按相关度和热度排序
+- **数据迁移工具**: 提供 `migrate_to_search.py` 将现有投稿导入搜索索引
+
+### 改进
+
+- **部署脚本增强**:
+  - `deploy.sh` 支持 `--rebuild` 和 `--clean` 选项
+  - `start.sh` 增加更详细的启动检查和功能状态展示
+  - 优化 Makefile，新增 `migrate`、`check`、`dev` 等命令
+- **Docker 优化**:
+  - 容器名称更新为 `telesubmit-v2`
+  - 增加 g++ 编译器支持（用于 Whoosh 编译）
+  - 优化健康检查逻辑（检查主进程而非仅配置文件）
+  - 内存限制提升至 1GB（搜索功能需要）
+  - 新增 `data/search_index` 目录挂载
+- **构建优化**:
+  - 更新 `.dockerignore`，排除更多不必要文件
+  - 更新 `.gitignore`，忽略搜索索引文件
+
+### 依赖更新
+
+- 新增 `whoosh >= 2.7.4` - 全文搜索引擎
+- 新增 `jieba >= 0.42.1` - 中文分词库
+
+### 文档
+
+- 新增搜索功能相关文档（SEARCH_INTEGRATION.md 等）
+- 更新部署脚本的帮助信息
+
+---
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+## [2.0.x] - 之前版本
+
+### 修复
+
+- **索引管理器修复**:
+  - 修复数据库列名错误：`id` → `message_id`
+  - 修复缺失的导入：添加 `os` 和 `shutil`
+  - 统一返回值类型：所有操作返回 `dict` 格式
+  - 简化索引优化逻辑避免 API 兼容性问题
+
+- **修复数据库列名错误**:
+  - `published_posts` 表的主键是 `message_id`，没有 `id` 列
+  - 删除相关说明中误用 `id` 的示例，统一为 `message_id`
+
+### 之前新增
+
+- **帖子删除功能（OWNER 专用）**:
+  - 搜索结果中添加删除按钮（仅 OWNER 可见）
+  - `/myposts` 命令中添加删除按钮（OWNER 专用）
+  - 批量删除命令 `/delete_posts` 支持：
+    - 单个删除：`/delete_posts 123`
+    - 多个删除：`/delete_posts 123 456 789`
+    - 范围删除：`/delete_posts 100-110`
+    - 混合删除：`/delete_posts 100-110 150 200-205`
+    - 最多一次删除 50 个帖子
+  - 完善的权限检查机制（仅 OWNER_ID 用户可删除）
+  - 删除操作包括：
+    - 从数据库标记为已删除（保留历史数据）
+    - 从搜索索引删除
+    - 删除关联的多媒体消息索引
+  - 不删除频道中的实际消息（需手动删除）
+  - 删除后标签统计自动更新
+  - 删除后搜索索引实时更新
+  - 详细的删除统计报告
+
+- **文件名搜索支持**:
+  - 搜索引擎新增 `filename` 字段，支持文件名搜索
+  - 文档上传时自动提取并保存文件名
+  - 多字段搜索：标题、简介、标签、**文件名**
+  - 完全兼容旧数据（历史投稿无文件名）
+
+### 改进
+
+- 数据库 schema 更新：
+  - `published_posts` 表新增 `filename` 字段
+  - 文档存储格式升级：`document:file_id:filename`
+  - 完全向后兼容旧格式
+
+- 搜索引擎优化：
+  - Whoosh Schema 包含 filename 字段
+  - 支持中文分词的文件名搜索
+  - 查询解析器扩展至 4 个字段
+  - 修复搜索结果中文件名显示问题
+
+### 新增工具
+
+- `migrate_add_filename.py` - 数据库 schema 迁移工具
+- `migrate_extract_filenames.py` - 文件名提取迁移说明
+- `FILENAME_SEARCH_UPGRADE.md` - 详细升级指南
+- `test_delete_feature.py` - 删除功能测试脚本
+- `DELETE_POST_GUIDE.md` - 帖子删除功能详细指南
+
+### 安全改进
+
+- 更新 `.gitignore`，增强临时文件保护：
+  - 自动忽略所有 `test_*.py`、`fix_*.py`、`fetch_*.py` 等临时脚本
+  - 自动忽略 `*_FIX.md`、`*_SUMMARY.md` 等临时文档
+  - 保护敏感数据和测试文件不被误提交
+
+### 文档
+
+- 搜索帮助文档更新，说明文件名搜索功能
+- 添加文件名搜索使用示例
+- 更新 README，明确说明搜索范围包含文件名
+ - 移除 README 中对 `docs/INDEX.md` 的失效链接
+
+---
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+## [2.0.0] - 2025-10-25
+
+### 重大更新
+
+这是一个完全重写的版本，采用了更现代化的架构和更好的代码组织。
+
+### 新增
+
+- **模块化架构**: 将代码拆分为多个模块（handlers, utils, config），更易维护
+- **环境变量支持**: 支持通过环境变量配置，方便容器化部署
+- **改进的会话管理**: 使用数据库存储用户会话，支持并发处理
+- **黑名单系统**: 完整的黑名单管理功能，支持添加/移除/查询
+- **搜索功能**: 支持按关键词、标签、投稿人搜索历史投稿
+- **统计功能**: 详细的投稿统计信息和用户排行
+- **批量操作**: 支持一次投稿多个文件/图片
+- **更好的错误处理**: 更友好的错误提示和异常处理
+- **日志系统**: 完整的日志记录，方便调试和监控
+
+### 改进
+
+- **性能优化**: 使用异步操作，提升响应速度
+- **代码质量**: 更好的代码组织和文档注释
+- **配置管理**: 统一的配置管理，支持默认值和验证
+- **用户体验**: 更清晰的提示信息和交互流程
+- **安全性**: 添加权限检查和输入验证
+
+### 架构变化
+
+```
+v1.x (单文件)          →  v2.x (模块化)
+main.py (379行)        →  main.py (主入口)
+                          ├── config/
+                          │   └── settings.py (配置管理)
+                          ├── handlers/
+                          │   ├── basic_handlers.py (基础命令)
+                          │   ├── submission_handlers.py (投稿处理)
+                          │   ├── admin_handlers.py (管理功能)
+                          │   └── search_handlers.py (搜索功能)
+                          └── utils/
+                              ├── database.py (数据库操作)
+                              ├── helpers.py (辅助函数)
+                              └── blacklist.py (黑名单管理)
+```
+
+### 依赖更新
+
+- `python-telegram-bot`: 升级到 21.10
+- 新增 `python-dotenv`: 支持 .env 文件
+- 新增 `aiosqlite`: 异步数据库操作
+- 新增 `psutil`: 系统监控
+
+### 迁移指南
+
+从 v1.x 迁移到 v2.0：
+
+1. **配置文件**: 
+   - 旧版配置可以继续使用
+   - 建议使用新的 `config.ini.example` 作为模板
+
+2. **数据库**:
+   - 旧的 `submissions.db` 可以继续使用
+   - 会自动创建新的 `user_sessions.db` 用于会话管理
+
+3. **命令变化**:
+   - 所有命令保持向后兼容
+   - 新增了搜索和统计命令
+
+### 破坏性变化
+
+- 配置文件读取逻辑改变，现在支持环境变量优先
+- 某些内部 API 已重构，如果你基于 v1.x 做了自定义修改，需要适配新架构
+
+### 修复
+
+- 修复了长时间运行后的内存泄漏问题
+- 修复了并发投稿时的状态冲突
+- 修复了特殊字符处理的问题
+- 改进了文件上传的稳定性
+
+### 文档
+
+- 新增快速开始指南 (QUICKSTART.md)
+- 更新了 README 文档
+- 添加了详细的代码注释
+
+---
+
+## [2.64.2](https://github.com/redtidev1918/TelePost/compare/v2.64.1...v2.64.2) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** await reply_text — /schedule produced zero response ([fb46a4a](https://github.com/redtidev1918/TelePost/commit/fb46a4a))## [2.64.1](https://github.com/redtidev1918/TelePost/compare/v2.64.0...v2.64.1) (2026-09-24)
+
+
+### Bug Fixes
+
+* **automation:** /schedule no response on fresh DB; add interactive wizard ([68013f9](https://github.com/redtidev1918/TelePost/commit/68013f9))---
+
+## [1.0.0] - 初始版本
+
+- 基础投稿功能
+- 简单的管理命令
+- 单文件实现