AutoHotkey v2 lightweight TypeItIn tool
  • AutoHotkey 100%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-10-13 08:41:18 +00:00
Lib fix: switch to SendInput, fix speed 0 recognition, hide on close, and adjust window height 2026-10-13 08:41:18 +00:00
.gitignore feat: migrate config storage to AppData with auto-creation, portable support, and gitignore 2026-10-13 06:52:22 +00:00
quickey.ico feat: add lightning icon, track mouse leave to clear hints, auto-cancel dialogs on blur, and 1px border with close hover 2026-10-13 06:42:14 +00:00
README.md feat: add alert macro, brace auto-escaping, user-friendly default presets, and remove runtime icon config 2026-10-13 08:09:59 +00:00
TypeItIn.ahk feat: add alert macro, brace auto-escaping, user-friendly default presets, and remove runtime icon config 2026-10-13 08:09:59 +00:00

QuicKey (ASML_typeit) - 輕量化 AHKv2 浮動自動輸入工具列

專為提高日常文字輸入與表單自動化效率而設計的輕量級 AutoHotkey v2 浮動工具列(以 TypeItIn 原型為藍本重新架構設計)。具備自由拖曳、智慧焦點恢復、視窗標題監控、巢狀剪貼簿貼上、多螢幕座標保護與直覺按鈕編輯器。


🌟 核心功能特色

  1. 精巧浮動工具列 (Floating ToolWindow)

    • 110px 緊湊垂直懸浮工具列,+AlwaysOnTop -Caption +ToolWindow。
    • 文字溢出保護:按鈕文字過長時自動截斷並補上「…」,滑鼠移至按鈕上方 (ToolTip) 會顯示完整按鈕標題與提示文字。
    • 安全預設按鈕:群組預設按鈕命名為「ℹ️ 使用說明」,點擊時彈出教學導引對話框,絕不誤向您的工作視窗輸入文字。
    • 多螢幕自適應:自動偵測多螢幕工作區,若拔除外接螢幕導致座標超出可視範圍,自動回彈至主螢幕右上角。
    • 閒置自動淡出:無操作 10 秒後平滑淡出至透明度 200,滑鼠移入或點擊瞬間喚醒。
  2. 智慧焦點恢復與極速輸入 (MacroEngine)

    • 點擊按鈕時自動還原前一個焦點視窗,並以 SendInput 極速打字。
    • 🚨 Esc 緊急中斷:執行長延遲或多步驟巨集時,隨時按住 Esc 鍵即可立即中斷終止輸入!
    • 換行策略:文字中的普通物理換行在執行時會自動忽略,只有明確含有 {enter} 標籤時才會觸發實質換行。
    • 巢狀貼上語法 {paste ...}:支援巢狀語法(如 {paste 今日報告:{date:yyyy-MM-dd},剪貼簿:{clip}}),透過暫存剪貼簿瞬間貼出並安全還原原剪貼簿歷史。
    • 外部應用程式與網址啟動 {run ...}:支援一鍵開啟外部程式或網址(如 {run https://www.google.com})。
    • 豐富組合鍵支援:支援各類複合按鍵(如 {ctrl+c}、{ctrl+v}、{alt+f4}、{win+r} 等)。
  3. 支援的巨集標籤語法

    • {enter}、{tab}、{esc}、{delete}、{backspace}、{home}、{end}、{pgup}、{pgdn}、{up}、{down}、{left}、{right}
    • {f1} ~ {f12}:功能鍵
    • {ctrl+c}、{ctrl+v}、{alt+f4}、{win+r} 等複合按鍵
    • {click x, y}、{rclick x, y}、{mclick x, y}、{wheelup}、{wheeldown}:滑鼠操作
    • {run 網址或指令}:啟動外部應用程式或網址
    • {alert:提示訊息}:彈出說明或警示訊息框(安全防護,點擊確定後關閉,不向目標視窗亂打字)
    • {{ 輸出 {、}} 輸出 },或使用 {lbrace} 與 {rbrace} 輸出字面大括弧(編輯器支援貼上/輸入智慧自動轉義)
    • {paste ...}:以暫存剪貼簿快速貼出內容(支援內部巢狀標籤)
    • {clip}:當前剪貼簿內容
    • {date:格式}:格式化日期(預設 yyyy-MM-dd)
    • {time:格式}:格式化時間(預設 HH:mm:ss)
    • {delay 毫秒}:暫停等待指定毫秒數(按住 Esc 可中斷)
    • {speed 毫秒}:動態調整打字延遲間隔(預設 12ms,{speed 0} 為極速,遇掉字可設 {speed 20})
    • {input:提示文字|預設值}:彈出輸入框由使用者動態填寫
  4. 專業按鈕編輯器 (GuiEditor)

    • 字體清晰升級:巨集編輯框採用 Consolas s12 高清晰度等寬程式碼字型,標籤與輸入項為 s10。
    • 左側扁平化巨集清單:條列所有常用巨集模板,單擊項目即時於底部狀態列顯示詳細用法說明與範例,雙擊直接插入游標處。
    • 全按鍵攔截模式 (Type Special Keys):
      • 開啟時:全面攔截功能鍵(Enter、Delete、Backspace、Insert、Home、End、PageUp/Down、方向鍵、Esc、Tab、F1~F12)直接轉為巨集標籤;同時保留 Ctrl+A/C/V/Z 以便於文字選取與複製。
      • 關閉時:按 Enter 鍵會同時插入 {enter} 與真實換行(\r\n),方便閱讀排版。
    • 底部動態提示列(Status Bar)與「❓ Help」語法指南。
  5. 視窗標題監控與自動切換 (WindowMonitor)

    • 右鍵點擊群組下拉選單選擇「🪟 Monitor Window」,引導點擊目標程式視窗完成綁定。
    • 背景即時監控使用中視窗標題,自動切換至對應的按鈕群組。
  6. 群組密碼保護 (Password Protection)

    • 支援為個別群組設定密碼保護(SHA-256 雜湊儲存於 config.json)。
    • 切換至該群組時需輸入密碼驗證解鎖。
    • 匯出設定檔時自動排除受密碼保護的群組,確保敏感資料安全。
  7. 右鍵選單操作

    • 群組選單 (下拉選單右鍵):
      • 🟢 New Group / ✏️ Edit Group / ❌ Delete Group
      • 🔤 Sort Buttons (A-Z 排序)
      • 🪟 Monitor Window / ⏹️ Cancel Monitoring
      • 🔒 Password Protect / 🔓 Remove Password
    • 按鈕選單 (按鈕右鍵):
      • 🟢 New Button / ✏️ Edit Button / ❌ Delete Button
      • 📋 Copy to Group (複製至其他群組)
      • 📂 Move to Group (移動至其他群組)
    • 系統托盤選單 (右鍵工作列圖示):
      • 🌐 語言切換 / Language (English / 繁體中文)
      • 開機自動啟動
      • 匯出設定檔 (自動過濾密碼群組)
      • 匯入設定檔
      • 顯示 / 置頂 QuicKey
      • 關於 QuicKey (About QuicKey)
      • 重新載入腳本 / 結束程式
  8. 雙語多國語系 (Bilingual I18n)

    • 支援繁體中文與 English 完整雙語切換,涵蓋所有功能選單、編輯器、說明提示與系統彈窗。
    • 透過托盤圖示「🌐 Language / 語言」一鍵無縫切換,設定自動記憶。

📁 檔案結構與設定檔路徑

  • 個人設定檔路徑:預設自動儲存於 %AppData%\QuicKey\config.json(已加入 .gitignore 避免外流個人資料)。若同目錄下存在 config.json 則優先讀取(自動切換為 Portable 免安裝模式)。首次啟動若無設定檔,系統將自動於 AppData 建立包含實用範例的預設設定。
ASML_typeit/
├── TypeItIn.ahk              # 主入口程式 (托盤、多國語言切換、特殊鍵勾點、視窗監控)
├── quickey.ico               # 專屬高解析度閃電圖標 (Ahk2Exe 編譯打包 EXE 專用)
├── README.md                 # 專案說明文件
└── Lib/
    ├── I18n.ahk              # 多國語言字典 (繁體中文/English) 與語系切換管理
    ├── Config.ahk            # 設定讀寫 (AppData/Portable)、群組/按鈕管理、密碼雜湊、多螢幕防呆
    ├── GuiMain.ahk           # QuicKey 浮動主視窗 (w110)、淡出淡入、文字截斷、防誤觸、游標捕捉
    ├── GuiEditor.ahk         # 按鈕編輯器介面 (Consolas s12)、巨集清單、特殊鍵攔截、語法檢查
    ├── MacroEngine.ahk       # 巨集解析引擎、穩定模式 (SendEvent 12ms)、{speed} 調速、Esc 緊急中斷
    ├── WindowMonitor.ahk     # 視窗監控導引精靈、失焦自動取消、標題比對
    └── JSON.ahk              # 純 AHK v2 JSON 解析與序列化器

💻 執行需求


Developed by yumi.lin@asml.com using AI