# WTelegram Layer 兼容性

适用范围：使用 `WTelegramClient 4.4.8`（Telegram Layer 228）的面板版本。

## 背景

Telegram 可能向部分既有会话返回相邻 Layer 的对象构造器。Issue #162 中的
`user#31774388` 和 `channel#1c32b11c` 属于 Layer 227；Layer 228 的 WTelegram
类型表默认只登记 `user#b1b8cc83` 与 `channel#d49f34c6`，因此会抛出
`Cannot find type for ctor`。

## 实现约束

`TelegramLayerCompatibility` 在 Web 启动入口执行，并由客户端池再次兜底，向
`TL.Layer.Table` 注册两条别名：

- `0x31774388` 映射到当前 `TL.User`；
- `0x1C32B11C` 映射到当前 `TL.Channel`。

这两个 Layer 的字段顺序一致，Layer 228 只在尾部新增受 flag 保护的可选字段，因此旧负载
可以由当前类型安全读取。不得将未知构造器、非相邻 Layer 或字段布局未经核对的构造器加入
该表；也不得为此降级 `WTelegramClient`。

启动入口在任何账号导入、登录、Session 转换和导出等直接创建 Telegram 客户端的路径前完成注册。
注册仅修改进程内类型表，不修改数据库、账号配置或 Session 文件。

## 验收与排查

升级并重启后，使用曾出现该错误的账号重新运行数据同步。成功判据是频道/群组读取完成，
日志和任务失败详情中不再出现这两个构造器的 `Cannot find type for ctor`。

若仍出现其他构造器编号，保留完整编号、WTelegram 版本和触发接口后反馈，不要泛化注册别名。
若同时出现 `AUTH_KEY_UNREGISTERED`、`SESSION_REVOKED` 等明确 Session 错误，按账号重新登录流程
处理，而不是将其视为 Layer 兼容问题。

## 回滚

回滚到不含该兼容层的应用版本只会移除进程内别名；数据库和 Session 文件均无需迁移或恢复。