failproofai 0.0.6-beta.1 → 0.0.6-beta.2

package/.next/standalone/docs/i18n/README.vi.md

@@ -21,14 +21,14 @@
 [![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
 [![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
 
-**Bản dịch**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
+**Translations**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
 
-Cách dễ nhất để quản lý các chính sách giúp AI agents của bạn hoạt động đáng tin cậy, tập trung vào nhiệm vụ và chạy tự động - cho **Claude Code** & **Agents SDK**.
+Cách dễ nhất để quản lý các chính sách giữ cho các AI agent của bạn đáng tin cậy, tập trung vào mục tiêu và chạy tự động - cho **Claude Code** & **Agents SDK**.
 
-- **30 Chính sách tích hợp sẵn** - Bắt các chế độ lỗi phổ biến của agent ngay lập tức. Chặn các lệnh nguy hiểm, ngăn chặn rò rỉ bí mật, giữ agents trong ranh giới dự án, phát hiện vòng lặp, và nhiều hơn nữa.
-- **Chính sách tùy chỉnh** - Viết các quy tắc độ tin cậy của riêng bạn bằng JavaScript. Sử dụng API `allow`/`deny`/`instruct` để thực thi các quy ước, ngăn chặn sự lệch lạc, kiểm soát các hoạt động, hoặc tích hợp với các hệ thống bên ngoài.
-- **Cấu hình dễ dàng** - Tinh chỉnh bất kỳ chính sách nào mà không cần viết code. Đặt danh sách cho phép, nhánh được bảo vệ, ngưỡng cho mỗi dự án hoặc toàn cục. Ba phạm vi cấu hình tự động hợp nhất.
-- **Agent Monitor** - Xem những gì agents của bạn đã làm khi bạn vắng mặt. Duyệt các phiên làm việc, kiểm tra từng lệnh gọi công cụ, và xem xét chính xác nơi các chính sách được áp dụng.
+- **30 Chính sách tích hợp** - Bắt các chế độ lỗi phổ biến của agent ngay lập tức. Chặn các lệnh phá hoại, ngăn chặn rò rỉ bí mật, giữ các agent trong ranh giới dự án, phát hiện vòng lặp, v.v.
+- **Chính sách tùy chỉnh** - Viết các quy tắc độ tin cậy của riêng bạn bằng JavaScript. Sử dụng API `allow`/`deny`/`instruct` để thực thi các quy ước, ngăn chặn sai lệch, gating các hoạt động hoặc tích hợp với các hệ thống bên ngoài.
+- **Cấu hình dễ dàng** - Điều chỉnh bất kỳ chính sách nào mà không cần viết mã. Đặt danh sách cho phép, các nhánh được bảo vệ, ngưỡng cho mỗi dự án hoặc toàn cầu. Ba cấu hình phạm vi hợp nhất tự động.
+- **Agent Monitor** - Xem những gì các agent của bạn đã làm khi bạn vắng mặt. Duyệt qua các phiên, kiểm tra từng lệnh gọi công cụ, và xem lại chính xác nơi các chính sách đã kích hoạt.
 
 Mọi thứ chạy cục bộ - không có dữ liệu nào rời khỏi máy của bạn.
 
@@ -53,23 +53,23 @@ bun add -g failproofai
 
 ## Bắt đầu nhanh
 
-### 1. Bật chính sách toàn cục
+### 1. Bật chính sách toàn cầu
 
 ```bash
 failproofai policies --install
 ```
 
-Ghi các mục hook vào `~/.claude/settings.json`. Claude Code sẽ gọi failproofai trước và sau mỗi lệnh gọi công cụ.
+Ghi các mục hook vào `~/.claude/settings.json`. Claude Code sẽ bây giờ gọi failproofai trước và sau mỗi lệnh gọi công cụ.
 
-### 2. Khởi động bảng điều khiển
+### 2. Khởi chạy bảng điều khiển
 
 ```bash
 failproofai
 ```
 
-Mở `http://localhost:8020` - duyệt các phiên làm việc, kiểm tra nhật ký, quản lý chính sách.
+Mở `http://localhost:8020` - duyệt qua các phiên, kiểm tra nhật ký, quản lý chính sách.
 
-### 3. Kiểm tra những gì đang hoạt động
+### 3. Kiểm tra cái gì đang hoạt động
 
 ```bash
 failproofai policies
@@ -83,17 +83,17 @@ failproofai policies
 
 | Phạm vi | Lệnh | Nơi ghi |
 |--------|------|---------|
-| Toàn cục (mặc định) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Toàn cầu (mặc định) | `failproofai policies --install` | `~/.claude/settings.json` |
 | Dự án | `failproofai policies --install --scope project` | `.claude/settings.json` |
 | Cục bộ | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
-### Cài đặt chính sách cụ thể
+### Cài đặt các chính sách cụ thể
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 ```
 
-### Gỡ bỏ chính sách
+### Xóa chính sách
 
 ```bash
 failproofai policies --uninstall
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 
 ## Cấu hình
 
-Cấu hình chính sách nằm trong `~/.failproofai/policies-config.json` (toàn cục) hoặc `.failproofai/policies-config.json` trong dự án của bạn (theo dự án).
+Cấu hình chính sách nằm trong `~/.failproofai/policies-config.json` (toàn cầu) hoặc `.failproofai/policies-config.json` trong dự án của bạn (cho mỗi dự án).
 
 ```json
 {
@@ -120,11 +120,11 @@ Cấu hình chính sách nằm trong `~/.failproofai/policies-config.json` (toà
   "policyParams": {
     "block-sudo": {
       "allowPatterns": ["sudo systemctl status", "sudo journalctl"],
-      "hint": "Use apt-get directly without sudo."
+      "hint": "Sử dụng apt-get trực tiếp mà không cần sudo."
     },
     "block-push-master": {
       "protectedBranches": ["main", "release", "prod"],
-      "hint": "Try creating a fresh branch instead."
+      "hint": "Hãy thử tạo một nhánh mới thay thế."
     },
     "sanitize-api-keys": {
       "additionalPatterns": [
@@ -138,40 +138,40 @@ Cấu hình chính sách nằm trong `~/.failproofai/policies-config.json` (toà
 }
 ```
 
-**Ba phạm vi cấu hình** được hợp nhất tự động (dự án → cục bộ → toàn cục). Xem [docs/configuration.mdx](docs/configuration.mdx) để biết các quy tắc hợp nhất đầy đủ.
+**Ba phạm vi cấu hình** được hợp nhất tự động (project → local → global). Xem [docs/configuration.mdx](docs/configuration.mdx) để biết các quy tắc hợp nhất đầy đủ.
 
 ---
 
-## Chính sách tích hợp sẵn
+## Chính sách tích hợp
 
 | Chính sách | Mô tả | Có thể cấu hình |
 |-----------|-------|:---:|
-| `block-sudo` | Ngăn agents chạy các lệnh hệ thống có đặc quyền | `allowPatterns` |
-| `block-rm-rf` | Ngăn xóa tệp đệ quy vô tình | `allowPaths` |
-| `block-curl-pipe-sh` | Ngăn agents đưa các tập lệnh không đáng tin cậy vào shell | |
-| `block-failproofai-commands` | Ngăn tự gỡ cài đặt | |
-| `sanitize-jwt` | Dừng các mã JWT rò rỉ vào ngữ cảnh agent | |
-| `sanitize-api-keys` | Dừng các khóa API rò rỉ vào ngữ cảnh agent | `additionalPatterns` |
-| `sanitize-connection-strings` | Dừng thông tin xác thực cơ sở dữ liệu rò rỉ vào ngữ cảnh agent | |
-| `sanitize-private-key-content` | Che mờ các khối khóa riêng PEM khỏi đầu ra | |
-| `sanitize-bearer-tokens` | Che mờ các mã Authorization Bearer từ đầu ra | |
-| `block-env-files` | Giữ agents không đọc các tệp .env | |
-| `protect-env-vars` | Ngăn agents in các biến môi trường | |
-| `block-read-outside-cwd` | Giữ agents trong ranh giới dự án | `allowPaths` |
-| `block-secrets-write` | Ngăn ghi vào các tệp khóa riêng và chứng chỉ | `additionalPatterns` |
-| `block-push-master` | Ngăn đẩy vô tình tới main/master | `protectedBranches` |
-| `block-work-on-main` | Giữ agents không hoạt động trên các nhánh được bảo vệ | `protectedBranches` |
-| `block-force-push` | Ngăn `git push --force` | |
-| `warn-git-amend` | Nhắc nhở agents trước khi sửa đổi commit | |
-| `warn-git-stash-drop` | Nhắc nhở agents trước khi xóa stash | |
-| `warn-all-files-staged` | Bắt `git add -A` vô tình | |
-| `warn-destructive-sql` | Bắt SQL DROP/DELETE trước khi thực hiện | |
-| `warn-schema-alteration` | Bắt ALTER TABLE trước khi thực hiện | |
-| `warn-large-file-write` | Bắt các lần ghi tệp lớn bất ngờ | `thresholdKb` |
-| `warn-package-publish` | Bắt `npm publish` vô tình | |
-| `warn-background-process` | Bắt khởi chạy quy trình nền không dự định | |
-| `warn-global-package-install` | Bắt cài đặt gói toàn cục không dự định | |
-| …và nhiều hơn nữa | | |
+| `block-sudo` | Ngăn chặn các agent chạy các lệnh hệ thống có đặc quyền | `allowPatterns` |
+| `block-rm-rf` | Ngăn chặn việc xóa tệp đệ quy ngẫu nhiên | `allowPaths` |
+| `block-curl-pipe-sh` | Ngăn chặn các agent từ piping các tập lệnh không tin cậy vào shell | |
+| `block-failproofai-commands` | Ngăn chặn tự gỡ cài đặt | |
+| `sanitize-jwt` | Dừng các mã thông báo JWT rò rỉ vào bối cảnh agent | |
+| `sanitize-api-keys` | Dừng các khóa API rò rỉ vào bối cảnh agent | `additionalPatterns` |
+| `sanitize-connection-strings` | Dừng thông tin xác thực cơ sở dữ liệu rò rỉ vào bối cảnh agent | |
+| `sanitize-private-key-content` | Che đi các khối khóa riêng PEM khỏi đầu ra | |
+| `sanitize-bearer-tokens` | Che đi các mã thông báo Authorization Bearer khỏi đầu ra | |
+| `block-env-files` | Giữ các agent khỏi đọc các tệp .env | |
+| `protect-env-vars` | Ngăn chặn các agent từ in các biến môi trường | |
+| `block-read-outside-cwd` | Giữ các agent bên trong ranh giới dự án | `allowPaths` |
+| `block-secrets-write` | Ngăn chặn ghi vào các tệp khóa riêng và chứng chỉ | `additionalPatterns` |
+| `block-push-master` | Ngăn chặn các push ngẫu nhiên vào main/master | `protectedBranches` |
+| `block-work-on-main` | Giữ các agent khỏi các nhánh được bảo vệ | `protectedBranches` |
+| `block-force-push` | Ngăn chặn `git push --force` | |
+| `warn-git-amend` | Nhắc nhở các agent trước khi sửa đổi commit | |
+| `warn-git-stash-drop` | Nhắc nhở các agent trước khi bỏ stash | |
+| `warn-all-files-staged` | Bắt `git add -A` ngẫu nhiên | |
+| `warn-destructive-sql` | Bắt DROP/DELETE SQL trước khi thực thi | |
+| `warn-schema-alteration` | Bắt ALTER TABLE trước khi thực thi | |
+| `warn-large-file-write` | Bắt ghi tệp lớn ngoài dự kiến | `thresholdKb` |
+| `warn-package-publish` | Bắt `npm publish` ngẫu nhiên | |
+| `warn-background-process` | Bắt các khởi chạy quy trình nền không dự định | |
+| `warn-global-package-install` | Bắt các cài đặt gói toàn cầu không dự định | |
+| …và hơn nữa | | |
 
 Chi tiết chính sách đầy đủ và tham chiếu tham số: [docs/built-in-policies.mdx](docs/built-in-policies.mdx)
 
@@ -179,25 +179,25 @@ Chi tiết chính sách đầy đủ và tham chiếu tham số: [docs/built-in-
 
 ## Chính sách tùy chỉnh
 
-Viết các chính sách của riêng bạn để giữ agents đáng tin cậy và tập trung vào nhiệm vụ:
+Viết các chính sách của riêng bạn để giữ cho các agent đáng tin cậy và tập trung vào mục tiêu:
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
 customPolicies.add({
   name: "no-production-writes",
-  description: "Block writes to paths containing 'production'",
+  description: "Chặn ghi vào các đường dẫn chứa 'production'",
   match: { events: ["PreToolUse"] },
   fn: async (ctx) => {
     if (!["Write", "Edit"].includes(ctx.toolName ?? "")) return allow();
     const path = ctx.toolInput?.file_path ?? "";
-    if (path.includes("production")) return deny("Writes to production paths are blocked");
+    if (path.includes("production")) return deny("Ghi vào các đường dẫn production bị chặn");
     return allow();
   },
 });
 ```
 
-Cài đặt với:
+Cài đặt bằng:
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -205,47 +205,47 @@ failproofai policies --install --custom ./my-policies.js
 
 ### Trợ giúp quyết định
 
-| Hàm | Hiệu quả |
+| Hàm | Hiệu ứng |
 |-----|---------|
-| `allow()` | Cho phép thao tác |
-| `allow(message)` | Cho phép và gửi bối cảnh thông tin đến Claude |
-| `deny(message)` | Chặn thao tác; tin nhắn được hiển thị cho Claude |
+| `allow()` | Cho phép hoạt động |
+| `allow(message)` | Cho phép và gửi bối cảnh thông tin tới Claude |
+| `deny(message)` | Chặn hoạt động; tin nhắn được hiển thị cho Claude |
 | `instruct(message)` | Thêm bối cảnh vào lời nhắc của Claude; không chặn |
 
-### Đối tượng ngữ cảnh (`ctx`)
+### Đối tượng bối cảnh (`ctx`)
 
 | Trường | Loại | Mô tả |
 |-------|------|-------|
 | `eventType` | `string` | `"PreToolUse"`, `"PostToolUse"`, `"Notification"`, `"Stop"` |
 | `toolName` | `string` | Công cụ được gọi (`"Bash"`, `"Write"`, `"Read"`, …) |
 | `toolInput` | `object` | Các tham số đầu vào của công cụ |
-| `payload` | `object` | Toàn bộ trọng tải sự kiện thô |
+| `payload` | `object` | Toàn bộ tải trọng sự kiện thô |
 | `session.cwd` | `string` | Thư mục làm việc của phiên Claude Code |
 | `session.sessionId` | `string` | Định danh phiên |
-| `session.transcriptPath` | `string` | Đường dẫn đến tệp phiên ghi âm |
+| `session.transcriptPath` | `string` | Đường dẫn tới tệp bảng lưu ý phiên |
 
-Hook tùy chỉnh hỗ trợ nhập cục bộ chuyển tiếp, async/await, và truy cập vào `process.env`. Các lỗi mở không kiểm soát được (ghi vào `~/.failproofai/hook.log`, các chính sách tích hợp sẵn tiếp tục). Xem [docs/custom-hooks.mdx](docs/custom-hooks.mdx) để biết hướng dẫn đầy đủ.
+Các hook tùy chỉnh hỗ trợ nhập cục bộ chuyên chở, async/await, và truy cập vào `process.env`. Các lỗi được mở rộng (ghi vào `~/.failproofai/hook.log`, các chính sách tích hợp tiếp tục). Xem [docs/custom-hooks.mdx](docs/custom-hooks.mdx) để biết hướng dẫn đầy đủ.
 
 ### Chính sách dựa trên quy ước
 
-Bỏ các tệp `*policies.{js,mjs,ts}` vào `.failproofai/policies/` và chúng sẽ tự động được tải — không cần cờ `--custom` hoặc thay đổi cấu hình. Hoạt động giống như git hooks: bỏ một tệp, nó chỉ hoạt động.
+Thả các tệp `*policies.{js,mjs,ts}` vào `.failproofai/policies/` và chúng sẽ được tự động tải - không cần cờ hoặc thay đổi cấu hình. Cam kết thư mục vào git và mọi thành viên trong nhóm sẽ tự động có được cùng tiêu chuẩn chất lượng.
 
 ```text
-# Cấp dự án — được commit vào git, chia sẻ với đội
+# Cấp độ dự án — cam kết vào git, chia sẻ với nhóm
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# Cấp người dùng — cá nhân, áp dụng cho tất cả các dự án
+# Cấp độ người dùng — cá nhân, áp dụng cho tất cả dự án
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-Cả hai cấp tải (hợp nhất). Các tệp được tải theo thứ tự bảng chữ cái trong mỗi thư mục. Tiền tố bằng `01-`, `02-`, v.v. để kiểm soát thứ tự. Xem [examples/convention-policies/](examples/convention-policies/) để biết các ví dụ sẵn sàng sử dụng.
+Cả hai cấp độ tải (hợp nhất). Các tệp được tải theo thứ tự bảng chữ cái trong mỗi thư mục. Tiền tố với `01-`, `02-`, v.v. để kiểm soát thứ tự. Khi nhóm của bạn khám phá ra các chế độ lỗi mới, hãy thêm một chính sách và đẩy - mọi người sẽ nhận được cập nhật trên pull tiếp theo của họ. Xem [examples/convention-policies/](examples/convention-policies/) để biết các ví dụ sẵn sàng sử dụng.
 
 ---
 
-## Telemetry
+## Viễn thông
 
-Failproof AI thu thập telemetry sử dụng ẩn danh thông qua PostHog để hiểu mức độ sử dụng tính năng. Nội dung phiên, tên tệp, đầu vào công cụ hoặc thông tin cá nhân không bao giờ được gửi.
+Failproof AI thu thập telemetry sử dụng ẩn danh qua PostHog để hiểu cách sử dụng tính năng. Không bao giờ gửi nội dung phiên, tên tệp, đầu vào công cụ hoặc thông tin cá nhân.
 
 Vô hiệu hóa nó:
 
@@ -260,12 +260,12 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 | Hướng dẫn | Mô tả |
 |---------|-------|
 | [Getting Started](docs/getting-started.mdx) | Cài đặt và các bước đầu tiên |
-| [Built-in Policies](docs/built-in-policies.mdx) | Tất cả 30 chính sách tích hợp sẵn với các tham số |
+| [Built-in Policies](docs/built-in-policies.mdx) | Tất cả 30 chính sách tích hợp với các tham số |
 | [Custom Policies](docs/custom-policies.mdx) | Viết các chính sách của riêng bạn |
 | [Configuration](docs/configuration.mdx) | Định dạng tệp cấu hình và hợp nhất phạm vi |
-| [Dashboard](docs/dashboard.mdx) | Giám sát các phiên và xem xét hoạt động chính sách |
+| [Dashboard](docs/dashboard.mdx) | Giám sát phiên và xem lại hoạt động chính sách |
 | [Architecture](docs/architecture.mdx) | Cách hệ thống hook hoạt động |
-| [Testing](docs/testing.mdx) | Chạy bài kiểm tra và viết các bài mới |
+| [Testing](docs/testing.mdx) | Chạy các bài kiểm tra và viết các bài kiểm tra mới |
 
 ### Chạy tài liệu cục bộ
 
@@ -274,7 +274,7 @@ docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
 
-Mở trang web tài liệu Mintlify tại `http://localhost:3000`. Container theo dõi các thay đổi nếu bạn gắn thư mục tài liệu:
+Mở trang web Mintlify docs tại `http://localhost:3000`. Container sẽ theo dõi các thay đổi nếu bạn gắn thư mục docs:
 
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -282,11 +282,11 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ---
 
-## Lưu ý cho những người đóng góp failproofai
+## Ghi chú cho những người đóng góp failproofai
 
 `.claude/settings.json` của repo này sử dụng `bun ./bin/failproofai.mjs --hook <EventType>` thay vì lệnh `npx -y failproofai` tiêu chuẩn. Điều này là vì chạy `npx -y failproofai` bên trong chính dự án failproofai tạo ra một xung đột tự tham chiếu.
 
-Đối với tất cả các repo khác, phương pháp được khuyến nghị là `npx -y failproofai`, được cài đặt thông qua:
+Đối với tất cả các repo khác, cách tiếp cận được khuyến nghị là `npx -y failproofai`, được cài đặt qua:
 
 ```bash
 failproofai policies --install --scope project
@@ -304,5 +304,4 @@ Xem [LICENSE](LICENSE).
 
 ---
 
-Được xây dựng và duy trì bởi **ExosphereHost: Phòng thí nghiệm nghiên cứu độ tin cậy cho Agents của bạn**. Chúng tôi giúp các doanh nghiệp và startup cải thiện độ tin cậy của các AI agents của họ thông qua các agents, phần mềm và chuyên môn của chính chúng tôi. Tìm hiểu thêm tại [exosphere.host](https://exosphere.host).
-```
+Được xây dựng và Bảo trì bởi **ExosphereHost: Reliability Research Lab cho các Agent của bạn**. Chúng tôi giúp các doanh nghiệp và startups cải thiện độ tin cậy của các AI agent của họ thông qua các agent, phần mềm và chuyên môn của riêng chúng tôi. Tìm hiểu thêm tại [exosphere.host](https://exosphere.host).

package/.next/standalone/docs/i18n/README.zh.md

@@ -21,23 +21,23 @@
 [![CI](https://img.shields.io/github/actions/workflow/status/exospherehost/failproofai/ci.yml?branch=main&style=flat-square&label=CI)](https://github.com/exospherehost/failproofai/actions)
 [![Slack](https://img.shields.io/badge/Slack-join%20us-4A154B?style=flat-square&logo=slack)](https://join.slack.com/t/failproofai/shared_invite/zt-3v63b7k5e-O3NBHmj8X6n9gZSGDx6ggQ)
 
-**语言版本**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
+**翻译版本**: [简体中文](docs/i18n/README.zh.md) | [日本語](docs/i18n/README.ja.md) | [한국어](docs/i18n/README.ko.md) | [Español](docs/i18n/README.es.md) | [Português](docs/i18n/README.pt-br.md) | [Deutsch](docs/i18n/README.de.md) | [Français](docs/i18n/README.fr.md) | [Русский](docs/i18n/README.ru.md) | [हिन्दी](docs/i18n/README.hi.md) | [Türkçe](docs/i18n/README.tr.md) | [Tiếng Việt](docs/i18n/README.vi.md) | [Italiano](docs/i18n/README.it.md) | [العربية](docs/i18n/README.ar.md) | [עברית](docs/i18n/README.he.md)
 
-管理策略的最简方式，让你的 AI 智能体保持可靠、专注任务、自主运行 —— 适用于 **Claude Code** 和 **Agents SDK**。
+管理策略的最简方式，让你的 AI 智能体保持可靠、专注任务、自主运行——适用于 **Claude Code** 与 **Agents SDK**。
 
-- **30 条内置策略** - 开箱即用，捕捉常见的智能体故障模式。阻止破坏性命令、防止密钥泄露、将智能体限制在项目边界内、检测死循环等。
-- **自定义策略** - 用 JavaScript 编写你自己的可靠性规则。使用 `allow`/`deny`/`instruct` API 来执行规范、防止偏差、管控操作，或与外部系统集成。
-- **简便配置** - 无需编写代码即可调整任意策略。可按项目或全局设置白名单、受保护分支、阈值。三级配置作用域自动合并。
-- **智能体监控** - 查看智能体在你离开时的所有操作。浏览会话记录、检查每次工具调用，精确回溯策略触发位置。
+- **30 条内置策略** - 开箱即用，覆盖常见智能体故障模式。拦截破坏性命令、防止密钥泄露、将智能体限制在项目边界内、检测循环，以及更多功能。
+- **自定义策略** - 用 JavaScript 编写你自己的可靠性规则。使用 `allow`/`deny`/`instruct` API 来强制执行约定、防止偏差、管控操作，或与外部系统集成。
+- **简易配置** - 无需编写代码即可调整任何策略。可按项目或全局设置白名单、受保护分支、阈值等。三级配置自动合并。
+- **智能体监控面板** - 查看你离开时智能体的所有操作。浏览会话、检查每次工具调用，以及精确回溯策略触发的位置。
 
-所有内容均在本地运行 —— 数据不会离开你的机器。
+所有功能均在本地运行——数据不会离开你的设备。
 
 ---
 
 ## 环境要求
 
 - Node.js >= 20.9.0
-- Bun >= 1.3.0（可选 —— 仅在开发或从源码构建时需要）
+- Bun >= 1.3.0（可选——仅在开发或从源码构建时需要）
 
 ---
 
@@ -59,17 +59,17 @@ bun add -g failproofai
 failproofai policies --install
 ```
 
-将 hook 条目写入 `~/.claude/settings.json`。此后 Claude Code 将在每次工具调用前后自动调用 failproofai。
+将 hook 配置写入 `~/.claude/settings.json`。此后 Claude Code 将在每次工具调用前后自动触发 failproofai。
 
-### 2. 启动控制台
+### 2. 启动控制面板
 
 ```bash
 failproofai
 ```
 
-打开 `http://localhost:8020` —— 浏览会话记录、查看日志、管理策略。
+打开 `http://localhost:8020`——浏览会话、检查日志、管理策略。
 
-### 3. 查看当前启用的策略
+### 3. 查看当前生效的策略
 
 ```bash
 failproofai policies
@@ -84,8 +84,8 @@ failproofai policies
 | 作用域 | 命令 | 写入位置 |
 |--------|------|----------|
 | 全局（默认） | `failproofai policies --install` | `~/.claude/settings.json` |
-| 项目级 | `failproofai policies --install --scope project` | `.claude/settings.json` |
-| 本地级 | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
+| 项目 | `failproofai policies --install --scope project` | `.claude/settings.json` |
+| 本地 | `failproofai policies --install --scope local` | `.claude/settings.local.json` |
 
 ### 安装特定策略
 
@@ -97,7 +97,7 @@ failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
 
 ```bash
 failproofai policies --uninstall
-# 或针对特定作用域：
+# 或指定作用域：
 failproofai policies --uninstall --scope project
 ```
 
@@ -105,7 +105,7 @@ failproofai policies --uninstall --scope project
 
 ## 配置
 
-策略配置文件位于全局的 `~/.failproofai/policies-config.json`，或项目级的 `.failproofai/policies-config.json`。
+策略配置存放于 `~/.failproofai/policies-config.json`（全局）或项目目录下的 `.failproofai/policies-config.json`（按项目）。
 
 ```json
 {
@@ -138,48 +138,48 @@ failproofai policies --uninstall --scope project
 }
 ```
 
-**三级配置作用域**自动合并（项目级 → 本地级 → 全局）。完整合并规则请参阅 [docs/configuration.mdx](docs/configuration.mdx)。
+**三级配置作用域**会自动合并（项目 → 本地 → 全局）。完整的合并规则请参阅 [docs/configuration.mdx](docs/configuration.mdx)。
 
 ---
 
 ## 内置策略
 
-| 策略 | 说明 | 可配置项 |
+| 策略 | 描述 | 可配置项 |
 |------|------|:--------:|
-| `block-sudo` | 阻止智能体运行特权系统命令 | `allowPatterns` |
-| `block-rm-rf` | 防止意外递归删除文件 | `allowPaths` |
-| `block-curl-pipe-sh` | 阻止智能体将不可信脚本通过管道传入 shell | |
-| `block-failproofai-commands` | 防止自卸载 | |
-| `sanitize-jwt` | 阻止 JWT 令牌泄露到智能体上下文中 | |
-| `sanitize-api-keys` | 阻止 API 密钥泄露到智能体上下文中 | `additionalPatterns` |
-| `sanitize-connection-strings` | 阻止数据库凭据泄露到智能体上下文中 | |
+| `block-sudo` | 阻止智能体执行特权系统命令 | `allowPatterns` |
+| `block-rm-rf` | 防止误操作递归删除文件 | `allowPaths` |
+| `block-curl-pipe-sh` | 阻止智能体将不可信脚本通过管道传入 shell 执行 | |
+| `block-failproofai-commands` | 防止自我卸载 | |
+| `sanitize-jwt` | 阻止 JWT 令牌泄露到智能体上下文 | |
+| `sanitize-api-keys` | 阻止 API 密钥泄露到智能体上下文 | `additionalPatterns` |
+| `sanitize-connection-strings` | 阻止数据库凭据泄露到智能体上下文 | |
 | `sanitize-private-key-content` | 从输出中脱敏 PEM 私钥块 | |
 | `sanitize-bearer-tokens` | 从输出中脱敏 Authorization Bearer 令牌 | |
 | `block-env-files` | 阻止智能体读取 .env 文件 | |
-| `protect-env-vars` | 防止智能体打印环境变量 | |
+| `protect-env-vars` | 阻止智能体打印环境变量 | |
 | `block-read-outside-cwd` | 将智能体限制在项目边界内 | `allowPaths` |
-| `block-secrets-write` | 防止向私钥和证书文件写入内容 | `additionalPatterns` |
-| `block-push-master` | 防止意外推送到 main/master 分支 | `protectedBranches` |
-| `block-work-on-main` | 阻止智能体在受保护分支上操作 | `protectedBranches` |
+| `block-secrets-write` | 阻止向私钥和证书文件写入内容 | `additionalPatterns` |
+| `block-push-master` | 防止误推送至 main/master 分支 | `protectedBranches` |
+| `block-work-on-main` | 阻止智能体在受保护分支上工作 | `protectedBranches` |
 | `block-force-push` | 阻止 `git push --force` | |
 | `warn-git-amend` | 在修改提交前提醒智能体 | |
-| `warn-git-stash-drop` | 在丢弃 stash 前提醒智能体 | |
-| `warn-all-files-staged` | 捕获意外的 `git add -A` | |
+| `warn-git-stash-drop` | 在丢弃暂存前提醒智能体 | |
+| `warn-all-files-staged` | 捕获误操作的 `git add -A` | |
 | `warn-destructive-sql` | 在执行前捕获 DROP/DELETE SQL | |
 | `warn-schema-alteration` | 在执行前捕获 ALTER TABLE | |
 | `warn-large-file-write` | 捕获意外的大文件写入 | `thresholdKb` |
 | `warn-package-publish` | 捕获意外的 `npm publish` | |
-| `warn-background-process` | 捕获意外启动的后台进程 | |
+| `warn-background-process` | 捕获意外的后台进程启动 | |
 | `warn-global-package-install` | 捕获意外的全局包安装 | |
 | ……以及更多 | | |
 
-完整策略详情和参数参考：[docs/built-in-policies.mdx](docs/built-in-policies.mdx)
+完整策略说明及参数参考：[docs/built-in-policies.mdx](docs/built-in-policies.mdx)
 
 ---
 
 ## 自定义策略
 
-编写你自己的策略，让智能体保持可靠和专注：
+编写你自己的策略，让智能体保持可靠并专注于任务：
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -209,43 +209,43 @@ failproofai policies --install --custom ./my-policies.js
 |------|------|
 | `allow()` | 允许该操作 |
 | `allow(message)` | 允许操作，并向 Claude 发送信息性上下文 |
-| `deny(message)` | 阻止操作；消息将显示给 Claude |
-| `instruct(message)` | 向 Claude 的提示词中添加上下文；不阻止操作 |
+| `deny(message)` | 阻止操作；消息显示给 Claude |
+| `instruct(message)` | 向 Claude 的提示词中添加上下文；不会阻止操作 |
 
 ### 上下文对象（`ctx`）
 
-| 字段 | 类型 | 说明 |
+| 字段 | 类型 | 描述 |
 |------|------|------|
 | `eventType` | `string` | `"PreToolUse"`、`"PostToolUse"`、`"Notification"`、`"Stop"` |
 | `toolName` | `string` | 被调用的工具（`"Bash"`、`"Write"`、`"Read"`……） |
 | `toolInput` | `object` | 工具的输入参数 |
-| `payload` | `object` | 完整的原始事件负载 |
+| `payload` | `object` | 完整的原始事件载荷 |
 | `session.cwd` | `string` | Claude Code 会话的工作目录 |
 | `session.sessionId` | `string` | 会话标识符 |
-| `session.transcriptPath` | `string` | 会话记录文件路径 |
+| `session.transcriptPath` | `string` | 会话记录文件的路径 |
 
-自定义 hook 支持传递式本地导入、async/await，以及访问 `process.env`。错误采用开放失败策略（记录到 `~/.failproofai/hook.log`，内置策略继续执行）。完整指南请参阅 [docs/custom-hooks.mdx](docs/custom-hooks.mdx)。
+自定义 hook 支持传递式本地导入、async/await，以及访问 `process.env`。发生错误时采用失败开放策略（日志写入 `~/.failproofai/hook.log`，内置策略继续运行）。完整指南请参阅 [docs/custom-hooks.mdx](docs/custom-hooks.mdx)。
 
 ### 基于约定的策略
 
-将 `*policies.{js,mjs,ts}` 文件放入 `.failproofai/policies/` 目录，它们会被自动加载 —— 无需 `--custom` 标志或任何配置变更。就像 git hooks 一样：放入文件即可生效。
+将 `*policies.{js,mjs,ts}` 文件放入 `.failproofai/policies/` 目录，它们会被自动加载——无需任何参数或配置变更。将该目录提交到 git，团队所有成员即可自动获得相同的质量标准。
 
 ```text
-# 项目级 —— 提交到 git，与团队共享
+# 项目级别——提交到 git，与团队共享
 .failproofai/policies/security-policies.mjs
 .failproofai/policies/workflow-policies.mjs
 
-# 用户级 —— 个人专属，适用于所有项目
+# 用户级别——个人专用，适用于所有项目
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-两个级别均会加载（取并集）。同一目录内的文件按字母顺序加载。可使用 `01-`、`02-` 等前缀控制加载顺序。开箱即用的示例请参阅 [examples/convention-policies/](examples/convention-policies/)。
+两个级别的策略会同时加载（取并集）。每个目录内的文件按字母顺序加载。可添加 `01-`、`02-` 等前缀来控制加载顺序。每当团队发现新的故障模式，添加一条策略并推送——所有人下次拉取后即可获得更新。可参考 [examples/convention-policies/](examples/convention-policies/) 中的即用示例。
 
 ---
 
 ## 遥测
 
-Failproof AI 通过 PostHog 收集匿名使用遥测数据，以了解功能使用情况。我们从不发送任何会话内容、文件名、工具输入或个人信息。
+Failproof AI 通过 PostHog 收集匿名使用遥测数据，以了解功能使用情况。任何会话内容、文件名、工具输入或个人信息均不会被发送。
 
 禁用遥测：
 
@@ -257,13 +257,13 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 
 ## 文档
 
-| 指南 | 说明 |
+| 指南 | 描述 |
 |------|------|
-| [入门指南](docs/getting-started.mdx) | 安装与初步使用 |
+| [快速入门](docs/getting-started.mdx) | 安装与初始步骤 |
 | [内置策略](docs/built-in-policies.mdx) | 全部 30 条内置策略及参数说明 |
 | [自定义策略](docs/custom-policies.mdx) | 编写你自己的策略 |
 | [配置](docs/configuration.mdx) | 配置文件格式与作用域合并规则 |
-| [控制台](docs/dashboard.mdx) | 监控会话并查看策略活动 |
+| [控制面板](docs/dashboard.mdx) | 监控会话与审查策略活动 |
 | [架构](docs/architecture.mdx) | hook 系统的工作原理 |
 | [测试](docs/testing.mdx) | 运行测试与编写新测试 |
 
@@ -274,7 +274,7 @@ docker build -f Dockerfile.docs -t failproofai-docs .
 docker run --rm -p 3000:3000 failproofai-docs
 ```
 
-在 `http://localhost:3000` 打开 Mintlify 文档站点。如果挂载 docs 目录，容器将监听文件变更：
+在 `http://localhost:3000` 打开 Mintlify 文档站点。如果挂载 docs 目录，容器会监听文件变更：
 
 ```bash
 docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
@@ -286,7 +286,7 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 本仓库的 `.claude/settings.json` 使用 `bun ./bin/failproofai.mjs --hook <EventType>` 而非标准的 `npx -y failproofai` 命令。这是因为在 failproofai 项目内部运行 `npx -y failproofai` 会产生自引用冲突。
 
-对于所有其他仓库，推荐使用 `npx -y failproofai`，通过以下命令安装：
+对于其他所有仓库，推荐使用 `npx -y failproofai`，通过以下方式安装：
 
 ```bash
 failproofai policies --install --scope project
@@ -304,4 +304,4 @@ failproofai policies --install --scope project
 
 ---
 
-由 **ExosphereHost: 智能体可靠性研究实验室** 构建与维护。我们通过自研智能体、软件和专业知识，帮助企业和初创公司提升 AI 智能体的可靠性。了解更多请访问 [exosphere.host](https://exosphere.host)。
+由 **ExosphereHost：智能体可靠性研究实验室** 构建与维护。我们通过自主研发的智能体、软件和专业知识，帮助企业和初创公司提升 AI 智能体的可靠性。了解更多请访问 [exosphere.host](https://exosphere.host)。