vChewing-macOS 发行版

3.8.6

2024-07-07 12:02

3.8.6

#### 3.8.6 版针对 3.8.5 版更新了下述内容：

- 修正：[所有发行版] 修复了威注音偏好设定的「开发道场」当中某些与内文组字区下划线有关的选项「对选字模式不起作用」的故障。虽然此处偏好设定画面仅提到了标记模式，但威注音从几个月前引入「选字模式下，组字区内可实时预览选字结果」的特性时起就对选字模式也启用了粗细分段下划线的设计，而某些 EBA 客体应用（详见下文）对此有相容性故障。
- 行为：[所有发行版] 从该版输入法更新开始，威注音输入法会主动检查客体应用是否是「以 Electron 这款 Web 框架构筑的应用（简称 EBA 客体应用）」。如果是的话，则会对当前客体应用强制启用浮动选字窗、以规避可能在 EBA 应用内出现的输入法内文组字区相容性故障。借由对这几年的故障提报的综合分析来看，每一款 EBA 应用都可能或多或少会有与威注音的相容性问题（除非启用浮动组字窗），故可知今后的 EBA 应用对 IMKTextInput 与内文组字区有关的 API 的行为完全不可预测。而 EBA 应用的开发者们往往因为自身的语言障碍等原因无法重现这个问题、更无法积极检查并解决这类问题。这些原因使得威注音开发者再也无法事先信任任何 EBA 应用是否有认真实作 IMKTextInput 协定、再无任何心力给每个有相容性故障的 EBA 应用逐一擦屁股，只得出此下策。使用者仍可以在威注音偏好设定的「开发道场」内关掉这个预设行为。
- 行为：[所有发行版] 从该版输入法更新开始，如果当前作业系统版本是 macOS 10.15 或更新版的话，则所有的异步操作均会尽可能改用 Swift Concurrency 完成。在更旧版的系统内运作时，威注音仍会继续使用 Grand Central Dispatch。
- 行为：[所有发行版] 针对田所选字窗的的预设文字颜色的实现方式做了一些调整、使其参数值不再依赖作业系统自身的 API。
- 研发：[所有发行版] 将辞典建置脚本的行为做了更改：先就地制作 SQL 纯文字档案，再将其直接转换成 SQLite 档案。
- 研发：[所有发行版] 针对 Xcode 16 与 Swift 6 做了建置策略相容处理。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道/鸣潮语料更新；全字库资料更新为 v2024-06-26 版本。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 近期 macOS 14.4.x 更新导致有些使用者经常遇到与 SecureEventInput 有关的滥用警告。威注音不替任何滥用 SecureEventInput 的软体开发者们负责。受不了相关警告的话，虽然您也可以借由输入法偏好设定画面的开发道场页面来关掉相关侦测功能，但您也还可以将这类软体检举给 Apple Support，因为他们对 SecureEventInput 的滥用行为祸害了系统内所有的第三方输入法软体的正常运作。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的系统的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 强烈建议您将您在用的任何终端机软体都拽入威注音输入法的客体管理器（且打勾），因为几乎所有的副厂终端机软体的开发者们在技术上都没有任何动力去将内文组字区的体验做得像 macOS 内建终端机那样完美。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7. 威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. Naver Line 聊天软体对 IMKTextInput 内文组字区的实作有问题（尤其是在使用 Dark Mode 的时候，根本看不到组字区下划线），所以被威注音预设放在客体管理器黑名单内。副作用就是一定会出现浮动组字窗，请谅解。如果您一定想要在 Line 软体内使用内文组字区的话，请借由客体管理器自行取消对 Naver Line 的勾选，相关后果自负（因为一切责任都在 Naver Line 的开发团队）。
9. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方开发者拿来用的话，这维护成本实在是过于空前。
10. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.8.6-signed.pkg
44e6b80b145fcb742726b8796164dad34758d8a40c24491d89d677c09911edd3

vChewing-macOS-3.8.6-signed-alternative.zip
5d106d5eb1cff230b9c46075ac334bae136caa34e05c7eade340a600b7d2edcc

最后提交信息为： [VersionUp] 3.8.6 GM Build 3860.

3.8.5

abb17e9

2024-04-07 01:49

3.8.5

#### 3.8.5 版针对 3.8.4 版更新了下述内容：

- 修正：[所有发行版] 为了因应部分使用者的自订辞典资料量过于庞大之现状，威注音输入法将记忆体使用上限阈值由 384MB 上调至 1024MB。当威注音输入法的实际记忆体使用量超出该阈值时，威注音输入法会主动自尽、自动重新启动。
- 修正：[所有发行版] 解决了在点灭 CapsLock 键时「会有浮动组字窗在萤幕上残留显示」的故障。该故障当且仅当关掉了系统内建的 CapsLock 英数切换功能时才会触发。
- 体验：[所有发行版] 对浮动组字窗与田所选字窗的候选字词高亮底色做了少许调适，也针对浮动组字窗启用了圆角窗体设计。
- 体验：[所有发行版] 田所选字窗：允许使用者将「横向多列选字窗最低单元宽度」设定为两个 Emoji 或两个汉字。
- 行为：[所有发行版] 微调了针对使用者语汇档案内的单汉字字音配对的预设权重指派策略与控频策略。
- 研发：[所有发行版] 铁恨注拼引擎升级至 v1.6.0，加快了建置速度。
- 研发：[所有发行版] 允许使用一个新的终端机命令、将当前输入法的所有使用者自订语汇资料写入到一个单独的 JSON 档案内。
    - 该功能便于其他输入法开发者们汇入威注音输入法的使用者自订语汇资料。
    - 推荐以 Bash 或 Zsh 来执行该命令。
    - 不包含关联词语资料：`~/Library/Input\ Methods/vChewing.app/Contents/MacOS/vChewing --dump-user-dict > ~/Downloads/Dumped.json`
    - 包含关联词语资料：`~/Library/Input\ Methods/vChewing.app/Contents/MacOS/vChewing --dump-user-dict-all > ~/Downloads/Dumped.json`
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 近期 macOS 14.4.x 更新导致有些使用者经常遇到与 SecureEventInput 有关的滥用警告。威注音不替任何滥用 SecureEventInput 的软体开发者们负责。受不了相关警告的话，虽然您也可以借由输入法偏好设定画面的开发道场页面来关掉相关侦测功能，但您也还可以将这类软体检举给 Apple Support，因为他们对 SecureEventInput 的滥用行为祸害了系统内所有的第三方输入法软体的正常运作。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的系统的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 强烈建议您将您在用的任何终端机软体都拽入威注音输入法的客体管理器（且打勾），因为几乎所有的副厂终端机软体的开发者们在技术上都没有任何动力去将内文组字区的体验做得像 macOS 内建终端机那样完美。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7. 威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. Naver Line 聊天软体对 IMKTextInput 内文组字区的实作有问题（尤其是在使用 Dark Mode 的时候，根本看不到组字区下划线），所以被威注音预设放在客体管理器黑名单内。副作用就是一定会出现浮动组字窗，请谅解。如果您一定想要在 Line 软体内使用内文组字区的话，请借由客体管理器自行取消对 Naver Line 的勾选，相关后果自负（因为一切责任都在 Naver Line 的开发团队）。
9. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方开发者拿来用的话，这维护成本实在是过于空前。
10. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.8.5-signed.pkg
2e1a027fd415b12ada1a7835f6bfb12814df578263d50f296fb2b0dbd820092c

vChewing-macOS-3.8.5-signed-alternative.zip
0c81525cf33c15f13df91620838e32852e794854681744251d9c0d00a65352d2

最后提交信息为： [VersionUp] 3.8.5 GM Build 3850.

3.8.4

f46cfda

2024-03-08 06:33

3.8.4

#### 3.8.4 版针对 3.8.3 版更新了下述内容：

- 修正：[所有发行版] 紧急修复了一处与「SecureEventInput 滥用行为侦测模组」有关的记忆体泄漏故障。
  - 故障原因：与 IOKit 有关的 Unmanaged CoreFoundation 物件在「电脑待机休眠时拿不到结果的情况下」没能被及时主动释放掉，导致累积的记忆体泄漏。
- 行为：[所有发行版] 「SecureEventInput 滥用行为侦测模组」不会再在下述应用场景执行主动侦测：桌面锁定、帐号未登入、帐号切换画面、萤保画面。
- 研发：[所有发行版] 这次的威注音输入法官方安装包均改用 Xcode 15.3（Swift 5.10）建置。须知：目前威注音输入法的专案建置要求仍是至少 Xcode 14.2.0，但未来恐有变数。
- 研发：[所有发行版] 统整了输入法的各个内部模组之间的相依关系。
- 研发：[主流发行版] 新增了 vChewingDebuggable 临时建置目标，以便第三者参与对威注音输入法的自愿排障测试。该建置目标会将威注音输入法见制成一个普通的 SwiftUI macOS App（而非输入法），可以放心用来下断点、而不用担心整个 macOS 桌面因此失去响应。该建置目标生成的 App 会单独使用一套 UserDefaults 容器，且与该建置目标有关的任何偏好设定修改都不会影响到威注音输入法自身的偏好设定。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方开发者拿来用的话，这维护成本实在是过于空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的系统的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.8.4-signed.pkg
2d2a592e7e58745ee59822f7eb5f1c18fa73a757756cba085548c8df720a34fc

vChewing-macOS-3.8.4-signed-alternative.zip
ad6931370a58b048f9c6e5ff25094d3db79f4f52d41826ca9038cb3ecf7cd4e8

最后提交信息为： [VersionUp] 3.8.4 GM Build 3840.

3.8.3

9dc7821

2024-03-03 00:03

3.8.3

#### 3.8.3 版针对 3.8.2 版更新了下述内容：

- 修正：[所有发行版] 修复了客体管理器视窗内的清单窗格「不显示滚动条」的故障。
- 修正：[所有发行版] 修复了「SwiftUI 版偏好设定视窗内建的使用者语汇编辑器」可能「无法成功监视该档案的来自其它程式的修改」的一处 KVO 故障。
- 体验：[所有发行版] 新增了一个选项，允许使用者自主设定 Command+Option+Ctrl+Enter 要递交的内容。该内容可以是盲文点字或各种带注音标记的字句。
- 体验：[所有发行版] 新增盲文点字输出支援，分别对应「1947 国语点字」与「2018 国通盲文」这两个现行标准。
  - 威注音输入法对盲文点字的支援仅限于「将给定的读音资料以点字阵列的形式递交」这一个特性。
    - 这是最实际的做法，因为「拿破音字匹配读音」这种功能需求在原理上是不可能**准确实作**的。
- 体验：[所有发行版] 新增「服务选单」功能。该功能可在选字窗内以当前候选字（及其可利用的可能存在的读音资料）作为参数依据、来显示可用的服务：
  - 有些服务是写死在输入法内部的，都有着各自的 ObjC Selector 名称作为呼叫依据。这类服务的查询结果会被直接写入剪贴簿。
  - 有些服务是 URL，可以叫出对应的 App 来查询相关参数。如果是以 https 或 http 开头的话，会用浏览器叫出网页来查询。
    - 当个别情况下的选字窗内没有读音资料可用的话（比如波浪符号选字窗），则某些依赖读音资料的服务不会出现在服务选单内。
  - 该选单可以用波浪符号键在选字窗内呼叫出来，也可以在输入法偏好设定内自己决定是否可以在选字窗内使用「Shift+?」呼叫。
  - 与同期小麦注音正在开发的同名功能相比，威注音输入法的该功能的实作方式一如既往地完全不同，且允许使用者自订该选单的内容与顺序。
    - 如果你在输入法主选单内找不到「服务选单编辑器」这个选单项的话，可以尝试在输入法主选单显示时摁下 Option 键。
    - 威注音的服务选单不具备念读功能。威注音输入法的念读功能仅限组音区，相关选项请洽输入法偏好设定的「一般设定」页面。
    - 考虑到时代因素，威注音的服务选单对汉字的编码查询仅支援 Unicode CodePoint 查询。目前没有提供除此之外的编码查询的计划。
    - 如果「服务选单编辑器」内的服务全都被删掉的话，则服务选单功能会进入停用状态。
- 行为：[所有发行版] 针对「单个汉字的字音配对」专门制定了新的控频方法：不再一次性无脑杠到最高权重/最低惩戒权重，而是每次操作都会挪一次该候选字在选字窗当中的排序位置。
  - 该选项目前仅对输入法内建的注音输入模式有效，且对逐字选字模式无可用影响：组字选字模式会强行套用倚天中文 DOS 系统内建的注音输入法的候选字排序。
- 行为：[所有发行版] 因应服务选单功能的引入，威注音从这一版开始有了下述行为变化：
  - 无法再将波浪符号键对应的符号设为选字键。
  - 根据输入法偏好设定内的与服务选单有关的某些选项的开关状态，问号「?」也会有无法被设为选字键的情况。
  - 想要从波浪符号选单直接借由「Option+波浪符号键」跳转到「汉音键盘符号模式的话」，需要多按一次这个热键组合，因为第一次按下时会先切换到服务选单。
    - ……除非你在「服务选单编辑器」内删掉了全部的服务。
- 研发：[所有发行版] 将 PrefMgr 由 MainAssembly 剥离、塞到了 Shared 这个更基层的模组内。这给今后的功能开发带来了一些便利。
- 辞典：[所有发行版] 针对「一繁对多简」的情况，修复了在组字选字模式下使用简体中文原厂词库时「倚天中文 DOS 系统候选字排序资料」的一些简体字映射失误。
- 辞典：[所有发行版] 例行语汇资料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方开发者拿来用的话，这维护成本实在是过于空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的系统的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.8.3-signed.pkg
8c12957fa54a707849cbb787258a1f32b3d11feaa26b12ba8426f513a012ea0f

vChewing-macOS-3.8.3-signed-alternative.zip
a15b36c8f1d35ada35d267ceaadc00b53542c779b5f9adcf6d2e9119f2957ad4

最后提交信息为： [VersionUp] 3.8.3 GM Build 3830.

3.8.2

549c361

2024-02-24 04:41

3.8.2

#### 3.8.2 版针对 3.8.1 版更新了下述内容：

**一句话总结**：本次更新没有功能上的变化，对使用者而言变化了的内容只有原厂辞典。

- 研发：[所有发行版] 针对整个语言模组套件（LMAssembly）做了架构调整：
  - 将半衰记忆模组修改成「语言模组副本化模组（LMInstantiator，下称「LMI」）」的内部从属模组，对外互动过程一律通过 LMI 模组来完成。
  - 将倚天中文 DOS 候选字词排列资料整合到 Swift 原始程式码内，不再读取单独的 JSON 档案。
  - 将 LMAssembly 的所有对外 API 做了精实案，仅对外开放必要之 API。
- 研发：[所有发行版] 全专案淘汰 NSJSONSerialization API 的使用、以 Swift Foundation 内建的 JSON Codec 取而代之。
- 辞典：[所有发行版] 例行语汇资料更新（也是此次版本更新的重点）：
  - 删除了一些源自于 LibTaBE 的错误词音配对。
  - 筛检了原厂繁体中文词库出现的个别简体中文词语、全部订正为繁体中文。
  - 对星穹铁道的语料做了一些跟得上游戏版本变化的内容增补。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方开发者拿来用的话，这维护成本实在是过于空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的系统的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.8.2-signed.pkg
a1b2c35b746778b29b938502d42c71ced2b27f9f740ebcd213cbc938077c7d4c

vChewing-macOS-3.8.2-signed-alternative.zip
9ce5232069b36b6ce86202f6f8a87fa06b30171a737a56fe452495a9611691f4

最后提交信息为： [VersionUp] 3.8.2 GM Build 3820.

3.8.1

a559818

2024-02-17 01:28

3.8.1 SP1

#### 3.8.1 版针对 3.8.0 版更新了下述内容：

- [SP1] 修正：[所有发行版] 解决了田所选字窗的字根反查区域在某些情况下「更新不及时、会残留前一笔查询结果」的故障。
- [SP1] 修正：[Aqua 纪念版] 解决了「关于」视窗内的右下角的按钮堆叠在 macOS 10.9 系统下的显示异常。
- [SP1] 修正：[主流发行版] 解决了 App 型安装包不显示产品著作权资讯的故障。
- 修正：[所有发行版] 解决了 macOS 10.9 - 10.12 的输入法选单在「摁 Alt 键执行不同的功能、显示不同的选单内容」会导致 NSMenuItem 与它们对应的 selectors 对位发生错位的问题。详情见下文。
- 修正：[所有发行版] 解决了 AppKit 版偏好设定视窗当中的念读设定无法立刻生效的故障。
- 修正：[所有发行版] 修复了 Dvorak-QwertyCMD 键盘布局的映射错误。
- 修正：[所有发行版] 解决了 AppKit 版偏好设定在 macOS 10.9 系统下的日语/英语介面的排版拥挤问题。
- 修正：[所有发行版] 解决了在「汇入奇摩输入法自订词资料库」之后、偏好设定视窗内的使用者语汇编辑器「不自动重新载入内容」的故障。
- 体验：[所有发行版] 新增了一个可选功能：使用输入法内建的 CNS11643 全字库资料库来对语言模组的输出资料做自动过滤、仅允许那些有采用 CNS11643 全字库规定读音的结果输出至输入法的组字引擎与选字窗内。
- 体验：[Aqua 纪念版] 针对 macOS 10.9 - 10.12 重新设计了「汇入奇摩输入法自订词资料库 TXT 档案」的图形介面交互方式。现在起，除了下文要提到的 NSConnection 通讯手段直接汇入奇摩输入法自订词资料库以外，您还可以将从奇摩输入法汇出的该资料库的 TXT 档案直接从 Finder 拽入至「输入法偏好设定->偏好设定->汇入奇摩输入法自订词资料库->请将档案拽到这边」这个按钮上、来完成对 TXT 资料库档案的汇入操作。
- 体验：[所有发行版] 允许直接借由 NSConnection 通讯的手段向奇摩输入法发出资料请求、借此汇入奇摩输入法的使用者自订词资料库的内容。这个功能只会在使用者主动使用时才会触发。
- 体验：[所有发行版] 新增了一个功能选项，让田所选字窗在显示符号时将符号描述（统一码码位点）显示于字根反查清单的位置。该功能预设启用。
- 行为：[所有发行版] 针对 macOS 10.9 - 10.12 另外研究了一套 NSMenu 输入法选单应对方案，解决了上文提到的 selectors 错位的故障。新方案带来的唯一副作用：在 macOS 13 及之前版本的系统下会无视 NSMenuItem.isAlternative 特性、强制显示本该摁了 Alt 才会显示的选单项。macOS 14 不受该副作用所影响。
- 研发：[所有发行版] 尝试解决了 AppKit 版偏好设定视窗的一些已知的 Constraints 冲突。
- 研发：[所有发行版] 重新统一整理了整个 App 对于情态视窗的挂接目标。
- 辞典：[所有发行版] 例行语汇资料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方开发者拿来用的话，这维护成本实在是过于空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的系统的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.8.1-signed.pkg
7d4278b8e92b053e37e5cfe793fe80e69c72c322216c50e3bc786da36269a4e3

vChewing-macOS-3.8.1-signed-alternative.zip
4e6d298eed088d3655437cfc3bf84e5fa3b468a5d8680e8b6145599bfaced7a4

最后提交信息为： [VersionUp] 3.8.1 SP1 Build 3811.

3.8.0

1b3dcb0

2024-02-12 18:02

3.8.0 SP1

#### 3.8.0 版针对 3.7.3 版更新了下述内容：

- [SP1] 修正：[所有发行版] 紧急修复了 AppKit 版偏好设定视窗「无法更改当前编辑的使用者语汇资料种类」的故障。
- 修正：[Aqua 纪念版] 在 macOS 10.9 - 10.12 系统下移除了「汇入奇摩输入法自订词资料库」按钮，因为该按钮对 NSOpenPanel 的呼叫会触发这几版 macOS 系统的内建缺陷、使得整个桌面停止响应。下一版威注音输入法会对该功能在这几版系统下的使用交互方式重新设计。
  - 作为备选方案，威注音 Aqua 纪念版在 3.8.0 版引入了一个新功能：允许使用终端指令汇入奇摩输入法的自订词资料库。
    - 该终端指令的使用方法为「 `~/Library/Input\ Methods/vChewing.app/Contents/MacOS/vChewing --import-kimo 奇摩输入法TXT档案路径` 」。
    - 威注音主流发行版也已经在 3.8.0 SP1 版引入对该终端指令的支援。
- 修正：[Aqua 纪念版] 解决了以 Xcode 15 建置出来的 App 安装程式在 macOS 10.9 - 10.14 系统下「无法正常启动」「无法正常处理 TISInputSource CoreFoundation 物件的 ARC 行为」这两处崩溃故障。至此，Xcode 14.2 不再成为刚需。
- 修正：[Aqua 纪念版] 修正了输入法版本更新检查模组在不满主流发行版所要求的系统版本下提示「切换到主流发行版」的错误行为。
- 体验：[所有发行版] 对 AppKit 版偏好设定视窗做了精实案，使之拥有与 SwiftUI 版偏好设定视窗同等品质的完成度与使用体验。这也减去了对 AppKit 版偏好设定视窗的新选项实作（包括相关内容的本地化工作）时的额外维护成本。所有的介面选项元素全部都是基于 UserDefaults 的既定资料动态生成的。// 前一版威注音输入法更新已经对 SwiftUI 版的偏好设定视窗做过同样的精实案。
- 体验：[所有发行版] 新增了一个与选字游标有关的选项，允许输入法在叫出选字窗的时候纠正不合理的端点选字游标位置。该选项预设启用。
- 体验：[所有发行版] 给浮动组字窗的游标新增了阴影，提升其辨识度。
- 体验：[所有发行版] 新增了一个与选字游标有关的选项，允许输入法在选字窗显示的时候使用 J / K 键移动组字区内的游标。这个选项专门用来照顾 PIME 版新酷音输入法使用者的习惯。该选项不预设启用，且有下述条件限制：
  - 必须是普通的、有用到组字区打字时的选字状态。
    - 比如说逐字选字模式、汉音键盘符号模式、波浪符号选单等情况就无法使用该特性。
  - 必须是直接敲 J / K 键、且不得有任何修饰键被按下。
    - 这一点与 PIME 新酷音略有不同：PIME 新酷音对此未做出这种条件检查限制。
  - 一旦启用该特性的话，威注音输入法会禁止 J / K 键用作选字键。
    - 如果磁带模组当前载入的磁带所规定的选字键有用到这两个键的话，则当前磁带的选字键定义资料会被威注音输入法忽略掉。
- 行为：[所有发行版] 对之前允许输入法在选字窗显示的时候「使用 Alt(+Shift)+前后方向键来挪动组字区内的游标」的特性新增了下述条件限制：
  - 必须是普通的、有用到组字区打字时的选字状态。
    - 比如说逐字选字模式、汉音键盘符号模式、波浪符号选单等情况就无法使用该特性。
- 行为：[所有发行版] 纠正了 NSEvent 在身为 flagsChanged 事件时转译为 KBEvent 的过程当中「违规存取自身不存在的属性（ `characters` `charactersIgnoringModifiers` `isARepeat` ）这一错误行为。这个错误行为会导致 macOS 系统 consle 狂喷「NSInternalInconsistencyException」错误。
- 研发：[所有发行版] 全专案统整了对档案与目录的开启方法，采用专用的 enum 统一管理这一类行为。
- 研发：[所有发行版] 不只 AppKit 版偏好设定视窗被做了精实案，软体的输入法选单、关于视窗、以及客体管理器也都做了同样的精实案，使得输入法本体彻底摆脱了对专有 XIB 的依赖。
- 研发：[所有发行版] 针对按键讯号调度模组当中的「普通打字模式（注音/磁带）」「内码输入模式」「汉音键盘符号模式」这三个子模式的轮替切换功能做了重构，设计了专有的 Enum 来管理对这三个子模式的轮替切换行为。这方便了未来对如何实作「允许使用者停用个别模式」等新特性的可行性探究。
- 辞典：[所有发行版] 例行语汇资料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方开发者拿来用的话，这维护成本实在是过于空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的系统的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.8.0-signed.pkg
271abe87e3e1857d0f5b6d20441efcb7f47b7b447abccc46207bbfaae7a9a188

vChewing-macOS-3.8.0-signed-alternative.zip
7d6c95452d0d1a9823569071819172b15383bd5814c5564fd4491cbf503ce5bc

最后提交信息为： [VersionUp] 3.8.0 SP1 Build 3801.

3.7.3

77f3902

2024-02-02 21:44

3.7.3

#### 3.7.3 版针对 3.7.2 版更新了下述内容：

- 修正：[所有发行版] 解决了「SecureEventInput 滥用行为侦测模组」无法正确检测萤幕保护程式状态的故障。
- 修正：[所有发行版] 解决了「SecureEventInput 滥用行为侦测模组」不检测电脑睡眠状态状态的设计缺陷。
- 体验：[所有发行版] 允许在选字窗内移动组字区内的游标：
  - 使用「Alt+文字输入方向上的前后方向键」热键的话，会以（在叫出选字窗之前的）组字区既定字词节点为单位来移动游标游标。
  - 使用「Shift+Alt+文字输入方向上的前后方向键」热键的话，则会依单个幅位长度（读音）移动游标。此谓「逐幅移动」。
    - 如果在逐幅移动游标时出现「游标位于字元中间」的情况的话，则会朝着当前的游标移动方向将游标移动到当前节点的边界线上。
- 体验：[所有发行版] 允许使用者自订数字小键盘的输入行为。此前仅支援「直接递交半形数字符号」这一种行为；而现在则追加了五种新的行为选项。
- 体验：[所有发行版] 从现在起，当您有将选字窗的高亮配色方案设定为跟随系统/客体软体的配色方案时，浮动组字窗的配色也会有对应的改变。
- 行为：[所有发行版] Shift 按键事件侦测模组的延迟从 0.3 秒改为 0.2 秒。
- 研发：[所有发行版] 全专案改用了全新的 KBEvent Struct 作为威注音输入法专用的按键讯号通讯格式。
  - 该更动乃是为了应对威注音输入法今后可能的跨平台移植需求。
  - 该更动也使得输入法的按键处理速度有了明显提升，毕竟是 Swift 原生的 Struct。
  - 该格式拥有与 NSEvent 互相转化对译的能力。
- 研发：[所有发行版] 重构了语言模组管理器：重新设计了该管理器对语言模组的交互方式。
- 研发：[所有发行版] 针对按键调度做了轻度翻修，使其对 ModifierFlags 的处理更加精确。
- 研发：[主流发行版] 针对 SwiftUI 偏好设定介面的内容呈现机制做了大翻新。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新，以及全字库资料更新至 2024年1月15日 的版本。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://gitee.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.7.3-signed.pkg
aca6372bb5848d833c16dac935ffac600ec45cc0382179fa390c20c3050036bb

vChewing-macOS-3.7.3-signed-alternative.zip
9cdc0aa17631ba9bf7a9f6e06e72bc1953b203de6b9787d6d2da342d8f021ff3

最后提交信息为： [VersionUp] 3.7.3 GM Build 3730.

3.7.2

5fb0bab

2024-01-08 02:00

3.7.2

#### 3.7.2 版针对 3.7.1 版更新了下述内容：

- 修正：[所有发行版] 解决了因为 SQLite 日志导致的记忆体用量失控的故障。从这一版开始将不再启用任何 SQLite 日志。
  - 因为威注音只有原厂辞典会用到 SQLite、且这类资料通常都是唯读资料，所以从原理上就对日志功能特性没有需求。
- 修正：[所有发行版] 解决了原厂辞典资料建构脚本当中的 Segmentation Fault 故障。
- 修正：[所有发行版] 解决了内文组字区「在组音区有内容时，将游标始终显示在文字输入方向的最前方」的故障。
- 体验：[所有发行版] 新增念读模式，可以在注音模式（而非磁带模式）下念出自己敲出的读音。
  - 该功能可用于一些特殊场合，比如哑巴或有口头表达障碍的人士可以在做简报的时候让威注音替自己把话讲出来……等。
  - 该模式会占用一点点记忆体（平均不到 10MB），且在关掉之后可能需要重新启动输入法、让系统释放对应的记忆体占用。
  - 该功能可在输入法偏好设定内配置，有三档选项可供选择：
    - 不念读：什么都不念出来，也就是关掉这个功能。该选项为预设值。
    - 仅在用声调键确认时：当且仅当组音区的读音被成功插入组字引擎时，才会念一遍。
    - 实时念读组音区的任何变化：只要组音区的内容有变化，组音区的内容就会被整个念出来。
      - 这个特性比较适合动态注音布局学习者，但多少有些聒噪了。
- 体验：[所有发行版] 联想词模式升级为关联词语模式；现在起，在没有开启逐字选字模式时，也可以使用关联词语模式。
  - 威注音的关联词语模式不会用到内文组字区。这样一来，虽然在某些方面的体验上不如小麦注音的新版联想词功能（小麦PR412），但也躲开了「拿破音字尝试自动匹配读音」这种**永远都无法正确实作**的功能需求。
    - 双方对该模式的实作思路完全不同，感兴趣者可以自行比对。
  - 威注音的关联词语只会以当前内文组字区的（在文字输入方向上的）最前方的「字音配对」与「字词节点词音配对」为最长检索依据。
    - 该功能也会尝试获取「不考虑读音」时的检索结果。
    - 如果该节点的幅长（读音长度）与字元数量不相等的话，则这种情况下不考虑以读音作为检索依据。
  - 在没有开启逐字选字模式时，关联词语选字窗的触发热键为 Shift+Enter。
  - 威注音的关联词语专用辞典可在输入法偏好设定内自订，且这次功能更新并未修改使用者关联词语辞典的档案格式。
    - 借由 Windows 9x/NT3/NT4/2000/XP/2003 内建全拼输入法 / ㄅ半输入法的相关字词编辑工具生成的使用者关联词语档案可直接使用，需先以 UTF-8 编码存档。
- 行为：[所有发行版] 这一版开始，威注音输入法的「SecureEventInput 滥用行为侦测模组」会转而使用与当代 macOS 相容的「用来侦测当前萤幕是否被锁定」的 API、以图进一步减少对 com.apple.loginwindow 的「SecureEventInput 滥用行为」误报。
  - 该模组在侦测到这一类行为的时候，会主动知会使用者，借此明确与此有关的「输入法可用性故障」的责任归属。
  - 该模组不会对有这类犯行的执行绪有任何砍杀操作，使用者可利用系统内建的 Activity Monitor 等手段自行实施相关操作。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.7.2-signed.pkg
ffd2afad271b121d2bd991f8c22f180230b758a984800430ea94bca6655c486c

vChewing-macOS-3.7.2-signed-alternative.zip
bc01b687893f523b3291b3163ac91203559a10c7d97eee68f704154ed0ab2f6b

最后提交信息为： [VersionUp] 3.7.2 GM Build 3720.

3.7.1

d7fb717

2024-01-01 00:48

3.7.1 SP1

#### 3.7.1 版针对 3.7.0 版更新了下述内容：

- 修正：[所有发行版] 解决了上一个版本复发的「旧的输入法会话控制副本会干涉新的输入法会话副本的选字窗的显示」的故障。
- 修正：[所有发行版] 解决了磁带模组在换插磁带的时候「没能彻底先清空之前的磁带在记忆体内的资料」的故障。
- 修正：[所有发行版] 解决了威注音输入法在繁体中文模式下叫出 macOS 语音输入时「只能使用简体中文语音输入」的故障。
- 研发：[所有发行版] 对磁带模组的磁带内容读取解析流程做了重构，使之更容易维护。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.7.1-signed.pkg
bb587471ac79a7eee05a5401b5b93b99fd16a9c1bdf059fd0fca7be246de0007

vChewing-macOS-3.7.1-signed-alternative.zip
27fafe55e4b7becdf2fdf56c8e0bb4cd74fa0184f891fbadd28e7437adcc5321

最后提交信息为： [VersionUp] 3.7.1 SP1 Build 3711.

3.7.0

b0e237e

2023-12-29 00:23

3.7.0

#### 3.7.0 版针对 3.6.3 版更新了下述内容：

- 修正：[所有发行版] 天权星组字引擎升级至 v2.7.3，重新将 KeyValuePaired 与 Unigram 变成 Struct，以修复在某些极端情况下「Swift 的 Set 当中被塞入了两个『明明完全不同、却被判定为相同』的 Class、从而崩掉整个软体」的情况。
- 体验：[所有发行版] 解决了在某些情况下会出现的「之前的打字输入会话副本所用的选字窗残留在萤幕上」的故障。
- 体验：[所有发行版] 为了照顾 macOS 14 Sonoma 迄 14.2.1 版为止的上下文输入法提示器当中的狗屄倒肏的输入法图示显示效果，威注音临时更换了输入法选单图示（因为是一条线上的蚂蚱）。等到啥时候 Apple 给出官方的开发说明文件、来允许且指导第三方使用者怎样实作该图示的时候，威注音输入法会再更换选单图示。
- 行为：[所有发行版] 此次更新引入了全新的 InputToken 敲字代令处理系统。
  - 目前可借由下述词语输入来触发动态生成的候选内容：
    - 「时间」「星期」「今年年度、去年年度、明年年度、前年年度、后年年度」；
    - 「当前时区、目前时区、所在时区」；
    - 「今天日期、明天日期、昨天日期、前天日期、后天日期」；
      - 以往可以直接输入「日期」迅速输入当前日期，但从该版本起必须输入「今天日期」。
  - 该敲字代令系统有着比较丰富自由的可订制性，可以允许使用者自订一些威注音输入法不方便直接内建的功能、以满足各自的私下需求。
    - 打比方说没准哪天日本天皇又驾崩了、导致日本历法又进入了新的纪年，但作业系统对新的纪年的支援往往要晚几周甚至几个月、对作业系统版本也有要求。此时就可以用代令系统自己动手丰衣足食。
    - 举例说你想用爱迪生发明钨丝灯泡的那一年（1879 年）来纪年的话，往使用者语汇档案里面插入「`MACRO@DATE_YEARDELTA:-1879 ㄞˋ-ㄉㄧˊ-ㄕㄥ-ㄐㄧˋ-ㄋㄧㄢˊ -114.514`」这一行就可以了。因为用到了「-114.514」这个惩戒权重，所以这个敲字代令不会干扰到组字引擎的正常组字。
    - 更多敲字代令范例可参见这一版威注音的**主流发行版**的原始码仓库当中的「InputTokenTests.swift」档案。
- 行为：[所有发行版] 新增对 CIN2 v2.4 标准的支援：`%keys_to_directly_commit` 用来让输入法故意放弃对被该行参数值包括的字元对应的按键讯息的「标点符号/字母」输入处理。这可以用来略过输入法本身对某些按键内建的原厂标点符号资料定义。
- 行为：[所有发行版] 不再在「系统桌面锁定」或「萤幕保护程式正在运行」时侦测 `com.apple.loginwindow` 对 SecureEventInput 的滥用行为存否，因为这种情况下一定不是在滥用。如果仍有与该执行绪有关的 SecureEventInput 滥用警告出现、且**确实有妨碍到您对威注音等第三方输入法的正常使用**的话，请洽 Apple Support，因为这种情况下很可能是 macOS 的软体功能缺陷。
- 研发：[所有发行版] 取消了对 Xcode 15 专案建置过程当中的 Build-Script Sandboxing 的支援，因为该特性会妨碍原厂辞典脚本的正常工作（SQLite Segmentation Fault）。该修改不会影响最终建置出来的软体的行为。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.7.0-signed.pkg
1cc259842b136c7854e554869b77c9defbb73c1aac6c33f09c80794747fecec8

vChewing-macOS-3.7.0-signed-alternative.zip
6282acd10f2f73519ec83f2a89de38a1f3b2fd9af6811439c20eac9a0e43caf1

最后提交信息为： [VersionUp] 3.7.0 GM Build 3700.

3.6.3

70a1b78

2023-12-02 16:36

3.6.3 SP1

#### 3.6.3 版针对 3.6.2 版更新了下述内容：

- [SP1] 修正：[所有发行版] 修复了 SwiftUI 偏好设定视窗在某些情况下“不显示全页卷动条”的行为异常。
- [SP1] 修正：[所有发行版] 修复了令磁带模式无法正常工作的一处故障。
- [SP1] 修正：[所有发行版] 修复了辞典编译脚本在 Xcode 14.2 当中可能会出现的 SQLite Segmentation Fault 故障。
- 修正：[所有发行版] 重新统整了与 Sandbox URL Bookmark 有关的 API 的使用方法。这在理论上应该能够解决在某些使用者的电脑上在旧版系统下「记不住使用者自订语汇目录位置」「记不住磁带模组档案位置」的故障。如果仍有遇到相关问题者，欢迎提报故障。
- 修正：[所有发行版] 天权星组字引擎升级到 v2.7.2，增补了一处防呆设计。
- 修正：[所有发行版] 修正了输入法偏好设定内与「尽量使用外置原厂辞典档案」有关的一处开关逻辑判断错误。
- 修正：[所有发行版] 修正了步天歌繁简转换引擎的一处与 SQLite API 用法有关的记忆体泄漏故障。该引擎主要用于使用者就地加词删词功能、以及磁带模式的繁简转换。
- 体验：[所有发行版] 允许使用终端机将当前输入法偏好设定的绝大多数内容倾印成一份备份档案。该备份档案的实质是 Shell 脚本、需要在终端机内使用 pipeline 语句来指定写到哪个新档案当中（否则只会在终端机萤幕上显示一遍脚本内容）。只需要将该脚本直接在终端机内运行、就可以将该档案内的输入法偏好设定恢复到电脑当中。需要注意的事项有：
  1. 命令用法参考范例：`~/Library/Input\ Methods/vChewing.app/Contents/MacOS/vChewing --dump-prefs > ~/Downloads/vChewingPrefBackup.sh`
  2. 任何涉及到档案路径的偏好设定内容均不在备份范围内，因为会有 Sandbox 资料位置存取相容问题。因为 Sandbox 机制的存在，威注音输入法在存取一个手动指定的目录时必须由使用者借由图形介面亲自点开这个资料夹/档案才可以（将档案拽入到路径控制项内也可以，因为也是使用者亲自在图形介面操作）。
  3. 该功能的设计交互特性决定了该功能不适合用来制作图形介面版本。如果您希望将这个备份恢复过程自动化的话，您或许可以借助其他的辅助工具（比如 crontab）搭配您自己写的其它 Shell 脚本工具来一同使用。
  4. 如果您用的威注音输入法是您自己组译建置的版本的话，请签名，否则该命令可能会用 NSLog 的形式抱怨说签名资料不存在。这并不影响倾印过程。
- 行为：[所有发行版] 修正了在当前系统偏好设定已经手动统一锁定过强调色的情况下「输入法仍旧优先读取客体软体的强调色」的行为错误。现在起，除非当前系统偏好设定的强调色已经设定为出场预设值（该预设值在 macOS 11 开始是「多色」），否则输入法不会读取客体软体自身的强调色。
- 研发：[所有发行版] 全专案重新检讨了 SQLite Statement Pointer 的使用方法，且改用了更安全的使用方法来使用相关的 SQLite API。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.6.3-signed.pkg
416a0e70f8618e24c3148654eafcb5998e785de276f2913e87f58b692a62b743

vChewing-macOS-3.6.3-signed-alternative.zip
b88e69fd6b1410edad1f7a84469a7b115b39335df8eb577b44939eb7d9dfa0ce

最后提交信息为： [VersionUp] 3.6.3 SP1 Build 3631.

3.6.2

de1272f

2023-11-30 00:14

3.6.2

#### 3.6.2 版针对 3.6.1 版更新了下述内容：

- 修正：[所有发行版] 修复了田所选字窗的多行/多列模式在「当前选字窗的候选字资料池的内容不足一页」的情况下「无法一次性将当前页面的内容全部显示完毕」的后端资料池处理故障。
- 修正：[主流发行版] 修复了「关于」视窗的「确定」按钮无法关闭该视窗的故障。
- 修正：[Aqua 纪念版] 为了因应偏好设定视窗在 macOS 10.9 Mavericks 下卷动视窗内容时「会崩掉 WindowServer」的故障，本次更新对 Cocoa 版偏好设定视窗的排版机制做了调整：对「行为设定」页签取消了「视窗内容可卷动」的设计，转而采用威注音 1.2 版时使用的多页签模式、将该总页内容拆成两个子页签来显示。这样可以成功绕过该故障（可以视为 macOS 10.9 的系统固有缺陷）。
- 修正：[所有发行版] 修复了 App 版安装程式在安装成功之后的提示文字的本地化翻译失误。
- 修正：[主流发行版] 修复了 App 版安装程式的一些 SwiftUI 美工缺陷。
- 体验：[所有发行版] **因应 Apple 在 MacBook Pro 产品线对 8GB 运行记忆体的病态执着，威注音输入法全专案针对原厂辞典改采 SQLite 资料库、将记忆体占用从原先的约 120MB 锐减至大约 30MB 以内。** 
  - 这样可以尽量避免一些因 Apple Silicon 机种休眠或「将硬碟当作记忆体空间使用」等特性而导致的输入法随机故障。这些故障都是在 Intel Mac 电脑上打死都无法重现的。
  - 与记忆体占用统计有关的特别说明：
    - 1. 如果有开过偏好设定等视窗的话，相关视窗物件的记忆体回收行为不可控，故此时的记忆体占用量约为 70MB 以内（以 SwiftUI 新版偏好设定视窗为准）。
    - 2. 使用者辞典以及 CIN 磁带资料的记忆体空间占用得另外计算。
- 体验：[所有发行版] 对田所选字窗在多栏纵向陈列模式下的「当前列」的背景色做了些许调整、使其与横向多行陈列模式时的「当前行」的背景色一致。
- 体验：[所有发行版] 预设情况下，选字窗的高亮候选字的背景色将会是客体应用自身的 accentColor、其次是系统的 accentColor。该特性不会在启用康熙文字转换模式或 JIS 日本简化字转换模式的时候生效（以便让使用者明白该模式被启用了）。使用者可借由输入法偏好设定关闭该特性。
- 体验：[所有发行版] 在借由输入法偏好设定启用侦错模式时，输入法选单顶端会显示「在您叫出选单的那一刻」输入法的记忆体占用量。
- 行为：[所有发行版] 因为 SQLite 格式的原厂词库不再需要将原厂辞典内容实时放在记忆体内，故修改了威注音输入法的记忆体最大利用上限的安全阈值：从 768MB 下调至 384MB，仍可应对极个别使用者对自订辞典的空前容量需求。
  - 和之前的版本一样，威注音输入法会在每次 activateServer() 的时候检查自身的记忆体占用情况，且在占用量超过这个阈值时自尽、自动重新启动输入法、以释放记忆体空间。
- 辞典：[所有发行版] 例行语汇资料更新＋原神/星穹铁道语料更新，另更新全字库资料（2023 年 11 月 06 日的版本）。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
5. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
6. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
7.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
8. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

- 本次提供的安装档案均已做公证处理。
- 如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.6.2-signed.pkg
b41caf6b18811893720e46b8aeb60b6e1ae2cabc333335e4e356f59ba6e565bb

vChewing-macOS-3.6.2-signed-alternative.zip
b6f676fef8bd741ab8e4be8f091404e77dbefde141df31456e5e7814c2ec3589

最后提交信息为： [VersionUp] 3.6.2 GM Build 3620.

3.6.1

d2f4fe6

2023-10-29 01:41

3.6.1 SP2

#### 3.6.1 版针对 3.6.0 版更新了下述内容：

- 修正：[SP2][所有发行版] 解决了 SP1 不慎引入的与 Caps Lock 状态判定有关的 IOReg API 使用不规范之处，不会再造成 IOSystemService 的无尽占用。
- 修正：[SP2][主流发行版] 解决了「偏好设定->语汇编辑」画面当中的「…」按钮「无法正常开启 Finder」的故障。
- 体验：[SP2][所有发行版] 在「偏好设定->辞典设定」页面的右下角新增了「汇入奇摩输入法自订词资料库」的按钮、可以直接读入由雅虎奇摩输入法汇出的 TXT 格式的自订词资料库。该功能不会汇入当前输入法内已有的词语。
- 修正：[SP1][所有发行版] 解决了 CapsLock 开关提示在 macOS 14 系统下「始终显示中文状态ON」的故障。
- 修正：[SP1][所有发行版] 撤销了一处对 CodeRunner 的相容性设计，以解决在 JetBrains IDE 下无法递交文字的故障。
- 修正：[主流发行版] 解决了 PKG 版安装包在某些电脑上会在开始安装时报称「安装失败」的故障。
- 体验：[所有发行版] 在「偏好设定->行为设定」当中新增了一个选项：允许使用者在打字时让输入法忽略掉威注音内建的 Caps Lock 处理。该特性用来照顾那些早已习惯微软新注音的行为策略的使用者们。如果您开启了这个特性的话，则 CapsLock 键在被点灭的时候是无论如何都不会弹出威注音的飘窗通知的。
- 体验：[所有发行版] 在「偏好设定->行为设定」当中新增了一个选项，同时允许两件事情：一、CapsLock 灭灯时连带关闭以「Shift 键 / JIS 英数键」控制的英数输入模式（要求至少 macOS 12）；二、在借由「JIS 英数键」关闭其所控制的英数输入模式时，CapsLock 自动灭灯。注：CapsLock 亮灯的时候，威注音输入法无法判断 Shift 键的单次敲击行为。
- 体验：[所有发行版] 田所选字窗现改用对眼睛略微温和的视窗背景色彩。
- 体验：[所有发行版] 波浪符号选单现新增「部首」分类，按笔画数量做了细分。
- 体验：[主流发行版] SwiftUI 版偏好设定画面的语汇编辑器的卷动条的显示行为做了一些小调整。
- 体验：[Aqua 纪念版] 的偏好设定画面的「行为设定」页面现支援卷动特性、以应对其日益变长的内容显示篇幅。这样对采 1024x768 外接显示器的电脑而言会更友善一些。
- 体验：[所有发行版] 输入法通知飘窗的位置做了一些小调整、使之不再遮挡 macOS 自身弹出的系统通知。这也可以让使用者不再误以为「有讯息来了」。
- 行为：[所有发行版] 有鉴于这十几年来 macOS 平台经常出现「某些应用在后台滥用 SecureEventInput API、导致系统内所有第三方输入法全部罢工」的情况，威注音引入了一套新的后台自动扫描机制（每六十秒一次扫描，会在电脑休眠时暂停扫描）、自动检查是否有这样的害虫执行绪。当发现有这种执行绪的时候，威注音会自动弹出视窗告知使用者「就是这个执行绪害得所有第三方输入法在输入法选单内灰掉用不了」。因为威注音有做过沙箱处理（最好的谣言粉碎机），所以不能替您结束这种害虫执行绪、只能由您自己借由活动监视器（Activity Monitor）或终端机手动结束之。该扫描特性可在「偏好设定->开发道场」内停用。
- 行为：[所有发行版] 威注音现照顾逐字选字模式使用者几十年来的肌肉记忆习惯、内建了倚天中文 DOS 环境下的ㄅ半注音的候选字顺序资料。任何不受倚天中文 DOS 环境支援的候选字都会排在之后的页数。该特性仅影响威注音的逐字选字模式。
- 行为：[所有发行版] 在除了 BBEdit / TextWrangler 以外的 App 当中递交文本之前，威注音输入法现在会先移除内文组字区的显示内容。
- 研发：[主流发行版] 的系统最低需求提升至 macOS 12 Monterey。在比这个更旧的系统内安装的主流发行版本会被更新提示引导至 [Aqua 纪念版] 的下载页面（支援 macOS 10.9 Mavericks 至 macOS 12 Monterey）。// 注：之所以保留了主流发行版对 macOS 12 的支援，是因为不想妨碍到借由 Homebrew 途径安装威注音的使用者们（Homebrew 仍在支援 macOS 12，直至 2024 年底为止）。
- 研发：[主流发行版] 的 App 版安装程式改采 SwiftUI 彻底重写。该重写不影响 Aqua 纪念版的 App 版安装程式。
- 研发：[主流发行版] 的「关于」视窗改采 SwiftUI 彻底重写。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. Steam 等对 IMKTextInput 协定没有认真遵守的应用当中，选字窗与浮动组字窗的位置可能不受输入法控制。此问题无解，因为只有客体软体厂商才能解决这种问题、但他们又不想解决这种问题。
5. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
6. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
7. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
8.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
9. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
10. 如果在使用早期版本的腾讯 QQNT、且在讯息视窗内就地加词/删词/控频的时候出现「组字区内容擅自被递交到组字区的前后端」的混乱情况的话，请在输入法选单「管理客体应用…」视窗内将「`com.tencent.qq`」填入、以改用浮动组字窗取而代之。受此故障影响的输入法不只威注音这一款。幸运的是，腾讯的 QQNT 团队目前已经将该故障解决，请升级至至少 v6.9.12 公开正式版。
</details>

------

系统版本要求：至少 macOS 12 Monterey。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。如需要在更旧版的系统下运行的话，请前往[威注音输入法主页](https://vchewing.github.io/README.html)下载 Aqua 纪念版威注音输入法，可支援自 macOS 10.9 开始至 macOS 12 Monterey 为止的系统版本。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

> 本次提供的安装档案均已做公证处理。如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.6.1-signed.pkg
3c9a4d56024830b6023ae6449e5075e8f895c14cc720184b294503491c2fe8c8

vChewing-macOS-3.6.1-signed-alternative.zip
c282f284cb78f02558c03030fcd4993e43f8b2d954141977c64e73280523db8d

最后提交信息为： [VersionUp] 3.6.1 SP2 Build 3612.

3.6.0

bc94bb8

2023-09-28 21:02

3.6.0

#### 3.6.0 版针对 3.5.5 版更新了下述内容：

- 修正：解决了输入法内部所有「全形文字没有以占据全形宽度的方式来显示」的故障（之前漏掉了田所选字窗）。该故障是 macOS 14.0 所引入的，但不见得一定会得到解决（因为是 Apple 故意的设计、但实作很烂），所以 App 开发者们只能给每一处 NSAttributeString 都手动加注「.kern = 0」。
- 修正：解决了在某些情况下「直接敲入的英文字符会被随后敲入的空格置换掉」的故障。解决方式就是彻底删掉「TISDoubleSpaceSubstitution」这个 plist 属性本身。
- 修正：解决了横版浮动组字窗内的排版格式失误的故障。该故障由前一个版本不慎引入。
- 修正：修复了一处与 `TISCreateInputSourceList` 有关的（理论上的）记忆体位置存取行为管理失误。
- 体验：在输入法偏好设定内新增了一个功能选项（目前暂时放在「开发道场」页面），名曰「强化型组字区安全防护」，允许对「所有的用来接收文字输入的客体软体」一律启用浮动组字窗。这可以彻底杜绝任何客体 App 「擅自读取内文组字区来用」的可能。欲知详情者，请洽「纯靠北工程师7ci」。
- 体验：针对 macOS 12 Montery 为止的 macOS 系统取消了 SwiftUI 版偏好设定视窗的支援。因应此项变化，本次更新专门给 Cocoa 版偏好设定视窗新增了一些「只能在 macOS 10.15 开始的系统才可能会用到」的选项。
- 体验：针对 macOS 13 开始的系统重新设计了 SwiftUI 版的偏好设定视窗。
- 体验：移除了屎绿色的应用程式偏好设定画面主题配色。该配色现完全听从作业系统的安排。
- 行为：延伸了 Aqua 纪念版的系统支援范围。该纪念版现在支援 macOS 10.9 Mavericks 至 macOS 12 Monterey、且只能用 Xcode 14 建置（推荐 Xcode 14.2）。如果用 Xcode 15.0 建置的话，哪怕用了旧版系统的 SDK，也会在 macOS 10.9 系统下在处理某些 TISInputSource 有关的 CoreFoundation 物件时出现记忆体释放行为失控之错误。
- 行为：从这一版开始，威注音不会再在系统登入介面执行软体新版检查。
- 行为：从这一版开始，在不足 macOS 13 的系统当中，输入法检查更新时会优先检查 Aqua 纪念版的更新。
- 研发：现暂时移除田所选字窗的 SwiftUI 支援。等过几年真的再需要用 SwiftUI 重做的话，届时应该能写得更好。
- 研发：主流发行版与 Aqua 纪念版都针对 Xcode 14.2 做了调整、使得专案本身可以正常建置。
- 研发：主流发行版的 Xcode 专案针对 Xcode 15 的「建置时脚本沙箱」特性做了相容性调整。
- 研发：全专案移除对 (Sindresorhus) Preferences 以及 (ShapsBenkau) SwiftUIBackports 的依赖。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. Steam 等对 IMKTextInput 协定没有认真遵守的应用当中，选字窗与浮动组字窗的位置可能不受输入法控制。此问题无解，因为只有客体软体厂商才能解决这种问题、但他们又不想解决这种问题。
5. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
6. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
7. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
8.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
9. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
10. 如果在使用早期版本的腾讯 QQNT、且在讯息视窗内就地加词/删词/控频的时候出现「组字区内容擅自被递交到组字区的前后端」的混乱情况的话，请在输入法选单「管理客体应用…」视窗内将「`com.tencent.qq`」填入、以改用浮动组字窗取而代之。受此故障影响的输入法不只威注音这一款。幸运的是，腾讯的 QQNT 团队目前已经将该故障解决，请升级至至少 v6.9.12 公开正式版。
</details>

------

系统版本要求：至少 macOS 10.13.4 High Sierra。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

> 本次提供的安装档案均已做公证处理。如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.6.0-signed.pkg
dbddbaa89336695778de9c33833e47d00759a96f6dc078e83af03e0a6484b014

vChewing-macOS-3.6.0-signed-alternative.zip
61fa1ea79447a4d91a22fd3c729557ebaef987a1bbb13e14a5e38a125f224ba1

最后提交信息为： [VersionUp] 3.6.0 GM Build 3600.

3.5.5

d7d6a58

2023-09-15 21:18

3.5.5

#### 3.5.5 版针对 3.5.4 版更新了下述内容：

- 修正：修复了因为 macOS 14 Dev Beta 7 的 `NSAttributedString.Key.kern` 特性选项的预设值「非零」所导致的工具提示视窗排版故障。从这一版开始，由输入法手动将该特性选项强制设为 0。
- 修正：修复了两处与 UserDefaults Plist 键值名称有关的拼写错误。因此，在各位升级输入法之后，请根据各自的需求来重新设定这几个选项：「以固定顺序来陈列选字窗内的候选字」、「允许使用右侧的 Shift 键切换英数输入模式」。
- 修正：在新增使用者语汇（或者控频）的时候，不会再在漂白相关的半衰记忆资料时将当前输入法繁简模式对应的各自的半衰记忆模组搞错。
- 修正：修改了 Shift 中英文切换功能所用的 Shift 按键判定机制。现在起，该判定模组会要求前后两个 NSEvent 彼此的 KeyCode 雷同。这会在某些个别使用者的电脑上借由「Shift+方向键」等按键组合时、防止对该中英切换开关的误触。
- 体验：磁带模组做了升级，现在会在磁带内有定义 `%quick` 但尚未查询到手动给定的简码资料时自动生成简码资料。这些自动生成的资料的字根是「仅需以给定的检索内容开头」还是「与给定的检索内容完全匹配」，则与磁带内是否有 `%flag_disp_partial_match` 有关。举例说行列输入法的使用者群体所习惯的情况是前者，那就不要在行列输入法的磁带档案内出现 `%flag_disp_partial_match` 这一行。
- 体验：考虑到很多使用者对 3.5.2 版前后引入的「选字窗位置反应当前候选字词的长度」的特性不适应，所以给这个功能特性新增了开关。
- 体验：考虑到很多使用者对 3.5.3 版引入的「多行选字窗在预设情况下、会折叠得只显示一行」的特性不适应，所以给这个功能特性新增了开关。一旦关闭的话，田所选字窗的多行选字窗将始终展页显示。
- 行为：在使用者就地加词、删词、控频时，输入法不再强制给被修改的档案整理格式、而是仅会修复可能缺失的 EOF 标记。
- 行为：在试图就地新增使用者语汇时，输入法会先检查该词音配对是否已被登记到词汇滤除表当中。仅当发现没被列入（过滤掉）时，才会新增使用者语汇（或升频）；如果有被列入（过滤掉）的话，则会先「仅」将该词音配对从词汇滤除表删除。标记模式当中的工具提示也做了对应的调整。
- 行为：在就地加词、删词、控频的时候，不会在完成任务之后同时重新载入使用者辞典档案和语汇排除表档案，而是按需决定要重新读取的资料。
- 行为：输入法记忆体占用封印上限由 512MB 改为 768MB，方便某些极个别人群对巨型使用者辞典档案的需求。超过这个封印上限的话，输入法会自动重新启动。
- 研发：全专案将 `[self] in` 置换成 `[weak self] in`，将这一类记忆体泄漏的可能性掐死在摇篮当中。
- 研发：优化了对使用者语汇档案的 EOF 标记的检查与修复方法，使之不再需要载入整个档案便可完成任务。
- 研发：修复了一处专案配置失误。现在起，在建置/封存专案的时候，会生成 dSYM 档案。
- 研发：如果两次 setMarkedText() 先后设定的内容雷同的话，则第二次 setMarkedText() 会被跳过执行。此举是为了尝试缓解该输入法在 Final Cut Pro X 当中编辑字幕时的体验，因为 FCPX 无法在编辑字幕的时候忽略掉内文组字区内的内容。
- 研发：调整了一处与中英文输入模式有关的判定、将其从 SessionCtl 挪到 InputHandler 当中，但愿此举能够避免威注音在某些个别的客体软体内的中英文输入模式切换异常。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. Steam 等对 IMKTextInput 协定没有认真遵守的应用当中，选字窗与浮动组字窗的位置可能不受输入法控制。此问题无解，因为只有客体软体厂商才能解决这种问题、但他们又不想解决这种问题。
5. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
6. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
7. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
8.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
9. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
10. 如果在使用早期版本的腾讯 QQNT、且在讯息视窗内就地加词/删词/控频的时候出现「组字区内容擅自被递交到组字区的前后端」的混乱情况的话，请在输入法选单「管理客体应用…」视窗内将「`com.tencent.qq`」填入、以改用浮动组字窗取而代之。受此故障影响的输入法不只威注音这一款。幸运的是，腾讯的 QQNT 团队目前已经将该故障解决，请升级至至少 v6.9.12 公开正式版。
</details>

------

系统版本要求：至少 macOS 10.13.4 High Sierra。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

> 本次提供的安装档案均已做公证处理。如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.5.5-signed.pkg
ee8d3378aeca28a69c05a8d63e6117b16191fbe20c5072a08325e207d9d95672

vChewing-macOS-3.5.5-signed-alternative.zip
b683e060b9e86b2e4e208f3f49264ff58b3f849a842b1af09a375ff2e6170471

最后提交信息为： [VersionUp] 3.5.5 GM Build 3505.

3.5.4

2e94128

2023-08-29 15:02

3.5.4

#### 3.5.4 版针对 3.5.3 版更新了下述内容：

- 修正：解决了一个与 macOS 14 Sonoma 有关的恶性相容性故障：如果使用者辞典目录或磁带档案在 iCloud Drive 里面的话，在系统刚升级到 macOS 14 之后，威注音输入法在使用时会触发 GateKeeper 机制、系统会询问使用者「是否允许威注音存取受 iCloud Drive 管理的档案」。本次更新会解决输入法在出现这个画面时的「系统整个画面操作失去响应长达几十秒」的故障。该故障乃威注音输入法的 GCD 设计不慎触发 macOS 一处设计缺陷所使然。从这一版开始，威注音不会再在这种情况下触发该系统缺陷。
- 修正：解决了半衰记忆模组在排除过期记忆（或溢出掉最旧的记忆资料）时的崩溃故障。
- 修正：解决了半衰记忆模组在某些情况下「无法生成正确的三元图检索用字串」的故障。打比方：当你敲「东京都前任知识」且借由选字窗将「知识」改选成「知事」的话，此时生成的记忆资料会且「仅会」在这个词的后方是「东京都前任」的时候才会生效。此时「东京都」「前任」「知事」正好组成三元图（Trigram）记忆。
- 修正：解决了可能会因为「将 NSEvent 放入 Set 集合」而导致的输入法崩溃故障。现已取消此类行为设计。
- 修正：解决了在区位内码输入模式下无法正确处理方向键事件的故障。
- 修正：解决了输入法在某些情况下会让某个控制会话「卡死在汉音键盘符号模式」的故障。
- 修正：针对「汉音键盘符号模式」与「区位内码输入模式」解决了「某些有处理过的功能按键操作会被漏给客户端」的故障。
- 体验：田所选字窗新增展页功能。当您启用了田所选字窗的多行/多列功能时，田所选字窗在刚刚叫出来的时候会以单行/单列显示，直到您触发翻页/翻行行为的时候才会展开页面为多行/多列显示。这使得田所选字窗在这方面的行为上与微软新注音输入法和 macOS 内建注音输入法几乎一致。
- 行为：因应威注音输入法的技术发展需求等原因，威注音输入法从这一版开始移除了对 IMK 选字窗的支援。详情请洽输入法偏好设定内的「IMK 选字窗去哪里了？」按钮。
- 行为：从现在起，当启用语汇置换模式时，在将当前组字区的内容递交出去的时候，当且仅当目前的内文组字区刚好是可取代对象的话，则整个递交出去的内容都会被置换掉。// 这个特性的触发条件必须是「当且仅当」，不然会导致严重的效能问题：组字区越长，效能问题越严重，转换结果也就越容易不可控。
- 研发：将输入法主程式专案的一些主要功能模组统一塞入一个单独的 Swift Package 内进行管理、谓之「输入法主体总成模组」。这包括但不限于：输入法控制会话模组、输入法应用程式代理模组（AppDelegate）、语言模型管理模组、按键输入调度模组、有限态械模组，等。利用 Swift Package 的特性，威注音输入法本身迎来了睽违超过一年多的单元测试（被写在了输入法主体总成模组内），且单元测试本身所使用的 UserDefaults 与威注音输入法运行时的 UserDefaults 彼此隔离、不受影响。目前的单元测试范围不算广泛，但会随着将来由使用者群体提报的故障来扩大测试范围。
- 研发：对整个输入法按键事件控制流程的修饰标记判定做了精简，仅会处理经过 .deviceIndependentFlagsMask 筛过的修饰标记集合。
- 研发：改用 KVO 来通知使用者偏好设定画面「是时候重新载入资料了」。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. 出于诸多原因，macOS 系统内建的 IMK 选字窗支援截止于 3.5.3 版、之后不再提供相关支援。一款连 Apple 自己都不想做好的系统元件，第三方用起来维护成本实在太空前。
3. 田所选字窗不支援滚动条卷动，但理论上应该不会影响使用。
4. Steam 等对 IMKTextInput 协定没有认真遵守的应用当中，选字窗与浮动组字窗的位置可能不受输入法控制。此问题无解，因为只有客体软体厂商才能解决这种问题、但他们又不想解决这种问题。
5. 如果您在使用 macOS 14 Sonoma 及之后的版本的话，请勿使用威注音 3.5.3 及之前的版本，因为这些版本可能会触发系统内的某些缺陷、导致整个系统画面失去响应。
6. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
7. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
8.  威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
9. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
10. 如果在使用早期版本的腾讯 QQNT、且在讯息视窗内就地加词/删词/控频的时候出现「组字区内容擅自被递交到组字区的前后端」的混乱情况的话，请在输入法选单「管理客体应用…」视窗内将「`com.tencent.qq`」填入、以改用浮动组字窗取而代之。受此故障影响的输入法不只威注音这一款。幸运的是，腾讯的 QQNT 团队目前已经将该故障解决，请升级至至少 v6.9.12 公开正式版。
</details>

------

系统版本要求：至少 macOS 10.13.4 High Sierra。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

> 本次提供的安装档案均已做公证处理。如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.5.4-signed.pkg
1e1736e6a185c0bb8f3e5220c3eee35181fed40e84d33c428bb7700bc797a642

vChewing-macOS-3.5.4-signed-alternative.zip
76497d509d989b10a365d132880bbc31e904aabb839f700f65735d84d4bf0df6

最后提交信息为： [VersionUp] 3.5.4 GM Build 3504.

3.5.3

660d79b

2023-07-30 14:15

3.5.3

#### 3.5.3 版针对 3.5.2 版更新了下述内容：

- 修正：田所选字窗 Cocoa 版利用 CoreGraphics 彻底重写，彻底解决了在 Intel Mac 电脑上的两个故障：
  1. 修正了因介面渲染低效导致的操作迟钝故障。该迟钝故障在 Apple Silicon 机种内极难察觉，但在 Intel Mac 电脑上的使用体验只能用地狱来形容。
  2. 无论 CPU 种类，之前的 Cocoa 版田所选字窗都有记忆体利用过多的故障（虽然不至于泄漏），也在这次重写更新当中得到了修正。毕竟，之前是给每个候选字词都初期化一个用 Swift 做过 SubClass 处理的特制 NSTextField，加上 NSStackView，一页（四行的）画面平均使用的 NSView 的数量恐超过三十；而现在只需要一个 NSView 采 CoreGraphics 绘制介面。因为没有用到 CoreAnimation Layer，所以：哪怕在 VMWare 虚拟机内无法正常使用显示卡驱动加速，也不会有介面绘制上的瑕疵。自然也就允许田所选字窗在所有版本的 macOS 当中的美术风格统一（SwiftUI 版的美术设计则另论）。
  - 注：由于类似的操作迟钝故障也出现在 SwiftUI 版的田所选字窗内（恐与 CPU 指令优化有关），所以威注音输入法不建议 Intel Mac 的使用者启用 SwiftUI 版田所选字窗。
- 体验：输入法偏好设定的「使用者辞典档案目录」以及「磁带档案目录」的自订用「…」按钮迎来一处新调整：当您摁住 Option 键再点这个按钮的时候，会直接以 Finder 开启该路径。
- 体验：将主流发行版特有的「修改使用者辞典档案目录」以及「磁带模式」功能下放给威注音输入法 Aqua 纪念版（v0.5.25）。
  - 技术层面说明：macOS 10.13 之前的版本的系统会在输入法自身呼叫 NSOpenPanel 的时候令自身与客体应用陷入无限停止响应的状态。更甚者，此时任何尝试切换到的其他客体应用也会陷入同样的状态。除了强制断电重新开机以外，就只能借由远端 SSH 连到目前的电脑上、以终端命令强行终止输入法执行绪。因此，威注音输入法不能对 macOS 10.12 及之前的系统开放对 NSOpenPanel 的存取。这也是这两个重磅级功能从威注音问世以来便长期缺席于这几版 macOS 的原因。好在目前终于找到了替代解决方案：让使用者从 Finder 将输入法辞典目录/磁带档案直接拽入输入法偏好设定内的 NSPathControl 路径控制项当中。
- 行为：从该版开始，威注音会正确处理 KeyUp 事件，且会刻意忽略一些以 .command 触发的热键（包括剪贴簿热键）。
- 行为：从该版开始，就地轮替候选字词时，轮替顺序与选字窗内的候选字词陈列顺序完全一致。
- 行为：从该版开始，输入法偏好设定视窗的标题列、以及输入法关于视窗内都会显示您当前安装的威注音输入法的签名日期时间戳。这有助于参与 beta 测试的人们弄清楚自己安装的是哪个版本。
- 行为：在某些极端个例当中，使用者半衰记忆模组的记忆档案可能会出现故障、导致输入法崩溃。从这一版开始，输入法在侦测到这种崩溃时，不再直接移除这类有问题的记忆档案，而是直接对这些档案做更名留档处理、以便今后的进阶侦错之需。
- 研发：简化了对 CFDictionary 的一些处理。
- 研发：将主流发行版当中的 App Sandbox 档案路径书签管理模组向下移植给 Aqua 纪念版。
- 研发：优化了对 NSAttributedString 的 BoundingDimension 的计算方法，且缩减了这个计算方法在整个输入法专案内的使用场合。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. macOS 系统内建的 IMK 选字窗无法自订选字键、无法根据输入法所处的简体/繁体模式自动切换对应的「选字窗字型」及「高亮候选字背景配色」。这两个问题受限于 IMK 选字窗本身的特性，均无解。
3. 田所选字窗尚未支援单页卷动之特性。如果想使用有支援滑鼠单页卷动的选字窗的话，请在输入法偏好设定内的开发道场内启用 IMK 选字窗。
4. IMK 选字窗在 macOS 10.14 Mojave 系统下只能使用横排矩阵选字窗、且无法使用 PageUp / PageDn 键。该问题是 macOS 10.14 内建 InputMethodKit 模组的 Bug，无解。另外，IMK 选字窗也无法支援那些只有田所选字窗才支援的一些特性（比如借由滑鼠右键选单对候选字词控频/排除，等）。
5. Steam 等对 IMKTextInput 协定没有认真遵守的应用当中，选字窗与浮动组字窗的位置可能不受输入法控制。此问题无解，因为只有客体软体厂商才能解决这种问题、但他们又不想解决这种问题。
6. 在刚刚切换到某个 App 就呼叫波浪键符号选字窗时，IMK 选字窗可能会突然闪一下。该问题因 IMK 框架的设计特性而无解。能在这种情况下保持选字窗正常显示、已经是威注音最大的努力。
7. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
8. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
9. 威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
10. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
11. 如果在使用早期版本的腾讯 QQNT、且在讯息视窗内就地加词/删词/控频的时候出现「组字区内容擅自被递交到组字区的前后端」的混乱情况的话，请在输入法选单「管理客体应用…」视窗内将「`com.tencent.qq`」填入、以改用浮动组字窗取而代之。受此故障影响的输入法不只威注音这一款。幸运的是，腾讯的 QQNT 团队目前已经将该故障解决，请升级至至少 v6.9.12 公开正式版。
</details>

------

系统版本要求：至少 macOS 10.13.4 High Sierra。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

> 本次提供的安装档案均已做公证处理。如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.5.3-signed.pkg
ab40df8542af7d70bfec5f417511e3f04c36a0929d0a3359eb8413828050de6c

vChewing-macOS-3.5.3-signed-alternative.zip
d9e076145d581b0b44a2a834a413c22da27bdeb129d1e06358dc2d8d9ad93c39

最后提交信息为： [VersionUp] 3.5.3 GM Build 3503.

3.5.2

2ac58f7

2023-06-29 22:19

3.5.2

#### 3.5.2 版针对 3.5.1 版更新了下述内容：

- 修正：订正了输入法偏好设定当中与 IMK 选字窗有关的错误描述。
- 修正：解决了近期改用 JSON 辞典资料格式时对逐字选字模式自订档案（plist）支援失效的故障。
- 修正：解决了选字窗的位置在某些情况下会乱跳的故障。
- 体验：更换了选字模式下的内文组字区下划线格式，使其显示逻辑类似于 macOS 内建的日语输入法。
- 体验：从现在起，借由「纵向布局的 IMK 选字窗」使用磁带模式的简码选字时，简码候选字会以闪电标记开头、以提醒使用者「目前可以使用简码候选字」。
- 行为：从现在起，当且仅当一个 CIN2 磁带的花牌键「不是字母键」的场合，才可以单独敲出这个符号。对此限制感到困扰的话，可以在每次输入符号时（用热键）关掉磁带模式来输入。
- 行为：如果当前载入的 CIN 磁带档案包含单独的「`%quick`」或「`%flag_disp_partial_match`」行、且该磁带档案尚未实装「`%quick begin`…`%quick end`」章节的话，输入法会自动让磁带模组找出前六十个候选字（单个汉字）作为简码候选字。
- 研发：弃用 Xcode 15 Beta 建置手段，因为测试版的 Toolchain 可能会导致 SIGTRAP / SIGILL 错误。本次版本使用 Xcode 14.3 建置。
- 研发：给输入法的 info.plist 新增了 `TISIconLabels` 参数。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. macOS 系统内建的 IMK 选字窗无法自订选字键、无法根据输入法所处的简体/繁体模式自动切换对应的「选字窗字型」及「高亮候选字背景配色」。这两个问题受限于 IMK 选字窗本身的特性，均无解。
3. 田所选字窗尚未支援单页卷动之特性。如果想使用有支援滑鼠单页卷动的选字窗的话，请在输入法偏好设定内的开发道场内启用 IMK 选字窗。
4. IMK 选字窗在 macOS 10.14 Mojave 系统下只能使用横排矩阵选字窗、且无法使用 PageUp / PageDn 键。该问题是 macOS 10.14 内建 InputMethodKit 模组的 Bug，无解。另外，IMK 选字窗也无法支援那些只有田所选字窗才支援的一些特性（比如借由滑鼠右键选单对候选字词控频/排除，等）。
5. Steam 等对 IMKTextInput 协定没有认真遵守的应用当中，选字窗与浮动组字窗的位置可能不受输入法控制。此问题无解，因为只有客体软体厂商才能解决这种问题、但他们又不想解决这种问题。
6. 在刚刚切换到某个 App 就呼叫波浪键符号选字窗时，IMK 选字窗可能会突然闪一下。该问题因 IMK 框架的设计特性而无解。能在这种情况下保持选字窗正常显示、已经是威注音最大的努力。
7. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
8. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
9. 威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
10. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
11. 如果在使用早期版本的腾讯 QQNT、且在讯息视窗内就地加词/删词/控频的时候出现「组字区内容擅自被递交到组字区的前后端」的混乱情况的话，请在输入法选单「管理客体应用…」视窗内将「`com.tencent.qq`」填入、以改用浮动组字窗取而代之。受此故障影响的输入法不只威注音这一款。幸运的是，腾讯的 QQNT 团队目前已经将该故障解决，请升级至至少 v6.9.12 公开正式版。
</details>

------

系统版本要求：至少 macOS 10.13.4 High Sierra。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

> 本次提供的安装档案均已做公证处理。如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.5.2-signed.pkg
0e0ee3ac89ff41192d91b4538f2f2cb004230e0c2673e75eee93bdd1e1424875

vChewing-macOS-3.5.2-signed-alternative.zip
f3987087ba032e475b0142c708a5555c04224274e204807f1b94919866843f68

最后提交信息为： [VersionUp] 3.5.2 GM Build 3502.

3.5.1

43b3b43

2023-06-27 19:38

3.5.1

#### 3.5.1 版针对 3.5.0 版更新了下述内容：

- 修正：天权星引擎升级至 v2.7.1，修复了「在组字器内删掉最后一个读音的时候，因为 walkedNodes 没被清空的原因，导致内文组字区在某些功能模式下的内容显示失常」的故障。从现在起：当你在尝试用 Shift+BackSpace 析构掉组字区内唯一一个汉字的读音的时候，内文组字区将会正常显示这个汉字的去掉声调的读音、而不显示额外的不该显示的汉字内容残留。
- 修正：针对 BackSpace 键做了一系列功能补充升级改进，以应对磁带模式的简码选字功能的需求。从现在起，当你逐字删掉组笔区当中的某个最新输入的字根的时候，简码选字窗不会再消失，除非当前组笔区为空。
- 体验：从这一版开始，针对联想词模式的「Enter 键确认汉字」的开关的预设值被改为「关闭」。另新增 Shift+Enter 备用组合键、可以在联想词模式当中始终确认当前高亮的联想字词。
- 体验：在简码选字状态更新时，选字窗不再「仅根据组笔区内字根数量的多寡变化，来调整自身的视窗座标位置」。
- 体验：对整个输入法的 IMK 选字窗行为处理流程做了彻底重构。现在起，IMK 选字窗也支援 CIN2 磁带的简码选字特性。然而，因为 IMK 选字窗的固有缺陷与限制，威注音输入法的 IMK 选字窗在使用 CIN2 简码选字功能时，有下述限制（可能会挑战到行列输入法的传统使用者群体的既有习惯）：
  1. 简码选字键只有「123456789」且无法变更：用以自订 IMK 选字窗选字键的 API 全都是废掉的。
  2. IMK 选字窗不允许在单个候选字阵列内出现雷同重复的候选字词，否则会出现介面操作紊乱的情况（该特性倒是看上去完全符合常理就是了）。虽然有保守治疗方案，但这会导致简码选字窗无法一次性显示尽可能多的简码候选字。于是威注音输入法只得在 IMK 简码选字窗当中剔除掉所有的空码、且去除重复的简码候选字。这样改出来的体验对行列输入法的新手而言完全没问题，但却与行列输入法的传统使用者群体几十年来的肌肉记忆水火不容……他们比较适合使用威注音预设的田所选字窗，可以满足他们的习惯特性需求。
  3. IMK 选字窗的 Annotation 功能是空实作（也就是相关的 API 啥也不干），于是在原理上暂无可实现反查显示功能之手段（macOS 内建的五笔输入法倒是有反查特性就是了）。为了方便使用者区分「是不是简码选字模式」，在使用 IMK 选字窗的横版阵列布局的时候，简码选字窗会显示为横版单列布局。
  4. 与之前一样的是，因为 IMK 选字窗的 API 功能限制，在 macOS 10.13 High Sierra 系统下的 IMK 选字窗横版布局仅有单列布局可用（因为这一版系统内的 IMK 选字窗多列布局完全不支援选字键）。
  5. 注：笔者有将上文提到的某些个别故障专门在 WWDC 2023 找 Apple 的专员讨论过，但对方不是输入法组员、所知情报有限，只是传达意见说 Apple 输入法团队「现阶段无权给出任何答复」。
- 体验：新增了一个功能，允许在逐字选字模式下以空格键递交当前选字窗内被高亮选中的候选字。该功能预设启用，可能会挑战到威注音输入法旧版使用者们的行为偏好，届时可以借由输入法偏好设定来停用该功能特性。
- 体验：现在开始可以在磁带模式内借由花牌键敲出花牌键原始对应的字元；与「花牌键不可用作首码」有关的警告讯息挪到萤幕右上角、以飘云通知视窗呈现。花牌键原始对应的字元资料将由威注音输入法的注音输入模式的原厂语汇资料辞典来提供。
- 体验：CIN2 磁带格式标准支援升级至 CIN v2.2:
  1. 新增了对「%symboldef」章节的支援。该章节的内容不会被统计为「%chardef」的内容，哪怕其坐落于「%chardef」章节的内部。
  2. 磁带模组会自动判断当前读入的磁带档案的简码选字键是否「得同时摁住 Shift 才能起作用」：只要当前生效的简码选字键与「%chardef」当中用到的字根键有任何重合，则磁带模组就会认定「当前磁带的全部的有效简码选字键均得同时摁住 Shift 才能起作用」。
  3. 威注音输入法的磁带模组会检查当前磁带规定的「%selkey」在去除重复内容之后是否符合输入法对选字键设定资料值的条件要求，且在发现不合规的情况下直接强制指派「1234567890」为简码选字键（是否需要摁住 Shift 则另论，上文有提及）。
  4. 如果因为当前的简码选字行为所用到的击键顺序「反而会触发『%symboldef』章节当中的符号输入」的话，则此时会临时自动要求「摁住 Shift 键，简码选字键才会生效」。典型例子是「行列30」输入法在摁「w」键之后的简码候选字，此时就得用「Shift+1」选「女」，因为「W → 1」会触发符号选单「W1」。
- 行为：对 IMK 选字窗在 activateServer() 时的显示状态保护策略将仅在 activateServer() 函式呼叫开始的 800 毫秒内才会被呼叫。这可以有效避免一些与逐字选字模式有关的相容性故障。
- 行为：从现在起，只要没有启用 IMK 选字窗，则与 IMK 选字窗有关的函式一个都不会被呼叫到。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<details>
<summary>已知问题（请点击这一行文字以展开阅读）。</summary>

1. 沙箱特性带来的些许不便。请参见 2.3.0 版的更新日志。引入沙箱是为了打消一些使用者们可能抱持的资安疑虑，但使用者仍可自行使用 HIPS 类工具软体来主动监督威注音输入法的软体行为。
2. macOS 系统内建的 IMK 选字窗无法自订选字键、无法根据输入法所处的简体/繁体模式自动切换对应的「选字窗字型」及「高亮候选字背景配色」。这两个问题受限于 IMK 选字窗本身的特性，均无解。
3. 田所选字窗尚未支援单页卷动之特性。如果想使用有支援滑鼠单页卷动的选字窗的话，请在输入法偏好设定内的开发道场内启用 IMK 选字窗。
4. IMK 选字窗在 macOS 10.14 Mojave 系统下只能使用横排矩阵选字窗、且无法使用 PageUp / PageDn 键。该问题是 macOS 10.14 内建 InputMethodKit 模组的 Bug，无解。另外，IMK 选字窗也无法支援那些只有田所选字窗才支援的一些特性（比如借由滑鼠右键选单对候选字词控频/排除，等）。
5. Steam 等对 IMKTextInput 协定没有认真遵守的应用当中，选字窗与浮动组字窗的位置可能不受输入法控制。此问题无解，因为只有客体软体厂商才能解决这种问题、但他们又不想解决这种问题。
6. 在刚刚切换到某个 App 就呼叫波浪键符号选字窗时，IMK 选字窗可能会突然闪一下。该问题因 IMK 框架的设计特性而无解。能在这种情况下保持选字窗正常显示、已经是威注音最大的努力。
7. 选单图示没有做成单色设计，是为了更好区分简体输入模式与繁体输入模式。如有审美不相容之状况，还请谅解。
8. 请勿在诸如 NSMenu 以及 Spotlight 这种浮动窗内使用田所选字窗的滑鼠右键选单，否则可能会遇到「选字窗消失，只剩下滑鼠右键选单」的情况。此时需要切换到别的 App 再切换回来、才可以正常敲字。该故障目前无解。因此，威注音自 3.1.0 版开始对 Spotlight 和 Raycast 这两个客体应用停用田所选字窗滑鼠右键选单。
9. 威注音输入法本身很多与 Enter 键有关的组合键在微信等少数应用当中无法生效，因为这些客体应用在讯息窗格内输入文字时始终会拦截 Enter 键的讯号处理、而无视 InputMethodKit 组字区内容的有无。如有相关需求者，可以先行用其它文字编辑软体敲好讯息之后、借由剪贴簿中转、再贴入这类客体应用当中。
10. 威注音输入法的 INMU 格式递交功能无法直接作用于 Sibelius / Dorico 这一类谱务工作站，而是先在其它文字处理软体内准备好相关格式之后再利用给谱务工作站软体。以 Sibelius / Dorico 2 为例的话，就是将这种格式的文字整段复制到剪贴簿内，然后在软体的歌词输入模式当中连续 Command+V 贴上即可。Dorico 3 开始要麻烦一些，得事先在乐谱当中每个音符下插入一个字母，然后将这些音符全部选中、整段编辑歌词，此时再将 INMU 格式的文本用 Command+V 整段贴上。详见：https://forums.steinberg.net/t/150448
11. 如果在使用早期版本的腾讯 QQNT、且在讯息视窗内就地加词/删词/控频的时候出现「组字区内容擅自被递交到组字区的前后端」的混乱情况的话，请在输入法选单「管理客体应用…」视窗内将「`com.tencent.qq`」填入、以改用浮动组字窗取而代之。受此故障影响的输入法不只威注音这一款。幸运的是，腾讯的 QQNT 团队目前已经将该故障解决，请升级至至少 v6.9.12 公开正式版。
</details>

------

系统版本要求：至少 macOS 10.13.4 High Sierra。请在安装之前务必阅读这篇《[安装指引](https://gitee.com/vchewing/vChewing-macOS/wikis/%E8%AA%AA%E6%98%8E%E6%89%8B%E5%86%8A/%E5%AE%89%E8%A3%9D%E6%8C%87%E5%BC%95)》。因应不可控之技术现状，今后请各位优先 [借由 Gitee 下载](https://gitee.com/vchewing/vChewing-macOS/releases/)。

<details>
<summary>其它注意事项（请点击这一行文字以展开阅读）。</summary>

> ⚠️ 注意：使用者们可以克隆「[libvChewing-data](https://jihulab.com/vChewing/libvchewing-data)」且自行 `make install` 来手动安装今后被官方更新过的最新核心辞库。更新核心词库的过程会破坏 app 的签名，所以请务必也备份原始的 pkg 安装包。

> ⚠️ 警告：如果您硬碟内既存的威注音版本小于 2.3.0 ，则请在安装此更新之前务必事先备份使用者语汇资料夹的内容、然后在升级之后在输入法偏好设定内重新设定一遍使用者语汇目录。自威注音 2.3.0 版开始，威注音引入沙箱机制，使用者语汇目录只能存放于「/Users/您的使用者帐户名称/」目录下（也就是您的 Home 目录）。
</details>

#### 关于 Apple Developer 公证 & 安装包 SHA256：

> 本次提供的安装档案均已做公证处理。如果遇到 pkg 安装包故障的话，请尝试以「-alternative.zip」结尾的安装程式。

vChewing-macOS-3.5.1-signed.pkg
098ad9bfb83d2f1f021eac7470709de47266243bd0918e1e9df5dde0bb96897e

vChewing-macOS-3.5.1-signed-alternative.zip
512a064d08a2efbbb1d663179155f7b54da356fdfa1cc2ca6c7ab197a35ce17b

最后提交信息为： [VersionUp] 3.5.1 GM Build 3501.

vChewing/vChewing-macOS .gitee-modal { width: 500px !important; }

搜索帮助

vChewing/vChewing-macOS