本地配置 - Failproof AI

Failproof AI 将策略选择与机器和守护进程设置分离。这样既能让仓库中的策略选择保持可审查性，又能将凭据和守护进程状态保留在仓库之外。

选择策略范围

控制台
CLI

不带参数运行 failproofai 可打开本地策略控制台。在启用策略之前，先选择用户、项目或本地范围，确保更改写入到正确的配置文件。

用户：应用于本机上的所有项目。
项目：属于仓库，可以提交。
本地：针对某一用户覆盖单个项目，应保留在 gitignore 中。

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

并非所有执行器都支持本地范围。如果所选执行器无法表示该范围，CLI 将拒绝执行。

范围	策略配置文件
项目	`<project>/.failproofai/policies-config.json`
本地	`<project>/.failproofai/policies-config.local.json`
用户	`~/.failproofai/policies-config.json`

已启用的策略以并集方式合并。策略参数按项目 → 本地 → 用户的顺序，使用第一个为该策略定义了参数的范围。显式自定义策略路径同样使用第一个定义它们的范围。

配置策略参数

控制台
CLI

在本地控制台中打开策略，编辑其支持的参数，然后在选定范围内保存。运行一个匹配及一个不匹配的代理操作，然后在 观察 → 策略 中查看决策结果。

编辑所选范围的 policies-config.json，然后运行 failproofai policies 以检测未知的策略名称或参数键。

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

failproofai policies

了解机器文件

~/.failproofai 包含针对不同信任边界的独立文件：

路径	用途
`config.json`	非敏感的守护进程、审计及遥测设置
`credentials.json`	云凭据；以仅所有者可读的权限存储
`policies-config.json`	用户范围内置策略选择、参数及显式自定义路径
`policies/`	用户约定策略及云托管策略工件
`hook-activity/`	本地策略决策日志
`state/`	守护进程队列、健康状态、暂停及运行时状态

使用 FAILPROOFAI_HOME 可为容器或隔离测试重新指定完整的机器布局目录。请勿单独迁移各个状态目录。

切勿提交 credentials.json。仅在将项目策略配置和项目约定策略作为执行代码审查后，才可提交它们。

​选择策略范围

​配置策略参数

​了解机器文件

选择策略范围

配置策略参数

了解机器文件