failproofai 0.0.6-beta.0 → 0.0.6-beta.2

package/.next/standalone/docs/zh/getting-started.mdx

@@ -1,13 +1,13 @@
 ---
-title: 快速入门
+title: 快速开始
 description: "安装 failproofai，启用策略，让你的 Agent 稳定运行"
 icon: rocket
 ---
 
-## 系统要求
+## 环境要求
 
 - **Node.js** >= 20.9.0
-- **Bun** >= 1.3.0（可选 - 仅从源码构建时需要）
+- **Bun** >= 1.3.0（可选，仅在从源码构建时需要）
 
 ---
 
@@ -27,7 +27,7 @@ bun add -g failproofai
 
 ---
 
-## 快速开始
+## 快速上手
 
 <Steps>
   <Step title="启用策略">
@@ -37,37 +37,37 @@ bun add -g failproofai
     failproofai policies --install
     ```
 
-    此命令会将 hook 条目写入 Claude Code 的 `settings.json`。你也可以针对单个项目安装，或选择特定策略：
+    该命令会将 hook 条目写入 Claude Code 的 `settings.json`。你也可以仅为单个项目安装，或选择特定策略：
 
     ```bash
     failproofai policies --install --scope project
     failproofai policies --install block-sudo block-rm-rf sanitize-api-keys
     ```
   </Step>
-  <Step title="验证">
+  <Step title="验证安装">
     ```bash
     failproofai policies
     ```
 
-    显示所有策略、是否已启用以及已配置的参数。
+    显示所有策略、启用状态及已配置的参数。
   </Step>
-  <Step title="启动仪表板">
+  <Step title="启动控制台">
     ```bash
     failproofai
     ```
 
-    在 `http://localhost:8020` 打开本地仪表板，你可以在此浏览会话、查看工具调用详情并管理策略。
+    在 `http://localhost:8020` 打开本地控制台，你可以在此浏览会话记录、查看工具调用详情并管理策略。
   </Step>
   <Step title="运行你的 Agent">
-    像往常一样启动 Claude Code。如果 Agent 尝试执行高风险操作，failproofai 会自动拦截。让它在无人值守的情况下运行，之后在仪表板中查看执行记录。
+    像往常一样启动 Claude Code。如果 Agent 尝试执行风险操作，failproofai 会自动拦截。你可以让其在无人值守的情况下运行，之后在控制台中回顾发生的一切。
   </Step>
 </Steps>
 
 ---
 
-## 策略的工作原理
+## 策略工作原理
 
-每当 Agent 运行工具时，Claude Code 会将 failproofai 作为子进程调用：
+每当 Agent 运行工具时，Claude Code 会以子进程方式调用 failproofai：
 
 ```text
 Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
@@ -75,11 +75,11 @@ Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
                                                  writes decision to stdout
 ```
 
-每个策略返回以下三种决策之一：
+每条策略会返回以下三种决策之一：
 
 - **allow** - Agent 正常继续执行
-- **deny** - 操作被阻止，并告知 Agent 原因
-- **instruct** - 向 Agent 的提示词中追加额外上下文
+- **deny** - 操作被拦截，并将原因告知 Agent
+- **instruct** - 向 Agent 的提示词中追加额外的上下文信息
 
 <Note>
 策略在你的本地进程中运行，不会向任何远程服务发送数据。
@@ -87,6 +87,58 @@ Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
 
 ---
 
+## 使用约定式策略为团队制定统一规范
+
+在团队中建立质量标准最快的方式是使用 `.failproofai/policies/` 约定目录。只需将策略文件放入该目录，它们会自动加载——无需任何标志、配置变更或安装命令。
+
+<Steps>
+  <Step title="创建策略目录">
+    ```bash
+    mkdir -p .failproofai/policies
+    ```
+  </Step>
+  <Step title="添加策略文件">
+    复制示例文件或编写你自己的策略：
+
+    ```bash
+    cp node_modules/failproofai/examples/convention-policies/*.mjs .failproofai/policies/
+    ```
+
+    或者新建一个策略文件：
+
+    ```js
+    // .failproofai/policies/team-policies.mjs
+    import { customPolicies, allow, deny, instruct } from "failproofai";
+
+    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"
+    ```
+
+    所有安装了 failproofai 的团队成员都会自动获取这些策略，无需单独配置。
+  </Step>
+</Steps>
+
+<Tip>
+将 `.failproofai/policies/` 提交到代码仓库，让整个团队共享同一套规范。随着团队发现新的故障模式，持续添加策略并推送更新——所有人在下次 `git pull` 时即可获取最新内容。随着时间推移，这些策略将成为不断演进的质量标准。
+</Tip>
+
+---
+
 ## 数据存储
 
 所有配置和日志均保存在本地：
@@ -94,10 +146,10 @@ Claude Code  →  failproofai --hook PreToolUse  →  reads stdin JSON
 | 路径 | 存储内容 |
 |------|----------------|
 | `~/.failproofai/policies-config.json` | 全局策略配置 |
-| `~/.failproofai/hook-activity.jsonl` | Hook 执行历史记录 |
+| `~/.failproofai/hook-activity.jsonl` | Hook 执行历史 |
 | `~/.failproofai/hook.log` | 自定义 hook 错误的调试日志 |
-| `.failproofai/policies-config.json` | 项目级配置（可提交至版本库） |
-| `.failproofai/policies-config.local.json` | 个人覆盖配置（已被 gitignore） |
+| `.failproofai/policies-config.json` | 项目级配置（可提交至仓库） |
+| `.failproofai/policies-config.local.json` | 个人覆盖配置（已加入 gitignore） |
 
 ---
 
@@ -115,16 +167,16 @@ failproofai policies --uninstall
 
 <CardGroup cols={2}>
 
-<Card title="配置" icon="gear" href="/zh/configuration">
+<Card title="配置说明" icon="gear" href="/zh/configuration">
   作用域与配置文件格式
 </Card>
 
 <Card title="内置策略" icon="shield" href="/zh/built-in-policies">
-  全部 26 个策略及其参数说明
+  全部 26 条策略及其参数说明
 </Card>
 
 <Card title="自定义策略" icon="code" href="/zh/custom-policies">
-  用 JavaScript 编写你自己的策略
+  使用 JavaScript 编写你自己的策略
 </Card>
 
 <Card title="Agent 监控" icon="chart-line" href="/zh/dashboard">

package/.next/standalone/node_modules/@next/env/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@next/env",
-  "version": "16.2.3",
+  "version": "16.2.4",
   "keywords": [
     "react",
     "next",

package/.next/standalone/node_modules/next/dist/build/swc/index.js

@@ -134,7 +134,7 @@ var HmrTarget = /*#__PURE__*/ function(HmrTarget) {
     HmrTarget["Server"] = "server";
     return HmrTarget;
 }({});
-const nextVersion = "16.2.3";
+const nextVersion = "16.2.4";
 const ArchName = (0, _os.arch)();
 const PlatformName = (0, _os.platform)();
 function infoLog(...args) {