Skip to content

Commit 2205f1f

Browse files
ShikiSuenShikiSuen
committed
README // Fix the paths of the mentioned files.
1 parent 039e415 commit 2205f1f

2 files changed

Lines changed: 114 additions & 112 deletions

File tree

‎README-CHS.md‎

Lines changed: 7 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@
2828
- 有「强化型组字区安全防护」模式，防止「接收打字的软体」提前存取您的组字区的内容。
2929

3030
>唯音有很多特色功能。在此仅列举部分：
31-
>- 支援 macOS 萤幕模拟键盘（仅传统大千与传统倚天布局）。
31+
>- 支援 macOS 荧幕模拟键盘（仅传统大千与传统倚天布局）。
3232
>- 可以将自己打的繁体中文自动转成日本 JIS 新字体来输出（包括基础的字词转换）、也可以转成康熙繁体来输出。
3333
>- 简繁体中文语料库彼此分离，彻底杜绝任何繁简转换过程可能造成的失误。
3434
>- 支援近年的全字库汉字输入。
@@ -44,7 +44,7 @@
4444
建置用系统需求：
4545

4646
- **Xcode 26+ (macOS 15.6+ required)** 或单独安装的 **Swift 6.2 open-source toolchain** + **macOS 26 SDK**。
47-
- 原因：Swift 6.2 成为必需版本（用于改进 concurrency 安全特性、SPM 6.2.4+ API 支持、CommandPlugin 改进等）。
47+
- 原因：Swift 6.2 成为必需版本（用于改进 concurrency 安全特性、SPM 6.2.4+ API 支援、CommandPlugin 改进等）。
4848
- 请使用正式发行版 Xcode，且最小子版本号越高越好（因为 Bug 相对而言最少）。
4949
- 如果是某个大版本的 Xcode 的 Release Candidate 版本的话，我们可能会对此做相容性测试。
5050

@@ -83,7 +83,7 @@
8383

8484
或者直接开启 Xcode 专案，Product -> Scheme 选「vChewingInstaller」，编译即可。
8585

86-
第一次安装完之后，如有修改原厂辞典与程式码的话，只要重复上述流程重新安装输入法即可。
86+
第一次安装完之后，如有修改原厂辞典与程式码的话，只要重覆上述流程重新安装输入法即可。
8787

8888
如果安装若干次后，发现程式修改的结果并没有出现、或甚至输入法已无法再选用的话，请重新登入系统。
8989

@@ -95,11 +95,13 @@
9595

9696
唯音输入法 macOS 版以 MIT-NTL License 授权释出 (与 MIT 相容)：© 2021-2022 vChewing 专案。
9797

98-
- 唯音输入法 macOS 版程式维护：Shiki Suen。特别感谢 Isaac Xen 与 Hiraku Wong 等人的技术协力。
98+
- 唯音输入法 macOS 版程式维护：Shiki Suen。特别感谢 Isaac Xen 与 Hiraku Wong 等人对唯音输入法 1.x 早期版本的技术协力。
9999
- 铁恨注音并击处理引擎：Shiki Suen (AGPL-3.0-or-later License)。
100-
- 天权星语汇处理引擎：Shiki Suen (AGPL-3.0-or-later License)。
100+
- 护摩组句引擎（Homa）：Shiki Suen (LGPL v3.0 or later, with Swift App Development exception)。
101101
- 唯音词库（先锋语料库）由 Shiki Suen 维护，以 3-Clause BSD License 授权释出。其中的词频资料[由 NAER 授权用于非商业用途](https://twitter.com/ShikiSuen/status/1479329302713831424)。
102102

103+
> 自 2026 年 04 月下旬，本仓库的组句引擎已由天权星（Megrez）迁移为敝专案自研先锋引擎套件 LibVanguard 当中的护摩（Homa）。Homa 元件本身以 LGPL v3.0 or later 授权释出，且附带与 Swift App Development 情境的额外许可；详见 `./Packages/vChewing_Homa/CUSTOM_LGPLv3_EXCEPTION.md` 与 `./Packages/vChewing_Homa/LICENSE`。
104+
103105
使用者可自由使用、散播本软体，惟散播时必须完整保留版权声明及软体授权、且「一旦经过修改便不可以再继续使用唯音的产品名称」。换言之，这条相对上游 MIT 而言新增的规定就是：你 Fork 可以，但 Fork 成单独发行的产品名称时就必须修改产品名称。
104106

105107
$ EOF.

‎README.md‎

Lines changed: 107 additions & 107 deletions
Original file line numberDiff line numberDiff line change
@@ -1,107 +1,107 @@
1-
語言：[简体中文](./README-CHS.md) | *繁體中文*
2-
3-
僅以此 README 紀念祁建華 (CHIEN-HUA CHI, 1921-2001)。
4-
5-
---
6-
7-
有關該倉庫及該輸入法的最新資訊，請洽產品主頁：https://vchewing.github.io/
8-
9-
因不可控原因，該倉庫只能保證在 Gitee 有最新的內容可用：
10-
11-
- 下載：https://gitee.com/vchewing/vChewing-macOS/releases
12-
- 程式碼倉庫：https://gitee.com/vchewing/vChewing-macOS
13-
14-
# vChewing 唯音輸入法
15-
16-
唯音輸入法是一款為 macOS 平台開發的副廠**原生簡體中文、原生繁體中文注音輸入法**：
17-
18-
- 唯音是業界現階段支援注音排列種類數量與輸入用拼音種類數量最多的注音輸入法。
19-
- 受唯音自家的鐵恨注音並擊引擎加持。
20-
- 唯音的原廠詞庫內不存在任何可以妨礙該輸入法在世界上任何地方傳播的內容。
21-
- 相比中州韻（鼠須管）而言，唯音能夠做到真正的大千聲韻並擊。
22-
- 擁有拼音並擊模式，不懂注音的人群也可以受益於該輸入法所帶來的穩定的平均輸入速度。
23-
- 相比小鶴雙拼等雙拼方案而言，唯音雙手聲韻分工明確、且重碼率只有雙拼的五分之一。
24-
- 唯音對陸規審音完全相容：不熟悉台澎金馬審音的大陸用戶不會遇到與漢字讀音有關的不便。
25-
- 反之亦然。
26-
- 唯音輸入法是最安全的 macOS 副廠中文輸入法：
27-
- 有啟用 Sandbox 特性，（相比其他沒有開 Sandbox 而言）唯音輸入法在原理上不可能拿到系統全局鍵盤權限。
28-
- 有「強化型組字區安全防護」模式，防止「接收打字的軟體」提前存取您的組字區的內容。
29-
30-
>唯音有很多特色功能。在此僅列舉部分：
31-
>- 支援 macOS 螢幕模擬鍵盤（僅傳統大千與傳統倚天佈局）。
32-
>- 可以將自己打的繁體中文自動轉成日本 JIS 新字體來輸出（包括基礎的字詞轉換）、也可以轉成康熙繁體來輸出。
33-
>- 簡繁體中文語料庫彼此分離，徹底杜絕任何繁簡轉換過程可能造成的失誤。
34-
>- 支援近年的全字庫漢字輸入。
35-
>- 可以自動整理使用者語彙檔案格式、自訂關聯詞語。
36-
>- ……
37-
38-
唯音分支專案及唯音詞庫（先鋒語料庫）由孫志貴（Shiki Suen）維護，其內容屬於可在 Gitee 公開展示的合法內容。但這些內容在被整理收入先鋒語料庫之前的原始資料的合規性不屬於維護者的負責範圍之內。
39-
40-
> 資安宣告：唯音輸入法的 Shift 按鍵監測功能僅藉由對 NSEvent 訊號資料流的上下文關係的觀測來實現，僅接觸藉由 macOS 系統內建的 InputMethodKit 當中的 IMKServer 傳來的 NSEvent 訊號資料流、而無須監聽系統全局鍵盤事件，也無須向使用者申請用以達成這類「可能會引發資安疑慮」的行為所需的輔助權限，更不會將您的電腦內的任何資料傳出去（本來就是這樣，且自唯音 2.3.0 版引入的 Sandbox 特性更杜絕了這種可能性）。請放心使用。Shift 中英模式切換功能要求至少 macOS 10.15 Catalina 才可以用。
41-
42-
## 系統需求
43-
44-
建置用系統需求：
45-
46-
- **Xcode 26+ (macOS 15.6+ required)** 或單獨安裝的 **Swift 6.2 open-source toolchain** + **macOS 26 SDK**。
47-
- 原因：Swift 6.2 成為必需版本（用於改進 concurrency 安全特性、SPM 6.2.4+ API 支援、CommandPlugin 改進等）。
48-
- 請使用正式發行版 Xcode，且最小子版本號越高越好（因為 Bug 相對而言最少）。
49-
- 如果是某個大版本的 Xcode 的 Release Candidate 版本的話，我們可能會對此做相容性測試。
50-
51-
編譯出的成品對應系統需求：
52-
53-
- 至少 macOS 12 Monterey。
54-
- 如需要在更舊版的系統下運行的話，請前往[唯音輸入法主頁](https://vchewing.github.io/README.html)下載 Aqua 紀念版唯音輸入法，可支援自 macOS 10.9 開始至 macOS 12 Monterey 為止的系統版本。
55-
56-
- **推薦最低系統版本**：macOS 14 Sonoma。
57-
58-
- 同時建議**系統記憶體應至少 4GB**。唯音輸入法佔用記憶體約 115MB 左右（簡繁雙模式）、75MB左右（單模式），供參考。
59-
- 請務必使用 SSD 硬碟，否則可能會影響每次開機之後輸入法首次載入的速度。從 10.10 Yosemite 開始，macOS 就已經是針對機械硬碟負優化的作業系統了。
60-
61-
- 關於全字庫支援，因下述事實而在理論上很難做到最完美：
62-
63-
- 很可惜 GB18030-2005 並沒有官方提供的逐字讀音對照表，所以目前才用了全字庫。然而全字庫並不等於完美。
64-
- 有條件者可以安裝全字庫字型與花園明朝，否則全字庫等高萬國碼碼位漢字恐無法在輸入法的選字窗內完整顯示。
65-
- 全字庫漢字顯示支援會受到具體系統版本對萬國碼版本的支援的限制。
66-
- 有些全字庫漢字一開始會依賴萬國碼的私人造字區，且在之後被新版本萬國碼所支援。
67-
68-
## 建置流程
69-
70-
安裝 Xcode 之後，請先配置 Xcode 允許其直接構建在專案所在的資料夾下的 build 資料夾內。步驟：
71-
```
72-
「Xcode」->「Preferences...」->「Locations」；
73-
「File」->「Project/WorkspaceSettings...」->「Advanced」；
74-
選「Custom」->「Relative to Workspace」即可。不選的話，make 的過程會出錯。
75-
```
76-
77-
在終端機內定位到唯音的克隆本地專案的本地倉庫的目錄之後，執行下列指令：
78-
79-
- `make update`：取得最新詞庫資源（使用遠端 Swift Package plugin）。
80-
- `make release`：建置通用二進制版本（arm64 + x86_64），輸出至 `Build/Products/Release/`。
81-
- `make archive`：建置通用版本並產生 `.xcarchive` 存檔（含 dSYM），存入 Xcode Archives 目錄。
82-
- `make debug`：快速偵錯組建（單一架構）。
83-
84-
或者直接開啟 Xcode 專案，Product -> Scheme 選「vChewingInstaller」，編譯即可。
85-
86-
第一次安裝完之後，如有修改原廠辭典與程式碼的話，只要重覆上述流程重新安裝輸入法即可。
87-
88-
如果安裝若干次後，發現程式修改的結果並沒有出現、或甚至輸入法已無法再選用的話，請重新登入系統。
89-
90-
## 關於該倉庫的歷史記錄
91-
92-
該輸入法早於 4.1.3 版的記錄全部放在[vChewing-macOS-AncientArchive](https://github.com/vChewing/vChewing-macOS-AncientArchive)倉庫內。
93-
94-
## 應用授權
95-
96-
唯音輸入法 macOS 版以 MIT-NTL License 授權釋出 (與 MIT 相容)：© 2021-2022 vChewing 專案。
97-
98-
- 唯音輸入法 macOS 版程式維護：Shiki Suen。特別感謝 Isaac Xen 與 Hiraku Wong 等人對唯音輸入法 1.x 早期版本的技術協力。
99-
- 鐵恨注音並擊處理引擎：Shiki Suen (AGPL-3.0-or-later License)。
100-
- 護摩組句引擎（Homa）：Shiki Suen (LGPL v3.0 or later, with Swift App Development exception)。
101-
- 唯音詞庫（先鋒語料庫）由 Shiki Suen 維護，以 3-Clause BSD License 授權釋出。其中的詞頻資料[由 NAER 授權用於非商業用途](https://twitter.com/ShikiSuen/status/1479329302713831424)。
102-
103-
> 自 2026 年 04 月下旬，本倉庫的組句引擎已由天權星（Megrez）遷移為敝專案自研先鋒引擎套件 LibVanguard 當中的護摩（Homa）。Homa 元件本身以 LGPL v3.0 or later 授權釋出，且附帶與 Swift App Development 情境的額外許可；詳見 `./Shared/vChewingComponents/Homa/CUSTOM_LGPLv3_EXCEPTION.md` 與 `./Shared/vChewingComponents/Homa/LICENSE`。
104-
105-
使用者可自由使用、散播本軟體，惟散播時必須完整保留版權聲明及軟體授權、且「一旦經過修改便不可以再繼續使用唯音的產品名稱」。換言之，這條相對上游 MIT 而言新增的規定就是：你 Fork 可以，但 Fork 成單獨發行的產品名稱時就必須修改產品名稱。
106-
107-
$ EOF.
1+
語言：[简体中文](./README-CHS.md) | *繁體中文*
2+
3+
僅以此 README 紀念祁建華 (CHIEN-HUA CHI, 1921-2001)。
4+
5+
---
6+
7+
有關該倉庫及該輸入法的最新資訊，請洽產品主頁：https://vchewing.github.io/
8+
9+
因不可控原因，該倉庫只能保證在 Gitee 有最新的內容可用：
10+
11+
- 下載：https://gitee.com/vchewing/vChewing-macOS/releases
12+
- 程式碼倉庫：https://gitee.com/vchewing/vChewing-macOS
13+
14+
# vChewing 唯音輸入法
15+
16+
唯音輸入法是一款為 macOS 平台開發的副廠**原生簡體中文、原生繁體中文注音輸入法**：
17+
18+
- 唯音是業界現階段支援注音排列種類數量與輸入用拼音種類數量最多的注音輸入法。
19+
- 受唯音自家的鐵恨注音並擊引擎加持。
20+
- 唯音的原廠詞庫內不存在任何可以妨礙該輸入法在世界上任何地方傳播的內容。
21+
- 相比中州韻（鼠須管）而言，唯音能夠做到真正的大千聲韻並擊。
22+
- 擁有拼音並擊模式，不懂注音的人群也可以受益於該輸入法所帶來的穩定的平均輸入速度。
23+
- 相比小鶴雙拼等雙拼方案而言，唯音雙手聲韻分工明確、且重碼率只有雙拼的五分之一。
24+
- 唯音對陸規審音完全相容：不熟悉台澎金馬審音的大陸用戶不會遇到與漢字讀音有關的不便。
25+
- 反之亦然。
26+
- 唯音輸入法是最安全的 macOS 副廠中文輸入法：
27+
- 有啟用 Sandbox 特性，（相比其他沒有開 Sandbox 而言）唯音輸入法在原理上不可能拿到系統全局鍵盤權限。
28+
- 有「強化型組字區安全防護」模式，防止「接收打字的軟體」提前存取您的組字區的內容。
29+
30+
>唯音有很多特色功能。在此僅列舉部分：
31+
>- 支援 macOS 螢幕模擬鍵盤（僅傳統大千與傳統倚天佈局）。
32+
>- 可以將自己打的繁體中文自動轉成日本 JIS 新字體來輸出（包括基礎的字詞轉換）、也可以轉成康熙繁體來輸出。
33+
>- 簡繁體中文語料庫彼此分離，徹底杜絕任何繁簡轉換過程可能造成的失誤。
34+
>- 支援近年的全字庫漢字輸入。
35+
>- 可以自動整理使用者語彙檔案格式、自訂關聯詞語。
36+
>- ……
37+
38+
唯音分支專案及唯音詞庫（先鋒語料庫）由孫志貴（Shiki Suen）維護，其內容屬於可在 Gitee 公開展示的合法內容。但這些內容在被整理收入先鋒語料庫之前的原始資料的合規性不屬於維護者的負責範圍之內。
39+
40+
> 資安宣告：唯音輸入法的 Shift 按鍵監測功能僅藉由對 NSEvent 訊號資料流的上下文關係的觀測來實現，僅接觸藉由 macOS 系統內建的 InputMethodKit 當中的 IMKServer 傳來的 NSEvent 訊號資料流、而無須監聽系統全局鍵盤事件，也無須向使用者申請用以達成這類「可能會引發資安疑慮」的行為所需的輔助權限，更不會將您的電腦內的任何資料傳出去（本來就是這樣，且自唯音 2.3.0 版引入的 Sandbox 特性更杜絕了這種可能性）。請放心使用。Shift 中英模式切換功能要求至少 macOS 10.15 Catalina 才可以用。
41+
42+
## 系統需求
43+
44+
建置用系統需求：
45+
46+
- **Xcode 26+ (macOS 15.6+ required)** 或單獨安裝的 **Swift 6.2 open-source toolchain** + **macOS 26 SDK**。
47+
- 原因：Swift 6.2 成為必需版本（用於改進 concurrency 安全特性、SPM 6.2.4+ API 支援、CommandPlugin 改進等）。
48+
- 請使用正式發行版 Xcode，且最小子版本號越高越好（因為 Bug 相對而言最少）。
49+
- 如果是某個大版本的 Xcode 的 Release Candidate 版本的話，我們可能會對此做相容性測試。
50+
51+
編譯出的成品對應系統需求：
52+
53+
- 至少 macOS 12 Monterey。
54+
- 如需要在更舊版的系統下運行的話，請前往[唯音輸入法主頁](https://vchewing.github.io/README.html)下載 Aqua 紀念版唯音輸入法，可支援自 macOS 10.9 開始至 macOS 12 Monterey 為止的系統版本。
55+
56+
- **推薦最低系統版本**：macOS 14 Sonoma。
57+
58+
- 同時建議**系統記憶體應至少 4GB**。唯音輸入法佔用記憶體約 115MB 左右（簡繁雙模式）、75MB左右（單模式），供參考。
59+
- 請務必使用 SSD 硬碟，否則可能會影響每次開機之後輸入法首次載入的速度。從 10.10 Yosemite 開始，macOS 就已經是針對機械硬碟負優化的作業系統了。
60+
61+
- 關於全字庫支援，因下述事實而在理論上很難做到最完美：
62+
63+
- 很可惜 GB18030-2005 並沒有官方提供的逐字讀音對照表，所以目前才用了全字庫。然而全字庫並不等於完美。
64+
- 有條件者可以安裝全字庫字型與花園明朝，否則全字庫等高萬國碼碼位漢字恐無法在輸入法的選字窗內完整顯示。
65+
- 全字庫漢字顯示支援會受到具體系統版本對萬國碼版本的支援的限制。
66+
- 有些全字庫漢字一開始會依賴萬國碼的私人造字區，且在之後被新版本萬國碼所支援。
67+
68+
## 建置流程
69+
70+
安裝 Xcode 之後，請先配置 Xcode 允許其直接構建在專案所在的資料夾下的 build 資料夾內。步驟：
71+
```
72+
「Xcode」->「Preferences...」->「Locations」；
73+
「File」->「Project/WorkspaceSettings...」->「Advanced」；
74+
選「Custom」->「Relative to Workspace」即可。不選的話，make 的過程會出錯。
75+
```
76+
77+
在終端機內定位到唯音的克隆本地專案的本地倉庫的目錄之後，執行下列指令：
78+
79+
- `make update`：取得最新詞庫資源（使用遠端 Swift Package plugin）。
80+
- `make release`：建置通用二進制版本（arm64 + x86_64），輸出至 `Build/Products/Release/`。
81+
- `make archive`：建置通用版本並產生 `.xcarchive` 存檔（含 dSYM），存入 Xcode Archives 目錄。
82+
- `make debug`：快速偵錯組建（單一架構）。
83+
84+
或者直接開啟 Xcode 專案，Product -> Scheme 選「vChewingInstaller」，編譯即可。
85+
86+
第一次安裝完之後，如有修改原廠辭典與程式碼的話，只要重覆上述流程重新安裝輸入法即可。
87+
88+
如果安裝若干次後，發現程式修改的結果並沒有出現、或甚至輸入法已無法再選用的話，請重新登入系統。
89+
90+
## 關於該倉庫的歷史記錄
91+
92+
該輸入法早於 4.1.3 版的記錄全部放在[vChewing-macOS-AncientArchive](https://github.com/vChewing/vChewing-macOS-AncientArchive)倉庫內。
93+
94+
## 應用授權
95+
96+
唯音輸入法 macOS 版以 MIT-NTL License 授權釋出 (與 MIT 相容)：© 2021-2022 vChewing 專案。
97+
98+
- 唯音輸入法 macOS 版程式維護：Shiki Suen。特別感謝 Isaac Xen 與 Hiraku Wong 等人對唯音輸入法 1.x 早期版本的技術協力。
99+
- 鐵恨注音並擊處理引擎：Shiki Suen (AGPL-3.0-or-later License)。
100+
- 護摩組句引擎（Homa）：Shiki Suen (LGPL v3.0 or later, with Swift App Development exception)。
101+
- 唯音詞庫（先鋒語料庫）由 Shiki Suen 維護，以 3-Clause BSD License 授權釋出。其中的詞頻資料[由 NAER 授權用於非商業用途](https://twitter.com/ShikiSuen/status/1479329302713831424)。
102+
103+
> 自 2026 年 04 月下旬，本倉庫的組句引擎已由天權星（Megrez）遷移為敝專案自研先鋒引擎套件 LibVanguard 當中的護摩（Homa）。Homa 元件本身以 LGPL v3.0 or later 授權釋出，且附帶與 Swift App Development 情境的額外許可；詳見 `./Packages/vChewing_Homa/CUSTOM_LGPLv3_EXCEPTION.md` 與 `./Packages/vChewing_Homa/LICENSE`。
104+
105+
使用者可自由使用、散播本軟體，惟散播時必須完整保留版權聲明及軟體授權、且「一旦經過修改便不可以再繼續使用唯音的產品名稱」。換言之，這條相對上游 MIT 而言新增的規定就是：你 Fork 可以，但 Fork 成單獨發行的產品名稱時就必須修改產品名稱。
106+
107+
$ EOF.

0 commit comments

Comments
 (0)