auto-enter (AI 掛機送出器) 🚀

這是一個專門用來對付 AI Agent 頻率限制（例如：5 小時冷卻時間）的深夜掛機工具。

無需安裝 Python、無需安裝 C++ 編譯環境、也無需手動下載任何專案檔案。只要你的環境有 Node.js，睡前一行 npx 指令即可進入極速倒數。

🕒 這是為了解決什麼？

當你深夜高強度使用 AI Agent（如 Claude Code 或各類開發工具）觸發了平台的頻率限制，提示你 「5 小時後才能繼續對話」，但你想去睡覺了。

使用本工具，你可以：

1. 先在終端機或網頁輸入框裡把下一個 Prompt 完整打好（先不要按 Enter）。
2. 一行指令啟動 npx auto-enter，精準設定 5 小時後的解禁時間。
3. 將滑鼠游標點擊留在 AI 的輸入框內（保持 Focus），然後直接去睡覺。
4. 本工具會依據你的作業系統，自動從 GitHub Release 抓取預編譯好的 Python 原生實體鍵盤驅動（PyInstaller 封裝），並在半夜時間到時自動幫你按下 Enter 送出。隔天早上醒來，直接收割 AI 跑完的成果！

💡 睡前檢查清單（友善提醒）

• 確認切換至 Auto / Bypass 模式：送出前請檢查 CLI 指令或環境是否已切換至 auto mode、bypass mode。確保 AI 啟動後會一路自動執行，不會中途停下來等待確認 (y/n)。
• 建議在安全環境下執行：由於執行的是全自動模式，建議此操作在 Dev Container、Docker 容器或獨立的 Sandbox 等隔離環境中掛機跑，確保本地主機安全。

🚀 參數使用說明

本工具完全支援 CLI 參數，讓你一行指令直接進入倒數：

1. 設定相對時間（最常用 ⏳）

直接指定幾小時或幾分鐘後觸發：

# 5 小時後自動按 Enter
npx auto-enter --delay 5h
npx auto-enter -d 5h

# 45 分鐘後自動按 Enter
npx auto-enter -d 45m

2. 設定絕對時間（精準對時 ⏰）

直接指定半夜某個精準的時間點（若時間已過，系統會聰明地自動判定為隔天）：

# 在凌晨 03:15:00 精準觸發
npx auto-enter --time 03:15:00
npx auto-enter -t 03:15:00

# 支援完整日期格式
npx auto-enter -t "2026-06-30 15:00:00"

🎯 深夜躺平三步驟

1. 根據你的冷卻時間，執行上方任意一條 npx auto-enter 指令。
2. 【最重要的一步】：把滑鼠移到你的 AI 輸入框，點一下左鍵，讓游標在裡面閃爍（維持 Focus 狀態）。
3. 關掉螢幕，安心去睡覺！

⚠️ 掛機注意事項

• 千萬別亂動滑鼠：因為工具是觸發作業系統的實體鍵盤訊號，如果時間到之前你動了電腦或切換了視窗，Enter 訊號就會按到別的地方去。
• 關閉螢幕休眠：請確保你的電腦在掛機期間不會進入睡眠（Sleep）或休眠（Hibernate）模式。螢幕可以關閉，但主機必須保持喚醒狀態，否則背景倒數腳本會暫停。

🛠 底層技術架構

本工具採用雙流派黃金組合：

• 前端分發：透過 npx 達到零安裝、零配置、跨平台的極速啟動體驗。
• 後端驅動：透過 GitHub Actions CI/CD 在多平台（Windows / macOS / Ubuntu）實體機上，利用 PyInstaller 將老牌最穩定的 pyautogui 硬體訊號庫預先編譯為單一執行檔。執行時會自動識別 OS 並無感下載，保證 100% 的原生按鍵觸發率。

🍏 macOS 🚨 重要掛機提醒（必看）

由於此工具底層使用模擬鍵盤與滑鼠事件，在 macOS 系統上執行時，必須授予終端機 「輔助使用 (Accessibility)」 的權限。

⚠️ 醒目警語： 請在掛機去睡覺前務必先執行一次並完成權限設定！否則一早睡醒，你只會看到 macOS 的權限提示彈窗尷尬地卡在那裡。

🛠️ 如何手動授權：

1. 打開 Mac 的 「系統設定」 (System Settings)。
2. 進入 「隱私權與安全性」 (Privacy & Security) ➔ 「輔助使用」 (Accessibility)。
3. 將你正在使用的終端機（例如 Terminal、iTerm2 或 VS Code）勾選為 允許（開啟）。

💡 終極務實建議： 強烈建議在正式掛機前，先用極短的延遲（例如 --delay 5s）在本地完整跑完一次測試。親眼確認終端機成功觸發按鍵、且沒有跳出任何 macOS 權限阻攔後，再換上真正需要的長時間參數（例如 --delay 30m）安心去睡覺！