Tài liệu

Cài đặt

Tải gói phù hợp với distro của bạn ở trang tải về:

• Ubuntu, Debian, Mint, Pop!_OS: sudo apt install ./QuickDesk_<phiên-bản>_amd64.deb
• Fedora, openSUSE: sudo dnf install ./QuickDesk-<phiên-bản>-1.x86_64.rpm
• Distro khác: cho file AppImage quyền chạy rồi mở nó. Cần FUSE 2 (libfuse2, trên Ubuntu 24.04 là libfuse2t64).

QuickDesk cần máy x86_64 đời vài năm gần đây (glibc 2.34 trở lên). Chạy tốt nhất trên GNOME, cả Wayland lẫn X11.

Lần mở đầu tiên, màn hình chào hiện danh sách phím tắt và hai lựa chọn: tự chạy khi đăng nhập (cần để lịch sử clipboard và vòng tròn AI luôn hoạt động) và dán tức thì (xem Tự động dán). Sau đó QuickDesk nằm trên thanh trên cùng.

Phím tắt

Bấm lại phím tắt khi cửa sổ đang mở là đóng nó. Đổi phím trong Cài đặt → Phím tắt; QuickDesk sẽ báo nếu tổ hợp đã bị dùng.

Trên GNOME, phím tắt được thêm vào Settings → Keyboard → Custom Shortcuts và gỡ đi khi thoát QuickDesk, nên chạy được cả trên Wayland. Trên desktop khác, hãy gán quickdesk toggle notes, quickdesk toggle clipboard, quickdesk toggle ports hoặc quickdesk toggle quick-note vào phím trong cài đặt bàn phím.

Sao lại là Super + Alt? Bộ gõ tiếng Việt như Unikey, Bamboo nuốt mất Super + Shift + chữ khi bạn đang gõ trong ô nhập; tổ hợp có Alt thì vẫn chạy.

Ghi chú

Ghi chú dùng Markdown với trình soạn đầy đủ: tiêu đề, in đậm và nghiêng, danh sách, checklist, trích dẫn, khối code. Ctrl N để viết ghi chú mới, Ctrl S để lưu, Ctrl F để tìm. Tìm kiếm không cần dấu: gõ tieng viet vẫn ra “tiếng Việt”.

Bấm ngôi sao để ghim ghi chú lên đầu. Xoá sẽ hỏi trước và có thể hoàn tác trong vài giây.

Đồng bộ ghi chú giữa các máy

Không có tài khoản hay server QuickDesk. Ghi chú đồng bộ qua một bucket lưu trữ do chính bạn sở hữu: Cloudflare R2 (gói miễn phí là đủ), AWS S3 hoặc MinIO.

1. Tạo bucket và một API token chỉ có quyền trên bucket đó (R2: R2 → Manage R2 API Tokens → Object Read & Write).
2. Trong Cài đặt → Đồng bộ, nhập endpoint (R2: https://<account-id>.r2.cloudflarestorage.com), bucket, region (auto với R2), access key và secret.
3. Trên máy đầu tiên, đặt một passphrase. QuickDesk sẽ hiện recovery key: hãy cất ở nơi an toàn.
4. Trên các máy khác, kết nối vào cùng bucket và nhập cùng passphrase (hoặc recovery key).

Ghi chú được mã hoá trên máy trước khi tải lên (XChaCha20-Poly1305, khoá sinh từ passphrase bằng Argon2id); bucket chỉ chứa dữ liệu đã mã hoá. Secret key của bucket nằm trong keyring của hệ thống. Chỉnh sửa lúc mất mạng sẽ đồng bộ khi có mạng lại; nếu một ghi chú bị sửa cùng lúc trên hai máy, cả hai bản đều được giữ.

Lịch sử clipboard

Mọi thứ bạn copy đều được lưu: chữ, ảnh (ảnh chụp màn hình) và file copy từ trình quản lý file. Mở popup bằng Super Alt V, gõ để tìm, lọc theo Chữ, Ảnh hoặc File, rồi bấm Enter để dán vào app bạn đang dùng. Ctrl Enter chỉ copy, Ctrl P để ghim, Del để xoá.

• Lịch sử chỉ nằm trên máy này, không bao giờ đồng bộ.
• Mục copy được trình quản lý mật khẩu đánh dấu bí mật sẽ bị bỏ qua. Trước khi copy thứ nhạy cảm, hãy tạm dừng lưu 15 phút, 1 giờ hoặc tới khi bật lại (trong tab Clipboard hoặc menu trên khay hệ thống).
• QuickDesk giữ 1.000 mục gần nhất; mục đã ghim được giữ mãi. Chữ tối đa 1 MB, ảnh tối đa 10 MB mỗi ảnh và 200 MB tổng cộng.
• Xoá lịch sử… trong tab Clipboard xoá hết, trừ các mục đã ghim.

Tự động dán

Khi bạn chọn một mục, QuickDesk quay lại app bạn đang dùng và bấm Shift Insert, chạy được cả trong terminal. Chọn cách dán trong Cài đặt → Tự động dán:

• Portal của desktop (mặc định): GNOME hỏi quyền một lần và hiện biểu tượng điều khiển từ xa trong lúc dán.
• Tức thì (bàn phím ảo): không hỏi, không hiện biểu tượng. Lúc bật sẽ hỏi mật khẩu quản trị một lần để cho phép chương trình của bạn tạo bàn phím ảo (cùng quyền Steam dùng cho tay cầm).

Tắt tự động dán trong tab Clipboard nếu chỉ muốn copy, rồi tự bấm Ctrl V.

Cổng

Super Alt P liệt kê mọi cổng TCP đang lắng nghe (IPv4 và IPv6) cùng tiến trình, dòng lệnh đầy đủ và user, làm mới mỗi 2 giây. Lọc theo cổng, PID, tiến trình hoặc tên container.

• Open mở http://localhost:<cổng> trên trình duyệt; Copy PID và Copy cmd để copy.
• Kill hỏi trước, dừng tiến trình nhẹ nhàng và chỉ đề nghị force kill khi nó không chịu thoát.
• Cổng do Docker mở hiện tên container và image, và Stop dừng container thay vì kill docker-proxy.
• Tiến trình của user khác (dịch vụ hệ thống) hiện dạng ẩn; xem chi tiết cần quyền root.

Usage AI

Một vòng tròn trên thanh trên cùng cho biết bạn đã dùng bao nhiêu hạn mức AI, đổi màu xanh, cam hoặc đỏ. Menu của nó liệt kê từng hạn mức và lúc đặt lại; tab AI có chi tiết.

• Claude Code: QuickDesk đọc phiên đăng nhập Claude Code đã lưu trên máy và hỏi Anthropic số liệu usage, tối đa mỗi 5 phút một lần. Token chỉ được đọc: không lưu lại, không làm mới và không gửi đi đâu ngoài Anthropic.
• Codex: đọc từ log phiên làm việc Codex lưu trong ~/.codex.
• Gemini (Antigravity): không báo phần trăm, nên QuickDesk hiện lần cuối bạn hết quota, lấy từ log của nó.

Chọn hạn mức mà vòng tròn theo dõi trong Vòng tròn hiển thị, hoặc ẩn vòng tròn trong tab AI.

Cập nhật

QuickDesk kiểm tra bản mới 30 giây sau khi khởi động, rồi cứ mỗi 6 giờ. Khi có bản mới, banner trong cửa sổ chính và một mục ở đầu menu khay hệ thống sẽ báo, kèm Có gì mới. Không có gì được cài cho tới khi bạn bấm Cập nhật ngay.

Mỗi bản cập nhật đều được kiểm tra chữ ký số của QuickDesk trước khi cài. Gói .deb hoặc .rpm sẽ hỏi mật khẩu quản trị; AppImage tự thay chính nó. Sau đó QuickDesk khởi động lại và cho bạn xem có gì thay đổi. Tắt tự động kiểm tra, hoặc tự kiểm tra, trong Cài đặt → Cập nhật.

Gỡ cài đặt

1. Tắt Tự chạy QuickDesk khi đăng nhập trong Cài đặt, rồi thoát app từ khay hệ thống.
2. Gỡ gói: sudo apt remove quick-desk (Debian/Ubuntu) hoặc sudo dnf remove QuickDesk (Fedora), hoặc xoá file AppImage.
3. Dữ liệu vẫn nằm trong ~/.local/share/click.quickdesk cho tới khi bạn xoá thư mục đó.

Gỡ gói cũng gỡ luôn quyền dán tức thì nếu bạn đã bật.

Khắc phục sự cố

• Phím tắt không có tác dụng: xem Settings → Keyboard → Custom Shortcuts có bị trùng không, hoặc chọn tổ hợp khác trong Cài đặt → Phím tắt.
• Tự động dán không gõ gì: kiểm tra app bạn đang dùng vẫn còn được focus; đổi cách dán trong Cài đặt → Tự động dán. Mục đã chọn luôn được copy, nên Ctrl V vẫn dùng được.
• Log: ~/.local/share/click.quickdesk/logs/. Đính kèm khi bạn báo lỗi.