v0.48.6（自动构建）

0.48.6 (2026-09-07)

Bug Fixes

• ios: satisfy App Store icon orientation and SDK validation (9ded8b2)
• ios: satisfy App Store icon orientation and SDK validation (091e2d7)

本版本由 CI 在合并到 main 后自动构建发布，未经人工挑选，标记为 Pre-release。想要经过挑选的版本，请下载页面上带 Latest 徽章的那个。

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

iOS

• -ios-testflight.ipa and -ios-testflight.xcarchive.zip are distribution-signed with the project Team ID; the IPA is uploaded to App Store Connect for TestFlight.
• Install the processed build from TestFlight. Apple may take additional time to finish processing before it appears to testers.

v0.47.2（自动构建）

0.47.2 (2026-09-06)

Bug Fixes

• ci: separate automatic and manual release locks (3951152)
• ci: separate automatic and manual release locks (906e14b)

本版本由 CI 在合并到 main 后自动构建发布，未经人工挑选，标记为 Pre-release。想要经过挑选的版本，请下载页面上带 Latest 徽章的那个。

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

iOS

• Both iOS assets are unsigned: this project has no Apple signing identity, so neither will run on a device until it is signed.
• -ios-unsigned.ipa is the one to take. Sign it with your own Apple ID using a re-signing tool such as Sideloadly or AltStore and install it; the keyboard is then enabled in Settings > General > Keyboard > Keyboards. A free Apple ID signature expires after 7 days and a paid Developer Program one after a year, at which point it has to be re-signed.
• -ios-unsigned.xcarchive.zip is for a maintainer with a Developer Program membership: open it in Xcode Organizer and distribute to TestFlight or the App Store from the exact bits this tag built, without rebuilding.

v0.47.1（自动构建）

0.47.1 (2026-09-06)

Bug Fixes

• release: resolve iOS artifact output path before zipping (eed9c69)
• release: resolve iOS artifact output path before zipping (e058dc7)

本版本由 CI 在合并到 main 后自动构建发布，未经人工挑选，标记为 Pre-release。想要经过挑选的版本，请下载页面上带 Latest 徽章的那个。

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

iOS

• Both iOS assets are unsigned: this project has no Apple signing identity, so neither will run on a device until it is signed.
• -ios-unsigned.ipa is the one to take. Sign it with your own Apple ID using a re-signing tool such as Sideloadly or AltStore and install it; the keyboard is then enabled in Settings > General > Keyboard > Keyboards. A free Apple ID signature expires after 7 days and a paid Developer Program one after a year, at which point it has to be re-signed.
• -ios-unsigned.xcarchive.zip is for a maintainer with a Developer Program membership: open it in Xcode Organizer and distribute to TestFlight or the App Store from the exact bits this tag built, without rebuilding.

v0.46.0

0.46.0 (2026-09-06)

Features

• ios: publish an unsigned iOS archive with every release (496ecec)

Bug Fixes

• ci: stop the engine bump triage from executing engine file names (58f743b)
• ios: stop discarding the composition on the keyboard's own edits (ecc03fc)
• mac: dispatch the punctuation keys the engine gained, and repair the toolbar menu (1298b90)

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

iOS

• The -ios-unsigned.xcarchive.zip asset is an unsigned archive, not an installable app. iOS has no equivalent of allowing an unsigned build in Privacy & Security, and a custom keyboard can only be installed through the App Store or TestFlight.
• It is published so a maintainer with an Apple Developer Program membership can export an IPA from the exact bits this tag built, without rebuilding.

v0.45.2

0.45.2 (2026-09-06)

Bug Fixes

• consolidation: align data notices and release checks with Engine (47362d3)
• release: accept the current semantic dictionary tag in configuration checks (e89e205)

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

v0.45.0

0.45.0 (2026-09-05)

Features

• ios: let the tryout field put the keyboard away (2cba7fb)

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

v0.44.0

0.44.0 (2026-09-05)

Features

• mac: use shared Engine voice and consolidated data sources (9c1ac5e)

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

v0.43.1

0.43.1 (2026-09-05)

Bug Fixes

• mac: stop annotating and converting local-mode candidates (628009b)

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

v0.42.0

0.42.0 (2026-09-05)

Features

• ios: page through candidates past the ninth (9205bdb)
• ios: report engine diagnostics in the keyboard (7b8be3b)
• ios: show double-pinyin hints on the keys (c4f052d)

Bug Fixes

• ios: keep the key hints on one line (7ea9081)

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.

v0.41.1

0.41.1 (2026-09-05)

Bug Fixes

• dictionary: hold the fetched database to committed digests (7a92195)
• dictionary: 按提交的摘要校验词库,并补上 #234 漏掉的归属声明 (fbba79a)
• ios: stop announcing the settings row icons (e1bca55)
• mac: 遵循每页候选数量设置，并让窗口尺寸适应内容 (309bec1)

Reverts

• move back off calendar versioning (df803f9)
• move back off calendar versioning (dd59d10)

[!WARNING] These macOS artifacts are not Developer ID signed or notarized because release signing credentials were not configured. The asset filenames are marked unsigned.

Install on macOS

• Recommended: ZIP. Verify its .sha256, extract it, then run Install.command. It installs for the current user, registers and enables the exact input source, and does not automatically log out or restart the Mac.
• PKG option. The native Installer copies the same app and attempts to register and enable 水杉 for the logged-in GUI user. If no GUI user is logged in or macOS blocks the app, enable it later in System Settings > Keyboard > Text Input > Edit. The package does not force a logout or restart; macOS may still require a later logout before a newly copied input method appears.