zh CN Notifications

通知与静音设置

English · 指南首页

对聊天使用 :mute、:mute 1h、:mute 8h、:mute 2d 或 :mute forever。 默认是永久静音。:unmute 明确启用该聊天的通知，即使账号的私聊或群聊默认设置 为静音。在聊天列表中，命令捕获当前选择的聊天；在内容区则捕获当前会话。命令标题 显示目标，新消息造成的列表重排不会改变它。

这些命令修改 Telegram 官方通知设置， 因此会同步到官方客户端，需要网络连接。修改静音时间时，Termgram 保留已有的预览、 静默发帖及桌面声音偏好，也保留该会话已有的故事设置。界面等待 Telegram 确认的实际 状态，不提前假定成功。请求期间若收到新的通知设置更新，将通过刷新聊天列表取得实际 状态；迟到快照不会覆盖新更新。失败时保留最后确认的状态，并允许重试。静音不会 标读消息或修改草稿。

侧栏以 [m] 标记静音聊天；开启 Nerd Font 后使用划线铃铛图标。可配置的底栏 notifications 组件显示当前焦点聊天的 Muted forever，或本地日期/时间的 静音截止时间。取消静音或到期后该信息消失，标记和截止时间不依赖颜色区分。 排除静音聊天的文件夹继续遵循已有的 Telegram 成员规则。

Lua 动作 mute_chat、unmute_chat 可绑定在 chats 或 conversation 上下文； mute_chat 表示永久静音。默认没有分配快捷键，例如：

keymap = {
  { context = "chats", on = { "m" }, run = "mute_chat" },
  { context = "chats", on = { "M" }, run = "unmute_chat" },
},

未读提及与回复给你的消息

在聊天列表或内容区按 g m，或者使用 :mentions。Unread mentions 面板使用 Telegram 的未读提及列表， 包括回复给你的消息。侧栏中的彩色 @ 标记有未读提及的聊天；选中提及消息后，底栏 也显示其状态。即使关闭颜色或没有 Nerd Font，这些标记仍可辨认。

用上下键选择，Enter 加载上下文并选中原消息，Ctrl-N/Ctrl-P 翻页，Ctrl-R 刷新， Esc 关闭。/ 返回保留的结果；:search 切回本地正则搜索。面板固定打开时的目标 聊天，并保留草稿。总数是搜索时 Telegram 返回的计数；其他设备发生变化后可刷新。 收到已读或删除更新时会移除对应结果。搜索中的摘要不会标读提及。本面板没有查询输入框。 Lua 动作 mentions 可用于 chats、conversation，面板按键使用 search 上下文。

只有终端获得焦点、聊天中确实绘制到消息末尾时，才确认文字提及的内容已读。加载历史、 搜索、打开浮层或终端失去焦点时不会确认。提及的内容回执和普通聊天已读边界相互独立。 语音、圆形视频和阅后即焚媒体需要实际消费；看到消息不会将其标记为已播放。在 Termgram 的播放流程接入这些回执前，可在其他 Telegram 客户端中消费。:read 将聊天历史标读， 不会假定这些媒体已经播放。

其他客户端的内容回执会更新消息、保留的结果和本地缓存。较慢的历史或搜索快照不会 恢复旧的未读标记。提及导航需要连接；重连后可用 Ctrl-R 重试。

桌面提醒

默认对新收到、尚未看到的入站消息启用桌面提醒。终端获得焦点且消息已经显示在当前 聊天中时保持安静，即使已读回执尚未完成。同一聊天在 800 毫秒内的消息会合并； 队列限制聊天数和消息数，系统投递在输入、绘制之外进行。

在 config.lua 返回的表中配置：

notifications = {
  enabled = true,
  backend = "auto",
  when = "unseen",
  previews = true,
  sound = true,
  group_delay_ms = 800,
},

• enabled = false 关闭本机桌面投递；Telegram 静音设置仍会同步。
• when = "unseen" 允许在 Termgram 获得焦点时提醒其他聊天的消息；"unfocused" 只在终端失去焦点时提醒。两种模式都遵守已读边界。
• previews = false 隐藏消息正文和发送者摘要。开启时也要遵守 Telegram 的实际预览 设置；被标为保护内容的消息使用通用提示。标题包含账号和聊天名称。
• sound = false 请求无声的原生提醒；Telegram 静默消息以及聊天的禁用声音设置也 保持无声。不会下载 Telegram 自定义铃声；允许声音时使用系统默认声音。
• group_delay_ms 范围是 100–5000 毫秒，从第一条消息起固定计时，不会因为聊天 持续活跃而无限推迟投递。

auto 在本地使用系统通知。通过 SSH 时，在检测为 Ghostty、iTerm2、Kitty、Warp、 WezTerm 的终端中使用 OSC 9，否则使用 BEL。本地原生投递报错时可以回退到终端。 native、osc9、bell 可明确选择后端。OSC 9/BEL 无法要求安静投递，因此会跳过 禁用声音的提醒。终端通知需要终端自身的通知权限；tmux 使用既有的 穿透设置。原生通知复用 notify-rust 的 macOS、Windows、Linux 集成， Linux 需要桌面会话总线。没有增加原生通知回调等待或第二个终端输入 reader。

Termgram 异步读取 Telegram 实际生效的通知偏好。静音聊天保持安静；如果提及或回复 给你的消息来自未静音的发送者，则按 Desktop 规则允许提醒，聊天的预览和声音设置仍然 生效。设置未知或读取失败时不会弹出提醒，请求有并发和时间限制。其他客户端的设置 变更会使旧快照和已排队的投递失效。

启动和重连后重新建立提醒时间范围：只有时间晚于该次连接边界、且不超过 30 秒的消息 可以提醒。旧缓存、补回的历史、重复消息、自己发送的消息及收藏夹不会提醒。这会避免 断网期间错过的消息在重连后集中弹出；消息本身和未读计数仍正常显示。新旧判断使用 系统时钟和 Telegram 消息时间。

读取、删除、静音、切换账号或退出会取消相应的待发送提醒。合并发生在交给系统之前； 已经投递的通知由操作系统管理。此界面暂不提供点击通知跳转、通知内回复或替换已投递卡片。

---

Documentation source / 文档来源