开发周报：2026-10-26 ~ 2026-11-01

本周概览

这周的产出几乎全部集中在 telefast 上：17 个提交、改动 66 个文件，新增约 8900 行、删除约 180 行。主线有三条：公开门户站点从零搭起来并做了 SEO 收尾，Telegram 公开查询 Bot 落地，榜单频道的自动发布脚本上线并补齐了一堆保护逻辑。

telefast：门户站点上线

周一一开工就在做门户。先落地的是公开频道目录站点，之后几天基本是围绕「能被搜索引擎正确收录」在补细节：

• 加了 sitemap、分享卡片和 SEO 结构化数据；
• 在 robots.txt 里屏蔽 /admin，避免后台页面被抓；
• 开发覆盖配置里保留代理头，这样才能生成正确的 https 协议 canonical 地址；
• 接入了可选的 Umami 访问统计，不配置就不生效，不会强制依赖。

部署侧也调整了一次结构：门户迁到 apex 域名，后台改走独立子域。相关过程记在了 docs/deploy.md，同时把 maco 环境的部署与搜索引擎收录状态也一并写进文档，省得下次自己再靠回忆拼现场。另外修了一个后台的小问题——语言筛选的中文展示名补全了。

Telegram 公开查询 Bot

新增了一个 Telegram 公开查询 Bot，从包结构看是一个独立子包：app.py、telegram.py、config.py、formatting.py、handlers.py，加上 services/search.py，配了较完整的测试（格式化、handler、查询三组）。同时补了 docs/bot.md 和 .env.example。

一个值得单独提的修复：httpx 的日志会打出 Bot token。这个不是功能 bug，是安全问题，提交里直接做了脱敏处理。凡是把 token 放进请求 URL 或头的场景，日志级别一调高就可能整串泄露，这类问题早发现比什么都强。

榜单频道自动发布

后半周把重点放到了 Telegram 榜单频道的自动发布上。先出发布脚本，再逐步加约束，顺序大致是：

1. 新增 TG 榜单频道发布脚本，随后拆出每日发布的调度脚本；
2. 发布前做批次时效检查，过期的批次不再发（文档里同步记了这层保护）；
3. 展示改为连续名次，并明确标注过滤口径——榜上名次不跳号，读者才不会怀疑漏了什么；
4. 默认过滤风险内容以及成人、博彩分类；
5. 增加标题关键词黑名单，作为分类过滤之外的第二道网。

这五条基本都是「先跑通，再防止它出错时难看」的思路。榜单类内容一旦自动发出去就很难收回，所以能做前置检查的地方我尽量前置。

小结

本周的 OpenCode 会话也印证了节奏：从 maco 延迟情况检查开始，中间大段时间花在 Telemetr 风格页面的设计实现上，末尾两次会话都在讨论网站推广方法。也就是说，代码写完只是开始，接下来真正的问题是让人找到它。其余几个项目（xx-panel 系列、tg-stats、tg-boss-assistant、x-reader）本周没有提交或文件改动，不展开。

---