Repository navigation
| 产品 | 平台 | 版本 / build | 状态 |
|---|---|---|---|
| OpenCCman | iOS / iPadOS | 2.3 / 65 | 已上线:2026-11-19,READY_FOR_DISTRIBUTION |
| OpenCCman | macOS | 2.3 / 65 | 已上线:2026-11-19,READY_FOR_DISTRIBUTION |
OpenCCman 2.3 fixes a regression in the Mac global shortcut, shows what each conversion changed, and adds batch TXT conversion on Mac and a Share sheet action on iPhone and iPad.
What's new
- Fixed: Mac global shortcut regression. In 2.1 and 2.2, pressing the Convert Chinese Text shortcut after selecting text in another app only opened the main window: a mandatory Accessibility selection check was refused by the App Sandbox, so the in-place replacement was skipped. 2.3 again copies the selection, converts it and pastes the result back into the original app without opening the main window. The paste is cancelled if the app, input, clipboard or selection changes, and the clipboard is restored. In terminals, OpenCCman shows the original and the result instead. Brief notices report failures (on by default) and successes (off by default) (#341).
- Show Differences: after a successful conversion, highlight what changed and move both selections together with Previous Difference and Next Difference (⌘⇧D shows or hides them; ⌘⌥⇧[ and ⌘⌥⇧] move). It is off by default and is not shown for very large documents. Copy, share and export stay plain text (#27).
- Mac batch TXT conversion (Pro): File › Batch Convert TXT Files… (⌘⇧O), or dropping two or more files onto a window, converts up to 100 TXT files, each up to 1 GiB, into an output folder. Originals are not changed, clashing names are numbered, and a failed file does not stop the rest. Batch conversion does not use the daily allowance (#25).
- Share sheet on iPhone and iPad: Convert Chinese Text converts text shared from other apps with a preset chosen in the extension, which keeps the last choice. Copy or share the result, or return it to apps that accept it. It is free, does not use the daily allowance and accepts up to 10 MiB (#29).
- Source Standard for Simplified Chinese: choose OpenCC, Taiwan or Hong Kong (t2s, tw2s or hk2s); Taiwan and Hong Kong sources can also convert regional phrases (tw2sp, hk2sp). Saved settings keep converting with t2s (#303).
- Hong Kong phrases: Traditional Chinese with the Hong Kong standard and HongKong Idiom now converts with s2hkp instead of Hong Kong characters with Taiwan phrases, so saved settings with that combination produce different output (#304).
- Fixes: Mac sheets follow the in-app text size, and a single TXT file dropped from Finder keeps its file name. Short Chinese segment labels stay horizontal when there is room (#324). Mac page titles are no longer covered by the back button at 150% text (#334). The Feedback page uses support@gewill.org.
Full details: CHANGELOG.
Compatibility
The app still requires iOS/iPadOS 15+ or macOS 12+, and the homepage allowance remains 12 conversions per day. Batch conversion is Mac and Pro only; iPhone and iPad still convert one file at a time. Big5/GBK decoding is not supported.
简体中文
2.3 修复了 Mac「转换中文文本」全局快捷键的功能回退:在 2.1 和 2.2 中,在其他应用选中文字后按转换快捷键,强制的辅助功能选区校验会被应用沙盒拒绝,于是跳过原位替换,只打开主窗口。2.3 重新复制选中文字、转换后贴回原应用,不会打开主窗口;应用、输入、剪贴板或选中文字一旦变化就取消粘贴,并恢复剪贴板。失败和成功都可以显示简短提示,默认只开失败提示。
新增「显示差异」,转换后标出每一处变化。Mac 上的 Pro 用户可以一次批量转换最多 100 个 TXT 文件。iPhone 和 iPad 的分享菜单新增「简繁转换」,免费且不计入每日次数。转换为简体时可以选择原文标准(OpenCC、台湾或香港);繁体搭配香港标准和香港模式时改用香港用词,已保存的这一组合输出会与旧版本不同。
最低系统仍为 iOS/iPadOS 15 和 macOS 12,每日免费次数仍为 12 次。
繁體中文
2.3 修正了 Mac「轉換中文文字」全域快速鍵的功能退化:在 2.1 與 2.2 中,在其他 App 選取文字後按轉換快速鍵,強制的輔助使用選取範圍檢查會被 App 沙盒拒絕,因而略過原地取代,只開啟主視窗。2.3 重新拷貝選取的文字、轉換後貼回原 App,不會開啟主視窗;App、輸入、剪貼簿或選取的文字一旦變化就取消貼上,並還原剪貼簿。失敗與成功都可以顯示簡短提示,預設只開啟失敗提示。
新增「顯示差異」,轉換後標出每一處變化。Mac 上的 Pro 使用者可以一次批次轉換最多 100 個 TXT 檔案。iPhone 與 iPad 的分享選單新增「簡繁轉換」,免費且不計入每日次數。轉換為簡體時可以選擇原文標準(OpenCC、臺灣或香港);繁體搭配香港標準與香港模式時改用香港用詞,已儲存的這一組合輸出會與舊版不同。
最低系統仍為 iOS/iPadOS 15 與 macOS 12,每日免費次數仍為 12 次。
构建来源
- 源提交(tag 指向):
0fca3a2893161fc08c17e9fe3a0fb142090d5a4a,即main上 #346 的 squash 提交。它集成develop的dac6ff4,并把 CHANGELOG 的 2.3 段落改为发布候选。 - 相对上一版本 tag
v2.2(92847e3):main上新增 2 个提交,c31936a(简繁中文 README,#328)与0fca3a2(#346);develop侧 170 个提交。compare - 各 App 的源是否相同:是。iOS 与 macOS 来自同一次 Xcode Cloud 运行(Build 65)和同一提交。
- Build 64 未使用:同一提交的 Build 64(run
e23d67b3-f4b3-483b-8302-b3eff4fdfefc)iOS 导出失败,日志为Automatic signing cannot register bundle identifier "org.gewill.OpenCCman.TextAction"。原因是分享扩展首次参与云端打包,开发者账号里没有登记它的 App ID。2026-11-17 登记该 Bundle ID(PJ3NR5QX4T)后,从同一提交重新打包为 Build 65。Build 64 的 macOS 包(VALID)没有挂到版本上。 - Mac 站外分发:不适用,仅 App Store 分发。
Xcode Cloud
| iOS / iPadOS | macOS | |
|---|---|---|
| App ID | 6474449401 |
6474449401 |
| Bundle ID | org.gewill.OpenCCman;分享扩展 org.gewill.OpenCCman.TextAction |
org.gewill.OpenCCman |
| Workflow ID | 00F5435C-1C48-4750-88FA-4563D018E4B3(Default) |
同左 |
| 构建分支 | build/v2.3-20261117-02 |
同左 |
| Build run ID | 4123e410-9ff8-4576-b338-3dce4ca5a453(Build 65,2026-11-17 12:23–12:33 UTC,SUCCEEDED) |
同左 |
| ARCHIVE action | 718a022a-cb0f-41c4-827d-432b923a3697 |
8ee4118a-276a-401b-8404-8e552e22462f |
| ASC build | 99d13bb1-02fa-4dcb-ae77-27d27bc8915b,VALID |
e7aa0989-54e1-46b7-a850-5763b1f159af,VALID |
| app-store 产物 | d3cb3a0e-a18d-4bf1-8809-7dbbea8b402a(OpenCCman.ipa) |
f6142514-8e94-4cde-ad31-6ab527972b11(OpenCCman.pkg) |
| 产物 SHA-256 | cbe2b42f09ce9bb4df1afd76010b7859ef024ac9ed4c859dbda6b22a3627c3da |
3b2a05e50fbff9da7250b8c8c76f276ab080dacf358843caf9be959e3e3ffdbc |
| 版本 / build(Info.plist) | 2.3 (65);分享扩展 2.3 (65) | 2.3 (65) |
| Workflow 的 Xcode 设置 | Xcode 27.1(27A9275) | 同左 |
| Workflow 的 macOS 设置 | macOS Golden Gate 27.0.1(26A434) | 同左 |
| 实际 Xcode build | 27A9275 | 27A9275 |
| SDK | iPhoneOS 27.1(24A94232) | MacOSX 27.0(26A425) |
| 最低系统 | iOS 15.0(MinimumOSVersion,分享扩展相同) |
macOS 12.0(LSMinimumSystemVersion) |
| 主程序 Mach-O UUID | arm64 0F9AFE2D-B0A5-3C86-BAFB-9283F93F521D;分享扩展 arm64 E160B148-D7AE-3B2D-B129-1B7BAAEF6DDB |
arm64 208EA526-F0BF-3379-BB62-702837AB5829;x86_64 F8FD1365-2957-38C1-83A6-965A6F2A1584 |
以上字段于 2026-11-17 从 Build 65 的产物读回:
- 实际 Xcode build 与 SDK 读自两端日志包的
xcodebuild-archive.log(--xcode-version 27A9275,iPhoneOS27.1.sdk/MacOSX27.0.sdk),与 app-store 导出中的DTXcodeBuild、DTSDKName一致,也与 workflow 设置一致。 - 两端
resolve_package_dependencies.log解析出的 20 个依赖与0fca3a2的Package.resolved完全相同。 - iOS 的 IPA 包含分享扩展
OpenCCmanTextAction.appex(org.gewill.OpenCCman.TextAction,带PrivacyInfo.xcprivacy);macOS 包没有扩展。 - UUID 用
xcrun dwarfdump --uuid读取主程序和扩展的可执行文件。
SPM 依赖(Package.resolved @ 0fca3a2;相对 v2.2 有变化的行加粗)
| 包 | 地址 | 版本 | Revision |
|---|---|---|---|
| bettersafariview | https://github.com/stleamist/BetterSafariView | 2.4.2 | 884533749e55949b2566030948c6fdbe2873ed0c |
| colorfulx | https://github.com/Lakr233/ColorfulX | 6.2.1 | 025be056e59a62d06c6867ad65a7cb03fc63baf1 |
| colorvector | https://github.com/Lakr233/ColorVector.git | 2.0.0 | 6dc3839b6060b835aed8dc82d2d620cc3b4ebe33 |
| displaylink | https://github.com/Lakr233/DisplayLink.git | 3.0.1 | 41bea2661e04bebcb1c4f15fc0b6197850100fdd |
| iqkeyboardcore | https://github.com/hackiftekhar/IQKeyboardCore.git | 1.0.9 | 4ece00fae7ddff664eb7b2c7d3b4b722bcdd438c |
| iqkeyboardmanager | https://github.com/hackiftekhar/IQKeyboardManager | 8.0.3 | 0972dd6eded87c930fb6ad36b3c5ecd620f06894 |
| iqkeyboardnotification | https://github.com/hackiftekhar/IQKeyboardNotification.git | 1.0.7 | efa705d7200edd95b6e31e65e25171f7e897f995 |
| iqkeyboardreturnmanager | https://github.com/hackiftekhar/IQKeyboardReturnManager.git | 1.0.6 | 495f694a6e62e431d776b4926a18fc26c62db317 |
| iqkeyboardtoolbar | https://github.com/hackiftekhar/IQKeyboardToolbar.git | 1.1.5 | 9d44e6b5d49776b8b979d5ff24cd4c7b3a4917c1 |
| iqkeyboardtoolbarmanager | https://github.com/hackiftekhar/IQKeyboardToolbarManager.git | 1.1.6 | f462b3310ac31d4ece7b1346b35abf2c0b3e7eca |
| iqtextinputviewnotification | https://github.com/hackiftekhar/IQTextInputViewNotification.git | 1.0.9 | 723784a2197121bb76a940cc6d79fd2fa6c23f43 |
| iqtextview | https://github.com/hackiftekhar/IQTextView.git | 1.0.5 | 76f514eba5218bdf67659168ba227c77da5f75fe |
| keyboardshortcuts | https://github.com/sindresorhus/KeyboardShortcuts | 3.1.0 | 772133d9dbe800fdac0473226822994c5c162c58 |
| neumorphic | https://github.com/gewill/neumorphic.git | 2.4.1 | 1f5745173dedddf0227fffc47cbdaa3100e5569a |
| purchases-ios-spm | https://github.com/RevenueCat/purchases-ios-spm.git | 5.103.0 | 7276de1d6f8b2cd1fe184c1239a6389a53383600 |
| springinterpolation | https://github.com/Lakr233/SpringInterpolation.git | 3.0.1 | c98d56c895abc41b3f78097dae7ab6dfb015e147 |
| swiftui-introspect | https://github.com/siteline/swiftui-introspect | 27.1.0 | 7f76fe19415a60ce28493c5ec67b8da629f27a44 |
| swiftuirouter | https://github.com/frzi/SwiftUIRouter.git | 1.4.0 | e0cb32b54bb429aa43ce30240b0036bf223a62a3 |
| swiftyopencc | https://github.com/gewill/SwiftyOpenCC | revision | f5ba852583e1fce34889da71f21a644359abe398 |
| swiftyuserdefaults | https://github.com/sunshinejr/SwiftyUserDefaults | 5.3.0 | f66bcd04088582c8fbb5cb8554d577e303bae396 |
相对 v2.2 移除:msdisplaylink。Package.resolved 的 SHA-256:5bd20d3df86f173ee48fd25ba5c2c52da9b5dc5ac59cd3d59455c4d05278ad33。
验证
- Release 构建:Xcode Cloud Build 65 从
0fca3a2归档。Archive - iOS 和 Archive - macOS 两个必需动作都是 SUCCEEDED,iOS app-store 导出成功,两端上传 ASC 后都处理为 VALID。TestFlight Internal Testing - iOS/macOS 两个动作也是 SUCCEEDED。本机没有另做 Release 构建。 - 核心流程:未执行。Build 65 签名包尚未做启动、转换、导入导出验收。
- 集中 UI 验收:未执行。
- 定向检查:发布 PR #346 的 HEAD
31a8550与0fca3a2文件树相同,在其上本地运行check-project.sh、check-app-language.py、check-control-labels.sh,均为 PASS。该 PR 只改了 CHANGELOG,没有重新构建 App。 - CI:App Regression 在 PR #346(run 44058317482)和
main的 push(run 44061163778,提交0fca3a2)上均为 success,App icon 检查也为 success。App Regression 使用 Xcode 26.3,不覆盖 Xcode Cloud 的 Xcode 27.1 构建。 - Xcode Cloud 产物(上传 ASC 的包):只读取了包内 Info.plist、扩展与 UUID,未在最低支持系统(iOS 15、macOS 12)或当前系统上做启动验证。
- TestFlight 复测:macOS 全局快捷键原位替换通过,其余未执行。
- 环境:2026-11-18,macOS 27.2.1(Apple silicon),从 TestFlight 安装的 2.3 (65)。主程序 UUID 与上表的 Build 65 导出一致。
- 设置:设备控制和数据访问权限已授予;转换快捷键 ⌥⌘T,失败提示开、成功提示关;预设为 Traditional · OpenCC(
s2t)。 - 步骤:在 TextEdit 中全选两段简体样本(14 字、26 字)后按 ⌥⌘T。
- 结果:分别在 0.41 秒和 0.45 秒内被原位替换,与
opencc -c s2t的结果逐字一致。剪贴板恢复为测试前写入的内容;前台仍是 TextEdit,主窗口没有被带到前面;没有失败提示。
- 交易与人工验收:除上面的 Mac 快捷键外,以下各项都还没有在 Build 65 上验收,手动上架前需要完成:
未覆盖:
- 上述未执行的各项。
- Mac 快捷键在 TextEdit 以外的 App、终端和只读文字中的表现,失败提示路径,以及「打开选中文本」快捷键(#341 用开发签名的 QA 副本在 Safari、Terminal、VS Code、Chrome、Firefox 等宿主上验过)。
- iPad、Intel Mac、iOS 15–17 真机和 macOS 12 实机。
发布记录
- 提交审核:2026-11-17。
- iOS:12:37:30 UTC,submission
f2af7766-543c-415f-b76b-d6cf29fd89e1,version36f89171-fec0-425d-9b46-c09319e1cfc5。 - macOS:12:37:52 UTC,submission
0d3fa1b2-2bbd-47fc-8be0-f331d1c50172,version7d6ee717-0a85-4f41-b3ef-11dc8a372ba5。 - 两端发布方式都是 MANUAL。
- iOS:12:37:30 UTC,submission
- 审核通过:2026-11-19 发布前读回,两端均为 PENDING_DEVELOPER_RELEASE;精确过审时刻未读取。
- 商店公开状态读回:2026-11-18T19:00:13+00:00,两端均为 READY_FOR_DISTRIBUTION、downloadable=true,关联 Build 65。
- 文案:
- CHANGELOG @ 0fca3a2。
- App Store 两端已写入三语 What's New,macOS 版以快捷键功能回退的修复开头。
- 官网:三语更新记录。
2026-11-19 发布决定与验收边界
维护者在核对上述未验证项后,明确选择“接受这些未验证项的风险,直接发布”。保留原始验收记录:购买/恢复、分享扩展、批量转换、差异查看等 Build 65 验收未执行,不计为通过;本次上架不关闭相关验收 Issue。