Unicode 文字輸入(emoji / CJK)

write 透過平台虛擬鍵表輸入,對任何不在表內的字元會*拋例外*——emoji、CJK、許多重音字母——因此無法以正常 途徑輸入非 ASCII 文字。可靠的跨平台輸入任意 Unicode 的方法,是將其放上剪貼簿再貼上。

plan_paste() 建立決定性操作計畫,:func:unicode_code_units 將文字拆成 UTF-16 碼元(供能做 KEYEVENTF_UNICODE 的後端使用);兩者皆為純函式、可單元測試。type_unicode() 透過可注入的 sink 派發貼上計畫,因此可在不觸碰真實剪貼簿下測試。不匯入 PySide6。

無頭 API

from je_auto_control import type_unicode, plan_paste, unicode_code_units

type_unicode("café 🚀 値")              # 設定剪貼簿 + Ctrl+V
type_unicode("値", modifier="command")  # macOS

unicode_code_units("🚀")               # [0xD83D, 0xDE80](代理對)
plan_paste("hi")
# [{'op': 'set_clipboard', 'text': 'hi'},
#  {'op': 'hotkey', 'keys': ['ctrl', 'v']}]

type_unicode 將剪貼簿設為該文字並送出貼上熱鍵(modifier 預設 "ctrl";macOS 用 "command"), 因此無論鍵盤配置都能輸入*任何*文字——emoji、CJK、RTL、重音。它回傳派發的計畫加上 UTF-16 碼元數。 unicode_code_units 供想直接注入碼元的後端使用。

執行器命令

AC_type_unicode 接受 text 與選用的 modifier,並回傳 {ops, plan, code_units}。它以 MCP 工具 ac_type_unicode 以及 Script Builder 中 Keyboard 分類下的命令提供。