本地配置 - 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

并非所有 harness 都支持本地范围。如果所选 harness 不支持指定的范围，CLI 会拒绝执行。

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

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

配置策略参数

控制台
CLI

在本地控制台中打开对应策略，编辑其支持的参数，然后在所选范围内保存。运行一个匹配和一个不匹配的 Agent 操作，再在 Observe → policy 中查看决策结果。

编辑所选范围的 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。项目策略配置和项目约定策略只有在将其作为执行代码进行审查后，才可提交到仓库。

​选择策略范围

​配置策略参数

​了解机器级文件

选择策略范围

配置策略参数

了解机器级文件