failproofai 0.0.3 → 0.0.4

package/.next/standalone/docs/zh/built-in-policies.mdx

@@ -1,57 +1,57 @@
 ---
 title: 内置策略
-description: "涵盖常见智能体失败模式的全部 30 条内置策略"
+description: "涵盖常见代理失败模式的全部 30 条内置策略"
 icon: shield
 ---
 
-failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式。每条策略会在特定的钩子事件类型和工具名称上触发。其中九条策略支持参数配置，让你无需编写代码即可调整其行为。四条 beta 工作流策略会强制执行提交 → 推送 → PR → CI 流水线，直至 Claude 停止运行。
+failproofai 内置了 30 条策略，用于捕获常见的代理失败模式。每条策略针对特定的钩子事件类型和工具名称触发。其中 9 条策略支持参数配置，无需编写代码即可调整行为。4 条工作流策略会在 Claude 停止前强制执行提交 → 推送 → PR → CI 的完整流程。
 
 ---
 
 ## 概览
 
-策略按类别分组如下：
+策略按类别分组：
 
 | 类别 | 策略 | 钩子类型 |
-|------|------|---------|
+|------|------|----------|
 | [危险命令](#dangerous-commands) | block-sudo, block-rm-rf, block-curl-pipe-sh, block-failproofai-commands | PreToolUse |
-| [密钥（清理器）](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
-| [环境变量](#environment) | block-env-files, protect-env-vars | PreToolUse |
+| [密钥（净化器）](#secrets-sanitizers) | sanitize-jwt, sanitize-api-keys, sanitize-connection-strings, sanitize-private-key-content, sanitize-bearer-tokens | PostToolUse |
+| [环境](#environment) | block-env-files, protect-env-vars | PreToolUse |
 | [文件访问](#file-access) | block-read-outside-cwd, block-secrets-write | PreToolUse |
 | [Git](#git) | block-push-master, block-work-on-main, block-force-push, warn-git-amend, warn-git-stash-drop, warn-all-files-staged | PreToolUse |
 | [数据库](#database) | warn-destructive-sql, warn-schema-alteration | PreToolUse |
 | [警告](#warnings) | warn-large-file-write, warn-package-publish, warn-background-process, warn-global-package-install | PreToolUse |
-| [工作流（beta）](#workflow-beta) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
+| [工作流](#workflow) | require-commit-before-stop, require-push-before-stop, require-pr-before-stop, require-ci-green-before-stop | Stop |
 
-- **`block-`** — 阻止智能体继续执行。
-- **`warn-`** — 向智能体提供额外上下文，使其能够自我纠正。
-- **`sanitize-`** — 在智能体读取工具输出之前，清除其中的敏感数据。
-- **`require-`** — 在满足条件之前阻止 Stop 事件触发。
+- **`block-`** — 阻止代理继续执行。
+- **`warn-`** — 为代理提供额外上下文，使其能够自我纠正。
+- **`sanitize-`** — 在代理查看工具输出前，清除其中的敏感数据。
+- **`require-`** — 在条件满足之前阻止 Stop 事件。
 
 ---
 
 <Tip>
-每条策略均支持在 `policyParams` 中配置可选的 `hint` 字段。该提示会附加到 Claude 收到的 deny 或 instruct 消息中，提供可操作的指导，无需修改策略代码。适用于内置策略、自定义策略和约定策略。详情请参阅 [配置 → hint](/zh/configuration#hint-cross-cutting)。
+每条策略均支持在 `policyParams` 中设置可选的 `hint` 字段。该提示会附加到 Claude 收到的 deny 或 instruct 消息中，提供可操作的指导，无需修改策略代码。适用于内置策略、自定义策略和约定策略。详见[配置 → hint](/zh/configuration#hint-cross-cutting)。
 </Tip>
 
 ---
 
 ## 危险命令
 
-防止智能体执行难以撤销或可能损坏宿主系统的操作。
+防止代理执行难以撤销或可能损害宿主系统的操作。
 
 ### `block-sudo`
 
 **事件：** PreToolUse (Bash)  
 **默认行为：** 拒绝任何包含 `sudo` 的命令。
 
-阻止包含 `sudo` 关键字的调用。模式匹配基于解析后的命令令牌（而非原始字符串），以防止通过 shell 运算符注入绕过检测。
+拦截包含 `sudo` 关键字的调用。模式匹配基于解析后的命令标记（token），而非原始字符串，以防止通过 shell 运算符注入绕过检测。
 
 **参数：**
 
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `allowPatterns` | `string[]` | `[]` | 允许执行的精确命令前缀。每条记录与解析后的 argv 令牌进行匹配。 |
+| `allowPatterns` | `string[]` | `[]` | 允许通过的命令前缀（精确匹配）。每个条目与解析后的 argv 标记进行匹配。 |
 
 **示例：**
 
@@ -65,10 +65,10 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 }
 ```
 
-使用此配置后，`sudo systemctl status nginx` 将被允许，但 `sudo rm /etc/hosts` 将被拒绝。
+使用此配置，`sudo systemctl status nginx` 将被允许，但 `sudo rm /etc/hosts` 将被拒绝。
 
 <Note>
-模式匹配基于解析后的令牌，而非原始命令字符串。这可以防止通过附加 shell 运算符绕过检测（例如，`sudo systemctl status x; rm -rf /` 不会匹配 `sudo systemctl status *`）。
+模式匹配基于解析后的标记，而非原始命令字符串。这可防止通过追加 shell 运算符进行绕过（例如 `sudo systemctl status x; rm -rf /` 不会匹配 `sudo systemctl status *`）。
 </Note>
 
 ---
@@ -116,14 +116,14 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ---
 
-## 密钥（清理器）
+## 密钥（净化器）
 
-防止智能体将凭证泄漏到其上下文或输出中。清理器策略在 **PostToolUse** 事件上触发。当 Claude 运行 Bash 命令、读取文件或调用任何工具时，这些策略会在输出返回给 Claude 之前对其进行检查。一旦检测到密钥模式，策略将返回拒绝决定，阻止输出被传回。
+防止代理将凭据泄露到其上下文或输出中。净化器策略在 **PostToolUse** 事件上触发。当 Claude 执行 Bash 命令、读取文件或调用任何工具时，这些策略会在输出返回给 Claude 之前对其进行检查。若检测到密钥模式，策略将返回拒绝决定，阻止输出被传回。
 
 ### `sanitize-jwt`
 
 **事件：** PostToolUse（所有工具）  
-**默认行为：** 清除 JWT 令牌（由 `.` 分隔的三段 base64url 字符串）。
+**默认行为：** 清除 JWT 令牌（三段由 `.` 分隔的 base64url 编码内容）。
 
 无参数。
 
@@ -138,7 +138,7 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | 需要视为密钥的额外正则表达式模式。 |
+| `additionalPatterns` | `{ regex: string; label: string }[]` | `[]` | 额外需要视为密钥的正则表达式模式。 |
 
 **示例：**
 
@@ -160,7 +160,7 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 ### `sanitize-connection-strings`
 
 **事件：** PostToolUse（所有工具）  
-**默认行为：** 清除包含嵌入凭证的数据库连接字符串（例如 `postgresql://user:password@host/db`）。
+**默认行为：** 清除包含内嵌凭据的数据库连接字符串（例如 `postgresql://user:password@host/db`）。
 
 无参数。
 
@@ -178,22 +178,22 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 ### `sanitize-bearer-tokens`
 
 **事件：** PostToolUse（所有工具）  
-**默认行为：** 清除令牌长度不低于 20 个字符的 `Authorization: Bearer <token>` 请求头。
+**默认行为：** 清除 `Authorization: Bearer <token>` 请求头中长度达到 20 个字符或以上的令牌。
 
 无参数。
 
 ---
 
-## 环境变量
+## 环境
 
-防止智能体读取或暴露敏感的环境配置。
+防止代理读取或暴露敏感的环境配置。
 
 ### `block-env-files`
 
-**事件：** PreToolUse (Bash, Read)  
-**默认行为：** 拒绝通过 `cat .env`、文件路径为 `.env` 的 `Read` 工具调用等方式读取 `.env` 文件。
+**事件：** PreToolUse（Bash、Read）  
+**默认行为：** 拒绝通过 `cat .env`、以 `.env` 为文件路径的 `Read` 工具调用等方式读取 `.env` 文件。
 
-不会阻止 `.envrc` 或其他环境相关文件，仅阻止名称完全为 `.env` 的文件。
+不会拦截 `.envrc` 或其他与环境相关的文件，仅针对精确命名为 `.env` 的文件。
 
 无参数。
 
@@ -201,7 +201,7 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `protect-env-vars`
 
-**事件：** PreToolUse (Bash)  
+**事件：** PreToolUse（Bash）  
 **默认行为：** 拒绝打印环境变量的命令：`printenv`、`env`、`echo $VAR`。
 
 无参数。
@@ -210,18 +210,18 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ## 文件访问
 
-将智能体的操作限制在项目目录内，避免其访问敏感文件。
+将代理的操作范围限制在项目目录内，并远离敏感文件。
 
 ### `block-read-outside-cwd`
 
-**事件：** PreToolUse (Read, Bash)  
+**事件：** PreToolUse（Read、Bash）  
 **默认行为：** 拒绝读取当前工作目录（项目根目录）以外的文件。
 
 **参数：**
 
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `allowPaths` | `string[]` | `[]` | 即使位于当前工作目录之外也允许访问的绝对路径前缀。 |
+| `allowPaths` | `string[]` | `[]` | 即使在工作目录之外也允许访问的绝对路径前缀。 |
 
 **示例：**
 
@@ -239,14 +239,14 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `block-secrets-write`
 
-**事件：** PreToolUse (Write, Edit)  
-**默认行为：** 拒绝写入常用于存储私钥和证书的文件：`id_rsa`、`id_ed25519`、`*.key`、`*.pem`、`*.p12`、`*.pfx`。
+**事件：** PreToolUse（Write、Edit）  
+**默认行为：** 拒绝写入常用于私钥和证书的文件：`id_rsa`、`id_ed25519`、`*.key`、`*.pem`、`*.p12`、`*.pfx`。
 
 **参数：**
 
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `additionalPatterns` | `string[]` | `[]` | 需要阻止的额外文件名模式（glob 风格）。 |
+| `additionalPatterns` | `string[]` | `[]` | 额外需要阻止的文件名模式（glob 风格）。 |
 
 **示例：**
 
@@ -268,7 +268,7 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `block-push-master`
 
-**事件：** PreToolUse (Bash)  
+**事件：** PreToolUse（Bash）  
 **默认行为：** 拒绝 `git push origin main` 和 `git push origin master`。
 
 **参数：**
@@ -290,30 +290,30 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 ```
 
 <Tip>
-若要允许推送到所有分支（即在不从 `enabledPolicies` 中移除该策略的情况下将其禁用），可将 `protectedBranches` 设置为 `[]`。
+若要允许推送到所有分支（即在不从 `enabledPolicies` 中移除该策略的情况下禁用它），请将 `protectedBranches` 设为 `[]`。
 </Tip>
 
 ---
 
 ### `block-work-on-main`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 拒绝直接检出 `main` 或 `master` 分支。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 拒绝直接切换到 `main` 或 `master` 分支。
 
 **参数：**
 
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `protectedBranches` | `string[]` | `["main", "master"]` | 不允许直接检出的分支名称。 |
+| `protectedBranches` | `string[]` | `["main", "master"]` | 不允许直接切换的分支名称。 |
 
 ---
 
 ### `block-force-push`
 
-**事件：** PreToolUse (Bash)  
+**事件：** PreToolUse（Bash）  
 **默认行为：** 拒绝 `git push --force` 和 `git push -f`。
 
-无策略专属参数。可使用跨策略的 [`hint`](/zh/configuration#hint-cross-cutting) 字段建议替代方案：
+无策略专属参数。可使用通用 [`hint`](/zh/configuration#hint-cross-cutting) 建议替代方案：
 
 ```json
 {
@@ -329,8 +329,8 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `warn-git-amend`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 运行 `git commit --amend` 时，提示其谨慎操作。不阻止该命令执行。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在运行 `git commit --amend` 时指示 Claude 谨慎操作。不会阻止命令执行。
 
 无参数。
 
@@ -338,8 +338,8 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `warn-git-stash-drop`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 运行 `git stash drop` 前，提示其进行确认。不阻止该命令执行。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在运行 `git stash drop` 前指示 Claude 进行确认。不会阻止命令执行。
 
 无参数。
 
@@ -347,8 +347,8 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `warn-all-files-staged`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 运行 `git add -A` 或 `git add .` 时，提示其审查所暂存的内容。不阻止该命令执行。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在运行 `git add -A` 或 `git add .` 时指示 Claude 检查所暂存的内容。不会阻止命令执行。
 
 无参数。
 
@@ -356,12 +356,12 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ## 数据库
 
-在破坏性 SQL 操作执行之前将其拦截。
+在破坏性 SQL 操作执行之前进行拦截。
 
 ### `warn-destructive-sql`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 执行包含 `DROP TABLE`、`DROP DATABASE` 或不带 `WHERE` 子句的 `DELETE` 的 SQL 语句前，提示其进行确认。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在运行包含 `DROP TABLE`、`DROP DATABASE` 或不带 `WHERE` 子句的 `DELETE` 的 SQL 语句之前，指示 Claude 进行确认。
 
 无参数。
 
@@ -369,8 +369,8 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `warn-schema-alteration`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 执行 `ALTER TABLE` 语句前，提示其进行确认。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在运行 `ALTER TABLE` 语句之前，指示 Claude 进行确认。
 
 无参数。
 
@@ -378,12 +378,12 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ## 警告
 
-在智能体执行潜在风险但非破坏性的操作之前，提供额外上下文。
+在执行潜在风险但非破坏性的操作之前，为代理提供额外的上下文信息。
 
 ### `warn-large-file-write`
 
-**事件：** PreToolUse (Write)  
-**默认行为：** 当 Claude 写入大于 1024 KB 的文件前，提示其进行确认。
+**事件：** PreToolUse（Write）  
+**默认行为：** 在写入超过 1024 KB 的文件之前，指示 Claude 进行确认。
 
 **参数：**
 
@@ -404,15 +404,15 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 ```
 
 <Note>
-钩子处理程序对 stdin 载荷强制限制为 1 MB。如需使用较小内容测试此策略，请将 `thresholdKb` 设置为远低于 1024 的值。
+钩子处理程序对载荷的 stdin 大小限制为 1 MB。若要使用较小的内容测试此策略，请将 `thresholdKb` 设置为远低于 1024 的值。
 </Note>
 
 ---
 
 ### `warn-package-publish`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 运行 `npm publish` 前，提示其进行确认。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在运行 `npm publish` 之前，指示 Claude 进行确认。
 
 无参数。
 
@@ -420,8 +420,8 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `warn-background-process`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 通过 `nohup`、`&`、`disown` 或 `screen` 启动后台进程时，提示其注意风险。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在通过 `nohup`、`&`、`disown` 或 `screen` 启动后台进程时，指示 Claude 谨慎操作。
 
 无参数。
 
@@ -429,8 +429,8 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ### `warn-global-package-install`
 
-**事件：** PreToolUse (Bash)  
-**默认行为：** 当 Claude 运行 `npm install -g`、`yarn global add` 或未在虚拟环境中执行 `pip install` 前，提示其进行确认。
+**事件：** PreToolUse（Bash）  
+**默认行为：** 在运行 `npm install -g`、`yarn global add` 或未在虚拟环境中执行的 `pip install` 之前，指示 Claude 进行确认。
 
 无参数。
 
@@ -438,27 +438,27 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 
 ## AI 行为
 
-检测智能体陷入卡死或异常行为的情况。
+检测代理卡住或行为异常的情况。
 
 ### `warn-repeated-tool-calls`
 
 **事件：** PreToolUse（所有工具）  
-**默认行为：** 当同一工具以相同参数被连续调用 3 次及以上时，提示 Claude 重新考虑——这通常是智能体陷入循环的常见信号。
+**默认行为：** 当同一工具以相同参数被调用 3 次或以上时，指示 Claude 重新考量——这通常是代理陷入循环的常见信号。
 
 无参数。
 
 ---
 
-## 工作流（beta）
+## 工作流
 
-强制执行规范的会话结束工作流。这些策略在 **Stop** 事件上触发，并阻止 Claude 在每个条件满足之前停止运行。它们遵循自然的依赖链：提交 → 推送 → PR → CI。若某条策略拒绝，链中后续策略将被跳过（拒绝会短路后续检查）。
+强制执行严格的会话结束工作流。这些策略在 **Stop** 事件上触发，并阻止 Claude 在每个条件满足之前停止。它们遵循自然的依赖链：提交 → 推送 → PR → CI。若某条策略拒绝，链中后续策略将被跳过（拒绝短路机制）。
 
-所有工作流策略均采用**失败开放**模式：若所需工具不可用（例如未安装 `gh`、无 git 远程仓库），策略将放行并附上说明跳过原因的提示信息。
+所有工作流策略均为**失败开放（fail-open）**模式：若所需工具不可用（例如 `gh` 未安装、无 git 远程仓库），策略将允许通过，并附上说明检查被跳过原因的提示信息。
 
 ### `require-commit-before-stop`
 
 **事件：** Stop  
-**默认行为：** 当存在未提交的变更（已修改、已暂存或未跟踪的文件）时，拒绝停止。当工作目录干净时，返回提示信息。
+**默认行为：** 当存在未提交的更改（已修改、已暂存或未跟踪的文件）时，拒绝停止。当工作目录干净时，返回提示信息。
 
 无参数。
 
@@ -467,13 +467,13 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 ### `require-push-before-stop`
 
 **事件：** Stop  
-**默认行为：** 当存在未推送的提交，或当前分支没有远程跟踪分支时，拒绝停止。如需创建跟踪分支，建议使用 `git push -u`。若未配置远程仓库，则失败开放。
+**默认行为：** 当存在未推送的提交或当前分支没有远程跟踪分支时，拒绝停止。若需要，建议使用 `git push -u` 创建跟踪分支。若未配置远程仓库，则以开放方式失败。
 
 **参数：**
 
 | 参数 | 类型 | 默认值 | 说明 |
 |------|------|--------|------|
-| `remote` | `string` | `"origin"` | 推送目标的远程仓库名称。 |
+| `remote` | `string` | `"origin"` | 推送的目标远程仓库名称。 |
 
 **示例：**
 
@@ -492,13 +492,13 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 ### `require-pr-before-stop`
 
 **事件：** Stop  
-**默认行为：** 当当前分支不存在拉取请求，或现有 PR 已关闭/已合并时，拒绝停止。提示 Claude 使用 `gh pr create` 创建 PR。
+**默认行为：** 当当前分支不存在拉取请求，或已有 PR 处于关闭/已合并状态时，拒绝停止。指示 Claude 使用 `gh pr create` 创建 PR。
 
 无参数。
 
 <Note>
 此策略需要安装并完成身份验证的 [GitHub CLI](https://cli.github.com/)（`gh`）。
-请运行 `gh auth login`，并使用具有 `repo` 权限（用于读取拉取请求）的个人访问令牌进行认证。若未安装 `gh` 或未完成认证，策略将失败开放并向 Claude 报告原因。
+请使用具有 `repo` 权限范围（用于读取拉取请求）的个人访问令牌运行 `gh auth login`。若 `gh` 未安装或未完成身份验证，策略将以开放方式失败，并向 Claude 报告原因。
 </Note>
 
 ---
@@ -506,49 +506,22 @@ failproofai 内置了 30 条策略，用于捕获常见的智能体失败模式
 ### `require-ci-green-before-stop`
 
 **事件：** Stop  
-**默认行为：** 当当前分支的 CI 检查失败或仍在运行时，拒绝停止。同时检查 GitHub Actions 工作流运行状态和第三方机器人检查（例如 CodeRabbit、SonarCloud、Codecov）。将 `skipped` 结论视为成功。所有检查通过时，返回提示信息。
+**默认行为：** 当当前分支的 CI 检查失败或仍在运行时，拒绝停止。同时检查 GitHub Actions 工作流运行和第三方机器人检查（例如 CodeRabbit、SonarCloud、Codecov）。将 `skipped` 结论视为成功。当所有检查通过时，返回提示信息。
 
 无参数。
 
 <Note>
 此策略需要安装并完成身份验证的 [GitHub CLI](https://cli.github.com/)（`gh`）。
-请运行 `gh auth login`，并使用具有 `repo` 权限（用于读取 Actions 工作流运行状态和 Checks API）的个人访问令牌进行认证。若未安装 `gh` 或未完成认证，策略将失败开放并向 Claude 报告原因。
+请使用具有 `repo` 权限范围（用于读取 Actions 工作流运行和 Checks API）的个人访问令牌运行 `gh auth login`。若 `gh` 未安装或未完成身份验证，策略将以开放方式失败，并向 Claude 报告原因。
 </Note>
 
 ---
 
-## Beta 策略
-
-部分策略标记为 `beta`，默认不安装。Beta 策略可能存在一定的不稳定性或误报情况，将在后续版本中升级为稳定版。
-
-**当前 beta 策略：**
-
-- `require-commit-before-stop` — 停止前提交所有变更
-- `require-push-before-stop` — 将所有提交推送到远程仓库
-- `require-pr-before-stop` — 确保分支存在对应的 PR
-- `require-ci-green-before-stop` — 所有 CI 检查必须通过
-
-这四条策略共同强制执行 **提交 → 推送 → PR → CI** 工作流。
-
-安装所有 beta 策略：
-
-```bash
-failproofai policies --install --beta
-```
-
-或安装指定的工作流策略：
-
-```bash
-failproofai policies --install require-commit-before-stop require-push-before-stop require-pr-before-stop require-ci-green-before-stop
-```
-
-运行 `failproofai policies` 可查看哪些策略带有 beta 标识。
-
 ---
 
 ## 禁用单条策略
 
-从配置文件的 `enabledPolicies` 中移除指定策略，或在控制面板的「策略」标签页中将其关闭。
+在配置文件的 `enabledPolicies` 中移除特定策略，或在控制台的「策略」选项卡中将其关闭。
 
 ```json
 {
@@ -559,4 +532,4 @@ failproofai policies --install require-commit-before-stop require-push-before-st
 }
 ```
 
-未在 `enabledPolicies` 中列出的策略不会运行，即使 `policyParams` 中存在对应的配置项也是如此。
+未在 `enabledPolicies` 中列出的策略不会运行，即使 `policyParams` 中存在对应条目也不例外。

package/.next/standalone/docs/zh/cli/install-policies.mdx

@@ -19,15 +19,14 @@ failproofai policies --install [policy-names...] [options]
 | `--scope project` | 安装到当前目录的 `.claude/settings.json` |
 | `--scope local` | 安装到当前目录的 `.claude/settings.local.json` |
 | `--custom <path>` / `-c` | 包含自定义钩子策略的 JS 文件路径 |
-| `--beta` | 包含测试版策略 |
 
-## 行为说明
+## 行为
 
 - **不指定策略名称** - 打开交互式提示以选择策略
-- **指定具体名称** - 启用对应策略（追加到已启用的策略中）
+- **指定具体名称** - 启用对应策略（追加到已启用的策略之上）
 - **`all`** - 启用所有可用策略
 
-安装操作为增量式：再次运行 `--install` 只会添加新策略，不会移除已有策略。
+安装操作为追加模式：再次运行 `--install` 只会添加新策略，不会移除已有策略。
 
 ## 示例
 
@@ -45,4 +44,4 @@ failproofai policies --install all
 failproofai policies --install --custom ./my-policies.js
 ```
 
-当提供 `--custom <path>` 时，文件会立即进行验证——它必须至少调用一次 `customPolicies.add()`。解析后的路径将作为 `customPoliciesPath` 保存到 `policies-config.json` 中。
+提供 `--custom <path>` 时，文件将立即被验证 - 它必须至少调用一次 `customPolicies.add()`。解析后的路径将以 `customPoliciesPath` 的形式保存到 `policies-config.json` 中。

package/.next/standalone/docs/zh/cli/remove-policies.mdx

@@ -1,13 +1,13 @@
 ---
 title: 卸载策略
-description: "从 Claude Code 的设置中移除 hook 条目"
+description: "从 Claude Code 的设置中移除钩子条目"
 ---
 
 ```bash
 failproofai policies --uninstall [policy-names...] [options]
 ```
 
-从 Claude Code 的 `settings.json` 中移除 failproofai hook 条目。
+从 Claude Code 的 `settings.json` 中移除 failproofai 钩子条目。
 
 别名：`failproofai p -u`
 
@@ -18,25 +18,24 @@ failproofai policies --uninstall [policy-names...] [options]
 | `--scope user` | 从全局设置中移除（默认） |
 | `--scope project` | 从项目设置中移除 |
 | `--scope local` | 从本地设置中移除 |
-| `--scope all` | 同时从所有作用域中移除 |
+| `--scope all` | 从所有作用域中一次性移除 |
 | `--custom` / `-c` | 从配置中清除 `customPoliciesPath` |
-| `--beta` | 仅从配置中移除 beta 策略 |
 
 ## 行为说明
 
-- **不指定策略名称** — 从设置文件中移除所有 failproofai hook 条目
-- **指定具体名称** — 禁用对应策略，但保留已安装的 hook
+- **未指定策略名称** — 从设置文件中移除所有 failproofai 钩子条目
+- **指定具体名称** — 禁用对应策略，但保留已安装的钩子
 
 ## 示例
 
 ```bash
-# 全局移除所有 hook
+# 全局移除所有钩子
 failproofai policies --uninstall
 
-# 禁用特定策略（保留已安装的 hook）
+# 禁用特定策略（保留已安装的钩子）
 failproofai policies --uninstall block-sudo
 
-# 从所有作用域中移除 hook
+# 从所有作用域中移除钩子
 failproofai policies --uninstall --scope all
 
 # 清除自定义策略路径

package/.next/standalone/package.json

@@ -1,6 +1,6 @@
 {
   "name": "failproofai",
-  "version": "0.0.3",
+  "version": "0.0.4",
   "description": "The easiest way to manage policies that keep your AI agents reliable, on-task, and running autonomously — for Claude Code & the Agents SDK",
   "bin": {
     "failproofai": "./dist/cli.mjs"

package/.next/standalone/server.js

@@ -9,7 +9,7 @@ const currentPort = parseInt(process.env.PORT, 10) || 3000
 const hostname = process.env.HOSTNAME || '0.0.0.0'
 
 let keepAliveTimeout = parseInt(process.env.KEEP_ALIVE_TIMEOUT, 10)
-const nextConfig = {"env":{"NEXT_PUBLIC_APP_VERSION":"0.0.3"},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/failproofai/failproofai","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","turbopack":{"root":"/home/runner/work/failproofai/failproofai"},"distDirRoot":".next"}
+const nextConfig = {"env":{"NEXT_PUBLIC_APP_VERSION":"0.0.4"},"typescript":{"ignoreBuildErrors":false},"typedRoutes":false,"distDir":"./.next","cleanDistDir":true,"assetPrefix":"","cacheMaxMemorySize":52428800,"configOrigin":"next.config.ts","useFileSystemPublicRoutes":true,"generateEtags":true,"pageExtensions":["tsx","ts","jsx","js"],"poweredByHeader":true,"compress":true,"images":{"deviceSizes":[640,750,828,1080,1200,1920,2048,3840],"imageSizes":[32,48,64,96,128,256,384],"path":"/_next/image","loader":"default","loaderFile":"","domains":[],"disableStaticImages":false,"minimumCacheTTL":14400,"formats":["image/webp"],"maximumRedirects":3,"maximumResponseBody":50000000,"dangerouslyAllowLocalIP":false,"dangerouslyAllowSVG":false,"contentSecurityPolicy":"script-src 'none'; frame-src 'none'; sandbox;","contentDispositionType":"attachment","localPatterns":[{"pathname":"**","search":""}],"remotePatterns":[],"qualities":[75],"unoptimized":true,"customCacheHandler":false},"devIndicators":{"position":"bottom-left"},"onDemandEntries":{"maxInactiveAge":60000,"pagesBufferLength":5},"basePath":"","sassOptions":{},"trailingSlash":false,"i18n":null,"productionBrowserSourceMaps":false,"excludeDefaultMomentLocales":true,"reactProductionProfiling":false,"reactStrictMode":null,"reactMaxHeadersLength":6000,"httpAgentOptions":{"keepAlive":true},"logging":{"serverFunctions":true,"browserToTerminal":"warn"},"compiler":{},"expireTime":31536000,"staticPageGenerationTimeout":60,"output":"standalone","modularizeImports":{"@mui/icons-material":{"transform":"@mui/icons-material/{{member}}"},"lodash":{"transform":"lodash/{{member}}"}},"outputFileTracingRoot":"/home/runner/work/failproofai/failproofai","cacheComponents":false,"cacheLife":{"default":{"stale":300,"revalidate":900,"expire":4294967294},"seconds":{"stale":30,"revalidate":1,"expire":60},"minutes":{"stale":300,"revalidate":60,"expire":3600},"hours":{"stale":300,"revalidate":3600,"expire":86400},"days":{"stale":300,"revalidate":86400,"expire":604800},"weeks":{"stale":300,"revalidate":604800,"expire":2592000},"max":{"stale":300,"revalidate":2592000,"expire":31536000}},"cacheHandlers":{},"experimental":{"appNewScrollHandler":false,"useSkewCookie":false,"cssChunking":true,"multiZoneDraftMode":false,"appNavFailHandling":false,"prerenderEarlyExit":true,"serverMinification":true,"linkNoTouchStart":false,"caseSensitiveRoutes":false,"cachedNavigations":false,"partialFallbacks":false,"dynamicOnHover":false,"varyParams":false,"prefetchInlining":false,"preloadEntriesOnStart":true,"clientRouterFilter":true,"clientRouterFilterRedirects":false,"fetchCacheKeyPrefix":"","proxyPrefetch":"flexible","optimisticClientCache":true,"manualClientBasePath":false,"cpus":3,"memoryBasedWorkersCount":false,"imgOptConcurrency":null,"imgOptTimeoutInSeconds":7,"imgOptMaxInputPixels":268402689,"imgOptSequentialRead":null,"imgOptSkipMetadata":null,"isrFlushToDisk":true,"workerThreads":false,"optimizeCss":false,"nextScriptWorkers":false,"scrollRestoration":false,"externalDir":false,"disableOptimizedLoading":false,"gzipSize":true,"craCompat":false,"esmExternals":true,"fullySpecified":false,"swcTraceProfiling":false,"forceSwcTransforms":false,"largePageDataBytes":128000,"typedEnv":false,"parallelServerCompiles":false,"parallelServerBuildTraces":false,"ppr":false,"authInterrupts":false,"webpackMemoryOptimizations":false,"optimizeServerReact":true,"strictRouteTypes":false,"viewTransition":false,"removeUncaughtErrorAndRejectionListeners":false,"validateRSCRequestHeaders":false,"staleTimes":{"dynamic":0,"static":300},"reactDebugChannel":true,"serverComponentsHmrCache":true,"staticGenerationMaxConcurrency":8,"staticGenerationMinPagesPerWorker":25,"transitionIndicator":false,"gestureTransition":false,"inlineCss":false,"useCache":false,"globalNotFound":false,"browserDebugInfoInTerminal":"warn","lockDistDir":true,"proxyClientMaxBodySize":10485760,"hideLogsAfterAbort":false,"mcpServer":true,"turbopackFileSystemCacheForDev":true,"turbopackFileSystemCacheForBuild":false,"turbopackInferModuleSideEffects":true,"turbopackPluginRuntimeStrategy":"childProcesses","optimizePackageImports":["lucide-react","date-fns","lodash-es","ramda","antd","react-bootstrap","ahooks","@ant-design/icons","@headlessui/react","@headlessui-float/react","@heroicons/react/20/solid","@heroicons/react/24/solid","@heroicons/react/24/outline","@visx/visx","@tremor/react","rxjs","@mui/material","@mui/icons-material","recharts","react-use","effect","@effect/schema","@effect/platform","@effect/platform-node","@effect/platform-browser","@effect/platform-bun","@effect/sql","@effect/sql-mssql","@effect/sql-mysql2","@effect/sql-pg","@effect/sql-sqlite-node","@effect/sql-sqlite-bun","@effect/sql-sqlite-wasm","@effect/sql-sqlite-react-native","@effect/rpc","@effect/rpc-http","@effect/typeclass","@effect/experimental","@effect/opentelemetry","@material-ui/core","@material-ui/icons","@tabler/icons-react","mui-core","react-icons/ai","react-icons/bi","react-icons/bs","react-icons/cg","react-icons/ci","react-icons/di","react-icons/fa","react-icons/fa6","react-icons/fc","react-icons/fi","react-icons/gi","react-icons/go","react-icons/gr","react-icons/hi","react-icons/hi2","react-icons/im","react-icons/io","react-icons/io5","react-icons/lia","react-icons/lib","react-icons/lu","react-icons/md","react-icons/pi","react-icons/ri","react-icons/rx","react-icons/si","react-icons/sl","react-icons/tb","react-icons/tfi","react-icons/ti","react-icons/vsc","react-icons/wi"],"trustHostHeader":false,"isExperimentalCompile":false},"htmlLimitedBots":"[\\w-]+-Google|Google-[\\w-]+|Chrome-Lighthouse|Slurp|DuckDuckBot|baiduspider|yandex|sogou|bitlybot|tumblr|vkShare|quora link preview|redditbot|ia_archiver|Bingbot|BingPreview|applebot|facebookexternalhit|facebookcatalog|Twitterbot|LinkedInBot|Slackbot|Discordbot|WhatsApp|SkypeUriPreview|Yeti|googleweblight","bundlePagesRouterDependencies":false,"configFileName":"next.config.ts","turbopack":{"root":"/home/runner/work/failproofai/failproofai"},"distDirRoot":".next"}
 
 process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(nextConfig)
 

package/.next/standalone/src/hooks/builtin-policies.ts

@@ -1385,7 +1385,6 @@ export const BUILTIN_POLICIES: BuiltinPolicyDefinition[] = [
     match: { events: ["Stop"] },
     defaultEnabled: false,
     category: "Workflow",
-    beta: true,
   },
   {
     name: "require-push-before-stop",
@@ -1394,7 +1393,6 @@ export const BUILTIN_POLICIES: BuiltinPolicyDefinition[] = [
     match: { events: ["Stop"] },
     defaultEnabled: false,
     category: "Workflow",
-    beta: true,
     params: {
       remote: {
         type: "string",
@@ -1415,7 +1413,6 @@ export const BUILTIN_POLICIES: BuiltinPolicyDefinition[] = [
     match: { events: ["Stop"] },
     defaultEnabled: false,
     category: "Workflow",
-    beta: true,
     params: {
       baseBranch: {
         type: "string",
@@ -1431,7 +1428,6 @@ export const BUILTIN_POLICIES: BuiltinPolicyDefinition[] = [
     match: { events: ["Stop"] },
     defaultEnabled: false,
     category: "Workflow",
-    beta: true,
   },
 ];