Lệnh gạch chéo
Cách thực sự dùng từng lệnh gạch chéo trong Perch Terminal và CLI, kết quả nhận được và khi nào nên dùng thay vì chỉ đặt câu hỏi.
Lệnh gạch chéo là chỉ dẫn trực tiếp cho chính Perch thay vì tác vụ cho mô hình. Nhập / tại prompt và danh sách xuất hiện. Phần lớn là các lệnh điều khiển phiên nhanh, nhưng năm lệnh thực hiện công việc thực tế: /goal tự chủ chạy qua nhiều lượt, /verify kiểm tra lại câu trả lời với nguồn của bạn, /deepresearch nghiên cứu câu hỏi qua nhiều vòng và trả về báo cáo có trích dẫn, /delegate giao tác vụ cho agent chạy nền và /flock chạy một nhóm agent thực thi.
Trang này trình bày khi nào nên dùng từng lệnh và điều gì xảy ra khi dùng. Để xem danh sách gọn của mọi lệnh và cờ, xem tài liệu tham khảo CLI.
Nơi các lệnh hoạt động
/goal
/goal là lệnh mọi người chưa dùng đủ. Một lượt thông thường thực hiện điều bạn yêu cầu rồi dừng, và nếu công việc có mười hai bước, bạn phải liên tục nói "tiếp tục". /goal đặt mục tiêu mà Perch tự theo đuổi qua từng lượt, tự gọi lại cho đến khi kiểm tra hoàn tất đạt yêu cầu hoặc hết ngân sách.
Dùng lệnh khi công việc có nhiều bước và đích hoàn thành bạn có thể diễn tả rõ:
/goal make the test suite pass
/goal reconcile every invoice in this folder against the GL and write up the exceptionsĐừng dùng cho một câu hỏi đơn lẻ. Mục tiêu vốn chỉ cần một lượt sẽ chỉ thêm bước kiểm tra.
Theo dõi và định hướng
Khi mục tiêu đang chạy, bạn thấy từng lượt diễn ra cùng các lệnh gọi công cụ. Các lệnh điều khiển gồm:
| Lệnh | Chức năng |
|---|---|
/goal | Hiển thị mục tiêu hiện tại: trạng thái, số lượt đã dùng và lý do lần dừng gần nhất. |
/goal pause | Tạm dừng mục tiêu mà không làm mất mục tiêu. |
/goal resume | Tiếp tục mục tiêu từ nơi đã dừng. |
/goal clear | Xóa hoàn toàn mục tiêu. stop, off, cancel và reset cũng đều hoạt động. |
/goal status giống /goal không có đối số, và /goal continue giống /goal resume.
Khi nào quá trình chạy dừng
Mục tiêu không bao giờ chạy mãi. Nó kết thúc vì một trong các lý do sau, và Perch cho bạn biết lý do nào:
| Trạng thái dừng | Ý nghĩa |
|---|---|
| Complete | Kiểm tra hoàn tất đạt yêu cầu. Công việc đã xong. |
| Budget | Đã đạt 40 lượt hoặc 4 giờ thời gian thực. Kết quả hiện có là tiến độ một phần. |
| No progress | Lượt cuối không gọi công cụ và không đạt yêu cầu kiểm tra, nên dừng thay vì chạy vòng lặp vô ích. |
| Blocked | Một hành động cần bạn phê duyệt. |
| Failed | Một lượt gặp lỗi. |
| Cancelled | Bạn dừng bằng Ctrl-C trong CLI hoặc Esc trong ứng dụng máy tính. |
Ngoại trừ Complete, tất cả đều có thể tiếp tục bằng /goal resume.
Chế độ quyền hạn có ảnh hưởng ở đây
Đây là điều khiến mọi người bất ngờ. Trong chế độ quyền hạn Default, thao tác ghi hoặc lệnh đầu tiên tạm dừng để bạn phê duyệt, và mục tiêu báo Blocked rồi dừng. Đó là hành vi đúng, nhưng có nghĩa mục tiêu chạy qua đêm không có người giám sát trong chế độ Default sẽ không tiến được xa.
Nếu muốn mục tiêu chạy khi bạn vắng mặt, đặt Auto Review (công việc có thể hoàn tác tự chạy, hành động không thể hoàn tác vẫn hỏi) hoặc Take the Wheel (tự chủ hoàn toàn). Xem chế độ quyền hạn để biết từng chế độ cho phép gì.
Vẫn được giữ khi thoát
Mục tiêu được lưu cùng luồng hội thoại, nên tồn tại sau phiên. Thoát CLI, đóng ứng dụng máy tính hoặc tải lại trang, rồi quay lại cùng thư mục hoặc luồng hội thoại và chạy /goal resume. Mục tiêu và số lượt vẫn còn.
Có hai hệ quả từ việc mục tiêu gắn với từng luồng hội thoại. Mục tiêu đặt trong luồng của một thư mục không hiển thị từ thư mục khác, vì CLI xác định phạm vi luồng mặc định theo thư mục làm việc. Và chạy lại /goal với nội dung mục tiêu giống hệt sẽ tiếp tục mục tiêu hiện có thay vì đặt lại số lượt, còn nội dung khác sẽ bắt đầu mới.
/verify
/verify kiểm tra lại các nhận định trong câu trả lời với các nguồn đã lập chỉ mục của bạn. Lệnh chỉ truy xuất, không gọi mô hình phía sau, nên trả về nhanh và không tiêu tốn token.
/verify # check the last answer Perch gave
/verify <paste text> # check text you wrote or pasted
/verify --changed # re-check only what moved since your last checkBạn nhận được thống kê rồi một dòng cho mỗi nhận định:
Citation check — 6 claims in the last answer checked against your sources
✓ 4 verified · ~ 1 uncertain · ✗ 1 not found✓ nghĩa là có nguồn hỗ trợ nhận định, ~ nghĩa là độ khớp còn yếu và bạn nên xem lại, còn ✗ nghĩa là không có gì trong nguồn của bạn hỗ trợ nhận định. Các dòng ✗ là lý do lệnh này tồn tại. Chạy sau khi Perch soạn bất kỳ nội dung nào có trích dẫn và trước khi bạn gửi bản thảo đi.
--changed và điểm kiểm tra là gì
/verify --changed trả lời câu hỏi hẹp hơn: từ lần kiểm tra trước, có nguồn nào thay đổi và có điều gì tôi dựa vào không còn đúng không?
Chi tiết cốt lõi là lần chạy /verify gần nhất của bạn chính là điểm kiểm tra. Không có lệnh riêng để đặt điểm này. Mỗi lần kiểm tra ghi lại các nguồn đã dựa vào, nên lần chạy --changed sau chỉ kiểm tra lại các nhận định có nguồn thực sự thay đổi và giữ nguyên phần còn lại. Nếu chưa từng chạy /verify trong luồng hội thoại, --changed không có gì để so sánh và báo rõ.
Kết quả đưa các trường hợp suy giảm lên trước, tức những nhận định có cơ sở yếu đi, vì đó là phần duy nhất cần bạn hành động. --since-last là bí danh nếu cách viết đó dễ hiểu hơn với bạn.
/deepresearch
/deepresearch dành cho câu hỏi cần nhiều hơn một lượt tìm kiếm. Lệnh chia câu hỏi thành các câu hỏi nhỏ để lập kế hoạch, tìm trong các tệp đã lập chỉ mục và trên web (kể cả nguồn chuyên biệt khi phù hợp), đọc những gì tìm được qua nhiều vòng và trả về báo cáo có trích dẫn cùng sổ theo dõi nhận định.
/deepresearch what changed in EU AI Act enforcement this year
/deepresearch --rounds 5 does creatine improve strength in trained adults
/deepresearch --web only use the public web for this merger timeline/research và /deep-research là cùng lệnh. Dùng khi bạn muốn câu trả lời đã được nghiên cứu với nguồn có thể kiểm tra, không phải câu trả lời trò chuyện nhanh. Đừng dùng cho tra cứu một dòng hoặc tác vụ có đích hoàn thành nên dùng /goal.
Cờ
| Cờ | Chức năng |
|---|---|
--rounds N | Đặt ngân sách vòng từ 1 đến 6. Mặc định là 3. -r và --rounds=N cũng hoạt động. |
--web | Bỏ qua các tệp trong không gian làm việc và chỉ nghiên cứu trên web công khai. --web-only tương đương. |
--resume | Tiếp tục lần chạy đã tạm giữ sau khi bị ngắt đột ngột. --continue tương đương. |
/deepresearch không có câu hỏi in trợ giúp và không tiêu tốn mức sử dụng. Nếu có lần chạy đang chờ tiếp tục, lệnh cũng báo cho bạn.
Kết quả nhận được
Câu trả lời trong trò chuyện gồm báo cáo, danh sách nguồn đánh số và sổ theo dõi nhận định. Sổ có ba nhóm: được tệp của bạn hỗ trợ, chỉ có nguồn web hoặc không có nguồn hỗ trợ. Câu trả lời làm nổi bật các nhận định được hỗ trợ và không được hỗ trợ; bản ghi đầy đủ liệt kê cả ba nhóm.
Trên ứng dụng máy tính và CLI, Perch cũng ghi tệp markdown trong perch-research/ với báo cáo đầy đủ, kế hoạch, mọi nguồn và toàn bộ sổ theo dõi. Tệp đó là bản ghi lâu dài của lần chạy.
Tiếp tục và thời điểm hết hạn
Ngắt đột ngột tạm giữ lần chạy để bạn có thể tiếp tục bằng /deepresearch --resume. Bạn có khoảng 45 phút. Sau đó trạng thái tạm giữ hết hạn và bạn bắt đầu lại với câu hỏi gốc. Hủy theo quy trình bình thường sẽ ghi báo cáo một phần thay thế và không để lại gì để tiếp tục.
--web nghĩa là không có nhận định nào được tệp của bạn hỗ trợ. Nếu chưa có gì trong thư mục được lập chỉ mục, điều này cũng đúng cho đến khi bạn lập chỉ mục một tệp.
/delegate
/delegate <task> giao tác vụ có phạm vi xác định cho agent chạy nền và đưa bạn trở lại prompt. Agent chạy bất đồng bộ và trả về kết quả để xem xét, nên công việc dài không bao giờ chặn phiên bạn đang dùng. /bg <task> là cùng lệnh với cách gõ ngắn hơn.
/delegate summarize every PDF in ./contracts and list the renewal datesDùng khi tác vụ độc lập và bạn muốn tiếp tục làm việc thay vì theo dõi quá trình chạy. Nếu tác vụ cần bạn cung cấp thông tin giữa chừng hoặc bạn muốn định hướng, hãy giữ nó trong phiên chính.
/flock
/flock <task> chạy một nhóm agent thực thi trên một tác vụ khó và có các agent thực thi phụ trách kiểm chứng kết quả trước khi bạn thấy. Tính năng đang thử nghiệm và không xuất hiện trong menu lệnh, nhưng hoạt động trong ứng dụng máy tính và CLI.
/flock review this branch for regressions and verify the testsLệnh được xây dựng cho công việc mà một lượt xử lý không đủ và từ chối tác vụ nhỏ trước khi bắt đầu vì lượt thông thường nhanh hơn. Xem Flock để biết cách lập kế hoạch và vận hành nhóm.
Lệnh phiên
Các lệnh này không thực hiện tác vụ mà thay đổi hoặc hiển thị thông tin về phiên.
| Lệnh | Chức năng | Nơi dùng |
|---|---|---|
/model [tier|name] | Hiển thị hoặc đặt mô hình: cấp Roost hoặc ghim mô hình cụ thể. Xem cấp mô hình. | Cả hai |
/usage | Hiển thị mức Perch Token đi kèm và mức sử dụng của phiên này. | Cả hai |
/compact | Tóm tắt các lượt cũ để giải phóng cửa sổ ngữ cảnh. | Desktop |
/context | Hiển thị thước đo ngữ cảnh và chi tiết nén ngữ cảnh. | CLI |
/persona [saffron|quill] | Hiển thị hoặc đổi giọng văn. Xem Persona. | CLI |
/mode [ask|agents|plan] | Hiển thị hoặc đặt chế độ trò chuyện. | CLI |
/permission [mode] | Hiển thị hoặc đặt mức độ Perch có thể làm mà không hỏi. | CLI |
/thinking [on|off] | Hiển thị hoặc bật/tắt suy nghĩ mở rộng cho mô hình đã chọn. | CLI |
/local-tools [on|off] | Hiển thị hoặc bật/tắt các công cụ shell và tệp cục bộ. | CLI |
/cwd [dir] | Hiển thị hoặc đổi thư mục làm việc. | CLI |
/thread [new|id] | Hiển thị, đặt lại hoặc đặt mã định danh luồng hội thoại hiện tại. | CLI |
/skills [name] | Liệt kê các skill cốt lõi của Perch hoặc hiển thị nội dung một skill. | CLI |
/memory-audit <text> | Kiểm tra liệu một ghi chú có được lưu vào bộ nhớ hay không và vì sao. Xem Bộ nhớ. | CLI |
/status | Hiển thị cwd, xác thực, chế độ, persona, quyền hạn và luồng hội thoại. | CLI |
/clear | Xóa bộ nhớ hội thoại cục bộ của phiên terminal này. | CLI |
/help | Hiển thị danh sách lệnh đầy đủ. | CLI |
/login, /logout | Đăng nhập qua OAuth trên trình duyệt hoặc xóa thông tin xác thực đã lưu. | CLI |
/exit | Thoát CLI. | CLI |
Trong lúc Perch làm việc
Bước tiếp theo
Perch trên điện thoại
Thêm Perch vào Màn hình chính của điện thoại, không cần cửa hàng ứng dụng. Trò chuyện trên mọi gói. Với Pro, trong giai đoạn beta, khởi động agent trên đám mây, truy cập máy tính từ bất cứ đâu và nhận thông báo khi quá trình chạy cần bạn.
Tài liệu tham khảo CLI
Mọi lệnh trong Perch CLI, gồm các lệnh con perch bạn chạy từ shell và các lệnh gạch chéo bạn dùng trong phiên tương tác.

