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

新主题系统做了什么
Section titled “新主题系统做了什么”旧版主题页是六个颜色字段的手动编辑器。新版改为完整命名主题:每个主题都带有背景、正文、边框、选中态、成功 / 警告 / 错误 / 信息等语义色,TRNovel 的页面、列表、弹窗、阅读器和 TTS 设置会一起跟随当前主题变化。
主题列表中的每一项会显示主题名称、保存用的 slug,以及一组关键色板预览。这样切换主题时能直接看到主要色彩,而不需要逐项记忆颜色值。
选择命名主题
Section titled “选择命名主题”全局设置页会列出所有内置主题,每项显示主题名称、保存用的 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 主题、「终端背景」模式与显示顶部栏。
旧配置兼容性
Section titled “旧配置兼容性”旧版本的六色编辑流程已经移除。~/.novel/theme.json 不再被读取、迁移或保存;如果该文件仍然存在,新主题系统会忽略它。用户在新设置页保存外观后,会写入新的 ~/.trnovel/config.toml 的 [appearance]。
如果你以前依赖手写 HEX 调整单个颜色,需要改为选择最接近的命名主题。这样所有组件都能从同一套语义色派生样式,避免出现某些页面仍沿用旧颜色、阅读器和弹窗不一致的问题。