vChewing-macOS 发行版

3.8.0

2024-02-12 18:02

#### 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

edbcae9

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

cad8a91

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

6ea10ac

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

c6469f1

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

c7cd358

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

04cc74c

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

0ba79d6

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

85ff6be

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

80e7877

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

9aeda12

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

e8c73e0

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

b0bf095

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

2ba27c6

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.

3.5.0

5b4dc92

2023-06-17 17:49

3.5.0 SP2

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

- [SP2] 修正：修复了 Cocoa 版输入偏好设定当中「磁带模组：在已经敲出最长可能码的时候自动组字」开关失效的故障。
- [SP2] 修正：修复了 Cocoa 版输入偏好设定当中的选字键「无法自订为 10 个」的故障。
- [SP2] 行为：现在起，在停用「磁带模组：在已经敲出最长可能码的时候自动组字」的时候，恐必须得使用「Shift+选字键」的方式才可以对简码进行选字。此乃现阶段不得已而做出的特性调整。
- [SP1] 修正：解决了磁带模式下的简码选字键失效的故障。
- 修正：在原理上解决了在诸如 MS Excel / Safari 等「单个 App 内部可能会叫出多个 IMKInputController 会话」的客体应用内出现的「Shift 中英模式切换状态混乱」的故障：现在起，只要是客体应用的 bundle identifier 唯一标帜字串雷同，则所有对接了「持这种唯一标帜字串的客体」的 IMKInputController 会话都会共用 Shift 中英文切换状态。
  - 副作用：在关掉某款 App 之后，输入法会记住那款被关掉的 App 的 Shift 中英文输入模式开关的最终开关状态、直到输入法被重启（或登入登出/重新开机）时才会丢失对于该开关状态的记忆。
- 修正：解决了（复发的）在「刚切换到其他应用就立刻叫出输入法的符号选字窗」时「IMK 选字窗刚显示就会被关闭」的故障。这种「被关闭」的现象乃 IMK 选字窗自身的程式设计特性使然，威注音对此的应对方式就是：每次主动显示 IMK 选字窗的时候，会再连续两三次每隔几百毫秒就检查该视窗的可见状态、发现不可见就再令其显示出来。
- 体验：CIN 磁带模组更新至 CIN2.1 标准，借此得以实现对诸如行列输入法、五笔输入法的简码输入支援。
  - 这对 CIN 档案内容有如下要求（相比 CIN2.0 而言）：
    - `%nullcandidate` 用来指明 `%quick` 字段给出的候选字当中有哪一种是无效的。
    - `%quick begin` 至 `%quick end` 之间则是简码资料字段，对应的 value 是单个字串、会被输入法逐字拆分成一组候选字词阵列。
    - `%selkey` 的内容现在会被威注音输入法优先当作简码输入时的专用选字键，但其数量必须得至少 6 个、至多 10 个。如果磁带内的这一行的给定资料值不符合条件的话，则输入法会自动另采 `1234567890` 作为简码输入专用选字键。
    - 如果简码候选字的对应码好死不死地包含了 `%chardef` 章节的某些内容的字根码的话，则 `%chardef` 章节的内容会被优先处理、优先度高于简码选字。
  - 注１：您仍可以借由「用方向键选择、敲 Enter 键确认」或滑鼠点击的方式来选择您想要确认输入的简码候选字。如果您载入的磁带给出了超过一页的简码候选字的话，可以用方向键翻页、高亮选取您想要输入的简码字。
  - 注２：简码输入模式目前无法支援 IMK 选字窗（因为实作难度过于复杂）。当威注音输入法有启用 IMK 选字窗的时候，输入法将不会借由磁带读取简码候选资料。
  - 注３：此次的磁带模组对于花牌键的设计并无任何改动。因暂时的可投入技术资源的限制，威注音此次更新暂时无法实作能够完全符合行列输入法规格标准的「*」「?」万用字元支援。能用到这些功能的使用者们往往都是因为忘记了字根，所以可以切换回注音打字模式、再利用田所选字窗的磁带字根反查显示功能。除此之外，威注音输入法目前的花牌键应该足够满足剩余的万用查码需求。今后如有这方面的技术突破的话，会再考虑实作这两个特性。
- 体验：CIN 磁带模组现可接受「需要摁住 Shift 才可以输入的字根符号或花牌键」的输入。
- 体验：现可敲空格键取消 Big5 / GB 内码输入状态。
- 体验：在输入法偏好设定内切换 IMK 选字窗 / 田所选字窗的时候，不再需要重新启动输入法。
- 体验：新增「Ctrl+Shift+Command+[]」作为另一组备用的候选字词轮替用热键。
- 体验：田所选字窗现会在自身介面重新绘制的时候自动更新视窗的起始座标点、以应对受反查结果变化而出现的视窗宽度变化。这有助于避免视窗因此抻出萤幕右侧边界的情况。
- 体验：田所选字窗现允许使用者借由拽动「除了候选字词以外的部分」的方式来拽动视窗本身。
- 行为：出于与效能有关的疑虑，在 macOS 10.15 开始的系统内全新安装威注音输入法时，田所选字窗的预设形态现在会是 Cocoa 形态。
- 行为：现允许设定最多 10 个选字键（之前的上限是 9 个）。
- 研发：彻底重构了 InputHandler 对于传入的按键讯号的分诊逻辑；另有些许小修正。
- 研发：针对 Xcode 15 做了些许专案配置调整。
- 辞典：例行语汇资料更新＋原神/星穹铁道语料更新。

<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.0-signed.pkg
f4f52be72e526ffaaa058c1bbea089d4e8c814d828f43ee0feeedba27b7fe8c9

vChewing-macOS-3.5.0-signed-alternative.zip
5841b9f05561b6e99286052ab44a0bb33d16c2cb0084ae7e21fe93cbbf32fb13

最后提交信息为： [VersionUp] 3.5.0 SP2 Build 3500.

3.4.9

b9d6a47

2023-06-06 09:55

3.4.9

#### 3.4.9 版针对 3.4.8 版更新了下述内容：

- 修正：解决了田所选字窗（SwiftUI 版）在除了横版单列以外的排版模式下「不显示反查结果」的故障。 
- 修正：修正了半衰记忆模组在输入法（重新）启动时无法读取 JSON 存档的 Bug。
- 修正：将 Cocoa 版偏好设定当中的与基础键盘布局有关的说明文字更新为目前 SwiftUI 版偏好设定视窗当中的说明文字，以正确描述目前的威注音输入法的软体行为。
- 体验：全专案改采 JSON 格式的原厂辞典、取代 plist，节省记忆体占用与硬碟空间占用，载入速度更快。
- 体验：磁带模组新增对于 `%quick` 区段的读取支援、会自动将其与 `%chardef` 区段融合（但优先权更高）。该区段常见于行列输入法表格的某些发行版。
- 研发：对田所选字窗以及 CandidatePool 做了一些与物件交互特性有关的调整。
- 研发：对不包含文字讯息的按键输入讯号的处理流程做了些许调整。
- 研发：天权星组字引擎 v2.7.0 更新，让 KeyValuePaired 成为 Unigram 的派生型别、以便于满足今后的开发目的，也解除了对 Foundation 的依赖。
- 研发：铁恨注拼引擎 v1.5.1 更新，解除了对 Foundation 的依赖。
- 研发：改用 IMKInputController 专门提供的原生方法来生成 selectionRange() 和 replacementRange()。
- 辞典：例行语汇资料更新＋原神语料更新。

<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.4.9-signed.pkg
58ba1f332b62466ec54a1f8b1138ae64a4c0cfc6658b6a6a1a818999f8473d16

vChewing-macOS-3.4.9-signed-alternative.zip
85773eea8127abfc0060327049e114c8d47c56bc39cbf3e34a93c89b5e51e3e3

最后提交信息为： [VersionUp] 3.4.9 GM Build 3409

3.4.8

48e2343

2023-05-26 01:03

3.4.8

#### 3.4.8 版针对 3.4.7 版更新了下述内容：

- 修正：解决了在拼音模式下「注拼槽为空的时候，无法直接借由主键盘区数字键输入某些数字」的故障。
- 修正：解决了按键调度模组在处理组字行为逻辑时的某处判定失误。
- 行为：从现在起，当使用 Ctrl+Command+Shift+D 切换繁体/简体输入模式的时候，会自动关掉当前的英文输入模式。
- 行为：借由调整输入法 bundle plist 内容参数配置的方法，封堵了在某些新开箱的 mac 电脑内全新安装威注音输入法之后「敲两下空格，会出现全形句号」的故障。虽然这是因为 macOS 的某个功能特性的原厂设定、而出现的异常行为，但这次的实现原理就是：将传入的连续的两个空格「取代为两个西文半形空格，而不是某一个中文句号」，所以（理论上）不用再担心 macOS 的这个功能特性是否被停用了。
- 体验：新增对刘又铭拟音注音排列的支援，且同时对其「微软新注音妥协形态」与「理想形态」这两种输入方案相容。
- 体验：为了照顾色盲患者的使用体验，从现在起，威注音将使用单色选单图示、辅以特殊的渐变美工处理，以增强两个输入模式彼此的辨识度。
- 体验：从现在起，当「声调键成功覆写位于游标身后的汉字」的时候，会出现对应的工具提示（两秒）。
- 体验：从现在起，威注音输入法成功实现了对「声调前置输入」之情形的防呆功能支援。与上游相比，差异如下：
  - 因为威注音所使用的注拼引擎（铁恨）与上游的注拼引擎（OVMandarin）完全不同，所以该功能的实作方式有明显的差异。
  - 威注音在开启该功能的情况下，允许借由单独敲一次 Enter 键以迅速输入声调符号（且直接递交）；上游需要敲两次 Enter 键才可以。
  - 威注音允许使用者自行停用该防呆功能；上游无法停用该功能。
- 体验：现在起，当试图输入新的汉字的字音时，如果先敲了声调键、且此时有启用「声调前置输入」的话，则会出现专门的工具提示、来指引进一步的操作。
- 辞典：例行语汇资料更新＋原神＆星穹铁道语料更新＆全字库更新（2023-05-19）。

<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.4.8-signed.pkg
ed163b4d0f5da5c5dc3497d683ef72ecd7cb7596c99abe4798ee26cebd014456

vChewing-macOS-3.4.8-signed-alternative.zip
4f2afc9c348a37a16d7b09fa46a13e0cb6de8bd753143257f633e5f2219c77aa

最后提交信息为： [VersionUp] 3.4.8 GM Build 3408.

3.4.7

5cd20a3

2023-05-01 21:31

3.4.7

#### 3.4.7 版针对 3.4.6 版更新了下述内容：

- 修正：解决了与汉语拼音模式的空格键响应逻辑有关的一些故障。
- 体验：从现在起，除了大千传统、酷音大千26键、（伪）精业、IBM 以外的注音键盘排列，都可以借由「基础键盘布局」设定来实现对 Dvorak 等英数键盘布局的映射支援。
- 体验：新增繁简输入模式切换专用热键「Command+Control+Shift+D」，可在偏好设定内停用。之所以没有采用小麦注音与奇摩输入法的繁简切换专用热键（Control/Shift+Command+G），是因为这些热键与很多软体存在热键冲突（可以在 DefKey 网站查询到）。该选项会在您当前系统「尚未同时启用威注音的繁＆简输入模式」的时候自动启用（截至 macOS 11）、或引领您在系统偏好设定内完成启用过程（自 macOS 12 开始的话是如此）。
- 体验：App 格式的备用版安装程式不会再在系统「已经有启用威注音输入法」的情况下重复询问使用者「是否启用威注音输入法」。
- 研发：改用 InputMethodKit 内建的（与 TSM 有关的）函式的生成结果、来作为内文组字区文字显示的优先采用格式。
- 辞典：例行语汇资料更新＋原神语料更新。

<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.4.7-signed.pkg
44afdf14c63aa857d88a9fdb627d23f3fb202bec0a86869fc01887aabbf901dc

vChewing-macOS-3.4.7-signed-alternative.zip
e0b12546b48cc40a8fe469f7cd2ee96829a635ed1d91a287d2ed6a3dda5c1732

最后提交信息为： [VersionUp] 3.4.7 GM Build 3407.

3.4.6

4f4ee8a

2023-04-15 15:15

3.4.6

#### 3.4.6 版针对 3.4.5 版更新了下述内容：

- 修正：解决了在借由 macOS 系统内建 Emoji 面板输入 Emoji 之后会导致输入法崩溃的故障。
- 修正：解决了在切换系统黑暗模式开关之后、输入法工具提示视窗的配色方案可能会出现的异常。
- 修正：铁恨注拼引擎更新至 v1.4.1，解决了（虽然一直没有爆发的）牵涉到与所有复合注音键盘布局处理有关的一些逻辑故障。另注：该故障迄今为止一直没发作的原因在于铁恨注拼引擎本身的追加保险设计。
- 行为：除非开启侦错模式，否则会使用系统的提示声、而非输入法本身的贝斯拨弦声。
- 辞典：例行语汇资料更新＋原神语料更新。

<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.4.6-signed.pkg
572ff556316eb44eaa282902ebf55b34307d231e1abb0ae8fbd51278dacf43e5

vChewing-macOS-3.4.6-signed-alternative.zip
726f1b5bc70f3c9292732839a23a25f1ec13a9013b796e3d2a3cc78fa8f6e520

最后提交信息为： [VersionUp] 3.4.6 GM Build 3406.

3.4.5

112da05

2023-04-05 21:14

3.4.5

#### 3.4.5 版针对 3.4.4 版更新了下述内容：

- 修复：取消了在上一版引入的「将某些与状态有关的任务另立专用执行绪队列」的设计，试图借此解决与某些客体软体不相容的故障（虽然崩溃的是客体软体、而非输入法本身）。这会取消对多核心 CPU 的一些充分利用，但实属无奈之举。如果 Line 自身还会再崩溃的话，请洽 Naver 提报其故障、并设法提供 Line 本身的崩溃报告给他们。
- 修复：解决了在某些包含同音异幅的候选字词的选字窗内来回选字时的崩溃故障。
- 体验：新增韦氏拼音输入支援，但必须使用英文右引号键「'」来区分清浊音。因应该功能需求，铁恨注拼引擎升级至 v1.4.0 版。
- 研发：针对 Cocoa 版偏好设定视窗改采动态方式来绘制国音分析器下拉选单，以节省本地化成本。
- 体验：自这一版开始，每次 activateServer() 都会始终确认当前会话副本的简繁模式与输入法选单所显示的当前输入法简繁模式是否一致、且会在发现不一致的时候更新当前会话副本内的简繁模式。
- 辞典：例行语汇资料更新＋原神语料更新。另更新全字库资料至 3 月 24 日的版本。

<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.4.5-signed.pkg
3e913c50941710c6b3bd7e52415575ea2c68b2b83bee2a1f0a30229cab23018e

vChewing-macOS-3.4.5-signed-alternative.zip
dcace9b0a474c5072686c0422acf05dff8eb90393ce7b46c8bf3bbfb5dbb6aab

最后提交信息为： Bump version to 3.4.5 GM Build 3405.

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

搜索帮助

vChewing/vChewing-macOS