外观与主题

在 Web 和桌面端，打开「设置 → 外观」，选择主题，并跟随系统外观，或固定为浅色或深色模式。若要为浅色和深色模式使用不同的主题，请在每个主题中选择对应的预览。外观偏好会在每台设备或每个浏览器上分别保存。

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

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

在 Android 12 或更高版本上，在外观中选择 Material You 主题，即可采用壁纸中的颜色。再选择其他主题会替换这些颜色。与其他主题一样，Material You 可以分别为浅色外观和深色外观选择。除非你在外观中将其关闭，否则 Android 默认使用 Material You Layout。它会改变形状、间距和控件，与所选主题无关。

Composer 上下文

由 Git 支持的项目（project），在创建对话线程（thread）时，会在 Composer（编写器）下方显示分支和工作树（worktree）控件。发出第一条消息、Composer 停靠之后，这些控件会收起。

打开 Composer 上下文，让这些控件在对话线程开始之后仍然可见。此偏好适用于 Web 和桌面客户端（client）。

数学

在「设置 → 外观」中打开 渲染数学，即可在 Web、桌面和移动端的消息与 Markdown 预览中排版 LaTeX。它会读取代码之外的 $…$、$$…$$、\(…\) 和 \[…\]。围栏 math 块也会渲染。公式在表格中同样有效，包括绝对值竖线。$5 and $10 这样的金额仍是文本；要让其他美元符号保持字面量，请写成 \$。较宽的公式会横向滚动，周围的文本则照常换行。复制公式或导出表格时，会保留 TeX。

即使启用了富文本，Composer 也保持 TeX 源码可编辑。渲染数学这一偏好在每台设备上分别保存。

动效

主侧边栏、右侧面板和终端抽屉默认会立即打开和关闭。将 面板动画 滑块调到 0 ms 以上即可加入动效，最长 400 ms，除非操作系统已启用减弱动态效果。在对话线程（thread）之间移动时，总会直接落到所选对话线程的面板状态，而不会重放它的过渡。

自定义主题

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

环境主题

环境（environment）主题和默认值，来自为你的 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 覆盖项使用主题编辑器高级视图中的名称。

更新时先写入临时文件，再重命名到位，这样客户端就永远不会读到写到一半的主题。无效文件不会被发布。