导入 Telegram Serverless 机器人：迁移前后的检查清单

把已有机器人接入新的开发流程，第一步不应是立即修改代码，而是确认它能否导入、云端当前到底运行什么，以及哪些数据和外部依赖不能被误伤。下面的清单面向已经运行在 Telegram Serverless 上的机器人；传统 VPS、轮询程序或第三方 webhook 服务需要先单独评估迁移方式，不能直接当作 Serverless 云端源码导入。

先判断是不是可直接导入的对象

开始前确认四件事：

• 机器人已经启用 Telegram Serverless，而不是由你自己的服务器接收更新。
• 你控制这个机器人的 Serverless CLI Token；普通数字开头的 Bot API Token 不是同一种凭据。
• 当前云端代码是你准备继续维护的正式版本，而不是一份未完成的实验。
• 你知道机器人依赖哪些第三方 API、密钥、付费服务和外部数据库。

BotFatherV2 的导入文档明确说明：直接导入只适用于已有 Telegram Serverless 机器人，并且需要 Serverless CLI Token。传统 VPS、轮询和第三方 webhook 机器人不能直接作为 Serverless 源码导入。产品文档页面未标注发布日期，本文于 2026 年 10 月 10 日核验。

在改动前保存一份可信基线

导入的价值不只是“把文件下载下来”，而是为后续变更建立可追溯的起点。首次导入应记录完整已部署模块集和云端 revision，同时不改变线上代码与业务数据。完成后，建议自己再保存以下信息：

• 机器人用户名、用途和主要负责人；
• 当前可见命令、菜单、按钮与管理员功能；
• 关键表、字段及几条虚构测试记录；
• 外部 API 的用途、负责人、限额和故障表现；
• 导入时间、云端 revision，以及导入报告是否存在警告。

BotFatherV2 会把首次导入的 JavaScript 保留在不可变版本中；以后只把实际修改的模块转换为 TypeScript。未知模块布局会保存在快照里，但可能阻止发布，不能理解为“导入成功就一定能继续发布”。导入报告也是快照记录，不证明旧代码通过了新的本地模拟。

把“能看见源码”和“能安全修改”分开

迁移前最好跑一轮不涉及真实资产的行为记录：

1. 用测试账号执行 /start 和两个主要命令。
2. 点击每种关键按钮，记录正常和无效输入的回应。
3. 创建一条虚构记录，再重新打开聊天确认它仍存在。
4. 用无权限用户尝试管理员操作，确认访问边界。
5. 临时模拟外部 API 失败，记录机器人是否给出可理解的提示。

这些结果构成迁移后的对照组。源码被完整保存，并不代表第三方接口仍有效，也不代表数据结构符合新生成代码的假设。

外部修改后先重新同步

导入之后，如果有人继续通过 Telegram 官方 BotFather、另一台电脑或 CLI 修改云端代码，原来的本地基线就过期了。此时应先重新导入云端状态，再基于新快照生成变更。

BotFatherV2 的导入文档说明，继续从其他入口修改后，应在生成新变更前再次导入；新的云端快照会成为最新工作基线。重新导入不会删除较早的本地草稿，但你需要明确下一次从哪个版本继续。

第一轮修改要小而且可回退

迁移后的首个变更适合选择低风险、容易观察的行为，例如调整帮助文案、补充一个错误提示或增加一个独立按钮。暂时不要同时改命令结构、数据库 schema 和外部集成。

发布前检查：

• 变更只涉及预期模块；
• 数据库预览没有未知或破坏性迁移；
• 未修改的导入模块仍在完整模块集中；
• 凭据没有写进源码、日志或支持消息；
• 已准备与迁移前相同的测试账号和虚构记录。

发布后在 Telegram 重跑 /start、主要命令、按钮、非文本输入、多用户隔离和数据持久化。部署校验能确认代码与 webhook 状态，但不能代替真实业务场景验收。

用 BotFatherV2 继续维护时的边界

BotFatherV2通过 AI 对话创建和修改 Telegram Serverless 机器人，并保存版本；它是与 Telegram 官方 BotFather 不同的独立产品。当前公开内测使用固定 SDK 校验范围，不支持任意 npm 模块或 Node/Bun 运行时 API，也不自动把导入的机器人变成运行时 AI Agent。原有第三方服务仍由使用者负责，并可能产生独立费用。

安全迁移的核心是：先保存真实云端基线，再用可观察的小改动验证新流程。只要云端还存在其他编辑入口，每次生成下一版前都要先问一句：我现在看到的，还是线上最新版本吗？

来源与核验日期

• BitBear Studio，BotFatherV2 《导入已有机器人》，中文产品文档，页面未标注发布日期；2026 年 10 月 10 日核验。