Perch Code
Trọn bộ harness. Trên mã nguồn của bạn.
Shell, tìm kiếm, chỉnh sửa tệp, tác vụ nền và sandbox cách ly, cùng bốn chế độ đa agent và hệ thống quyền hạn phân biệt được thao tác có thể hoàn tác và không thể hoàn tác. Perch được xây dựng cho những công việc sẽ bị kiểm toán. Hóa ra đó cũng chính là điều một mã nguồn cần.
Perch chạy những gì
Những công cụ bạn mong đợi ở một harness nghiêm túc, trên Desktop và trong CLI.
Shell và tìm kiếm
Bash, grep và glob thật sự. Tìm mọi chỗ gọi hàm nghĩa là tìm đủ mọi chỗ gọi hàm, không phải phỏng đoán theo ngữ nghĩa ra phần lớn trong số đó.
Chỉnh sửa tệp
Đọc, ghi, sửa tại chỗ, di chuyển, sao chép, xóa. Mọi lệnh gọi đều được đối chiếu với các thư mục gốc đã phê duyệt cho không gian làm việc của bạn.
Tác vụ nền
Chạy tách rời một bản build hay bộ test, rồi kiểm tra, chờ hoặc buộc dừng nó trong khi Perch tiếp tục làm việc khác.
Sandbox cách ly
Code chạy với mạng bị tắt trong một profile seatbelt của macOS, và mọi lần thực thi đều được ghi lại để mỗi kết quả có thể truy ngược về thứ đã tạo ra nó.
Chế độ Plan
Perch xem xét kho mã và soạn kế hoạch trong khi các công cụ làm thay đổi dữ liệu bị chặn. Không có gì được ghi trong lúc bạn đọc kế hoạch.
Việc cần làm và câu hỏi
Danh sách việc hiển thị rõ suốt các lượt chạy dài, và một câu hỏi thực sự khi quyết định thuộc về bạn, thay vì một phỏng đoán thay cho bạn.
Bốn cách chạy agent
Hầu hết các harness chỉ có một. Đây thực sự là những dạng công việc khác nhau, nên Perch tách riêng chúng thay vì giả vờ một khuôn mẫu phù hợp với mọi thứ.
Workers
Được tạo ra trong một lượt và chạy bên trong lượt đó. Lượt kết thúc khi chúng hoàn tất.
Flock
Lên kế hoạch cho một đội, chạy song song và tổng hợp thành một câu trả lời. Dành cho việc lớn, chia nhỏ được.
Delegate
Chạy tách rời. Tự hoạt động, đề xuất thay đổi tệp và chờ bạn phê duyệt trước khi ghi bất cứ thứ gì.
Background shell
Một tác vụ ở cấp hệ điều hành mà bạn kiểm tra định kỳ. Bản build vẫn chạy trong khi cuộc trò chuyện tiếp tục.
export async function settle(batch: Batch) { const total = batch.lines.reduce(sum, 0); const total = await computeTotal(batch.lines); assertReconciled(total, batch.expected); return post(total);}Agent chạy nền đề xuất thay đổi. Không có gì được ghi cho đến khi bạn đồng ý.
Git và GitHub
Perch làm việc với cả kho mã, không chỉ các tệp bên trong. Đọc lịch sử thì tự do; thay đổi những gì người khác nhìn thấy thì không.
Đọc lịch sử
Status, diff và lịch sử commit, để việc review bắt đầu từ những gì thực sự thay đổi thay vì từ một bản mô tả về nó.
Review commit và PR
Đi qua một pull request, truy một lỗi hồi quy về đúng commit đã gây ra nó, và báo cáo lại kèm các tệp làm căn cứ cho nhận định.
Gỡ lỗi check thất bại
Đọc CI check đang thất bại, tái hiện nó trên máy và sửa lỗi, thay vì bảo bạn nên đi đọc log nào.
Đẩy code có kiểm soát
Commit, push và mở pull request là những thao tác không thể hoàn tác và ảnh hưởng ra bên ngoài, nên chúng nằm sau một ranh giới quyền hạn rõ ràng.
Một mô hình kiểm tra mô hình khác
Mô hình đã viết ra nó không phải là mô hình nên chấm điểm nó.
Perch không phụ thuộc vào mô hình nào, nên các agent hỗ trợ mà nó tạo ra không nhất thiết phải chạy trên mô hình đang làm phần việc chính. Cho chúng chạy trên một mô hình khác và bạn có được ý kiến thứ hai thực sự, thay vì một mô hình tự review đầu ra của chính nó và thấy nó xuất sắc.
Điều đó chỉ khả thi vì bạn không bị ràng buộc vào một nhà cung cấp. Mọi mô hình trong danh mục mô hình đều có sẵn, được tính phí theo giá công bố mà không cộng thêm, và chúng tôi đã công bố benchmark chín mô hình thay vì chỉ khẳng định kết quả.
Bộ nhớ mà hầu hết các harness không có
Một tệp dự án chỉ là mức tối thiểu. Perch chạy ba hệ thống bộ nhớ, và mỗi phần ngữ cảnh đều đi kèm lý do được ghi lại vì sao nó có mặt ở đó.
Tệp dự án
PERCH.md, ghi chú bộ nhớ và quy tắc nằm trong thư mục của bạn dưới dạng markdown thuần do bạn sở hữu, được đọc ở mỗi lượt.
Bộ nhớ lâu dài
Các thẻ ở cấp tài khoản, được truy xuất bằng tìm kiếm kết hợp ngữ nghĩa và từ khóa, hợp nhất bằng reciprocal rank fusion, rồi được đánh trọng số theo độ tin cậy và độ mới.
Học từ các lần sửa
Sửa Perch một lần và lần sửa đó có thể trở thành bộ nhớ vĩnh viễn. Bạn không cần phải tự ghi chép lại.
Cách bộ nhớ hoạt động, bao gồm cách các làn (lane) và ngân sách token quyết định những gì đến được mô hình ở mỗi lượt.
Phần không ai khác có
Cùng một agent làm cả phần việc xung quanh code.
Các coding agent dừng lại ở kho mã. Perch được xây dựng cho công việc pháp lý, tài chính và tài liệu, nơi một câu trả lời sai nhưng đầy tự tin sẽ gây hậu quả, và bộ máy đó không tắt đi khi bạn mở một mã nguồn. Cùng phiên làm việc sửa lỗi đối chiếu có thể kiểm toán các khoản thanh toán mà lỗi đó đã xử lý sai, đối chiếu số liệu với tài liệu nguồn, và soạn bản ghi nhớ giải thích sự việc với trích dẫn cho mọi nhận định.
Một agent, một không gian làm việc, một bộ nhớ. Bạn không phải chắp nối một công cụ lập trình với một công cụ tài liệu rồi hy vọng chúng khớp nhau.
Trỏ Perch vào một kho mã.
Perch Code chạy trên Desktop và trong CLI. Cả hai đều làm việc từ thư mục cục bộ của bạn, và cả hai đều có trong mọi gói.