外观与主题¶

在 Web 和桌面端，打开设置 → 外观即可选择主题，并跟随系统外观或保持浅色/深色模式。要为浅色和深色模式分别选择不同主题，请在各个主题中选择对应的预览。外观偏好设置会在每个设备或浏览器上单独保存。

在 Web 和桌面端，可在命令面板中使用更改主题，无需离开聊天即可选择主题。在 macOS 上按 Cmd+Option+A，或在 Windows/Linux 上按 Ctrl+Alt+A，可直接打开主题选择器。在命令面板中使用更改外观，可独立于主题选择系统、浅色或深色。在 macOS 上按 Cmd+Option+Shift+A，或在 Windows/Linux 上按 Ctrl+Alt+Shift+A，可在这些模式间循环切换。可以在设置 → 键绑定中自定义这些快捷键。

在移动端，打开设置 → 外观。移动端有自己独立的主题以及文本、代码和终端偏好设置。它不跟随环境主题或默认设置。

在 Android 12 或更高版本上，在外观中选择 Material You 主题，可使用壁纸中的颜色。选择其他主题会替换这些颜色。与其他主题一样，Material You 可以分别针对浅色和深色外观进行选择。除非你已在“外观”中关闭，否则 Android 默认使用 Material You 布局。它会独立于所选主题地改变形状、间距和控制项。

Composer 上下文¶

基于 Git 的项目在创建线程时，会在 Composer 下方显示分支和工作树控件。发送第一条消息后，Composer 停靠，这些控件随之收起。

开启Composer 上下文，可在线程开始后保持这些控件可见。此偏好设置适用于 Web 和桌面客户端。

数学公式¶

在设置 → 外观中开启渲染数学公式，即可在 Web、桌面和移动端的消息与 Markdown 预览中排版 LaTeX。它会在代码之外读取 $…$、$$…$$、\(…\) 和 \[…\]。围栏 math 代码块也会渲染。公式在表格中同样有效，包括绝对值竖线。$5 and $10 等金额会保持为文本；如需保留其他美元符号的字面含义，请写成 \$。宽公式会水平滚动，而周围文本正常换行。复制公式或导出表格会保留 TeX 源码。

Composer 会保持 TeX 源码可编辑，即使在启用富文本时也是如此。“渲染数学公式”偏好设置会在每个设备上单独保存。

动效¶

默认情况下，主侧边栏、右侧面板和终端抽屉会立即打开和关闭。将面板动画滑块移到 0 ms 以上，即可添加动效，最高 400 ms，除非你的操作系统已启用“减弱动态效果”。在线程间切换时，始终会直接跳转到所选线程的面板状态，而不会重放其过渡动画。

自定义主题¶

在 Web 和桌面端，选择创建主题以调整调色板，或导入 T3 Code 或 VS Code 主题。主题编辑器的取色器可让你选择应用中的某个区域，以找到要更改的颜色。将主题导出为 JSON 即可分享。

环境主题¶

环境主题和默认设置来自为你的 Web 应用提供服务的服务器，或桌面应用的主本地环境。当桌面应用的本地环境关闭时，在应用连接到后台服务期间，它们来自同一台机器上的后台服务。app.t3.codes 和其他连接不使用这些环境主题。

在设置 → 外观中选择已发布的主题，即可在服务器更新时跟随其调色板。复制可以创建一个可编辑的独立副本。保存的具有相同 ID 的自定义主题优先。如果服务器停止发布所选主题，T3 Code 会回退到其标准主题。

在服务器上运行以下命令，可设置默认主题并将已连接的客户端切换到该主题：

t3 theme set nightfall

离线客户端会在重新连接时应用该设置。每个客户端仅应用一次该设置；之后选择其他主题会保持生效，直到下一次执行 t3 theme set。即使名称未更改，也可以再次运行该命令以重新应用。

t3 theme clear 会移除默认主题，但不会更改任何人当前的主题。t3 theme show 会列出默认主题和已发布的主题。

发布主题¶

将从 T3 Code 导出的主题保存到服务器上的 ~/.t3/userdata/themes/，或自定义状态目录下的 themes 目录中。文件名提供主题 ID：nightfall.json 可通过 t3 theme set nightfall 选择。更新主题颜色时请保持文件名稳定。不要使用 system、light、dark 或内置主题的 ID。

对于生成调色板的集成，这种更短的格式也适用：

{
  "name": "Nightfall",
  "appearance": "dark",
  "canvas": "#1a1b26",
  "accent": "#7aa2f7",
  "colors": {
    "terminalSelection": "#292e42",
    "error": "#f7768e"
  }
}

将 appearance 设置为 light 或 dark，并为 canvas 和 accent 提供十六进制颜色。T3 Code 会生成其余部分。可选的 colors 覆盖项使用主题编辑器高级视图中的名称。

将更新写入临时文件，然后重命名到位，这样客户端绝不会读取到不完整的主题。无效文件不会被发布。