FinchGram 能做的一切

用 Telegram 官方应用支持的方式登录，或者注册一个新账号。

• 手机号

  输入手机号，再输入 Telegram 发来的验证码。

• 两步验证密码

  如果你的账号设了，FinchGram 会在验证码之后问你要。

• 二维码

  用手机上的 Telegram 扫码，什么都不用输。

• 新账号

  在登录页就能注册 Telegram。

• 两步验证

  在设置里开启；修改密码、密码提示或恢复邮箱；或者关闭。

Telegram 的聊天列表，带标签页和搜索，为键盘而设计。

• 文件夹

  你的 Telegram 文件夹，每个都带着自己的聊天和未读数。

• 置顶聊天

  置顶的聊天始终在列表最上面。

• 未读数和 @ 提醒

  每个聊天都显示有多少未读，有人 @ 你时还有标记。

• 收藏夹

  固定在列表顶部的一行，没用过也在那里。

• 聊天开在标签页里

  把几个聊天开成标签页，随时关掉，还能在标签页上直接静音。

• 搜索

  ⌘K

  按你看到的名字找聊天，收藏夹也算；按回车打开。

• 在聊天中搜索

  ⌘F

  在当前聊天里找含有你输入文字的消息。

• 频道和机器人

  你的频道单独一个视图，机器人也有一个。

• 正在输入

  能看到对方正在输入；对方也能看到你在输入，和 Telegram 官方应用一样。

消息能带的一切，以及一个菜单，列出你能对它做的事。

• 格式

  粗体、斜体、代码和链接，照发来的样子显示。

• 链接预览

  带链接的消息下面，有一张网页预览卡片。

• 回复和转发

  一条消息回复的是什么，转发的消息来自哪里。

• 聊天里的媒体

  照片、视频、GIF、贴纸和文件；动态贴纸暂时只显示静态图。

• 消息菜单

  点右键：回复、编辑、复制、复制链接、转发、举报、删除，或者多选。

• 自毁媒体

  模糊显示，只能打开一次，和 Telegram 官方应用一样。

• 链接去哪里，先说清楚

  文字和地址对不上的链接，打开之前会先问你，并把站点和完整地址显示出来。

照片和视频在盖住整个窗口的查看器里打开，可以翻看同一相册的其他内容。

• 相册

  用图片两侧的大箭头翻看相册。

• 说明文字

  显示在图片下方，长的也完整显示。

• 视频用 mpv 播放

  从源码构建进 app，能用 Mac 的硬件解码时就用。

• 音量

  ↑↓

  鼠标悬停在喇叭上会滑出音量条，也可以用方向键或滚轮；下一个视频沿用。

• 保存

  把照片或视频存到“下载”，只要聊天允许保存。

• 缓存随时能清除

  Telegram 发来的照片、视频和文件放在 ~/Documents/FinchGram/media_cache；清除之后，你再看的东西会重新取回。

文件是什么样就怎么发，发出去之前先在一张卡片里显示。

• 三个入口

  ⌘V

  点回形针、把文件拖进窗口，或者直接粘贴。

• 发送卡片

  可以加说明文字，还能选按照片发还是按文件发。

• 相册

  照片和视频最多十个合成一个相册。

• 自毁计时器

  私聊里，照片或视频可以设为自毁。

• 静默发送

  发出去，对方那边没有提示音。

• 按 Enter 发送消息

  ⏎

  按回车发送，Shift 或 Option 加回车换行；关掉后用 ⌘Return 发送。

在任何聊天里，取下一块屏幕，标注好，发出去。

• 一个快捷键

  ⌘⇧A

  按它，或者点回形针旁边的剪刀。

• 自定义快捷键

  在设置 → 通用 → 截图里换一个。

• 整个窗口或一个选区

  单击一个窗口就整个取下，或者拖一个选区，带放大镜和像素尺寸。

• 每个显示器

  覆盖层盖住每个显示器，菜单栏也包括在内。

• 标注

  方框、椭圆、箭头、画笔、文字和马赛克，三种粗细、六种颜色。

• 撤销和重做

  ⌘Z⌘⇧Z

  每一笔都能撤销，也能重做。

• 微调

  ←→↑↓

  方向键每次把选区移动 1 点，加 Shift 移 10 点。

• 发送、复制或保存

  ⏎⌘C⌘S

  按回车放进发送卡片；也可以复制，或者存到“下载”。

• 自己不入镜

  截图时，FinchGram 自己的窗口可以先藏起来。

一个独立页面的 WebDAV 客户端：你的 NAS，在 app 里直接浏览。

• 你的服务器

  NAS、seedbox、PikPak、Alist 或 OpenList，或者用 vget serve 共享的文件夹。

  工作原理

• 文件夹排成路径

  “Home NAS /Movies/2026”：路径里的每个文件夹都能点一下退回去。

• 单个文件或整个文件夹

  勾选想要的文件，或者连文件夹带里面的东西整个拿走。

• 快

  每个文件切成 8 MB 的块、最多十二条连接并发，服务器支持 HTTP/2 就走 HTTP/2。

• 停了能接着来

  停下的下载会从停下的地方接着来。

• 服务器忙就等

  服务器说忙，就等它，最多等五分钟。

• 直接进查看器

  照片和视频下完直接在媒体查看器里打开。

• 密码加密保存

  存在 FinchGram 自己的数据库里，整体加密，密钥在你的登录钥匙串里；从不以明文写进文件。

• 每台服务器一个文件夹

  下载的文件放在 ~/Documents/FinchGram/webdav，每台服务器一个文件夹，或者放进你选的文件夹。

• 磁盘空间够不够

  磁盘放不下的文件，开始之前就拒绝；大小未知的文件，会在磁盘装满之前停下。

• 只读

  不会上传、重命名或删除服务器上的任何东西。

• 不需要 Telegram 账号

  下载页面在登录前就能打开。

• 清除已完成

  一个按钮，把所有已完成的下载从队列里清掉。

• 你自己的证书

  你在钥匙串访问里信任的证书都认，自签名的也一样。

• 服务器慢，有记录可查

  downloads.log 记下每个请求，方便查清服务器为什么慢。

FinchGram 是一个 MCP 服务端：Claude Desktop、Claude Code、Cursor 以及其他应用，在你允许后可以通过它使用你的 Telegram。

• 你打开之前一直关着

  开关在设置 → AI 访问；关闭时，所有助手都会被拒绝。

• 你选的聊天

  除秘密聊天外的所有聊天，或者只限你选的那些。

• 它能写什么

  以你的名义立即发出消息，只留草稿由你发送，或者什么都不写。

• 每个应用都要先问你

  应用第一次连接时，FinchGram 会问你；回答为那个应用保留，它更新了也不变。

• 十二个工具

  列出、搜索和读取聊天与消息，查看未读，获取媒体，写草稿，发送，删除你自己的消息，标为已读。

  工具列表

• 读取不会标为已读

  助手读聊天时，不会把任何消息标为已读。

• 永远不交出去

  秘密聊天、自毁媒体，以及禁止保存的聊天里的媒体。

• 有记录可查

  AI 访问页面列出每个助手请求过什么。

• 绑定你的账号

  换另一个账号登录后，每个应用都要重新允许。

• 复制就能用

  把 FinchGram 加进 Claude Code 或 Claude Desktop 的那几行，就在 AI 访问页面上。

• 自己不带 AI

  FinchGram 不调用任何 AI，也不训练什么；助手只能拿到你允许它读的内容。

在聊天或文件夹上点右键。

• 静音和置顶

  给聊天静音或取消静音，置顶或取消置顶。

• 文件夹

  把聊天放进某个文件夹或拿出来；它所在的文件夹会打勾。

• 复制 ID

  聊天的 ID，从它的菜单或资料页复制。

• 拉黑、举报、退出、删除

  拉黑或取消拉黑一个人，举报聊天，退出群组或频道，删除聊天。

• 把文件夹标为已读

  文件夹里的所有聊天，一次搞定。

• 给文件夹排序

  按最新消息、按名称，或者按未读消息排，置顶聊天始终在最上面。

通知、Dock 和菜单栏，都按 Mac 应用的做法来。

• 通知

  新消息以 macOS 通知提醒，要不要显示内容、要不要提示音，都由你定。

• Dock 角标

  未读消息数显示在 Dock 图标上。

• 关闭窗口时

  FinchGram 留在 Dock 里，或者退出，由你在设置里决定。

• 菜单栏图标

  从菜单栏打开窗口或退出；默认开启。

• 开机时启动

  登录 Mac 时 FinchGram 自动启动。

三种外观，各有浅色和深色，切换不用重启。

• 工作台

  默认主题：一个带标签页的工作窗口，字体用 IBM Plex Sans，强调色是靛蓝色。

• 报纸

  读起来像一份报纸，每个账号有自己的强调色，字体用 Source Sans 3。

• 终端

  等宽字体的屏幕，命令放在方括号里，字体用 JetBrains Mono；默认深色。

• 浅色与深色

  浅色、深色，或者跟随系统；每套主题各记各的。

• 随时切换

  在设置 → 外观里，或者从“视图”菜单。

界面有十一种语言。消息保持原样，不翻译。

• 十一种语言

  英语、简体中文、繁体中文、西班牙语、葡萄牙语、德语、法语、俄语、日语、韩语和阿拉伯语。

• 跟随你的 Mac

  或者在设置 → 语言里自己选，切换不用重启。

• 自带字体

  中文、日文、韩文和阿拉伯文的字体随 app 一起提供。

• README 也是

  项目的 README 也有同样的十一种语言。

FinchGram 菜单和窗口里的快捷键。

• 搜索

  ⌘K

  在 app 的任何地方找聊天。

• 在聊天中搜索

  ⌘F

  在当前聊天里找消息。

• 截图

  ⌘⇧A

  定住屏幕，取下一块。

• 下载页面

  ⌘⌥L

  打开下载页面。

• 设置

  ⌘,

  打开设置。

• 发送

  ⏎

  开着“按 Enter 发送消息”时；关掉后用 ⌘Return。

• 换行

  ⇧⏎⌥⏎

  Shift 或 Option 加回车。

• 粘贴文件

  ⌘V

  剪贴板里的照片和文件直接进发送卡片。

• 取消

  Esc

  关闭发送卡片或截图覆盖层。

FinchGram 自己保持最新，验证不过的一律不装。

• 自动更新

  从 GitHub Releases 更新：每天在随机时间检查一次，也可以在帮助 → 检查更新里手动检查。

• 装之前先校验

  每个 release 都带 SHA256SUMS 和它的 Ed25519 签名；app 两样都会校验。

• 经 Apple 公证

  用 Developer ID 签名、开启了强化运行时、经过公证：下载下来的副本和别的 app 一样直接就能打开。

• 磁盘上是加密的

  FinchGram 自己的数据库和 Telegram 的数据库各自整体加密，密钥各有一把，存在你的登录钥匙串里。

• 公开构建

  release 只由 GitHub Actions 从锁定的源码构建。

• 每次签名都一样

  所以更新后 macOS 仍保留你给的屏幕录制权限。

• 遵守 Telegram 的规则

  已读回执、正在输入和在线状态都和 Telegram 官方应用一样，频道的赞助消息照常显示。

• 不收集任何数据

  没有统计，没有崩溃报告，没有 FinchGram 服务器。

  隐私

• 下载有防护

  会落到下载文件夹之外的文件名一律拒绝，密码也绝不会跟着重定向发给另一台服务器。

• 开源

  GPL-3.0 许可证，用 Rust 和 Slint 写成，Telegram 官方的 TDLib 作为单独的程序运行。

  源码