⚠️ This is an auto-generated translation. For the latest version, see the English README. Community corrections welcome!
🇺🇸 English | 🇨🇳 简体中文 | 🇯🇵 日本語 | 🇰🇷 한국어 | 🇪🇸 Español | 🇧🇷 Português | 🇩🇪 Deutsch | 🇫🇷 Français | 🇷🇺 Русский | 🇮🇳 हिन्दी | 🇹🇷 Türkçe | 🇻🇳 Tiếng Việt | 🇮🇹 Italiano | 🇸🇦 العربية | 🇮🇱 עברית
Bản dịch: 简体中文 · 日本語 · 한국어 · Español · Português · Deutsch · Français · Русский · हिन्दी · Türkçe · Tiếng Việt · Italiano · العربية · עברית
Giải pháp xử lý lỗi thời gian chạy cho các agent code. Tích hợp vào Claude Code và Codex. Bắt các vòng lặp, hành động nguy hiểm, và rò rỉ bí mật trước khi chúng trở thành sự cố. Độ trễ bằng không. Chạy cục bộ.
Cài đặt hook cho một hoặc bất kỳ kết hợp nào:
failproofai policies --install --cli opencode pi gemini(hoặc--cli claude codex copilot cursor opencode pi gemini). Bỏ qua--cliđể tự động phát hiện các CLI được cài đặt và nhắc nhở.
npm install -g failproofai
failproofai policies --install # hoặc chỉ chạy `failproofai` và chấp nhận lời nhắc lần đầu tiên
failproofai30 chính sách tích hợp sẵn được kích hoạt ngay lập tức. Bảng điều khiển tại localhost:8020. Tắt lời nhắc lần đầu tiên bằng FAILPROOFAI_NO_FIRST_RUN=1.
| Chính sách | Những gì nó chặn |
|---|---|
block-push-master |
Đẩy trực tiếp tới main / master |
block-force-push |
git push --force |
block-work-on-main |
Commit, merge, rebase trên main / master |
block-rm-rf |
Xóa file đệ quy |
sanitize-api-keys |
API key rò rỉ vào ngữ cảnh agent |
→ Tất cả 30 chính sách tích hợp sẵn
Thả một tệp vào .failproofai/policies/ — nó tự động tải mà không cần cờ nào.
Commit nó và toàn bộ đội của bạn sẽ nhận được nó khi pull tiếp theo.
import { customPolicies, deny, allow } from "failproofai";
customPolicies.add({
name: "no-production-writes",
match: { events: ["PreToolUse"] },
fn: async (ctx) => {
if (ctx.toolInput?.file_path?.includes("production"))
return deny("Writes to production paths are blocked.");
return allow();
},
});Ba quyết định khả dụng cho mọi chính sách:
| Quyết định | Hiệu ứng |
|---|---|
allow() |
Cho phép thực hiện |
deny(message) |
Chặn nó — thông điệp trở về agent |
instruct(message) |
Để nó qua, nhưng thêm ngữ cảnh vào lời nhắc tiếp theo của agent |
→ Hướng dẫn chính sách tùy chỉnh
Mọi lệnh gọi công cụ mà agent của bạn thực hiện đều được ghi lại cục bộ. Bảng điều khiển hiển thị những gì đã chạy, những gì bị chặn, và những gì chính sách đã báo cho agent — vì vậy bạn không phải đoán khi có điều gì đó trở nên sai. → Hướng dẫn bảng điều khiển
| Bắt đầu | Cài đặt và bước đầu tiên |
| Chính sách tích hợp sẵn | Tất cả 30 chính sách với tham số |
| Chính sách tùy chỉnh | Viết của riêng bạn |
| Cấu hình | Phạm vi cấu hình và quy tắc merge |
| Bảng điều khiển | Giám sát phiên và hoạt động chính sách |
| Kiến trúc | Cách hệ thống hook hoạt động |
MIT với Commons Clause — miễn phí cho sử dụng nội bộ và cá nhân; bán lại thương mại chính failproofai yêu cầu một thỏa thuận riêng. Xem LICENSE để biết toàn bộ văn bản.
Xem CONTRIBUTING.md. Chúng tôi hoan nghênh các chính sách mới, trường hợp cạnh, và bản dịch.
Được xây dựng bởi Nivedit Jain và Nikita Agarwal. befailproof.ai