termscp/docs/zh-CN/configuration/themes.md

主题

termscp 允许你为应用程序中的多个组件设置颜色。有两种方式可以自定义 termscp：

• 通过 配置菜单
• 导入 主题文件

通过配置菜单自定义

要通过配置菜单自定义 termscp，请在认证界面按 <CTRL+C> 进入配置，然后按两次 <TAB> 到达 themes 面板。使用 <UP> 和 <DOWN> 移动以选择你想更改的样式，如下面的 gif 所示：

导入主题文件

你也可以导入主题文件。你可以从仓库 themes/ 目录中随 termscp 附带的某个主题获取灵感，或直接使用它。通过运行以下命令导入主题：

termscp theme <theme_file>

如果一切正常，termscp 会确认主题已导入。

颜色语法

termscp 接受以下颜色格式：

• 显式十六进制：#rrggbb
• RGB：rgb(r, g, b)
• CSS 颜色名称（例如 crimson）
• 特殊关键字 Default，它使用与情境相关的默认前景色或背景色（文本和线条使用前景色，其余使用背景色）

从无法加载的主题中恢复

更新后，已保存的主题可能无法加载。这发生在向主题添加新键时：之前保存的主题不再包含该键。有两种快速修复方法：

1. 重新导入官方主题。每次发布后，官方主题都会被修补，因此从仓库下载更新后的主题并重新导入：

   termscp theme <theme.toml>
   

2. 手动编辑你的主题。如果你使用自定义主题，请编辑该文件并添加缺失的键。主题位于 $CONFIG_DIR/termscp/theme.toml，其中 $CONFIG_DIR 为：

   • FreeBSD/Linux：$HOME/.config/
   • macOS：$HOME/Library/Application Support
   • Windows：%appdata%

   缺失的键会在你刚安装的版本的 CHANGELOG 中 BREAKING CHANGES 部分列出。

样式

下面的表格描述了每个样式字段。请注意，样式 不 适用于配置页面，因此即使你不小心更改了某些内容，配置页面也始终保持可用。

认证页面

键	说明
auth_address	IP 地址输入框的颜色
auth_bookmarks	书签面板的颜色
auth_password	密码输入框的颜色
auth_port	端口号输入框的颜色
auth_protocol	协议单选框组的颜色
auth_recents	最近记录面板的颜色
auth_username	用户名输入框的颜色

传输页面

键	说明
transfer_local_explorer_background	本地主机浏览器的背景色
transfer_local_explorer_foreground	本地主机浏览器的前景色
transfer_local_explorer_highlighted	本地主机浏览器的边框及高亮颜色
transfer_remote_explorer_background	远程浏览器的背景色
transfer_remote_explorer_foreground	远程浏览器的前景色
transfer_remote_explorer_highlighted	远程浏览器的边框及高亮颜色
transfer_log_background	日志面板的背景色
transfer_log_window	日志面板的窗口颜色
transfer_progress_bar_partial	部分进度条的颜色
transfer_progress_bar_total	总进度条的颜色
transfer_status_hidden	状态栏 "hidden" 标签的颜色
transfer_status_sorting	状态栏 "sorting" 标签的颜色；也适用于文件排序对话框
transfer_status_sync_browsing	状态栏 "sync browsing" 标签的颜色

杂项

这些样式适用于应用程序的不同部分。

键	说明
misc_error_dialog	错误消息的颜色
misc_info_dialog	信息对话框的颜色
misc_input_dialog	输入对话框的颜色（例如复制文件）
misc_keys	按键文本的颜色
misc_quit_dialog	退出对话框的颜色
misc_save_dialog	保存对话框的颜色
misc_warn_dialog	警告对话框的颜色