全部笔记

我的 iPhone Safari + Stay 用户脚本折腾记录

Notes

用 iPhone 的人大概都有同一个感受:Safari 很干净,但干净过头了。没有脚本管理器,没有广告拦截的细粒度控制,很多在桌面上一个 Tampermonkey 就能解决的事,到了手机上只能忍着。

我平时在手机上查资料的时间比电脑还多,所以最后还是折腾了一套 Safari + Stay 的组合。这篇记录一下过程和踩过的坑。

为什么是 Stay

iOS 上能跑用户脚本的 App 不多,Stay 是我用下来最顺手的:

  • 支持安装桌面端常见的 .user.js 脚本
  • 可以给脚本配置匹配域名,不用全局注入
  • 自带一个小型脚本编辑器,能改完直接刷新页面看效果

它不是完美的,但对「我只需要几个小工具」这个需求来说够用了。

一个脚本只做一件事

刚开始我写了一个「大而全」的脚本,书签、翻译、页面信息全塞在一起。结果很糟糕:任何一个页面加载慢一点,整块逻辑都会受影响,出问题也不好排查。

后来我改成一个脚本只解决一个具体动作:

  1. website-书签脚本:只负责抓取当前页面的标题、链接、站点信息,整理成书签格式
  2. 查常见术语黑话:只负责选中文本后的解释
  3. traffic 查流量:只负责呼出 traffic.cv 的面板

这样每个脚本都短,注入的时机也更可控。出问题时,关掉对应的那个就行。

移动端要格外克制

在桌面上随手 document.querySelector 没什么负担,但在 iOS 上,页面生命周期、内存和触摸事件都不一样,写脚本时我会刻意遵守几条规则:

  • 不要依赖 hover:手机上根本没有 hover 状态,交互一律用点击
  • 按钮别太小:手指点击区域至少要 40px 见方,不然每次都点偏
  • 面板用 fixed + safe-area:底部弹出的面板要留出 Home Indicator 的空间
  • 尽量不拦截页面默认行为:能旁路加一个按钮,就不要改原页面结构

一个底部面板的最小骨架大概是这样:

const panel = document.createElement("div");
panel.style.cssText = `
  position: fixed;
  left: 12px;
  right: 12px;
  bottom: calc(16px + env(safe-area-inset-bottom));
  z-index: 2147483000;
  background: #fff;
  border: 1px solid #e4e4e7;
  border-radius: 14px;
  padding: 12px;
`;
document.body.appendChild(panel);

env(safe-area-inset-bottom) 这一行,几乎每个移动端脚本都会用到。

调试靠「日志 + 最小复现」

Stay 的调试体验谈不上好。我的习惯是把关键节点都打上带前缀的日志,比如 [azeng] loaded、[azeng] panel mounted,然后用一个最简单的测试页面验证逻辑,确认没问题再放回真实站点。

如果某段代码在真实站点上不生效,先怀疑这几件事:

  • 脚本的匹配域名写错了(带不带 www 是两回事)
  • 页面是 SPA,路由切换后脚本没有重新执行
  • 元素在脚本运行之后才渲染出来,需要 MutationObserver 或延迟

最后

这套东西没什么技术含量,但它确实把手机上那些「本来要复制到备忘录」的琐事变成了一个点击。

后面会把这几个脚本继续放在 safari-userscripts 里,有改动就顺手更新。