> ## Documentation Index
> Fetch the complete documentation index at: https://docs.befailproof.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Cấu hình cục bộ

> Kiểm soát phạm vi chính sách, tham số, tệp tùy chỉnh và cài đặt Failproof AI cấp máy.

Failproof AI tách rời việc lựa chọn chính sách khỏi cài đặt máy và daemon. Điều này giữ cho lựa chọn chính sách kho lưu trữ có thể được xem xét, trong khi thông tin xác thực và trạng thái daemon ở bên ngoài kho lưu trữ.

## Chọn phạm vi chính sách

<Tabs>
  <Tab title="Dashboard">
    Chạy `failproofai` mà không có tham số để mở bảng điều khiển chính sách cục bộ. Chọn phạm vi người dùng, dự án hoặc cục bộ trước khi bật chính sách để thay đổi được ghi vào tệp cấu hình dự định.

    * **User** áp dụng trên các dự án trên máy này.
    * **Project** thuộc kho lưu trữ và có thể được cam kết.
    * **Local** ghi đè một dự án cho một người dùng và phải giữ trong gitignore.
  </Tab>

  <Tab title="CLI">
    ```bash theme={null}
    failproofai policy add block-rm-rf --scope user
    failproofai policy add block-force-push --scope project
    failproofai policy add warn-large-file-write --scope local
    failproofai policies
    ```

    Không phải mọi harness đều hỗ trợ phạm vi cục bộ. CLI từ chối một phạm vi mà harness được chọn không thể đại diện.
  </Tab>
</Tabs>

| Phạm vi | Tệp cấu hình chính sách                             |
| ------- | --------------------------------------------------- |
| Project | `<project>/.failproofai/policies-config.json`       |
| Local   | `<project>/.failproofai/policies-config.local.json` |
| User    | `~/.failproofai/policies-config.json`               |

Các chính sách được bật được hợp nhất dưới dạng một liên kết. Các tham số chính sách sử dụng phạm vi đầu tiên xác định tham số cho chính sách đó, theo thứ tự project → local → user. Đường dẫn chính sách tùy chỉnh rõ ràng sử dụng phạm vi đầu tiên xác định chúng.

## Cấu hình tham số chính sách

<Tabs>
  <Tab title="Dashboard">
    Mở chính sách trong bảng điều khiển cục bộ, chỉnh sửa các tham số được hỗ trợ của nó, và lưu trong phạm vi được chọn. Chạy một hành động agent phù hợp và không phù hợp, sau đó kiểm tra quyết định trong **Observe → policy**.
  </Tab>

  <Tab title="CLI">
    Chỉnh sửa tệp `policies-config.json` của phạm vi được chọn, sau đó chạy `failproofai policies` để hiển thị các tên chính sách hoặc khóa tham số không xác định.

    ```json theme={null}
    {
      "enabledPolicies": ["block-rm-rf", "block-force-push"],
      "policyParams": {
        "block-rm-rf": {
          "allowPaths": ["/tmp/build-output"]
        }
      }
    }
    ```

    ```bash theme={null}
    failproofai policies
    ```
  </Tab>
</Tabs>

## Hiểu các tệp trên máy

`~/.failproofai` chứa các tệp riêng biệt cho các ranh giới tin tưởng riêng biệt:

| Đường dẫn              | Mục đích                                                                    |
| ---------------------- | --------------------------------------------------------------------------- |
| `config.json`          | Cài đặt daemon, kiểm tra và telemetry không bí mật                          |
| `credentials.json`     | Thông tin xác thực đám mây; được lưu trữ với quyền chỉ dành cho chủ sở hữu  |
| `policies-config.json` | Lựa chọn builtin phạm vi người dùng, tham số và đường dẫn tùy chỉnh rõ ràng |
| `policies/`            | Chính sách quy ước người dùng và tạo phẩm chính sách do đám mây quản lý     |
| `hook-activity/`       | Nhật ký quyết định chính sách cục bộ                                        |
| `state/`               | Daemon spool, health, pause và trạng thái runtime                           |

Sử dụng `FAILPROOFAI_HOME` để thay đổi bố cục máy hoàn chỉnh cho một container hoặc bài kiểm tra cô lập. Không thay đổi các thư mục trạng thái riêng lẻ một cách độc lập.

<Warning>
  Không bao giờ cam kết `credentials.json`. Chỉ cam kết cấu hình chính sách dự án và chính sách quy ước dự án sau khi xem xét chúng như mã thực thi.
</Warning>