VilaNet for Apple TV 1.2.11 已在 App Store 上架。 这一版我们重新整理了主要页面的按钮、文字、间距和焦点样式,并对照 Apple TV 自带的「设置」测量、调整了关键尺寸;AI 写代码时常留下的那些「小毛病」,也一条一条改掉了。用 AI 的速度,守日本匠人精神的标准,是我们这一版最想做到的事。
先看改版前后的对比:
结论先放在前面:
- 更像 Apple TV 自己的 App:内容收进一栏,不再横跨整个电视;单行的列表行统一为 66 pt,和系统「设置」一致。
- 焦点一眼就能看到:主要按钮和列表行,选中时改用一圈蓝色描边;以前叠加的白色底板和彩色光晕都去掉了。
- 去掉「AI 味」:渐变色标题、彩色光晕、表情符号图标、电视上的「点击」字样……逐条改掉。
- 新功能:用手机扫码登录、实时网速、连接中可以取消、直连优先、连接活动、BT 下载状态等,见文末。
下面讲讲这一版是怎么来的。
一、起点:一个 App,所有屏幕

VilaVPN 的想法一直很简单:不管你手上是什么设备,都能装上 VilaNet,用同一个账号连上。 今天 VilaNet 已经有 iPhone 和 iPad、Android 手机和平板(包括折叠屏)、Mac、Windows、Linux、Apple TV、Android TV 版本,还有命令行版和 OpenWrt、Merlin 两种路由器版本。
手机和电脑上的 VilaNet 是同一套跨平台代码。但这套框架不支持 Apple TV,所以 Apple TV 版是单独写的原生 App。两套代码,怎么保证用起来一样?我们的做法是:以手机版为准,Apple TV 版逐项对照移植,而且从一开始就大量让 AI 来写代码。
这次 1.2.11 之前,我们整理了 30 项对照工作,包括功能补齐、电视适配和验证;每一项先写计划,再分别确认已有行为、编写代码或补充测试。
二、AI 写得很快,但「能用」不等于「好用」

用电视和用手机,是两回事:
- 距离:手机离眼睛三十厘米,电视在三米开外。
- 没有手指:电视没有触摸屏,只有遥控器。你在遥控器上滑动,「焦点」就在按钮之间移动;焦点停在哪里,按下去就是哪里。
- 屏幕很大:同样一行字,在 65 寸电视上可以拉到一米多长。
AI 很会按要求写出「能跑」的界面,但它没有坐在你家客厅里。它写出来的东西,测试可以全部通过,截图里也挑不出明显的错,可人看完整屏,还是觉得不舒服。
这一次,问题就出在一句很朴素的反馈上:「设置页也太大了。」
三、unslop:把 AI 的「习惯动作」一条条改掉

英文里把 AI 批量生成、乍一看像模像样、细看经不起推敲的内容叫作 slop(原意是泔水);把这些痕迹清理掉的工作,就叫 unslop。这和日本木匠刨木板是一个道理:板子做出来只是开始,一遍遍刨掉毛刺,摸上去不扎手,才算完工。
界面上的 slop 有很固定的套路。光是其中一次逐屏检查,我们就记下了 17 条,其中有几条只提了改进方向。下面先看主页上改掉的 5 处:
- 标题用了蓝紫渐变色 → 回到纯白。
- 图标背后一团蓝色光晕 → 去掉光晕;已断开时,图标就是灰色的。
- 电视上写着「点击选择服务器」,「点击」是手机触屏的说法 → 改成「选择服务器」。
- 连接按钮是绿色,和手机版不一样 → 改成蓝色,和手机版一致。
- 模式按钮带高光和外发光 → 平涂,只用蓝色标出选中的模式。
除了主页,这一版改掉的还有:
- 每个图标一个颜色:蓝的、绿的、橙的,没有一个颜色有意义。现在统一用线条图标,颜色跟着文字走。
- 表情符号当图标:服务器卡片上的 ⚡,换成了和其他图标同一风格的线条图标。
- 图标用错:「断开」按钮上画的是 ▶ 播放,现在是 ■ 停止。
- 什么都加粗:标题从粗体改成半粗,和系统一致。

17 条里还有几条,比如主页的整体布局,我们只提了改进方向,没有在这一版里动。
四、尺寸是量出来的
「太大」到底是多大?匠人做活,靠的是尺子,不是感觉。我们在模拟器上打开 Apple TV 自带的「设置」,截下整屏,逐项量出尺寸,再和 VilaNet 一项项对照:
| 实测(pt) | 调整前* | 调整后 | 系统设置 |
|---|---|---|---|
| 内容宽度 | 1552 | 1200(服务器列表 1320) | 764(旁边有一张大图) |
| 文字离行边缘 | 134 | 86 | 24(没有图标列) |
| 单行高度 | 49–63,共 5 种 | 统一 66 | 66 |
| 分组标题 | 38 | 29 | — |
| 页面标题 | 57,粗体 | 57,半粗 | 57 |
| 按钮和输入框高度 | 84–128 | 66(小按钮 56,连接按钮 100) | — |
单位为 pt,画面按 1920×1080 计;「系统设置」指 Apple TV 自带的「设置」。*「调整前」来自前两轮打磨之后的中间版。文章开头对比动画里的「改版前」是更早的初版,两者不是同一个版本;初版还要更宽。
量完才发现,问题不在字太大,而在字周围的空间太大:一行横跨整个电视,文字离边缘太远,分组标题比正文大一号,说明文字掉在行外面。单行的高度本来就和系统差不多,这次反而略微加高到 66,全 App 的单行列表行都统一成这个高度;带说明文字的行,按内容加高。
五、焦点:遥控器的「手指」
在电视上,焦点就是你的手指。以前选中一个按钮时,外面会套一块白色底板,下面再发一圈彩色的光,按钮本来的颜色反而看不清。现在 App 自己画的按钮和列表行,选中时统一改用一圈蓝色描边,去掉了白色底板和彩色光晕;连接、断开这类主要按钮保留原来的底色。和 Apple TV 的系统习惯一样,选中的按钮会稍微放大一点。顶部标签栏和系统输入框,保留系统原生的选中样式。
下面用遥控器在主页上走一遍:从标签栏往下,切到 PAC 模式,经过已经选好的服务器,按下连接:
不同语言也要照顾到。俄语单词很长,我们在俄语界面里发现两处文字被截断(主页的「全局模式」按钮和服务器卡片的说明),都已修好;波斯语从右往左读,箭头和开关会左右镜像。
六、AI 写得快,每一轮就要查得更严

说「AI 帮我们写 App」,很容易让人以为按个按钮就好了。实际上正好相反:AI 写得越快,检查就要越严。 这次改版,我们做了这些检查:
- 自动测试:今年 7 月之前,Apple TV 版一个自动测试都没有。这次改版的最后一轮,模拟器上跑了 361 个单元测试和 32 个界面测试,全部通过;界面测试用代码模拟遥控器操作。
- 自动截图:用同一个演示账号,每种语言自动截下 56 个画面。英语、俄语、波斯语各截一套,专门看长单词会不会被截断、从右往左的语言有没有镜像。
- 另一个 AI 审查:代码改完,再交给另一个 AI 模型独立审查一遍。
- 对照系统实测:尺寸和 Apple TV 自带的「设置」逐项对比。
- 最后一关是人:看整屏,不看局部。
前两轮的时候,测试全部通过,截图也全部生成了,设置页还是太大。测试通过,只能说明测到的地方没出错;好不好用,要另外看。 从那以后,「对照系统实测」也成了我们检查清单上的一项。
七、匠人精神:AI 的速度,匠人的标准

VilaVPN 的日本运营主体是 Viral Tech 合同会社。日语里有个词叫「職人気質」,也就是中文常说的「匠人精神」。我们这次做 Apple TV 版,守的就是其中三条:
- 看不见的地方也要做好:一行高 63 还是 66,大多数人不会注意到。可几十个画面放在一起,整不整齐,一眼就能感觉到。所以全 App 的行高、间距、图标,我们一个一个统一。
- 用尺子说话:好不好看,可以争论很久;尺寸不会。所以我们拿 Apple TV 自带的「设置」当样板,一项一项量。
- 反复打磨:一遍做不到位,就再来一遍。前两轮测试全部通过之后,我们还是把整套尺寸重新定了一遍;英文界面改完,再逐屏看俄语和波斯语。
对我们来说,AI 是一把更快的刨子。刨子再快,哪里该刨、刨到什么程度,还是要靠匠人的手和眼睛来判断。
八、1.2.11 还带来了什么

- 用手机登录:在登录页选「使用手机登录」,用手机上的 VilaNet 扫码批准,电视就登录好了,不用拿遥控器输密码。
- 实时网速:连接后,「断开」按钮下方会显示上传和下载速度;选中这一行,可以打开连接列表。
- 连接中可以取消:连接失败时,会显示原因和「重试」按钮。
- 设置 › 直连优先:没有列在规则里的网站不走 VPN,可随时关闭(默认关闭)。
- 设置 › 连接活动:查看当前的实时连接。
- 设置 › BT 下载状态:查看账户的 BT 下载限制状态。
- 设置 › 帮助与支持:用手机扫码打开客服中心。
- 设置 › 给 VilaNet 评分:用 iPhone 或 iPad 扫码,去 App Store 写评价。
- 路由规则:可以单独设置 Apple 推送是否走代理;修改有冲突的设置之前,会先请你确认。
- 另外还有稳定性、隐私和错误修复。

怎么更新
- 已经装了 VilaNet:在 Apple TV 上打开 App Store,更新 VilaNet;开了自动更新的话,会自动装上。
- 第一次在 Apple TV 上用:看这篇 在 Apple TV 上安装并连接 VilaNet。
- 不知道该装哪个版本?看这篇:选择适合你的 App。
写在最后
做一个能用的 App 不难,做一个好用的 App 很难。AI 让我们写得更快,也让「看起来差不多」的东西更容易混过去。速度可以交给 AI,标准要留给人。 这就是我们理解的匠人精神。
在电视上用 VilaNet 时,如果觉得哪里别扭,请打开「设置 › 帮助与支持」,用手机扫码告诉我们。
文中截图和测试记录都来自模拟器上的演示账号,测试版专用的标记已遮去;改版前后对比为英文界面。动画为界面示意,其中的 IP、服务器和网速是演示数据;尺寸和测试数量来自这次改版的记录。