diff --git a/MAC_BUILD.md b/MAC_BUILD.md index e5a941a..ccba0dd 100644 --- a/MAC_BUILD.md +++ b/MAC_BUILD.md @@ -1,6 +1,6 @@ -# Mac 打包交接(给小毛) +# 在 Mac 上构建 -千夏在 Windows 上做不了 Mac 包(PyInstaller 不能跨平台编译),代码已做好 Mac 适配,麻烦你在一台 Mac 上 build + 测一下。 +PyInstaller 不能跨平台编译,所以 Mac 包必须在一台 Mac 上打。代码本身已做好 Mac 适配。 ## 怎么 build @@ -12,9 +12,9 @@ chmod +x build_release_mac.sh 产物:`release/TypelessButFree-macos-.zip`(arm64=Apple Silicon / x86_64=Intel)。 -## 必须测的几点(Mac 和 Windows 有差异的地方) +## Mac 与 Windows 的行为差异(构建后重点验这几处) -1. **粘贴键已改 Cmd+V**(Windows 是 Ctrl+V)。验证:说完话松手,文字是不是正确粘到光标处。 +1. **粘贴键是 Cmd+V**(Windows 是 Ctrl+V)。验证:说完话松手,文字是不是正确粘到光标处。 2. **抢焦点在 Mac 是 no-op**(`set_foreground_window` 只在 Windows 生效)。理论上焦点没离开就能直接粘——验证一下粘对了窗口。 3. **圆角真透明不支持**:Windows 用 `-transparentcolor` 做透明圆角,Mac 不支持 → 代码会退化成实色边框卡片(已 try/except 兜底)。验证:右下角窗口能正常显示、不难看。 4. **权限**(最容易卡的):首次运行去 **系统设置 → 隐私与安全性** 给这个 app 授权: @@ -23,8 +23,6 @@ chmod +x build_release_mac.sh - **麦克风** —— 否则录不了音 5. **Gatekeeper**:未签名,首次打开会被拦。右键 → 打开,或 `xattr -dr com.apple.quarantine TypelessButFree.app`(或对应目录)。 -## 测完反馈 +跑一遍热键触发 / 录音 / 转写 / 粘贴 / 窗口样式,有 Mac 专属问题请开 issue。 -热键触发 / 录音 / 转写 / 粘贴 / 窗口样子,哪个 OK 哪个不行告诉千夏,有 Mac 专属 bug 我远程改。 - -> 未来要正式发布 Mac 版,得 Apple 开发者账号($99/年)做**签名 + 公证**才能免 Gatekeeper 警告——先内部测,发布再说。 +> 要正式发布 Mac 版,得 Apple 开发者账号($99/年)做**签名 + 公证**才能免 Gatekeeper 警告。 diff --git a/setup.ps1 b/setup.ps1 index ff68a34..b58d72e 100644 --- a/setup.ps1 +++ b/setup.ps1 @@ -1,5 +1,5 @@ # VoiceType 一键安装(Windows / PowerShell) -# 用法:在 E:\Project\voicetype 下右键“用 PowerShell 运行”,或: +# 用法:在项目根目录下右键“用 PowerShell 运行”,或: # powershell -ExecutionPolicy Bypass -File .\setup.ps1 $ErrorActionPreference = "Stop" Set-Location $PSScriptRoot