License Windows Test Build

DIME 是一套適用於 Windows 8/10/11 的輸入法框架,支援多種中文輸入法,包含大易、行列、注音、自建輸入法。

• 原生支援Windows各平台
  • 同一套程式碼同時支援 Windows x86/x64/ARM64 架構
  • 遵循 Windows TSF(Text Services Framework)標準,同時支援傳統桌面應用程式與 Microsoft Store 應用程式
• 大易輸入法
  • 標準大易輸入法 (Windows 內建碼表或自行提供碼表)
• 行列輸入法 (行列30/行列40)
  • 標準行列輸入法 (內建行列最新碼表)
  • 支援 Unicode CJK Ext-A~G (行列30)
• 傳統注音輸入法
  • 支援標準/許氏 鍵盤排列
• 自訂字根檔
  • 所有輸入法支援自行載入 .cin 碼表
• 自建詞庫輸入
  • 所有輸入法支援自建詞庫
  • 支援自建詞庫匯入匯出
• 支持字根反查
  • 支持Widnows TSF 標準反查界面,可與Windows 內建輸入法互相反查
• 輕量化設計
  • 100% 原生 C++ 開發,無第三方外部程式碼、函式庫或二進位檔案相依性
• 隱私保護
  • 不學習使用者輸入內容,不連線網路,無任何隱私疑慮
• 開源專案
  • 程式碼完全公開,歡迎檢視、使用與貢獻

1. 下載安裝檔

   最新穩定發行版本 DIME v.1.3.644(更新日期: 2026年05月08日)

   DIME-Universal.zip (單一安裝檔同時支援 x86/x64/ARM64 三種平台,安裝程式會自動偵測並安裝對應檔案)

   或依您的平台下載對應的 MSI 安裝檔:

   檔案	支援平台
   DIME-64bit.msi	Windows x64/ARM64 (64位元)
   DIME-32bit.msi	Windows x86(32位元)

   如何確認您的平台? 「設定」→「系統」→「系統資訊」頁面,查看「系統類型」欄位。若顯示「64位元作業系統」請選 DIME-64bit.msi,顯示「32位元作業系統」請選 DIME-32bit.msi。

   ---

   最新開發版本 DIME v1.3.657 (更新日期: 2026年05月20日)

   DIME-Universal.zip (單一安裝檔同時支援 x86/x64/ARM64 三種平台,安裝程式會自動偵測並安裝對應檔案)

   或依您的平台下載對應的 MSI 安裝檔:

   檔案	支援平台
   DIME-64bit.msi	Windows x64/ARM64 (64位元)
   DIME-32bit.msi	Windows x86(32位元)

2. 解壓縮 DIME-Universal.zip 取得 DIME-Universal.exe 安裝檔至任意目錄

3. (建議)驗證檔案完整性:

   最新穩定發行版本 DIME v.1.3.644 SHA-256 CHECKSUM (更新日期: 2026年05月08日):

   檔案	SHA-256 CHECKSUM
   DIME-Universal.exe	CD82EC8A81B9A1E722DB8F4A64596A1E913BD20906A75B33A6A3B1D0C301271B
   DIME-Universal.zip	AF914F8CA9ED02BB2D4C1888E77FA46596DE43763AA7590B4066251518AC2317
   DIME-64bit.msi	4DA9D8FC52A782328D34DD6EA9AADFEC477AC72F2314C5E24CB62E07A0E9DFDA
   DIME-32bit.msi	95E27015FAC5557869857CD80BC930BA41B8D14BE031A9730BBD1D1055F99E37

   最新開發版本 DIME v1.3.657 SHA-256 CHECKSUM (更新日期: 2026年05月20日)

   檔案	SHA-256 CHECKSUM
   DIME-Universal.exe	211C7808B5CFF8B80471299AFDA5A2CD7995AF98DB398164F61EE65B65032169
   DIME-Universal.zip	6B24F5A00C6ECD34D23791A80E6454DCE7E15B75A3406B161EEC51E80F6FA352
   DIME-64bit.msi	B491DE3B28F264C2FC753BA6BDA435AB862618F7B3ABB0174AE1882CBD8A5D04
   DIME-32bit.msi	D8E371694A55E235149DE04259DB2AEF0FA37A73715713B724005DCC093E8A30

   建議用如下Powershell指令,取得 SHA-256 CHECKSUM,將顯示的CHECKSUM 與上方表格中公布的值比對。

   # 驗證 .exe 檔案
   Get-FileHash DIME-Universal.exe -Algorithm SHA256
   # 或驗證 .zip 檔案
   Get-FileHash DIME-Universal.zip -Algorithm SHA256
   # 驗證 MSI 檔案
   Get-FileHash DIME-64bit.msi -Algorithm SHA256
   Get-FileHash DIME-32bit.msi -Algorithm SHA256

   為什麼需要驗證? 安裝程式未經數位簽章,因此無法透過 Windows 驗證發行商身分。透過比對 SHA-256 CHECKSUM 可確保下載的檔案與DIME正式發布版本完全一致,未經竄改。

4. 執行 DIME-Universal.exe 進行安裝,安裝後會自動新增以下四種輸入法:

   • DIME自建 - 自建 .cin 碼表輸入法
   • DIME傳統注音 - 傳統注音輸入法
   • DIME大易 - 大易輸入法
   • DIME行列 - 行列輸入法

   安裝時的安全警告

   執行 DIME 安裝程式時,Windows 會顯示使用者帳戶控制 (UAC) 提示,如下所示:

   使用者帳戶控制提示

   為什麼需要系統管理員權限?

   DIME 安裝程式需要系統管理員權限 (elevation rights) 才能完成以下操作:

   • 註冊輸入法服務:將 DIME 註冊為 Windows Text Services Framework (TSF) 輸入法,需要寫入系統登錄檔
   • 複製系統檔案:將輸入法 DLL 檔案安裝到系統目錄(詳見檔案說明)
   • 設定系統組態:配置輸入法在所有使用者帳戶中可用的相關設定

   這些操作都需要系統管理員權限才能執行,這是所有輸入法安裝程式的標準要求。

   為什麼顯示「未知的發行者」?

   UAC 對話框中顯示「未知的發行者」(Unknown Publisher),並且檔案資訊顯示「無法驗證發行者」,這是因為:

   • 未經數位簽章:DIME 安裝程式未使用程式碼簽章憑證 (Code Signing Certificate) 進行數位簽章
   • 簽章成本考量:程式碼簽章憑證每年需要數百至數千美元的費用,對於免費開源專案來說成本過高
   • Windows 安全機制:Windows 無法驗證安裝程式的發行者身分,因此會顯示此警告

   這樣安全嗎?

   儘管顯示未知發行者警告,DIME 仍然是安全的,原因如下:

   ✅ 100% 開源:所有原始碼公開於 GitHub,任何人都可以檢視和審查

   ✅ 無外部依賴:使用純 C++ 開發,不包含任何第三方程式庫、外部程式碼或可疑的二進位檔案

   ✅ 可驗證完整性:請務必從DIME GitHub 頁面下載安裝包 並比對 SHA-256 CHECKSUM,以確認下載的檔案未經竄改(見步驟 3)

   ✅ 無網路連線:不會連接網路,不會收集或傳送任何使用者資料

   ✅ 社群驗證:開源社群可以驗證程式碼的安全性

5. 如不需要全部輸入法,可在「設定」→「時間與語言」→「語言」→「中文(台灣)」→「選項」中,點選不需要的輸入法旁的「⋯」選單,選擇「移除」

v1.3+ 全新安裝程式

DIME v1.3 起採用全新安裝程式,除原有的通用安裝檔(DIME-Universal.exe)外,另提供針對各平台最佳化的獨立 MSI 安裝檔(DIME-64bit.msi 適用於 64 位元平台,含 x64 及 ARM64;DIME-32bit.msi 適用於 32 位元平台),可直接使用 Windows 標準套件管理工具進行部署與管理。

新安裝程式安裝、升級、降級及移除全程無需重開機,即使輸入法正在執行中亦然。安裝程式採用不中斷服務的檔案替換技術,讓執行中的程序持續使用原版本直到下次輸入法重新載入,無需等待重開機。從舊版安裝程式升級時,新版安裝程式亦會自動靜默移除舊版,無需使用者手動操作。

在「設定」→「應用程式」→「已安裝的應用程式」中,搜尋 DIME 並移除

DIME 安裝完成後會自動新增以下四種輸入法:DIME大易、DIME行列、DIME傳統注音、DIME自建。前三者安裝後即可使用,DIME自建則需先透過設定頁面載入自訂 .cin 碼表才能使用,碼表格式請參考自訂碼表格式說明。

使用時,點選 Windows 工作列上的語言圖示,或按 Windows + Space 在已安裝的輸入法之間循環切換,選擇所需的 DIME 輸入法。

DIME 選字視窗與提示視窗採用與 Windows 11 一致的現代化 UI 風格,外觀及互動行為完整融入系統,同時向下相容 Windows 7 至 Windows 10:

• 圓角外框:視窗四角圓角設計,搭配全方位柔和陰影,在各種背景下皆清晰易讀。

• 深色模式:自動跟隨系統深色/淺色模式即時切換配色,無需手動設定。

• 圓角選取列:目前選取的候選字以圓角矩形反白標示。

• 全功能捲軸:全新設計,候選字超過一頁時顯示,僅一頁時自動隱藏。支援滑鼠滾輪、觸控板捲動、點擊箭頭按鈕及拖曳滑桿翻頁,較原版捲軸大幅強化(原DIME捲軸僅有箭頭按鈕,無滑桿可拖曳)。

  捲軸外觀依照 Windows 11「協助工具」→「視覺效果」→「永遠顯示捲軸」設定而有所不同:

  設定	捲軸行為
  永遠顯示(開)	完整捲軸(三角箭頭+滑桿)隨時可見
  永遠顯示(關,預設)	多頁時細線滑桿隨時可見,其位置與高度即時反映目前頁面在所有頁面中的相對位置;滑鼠移入捲軸區域時展開為完整捲軸,離開後 2 秒自動收回

  提示: 若希望捲軸隨時完整顯示,可至「Windows 設定」→「協助工具」→「視覺效果」→ 開啟「永遠顯示捲軸」。此為 Windows 系統層級設定,DIME 會即時套用,無需重新啟動輸入法。

選擇 DIME 輸入法後,可使用以下快捷鍵切換中文/英數模式及其他功能:

快捷鍵設定選項:

以下快捷鍵可在各輸入法設定頁面中調整:

中文/英數切換方式:

• 左右 Shift 鍵
• 右 Shift 鍵
• 左 Shift 鍵
• 無(僅 Ctrl + Space 鍵)

全形/半形切換方式:

• 以 Shift + Space 熱鍵切換
• 全形
• 半形

輸入碼中支援兩種萬用字元:* 代表任意數量(含零個)的字根或字碼,? 代表恰好一個字根或字碼。萬用字元可出現在輸入碼的任意位置(開頭、中間或結尾),也可組合使用。例如在大易輸入法中,輸入 a* 可匹配所有以 a 開頭的輸入碼;輸入 *a 可匹配所有以 a 結尾的輸入碼;輸入 a?c 可匹配 abc、adc 等中間恰好一個字碼的組合。萬用字元可用於快速查詢不確定的字根或字碼組合。注意:不可單獨輸入純萬用字元(如僅輸入 * 或 ?)進行搜尋。

注音輸入法僅支援 ? 作為萬用字元,不支援 *。注音的組字結構為「聲母+介音+韻母+聲調」,? 會自動填入下一個尚未輸入的欄位作為萬用匹配。

在中文輸入模式下,未開始組字時,按住 Shift 鍵可直接輸入英數字元,無需切換至英文模式。

範例:在行列30中,,、.、;、/ 為字根鍵,[、]、-、= 不是。Shift+, 由輸入法處理;Shift+[ 繞過輸入法,由系統送出 {。

字根鍵由輸入法攔截後,依 CapsLock 狀態決定輸出:

數字鍵備註:數字鍵的 CapsLock 行為與字母鍵相反。若數字鍵不是字根鍵(如行列 30),則 Shift+數字鍵繞過輸入法,一律由系統送出 Shift 字元(!@# 等),不受 CapsLock 影響。兩者差異僅在 CapsLock ON 時:字根鍵輸入法(如大易)可取得基礎數字,非字根鍵輸入法(如行列 30)則始終為 Shift 字元。若需在中文模式下輸入阿拉伯數字,建議在設定頁面將「九宮格數字鍵盤」設為數字輸入模式,直接以數字小鍵盤輸入。

在「輸入設定」中的「Shift英數模式數字鍵行為」可調整數字鍵區在 Shift 英數模式下的輸出規則:

Shift+數字鍵的輸出對照:

• 「CapsLock 關輸出符號」(預設):CapsLock OFF → !@#$%^&*(),CapsLock ON → 1234567890
• 「CapsLock 關輸出數字」:CapsLock OFF → 1234567890,CapsLock ON → !@#$%^&*()
• 「永遠輸出符號」:無論 CapsLock 狀態一律輸出 !@#$%^&*()

• 中英混合:輸入「請使用」→ 按住 Shift 輸入 git commit → 輸入「命令」→「請使用 git commit 命令」。Shift 期間可連續輸入英數及空格(Shift+Space 產生空格)。
• 電子郵件:CapsLock OFF,按住 Shift 輸入 user、2(→ @)、example.com → user@example.com。
• 混合數字符號:輸入「版本」→ Shift 輸入 v → 放開 Shift → 數字小鍵盤輸入 1.2 → Shift 輸入 -beta → 輸入「已發布」→「版本v1.2-beta已發布」。

注意:當「全形/半形切換」設定為「以 Shift-Space 熱鍵切換」時,Shift+Space 保留給全形/半形切換,不會輸入空格;需放開 Shift 後按 Space 輸入空格。

所有輸入法皆支援聯想詞功能,DIME 使用Windows 內建聯想詞表。在各輸入法設定頁面勾選「提示聯想字詞」即可啟用,每輸入一個中文字後會自動顯示相關聯想詞,以 Shift + 1~0 選字(詞),例如輸入「台」後,聯想詞視窗會顯示「灣」、「北」、「中」和「北市」供選擇。使用者也可透過各輸入法設定的自建詞庫頁面載入聯想詞表按鈕載入自訂聯想詞表,聯想詞表格式請參考聯想詞表格式說明。

全新 Windows 11 風格設定介面,以側邊欄 + 卡片式佈局取代舊版 PropertySheet 對話方塊,支援深色模式與響應式佈局。

可透過開始選單中的「DIME設定」開啟設定程式,或在使用輸入法時按下 Ctrl + \ 直接開啟該輸入法的設定頁面。

DIME 行列輸入法設定

左側側邊欄提供以下頁面切換:

每個輸入法頁面包含四個設定區塊,以卡片方式呈現:

點擊「子頁面」卡片(外觀設定、自建詞庫)會進入子頁面,上方顯示麵包屑導覽列(例如「大易輸入法 › 外觀設定」),可點擊返回。

外觀設定子頁面

色彩模式:淺色模式、深色模式、自訂 為三套各自獨立的色彩組合,每套均可透過色彩選擇器個別自訂六項配色。Windows 10 1809 版後,設定跟隨系統模式時 DIME 依 Windows 淺色/深色模式設定(設定→個人化→色彩)自動切換色彩組合。

以下設定在所有輸入法的「輸入設定」卡片中皆可使用:

字集查詢範圍選項(大易、注音、自建):

字集查詢範圍選項(行列):

各輸入法專屬設定:

點擊「自建詞庫」卡片進入詞庫編輯器,所有輸入法皆支援自建詞庫功能,可新增常用字詞、專有名詞或特殊符號。

自建詞庫編輯器

使用方式:

• 每行輸入一組自訂字詞,格式為:輸入碼[空白]自訂字詞

範例:

wto 世界貿易組織
tw 台灣
nasa 美國國家航空暨太空總署
un 聯合國
usa 美國

傳統注音自訂詞組說明

使用傳統注音輸入法自訂詞組功能時,需使用 \ 鍵導引導跳過注音音節處理流程並進入自訂詞組模式。請注意,\ 僅作為引導鍵,不會作為查詢自訂詞組表的編碼查詢。

自建詞庫即時格式檢查

自訂詞庫編輯器內建即時驗證機制,在輸入過程中自動以顏色標記錯誤行,無需等到套用才發現格式問題。 觸發時機:按下 Enter 或空白鍵(分隔符)後、貼上內容後、大量刪除後,以及持續輸入時每隔 N 個按鍵。套用或匯出時亦會執行一次驗證;若有錯誤則中止操作並提示使用者。 驗證採三級層次,依嚴重程度以不同顏色標示:

層級	顏色	錯誤類型	說明
Level 1	洋紅色	格式錯誤	行不符合「輸入碼 空白 字詞」格式
Level 2	橘色	輸入碼過長	輸入碼長度超過輸入法設定組字區最大長度(行列固定為5,大易、自建可在設定頁面設定,傳統注音為 64)
Level 3	紅色	無效字碼	輸入碼中含有非輸入法字根(傳統注音因有引導鍵,無限制)
顏色配色會依目前介面主題(深色/淺色)自動調整。

Level 3 字元檢查規則依輸入法模式而異:

• 傳統注音:輸入碼允許可列印 ASCII 字元(! 至 ~),但首碼不得為 ? 萬用字元
• 其他輸入法:輸入碼必須為輸入法字根

功能按鈕:

側邊欄最下方的「自定碼表」頁面可載入或更新各輸入法的主碼表及額外碼表:

自定碼表頁面

自訂碼表提示: 若要客製化碼表內容,可直接編輯內建的 .cin 檔案(位於 %ProgramFiles%\DIME\ 目錄),編輯存檔後點選對應按鈕重新載入即可生效。碼表格式請參考自訂碼表格式說明。

設定介面支援 Windows 深色模式,自動偵測系統主題並切換標題列、側邊欄、卡片及控制項配色。候選字視窗色彩可在「外觀設定 › 色彩模式」中獨立設定。

DIMESettings.exe 支援 headless CLI 模式,可透過命令列查詢、設定及管理輸入法,詳見 DIME_CLI.md。

舊版設定介面: v1.3.588 及更早版本使用 PropertySheet 對話方塊設定介面,相關說明請參考 docs/OLD_SETTINGS.md。

DIME 支援標準 .cin 碼表格式,此格式源自 xcin 輸入法,廣泛應用於各種中文輸入法。檔案必須以 UTF-8 編碼儲存。

.cin 檔案使用 % 開頭的控制鍵定義碼表屬性,以 # 開頭的行為註解:

%sorted 索引機制(DIME 專屬):

%sorted 是 DIME 專屬的控制鍵,用於大幅加速碼表查詢效能。當 %sorted 1 啟用時,DIME 會在載入碼表時建立字首索引表(Radical Index Map):

1. 索引建立:解析 %chardef 區段時,記錄每個輸入碼首碼第一次出現的檔案位置
2. 快速定位:查詢時直接跳轉至輸入首碼開頭的位置,無需從頭搜尋
3. 提前終止:找到符合的字碼後,遇到不同首字母即停止搜尋

使用條件: %chardef 區段內的輸入碼必須先行排序 (不區分大小寫)

效能比較:

範例: 若碼表已排序,輸入 ba 查詢時:

1. 透過索引直接跳至 b 開頭的位置
2. 搜尋直到找到所有 ba 的對應字
3. 遇到 bb 或 c 開頭時立即停止

建議: 對於超過 10,000 筆資料的碼表,強烈建議碼表先行排序並啟用 %sorted 1。

# 註解
%ename 英文名稱
%cname 中文名稱
%selkey 選字鍵
%sorted 1
%keyname begin
按鍵	字根顯示
%keyname end
%chardef begin
輸入碼	輸出字詞
%chardef end

• %keyname:定義按鍵與字根符號對應,格式為 按鍵<Tab>字根 或 按鍵<空格>字根
• %chardef:定義輸入碼與輸出字詞對應,格式為 輸入碼<Tab>字詞 輸入碼<空格>字詞
• 同一輸入碼可對應多個字詞(多行)
• 若啟用 %sorted 1,%chardef 段落必須按輸入碼排序
• DIME 專屬:雙引號 " 為選用,僅在內容包含空白時需要(原始 .cin 格式不支援空白)

基本範例:

# 自訂輸入法
%ename	MyIME
%cname	我的輸入法
%encoding	UTF-8
%selkey	1234567890
%sorted	1
%keyname begin
a	A
b	B
%keyname end
%chardef begin
a	啊
a	阿
ai	愛
b	不
ba	把
%chardef end

行列輸入法 (Array.cin):

%ename	array30
%cname	行列30
%selkey	1234567890
%sorted	1
%keyname begin
a	1-
b	5v
c	3v
%keyname end
%chardef begin
,	,
,	火
,,	炎
%chardef end

注音輸入法 (phone.cin): 使用 %endkey 定義聲調鍵

%ename	Phonetic
%cname	注音
%selkey	123456789
%endkey	3467
%keyname begin
3	ˇ
4	ˋ
1	ㄅ
%keyname end
%chardef begin
-	兒
-3	爾
-4	二
%chardef end

聯想詞表/行列詞庫 (見Array-Phrase.cin): 可省略 %keyname 區段,直接使用 %chardef 定義輸入碼與字詞對應,並啟用 %sorted 1 加速查詢

%sorted	1
%chardef begin
,,,	米糕
,,,,	炎炎
,,r,	炎熱
%chardef end

聯想詞表使用 .cin 碼表格式,可省略 %keyname 區段,直接使用 %chardef 定義輸入碼與字詞對應,請用 UTF-8 編碼儲存,在任何一個輸入法自建詞庫頁面用載入聯想詞表按鍵載入 (請見自建詞庫與自訂碼表)。輸入碼為剛輸入的中文字,對應的聯想詞。例如輸入「台」後,聯想詞視窗會顯示「灣」、「北」、「中」和「北市」供選擇。詞表格式詳見下方範例:

範例:

%chardef begin
一	個
一	點
一	樣
一	些
一	次
一	下
一	種
一	定
台	灣
台	北
台 中
台	北市
%chardef end

注意:載入自訂聯想詞表後會取代 Windows 內建聯想詞表。若自訂詞表收錄的詞彙不夠完整,建議繼續使用內建聯想詞表以獲得較佳的聯想效果。

安裝程式會依據作業系統平台安裝對應的檔案:

系統檔案:

程式檔案(%ProgramFiles%\DIME\):

DIME 會在使用者的漫遊設定檔資料夾建立 DIME 目錄,存放個人化設定與碼表:

設定檔(.ini):

主碼表:

DIME 執行時一律從此目錄讀取碼表(.cin),碼表來源有兩種:

• 從 Program Files 複製:行列(Array.cin)與注音(phone.cin)在首次使用時會自動從安裝目錄複製
• 從設定頁面載入:使用者可透過各輸入法設定頁面的「載入主碼表」按鈕載入任意 .cin 檔案,載入時會自動轉換編碼(UTF-8 → UTF-16)並重新命名為該輸入法的固定檔名(見下表)

Windows 內建碼表:

首次使用時會自動從 %PROGRAMFILES%\Windows NT\TableTextService 目錄複製

Big5 過濾快取:

開啟 Big5 候選字過濾時,DIME 會自動產生 *-Big5.cin 或 *-Big5.txt 快取檔案(例如 Array-Big5.cin、TableTextServiceDaYi-Big5.txt),儲存過濾後的碼表以避免每次載入時重新過濾。當來源碼表更新時會自動重建。

自建詞庫:

使用者透過各輸入法設定頁面的「自建詞庫」功能新增自建字詞時,會自動建立對應的詞庫檔案:

.txt 檔案(使用者編輯格式)
 📝 使用者可直接用文字編輯器開啟修改
 💾 UTF-16LE 編碼(含 BOM)
 📋 簡化格式:僅包含 `輸入碼 字詞` 的內容
 🖊️ 設定頁面編輯框顯示和編輯的就是此檔案內容
 💡 可手動編輯後,下次開啟設定頁面會自動載入
.cin 檔案(輸入法引擎格式)
 ⚙️ 輸入法引擎實際載入使用的碼表
 💾 UTF-16LE 編碼
 📋 標準 .cin 格式:包含 `%chardef begin/end` 控制區段
 🔤 特殊字元自動跳脫處理(`\` → `\\`、`"` → `\"`,並視需要加上雙引號)
 🔄 每次點選「套用」時,會自動從 `.txt` 轉換生成

聯想詞表:

使用者透過各輸入法設定頁面的「載入聯想詞表」按鈕載入自訂聯想詞表時,會自動建立,以取代Windows內建聯想詞表。此檔案為所有輸入法共用:

行列專用碼表:

首次使用行列輸入法時,會自動從安裝目錄複製:

詞頻與簡繁轉換表:

首次使用時,會自動從安裝目錄複製:

注意:不建議直接修改%APPDATA%\DIME下的碼表檔案,請透過設定頁面載入自訂碼表或自建詞庫來覆蓋使用者資料夾中的碼表,以確保格式與編碼正確。

DIME 是開源專案,歡迎開發者 fork 並基於 DIME 建立衍生專案或軟體。

DIME is an open-source project. Developers are welcome to fork and build derivative projects or software based on DIME.

專案特色 / Project Highlights:

• ✅ 100% 原生 C++ / 100% Native C++ - 無外部依賴 / No external dependencies
• ✅ BSD 3-Clause 授權 / BSD 3-Clause License - 商業與非商業皆可使用 / Free for commercial and non-commercial use
• ✅ 多平台支援 / Multi-platform Support - x86/x64/ARM64EC 單一程式碼基底 / Single codebase for all platforms
• ✅ 完整的 TSF 實作 / Complete TSF Implementation - Windows Text Services Framework 標準實作 / Standard Windows TSF implementation

從原始碼建置 DIME / Building DIME from Source:

如果您想要自行編譯 DIME 或修改原始碼,請參閱完整的編譯指南:

If you want to build DIME yourself or modify the source code, please refer to the complete build guide:

📖 HOW_TO_BUILD

此文件包含詳細的編譯步驟、開發環境設定、多平台建置說明。

This document contains detailed build instructions, development environment setup, multi-platform build guidance.

DIME provides a headless CLI via DIMESettings.exe for AI Agents to install, configure, and manage the IME without GUI interaction.

# Download, extract, and silent-install (requires elevation)
Invoke-WebRequest -Uri "https://github.com/jrywu/DIME/releases/latest/download/DIME-Universal.zip" -OutFile "$env:TEMP\DIME-Universal.zip"
# Verify SHA-256 hash against the checksum published in the release notes
(Get-FileHash "$env:TEMP\DIME-Universal.zip" -Algorithm SHA256).Hash
Expand-Archive "$env:TEMP\DIME-Universal.zip" -DestinationPath "$env:TEMP\DIME" -Force
Start-Process "$env:TEMP\DIME\DIME-Universal.exe" -ArgumentList "/install /quiet /norestart" -Verb RunAs -Wait

Important: Before installing, compare the SHA-256 hash output with the checksum published in the release notes. The installer is unsigned — hash verification ensures the file has not been tampered with.

After installation: $dime = "$env:ProgramFiles\DIME\DIMESettings.exe"

$dime = "$env:ProgramFiles\DIME\DIMESettings.exe"
& $dime --help # Show all commands
& $dime --list-modes # dayi, array, phonetic, generic
& $dime --mode dayi --get-all --json # Query all settings as JSON
& $dime --mode dayi --set FontSize 16 --set ColorMode 2 # Change settings
& $dime --mode array --reset # Reset to defaults
& $dime --mode generic --load-main "$env:USERPROFILE\Documents\my.cin" # Load dictionary

All switches, mode names, key names, and table names are case-insensitive.

Exit codes: 0=success, 1=invalid argument, 2=I/O error, 3=key not applicable to mode.

Many ready-to-use .cin files are available online (Cangjie, Wubi, Pinyin, etc.). When helping users:

1. The .cin file must be UTF-8 encoded (most .cin files online already are)
2. Sort %chardef entries by keycode and add %sorted 1 to speed up lookup for large dictionaries (10,000+ entries)
3. Use --load-main to load into the generic (custom) IME mode

& $dime --mode generic --load-main "$env:USERPROFILE\Documents\my_ime.cin"
& $dime --mode generic --set AutoCompose 1 --set MaxCodes 6

See .cin format documentation for the file format and DIME CLI Interface for the complete command reference and key list.

Note for AI Agents: Do not directly modify files under %APPDATA%\DIME\. The config INI files and dictionary tables have internal format dependencies managed by the IME runtime. Always use the DIMESettings.exe CLI for all settings changes and table loading/unloading — it is the only supported interface.

如遇到問題或有建議,歡迎透過以下方式回報:

請至 GitHub Issues 提交問題回報,回報時請提供:

• Windows 版本:作業系統平台與版本(如 x64 Windows 11 23H2)
• DIME 版本:可在各輸入法設定頁面的視窗標題列中查看

如有行列輸入法的新功能建議,請先至 Facebook 行列輸入的家社團 發文討論。