telegramharmony

基于HarmonyOS NEXT开发的完整Telegram客户端应用。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:telegramharmony。
它的用途是:基于HarmonyOS NEXT开发的完整Telegram客户端应用。
完整的 Skill 内容见:https://321skill.com/skills/telegramharmony/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

“我想学习如何在HarmonyOS上开发一个完整的即时通讯应用,可以参考哪个开源项目?” 它会推荐TelegramHarmony,并说明这是一个使用ArkTS实现MTProto协议的原生Telegram客户端,适合作为高级学习案例。或者,当开发者询问“如何为鸿蒙应用集成复杂的网络协议”时,可以引导其参考此项目的协议层实现。

介绍

TelegramHarmony是一个专为HarmonyOS NEXT系统开发的Telegram客户端,它完整实现了MTProto 2.0协议,旨在为鸿蒙生态用户提供原生、流畅的Telegram使用体验。

开发者需要先访问Telegram官网获取自己的API凭证,并按照项目说明进行配置,然后使用DevEco Studio打开项目,连接鸿蒙设备或模拟器即可运行。整个过程清晰,适合有一定鸿蒙开发经验的用户上手。

这个项目非常适合对HarmonyOS原生应用开发、即时通讯协议实现感兴趣的前端开发、全栈开发或移动应用开发者。它提供了一个从零开始构建复杂社交应用的绝佳学习案例。

请注意,此项目为开源学习项目,运行前必须配置个人API凭证,且该凭证属于敏感信息,切勿提交至公开仓库。项目依赖HarmonyOS NEXT的特定开发环境,普通Android/iOS开发者可能需要先熟悉鸿蒙生态。

核心特点

这是首个公开的、基于HarmonyOS NEXT并使用ArkTS/ArkUI原生开发的完整Telegram客户端,实现了完整的MTProto 2.0协议层,而非简单的Web封装,提供了真正的鸿蒙原生体验和底层协议学习价值。

注意事项

不适合希望快速部署一个现成、开箱即用Telegram客户端的普通用户,需要一定的开发环境和配置能力。

常见问题

运行这个项目需要什么条件?

需要安装DevEco Studio 5.0+、HarmonyOS NEXT SDK (API 12),并拥有一台HarmonyOS NEXT真机或模拟器。

如何获取Telegram的API凭证?

访问 https://my.telegram.org/apps,登录你的Telegram账号后创建应用即可获得api_id和api_hash。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/telegramharmony/raw/index.md 读取 telegramharmony 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。