failproofai 1.0.1-beta.0 → 1.0.1

package/.next/standalone/docs-old/zh/cli/audit.mdx

@@ -0,0 +1,115 @@
+---
+title: 审计历史会话（测试版）
+description: "统计 agent 在过去记录中执行浪费性或高风险操作的频率"
+---
+
+<Note>
+  **测试版功能。** 审计功能以测试版形式发布，我们正在收集早期反馈。
+  检测器目录和报告格式可能在下一个稳定版本发布前有所变动。
+  如有异常，请提交 issue。
+</Note>
+
+审计功能会将你过去的 agent CLI 记录通过 failproofai 的策略引擎重新回放，并在 **`/audit` 控制台页面**生成一份可分享的可视化报告，内容包括：你的 agent 所属原型、0 到 100 的评分，以及哪些策略会捕获哪些问题。
+
+## 运行方式
+
+有三种入口——最终都会跳转到同一份 `/audit` 报告。
+
+<CodeGroup>
+
+```bash npx (无需安装)
+npx -y failproofai audit
+```
+
+```bash failproofai audit
+failproofai audit
+```
+
+```bash failproofai (控制台)
+failproofai
+```
+
+</CodeGroup>
+
+<CardGroup cols={3}>
+  <Card title="无需安装" icon="bolt">
+    `npx -y failproofai audit` 会自动获取 failproofai，执行扫描并打开控制台——无需预先安装任何东西。
+  </Card>
+  <Card title="通过 CLI" icon="terminal">
+    `failproofai audit` 在终端中运行扫描，完成后自动打开 `localhost:8020/audit`。
+  </Card>
+  <Card title="通过控制台" icon="gauge">
+    运行 `failproofai`，点击导航栏中的 **Audit**（位于 Policies 和 Projects 之间），或直接打开 `/audit`。
+  </Card>
+</CardGroup>
+
+<Tip>
+  运行 `failproofai audit -h`（或 `--help`）查看使用说明。审计**完全离线**运行——无需账户或网络——控制台会持续服务，直到你按 `Ctrl+C` 停止。
+</Tip>
+
+控制台会扫描本机上过去的 agent CLI 记录（Claude Code、Codex、Copilot、Cursor、OpenCode、Pi），并报告 agent 执行了多少次 failproofai 所设计拦截的操作——包括环境变量检查、强制推送、多余的 `cd <cwd>` 前缀、sleep 轮询循环、重复读取刚刚编辑过的文件等。
+
+对于每份记录，所有工具调用事件都会经过 39 条内置策略**以及** 8 个仅限审计的检测器重新回放，这些检测器用于捕获尚未被运行时策略覆盖的模式。计数按策略/检测器在所有会话中汇总。
+
+## 报告内容
+
+`/audit` 页面是一个单屏可分享的**海报**，后跟四个滚动区域：
+
+1. **海报** — 一目了然地展示 agent 的身份：**原型**（共 8 种——`optimist`、`cowboy`、`explorer`、`goldfish`、`paranoid architect`、`precision builder`、`hammer`、`ghost`）、persona 关键词、该原型的稀有程度，以及带等级区间的 **0–100 评分**（从 `S` 到 `bottom tier`）。专为分享设计——可发布到 X 或 LinkedIn，或下载为 PNG。
+2. **`// strengths`** — agent 已经做得好的方面，以扫描得出的真实数字呈现（例如：干净工具调用百分比、`0` 次 push-to-main 尝试），仅在相关策略记录完全干净时显示。
+3. **`// quirks`** — 存在的问题：一张按优先级排列的表格，展示 failproofai 本可捕获的行为——*最近一次发生的时间*、*具体内容*（以及会拦截它的内置策略）、*严重程度*，以及*出现频率*（`new` / `recurring` / `N× seen`）。
+4. **`// how to improve`** — 针对性修复列表：每条策略对应一行，附有可直接复制粘贴的 `failproofai policy add <slug>` 命令，以及一键**全部安装**按钮，可同时启用所有建议，并显示执行后的**预期评分**。
+5. **`// come back better`** — 养成习惯：设置重新审计的邮件**提醒**（`3d` / `7d` / `14d` / `30d`）或立即重新审计，并**邀请朋友**进行他们自己的审计（由 failproof.ai 发送，抄送给你）。提醒和邀请功能需要登录。
+
+## 定时审计
+
+如果你运行了 **failproofaid 守护进程**（参见 [`failproofai config`](/zh/cli/install-policies)），它可以按计划自动重新运行审计，并在后台刷新 `/audit` 报告。该功能**默认关闭**，因为扫描会读取本机上每个 agent 会话记录的*内容*——在你明确开启之前，不会有任何定时扫描。
+
+在 `~/.failproofai/config.toml` 中开启：
+
+```toml
+[audit]
+auto = true
+interval_days = 7
+```
+
+| 键 | 含义 |
+|---|---|
+| `auto` | `true` 启用定时扫描。其他任何值——缺失、`false`、`"yes"`——均为关闭。 |
+| `interval_days` | 两次扫描之间的天数。限制在 1–90 之间；`0`、负数或非数字值将回退到 `7`。 |
+
+- 计划基于**挂钟时间**，因此能在休眠和重启后继续：如果笔记本电脑在到期后才唤醒，仅**运行一次**，不会积压。
+- 每次运行都是独立的低优先级（`nice 19`）进程——绝不占用守护进程的 hook 路径，该路径始终保持空闲以响应工具调用。
+- 如果 `failproofai audit` 或控制台的重新运行已在进行中，本次扫描会被跳过；稍后会重试，而不是视为失败。
+- 进度写入 `~/.failproofai/state/audit-schedule.json`（包含上次运行时间和下次计划时间）。该文件由守护进程管理——请在 `config.toml` 中修改周期。
+
+<Note>
+如果你在旧版 failproofai 搭建的机器上启用了此功能，请运行一次
+`failproofai config`。守护进程的服务定义在能启动 CLI 之前需要一个额外条目，刷新操作已包含在该命令中。
+</Note>
+
+## 仅限审计的检测器
+
+这些检测器用于发现"低质量行为"模式，这些模式尚未被实时强制执行。它们仅在审计期间运行，绝不会阻断实时工具调用。
+
+| 检测器 | 计数内容 |
+|---|---|
+| `redundant-cd-cwd` | 以 `cd <cwd> && …` 开头的 Bash 命令，尽管命令已在 `cwd` 中运行。 |
+| `prefer-edit-over-read-cat` | 对单个源文件使用 `cat`/`head`/`tail`/`less`/`more`——应使用 `Read` 工具。 |
+| `prefer-edit-over-sed-awk` | 使用 `sed -i` / `awk … > file` 就地编辑——应使用 `Edit` 工具。 |
+| `prefer-write-over-heredoc` | 使用 heredoc / 多行 `echo > file` 写入文件——应使用 `Write` 工具。 |
+| `sleep-polling-loop` | 长时间 `sleep N`（≥ 30 秒）或 `while …; sleep …; done` 轮询循环。 |
+| `find-from-root` | 使用 `find /`、`find /home`、`find /usr` 等——应限定在 `cwd` 范围内。 |
+| `git-commit-no-verify` | 使用 `git commit … --no-verify` / `-n`，跳过 hook。 |
+| `reread-after-edit` | 在同一会话中对刚刚 `Edit`/`Write` 过的文件执行 `Read`。 |
+
+## 缓存
+
+- **逐记录缓存**，位于 `~/.failproofai/cache/audit/<sha1>.json`，以 `(mtime, size, engineVersion, detectorVersion)` 为键——当记录或策略/检测器代码发生变化时自动失效。每个条目还存储了 `cachedAt` 时间戳作为 **TTL 元数据**（不属于缓存键）；读取时，超过 **7 天**的条目将被拒绝，以防长期缓存的结果与演进中的检测器意图脱节。
+- **完整结果缓存**，位于 `~/.failproofai/audit-dashboard.json`（权限 0600）。让控制台在导航时能立即渲染，无需重新运行。超过 **7 天 TTL** 后读取同样会被拒绝——`/audit` 随后回退到空状态并提示重新运行。点击报告底部附近的 `[ re-audit now ]` 刷新——重新审计会发送 `noCache: true`，绕过逐记录缓存并重新扫描所有记录，而不是返回缓存结果；运行过程通过顶部固定条带显示进度，成功后原地替换结果（无需刷新页面；重新审计失败时保留之前的报告）。
+
+## 说明
+
+- **只读操作。** 审计以只读模式回放。`warn-repeated-tool-calls` 会被跳过，否则其每会话附属文件将被修改。
+- **跳过工作流策略。** `require-*-before-stop` 策略仅在 `Stop` 事件时触发，并对实时 git 状态执行 `execSync`——它们对于"2025 年会发生什么"没有实际意义，因此不会出现在审计计数中。
+- **跳过自定义策略。** 用户提供的自定义 hook 不会被回放（它们可能在原始会话之后已发生变更）。

package/.next/standalone/docs-old/zh/cli/dashboard.mdx

@@ -0,0 +1,29 @@
+---
+title: 查看会话
+description: "启动仪表板以浏览代理会话并管理策略"
+---
+
+```bash
+failproofai
+```
+
+在 `http://localhost:8020` 启动 Web 仪表板。
+
+## 选项
+
+| 标志 | 描述 |
+|------|------|
+| `--port <number>` | 监听端口（默认：`8020`） |
+| `--allowed-origins <origins>` | 允许访问开发资源的主机/IP，以逗号分隔 |
+
+若要将仪表板指向非默认的 Claude 项目文件夹，请在启动时设置 `CLAUDE_PROJECTS_PATH` 环境变量。
+
+## 示例
+
+```bash
+# 在不同端口启动
+failproofai --port 9000
+
+# 通过环境变量使用自定义 Claude 项目路径
+CLAUDE_PROJECTS_PATH=~/my-claude-projects failproofai
+```

package/.next/standalone/docs-old/zh/cli/environment-variables.mdx

@@ -0,0 +1,62 @@
+---
+title: 环境变量
+description: "通过环境变量配置 failproofai 的行为"
+---
+
+## 仪表盘
+
+| 变量 | 描述 |
+|----------|-------------|
+| `PORT` | 仪表盘端口（默认：`8020`） |
+| `CLAUDE_PROJECTS_PATH` | 覆盖 Claude Code 项目文件夹的查找路径 |
+| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | 以逗号分隔的仪表盘页面名称，用于隐藏对应页面 |
+| `FAILPROOFAI_ALLOWED_DEV_ORIGINS` | 允许访问开发资源的主机/IP，与 `--allowed-origins` 相同 |
+
+## 日志
+
+| 变量 | 描述 |
+|----------|-------------|
+| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | 服务器日志级别（默认：`warn`） |
+| `FAILPROOFAI_HOOK_LOG_FILE` | 自定义 hook 日志文件路径，或设为 `true` 使用默认路径（`~/.failproofai/logs/hooks.log`） |
+
+## 遥测
+
+failproofai 默认会上报匿名使用遥测数据。有两种方式可以关闭遥测，系统会采用两者中限制更严格的那个——环境变量无法重新启用已被配置文件关闭的功能。
+
+| 变量 | 描述 |
+|----------|-------------|
+| `FAILPROOFAI_TELEMETRY_DISABLED=1` | 为当前进程禁用匿名使用遥测 |
+
+若要在机器上永久禁用遥测，请将以下内容添加到 `~/.failproofai/config.toml`：
+
+```toml
+[telemetry]
+enabled = false
+```
+
+<Note>
+如果你运行的是 **failproofaid 守护进程**，推荐使用配置文件的方式。守护进程是系统级服务，其运行环境不包含从 shell 导出的变量，因此 `FAILPROOFAI_TELEMETRY_DISABLED` 对它无效。`[telemetry] enabled = false` 对 CLI 和守护进程均有效。
+</Note>
+
+守护进程仅上报自身的**生命周期**事件：启动时（以及上次运行是否正常退出）、停止时、评估 worker 被启动或重启时、采集任务失败时，以及云端策略拉取的结果。这些事件只携带低基数的值和计数——不包含任何文件路径、命令、策略、提示词，或从记录中读取的任何内容，也不存在每次工具调用的事件。
+
+## 认证
+
+| 变量 | 描述 |
+|----------|-------------|
+| `FAILPROOF_API_URL` | 覆盖仪表盘认证对话框使用的 API 服务器基础 URL。默认为 `https://api.befailproof.ai`；在本地运行 API 服务器时，可设置为 `http://localhost:8080`（或对应地址）。 |
+| `FAILPROOFAI_AUTH_DIR` | 覆盖 `auth.json` 的存储路径（默认：`~/.failproofai`），主要用于隔离测试。 |
+
+## 首次运行提示
+
+| 变量 | 描述 |
+|----------|-------------|
+| `FAILPROOFAI_NO_FIRST_RUN=1` | 跳过首次裸调用 `failproofai` 时提示安装策略的交互 |
+
+## LLM（用于策略评估）
+
+| 变量 | 描述 |
+|----------|-------------|
+| `FAILPROOFAI_LLM_BASE_URL` | LLM API 端点（默认：`https://api.openai.com/v1`） |
+| `FAILPROOFAI_LLM_API_KEY` | LLM 驱动策略所需的 API 密钥 |
+| `FAILPROOFAI_LLM_MODEL` | 模型名称（默认：`gpt-4o-mini`） |

package/.next/standalone/docs-old/zh/cli/hook.mdx

@@ -0,0 +1,30 @@
+---
+title: Hook 处理器（内部）
+description: "Claude Code 在每个工具事件上调用的子进程"
+---
+
+```bash
+failproofai --hook <EventType>
+```
+
+这是由 `failproofai policies --install` 注册到 Claude Code 的 `settings.json` 中的命令，通常无需直接调用。
+
+该命令从 stdin 读取 JSON 载荷，对所有已启用的策略进行评估，并以退出码的形式返回决策结果：
+
+| 退出码 | 决策 | 效果 |
+|--------|------|------|
+| `0` | `allow` | 允许该操作 |
+| `1` | `deny` | 阻止该操作 —— Claude 将收到拒绝原因 |
+| `2` | `instruct` | 向 Claude 的上下文注入指导信息 |
+
+### 支持的事件类型
+
+| 类别 | 事件 |
+|------|------|
+| **工具执行** | `PreToolUse`、`PostToolUse`、`PostToolUseFailure`、`PermissionRequest`、`PermissionDenied` |
+| **会话生命周期** | `SessionStart`、`SessionEnd`、`Stop`、`StopFailure` |
+| **用户交互** | `UserPromptSubmit`、`Notification`、`Elicitation`、`ElicitationResult` |
+| **子代理与任务** | `SubagentStart`、`SubagentStop`、`TaskCreated`、`TaskCompleted`、`TeammateIdle` |
+| **配置** | `InstructionsLoaded`、`ConfigChange`、`CwdChanged` |
+| **文件系统** | `FileChanged`、`WorktreeCreate`、`WorktreeRemove` |
+| **上下文** | `PreCompact`、`PostCompact` |

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

@@ -0,0 +1,57 @@
+---
+title: 安装策略
+description: "启用策略，使其在每次代理工具调用时运行"
+---
+
+```bash
+failproofai policies --install [policy-names...] [options]
+```
+
+将 hook 条目写入已安装的代理 CLI 的设置文件（Claude Code、OpenAI Codex 或 GitHub Copilot CLI _(测试版)_），使 failproofai 能够拦截工具调用。
+
+别名：`failproofai p -i`
+
+## 选项
+
+| 参数 | 描述 |
+|------|------|
+| `--cli claude\|codex\|copilot` | 要安装的代理 CLI，以空格分隔（例如 `--cli claude codex copilot`）或重复使用。省略时将自动检测已安装的 CLI 并提示选择。 |
+| `--scope user` | 安装到用户级设置文件（Claude：`~/.claude/settings.json`；Codex：`~/.codex/hooks.json`；Copilot：`~/.copilot/hooks/failproofai.json`）。默认值。 |
+| `--scope project` | 安装到项目级设置文件（Claude：`<cwd>/.claude/settings.json`；Codex：`<cwd>/.codex/hooks.json`；Copilot：`<cwd>/.github/hooks/failproofai.json`）。 |
+| `--scope local` | 仅限 Claude — 安装到 `<cwd>/.claude/settings.local.json`。Codex 和 Copilot 不支持 `local` 作用域。 |
+| `--custom <path>` / `-c` | 包含自定义 hook 策略的 JS 文件路径 |
+
+## 行为
+
+- **不指定策略名称** - 打开交互式提示以选择策略
+- **指定具体名称** - 启用这些策略（追加到已启用的策略中）
+- **`all`** - 启用所有可用策略
+
+安装为追加模式：再次运行 `--install` 只会添加新策略，不会移除已有策略。
+
+## 示例
+
+```bash
+# 全局安装所有默认策略（交互式）
+failproofai policies --install
+
+# 为当前项目安装指定策略
+failproofai policies --install block-sudo sanitize-api-keys --scope project
+
+# 一次性启用所有策略
+failproofai policies --install all
+
+# 使用自定义策略文件安装
+failproofai policies --install --custom ./my-policies.js
+
+# 为 OpenAI Codex 安装（项目作用域）
+failproofai policies --install --cli codex --scope project
+
+# 为 GitHub Copilot CLI（测试版）安装到当前项目
+failproofai policies --install --cli copilot --scope project
+
+# 同时为三个 CLI 安装
+failproofai policies --install --cli claude codex copilot
+```
+
+当提供 `--custom <path>` 时，文件将立即进行验证——至少需要调用一次 `customPolicies.add()`。解析后的路径将作为 `customPoliciesPath` 保存到 `policies-config.json` 中。

package/.next/standalone/docs-old/zh/cli/list-policies.mdx

@@ -0,0 +1,31 @@
+---
+title: 列出策略
+description: "查看已启用的策略、其参数以及自定义策略"
+---
+
+```bash
+failproofai policies
+```
+
+显示所有策略及其状态、已配置的参数和自定义策略。
+
+## 示例输出
+
+```text
+Failproof AI Hook Policies (user)
+
+  Status  Name                          Description
+  ──────  ──────────────────────────────────────────────────────────────
+  ✓       block-sudo                    Block sudo commands
+            allowPatterns: ["sudo systemctl status"]
+  ✓       block-rm-rf                   Block recursive deletions
+  ✗       block-curl-pipe-sh            Block curl|bash patterns
+  ✓       sanitize-api-keys             Redact API keys from output
+            additionalPatterns: [{ regex: "MY_TOKEN_...", label: "..." }]
+
+  ── Custom Policies (/home/alice/myproject/my-policies.js) ──────────────
+  ✓       require-jira-ticket           Block commits without ticket
+  ✓       approval-gate                 Approval gate for destructive ops
+```
+
+`policyParams` 中未知的键会在此处标记出来，以便你尽早发现拼写错误。

package/.next/standalone/docs-old/zh/cli/migrate.mdx

@@ -0,0 +1,86 @@
+---
+title: 迁移主目录
+description: "将 ~/.failproofai 升级到当前版本所需的目录结构，并提前查看迁移计划"
+---
+
+```bash
+failproofai migrate --dry-run   # 打印迁移计划，不做任何更改
+failproofai migrate             # 执行迁移
+```
+
+大多数用户不需要手动执行此命令。它会在升级后首次运行任意命令时自动触发，[`failproofai update`](/zh/cli/update) 也会自动包含此步骤。仅在以下情况下才需要直接调用：希望在执行前预览迁移计划，或单独运行迁移流程。
+
+## 基于目录结构版本，而非发布版本
+
+`~/.failproofai/VERSION` 记录的是**目录结构**编号——代表目录的形态，而非写入该文件的发行版本号。迁移操作基于此编号进行，这使得跨越多个版本的迁移代价极低：
+
+- npm 版本随每次发布而变化，两个目录结构版本之间可能相差数十个发布版本。
+- 因此，若某台机器跳过了三十个发布版本，但**目录结构未发生变化**，则**不会执行任何**迁移，而不是执行三十次空操作。
+- 若某台机器一次性跨越多个目录结构版本，则会按顺序依次执行每个步骤，每个步骤只需了解自身的两个端点。
+
+这一设计非常重要，因为 npm 无法自动更新已安装的包。机器长时间停留在某个版本后一次性跨越多个目录结构版本，是常见情况，而非特殊情况。
+
+## 演练模式
+
+`--dry-run` 会打印完整的迁移链以及迁移前将被备份的文件，不做任何实际操作——不执行迁移、不创建备份、不写入记录：
+
+```
+Layout 2 on disk; this build speaks 3.
+1 step(s) would run:
+  2 → 3  layout 2 → 3: carry config.toml and credentials.toml into JSON, move
+         custom-policies/ back up into policies/, nest the policy config at the root
+
+These would be copied to ~/.failproofai/migrations/backup-layout2 first:
+  VERSION
+  config.toml
+  credentials.toml
+```
+
+## 哪些内容会被迁移，哪些会被重建
+
+主目录中的每个路径都声明了其所存储的数据类型，这决定了迁移时是否可以将其丢弃。规则如下：**可派生或可重新获取的数据可以丢弃；由您手动输入的内容、尚未投递的内容，以及标识机器身份的内容，都会被保留。**
+
+| 保留内容 | 重建或重新获取的内容 |
+|---|---|
+| `config.json` — 设置项、`daemon.configured`、额外捕获路径 | 审计缓存 |
+| `credentials.json` — 您的云端注册信息 | 云端管理的部署项（在下次轮询时重新获取并进行摘要验证） |
+| `policies-config.json` — 您的策略选择与参数 | 守护进程临时状态 |
+| `policies/` — 您自己的策略文件及其引用的辅助文件 | |
+| `hook-activity/` — 仪表板读取的决策日志 | |
+| 队列中尚未上传的待投递事件 | |
+| `cursors/` — 采集器水位标记 | |
+| `bin/` 中的守护进程二进制文件 | |
+
+<Note>
+  待投递事件会被保留而非丢弃，因为丢失是永久性的，而非短暂延迟：采集器的水位标记已经超过了队列中所有内容的位置，因此没有任何机制能再次读取转录文件中那段范围的数据。迁移完成后，系统还会通知守护进程立即投递队列中的内容，因此通常情况下不会有任何内容需要保留。
+</Note>
+
+**较新**版本写入 `config.json`、`credentials.json` 或 `policies-config.json` 中的键也会被保留，而不会被旧版本读取器丢弃。
+
+## 迁移留下的记录
+
+```
+~/.failproofai/migrations/
+  applied.json                 每个步骤一条记录：目录结构版本、CLI 版本、时间戳、耗时、结果
+  backup-layout<n>/            执行第一个步骤前备份的不可替代文件副本
+```
+
+`applied.json` 是回答"这台机器究竟经历了什么"的依据——升级后出现异常时，这是最值得首先查看的文件。请在提交问题报告时附上此文件。
+
+备份内容有意保持精简，而非复制整个目录：从设计上讲，迁移不再删除任何不可替代的内容，因此真正需要防范的是**步骤中的缺陷**，而这少数几个文件正是此类缺陷可能造成损害的地方。
+
+## 步骤失败时的处理
+
+迁移链在失败处停止。`VERSION` 仅在步骤成功完成后才会被更新，因此主目录仍保留旧的目录结构编号，下次执行命令时会重试——主目录永远不会因部分迁移成功而被标记为最新状态。失败的步骤会以 `"ok": false` 记录在 `applied.json` 中，备份文件保留在原来的位置。
+
+## 较新的主目录会被拒绝，而非迁移
+
+如果 `~/.failproofai/` 是由比当前运行版本**更新**的 failproofai 写入的，命令会停止并提示您进行升级。该数据本身没有问题，更新的 CLI 可以正常读取；向"旧"方向迁移并不存在，而重置它会破坏可恢复的数据。
+
+```
+This machine's failproofai directory was written by a newer version (layout 4;
+this build speaks 3). Upgrade rather than migrate:
+  npm install -g failproofai@latest
+```
+
+守护进程遵循同样的规则：`failproofaid` 拒绝在其不支持的目录结构版本上启动，而不是读写已移动位置的路径。

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

@@ -0,0 +1,43 @@
+---
+title: 卸载策略
+description: "从 Claude Code 的设置中移除 hook 条目"
+---
+
+```bash
+failproofai policies --uninstall [policy-names...] [options]
+```
+
+从 Claude Code 的 `settings.json` 中移除 failproofai hook 条目。
+
+别名：`failproofai p -u`
+
+## 选项
+
+| 标志 | 描述 |
+|------|------|
+| `--scope user` | 从全局设置中移除（默认） |
+| `--scope project` | 从项目设置中移除 |
+| `--scope local` | 从本地设置中移除 |
+| `--scope all` | 从所有范围中一次性移除 |
+| `--custom` / `-c` | 从配置中清除 `customPoliciesPath` |
+
+## 行为说明
+
+- **不指定策略名称** — 从设置文件中移除所有 failproofai hook 条目
+- **指定具体名称** — 禁用这些策略，但保留已安装的 hooks
+
+## 示例
+
+```bash
+# 全局移除所有 hooks
+failproofai policies --uninstall
+
+# 禁用特定策略（保留已安装的 hooks）
+failproofai policies --uninstall block-sudo
+
+# 从所有范围中移除 hooks
+failproofai policies --uninstall --scope all
+
+# 清除自定义策略路径
+failproofai policies --uninstall --custom
+```

package/.next/standalone/docs-old/zh/cli/update.mdx

@@ -0,0 +1,65 @@
+---
+title: 升级后更新
+description: "完成 npm 无法完成的另一半升级工作：迁移 home 目录并匹配守护进程"
+---
+
+```bash
+npm install -g failproofai@latest && failproofai update
+```
+
+这就是完整的升级流程。`npm` 替换 CLI；`failproofai update` 完成其余工作。
+
+## 为什么需要第二条命令
+
+`npm install -g` 只替换一个东西——CLI。failproofai 安装中还有另外两个组件有意存放在包之外，npm 运行时两者都不会移动：
+
+- **`~/.failproofai/`**，存放你的设置、云端注册信息、策略选择和历史记录。新版本可能对其结构有所调整，而这种重组必须由同时了解新旧两种结构的代码来完成。
+- **`failproofaid` 守护进程二进制文件**，位于 `~/.failproofai/bin/failproofaid-<version>`。它故意不放在 `node_modules` 内：升级时在运行中的服务下替换该文件，会让一个活跃的守护进程指向由不同源码构建的二进制文件，而删除该包则会在服务仍在运行时将其删除，导致每次启动时崩溃循环。
+
+因此，单独执行 `npm install -g` 后，CLI 是新的，但守护进程并不是。`failproofaid` 拒绝以它无法识别的 home 目录布局启动——这是对版本不匹配的显式报错，而非无声失败——所以需要将两部分同步。`failproofai update` 就是完成这一步骤的命令。
+
+## 它做了什么
+
+<Steps>
+  <Step title="执行所有待处理的布局迁移">
+    读取记录在 `~/.failproofai/VERSION` 中的布局版本，并执行将其升级到当前版本所需的步骤。通常无需任何操作——参见
+    [`failproofai migrate`](/zh/cli/migrate)。
+  </Step>
+  <Step title="将匹配的守护进程二进制文件就位">
+    优先从 npm 已下载的平台包中获取（无需网络），否则从该精确版本的发布资产中下载，并在使用前进行 SHA-256 验证。
+  </Step>
+  <Step title="重启服务并确认其已恢复运行">
+    通过探测而非假设来确认——服务管理器在进程派生的那一刻就报告其处于活跃状态，但这与服务正常运行并不等同。
+  </Step>
+</Steps>
+
+## 选项
+
+| 标志 | 效果 |
+|------|--------|
+| `--no-daemon` | 仅迁移 home 目录，守护进程保持当前版本不变。 |
+
+<Warning>
+  `--no-daemon` 会保留一个版本不匹配的守护进程。在配置为需要守护进程的机器上，如果守护进程无法响应，每个 hook 事件都会**失败关闭**——而拒绝以已迁移的 home 目录启动的守护进程自然无法响应。建议让守护进程部分也正常运行。
+</Warning>
+
+## 如果出现问题
+
+命令以非零值退出，并说明哪一半失败了。有两种情况值得了解：
+
+- **迁移步骤未完成。** home 目录会保留其*旧*布局标记，因此下一次命令会重试——在部分迁移完成的情况下，home 目录永远不会被标记为当前状态。在任何操作执行之前，你的设置和注册信息的副本已保存到 `~/.failproofai/migrations/backup-layout<n>/`。
+- **守护进程在没有密码的情况下无法重启。** 故意使用 `sudo -n`，因此在进度显示过程中不会有任何提示弹出。命令会打印出你需要自行运行的确切命令行。
+
+<Note>
+  这里的任何操作都不需要交互式设置向导。你的设置、云端注册信息和策略选择在升级后都会保留，因此已迁移的机器的执行效果与之前完全一致——这对于无人值守的机器尤为重要：CI 运行器、集群节点、无头网关等。
+</Note>
+
+## 自动化
+
+`failproofai update` 是非交互式的，即使没有任何需要处理的内容也可以安全运行——它会报告"无需迁移"并以 0 退出。在配置脚本或 Dockerfile 中将其放在每次升级之后是预期的使用方式：
+
+```dockerfile
+RUN npm install -g failproofai@latest && failproofai update --no-daemon
+```
+
+（在镜像构建中使用 `--no-daemon`，因为此时还没有服务需要重启。）

package/.next/standalone/docs-old/zh/cli/version.mdx

@@ -0,0 +1,12 @@
+---
+title: 查看版本
+description: "打印已安装的 failproofai 版本"
+---
+
+```bash
+failproofai --version
+# or
+failproofai -v
+```
+
+打印已安装的版本号。