
本文作者:Captain,TRAE 社区运营
开源项目地址:Issues · captainfod/TRAE-Work-Dream-Skin
温馨提醒: 在正式安装主题时,TRAE Work 可能需要重新启动。请先保存 TRAE Work 未发送的内容。
最近很火的给你的工具换"皮肤",今天来教大家实现。

效果先行
以下为大家展示主题效果,只要是你自己喜欢的"产品皮肤",都可以快速定制。



这篇教程是做什么
通过这个教程,可以给你的 TRAE Work 更换主题图片、主题名称和三组主色调。
你可以很容易做出"猫咪主题 "、"动漫主题 "、"公司吉祥物主题"等等,这个主题只会改变你的产品外观,不会修改 TRAE Work 这个应用。

前期准备
-
一台电脑,Mac 建议使用 macOS 12 或更高版本。
-
已经安装好 TRAE Work。如果应用在"应用程序"里显示为 TRAE SOLO 也没有关系,安装器可以识别。
-
安装包 TRAE Work Mario Dream Skin 0.2.0 Client.zip。
-
一张主题图片。
本次演示使用:
- Apple 芯片 Macbook(Intel Mac 芯片未完成同等效果的验证)
- TRAE Work 0.1.36 版本
Windows 版本可以尝试根据步骤走一遍。

如何选择背景图片
优先选横图,宽度最好在 2000 像素以上,文件不要超过 50 MB。支持 PNG、JPEG、HEIC、TIFF 和 Mac 能正常打开的 WebP 图片。
图片的主要人物或物体尽量放在右半边,背景不要太乱,也不要放很小的文字。这样不容易挡住 TRAE Work 中间的标题和输入框。
举个例子: 想做一套猫咪主题,可以准备一张 2560 × 1440 的 JPG 图片,把猫放在画面右侧,文件名改成 cat-theme.jpg。主题名可以填写"我的猫咪工作台"。这只是示例,不要求图片一定是这个尺寸。
第一步:安装主题工具
双击安装包并解压。打开解压后的 TRAE Work Dream Skin 文件夹,再双击:
bash
安装 TRAE Work Dream Skin.command
如果 Mac 提示"无法验证开发者",不要反复双击。回到 Finder,右键这个安装文件,选择"打开",再在提示框里点一次"打开"。
安装程序会自动寻找 TRAE Work。如果弹出重启提示,确认工作已经保存后,选择允许重启。
安装完成后,桌面会出现四个入口:
| 桌面文件 | 作用 |
|---|---|
| TRAE Work Dream Skin.command | 启动主题 |
| TRAE Work Dream Skin - Customize.command | 更换图片和名称 |
| TRAE Work Dream Skin - Verify.command | 生成检查截图 |
| TRAE Work Dream Skin - Restore.command | 恢复官方界面 |
第二步:换成自己的图片
双击桌面的 TRAE Work Dream Skin - Customize.command。
接下来会先弹出图片选择窗口。选中准备好的图片,再点"选择"。然后输入主题名称,例如"我的猫咪工作台",点"继续"。
如果 TRAE Work 正在正常运行,图片通常会直接更新;如果程序提示需要重启,先保存工作,再允许重启。
做到这里,你已经完成最常用的主题改造。这个入口会保留默认的红、蓝、黄色彩。如果你不想折腾颜色,可以直接跳到下一步检查效果。
第三步:检查主题是否真的能用
打开 TRAE Work 首页,先不要只看图片好不好看,还要检查原来的功能有没有被遮住。
-
主题名称显示正确。
-
图片能看清,没有压住标题和输入框。
-
输入框可以点击、输入和发送。
-
任务列表、文件选择和页面按钮都可以正常点击。
然后双击桌面的 TRAE Work Dream Skin - Verify.command。程序会在桌面生成并打开:
TRAE Work Dream Skin Verification.png
再看一遍截图。如果文字、输入框和按钮都完整,就可以正常使用。截图好看但按钮点不到,也不能算通过。
第四步:想改文字和颜色时再做这一步
这一段是可选的。只想换图片和名称,可以跳过。
先把示例图片放到桌面,并确认文件名是 cat-theme.jpg。然后打开 Mac 的"终端",完整复制下面的命令并按回车:
bash
~/.trae/trae-work-dream-skin-studio/scripts/customize-theme-macos.sh \
--image "$HOME/Desktop/cat-theme.jpg" \
--name "我的猫咪工作台" \
--tagline "今天也把事情一件件做完。" \
--quote "FOCUS AND SHIP" \
--accent "#ff6b6b" \
--secondary "#4dabf7" \
--highlight "#ffd43b"
这个例子使用珊瑚红作为强调色、天蓝色作为背景主色、黄色作为高亮色。颜色必须写成 # 加 6 位数字或英文字母,例如 #4dabf7,不能省略井号。
如果你的图片不叫 cat-theme.jpg,或者不在桌面,就不能原样照抄图片路径。最简单的做法是先按示例把图片放到桌面并改成相同文件名。
第五步:不想用了,恢复官方界面
双击桌面的 TRAE Work Dream Skin - Restore.command。
TRAE Work 会重新启动,并恢复官方外观。这个操作不会删除任务、项目和聊天记录,也不会删除桌面的四个主题入口。以后想再用主题,双击 TRAE Work Dream Skin.command 即可。

遇到问题时这样处理
- 安装文件打不开。 在 Finder 里右键安装文件,选择"打开",不要只用双击反复尝试。
- 选完图片后没有变化。 双击 TRAE Work Dream Skin.command,按提示允许 TRAE Work 重启。
- 图片太小、太糊或位置不好。 换一张宽度 2000 像素以上的横图,让主要人物或物体靠右,再运行一次 Customize。
- 桌面没有四个入口。 重新运行 安装 TRAE Work Dream Skin.command。
TRAE Work 更新后界面错位,或者按钮不能点击。 先运行 Restore 恢复官方界面,不要继续使用错位的主题;等主题工具适配新版 TRAE Work 后再安装。

写在最后
请使用自己的图片或已经获得授权的图片。
马里奥示例图只建议个人使用,不要直接拿去售卖或重新分发。
主题运行时会在本机临时开启调试入口。不要同时运行来源不明的软件;暂时不用主题时,运行 Restore 关闭主题并恢复普通启动方式。
欢迎大家在评论区留下你的 TRAE Work 界面 DIY 截图,一起开心办公!
今天的效果演示文件点击链接即可获得:bytedance.larkoffice.com/wiki/BGQSwR...