Adrafinil: Ngăn Chặn macOS Ngủ Đông Thông Minh Theo Tác Nhân AI 💡
Bạn là người dùng MacBook và thường xuyên làm việc với các "trợ lý" AI lập trình? Chắc hẳn bạn đã từng khó chịu khi máy đi vào giấc ngủ sâu trong lúc một tác nhân AI đang miệt mài xử lý mã hoặc chạy một tác vụ dài. Giờ đây, một giải pháp mã nguồn mở mang tên Adrafinil đã xuất hiện để khắc phục vấn đề này một cách thông minh và hiệu quả! ✨
Adrafinil là một ứng dụng trên thanh menu macOS, được thiết kế đặc biệt để giữ cho MacBook của bạn luôn "thức tỉnh" – chỉ khi một tác nhân AI lập trình đang hoạt động. Điều này bao gồm cả chế độ vỏ sò (clamshell mode) khi bạn gập máy. Đây là một bước tiến vượt trội so với các tiện ích truyền thống như caffeinate hay Amphetamine, vốn thường giữ máy luôn bật mà không xét đến trạng thái làm việc thực tế.
Như một "eugeroic" (chất thúc đẩy sự tỉnh táo) cho máy móc, Adrafinil chỉ ngăn Mac ngủ khi có một phiên làm việc của tác nhân AI đang hoạt động. Ngay khi công việc hoàn tất, máy sẽ trở lại hành vi ngủ bình thường. Thật thông minh và tiết kiệm năng lượng! 🔋
* Nhà phát triển: @kageroumado / kagerou.glass * Giấy phép: MIT * Ngôn ngữ: Swift (100%)
---
Các Tính Năng Nổi Bật của Adrafinil 🌟
Adrafinil không chỉ đơn thuần là một công cụ chống ngủ. Nó mang đến hàng loạt tính năng được thiết kế tinh vi để tối ưu hóa trải nghiệm làm việc với AI trên macOS:
* Ngăn Ngủ Theo Tác Nhân (Agent-Aware Sleep Prevention): Tính năng cốt lõi. Mac chỉ thức khi có ít nhất một phiên tác nhân đang hoạt động. Khi không có tác vụ nào, bạn có thể gập máy và nó sẽ ngủ như bình thường. Đây là điểm khác biệt lớn nhất! ✅ * Tích Hợp Sẵn Sàng (Out-of-the-Box Integration): Với một cú nhấp chuột, Adrafinil có thể tích hợp vào hệ thống móc nối (hook systems) của 9 tác nhân AI phổ biến: Claude Code, Codex, Cursor, Gemini CLI, Aider, Hermes, OpenCode, Cline và Pi. Sự tiện lợi là tuyệt đối. 🚀 * Giao Diện Dòng Lệnh Nhanh Chóng (<50ms CLI): Các lệnh adrafinil acquire và release có thời gian phản hồi chưa đến 50ms, đảm bảo quy trình làm việc của tác nhân không bị gián đoạn. Tốc độ là yếu tố then chốt! ⚡ * Quản Lý Ngăn Ngủ Theo Tham Chiếu (Reference-Counted Assertions): Các phiên làm việc của tác nhân chồng chéo sẽ được quản lý gọn gàng. Mac chỉ được phép ngủ khi phiên làm việc cuối cùng giải phóng yêu cầu ngăn ngủ của nó. 🔢 * Cơ Chế An Toàn Chống Quá Nhiệt (Thermal Cutout Safeguard): Nếu nhiệt độ bên ngoài hoặc CPU của Mac vượt ngưỡng an toàn khi gập máy, tất cả các yêu cầu ngăn ngủ sẽ bị buộc giải phóng để tránh tình trạng quá nhiệt trong túi xách. An toàn là trên hết! 🔥 * Tự Động Giải Phóng Khi Rảnh Rỗi (Idle Release): Tự động hủy yêu cầu ngăn ngủ nếu tiến trình sở hữu bị tắt hoặc không hoạt động CPU trong một khoảng thời gian nhất định. Tiết kiệm năng lượng tối đa. ⏰ * Phát Hiện Tiến Trình (Tùy chọn - Process Sniffing): Trình nền (daemon) có thể tự động nhận diện các yêu cầu ngăn ngủ bằng cách phát hiện các tệp nhị phân của tác nhân đã biết đang chạy, ngay cả khi chưa cài đặt móc nối rõ ràng. Linh hoạt hơn rất nhiều! 🕵️ * Âm Thanh Khi Gập Máy & Tóm Tắt Khi Mở Máy (Lid-Close Audio & Lid-Open Summary): Phát âm báo khi bạn gập máy để xác nhận yêu cầu ngăn ngủ đang hoạt động (vì màn hình đã tắt). Đồng thời, hiển thị bản tóm tắt khi mở máy trở lại, cho biết những gì đã chạy khi bạn vắng mặt, nhiệt độ cao nhất và liệu cơ chế chống quá nhiệt có được kích hoạt hay không. Trải nghiệm người dùng được nâng cao rõ rệt! 🔔📊
---
Adrafinil Hoạt Động Như Thế Nào? 🤔
Các tác nhân AI không giao tiếp trực tiếp với Adrafinil. Thay vào đó, hệ thống móc nối của chúng sẽ gọi tiện ích CLI được đóng gói cùng với Adrafinil. Điều đặc biệt là các yêu cầu giữ máy (holds) được định nghĩa theo phạm vi hoạt động (activity-scoped), chứ không phải theo phạm vi phiên (session-scoped). Ví dụ, Claude Code sẽ gửi yêu cầu "acquire" khi UserPromptSubmit và "release" khi Stop. Điều này đảm bảo MacBook có thể ngủ bình thường nếu một phiên tác nhân đang mở nhưng ở trạng thái chờ lệnh.
Các Lệnh CLI Cơ Bản
Để Yêu Cầu và Giải Phóng Ngăn Ngủ:
```bash # Gọi khi một lượt làm việc của tác nhân bắt đầu adrafinil acquire --tool claude-code --reason "long build"
Gọi khi tác nhân trở nên rảnh rỗi
adrafinil release ```
Giữ Máy Theo Thời Gian & Hỗ Trợ MCP:
Một tác nhân cũng có thể giữ máy thức cho các tác vụ nền (như build hoặc triển khai kéo dài) bằng cách sử dụng chế độ giữ theo thời gian hoặc qua Giao thức Ngữ cảnh Mô hình (Model Context Protocol - MCP):
```bash # Giữ máy thức tối đa 30 phút, sau đó tự động giải phóng adrafinil hold --for 30m --reason "deploy"
Giao tiếp qua Giao thức Ngữ cảnh Mô hình trên stdio cho các tác nhân hỗ trợ MCP
adrafinil mcp ```
---
Kiến Trúc Đằng Sau Adrafinil 🏗️
Để đảm bảo sự ổn định và an toàn, Adrafinil được chia thành bốn sản phẩm trên ba cấp độ đặc quyền khác nhau. Cách tiếp cận này giúp cô lập quyền kiểm soát ngủ ở cấp độ root khỏi logic chính sách, tăng cường bảo mật và hiệu suất:
1. Adrafinil.app (ứng dụng trên thanh menu, giao diện người dùng): Hiển thị trạng thái, cài đặt, giao diện cài đặt và tóm tắt khi mở máy. 2. AdrafinilDaemon (LaunchAgent, chạy dưới quyền người dùng, luôn bật): Quản lý đăng ký yêu cầu ngăn ngủ theo tham chiếu, giám sát tiến trình, giám sát nhiệt độ (SMC), giám sát trạng thái gập máy (IORegistry) và âm báo khi gập máy. 3. AdrafinilHelper (SMAppService LaunchDaemon, chạy dưới quyền root): LÀ THÀNH PHẦN DUY NHẤT chạm vào các API chặn ngủ, đồng thời xác minh yêu cầu ký mã của bên gọi. 4. adrafinil CLI (Giao diện dòng lệnh, nằm trong .app, được liên kết vào PATH): Kết nối đến socket của daemon với thời gian phản hồi dưới 50ms.
---