From e9f686718d38e78a07bbdb897bf73c80be0025b2 Mon Sep 17 00:00:00 2001 From: softmaxe <94467584+softmaxe@users.noreply.github.com> Date: Tue, 27 Oct 2026 21:11:53 +0800 Subject: [PATCH] docs(readme): explain the unsupported macOS error and make test scope --- README.md | 4 ++-- README.zh-CN.md | 4 ++-- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index ad9317f..4ad7994 100644 --- a/README.md +++ b/README.md @@ -129,7 +129,7 @@ from the app's Accessibility window list, the window may move without Follow. | `no focused window` | Click the window you want to move, then retry. | | `window N not found` | The ID passed to `--window` may be stale. Use the focused window or a current window ID. | | `window ... did not move` | ferry could not confirm the move within one second. Some windows, such as system panels and fullscreen windows, may refuse the move. | -| `unsupported macOS version` | ferry supports macOS 26 only. | +| `unsupported macOS version` | ferry could not find SkyLight's private window move interface, usually because a macOS update changed it. ferry supports macOS 26 only. | | ferry moves the wrong window | Turn on Accessibility for the app that runs ferry. See [Set up](#set-up). | | Space numbers don't match what you see | Count Spaces across all displays, including fullscreen Spaces, and turn off automatic rearranging. See [Set up](#set-up). | | A new binary or script starts slowly | Compare the first run with later runs. `--verbose` measures work inside ferry, so launcher and macOS startup checks can add time outside that measurement. | @@ -171,7 +171,7 @@ make install PREFIX="$HOME/.local" ``` `make test` checks the command-line interface and the built binary's architecture, -deployment target, and linked frameworks. It does not move windows. +deployment target, and that it links AppKit. It does not move windows. `make test-follow` runs the live desktop regression for background `--window` commands. It requires Accessibility and two normal Spaces on the active display, creates temporary test windows, and temporarily switches Spaces. It closes the diff --git a/README.zh-CN.md b/README.zh-CN.md index a638402..1243e4d 100644 --- a/README.zh-CN.md +++ b/README.zh-CN.md @@ -95,7 +95,7 @@ Space 编号从 1 开始,按调度中心的顺序计算所有显示器上的 | `no focused window` | 先点一下要移动的窗口,再重试。 | | `window N not found` | 传给 `--window` 的 ID 可能已失效。改用焦点窗口或有效的窗口 ID。 | | `window ... did not move` | ferry 未能在一秒内确认移动完成。系统面板、全屏窗口等窗口可能拒绝移动。 | -| `unsupported macOS version` | ferry 只支持 macOS 26。 | +| `unsupported macOS version` | ferry 找不到 SkyLight 的私有窗口移动接口,通常是 macOS 更新改动了它。ferry 只支持 macOS 26。 | | 移动的不是想要的窗口 | 给运行 ferry 的 App 打开辅助功能权限,见[设置](#设置)。 | | Space 编号和看到的顺序不一致 | 编号包括所有显示器上的全屏 Space;同时关闭自动重新排列,见[设置](#设置)。 | | 新二进制或脚本启动慢 | 比较首次和后续运行的速度。`--verbose` 只测量 ferry 内部执行,启动器和 macOS 启动检查可能另有耗时。 | @@ -131,7 +131,7 @@ make test make install PREFIX="$HOME/.local" ``` -`make test` 只检查命令行接口和构建产物的架构、最低系统版本及链接的框架,不会移动窗口。`make test-follow` 针对后台 `--window` 命令运行真实桌面回归测试。它需要辅助功能权限,且当前显示器上有两个普通 Space;测试会创建临时测试窗口并临时切换 Space,结束后关闭测试窗口并恢复原来的 App。 +`make test` 只检查命令行接口和构建产物的架构、最低系统版本,以及是否链接了 AppKit,不会移动窗口。`make test-follow` 针对后台 `--window` 命令运行真实桌面回归测试。它需要辅助功能权限,且当前显示器上有两个普通 Space;测试会创建临时测试窗口并临时切换 Space,结束后关闭测试窗口并恢复原来的 App。 ### 升级和卸载