首页门户/生态工具地图
纸飞机生态工具地图：4 个象限与 6 张对照表
生态不是合作名单，而是围绕同一套接口与协议形成的公开资料类型；本页按 Bot、客户端、主题、翻译 4 个象限展开，每一行都对应 1 个可自行核对的官方页面。
阅读前提：本页列出的是公开资料与工具类型，不是合作名单。凡是宣称与官方有「独家授权」「战略合作」的第三方站点，本页不予收录，也无法替其背书。核对日期统一为 2026-10-19。
象限一：Bot 平台
Bot 平台是文档最完整的一个象限，官方把接入方式分成 2 条路径，并分别写明了参数约束。
| 维度 | Long polling | Webhook |
|---|---|---|
| 官方文档位置 | Getting updates 章节 | Setting webhooks 章节 |
| 连接方向 | 程序主动拉取 | 官方主动推送 |
| 超时上限 | timeout 上限 50 秒 | 由 HTTP 连接决定 |
| 单次上限 | limit 上限 100 条 | 每次请求 1 条更新 |
| 公网要求 | 不需要 | 需要 HTTPS 地址 |
| 并发上限 | 由程序控制 | max_connections 上限 100 |
| 互斥关系 | 两者互斥，设置 webhook 后 getUpdates 不再返回更新（来源：官方文档） | |
对象模型先看懂
Bot 收到的是 Update 对象，其中包含 message、callback_query、inline_query 等多种内容类型；发出的则是带 chat_id 的方法调用。两者不要混淆（来源：官方文档 Available types 章节）。
开发接入的细节集中在Bot API 接入说明，那里逐个拆解了对象与参数。
自建服务端这条路
官方文档在 Bot API usage 章节给出了自建服务端的做法，说明了本地文件上传上限与 webhook 请求头处理等差异（来源：core.telegram.org/bots/api，2026-10-19 查阅）。自建适合有运维能力的团队，个人项目通常直接用官方接口即可。
| 参数 | 所属方法 | 上限 | 超限后果 |
|---|---|---|---|
| text | sendMessage | 4096 字符 | 请求失败 |
| caption | sendPhoto 等媒体方法 | 1024 字符 | 说明被截断或报错 |
| command | setMyCommands | 32 字符 | 命令注册失败 |
| description | setMyCommands | 256 字符 | 命令注册失败 |
| description | setMyDescription | 512 字符 | 简介设置失败 |
| text | answerCallbackQuery | 200 字符 | 提示不显示 |
| limit | getUpdates | 100 条 | 请求被拒绝 |
接入前先核对 3 件事
在动手写代码之前，先把下面 3 条确认好，可以避免把用户接口与机器人接口混用。
- 确认调用目标：机器人接口是无状态 HTTP 调用，不涉及账号登录，与客户端使用的账号会话体系是 2 套独立机制（来源：core.telegram.org 文档结构）。
- 确认凭据来源：token 由官方机器人管理入口生成，全站只应出现在 1 个服务端的配置项中（依据：官方文档的凭据说明）。
- 确认访问方式：设置 webhook 后 getUpdates 不再返回更新，两条路径在同一时间只能用 1 条（来源：官方文档的互斥说明）。
象限二：客户端
官方客户端与官方客户端库是两类不同的东西，前者给人用，后者给程序用。
| 名称 | 类别 | 平台 | 适用对象 |
|---|---|---|---|
| 官方移动端 | 图形客户端 | Android 与 iOS | 全部用户 |
| 官方桌面端 | 图形客户端 | Windows / macOS / Linux | 全部用户 |
| Web K | 网页客户端 | 浏览器 | 单账号轻量使用 |
| Web A | 网页客户端 | 浏览器 | 多账号工作组 |
| TDLib | 客户端库 | 跨平台 | 自建客户端的开发者 |
| MTProto | 传输协议 | 跨平台 | 实现客户端的开发者 |
| 桌面端源码 | 开源仓库 | Windows / macOS / Linux | 审计与二次开发 |
选型时的三个判断点
第三方客户端之间差异很大，但判断维度是稳定的：是否直连协议、数据存放位置、更新节奏。下面 3 条可直接套用。
- 是否直连：能直连 MTProto 的客户端不依赖第三方服务器转发，这是评估第三方实现的基本前提（来源：core.telegram.org 协议文档）。
- 是否开源：开源与否决定你能否读到代码路径，本页只介绍可查证的开源仓库类型，不替任何仓库做质量背书。
- 更新节奏：客户端版本落后官方版本时，媒体格式与新特性的兼容性会先出问题（场景：新功能上线后的首周）。
- 资料入口：官方把客户端相关说明分散在 3 个页面，应用总览、桌面端页面与客户端库文档各管一段（来源：telegram.org/apps 与 core.telegram.org，2026-10-19 核对）。
象限三：主题与外观
这是四个象限里范围最小的一个，但它有明确的文件格式，查证成本很低。
| 内容项 | 作用范围 | 说明 | 常见取值 |
|---|---|---|---|
| 背景色 | 整体界面 | 主背景取值 | 纯色或渐变 |
| 主题色 | 按钮与高亮 | 强调色取值 | 十六进制色值 |
| 壁纸 | 聊天背景 | 可选图片资源 | 本地文件 |
| 字号缩放 | 文本显示 | 影响排版大小 | 百分比数值 |
| 文件扩展名 | 导入格式 | 桌面端专用格式 | tdesktop-theme |
主题文件只影响观感，不会改变加密范围、消息留存策略或账号安全设置。看到宣称「主题包能提升加密等级」的说法，可以直接忽略。
象限四：翻译与本地化
翻译流程有官方说明页，读者可以直接查看当前语言的覆盖率来源。
| 入口 | 用途 | 面向 | 说明 |
|---|---|---|---|
| core.telegram.org/translations | 翻译流程说明 | 愿意参与的用户 | 指向文档所述的翻译平台 |
| 客户端语言设置 | 切换界面语言 | 全部用户 | 含 2 个中文选项 |
| 客户端内报告问题 | 反馈译文问题 | 全部用户 | 对所有语言一致 |
| telegram.org/faq | 帮助文档 | 全部用户 | 英文为主 |
| 客户端内搜索 | 中文检索 | 全部用户 | 跟随界面语言 |
翻译相关的 3 个常见误解
中文界面来自官方的多语言流程，不存在单独的「中文版客户端」。下面是 3 个流传较广但与文档不符的说法。
- 误解一：需要单独下载中文包。实际不需要，6 个官方入口都自带简体中文（来源：官方客户端语言设置，2026-10-19 实测）。
- 误解二：中文版功能比国际版多。实际各语言版本功能一致，差异只在界面文字（来源：官方客户端设置说明）。
- 误解三：翻译由某个中文团队维护。实际按官方文档说明，走的是文档所指向的社区翻译流程（来源：core.telegram.org/translations）。
第三方工具评估清单
如果你打算使用某个第三方工具，按下面 6 条逐项核对，任何一条无法确认就先停下来。
| 核对项 | 合格标准 | 不合格的表现 |
|---|---|---|
| 域名与证书 | 证书链有效 | 出现自签证书警告 |
| 登录方式 | 官方登录流程 | 要求粘贴会话密钥 |
| 数据位置 | 本地存储 | 要求导入导出全量聊天库 |
| 权限申请 | 仅必要项 | 索取通讯录或短信权限 |
| 安装包来源 | 官方入口 | 第三方网盘分发 |
| 更新说明 | 有变更记录 | 长期无版本记录 |
需要说明的是，本页不列出任何具体第三方产品的名称与评分，因为这类信息随版本变化、且极易被夸大。评估方法比具体名单更有用：按表 6 的 6 条核对，任何一项说不清就不用（依据：官方安全指引中关于第三方应用的提示）。