服务端校验才建立身份
将原始 initData 交给后端按官方方案验证；initDataUnsafe 不能作为可信登录证据。还需处理认证时间与自己的重放策略。Bot Token 留在服务器，不能写进前端构建产物。
入口影响上下文
主 Mini App、菜单、直接链接和附件菜单有不同的启动方式。客户端侧需要正确打开 WebView、传递上下文及处理事件；网页开发者则使用对应的 JavaScript API。两份文档面向不同实现层。
附件入口是否可以安装、应出现在哪里以及是否需要确认，由当前能力决定，不能给所有 Bot 都宣称已开启附件菜单。
适配真实设备
主题、安全区、内容安全区、视口与键盘会改变可用空间。建议按能力检测渐进启用新功能，给旧客户端提供明确后备操作。不要把固定浏览器高度当作锁屏、旋转或键盘弹出后的实际高度。
推荐计划独立记账
推荐计划有佣金、期限、终止与归因规则。终止计划和既有用户的后续佣金并非必然同时结束。展示链接前先读取真实状态，避免发出过期推荐链接或误算收益。