# PaperWM.spoon trên macOS: cài đặt và cấu hình những điều cơ bản

Last updated: 2026-11-12

PaperWM.spoon là một plugin trình quản lý cửa sổ xếp ô kiểu cuộn, miễn phí, dành cho Hammerspoon trên macOS. Để thiết lập, hãy cài Hammerspoon, sao chép kho mã PaperWM.spoon vào thư mục Spoons của Hammerspoon, tải và khởi động Spoon từ init.lua, rồi cấp các quyền mà macOS yêu cầu. Các lệnh dưới đây theo README của dự án, được kiểm tra ngày 12 tháng 11 năm 2026.

## Thông tin chính

- PaperWM.spoon là một Spoon của Hammerspoon, không phải một ứng dụng Mac độc lập.
- README của nó cung cấp lệnh clone và ví dụ cấu hình bằng Lua.
- README yêu cầu bạn đổi hai cài đặt Mission Control: tắt tự động sắp xếp lại Spaces và bật Spaces riêng cho các màn hình.
- Nó phù hợp nếu bạn muốn một thiết lập có thể cấu hình dựa trên Lua; những người không muốn duy trì cấu hình Hammerspoon có thể chọn một công cụ khác.

## Cài Hammerspoon trước

Tải Hammerspoon từ [trang chính thức](https://www.hammerspoon.org/), được kiểm tra ngày 12 tháng 11 năm 2026. Mở ứng dụng một lần và làm theo các lời nhắc quyền của macOS. Hammerspoon chạy các script tự động hóa, vì vậy hãy xem lại những gì bạn cài và đoạn mã bạn chọn nạp vào. README của dự án PaperWM.spoon mô tả plugin và cách thiết lập. Chúng tôi chưa thử các bước này trên mọi phiên bản macOS.

[README chính thức](https://github.com/mogenson/PaperWM.spoon) của PaperWM.spoon, được kiểm tra ngày 12 tháng 11 năm 2026, đưa ra lệnh cài đặt sau:

```bash
git clone https://github.com/mogenson/PaperWM.spoon ~/.hammerspoon/Spoons/PaperWM.spoon
```

Chạy lệnh này trong Terminal. Nó sao chép kho mã vào thư mục Spoons mà Hammerspoon dùng. Nếu bạn dùng thư mục cấu hình Hammerspoon tùy chỉnh, hãy đổi đích đến cho khớp với thư mục đó.

## Đặt các tùy chọn Mission Control

README hướng dẫn bạn vào Tùy chọn Hệ thống → Màn hình nền & Dock và mục Mission Control. Trên macOS hiện tại, hãy mở Cài đặt hệ thống → Màn hình nền & Dock, rồi cuộn đến Mission Control. Tắt **Tự động sắp xếp lại Spaces dựa trên lần sử dụng gần nhất** và bật **Màn hình có các Spaces riêng biệt**. Cách diễn đạt và vị trí chính xác có thể khác nhau tùy phiên bản macOS. README liệt kê các tùy chọn này như một phần của thiết lập.

Đây là các lựa chọn toàn hệ thống, ảnh hưởng đến cách macOS xử lý Spaces. Hãy quyết định xem chúng có phù hợp với thiết lập của bạn hay không trước khi thay đổi. Nếu bạn dùng nhiều màn hình, hãy kiểm tra hành vi Space của chúng có khớp với điều bạn muốn không.

## Nạp và khởi động Spoon

Mở tệp cấu hình của Hammerspoon tại `~/.hammerspoon/init.lua`. Thêm các dòng Lua sau:

```lua
PaperWM = hs.loadSpoon("PaperWM")
PaperWM:bindHotkeys(PaperWM.default_hotkeys)
PaperWM:start()
```

Lưu tệp. Từ biểu tượng Hammerspoon trên thanh menu, chọn **Reload Config**. Dòng đầu tiên nạp Spoon, dòng thứ hai đăng ký các phím tắt mặc định được tài liệu hóa, và dòng thứ ba bắt đầu quản lý cửa sổ. README của dự án cũng trình bày cách cài qua SpoonInstall và các phím gán tùy chỉnh mẫu. Hãy bắt đầu với các mặc định trước khi sửa phím để bạn biết thiết lập đã nạp thành công hay chưa.

Để dừng PaperWM.spoon, gọi `PaperWM:stop()` qua console hoặc tệp cấu hình của Hammerspoon. Nếu khi khởi động báo thiếu Spoon, hãy kiểm tra xem thư mục clone có tên `PaperWM.spoon` và nằm trong thư mục Spoons mà Hammerspoon dùng hay không. Hãy kiểm tra console của Hammerspoon xem có lỗi Lua nào trước khi đổi nhiều cài đặt cùng lúc.

## Kiểm tra phím gán và thực hiện một thay đổi

[README](https://github.com/mogenson/PaperWM.spoon) của PaperWM.spoon, được kiểm tra ngày 12 tháng 11 năm 2026, ghi lại các mặc định: lấy nét bằng Option–Command và phím mũi tên, đổi chỗ bằng Option–Command–Shift và phím mũi tên, và xoay vòng độ rộng bằng Option–Command–R. Nó cũng có phím gán cho chế độ nổi, Spaces và đổi kích thước cửa sổ. Nếu một phím tắt xung đột với ứng dụng khác, hãy sửa bảng Lua, nạp lại cấu hình, và kiểm tra console của Hammerspoon nếu plugin ngừng phản hồi.

Cấu hình riêng của Spoon có thể lọc ứng dụng và điều chỉnh tỉ lệ cửa sổ. README trình bày `window_filter` và `window_ratios` như các điểm cấu hình. Chỉ đổi một cài đặt mà bạn xác định được trong tài liệu, rồi thử một cửa sổ ứng dụng bình thường và một ứng dụng bạn muốn loại trừ. Người bảo trì cũng lưu ý rằng macOS giới hạn việc di chuyển cửa sổ ra hẳn ngoài màn hình, nên các cửa sổ xếp ô ở mép có thể vẫn hiện một phần.

Đây là bộ công cụ dựa trên Lua. Nó phù hợp với người thoải mái đọc tệp cấu hình và muốn tính linh hoạt của Hammerspoon. Người thích một ứng dụng độc lập và cửa sổ cài đặt có thể thấy thiết lập này khó duy trì. Hướng dẫn thiết lập trong README là nguồn chính thức của PaperWM.spoon; hãy kiểm tra kho mã trước khi làm theo, vì các dự án mã nguồn mở có thể thay đổi.

README của PaperWM.spoon nói rằng nó “Lấy cảm hứng từ PaperWM” và liên kết đến [dự án PaperWM](https://github.com/paperwm/PaperWM), được kiểm tra ngày 12 tháng 11 năm 2026. Hai dự án có cách triển khai và hướng dẫn thiết lập riêng.

Chúng tôi làm ra SlidePane, một ứng dụng macOS dành cho người muốn cấu hình bố cục cửa sổ mà không phải duy trì các script Lua. Ứng dụng có thể phù hợp nếu bạn thích cài đặt trong ứng dụng và các điều khiển phím tắt có sẵn; PaperWM.spoon phù hợp hơn khi bạn muốn mô hình script Hammerspoon của nó. Xem [Cài đặt SlidePane và bắt đầu dùng thử miễn phí](/vi/guides/installation) để thiết lập ứng dụng.

## Trang liên quan

[Bài viết Niri trên Mac](/vi/blog/niri-on-mac) so sánh một quy trình cuộn khác. [Phím tắt và bố cục bàn phím](/vi/guides/shortcuts) giải thích cách xem lại các phím gán của ứng dụng.
