README.vi.md

⚠️ 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 lập trình. Kết hợp với 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ác CLI agent được hỗ trợ

                    

             

Cài đặt hook cho một hoặc bất kỳ sự 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 lựa chọn.

---

Cài đặt

npm install -g failproofai
failproofai policies --install   # hoặc chỉ cần chạy `failproofai` và chấp nhận lời nhắc lần đầu
failproofai

30 chính sách tích hợp sẵn kích hoạt ngay lập tức. Bảng điều khiển tại localhost:8020. Vô hiệu hóa lời nhắc lần đầu với FAILPROOFAI_NO_FIRST_RUN=1.

---

Những gì nó ngăn chặn

Chính sách	Những gì nó chặn
block-push-master	Push trực tiếp đến main / master
block-force-push	git push --force
block-work-on-main	Commit, merge, rebase trên main / master
block-rm-rf	Xóa tệp đệ quy
sanitize-api-keys	Khóa API rò rỉ vào ngữ cảnh agent

→ Tất cả 30 chính sách tích hợp sẵn

---

Chính sách của riêng bạn

Thả một tệp vào .failproofai/policies/ — nó tải tự động, không cần cờ. Commit nó và toàn bộ đội sẽ nhận được nó vào lần kéo 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 có sẵn cho mỗi chính sách:

Quyết định	Tác dụng
allow()	Cho phép hoạt động
deny(message)	Chặn nó — thông báo quay lại agent
instruct(message)	Cho 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

---

Khả năng hiển thị phiên

Mọi cuộc 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 đã nói với agent — vì vậy bạn không phải đoán khi có sự cố. → Hướng dẫn bảng điều khiển

---

Tài liệu

Bắt đầu	Cài đặt và các 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 các tham số
Chính sách tùy chỉnh	Viết chính sách của riêng bạn
Cấu hình	Phạm vi cấu hình và quy tắc hợp nhất
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

---

Giấy phép

MIT với Commons Clause — miễn phí cho mục đích nội bộ và cá nhân; bán lại thương mại của failproofai yêu cầu thỏa thuận riêng. Xem LICENSE để xem toàn bộ văn bản.

---

Đóng góp

Xem CONTRIBUTING.md. Các chính sách mới, trường hợp cạnh và bản dịch đều được chào đón.

Build trước khi bạn bắt đầu. Chạy bun install && bun run build trước. Kho lưu trữ này chạy các hook của failproofai trên chính nó, và chúng phân giải import failproofai dựa trên bundle dist/ được biên dịch — nếu không build, bạn sẽ gặp lỗi Cannot find package 'failproofai' từ các hook. Rebuild sau khi thay đổi src/. Xem Build before the in-repo dev hooks will work.

---

Được xây dựng bởi Nivedit Jain và Nikita Agarwal. befailproof.ai