zh CN Appearance

外观

English · 指南首页

消息标题同时显示完整姓名和 Telegram 提供的 @username，窄窗口会换行， 不会截断姓名或用户名。用户名随消息保存在本地缓存中；旧缓存会在历史消息 刷新后补齐。没有公开用户名的账号只显示姓名。

在聊天列表或聊天内容区按 c 设置聊天颜色；在列表按 C 设置当前文件夹颜色。 Up/Down 选择带名称的终端颜色，Enter 应用，Esc 取消。列表选中标记和选中样式不依赖 颜色本身，因此颜色不是唯一的状态提示。

聊天行和聊天标题默认使用终端前景色。文件夹标题从六种 ANSI 调色板颜色中稳定 选取，终端主题决定实际 RGB 值；这些颜色不假定终端一定采用深色背景。

优先级为：内置默认值 → Lua → 应用内覆盖。选择 Follow configuration 移除 覆盖并重新跟随配置。Terminal default 则是明确使用终端前景色，可以覆盖 Lua 中指定的彩色默认值。

return {
  colors = {
    chats = { [-1001234567890] = "cyan" },
    folders = { [2] = "yellow" },
  },
}

可用值：default、black、red、green、yellow、blue、magenta、cyan、 gray、dark_gray、light_red、light_green、light_yellow、light_blue、 light_magenta、light_cyan、white。g i 显示聊天 ID 和当前文件夹 ID。

应用内覆盖保存在 settings.conf 同目录的 appearance.json，按真实 Telegram 账号 ID 隔离。切换账号或清理消息缓存不会混用或删除配色。保存复用现有原子写入 逻辑；格式错误会明确报错，不会悄悄覆盖损坏的文件。调色板不会改写 Lua 配置或 服务端文件夹颜色。

Nerd Font 图标

Nerd Font 支持需要主动开启。安装 Nerd Font 字体， 在终端配置中选择其 Nerd Font Mono 变体，再在 config.lua 中添加配置并重启 Termgram：

return {
  nerd_font = true,
}

使用 v3+ 字体。图标用于区分聊天类型、文件夹、Archive、置顶和附件，文字标签、按键提示 与终端配色仍会保留。Mono 变体让图标位于单个终端单元格内。通过 SSH 或 tmux 使用时， 需要在实际显示会话的本地终端设置字体。Termgram 使用终端选定的字体，不会安装字体或 修改终端偏好。

默认 nerd_font = false 使用普通文字显示，置顶标记为 ^。如果图标显示为方框或与邻近 文字重叠，将此选项关闭即可恢复。配置错误通过现有 Lua 加载流程显示。

字体参考：Nerd Fonts 字体变体。

聊天列表列布局

标题使用聊天配置的颜色；时间默认青色、未读数默认黄色，独立右对齐，不随标题长度改变。 指示符和选中标题的下划线标明焦点，不用整行反色覆盖颜色。Nerd Font 聊天/置顶图标 放在标题列，中文和 emoji 名称按终端列宽截断。紧凑侧栏默认 30 列，F4 切换显示。 宽度和语义颜色选项见 Lua 配置。

会话布局

作者独占一行，用户显示名包含名和姓，较长名字自动折行，不再被时间或 ID 挤掉。 收到的消息按作者分配稳定的终端颜色，发出消息作者为绿色；正文保持终端默认文字颜色。

消息默认不留空白分隔行，通过交替底色区分。自动底色从终端报告的背景略微提亮或 压暗，适应深色与浅色主题；未收到背景报告时保持终端默认背景。可调整间距或指定 终端调色板颜色：

messages = {
  spacing = 0, -- 接受 0–2 行空白
  alternating = true,
  -- images = "placeholder", -- 只显示占位标签，`o` 才打开预览
  -- alternate_background = "dark_gray", -- 省略时自动适配背景
},

底栏的 message 组件显示选中消息的信息；没有选择时显示会话中最后一条可见消息。 内容包括本地时间/日期、可选 ID、发送状态、置顶和下载/预览状态。context 组件显示 Lua 配置后的真实操作键。窄窗口会先隐藏次要组件，消息详情也可能缩短。

回复在正文上方显示带缩进的原作者和摘要，最多两行。点击引用区，或选中回复消息 后按 Enter，可跳到原消息。ID 和加载/不可用状态显示在底栏。媒体点击仍只选择， o 打开大图。messages.images = "placeholder" 可完全关闭内嵌渲染：图片消息保留标签行， 滚动时不再下载或输出图像协议，o 仍按需放大预览。左侧细标记表示消息选择，当前回复、附件或链接操作另有强调。正文、操作项和内嵌 媒体共用两列缩进。图片或贴纸预览不再重复显示 photo 等标签；尚无图片时以小型 占位标记保留可选目标，预览状态放在底栏。o 放大选中媒体，O 在系统文件管理器 定位原文件，i 回复，g n / g p 切换操作项。

调整窗口或切换侧栏保留锚定的消息；原物理行不存在时回到该消息作者行。 这里保留消息/行锚点，不承诺不同折行宽度下的精确文字字符位置。

---

Documentation source / 文档来源