failproofai 1.0.1-beta.1 → 1.0.1

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

@@ -0,0 +1,151 @@
+---
+title: 控制台
+description: "监控 Agent 会话、查看工具调用并管理策略"
+icon: chart-line
+---
+
+failproofai 控制台是一个本地 Web 应用，用于监控 AI Agent 会话和管理策略。查看 Agent 在您离开期间所做的一切。
+
+---
+
+## 启动控制台
+
+```bash
+failproofai
+```
+
+访问地址：`http://localhost:8020`。
+
+控制台直接从文件系统读取本地项目、会话和 failproofai 配置数据。可选的需认证功能（如审计提醒和邀请）会将相关请求所需的信息（包括电子邮件地址）发送至远程 API。
+
+---
+
+## 页面
+
+### 项目
+
+列出在您计算机上发现的所有 Claude Code、OpenAI Codex、GitHub Copilot CLI _(beta)_、Cursor Agent _(beta)_、OpenCode _(beta)_、Pi _(beta)_、Hermes、OpenClaw、Factory Droid、Devin、Antigravity 和 Goose 项目。Claude 项目从 `~/.claude/projects/`（或由 `CLAUDE_PROJECTS_PATH` 设置的路径）中发现；Codex 项目通过扫描 `~/.codex/sessions/<YYYY>/<MM>/<DD>/*.jsonl` 下的所有记录并按每个会话第一条记录中的 `cwd` 分组来发现；Copilot CLI 项目通过扫描各 `~/.copilot/session-state/<sessionId>/workspace.yaml`（可通过 `COPILOT_HOME` 配置）并按其 `cwd` 字段分组来发现；Cursor Agent 项目通过扫描 `~/.cursor/agent-sessions/<sessionId>/`（可通过 `CURSOR_HOME` 配置，备用路径为 `conversations/` 和 `sessions/`）下每个会话的元数据，从 `meta.json` / `session.json` / `workspace.yaml` 中查找 `cwd` 标量来发现；OpenCode 项目通过 `opencode db --format json` 查询位于 `~/.local/share/opencode/opencode.db` 的 SQLite 数据库来发现（读取 `session` 和 `project` 表并按 `project_id` 分组）；Pi 项目通过扫描 `~/.pi/agent/sessions/<encoded-cwd>/<timestamp>_<uuid>.jsonl`（可通过 `PI_SESSIONS_DIR` 配置）下每个会话的 JSONL 记录，并从每个会话的第一条记录中提取 `cwd` 来发现；Hermes 网关会话直接从每个配置文件的 SQLite 存储中读取——`~/.hermes/state.db` 以及 `~/.hermes/profiles/<name>/state.db`（可通过 `HERMES_HOME` 覆盖，或通过 `HERMES_DB_PATH` 指定单一数据库）——并按配置文件和 `source`（Slack/Telegram/cli/cron——网关会话没有 cwd）分组为 `hermes-<profile>-<source>` 项目；OpenClaw 网关会话从 `~/.openclaw/agents/<agentId>/sessions/*.jsonl` 读取，并按 agent 和频道分组为 `openclaw-<agentId>-<channel>` 项目（同样没有 cwd）；Factory Droid 项目从 `~/.factory/sessions/<encoded-cwd>/*.jsonl` 的 JSONL 记录中发现并按 cwd 分组；Devin 项目从 `~/.local/share/devin/cli/sessions.db` 的 SQLite 数据库（按每个会话的 `working_directory` 分组）中发现；Antigravity 项目从 `~/.gemini/antigravity-cli/brain/<conversationId>/…/transcript_full.jsonl` 的 JSONL 记录中发现并按 cwd 分组；Goose 项目从 `~/.local/share/goose/sessions/sessions.db` 的 SQLite 数据库（按每个会话的 `working_dir` 分组）中发现。被多个 CLI 使用过的项目会渲染为带有所有匹配徽章的单行。使用表格上方的 **CLI** 下拉菜单按特定 agent CLI 筛选；URL 会将您的选择保留为 `?cli=claude|codex|copilot|cursor|opencode|pi|hermes|openclaw|factory|devin|antigravity|goose`。
+
+Hermes 和 OpenClaw 是用户范围的，没有可用于分组的工作目录，因此它们渲染为**可折叠的文件夹树**——顶层为配置文件（或 agent），其下为各频道——而所有基于 cwd 的 CLI 保持平铺行。文件夹行汇总其下所有项的会话计数和最近活动，折叠状态在访问间保留，关键字搜索会展开匹配项。
+
+每个项目显示：
+- 项目名称（从文件夹路径派生）
+- CLI 徽章——`Claude Code`（橙色）、`OpenAI Codex`（紫色）、`GitHub Copilot`（蓝色）、`Cursor Agent`（翠绿色）、`OpenCode`（琥珀色）、`Pi`（粉色）和/或 `Hermes`（靛蓝色）
+- 最近会话活动的日期
+
+点击项目可查看其会话。
+
+### 会话
+
+列出项目内的所有会话。每个会话显示：
+- 会话 ID
+- 开始和结束时间戳
+- 工具调用次数
+- 钩子活动计数（触发的策略数）
+
+使用日期范围筛选器和会话 ID 搜索来缩小范围。会话支持分页。
+
+点击会话可打开会话查看器。
+
+### 会话查看器
+
+会话查看器解答自主 Agent 的关键问题：Agent 做了什么，它是否保持在正轨上？标题旁的 CLI 徽章指示会话是 Claude Code、OpenAI Codex、GitHub Copilot CLI、Cursor Agent、OpenCode、Pi、Hermes、OpenClaw、Factory Droid、Devin、Antigravity 还是 Goose 的记录。它显示会话中发生的所有事件的时间线：
+
+- **消息** - Claude 的文本响应和用户提示
+- **工具调用** - Claude 调用的每个工具及其输入和输出
+- **策略活动** - 每次工具调用触发了哪些策略以及返回了什么决策
+
+顶部的统计栏显示会话时长、总工具调用次数以及钩子决策摘要（allow / deny / instruct 计数）。
+
+点击 **下载日志** 按钮导出会话。Claude Code、Codex、Copilot、Cursor 和 Pi 会话将获得磁盘上的原始 JSONL 记录（逐字节）；OpenCode（其会话存储在 SQLite 中而非磁盘上）则获得一个镜像底层 `session` / `messages` / `parts` 表的 JSON 文档。
+
+### 审计
+
+关于您的 Agent 在过去会话中实际行为表现的个性化报告。运行与 `failproofai audit` CLI 相同的扫描，但以单屏可分享海报 + 四个折叠内容区块的形式呈现：
+
+1. **海报** — 填满第一屏视口。自包含的 PNG 截图区域，包含 failproof_ai 品牌标识 + 审计标签·原型索引（`№ NN of 08`）+ 审计日期·数字评分（0–100）+ 百分位排名徽章（`top 15%`）·原型名称（`the optimist`、`the cowboy`、`the explorer`、`the goldfish`、`the paranoid architect`、`the precision builder`、`the hammer`、`the ghost` 之一）+ 3 关键词条·`// only N% of agents are this archetype` 稀有度行·8×8 像素印记图块·`audit yours → failproof.ai` 页脚。截图框外有三个分享按钮：`post your archetype`（X 意图）、`share on linkedin`、`download poster`。截图通过 `html-to-image` 运行，因此 PNG 与屏幕上的渲染像素完全一致（虚线边框、SVG logo 遮罩、渐变、字体度量——全部保留）。
+2. **优势** — 列出您的 Agent 已经做得正确的行为，以平和的 ✓ 列表形式展示，数据来源于实时审计数据（干净的工具调用率、无直接推送到主分支、零凭证泄露、零重试风暴）——仅当相关策略在审计窗口内记录清白时才会显示。
+3. **问题** — 列出遗漏问题的表格，按严重程度排序：`时间 · 遗漏内容 + 本可捕获它的策略 · 严重程度徽章 · 出现次数`，其中复发次数显示为 `new`（一次）、`N× seen`（2–9 次）或 `recurring`（10+ 次）。
+4. **改进建议** — 平和的列表行，每个推荐策略一行：左侧为白色策略名称和一行描述，右侧为安装命令和复制按钮。区块标题显示 `enable all N → projected <score> · <tier>`（应用所有修复后可达到的评分），其 `[install all]` 按钮会复制针对所有推荐策略的组合 `failproofai policy add a b c …` 命令。
+5. **下次更好** — 两张并排卡片。左侧：设置提醒（`3d` / `7d` / `14d` / `30d` 周期选择器；认证后通过 `/api/auth/reminder` 持久化）。右侧：解锁 failproof 特权——`invite a friend` 打开一个模态框，接受逗号/空格/换行分隔的好友邮件列表（每次最多 10 个），通过 `/api/audit/invite` 发送 POST 请求，转发至 api-server 的 `POST /v0/invite`。api-server 从 `invite@failproof.ai` 向每位收件人发送邮件，同时将发件人抄送，并设置 `Reply-To`，以便收件人知道是谁邀请了他们，发件人也会在收件箱中收到一份副本。匿名用户会先通过 `AuthDialog` 进行路由，以便在发送邀请前获知发件人的邮件地址。权限/特权兑现为后续功能。
+
+由 `failproofai audit` 运行时驱动——请参阅 [审计 CLI](/zh/cli/audit) 了解底层扫描引擎、支持的标志和每个记录的缓存不变量。控制台将最新结果缓存在 `~/.failproofai/audit-dashboard.json`（模式 `0600`，单槽，新运行覆盖），以便再次访问时立即加载；**每个记录的缓存和整体结果缓存在读取时若超过 7 天则被拒绝**，因此控制台不会静默返回一周前的结果——超过 TTL 后 `/audit` 会回落到空状态并提示重新运行。点击报告底部附近的 `[ re-audit now ]` 会以 `noCache: true` 向 `/api/audit/run` 发送 POST 请求——重新审计会绕过每个记录的缓存，从头重新扫描每份记录，而不是静默返回缓存结果——控制台以 1Hz 轮询 `/api/audit/status` 直到运行完成；运行期间，一条粉色进度条固定在视口顶部并显示已用时间，完成后新结果会原地替换（无需整页刷新；重新审计失败时保留之前的报告）。失败时进度条变为红色，并根据 `RerunError.kind`（`timeout` / `network` / `post_failed`）显示对应文案。空状态（无缓存或已过期）和零会话状态（缓存存在但扫描未发现任何记录）会分别显示。
+
+### 策略
+
+一个两标签页面，用于管理策略和查看活动。
+
+<Tabs>
+  <Tab title="策略标签">
+  - 通过单一面板多选要让 failproofai 保护哪些 agent CLI——Claude Code、OpenAI Codex、GitHub Copilot、Cursor Agent、OpenCode、Pi 和 Hermes 均有各自行，显示安装状态（`Active` / `Detected` / `Inactive`）、用户范围设置路径和品牌色调。勾选或取消勾选您想要的 CLI，然后点击 `Apply changes` 一步完成安装/卸载差异。PATH 上检测到二进制文件的 CLI 会预先勾选。
+  - 单击切换单个策略的启用/禁用状态（写入 `~/.failproofai/policies-config.json`——在所有已安装的 CLI 间共享）
+  - 展开策略以配置其参数（适用于支持 `policyParams` 的策略）
+  - 设置自定义策略文件路径
+  </Tab>
+  <Tab title="活动标签">
+  - 跨所有会话触发的每个钩子事件的完整分页历史记录
+  - 按决策、事件类型、CLI（Claude Code / OpenAI Codex / GitHub Copilot _(beta)_ / Cursor Agent _(beta)_ / OpenCode _(beta)_ / Pi _(beta)_ / Hermes / OpenClaw / Factory Droid / Devin / Antigravity / Goose）、策略名称或会话 ID 筛选
+  - 每行显示：时间戳、策略名称、决策、CLI 徽章（橙色 = Claude Code，紫色 = OpenAI Codex，蓝色 = GitHub Copilot，翠绿色 = Cursor Agent，琥珀色 = OpenCode，粉色 = Pi，靛蓝色 = Hermes，青色 = OpenClaw，玫瑰色 = Factory Droid，紫罗兰色 = Devin，青蓝色 = Antigravity，青柠色 = Goose）、工具名称、会话 ID 以及 deny/instruct 决策的原因
+  - 点击会话 ID 可打开其记录——查看器会自动检测触发钩子的 CLI（Claude `~/.claude/projects/…`、Codex `~/.codex/sessions/…`、Copilot CLI `~/.copilot/session-state/<id>/events.jsonl`、Cursor Agent `~/.cursor/agent-sessions/<id>/events.jsonl`、OpenCode `~/.local/share/opencode/opencode.db`、Pi `~/.pi/agent/sessions/<encoded-cwd>/<id>.jsonl`、Hermes `~/.hermes/state.db`、OpenClaw `~/.openclaw/agents/<id>/sessions/*.jsonl`、Factory Droid `~/.factory/sessions/<encoded-cwd>/<id>.jsonl`、Devin `~/.local/share/devin/cli/sessions.db`、Antigravity `~/.gemini/antigravity-cli/brain/<id>/…/transcript_full.jsonl`、Goose `~/.local/share/goose/sessions/sessions.db`）并在标题中渲染对应的 CLI 徽章
+  </Tab>
+</Tabs>
+
+---
+
+## 自动刷新
+
+控制台在顶部导航栏中有一个自动刷新切换开关。启用后，当前页面会定期刷新以显示新会话和策略活动。对于监控长时间运行的自主 Agent 会话至关重要。
+
+---
+
+## 禁用页面
+
+如果您只需要控制台的某些部分，将 `FAILPROOFAI_DISABLE_PAGES` 设置为逗号分隔的页面名称列表：
+
+```bash
+FAILPROOFAI_DISABLE_PAGES=policies failproofai
+```
+
+有效值：`policies`、`projects`、`audit`。
+
+---
+
+## 配置项目路径
+
+默认情况下，控制台从标准 Claude Code 项目目录读取。对于自定义设置可以覆盖：
+
+```bash
+CLAUDE_PROJECTS_PATH=/custom/path/to/projects failproofai
+```
+
+---
+
+## 从非 localhost 主机访问
+
+在**开发模式**（`npm run dev`）下运行控制台，并从 localhost 以外的主机名访问时——例如自定义域名、远程 IP 或隧道 URL——您可能会看到如下警告：
+
+```text
+⚠ Blocked cross-origin request to Next.js dev resource /_next/webpack-hmr from "dashboard.example.com".
+```
+
+这是 Next.js 阻止对其 HMR（热模块重载）WebSocket 的跨域访问，这是一个仅限开发的功能。要允许您的主机，请使用 `--allowed-origins` 标志：
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com
+```
+
+对于多个主机或 IP，传递逗号分隔的列表：
+
+```bash
+npm run dev -- --allowed-origins dashboard.example.com,192.168.1.5
+```
+
+您也可以改为设置 `FAILPROOFAI_ALLOWED_DEV_ORIGINS` 环境变量：
+
+```bash
+FAILPROOFAI_ALLOWED_DEV_ORIGINS=dashboard.example.com npm run dev
+```
+
+<Note>
+这仅适用于开发模式。运行 `failproofai`（生产模式）时，不存在 HMR WebSocket，也没有跨域开发资源问题。
+</Note>

package/.next/standalone/docs-old/zh/examples.mdx

@@ -0,0 +1,307 @@
+---
+title: 示例
+description: "如何为 Claude Code 和 Agents SDK 设置钩子"
+icon: book-open
+---
+
+开箱即用的常见场景示例，每个示例都展示了如何安装以及预期效果。
+
+---
+
+## 为 Claude Code 设置钩子
+
+Failproof AI 通过 Claude Code 的[钩子系统](https://docs.anthropic.com/en/docs/claude-code/hooks)与其集成。运行 `failproofai policies --install` 时，它会在 Claude Code 的 `settings.json` 中注册钩子命令，这些命令会在每次工具调用时触发。
+
+<Steps>
+  <Step title="安装 failproofai">
+    ```bash
+    npm install -g failproofai
+    ```
+  </Step>
+  <Step title="启用所有内置策略">
+    ```bash
+    failproofai policies --install
+    ```
+  </Step>
+  <Step title="验证钩子是否已注册">
+    ```bash
+    cat ~/.claude/settings.json | grep failproofai
+    ```
+
+    你应该能看到 `PreToolUse`、`PostToolUse`、`Notification` 和 `Stop` 事件的钩子条目。
+  </Step>
+  <Step title="运行 Claude Code">
+    ```bash
+    claude
+    ```
+
+    策略现在会在每次工具调用时自动执行。尝试让 Claude 运行 `sudo rm -rf /`——它将被拦截。
+  </Step>
+</Steps>
+
+---
+
+## 为 Agents SDK 设置钩子
+
+如果你正在使用 [Agents SDK](https://docs.anthropic.com/en/docs/agents-sdk) 进行开发，可以通过编程方式使用相同的钩子系统。
+
+<Steps>
+  <Step title="在项目中安装 failproofai">
+    ```bash
+    npm install failproofai
+    ```
+  </Step>
+  <Step title="在 Agent 中配置钩子">
+    在创建 Agent 进程时传入钩子命令。钩子的触发方式与 Claude Code 中相同——通过 stdin/stdout JSON 进行通信：
+
+    ```bash
+    failproofai --hook PreToolUse   # called before each tool
+    failproofai --hook PostToolUse  # called after each tool
+    ```
+  </Step>
+  <Step title="为 Agent 编写自定义策略">
+    ```javascript
+    import { customPolicies, allow, deny } from "failproofai";
+
+    customPolicies.add({
+      name: "limit-to-project-dir",
+      description: "Keep the agent inside the project directory",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        const path = String(ctx.toolInput?.file_path ?? "");
+        if (path.startsWith("/") && !path.startsWith(ctx.session?.cwd ?? "")) {
+          return deny("Agent is restricted to the project directory");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="安装自定义策略">
+    ```bash
+    failproofai policies --install --custom ./my-agent-policies.js
+    ```
+  </Step>
+</Steps>
+
+---
+
+## 拦截破坏性命令
+
+最常见的配置——防止 Agent 造成不可逆的损害。
+
+```bash
+failproofai policies --install block-sudo block-rm-rf block-force-push block-curl-pipe-sh
+```
+
+功能说明：
+- `block-sudo` - 拦截所有 `sudo` 命令
+- `block-rm-rf` - 拦截递归删除文件
+- `block-force-push` - 拦截 `git push --force`
+- `block-curl-pipe-sh` - 拦截将远程脚本通过管道传入 shell 执行
+
+---
+
+## 防止密钥泄露
+
+阻止 Agent 在工具输出中读取或泄露凭证信息。
+
+```bash
+failproofai policies --install sanitize-api-keys sanitize-jwt sanitize-connection-strings sanitize-bearer-tokens
+```
+
+这些策略在 `PostToolUse` 阶段触发——工具运行后，在 Agent 读取输出之前对其进行脱敏处理。
+
+---
+
+## 在 Agent 需要关注时发送 Slack 通知
+
+使用通知钩子将空闲提醒转发到 Slack。
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "slack-on-idle",
+  description: "Alert Slack when the agent is waiting for input",
+  match: { events: ["Notification"] },
+  fn: async (ctx) => {
+    const webhookUrl = process.env.SLACK_WEBHOOK_URL;
+    if (!webhookUrl) return allow();
+
+    const message = String(ctx.payload?.message ?? "Agent is waiting");
+    const project = ctx.session?.cwd ?? "unknown";
+
+    try {
+      await fetch(webhookUrl, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+          text: `*${message}*\nProject: \`${project}\``,
+        }),
+        signal: AbortSignal.timeout(5000),
+      });
+    } catch {
+      // never block the agent if Slack is unreachable
+    }
+
+    return allow();
+  },
+});
+```
+
+安装方式：
+
+```bash
+SLACK_WEBHOOK_URL=https://hooks.slack.com/... failproofai policies --install --custom ./slack-alerts.js
+```
+
+---
+
+## 将 Agent 限制在指定分支
+
+防止 Agent 切换分支或推送到受保护的分支。
+
+```javascript
+import { customPolicies, allow, deny } from "failproofai";
+
+customPolicies.add({
+  name: "stay-on-branch",
+  description: "Prevent the agent from checking out other branches",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+checkout\s+(?!-b)/.test(cmd)) {
+      return deny("Stay on the current branch. Create a new branch with -b if needed.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## 提交前要求运行测试
+
+提醒 Agent 在提交代码前先运行测试。
+
+```javascript
+import { customPolicies, allow, instruct } from "failproofai";
+
+customPolicies.add({
+  name: "test-before-commit",
+  description: "Remind the agent to run tests before committing",
+  match: { events: ["PreToolUse"] },
+  fn: async (ctx) => {
+    if (ctx.toolName !== "Bash") return allow();
+    const cmd = String(ctx.toolInput?.command ?? "");
+    if (/git\s+commit/.test(cmd)) {
+      return instruct("Run tests before committing. Use `npm test` or `bun test` first.");
+    }
+    return allow();
+  },
+});
+```
+
+---
+
+## 锁定生产仓库
+
+在项目中提交一份项目级配置，让团队中的每位开发者都能应用相同的策略。
+
+在仓库中创建 `.failproofai/policies-config.json`：
+
+```json
+{
+  "enabledPolicies": [
+    "block-sudo",
+    "block-rm-rf",
+    "block-force-push",
+    "block-push-master",
+    "block-env-files",
+    "sanitize-api-keys",
+    "sanitize-jwt"
+  ],
+  "policyParams": {
+    "block-push-master": {
+      "protectedBranches": ["main", "release", "production"]
+    }
+  }
+}
+```
+
+然后提交：
+
+```bash
+git add .failproofai/policies-config.json
+git commit -m "Add failproofai team policies"
+```
+
+所有已安装 failproofai 的团队成员将自动获取这些规则。
+
+---
+
+## 通过约定策略构建全组织质量标准
+
+最具影响力的配置：将针对项目定制的策略提交到仓库的 `.failproofai/policies/` 目录。每位团队成员都能自动获取——无需执行安装命令，无需修改配置。
+
+<Steps>
+  <Step title="创建目录并添加策略">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    // Enforce your team's preferred package manager
+    // (or enable the built-in prefer-package-manager policy instead)
+    customPolicies.add({
+      name: "enforce-bun",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        const cmd = String(ctx.toolInput?.command ?? "");
+        if (/\bnpm\b/.test(cmd)) return deny("Use bun instead of npm.");
+        return allow();
+      },
+    });
+
+    // Remind the agent to run tests before committing
+    customPolicies.add({
+      name: "test-before-commit",
+      match: { events: ["PreToolUse"] },
+      fn: async (ctx) => {
+        if (ctx.toolName !== "Bash") return allow();
+        if (/git\s+commit/.test(ctx.toolInput?.command ?? "")) {
+          return instruct("Run tests before committing.");
+        }
+        return allow();
+      },
+    });
+    ```
+  </Step>
+  <Step title="提交到 git">
+    ```bash
+    git add .failproofai/policies/
+    git commit -m "Add team quality policies"
+    ```
+  </Step>
+  <Step title="持续改进">
+    每当团队遇到新的故障模式时，添加新策略并推送。所有人在下次 `git pull` 时即可获取更新。这些策略将成为随团队成长而不断演进的质量标准。
+  </Step>
+</Steps>
+
+---
+
+## 更多示例
+
+仓库中的 [`examples/`](https://github.com/failproofai/failproofai/tree/main/examples) 目录包含以下内容：
+
+| 文件 | 内容说明 |
+|------|---------------|
+| `policies-basic.js` | 入门策略——拦截生产环境写入、force push、管道脚本 |
+| `policies-notification.js` | 空闲通知和会话结束时的 Slack 告警 |
+| `policies-advanced/index.js` | 传递导入、异步钩子、PostToolUse 输出脱敏、Stop 事件处理 |

package/.next/standalone/docs-old/zh/for-agents.mdx

@@ -0,0 +1,38 @@
+---
+title: "面向智能体"
+description: "一条命令即可将 Failproof AI 知识添加到你的编程智能体中。支持 Claude Code、Cursor、Windsurf 等。"
+---
+
+一条命令即可将完整的 Failproof AI 参考文档添加到你的编程智能体中。支持 Claude Code、Cursor、Windsurf 以及任何支持技能（skills）的智能体。
+
+```bash
+npx skills add https://docs.befailproof.ai
+```
+
+`npx skills` 会自动检测你已安装的智能体，并以适合各自的格式添加技能。
+
+## 技能涵盖的内容
+
+| 领域 | 包含内容 |
+|------|----------------|
+| 策略 | 内置策略名称、事件类型、参数、启用/禁用 |
+| 自定义策略 | `customPolicies.add()`、匹配过滤器、`allow`/`deny`/`instruct` API |
+| 上下文对象 | `ctx.eventType`、`ctx.toolName`、`ctx.toolInput`、`ctx.session` |
+| 配置 | `policies-config.json` 结构、作用域合并、`policyParams` |
+| CLI | `failproofai policies --install`、`--uninstall`、`--custom`、作用域 |
+| 仪表盘 | 会话查看器、策略活动、环境变量 |
+| 架构 | Hook 处理器流程、退出码、stdin/stdout 协议 |
+
+## 技能内容是否完整？
+
+Mintlify 会从导航中的所有页面生成 `llms.txt`。Failproof AI 文档涵盖完整的 API——每一条策略、选项和示例均已收录。如果你发现有所遗漏，源文件位于 `https://docs.befailproof.ai/llms-full.txt`。
+
+如需精准获取特定内容，可直接链接到具体页面：
+
+```bash
+# 仅获取自定义策略 API
+npx skills add https://docs.befailproof.ai/custom-policies
+
+# 仅获取内置策略
+npx skills add https://docs.befailproof.ai/built-in-policies
+```