你的数据去哪里
FinchGram 只连接这些,别的都不连。
Telegram
Telegram 应用会发的一切:登录时的手机号,以及你的消息和文件。它们经由 Telegram 官方的库 TDLib 发到 Telegram 的服务器,和 Telegram 官方应用一样。Telegram 还会知道 app 的版本,以及你 Mac 的机型、系统版本和语言,并列在你的活跃设备里。适用 Telegram 隐私政策。
GitHub,用来更新
每天在一个随机时间,FinchGram 会问 GitHub 有没有新版本,有就下载。和任何访问一样,GitHub 能看到你的 IP 地址。在设置里关掉“自动检查更新”就不会再问。适用 GitHub 隐私声明。
你添加的 WebDAV 服务器
下载页面只连接你添加的服务器,用你给它的账号,而且只读。地址是 http:// 时,密码和文件在你的网络里是明文传输的;出了自己的网络,请用 https://。
你允许的 AI 助手
只在你打开 AI 访问之后,而且只有你允许它们看的部分。详见下文。
没有 FinchGram 服务器,所以 app 没有地方可以发送任何关于你的东西:没有统计,没有崩溃报告,没有使用计数。
什么留在你的 Mac 上
FinchGram 自己的文件放在 ~/Library/Application Support/FinchGram/,替你取回来的东西放在 ~/Documents/FinchGram/;你保存的文件则存到“下载”。
聊天和消息
tdlib/TDLib 的数据库:Telegram 发来的聊天和消息,这样聊天能立刻打开。整体加密,密钥单独一把,存在你的登录钥匙串里。
照片、视频和文件
media_cache/Telegram 发来的东西,就是“文稿”下的普通文件,你看得见也能清除;清除掉的,再看时会重新取回。
设置
settings.toml你的偏好设置,包括 AI 访问:哪些聊天、能写什么。
FinchGram 的数据库
finchgram.db你的 WebDAV 服务器和它们的密码,以及你在 AI 访问里允许或拒绝过的应用。整体加密,密钥存在你的登录钥匙串里。
密钥,在 macOS 钥匙串里
两个数据库的密钥都在你的登录钥匙串里,名为 FinchGram,只有这个 app 能读;密码从不以明文写进文件。
两份记录
downloads.logmcp.log下载引擎做了什么,地址不带账号,更不会有密码;以及哪些 AI 应用连接过、请求了什么,从不记录消息内容。两份都不会变大:超过大小限制就从头开始。
你保存的东西
从 WebDAV 服务器下载的文件放在
~/Documents/FinchGram/webdav,每台服务器一个文件夹,或者放进你选的文件夹;你保存的照片、视频和截图则存到“下载”。
要清掉 FinchGram 保存的一切:退出它,删除文件夹 ~/Library/Application Support/FinchGram 和 ~/Documents/FinchGram,再在钥匙串访问里删除名为“FinchGram”的项目。
AI 访问
FinchGram 是一个 MCP 服务端:你 Mac 上的 AI 助手应用,比如 Claude Desktop、Claude Code 或 Cursor,可以通过 FinchGram、用你的账号读取你的 Telegram 并在其中操作。在你到设置 → AI 访问里打开之前,它一直关着。
- 助手能看哪些聊天由你决定:除秘密聊天外的所有聊天,或者只限你选的那些。
- 它能写什么由你决定:以你的名义发消息,只留草稿由你发送,或者什么都不写。
- 应用第一次连接时,FinchGram 会问你允不允许,并为那个应用记住你的回答。
- 读取不会把任何消息标为已读,秘密聊天永远不给看。
- FinchGram 不为 AI 保存任何东西,不建索引,自己也不调用任何 AI。
助手读到的内容会从 FinchGram 交给那个应用,走的是一条不出你 Mac 的连接。那个应用通常会把它转给自己的 AI 服务来回答你,之后发生什么,取决于那个应用和它的隐私政策。打开 AI 访问之前,先读一读它。
FinchGram 向 macOS 申请什么
通知
用于新消息。在设置里关掉“显示消息预览”,消息内容就不会出现在屏幕上。
屏幕录制
只给截图工具用(⌘⇧A)。截图一直留在你的 Mac 上,除非你发送、复制或保存它。
钥匙串
用来保存它两个数据库的密钥。
这些你都能核实
FinchGram 开源,采用 GPL-3.0 许可证。每个 release 都由 GitHub Actions 从公开源码构建并签名,app 安装更新之前会先校验签名。本页说的每一句,都可以对照代码核实。
在 GitHub 上阅读源码本网站
finchgram.com 跑在 Cloudflare Workers 上。不设 cookie,不做统计,不从别的公司加载任何东西:字体和截图都来自 finchgram.com 自己。托管它的 Cloudflare 和任何主机一样能看到每个请求,并保留其惯常的短期日志;这些适用 Cloudflare 隐私政策。
变更与提问
本页有变动时,顶部的日期会跟着变。关于隐私的问题,请在 GitHub 上提 issue。
FinchGram 是非官方客户端,不是 Telegram 出品的。