diff --git a/docs/index.html b/docs/index.html
index e4de98c..104665c 100644
--- a/docs/index.html
+++ b/docs/index.html
@@ -211,8 +211,9 @@
-
系統匣熱鍵
+
系統匣熱鍵 Windows only
migao-watch 常駐背景，不需要開終端機，在任何應用程式（LINE、瀏覽器、Word）都有效。
+
macOS / Linux 歡迎貢獻——Issues 討論或認領。
CLI 工具
diff --git a/examples/ime_test.rs b/examples/ime_test.rs
new file mode 100644
index 0000000..23b2069
--- /dev/null
+++ b/examples/ime_test.rs
@@ -0,0 +1,131 @@
+//! One-shot probe: can we switch Microsoft Bopomofo from English mode back to
+//! Chinese mode from another process?
+//!
+//! Steps it performs automatically after a 5-second countdown:
+//! 1. read conversion mode via WM_IME_CONTROL (ImmGetDefaultIMEWnd)
+//! 2. try to set Chinese mode via IMC_SETCONVERSIONMODE / IMC_SETOPENSTATUS
+//! 3. read back; if unchanged, inject a single Shift as fallback
+//!
+//! User procedure (one action only):
+//! open Notepad, switch Bopomofo to 英 (English mode), run
+//! `cargo run --example ime_test`, click into Notepad, wait.
+//! Then report whether the indicator ended up 中 or 英, plus this output.
+
+#[cfg(windows)]
+fn main() {
+ use std::io::Write as _;
+ use std::{mem, thread, time::Duration};
+ use winapi::shared::basetsd::DWORD_PTR;
+ use winapi::shared::minwindef::{LPARAM, WPARAM};
+ use winapi::shared::windef::HWND;
+ use winapi::um::winuser::{
+ GetClassNameW, GetForegroundWindow, GetKeyboardLayout, GetWindowThreadProcessId, SendInput,
+ SendMessageTimeoutW, INPUT, INPUT_KEYBOARD, KEYEVENTF_KEYUP, SMTO_ABORTIFHUNG,
+ };
+
+ #[link(name = "imm32")]
+ extern "system" {
+ fn ImmGetDefaultIMEWnd(hwnd: HWND) -> HWND;
+ }
+
+ const WM_IME_CONTROL: u32 = 0x0283;
+ const IMC_GETCONVERSIONMODE: WPARAM = 0x0001;
+ const IMC_SETCONVERSIONMODE: WPARAM = 0x0002;
+ const IMC_GETOPENSTATUS: WPARAM = 0x0005;
+ const IMC_SETOPENSTATUS: WPARAM = 0x0006;
+ const IME_CMODE_NATIVE: DWORD_PTR = 0x0001;
+ const VK_SHIFT: u16 = 0x10;
+
+ unsafe fn ime_msg(ime_wnd: HWND, cmd: WPARAM, lparam: LPARAM) -> Option {
+ let mut result: DWORD_PTR = 0;
+ let ok = SendMessageTimeoutW(
+ ime_wnd,
+ WM_IME_CONTROL,
+ cmd,
+ lparam,
+ SMTO_ABORTIFHUNG,
+ 500,
+ &mut result,
+ );
+ if ok == 0 {
+ None
+ } else {
+ Some(result)
+ }
+ }
+
+ unsafe fn inject_shift() {
+ let mut inputs: [INPUT; 2] = mem::zeroed();
+ for (i, input) in inputs.iter_mut().enumerate() {
+ input.type_ = INPUT_KEYBOARD;
+ let ki = input.u.ki_mut();
+ ki.wVk = VK_SHIFT;
+ ki.dwFlags = if i == 0 { 0 } else { KEYEVENTF_KEYUP };
+ }
+ SendInput(2, inputs.as_mut_ptr(), mem::size_of::() as i32);
+ }
+
+ println!("請確認：記事本已開啟，微軟注音在「英」模式。");
+ println!("倒數 5 秒內請點進記事本視窗，之後不用做任何事。");
+ for i in (1..=5u64).rev() {
+ print!(" {i}...");
+ std::io::stdout().flush().ok();
+ thread::sleep(Duration::from_secs(1));
+ }
+ println!();
+
+ unsafe {
+ let hwnd = GetForegroundWindow();
+ let mut buf = [0u16; 256];
+ let len = GetClassNameW(hwnd, buf.as_mut_ptr(), buf.len() as i32);
+ let class = String::from_utf16_lossy(&buf[..len.max(0) as usize]);
+ let tid = GetWindowThreadProcessId(hwnd, std::ptr::null_mut());
+ let hkl = GetKeyboardLayout(tid) as usize;
+ let ime_wnd = ImmGetDefaultIMEWnd(hwnd);
+ println!("前景視窗 class={class:?} HKL={hkl:#010x} ime_wnd={ime_wnd:?}");
+
+ let conv_before = ime_msg(ime_wnd, IMC_GETCONVERSIONMODE, 0);
+ let open_before = ime_msg(ime_wnd, IMC_GETOPENSTATUS, 0);
+ println!("讀取: conv={conv_before:?} open={open_before:?}");
+
+ let conv = conv_before.unwrap_or(0);
+ let r1 = ime_msg(
+ ime_wnd,
+ IMC_SETCONVERSIONMODE,
+ (conv | IME_CMODE_NATIVE) as LPARAM,
+ );
+ let r2 = ime_msg(ime_wnd, IMC_SETOPENSTATUS, 1);
+ println!("設定: SETCONVERSIONMODE={r1:?} SETOPENSTATUS={r2:?}");
+
+ thread::sleep(Duration::from_millis(500));
+ let conv_after = ime_msg(ime_wnd, IMC_GETCONVERSIONMODE, 0);
+ let open_after = ime_msg(ime_wnd, IMC_GETOPENSTATUS, 0);
+ println!("讀回: conv={conv_after:?} open={open_after:?}");
+
+ let message_method_worked = match (conv_before, conv_after) {
+ (Some(b), Some(a)) => (b & IME_CMODE_NATIVE) == 0 && (a & IME_CMODE_NATIVE) != 0,
+ _ => false,
+ };
+
+ if message_method_worked {
+ println!("結果: 訊息法看起來有效，未注入 Shift。");
+ } else {
+ println!("結果: 訊息法無效或讀不到，3 秒後注入 Shift 作為備案...");
+ thread::sleep(Duration::from_secs(3));
+ inject_shift();
+ thread::sleep(Duration::from_millis(500));
+ let conv_final = ime_msg(ime_wnd, IMC_GETCONVERSIONMODE, 0);
+ println!("Shift 注入後讀回: conv={conv_final:?}");
+ }
+ }
+
+ println!();
+ println!(">>> 現在請看右下角語言列：是「中」還是「英」？ <<<");
+ println!("把這個答案＋上面全部輸出貼回給我。15 秒後自動關閉...");
+ thread::sleep(Duration::from_secs(15));
+}
+
+#[cfg(not(windows))]
+fn main() {
+ eprintln!("Windows only");
+}
diff --git a/install.ps1 b/install.ps1
index ac5b704..b6c09ac 100644
--- a/install.ps1
+++ b/install.ps1
@@ -1,11 +1,12 @@
#!/usr/bin/env pwsh
# Migao Windows Installer / Uninstaller
#
-# Install: irm https://raw.githubusercontent.com/winterdrive/migao/main/install.ps1 | iex
-# Uninstall: & ([scriptblock]::Create((irm https://raw.githubusercontent.com/winterdrive/migao/main/install.ps1))) -Uninstall
-# (or: .\install.ps1 -Uninstall)
+# Install (latest): irm https://raw.githubusercontent.com/winterdrive/migao/main/install.ps1 | iex
+# Install (pre-release): & ([scriptblock]::Create((irm https://raw.githubusercontent.com/winterdrive/migao/main/install.ps1))) -Prerelease
+# Uninstall: & ([scriptblock]::Create((irm https://raw.githubusercontent.com/winterdrive/migao/main/install.ps1))) -Uninstall
+# (or: .\install.ps1 -Uninstall)
-param([switch]$Uninstall)
+param([switch]$Uninstall, [switch]$Prerelease)
$ErrorActionPreference = "Stop"
$repo = "winterdrive/migao"
@@ -127,7 +128,16 @@ Stop-MigaoWatch
$previousProgressPreference = $ProgressPreference
$ProgressPreference = "SilentlyContinue"
try {
- $release = Invoke-RestMethod "https://api.github.com/repos/$repo/releases/latest"
+ if ($Prerelease) {
+ $releases = Invoke-RestMethod "https://api.github.com/repos/$repo/releases"
+ $release = $releases | Where-Object { $_.prerelease -eq $true } | Select-Object -First 1
+ if (-not $release) {
+ Write-Error "No pre-release found. Check https://github.com/$repo/releases"
+ exit 1
+ }
+ } else {
+ $release = Invoke-RestMethod "https://api.github.com/repos/$repo/releases/latest"
+ }
} finally {
$ProgressPreference = $previousProgressPreference
}
diff --git a/src/bin/watch.rs b/src/bin/watch.rs
index a907259..7fef3cb 100644
--- a/src/bin/watch.rs
+++ b/src/bin/watch.rs
@@ -19,18 +19,25 @@ mod win {
use tray_icon::menu::{CheckMenuItem, Menu, MenuEvent, MenuItem, PredefinedMenuItem};
use tray_icon::{TrayIcon, TrayIconBuilder};
use winapi::shared::minwindef::TRUE;
+ use winapi::shared::windef::HWND;
use winapi::um::consoleapi::SetConsoleCtrlHandler;
use winapi::um::processthreadsapi::GetCurrentThreadId;
use winapi::um::wincon::{CTRL_BREAK_EVENT, CTRL_CLOSE_EVENT, CTRL_C_EVENT};
use winapi::um::winuser::{
- DispatchMessageW, GetClassNameW, GetForegroundWindow, GetMessageW, KillTimer,
- PostThreadMessageW, RegisterHotKey, SendInput, SetTimer, UnregisterHotKey, INPUT,
- KEYBDINPUT, KEYEVENTF_KEYUP, MOD_ALT, MOD_CONTROL, MSG, WM_APP, WM_HOTKEY, WM_QUIT,
- WM_TIMER,
+ DispatchMessageW, GetAsyncKeyState, GetClassNameW, GetForegroundWindow, GetKeyboardLayout,
+ GetKeyboardLayoutList, GetMessageW, GetWindowThreadProcessId, KillTimer, PostMessageW,
+ PostThreadMessageW, RegisterHotKey, SendInput, SendMessageTimeoutW, SetTimer,
+ UnregisterHotKey, INPUT, KEYBDINPUT, KEYEVENTF_KEYUP, MOD_ALT, MOD_CONTROL, MSG,
+ SMTO_ABORTIFHUNG, WM_APP, WM_HOTKEY, WM_INPUTLANGCHANGEREQUEST, WM_QUIT, WM_TIMER,
};
use winreg::enums::{HKEY_CURRENT_USER, KEY_READ, KEY_SET_VALUE};
use winreg::RegKey;
+ #[link(name = "imm32")]
+ extern "system" {
+ fn ImmGetDefaultIMEWnd(hwnd: HWND) -> HWND;
+ }
+
const HOTKEY_ID: i32 = 1;
const VK_R: u32 = 0x52;
const VK_CTRL: u16 = 0x11;
@@ -41,6 +48,15 @@ mod win {
const VK_Z: u16 = 0x5A;
const CYCLE_WINDOW: Duration = Duration::from_secs(3);
+ const VK_SHIFT: u16 = 0x10;
+
+ // IME mode switching after a correction (issue #1).
+ const LANGID_ZH_TW: usize = 0x0404;
+ const WM_IME_CONTROL: u32 = 0x0283;
+ const IMC_GETCONVERSIONMODE: usize = 0x0001;
+ const IMC_SETCONVERSIONMODE: usize = 0x0002;
+ const IMC_SETOPENSTATUS: usize = 0x0006;
+ const IME_CMODE_NATIVE: usize = 0x0001;
static MAIN_THREAD_ID: AtomicU32 = AtomicU32::new(0);
static PAUSED: AtomicBool = AtomicBool::new(false);
@@ -224,6 +240,99 @@ mod win {
}
}
+ /// Sends WM_IME_CONTROL to a default IME window with a timeout so an
+ /// unresponsive target can never hang the worker thread.
+ fn ime_msg(ime_wnd: HWND, cmd: usize, lparam: isize) -> Option {
+ let mut result: usize = 0;
+ let ok = unsafe {
+ SendMessageTimeoutW(
+ ime_wnd,
+ WM_IME_CONTROL,
+ cmd,
+ lparam,
+ SMTO_ABORTIFHUNG,
+ 500,
+ &mut result,
+ )
+ };
+ if ok == 0 {
+ None
+ } else {
+ Some(result)
+ }
+ }
+
+ /// Best-effort switch of the foreground window's input method back to
+ /// Chinese after a successful Bopomofo correction (issue #1).
+ ///
+ /// Layer 1: keyboard layout is not Chinese (user typed with ENG active)
+ /// → WM_INPUTLANGCHANGEREQUEST, the same mechanism as Win+Space.
+ /// Layer 2: MS Bopomofo active but in English mode → WM_IME_CONTROL on the
+ /// default IME window. The message is processed inside the target
+ /// process, so it works where ImmGetContext (process-local) cannot.
+ /// Layer 3: fallback blind Shift toggle. Safe direction: a correction just
+ /// succeeded, so the IME must have been in English mode. Waits for
+ /// the user to physically release Ctrl/Alt/R first — otherwise the
+ /// IME sees Ctrl+Alt+Shift and ignores the toggle.
+ fn switch_ime_to_chinese() {
+ unsafe {
+ let hwnd = GetForegroundWindow();
+ if hwnd.is_null() {
+ return;
+ }
+
+ // Layer 1: wrong keyboard layout entirely.
+ let tid = GetWindowThreadProcessId(hwnd, std::ptr::null_mut());
+ if (GetKeyboardLayout(tid) as usize) & 0xFFFF != LANGID_ZH_TW {
+ let n = GetKeyboardLayoutList(0, std::ptr::null_mut());
+ let mut layouts = vec![std::ptr::null_mut(); n.max(0) as usize];
+ let n = GetKeyboardLayoutList(n, layouts.as_mut_ptr());
+ if let Some(&hkl) = layouts[..n.max(0) as usize]
+ .iter()
+ .find(|&&h| (h as usize) & 0xFFFF == LANGID_ZH_TW)
+ {
+ PostMessageW(hwnd, WM_INPUTLANGCHANGEREQUEST, 0, hkl as isize);
+ }
+ return;
+ }
+
+ // Layer 2: Chinese IME active but in English mode.
+ let ime_wnd = ImmGetDefaultIMEWnd(hwnd);
+ if !ime_wnd.is_null() {
+ if let Some(conv) = ime_msg(ime_wnd, IMC_GETCONVERSIONMODE, 0) {
+ if conv & IME_CMODE_NATIVE != 0 {
+ return; // already in Chinese mode
+ }
+ ime_msg(
+ ime_wnd,
+ IMC_SETCONVERSIONMODE,
+ (conv | IME_CMODE_NATIVE) as isize,
+ );
+ ime_msg(ime_wnd, IMC_SETOPENSTATUS, 1);
+ if let Some(after) = ime_msg(ime_wnd, IMC_GETCONVERSIONMODE, 0) {
+ if after & IME_CMODE_NATIVE != 0 {
+ return; // verified switched
+ }
+ }
+ }
+ }
+
+ // Layer 3: blind Shift toggle, only after the hotkey keys are
+ // physically released.
+ let deadline = Instant::now() + Duration::from_millis(1500);
+ while [VK_CTRL as i32, VK_ALT as i32, VK_R as i32]
+ .iter()
+ .any(|&vk| GetAsyncKeyState(vk) as u16 & 0x8000 != 0)
+ {
+ if Instant::now() >= deadline {
+ return; // keys still held; give up rather than mis-toggle
+ }
+ thread::sleep(Duration::from_millis(20));
+ }
+ batch(&mut vec![ki(VK_SHIFT, 0), ki(VK_SHIFT, KEYEVENTF_KEYUP)]);
+ }
+ }
+
fn paste(clipboard: &mut arboard::Clipboard, text: &str) -> bool {
if clipboard.set_text(text).is_err() {
return false;
@@ -347,6 +456,9 @@ mod win {
);
if paste(clipboard, &candidates[0]) {
+ if ime == "bopomofo-daqian" {
+ switch_ime_to_chinese();
+ }
let orig = truncate(&text, 25);
let fixed = truncate(&candidates[0], 25);
let summary = format!("{orig} → {fixed}");
@@ -395,6 +507,9 @@ mod win {
}
// ── Tray icon ────────────────────────────────────────────────────────
+ let version_item =
+ MenuItem::new(format!("migao v{}", env!("CARGO_PKG_VERSION")), false, None);
+ let sep_top = PredefinedMenuItem::separator();
let pause_item = MenuItem::new("Pause", true, None);
let login_item = CheckMenuItem::new("Launch at Login", true, is_autostart_enabled(), None);
let update_item = MenuItem::new("Check for Updates", true, None);
@@ -403,6 +518,8 @@ mod win {
let sep = PredefinedMenuItem::separator();
let menu = Menu::new();
menu.append_items(&[
+ &version_item,
+ &sep_top,
&pause_item,
&login_item,
&update_item,