GemmaTrans 2.0：给 Codex 装设计审查 Skill 后，重构了五次 macOS UI

Rand01ph

之前在 V2EX 发过 GemmaTrans 的第一版：一款完全本地运行的 macOS 划词翻译工具。

先感谢 V 友的反馈。第一版发布后，有坛友推荐了腾讯混元 Hy-MT2。实测在我的 M2 上运行更快，翻译也更稳定。接入过程并不是简单换一个模型 ID：当时 Swift 版 MLXLLM 还不支持混元架构，我们在项目中移植并注册了 hunyuan_v1_dense，补齐 CLA 跨层 KV 共享和对应 Prompt ，最终加入 4-bit/8-bit 两个版本。



这次 2.0 花时间最多的还是 UI 。最初让 Codex 看截图后直接改 SwiftUI ，结果经常是“局部漂亮，整体不对”：玻璃层级太多、浅色对比度不足、按钮尺寸不统一、长文本破坏浮窗，快捷键还会错误置顶其他窗口。

后来我们调整了流程：

安装 emilkowalski/skills，先审查信息层级、密度、动效和交互，再修改代码；

参考 Codex 的视觉表现和一些开源项目的 DESIGN.md；

整理出 GemmaTrans 自己的 DESIGN.md，约束语义颜色、玻璃层级、稳定几何和按钮状态；

SwiftUI 负责界面，AppKit 补齐浮窗、焦点、置顶和文本对齐；

每轮都启动 fresh build ，用截图验证浅色、深色、长文本和不同窗口尺寸；

Skill 的方案真实使用不好，就直接推翻。



前后大约重构了五次。最大的体会是：AI 不太适合一次生成最终设计，更适合在明确约束后，持续参与审查、实现、截图验证和纠偏。



2.0 现已支持 Hy-MT2/Gemma 4 四款本地模型按需下载、固定翻译浮窗、国内源自动切换和本地 API 。

Mac App Store： https://apps.apple.com/app/id6778876828

GitHub： https://github.com/Rand01ph/gemma-trans

运行要求：Apple Silicon Mac ，macOS 26+。欢迎继续提模型和使用体验方面的建议。