跳转到内容
GitHub

全局设置

TRNovel 的界面外观现在由 ratatui-kit-themes 的命名主题驱动。主页选择「全局设置」进入后,可以在完整主题之间切换,而不是逐项编辑六个颜色。

主题设置

旧版主题页是六个颜色字段的手动编辑器。新版改为完整命名主题:每个主题都带有背景、正文、边框、选中态、成功 / 警告 / 错误 / 信息等语义色,TRNovel 的页面、列表、弹窗、阅读器和 TTS 设置会一起跟随当前主题变化。

主题列表中的每一项会显示主题名称、保存用的 slug,以及一组关键色板预览。这样切换主题时能直接看到主要色彩,而不需要逐项记忆颜色值。

全局设置页会列出所有内置主题,每项显示主题名称、保存用的 slug,以及一组关键色板预览。用 ↑/↓ 或 j/k 移动,按 Enter 应用当前主题。

选择会立即生效,并保存到 ~/.trnovel/config.toml 的 [appearance]。配置记录主题 slug、背景模式与顶部栏显示偏好,不保存派生后的完整色板。

「更多 → 全局设置」中的「设置」菜单可以切换顶部栏显示;「更多」菜单也提供「隐藏顶部栏 / 显示顶部栏」快捷入口。隐藏后所有页面释放顶部一行,重启后保留偏好。现有配置默认继续显示顶部栏。

按 F10 临时呼出菜单,或点击右上角边框上的 ⋯ 打开更多菜单。关闭菜单或执行动作后恢复隐藏。搜索快捷键仍然可用,输入栏临时覆盖顶部;提交或取消后恢复隐藏,不改变显示偏好。

也可以在 ~/.trnovel/config.toml 中设置:

[appearance]
show_header = false

按 t 可以在两种背景模式之间切换:

模式行为
终端背景保留终端本身的背景色,只应用主题的文字、边框、高亮和语义色
主题背景使用主题自带背景色填充 TRNovel 根界面

背景模式同样会立即保存并应用。

快捷键行为
↑/↓ 或 j/k移动主题列表
Enter应用当前选中的主题
t切换终端背景 / 主题背景
d打开恢复默认确认框
i查看当前页面快捷键

在全局设置页按 d 弹出确认框。确认后会恢复默认外观:tokyo-night 主题、「终端背景」模式与显示顶部栏。

旧版本的六色编辑流程已经移除。~/.novel/theme.json 不再被读取、迁移或保存;如果该文件仍然存在,新主题系统会忽略它。用户在新设置页保存外观后,会写入新的 ~/.trnovel/config.toml 的 [appearance]。

如果你以前依赖手写 HEX 调整单个颜色,需要改为选择最接近的命名主题。这样所有组件都能从同一套语义色派生样式,避免出现某些页面仍沿用旧颜色、阅读器和弹窗不一致的问题。