failproofai 0.0.5 → 0.0.6-beta.1

package/.next/standalone/docs/i18n/README.vi.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)
 
-**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)
+**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)
 
-Cách dễ nhất để quản lý các chính sách giữ cho các agent AI 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**.
+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**.
 
-- **30 Chính sách tích hợp sẵn** - Bắt các lỗi phổ biến của agent ngay từ đầu. 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à 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ự trôi dạt, kiểm soát các phép toán 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, nhánh được bảo vệ, ngưỡng cho từng dự án hoặc toàn cầu. Hợp nhất cấu hình ba phạm vi 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 các phiên, 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 kích hoạt.
+- **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.
 
-Mọi thứ chạy cục bộ - không có dữ liệu nào rời khỏi máy tính của bạn.
+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.
 
 ---
 
 ## Yêu cầu
 
 - Node.js >= 20.9.0
-- Bun >= 1.3.0 (tùy chọn - chỉ cần thiết để phát triển / xây dựng từ nguồn)
+- Bun >= 1.3.0 (tùy chọn - chỉ cần thiết cho phát triển / xây dựng từ nguồn)
 
 ---
 
@@ -53,7 +53,7 @@ bun add -g failproofai
 
 ## Bắt đầu nhanh
 
-### 1. Bật chính sách trên toàn cầu
+### 1. Bật chính sách toàn cục
 
 ```bash
 failproofai policies --install
@@ -61,13 +61,13 @@ 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ụ.
 
-### 2. Khởi chạy bảng điều khiển
+### 2. Khởi động bảng điều khiển
 
 ```bash
 failproofai
 ```
 
-Mở `http://localhost:8020` - duyệt các phiên, kiểm tra nhật ký, quản lý chính sách.
+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.
 
 ### 3. Kiểm tra những gì đang hoạt động
 
@@ -81,9 +81,9 @@ failproofai policies
 
 ### Phạm vi
 
-| Phạm vi | Lệnh | Nơi nó ghi |
-|--------|------|-----------|
-| Toàn cầu (mặc định) | `failproofai policies --install` | `~/.claude/settings.json` |
+| Phạm vi | Lệnh | Nơi ghi |
+|--------|------|---------|
+| Toàn cục (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` |
 
@@ -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ầu) hoặc `.failproofai/policies-config.json` trong dự án của bạn (mỗi dự án).
+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).
 
 ```json
 {
@@ -120,15 +120,15 @@ 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": "Sử dụng apt-get trực tiếp mà không cần sudo."
+      "hint": "Use apt-get directly without sudo."
     },
     "block-push-master": {
       "protectedBranches": ["main", "release", "prod"],
-      "hint": "Hãy thử tạo một nhánh mới thay vào đó."
+      "hint": "Try creating a fresh branch instead."
     },
     "sanitize-api-keys": {
       "additionalPatterns": [
-        { "regex": "myco_[A-Za-z0-9]{32}", "label": "Khóa API MyCo" }
+        { "regex": "myco_[A-Za-z0-9]{32}", "label": "MyCo API key" }
       ]
     },
     "warn-large-file-write": {
@@ -138,39 +138,39 @@ 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ầu). 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 (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 đủ.
 
 ---
 
 ## Chính sách tích hợp sẵn
 
 | Chính sách | Mô tả | Có thể cấu hình |
-|-----------|--------|:---:|
-| `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 xóa tệp đệ quy vô tình | `allowPaths` |
-| `block-curl-pipe-sh` | Ngăn chặn các agent đưa các tập lệnh không đáng tin cậy vào shell | |
-| `block-failproofai-commands` | Ngăn chặn tự dỡ cài đặt | |
-| `sanitize-jwt` | Dừng các mã thông báo JWT bị rò rỉ vào ngữ cảnh agent | |
-| `sanitize-api-keys` | Dừng các khóa API bị 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 bị rò rỉ vào ngữ 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 Bearer Authorization khỏi đầu ra | |
-| `block-env-files` | Ngăn chặn các agent đọc tệp .env | |
-| `protect-env-vars` | Ngăn chặn các agent in các biến môi trường | |
-| `block-read-outside-cwd` | Giữ các agent 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 đẩy vô tình tới main/master | `protectedBranches` |
-| `block-work-on-main` | Giữ các agent không ở 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 xóa stashes | |
+|-----------|-------|:---:|
+| `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 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 bất ngờ | `thresholdKb` |
+| `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 quá trình nền không dự định | |
-| `warn-global-package-install` | Bắt cài đặt gói toàn cầu không dự đị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 | | |
 
 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,19 +179,19 @@ 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 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:
+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ụ:
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
 
 customPolicies.add({
   name: "no-production-writes",
-  description: "Chặn ghi vào các đường dẫn chứa 'production'",
+  description: "Block writes to paths containing '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("Ghi vào các đường dẫn production bị chặn");
+    if (path.includes("production")) return deny("Writes to production paths are blocked");
     return allow();
   },
 });
@@ -205,49 +205,49 @@ failproofai policies --install --custom ./my-policies.js
 
 ### Trợ giúp quyết định
 
-| Hàm | Hiệu ứng |
+| Hàm | Hiệu quả |
 |-----|---------|
 | `allow()` | Cho phép thao tác |
-| `allow(message)` | Cho phép và gửi ngữ cảnh thông tin tới Claude |
-| `deny(message)` | Chặn thao tác; thông báo được hiển thị tới Claude |
-| `instruct(message)` | Thêm ngữ cảnh vào yêu cầu của Claude; không chặn |
+| `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 |
+| `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`)
 
 | 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` | Tham số đầu vào của công cụ |
-| `payload` | `object` | Tải trọng sự kiện thô đầy đủ |
+| `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ô |
 | `session.cwd` | `string` | Thư mục làm việc của phiên Claude Code |
-| `session.sessionId` | `string` | Mã định danh phiên |
+| `session.sessionId` | `string` | Định danh phiên |
 | `session.transcriptPath` | `string` | Đường dẫn đến tệp phiên ghi âm |
 
-Các hook tùy chỉnh hỗ trợ nhập cục bộ chuyển tiếp, async/await và truy cập `process.env`. Các lỗi là fail-open (đượ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 đủ.
+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 đủ.
 
 ### Chính sách dựa trên quy ước
 
-Thả các tệp `*policies.{js,mjs,ts}` vào `.failproofai/policies/` và chúng sẽ được tải tự động — không cần cờ `--custom` hoặc thay đổi cấu hình. Hoạt động giống như git hooks: thả một tệp, nó hoạt động.
+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.
 
 ```text
-# Cấp độ dự án — được commit vào git, chia sẻ với nhóm
+# Cấp dự án — được commit vào git, chia sẻ với đội
 .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ả các dự án
 ~/.failproofai/policies/my-policies.mjs
 ```
 
-Cả hai cấp độ đều tải (union). 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ự. 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ố 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.
 
 ---
 
-## Đo lường hiệu suất
+## Telemetry
 
-Failproof AI thu thập telemetry sử dụng ẩn danh thông 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.
+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.
 
-Tắt nó:
+Vô hiệu hóa nó:
 
 ```bash
 FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
@@ -258,14 +258,14 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 ## Tài liệu
 
 | 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ố |
-| [Custom Policies](docs/custom-policies.mdx) | Viết chính sách của riêng bạn |
+| [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 |
 | [Architecture](docs/architecture.mdx) | Cách hệ thống hook hoạt động |
-| [Testing](docs/testing.mdx) | Chạy các bài kiểm tra và viết bài kiểm tra mới |
+| [Testing](docs/testing.mdx) | Chạy bài kiểm tra và viết các bài 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 Mintlify docs tại `http://localhost:3000`. Container theo dõi những thay đổi nếu bạn gắn thư mục tài liệu:
+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:
 
 ```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
 
 ---
 
-## Ghi chú cho những người đóng góp failproofai
+## Lưu ý cho những người đóng góp failproofai
 
-Tệp `.claude/settings.json` của kho 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 xung đột tự tham chiếu.
+`.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 kho 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, phương pháp được khuyến nghị là `npx -y failproofai`, được cài đặt thông qua:
 
 ```bash
 failproofai policies --install --scope project
@@ -304,5 +304,5 @@ 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 các Agent của bạn**. Chúng tôi giúp các doanh nghiệp và các công ty khởi nghiệp cải thiện độ tin cậy của các agent AI của họ thông qua các agent, phần mềm và chuyên môn của chúng tôi. Tìm hiểu thêm tại [exosphere.host](https://exosphere.host).
+Đượ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).
 ```

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,7 +59,7 @@ bun add -g failproofai
 failproofai policies --install
 ```
 
-将 hook 条目写入 `~/.claude/settings.json`。Claude Code 此后将在每次工具调用前后调用 failproofai。
+将 hook 条目写入 `~/.claude/settings.json`。此后 Claude Code 将在每次工具调用前后自动调用 failproofai。
 
 ### 2. 启动控制台
 
@@ -67,7 +67,7 @@ failproofai policies --install
 failproofai
 ```
 
-打开 `http://localhost:8020`——浏览会话、查看日志、管理策略。
+打开 `http://localhost:8020` —— 浏览会话记录、查看日志、管理策略。
 
 ### 3. 查看当前启用的策略
 
@@ -82,12 +82,12 @@ 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` |
 
-### 安装指定策略
+### 安装特定策略
 
 ```bash
 failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
@@ -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,32 +138,32 @@ 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` | 防止数据库凭据泄露到智能体上下文中 | |
-| `sanitize-private-key-content` | 从输出中删除 PEM 私钥块 | |
-| `sanitize-bearer-tokens` | 从输出中删除 Authorization Bearer 令牌 | |
+| `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` | 在丢弃储藏区前提醒智能体 | |
+| `warn-git-stash-drop` | 在丢弃 stash 前提醒智能体 | |
 | `warn-all-files-staged` | 捕获意外的 `git add -A` | |
 | `warn-destructive-sql` | 在执行前捕获 DROP/DELETE SQL | |
 | `warn-schema-alteration` | 在执行前捕获 ALTER TABLE | |
@@ -171,7 +171,7 @@ failproofai policies --uninstall --scope project
 | `warn-package-publish` | 捕获意外的 `npm publish` | |
 | `warn-background-process` | 捕获意外启动的后台进程 | |
 | `warn-global-package-install` | 捕获意外的全局包安装 | |
-| …以及更多 | | |
+| ……以及更多 | | |
 
 完整策略详情和参数参考：[docs/built-in-policies.mdx](docs/built-in-policies.mdx)
 
@@ -179,7 +179,7 @@ failproofai policies --uninstall --scope project
 
 ## 自定义策略
 
-编写你自己的策略，使智能体保持可靠并专注任务：
+编写你自己的策略，让智能体保持可靠和专注：
 
 ```js
 import { customPolicies, allow, deny, instruct } from "failproofai";
@@ -197,7 +197,7 @@ customPolicies.add({
 });
 ```
 
-通过以下命令安装：
+安装方式：
 
 ```bash
 failproofai policies --install --custom ./my-policies.js
@@ -208,44 +208,44 @@ failproofai policies --install --custom ./my-policies.js
 | 函数 | 效果 |
 |------|------|
 | `allow()` | 允许该操作 |
-| `allow(message)` | 允许并向 Claude 发送信息性上下文 |
-| `deny(message)` | 阻止该操作；消息将显示给 Claude |
-| `instruct(message)` | 向 Claude 的提示词添加上下文；不会阻止操作 |
+| `allow(message)` | 允许操作，并向 Claude 发送信息性上下文 |
+| `deny(message)` | 阻止操作；消息将显示给 Claude |
+| `instruct(message)` | 向 Claude 的提示词中添加上下文；不阻止操作 |
 
 ### 上下文对象（`ctx`）
 
 | 字段 | 类型 | 说明 |
 |------|------|------|
 | `eventType` | `string` | `"PreToolUse"`、`"PostToolUse"`、`"Notification"`、`"Stop"` |
-| `toolName` | `string` | 被调用的工具（`"Bash"`、`"Write"`、`"Read"` 等） |
+| `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/` 目录，它们会被自动加载 —— 无需 `--custom` 标志或任何配置变更。就像 git hooks 一样：放入文件即可生效。
 
 ```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 收集匿名使用遥测数据，以了解功能使用情况。我们从不发送任何会话内容、文件名、工具输入或个人信息。
 
 禁用遥测：
 
@@ -259,8 +259,8 @@ FAILPROOFAI_TELEMETRY_DISABLED=1 failproofai
 
 | 指南 | 说明 |
 |------|------|
-| [快速入门](docs/getting-started.mdx) | 安装与初步使用 |
-| [内置策略](docs/built-in-policies.mdx) | 全部 30 条内置策略及其参数 |
+| [入门指南](docs/getting-started.mdx) | 安装与初步使用 |
+| [内置策略](docs/built-in-policies.mdx) | 全部 30 条内置策略及参数说明 |
 | [自定义策略](docs/custom-policies.mdx) | 编写你自己的策略 |
 | [配置](docs/configuration.mdx) | 配置文件格式与作用域合并规则 |
 | [控制台](docs/dashboard.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
@@ -282,26 +282,26 @@ docker run --rm -p 3000:3000 -v $(pwd)/docs:/app/docs failproofai-docs
 
 ---
 
-## 致 failproofai 贡献者的说明
+## failproofai 贡献者须知
 
 本仓库的 `.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
 ```
 
-## 贡献指南
+## 参与贡献
 
-参见 [CONTRIBUTING.md](CONTRIBUTING.md)。
+请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。
 
 ---
 
 ## 许可证
 
-参见 [LICENSE](LICENSE)。
+请参阅 [LICENSE](LICENSE)。
 
 ---
 
-由 **ExosphereHost: 智能体可靠性研究实验室** 构建与维护。我们通过自研智能体、软件和专业知识，帮助企业和初创公司提升 AI 智能体的可靠性。了解更多，请访问 [exosphere.host](https://exosphere.host)。
+由 **ExosphereHost: 智能体可靠性研究实验室** 构建与维护。我们通过自研智能体、软件和专业知识，帮助企业和初创公司提升 AI 智能体的可靠性。了解更多请访问 [exosphere.host](https://exosphere.host)。