v1.0.0

Bản phát hành đầu tiên của PrintAgent.

npm install -g @hyydev/printagent
printagent start

Có gì

• Bốn cách điều khiển: REST API, WebSocket, MCP (HTTP và stdio), web UI.
• In PDF thẳng từ base64, URL hoặc upload multipart; hoặc template Handlebars + biến JSON rồi tự render PDF phía agent.
• 6 mẫu chuẩn Việt Nam: hoá đơn GTGT A4, hoá đơn máy tính tiền 80mm, phiếu thu 01-TT, bill nhiệt, ESC/POS raw.
• Quét máy in trên CUPS (macOS/Linux) và Windows, đặt máy in mặc định, in trang thử.
• Tunnel Cloudflare (quick và named) hoặc ngrok, có xác minh hostname bằng nonce.
• One-click setup cross-platform, tự cài Node LTS qua nvm nếu thiếu, đăng ký chạy nền theo launchd/systemd/Task Scheduler.
• Song ngữ đầy đủ tiếng Việt và tiếng Anh cho UI, lỗi API, CLI và tài liệu.
• Tài liệu cho tác nhân AI: /.well-known/printagent.json, /openapi.json, /llms.txt.

Bảo mật

Ngoại lệ miễn API key cho máy local đòi thoả đồng thời bốn điều kiện độc lập (địa chỉ loopback, Host loopback, không có header proxy, Sec-Fetch-Site same-origin/none), nên request qua tunnel hay do một website khác khởi tạo đều không lọt. Sai key 10 lần trong một phút thì bị chặn 5 phút, tính chung cho REST và WebSocket. Tunnel không bật được khi chưa bật xác thực hoặc chưa có key nào.