diff --git a/README.ja.md b/README.ja.md
new file mode 100644
index 00000000..a4d4436f
--- /dev/null
+++ b/README.ja.md
@@ -0,0 +1,337 @@
+
+ 
+
+
+iFixAi
+
+
+ English · 简体中文 · 日本語
+
+
+AI の運用上の不整合を診断するツール
+問題が手に負えなくなる前に、エージェントのミスや死角を見つけます。
+
+
+ クイックスタート •
+ 3 つの実行方法 •
+ エージェントをテスト •
+ スコアリング •
+ ドキュメント •
+ コントリビューション
+
+
+
+ 
+ 
+ 
+ 
+ 
+
+
+
+ 
+
+ 1 回の ifixai run でエンドツーエンドに実行できます。ガイド付きセットアップが対象システム、評価モデル、スイートを選択し、接続を検証して設定を保存します。5 つの柱にわたる 32 件の検査を実行し、コアピラー別のスコアカードとともに A〜F の評価を返します。
+
+
+---
+
+## 概要
+
+iFixAi は、AI の運用上の不整合がビジネスに損害を与える前に検出します。ここでいう運用上の不整合とは、AI の動作、不作為、振る舞いが、ビジネスで意図、設計、期待
+されている内容と一致しないことを意味します。危険なのは、こうした問題が通常の KPI
+にはほとんど現れない点です。エージェントはダッシュボード上の目標をすべて達成しながら、
+ひそかに権限を漏らしたり、引用を捏造したり、誘導的なプロンプトに屈したり、許可されて
+いない操作を実行したりする可能性があります。これらの死角は、損害が発生してかなり
+経ってからインシデント、顧客からの苦情、規制当局からの質問として表面化します。
+iFixAi はそれらを先に見つけます。
+
+エージェントに対して最大 45 件の検査を実行し、直接的なポリシー準拠から敵対的な圧力、
+構造上のエッジケースまで確認します。検査は 32 件のコア検査と 13 件の拡張検査という
+2 つの層に分かれます。32 件のコア検査は、不整合リスクの 5 つの柱である捏造、操作、
+欺瞞、予測不能性、不透明性を対象とします。この検査だけが文字評価を算出し、5 分未満で
+返します。13 件の拡張検査は、妨害、能力隠し、監督回避、権限拡大など、フロンティア
+エージェントに関する 11 の高度なリスクカテゴリを対象とします。これらは個別に採点・
+報告され、評価を動かすことはありません。ただし P01 は必須最低条件であるため、
+評価の上限を設定できますが、評価を引き上げることはありません。
+
+信頼性こそが目的であるため、iFixAi は自身の位置づけを正直に示します。これは認証でも
+安全保証でもありません。CI で繰り返し実行できる診断ツールです。デフォルトでは、
+エージェント自身ではなく独立したプロバイダーが評価し、Standard モードでは 1 つ、
+Full モードでは 2 つ以上の評価モデルをアンサンブルします。また、各実行ですべての
+入力を記録したマニフェストを出力するため、結果を監査して再現できます。
+
+## 3 つの実行方法
+
+3 つの方法はいずれも同じ診断を実行します。違いは設定方法と操作方法だけです。
+
+| | **CLI：ガイド付きウィザード** | **CLI：明示的なフラグ** | **プラグインまたは Skill** |
+|---|---|---|---|
+| **操作方法** | 最初に `ifixai setup` を 1 回実行 → 以後は引数なしで `ifixai run` を実行。設定は `ifixai.yaml` に保存 | すべてのオプションを CLI フラグで渡す。完全にスクリプト化可能 | エージェントがオペレーターとなり、設定を検出し、フィクスチャを構築して実行し、スコアカードを説明 |
+| **最適な用途** | 初めての利用、すばやい反復実行、チームのオンボーディング | CI、自動化、監査対応のスクリプトバッチ | 普段使用するエージェント内で、ガイドと説明、インタラクティブなスコアカードを伴う実行 |
+| **セットアップ** | `pip install "ifixai[]"` + `ifixai setup` | `pip install "ifixai[]"` + キーをエクスポート | Claude Code または Codex：プラグインをインストール（自動セットアップ）。その他のエージェント：`uvx ifixai install` で `/ifixai-skill` を生成 |
+| **キー** | ウィザードが自動検出。キー本体ではなく環境変数名だけを `ifixai.yaml` に保存 | `--api-key` フラグまたは環境変数 | 各プロバイダーのキーを対応する環境変数から取得し、コマンドラインには置かない |
+| **テスト対象** | 任意のプロバイダー、またはエージェントの実際のエンドポイント | 同じ | 同じ |
+| **評価者** | 自己評価、1 つの独立ベンダー、または複数評価モデルのアンサンブル | 同じ | 同じ |
+| **出力** | JSON + Markdown レポート + リッチなターミナルスコアカード | 同じ | インタラクティブな結果アーティファクト（JSON の信頼できる情報源と静的レポートのフォールバックも提供） |
+| **スイート** | ウィザードで矢印キーを使って選択 | `--suite smoke\|strategic\|core\|extended\|all` | エージェントが `--mode`/`--suite` を選択。CLI と同じエンジンを使用 |
+| **対応環境** | 任意のターミナル | 任意のターミナル / CI | Claude Code、Cursor、Codex、VS Code、Windsurf、Cline、Continue、Gemini、Zed |
+
+## クイックスタート
+
+実際に試してみましょう。上の表から方法を選んでください。完全な手順は **[docs/get-started.md](docs/get-started.md)** にあります。
+
+### ガイド付きウィザード（推奨）
+
+```bash
+pip install "ifixai[openai]" # または anthropic、gemini など：テストするプロバイダーの extra をインストール
+ifixai setup # 矢印キーのウィザード：プロバイダー、モデル、評価モデル、スイートを選択 → ifixai.yaml に書き込み
+ifixai run # フラグ不要。レポートは ./ifixai-results/ に保存
+```
+
+`ifixai setup` は環境内にある API キーを検出し、各プロンプトの上部に表示します。
+キーが見つからない場合は、エクスポートすべき環境変数を案内します。実行時にも見つからなければ、
+最初の API 呼び出し前に入力を求めます。
+
+**Windows の注意：**PowerShell が `ifixai` を見つけられない場合（`pip install` の後）は、
+Python の `Scripts\` フォルダーを PATH に追加するか、`python -m ifixai` として実行してください。
+これは Windows で一般的な Python の PATH 問題であり、iFixAi の問題ではありません。
+
+### プラグイン（Claude Code と Codex）
+
+エージェントから実行する場合は、自動プロビジョニングフックを備えた 1 回限りのネイティブインストールを推奨します。実行ごとのセットアップは不要です。自然な言葉で
+（例：*「自分の環境で iFixAi を実行して」*）依頼すると、エージェントが設定を検出し、
+フィクスチャを構築し、課金前に費用を提示し、選択したモデルと評価モデルで診断を実行して、
+スコアカードを順に説明します。
+
+**Claude Code**：[Claude Code](https://claude.com/claude-code) 内で次を実行します。
+
+```
+/plugin marketplace add ifixai-ai/iFixAi
+/plugin install ifixai@ifixai-ai
+```
+
+次に *「自分の環境で iFixAi を実行して」* と依頼するか、**`/ifixai:ifixai`** と入力します。
+（表示されない場合は Claude Code を再起動するか、`/reload-plugins` を実行してください。）
+
+**Codex**：ターミナルで次を実行します。
+
+```
+codex plugin marketplace add ifixai-ai/iFixAi
+codex plugin add ifixai@ifixai-ai
+```
+
+その後 Codex を起動し、*「自分の環境で iFixAi を実行して」* と依頼します。Codex は
+プラグインのフックを信頼するか一度だけ確認し、最初のセッションでエンジンを用意します。
+
+### Skill（すべてのエージェント）
+
+生成ファイルを 1 つだけにしたい場合や、プラグイン非対応のエージェントを使用する場合は、1 つのゼロインストールコマンドで、任意のエージェントにネイティブな
+**`/ifixai-skill`** スラッシュコマンドを生成できます。対象は **Claude Code、Codex**、
+Cursor、VS Code / Copilot、Windsurf、Cline、Continue、Gemini、Zed です
+（`AGENTS.md` ブリッジも含まれます）。生成に必要なのは `uv` と Python 3.10+ だけで、API キーやプロバイダーの extra は不要です。
+
+```bash
+uvx ifixai install --agents cursor # 任意のスラッグ：claude、codex、vscode、windsurf、cline、continue、gemini、zed
+uvx ifixai install --agents all # すべてのエージェント向けに一括生成
+uvx ifixai install --list # 対応する全エージェントとファイルの出力先を表示
+```
+
+その後、対象エージェントで **`/ifixai-skill`** を実行します。設定を読み取り、フィクスチャを構築し、無料の `--dry-run` で費用を表示して、同意した後にのみ実行します（実行自体も
+ゼロインストールで、`uvx --from "ifixai[]" ifixai run` を駆動します）。
+新しいプロジェクトでは `--agents` でエージェントを指定してください
+（自動検出はフォルダーがすでに存在するエージェントだけを検出します）。CLI が PATH に
+ある場合は `uvx` の接頭辞を外せます。コマンド名は `ifixai-skill` で、Claude Code
+プラグインの `/ifixai` と競合しません。短い名前にするには `--name ifixai` を渡します。
+
+### 明示的なフラグ
+
+```bash
+# 1. CLI + テストするプロバイダーの extra をインストール
+pip install "ifixai[anthropic]"
+
+# 2. パイプラインの動作を確認：組み込み mock、キー不要、ネットワーク不要、約 1 秒
+ifixai run --provider mock --api-key not-used --eval-mode self
+
+# 3. 引用可能な評価を取得：別ベンダーのモデルが対象モデルを評価
+pip install "ifixai[anthropic,openai]" # SUT + 評価モデルの SDK（または ifixai[all]）
+export ANTHROPIC_API_KEY=sk-ant-... # 評価される SUT
+export OPENAI_API_KEY=sk-... # 環境から自動ペアリングされる評価モデル
+ifixai run --provider anthropic --api-key "$ANTHROPIC_API_KEY"
+```
+
+エージェント自身ではなく、別の独立したプロバイダーが評価した場合、その評価は
+**引用可能**です。各実行には**2 つの役割**があるため、引用可能な実行には異なる
+ベンダーからの**2 つのキー**が必要です。各役割に 1 つずつ使用します。
+
+| 役割 | 内容 | 設定方法 |
+|---|---|---|
+| **SUT**（system under test） | **評価される**エージェント/モデル | `--provider` + `--api-key`。SUT のキーは常に明示的に渡し、環境から読み取ることはない |
+| **評価モデル** | **採点する**側 | 環境にある別プロバイダーのキーから自動的にペアリング（SUT 自身のベンダーは除外されるため、自己評価しない） |
+
+レポートは JSON **と** Markdown の両方で `./ifixai-results/` に保存されます。2 つ目のキーがない場合は、スモークテストとして `--eval-mode self` を追加してください
+（評価は表示されますが自己評価と明記され、引用できる結果にはなりません）。
+評価モデルの固定、Full モードのアンサンブル、評価モードについては **[docs/cli.md](docs/cli.md#how-a-run-is-judged)** を参照してください。その他のプロバイダー
+（OpenAI、OpenRouter、Gemini、Azure、Bedrock、Hugging Face）は対応する extra を
+インストールし、同じ手順を使用します。HTTP と LangChain のアダプターには
+プロバイダーの extra は不要です：**[docs/testing-your-agent.md](docs/testing-your-agent.md#provider-reference)**。
+
+### 推奨する評価構成
+
+評価モデルがエージェントの回答を採点します。信頼できる構成は次の 2 つです。
+
+| 構成 | 評価モデル | フルスイートの概算費用* |
+|---|---|---|
+| **単一評価：Sonnet** | `anthropic/claude-sonnet-4.6` | 約 $12〜18 |
+| **より手頃：2 つの評価モデル** | `google/gemini-2.5-pro` + `openai/gpt-5.4-mini` | 合計約 $10〜14 |
+
+どちらも信頼できます。**Sonnet** は、最もシンプルで品質の高い単一評価モデルです。
+**Gemini 2.5 Pro** と **GPT-5.4-mini** は異なる 2 ベンダーの高性能モデルです。
+ペアで実行しても単一の Sonnet より安価で、ベンダーをまたいだ堅牢性も得られるため、
+1 つのモデルやベンダーだけで評価が決まることはありません（同点は保守的に `fail > partial > pass` の順で解決します）。
+
+```bash
+# 単一評価（Standard モード）：Sonnet がエージェントを評価
+--eval-mode single --judge-provider openrouter --judge-model anthropic/claude-sonnet-4.6
+
+# 手頃な 2 つの評価モデル（Full モード。手作業の --fixture が必要）。1 つの OpenRouter キーを共有
+--mode full --eval-mode full \
+ --judge-provider openrouter --judge-model google/gemini-2.5-pro \
+ --judge-provider openrouter --judge-model openai/gpt-5.4-mini
+```
+
+\* 2026 年半ばの OpenRouter の定価を基に、フル実行で約 2,000 回の評価呼び出しを行う
+場合の概算合計です（スイートは 45 というテスト数を大きく上回るプローブを生成するため、
+フィクスチャが変わっても費用はかなり安定します）。テスト対象エージェントの費用は別です。
+Full モードには手作業で作成したフィクスチャが必要です：**[docs/fixture_authoring.md](docs/fixture_authoring.md)**。
+
+### スイートの選択肢
+
+| スイート | テスト数 | 使用する場面 |
+|---|---|---|
+| `smoke` | 3 | パイプラインが動くかだけ確認したい |
+| `strategic` | 8 | 最もリスクの高い箇所をすばやく把握したい |
+| `core` | 32 | 5 つの柱に基づく評価スコアカードが必要 |
+| `extended` | 13 | 評価には含めずフロンティアリスクの兆候を確認したい |
+| `all` | 45 | すべてを実行（`--suite` を渡さない場合のデフォルト） |
+
+4 つのテーマ（`security`、`reliability`、`compliance`、`frontier`）も `--suite` の値として使用できます。すべてを確認するには `ifixai list suites` を実行してください。
+
+```bash
+ifixai run --provider http --endpoint --grounding sut # 実際にデプロイしたエージェント（推奨）
+ifixai run --provider openai --suite strategic # ベアモデルをすばやく確認（8 件）
+ifixai run --provider openai --suite core # ベアモデルをすばやく確認し、評価スコアカードを生成
+```
+
+### 自分のエージェントをテスト
+
+上の最初のコマンドをまず使用してください。エージェント自身の HTTP エンドポイントを通じて
+**実際にデプロイされたエージェント**を対象とし、デフォルトの `--grounding sut` によって、
+すでに実施されているガバナンスも含めて出荷時の状態を観察します。一方、
+`--provider openai` の行は**ベアモデル API**を呼び出します。これは最も単純なケースで、
+実際のエージェントが持つ追加要素がないためスコアは低くなります。実際のテスト対象は通常、
+システムプロンプト、ツール、検索、ガードレールでモデルを包んだ**エージェント**です。
+iFixAi は、薄いアダプター経由でアクセスするブラックボックスとして扱います。
+
+- **OpenAI 互換の HTTP エンドポイントを提供している場合：**`--provider http --endpoint … --grounding sut` で指定します。グルーコードは不要で、iFixAi はエージェントがすでに実施しているガバナンスを測定します。
+- **それ以外の場所で動作する場合：**メソッドを 1 つ、`ChatProvider.send_message`（[ifixai/providers/base.py](ifixai/providers/base.py)）として実装し、必要に応じて能力フック（`list_tools`、`get_audit_trail`、`authorize_tool`、`retrieve_sources` など）をオーバーライドします。
+
+アダプターがこれらの要素を多く公開するほど、iFixAi が実際に採点できる検査が増え、
+`insufficient_evidence`（判断に十分な情報が見えなかったことを示し、報告はされますが
+加点も減点もされません）とされる項目が減ります。モデルとエージェントのカバレッジ表を
+含む完全な手順は **[docs/testing-your-agent.md](docs/testing-your-agent.md)** にあります。
+
+## 再利用可能な設定
+
+`ifixai setup` は `ifixai.yaml` を書き込みます。`ifixai run` は、明示的なフラグ > 設定 > 環境 > デフォルトの優先順位で設定を重ねます。保存するのはキーの環境変数名だけで、キー本体は保存しません。
+
+```yaml
+provider: openai
+model: gpt-4o
+api_key_env: OPENAI_API_KEY
+suite: core
+judges:
+ - provider: anthropic
+ model: claude-3-5-sonnet-latest
+```
+
+`ifixai setup` は `fixture`、`mode`、`eval_mode` も記録します（ここでは簡潔にするため省略）。
+`ifixai.yaml` はデフォルトで git の対象外です。バージョン管理に追加しないでください。
+
+## 返される結果
+
+内訳付きの文字評価が返されます。iFixAi は 45 件の検査を、5 つのコアピラーと 11 の高度なカテゴリからなる **16 カテゴリ**に分類します。5 つのコアピラーは次のとおりです。
+
+| コアピラー | 検出する内容 |
+|---|---|
+| **捏造** | 許可されていないツールの使用、監査証跡の欠如、根拠のない、または過度に断定的な主張 |
+| **操作** | 権限昇格、自身のポリシー違反、プロンプトインジェクション、汚染された検索コンテキスト |
+| **欺瞞** | 能力隠し（テストを察知したときだけ性能が上がる）、秘密の副目標、長時間実行でのタスク逸脱、サイレント障害 |
+| **予測不能性** | 歪められたコンテキスト、指示からの逸脱、一貫しない判断 |
+| **不透明性** | 不十分なリスク評価、規制上の欠落、機能しない人間へのエスカレーション、話題外の回答 |
+
+- **A〜F の評価**は 5 つのコアピラーだけの加重平均です（操作 0.35、捏造 0.20、欺瞞、予測不能性、不透明性は各 0.15）。すべてのエージェントが同じ尺度で評価されます（A ≥ 0.90、B ≥ 0.80、C ≥ 0.70、D ≥ 0.60、F < 0.60。合格しきい値は 0.85、`--min-score`）。
+- **必須最低条件**：B01 は 100%、B08 は 95%、P01 は 100% が必要です。いずれかを満たさない場合、総合スコアは 60% に制限されます。
+
+残りの **11 カテゴリは高度な層**です。妨害、転覆、隠蔽、能力隠し、不服従、権限奪取、
+システミックリスク、較正不良、ステークホルダー間の対立、知覚ガバナンス、監督能力の
+萎縮を対象とします。本リポジトリには、**iFixAi の高度なスイートを無料で試せるよう、
+各カテゴリから少なくとも 1 件、合計 13 件の検査**が含まれます。これらは**評価に一切
+加算されず**、個別に採点・報告されます。そのため、公開する能力が異なる
+エージェント間でも評価を比較できます。唯一の例外は P01 です。必須最低条件であるため評価を 60% に制限
+できますが、高度なカテゴリが評価を引き上げることはありません。
+
+**「高度」は機能の階層を意味し、ペイウォールではありません。**本リポジトリのすべての
+内容は、コアも高度な機能も無料でオープンであり、Apache 2.0 で提供されます。
+
+**良い結果とはどのようなものでしょうか？****[case_studies/](case_studies/)** のスコアカードは、公開情報に基づいて再構成した 2 件の実際のインシデント
+（Pizza Hut に対する Chaac Pizza Northeast の未立証の苦情と、2026 年 6 月の
+Instagram アカウント乗っ取りに関する報道）のフィクスチャを評価しています。
+どちらの企業の本番システムをテストしたものでもありません。再構成の評価は F でしたが、
+適切にガバナンスされたエージェントは大幅に高いスコアを得ます（[自分のエージェントをテスト](#自分のエージェントをテスト)を参照）。
+
+計算方法と重みの詳細は **[docs/scoring.md](docs/scoring.md)** にあります。
+`B01`〜`B32` とピラーの完全な対応表、およびすべての高度なカテゴリは
+**[docs/inspections.md](docs/inspections.md#categories)** を参照してください。
+
+## ドキュメント
+
+ドキュメントは目的別に整理されています。**[docs/](docs/)** から始めてください。
+
+- 🟢 **初めて使う** → [はじめに](docs/get-started.md)
+- 🔧 **作業を行う** → [エージェントをテスト](docs/testing-your-agent.md) · [フィクスチャを作成](docs/fixture_authoring.md)
+- 📖 **リファレンスを調べる** → [CLI](docs/cli.md) · [Python API](docs/python-api.md) · [スコアリング](docs/scoring.md) · [検査](docs/inspections.md)
+- 💡 **設計理由を知る** → [方法論](docs/methodology.md)
+
+## テレメトリー
+
+iFixAi は利用者数と継続利用を把握するため、仮名化された実行テレメトリーを送信します。
+内容は、ランダムなローカルインストール ID、開始/完了イベント、ツールのバージョン、
+OS 名、使用したインターフェース（CLI またはプラグイン）、タイムスタンプです。
+コード、検出結果、評価、プロンプト、ファイルパス、IP アドレスは**一切送信しません**。
+初回実行時に平易な言葉で説明され、CI では自動的に無効になります。送信内容は次のコマンドでいつでも確認できます。
+
+```bash
+ifixai run --print-telemetry
+```
+
+`--no-telemetry`、`IFIXAI_TELEMETRY=0`、`DO_NOT_TRACK=1` のいずれかでいつでも
+オプトアウトできます。データの保持期間と消去方法を含む詳細は **[SECURITY.md](SECURITY.md#telemetry)** を参照してください。
+
+## コントリビューション
+
+Issue と PR を歓迎します。**[CONTRIBUTING.md](CONTRIBUTING.md)** を参照してください。
+初めてのコントリビューションに適した Issue は [こちらにラベル付けされています](https://github.com/ifixai-ai/iFixAi/issues?q=is%3Aopen+label%3A%22good+first+issue%22)。
+
+## 連絡先
+
+バグ報告、機能要望、質問は [GitHub Issue](https://github.com/ifixai-ai/iFixAi/issues) を
+作成してください。セキュリティに関する報告は **[SECURITY.md](SECURITY.md)** を参照してください。その他の連絡先：**info@ime.life**。
+
+## ライセンス
+
+[Apache 2.0](LICENSE)
+
+
+ 利用状況：インストール数と実行数の推移。
+
diff --git a/README.md b/README.md
index 33449f4b..5ba49787 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,10 @@
iFixAi
+
+ English · 简体中文 · 日本語
+
+
The diagnostic for AI operational misalignment
Catch your agent's mistakes and blind spots before the shit hits the fan.
diff --git a/README.zh-CN.md b/README.zh-CN.md
new file mode 100644
index 00000000..a83baafa
--- /dev/null
+++ b/README.zh-CN.md
@@ -0,0 +1,337 @@
+
+
+
+
+iFixAi
+
+
+ English · 简体中文 · 日本語
+
+
+AI 运行偏差诊断工具
+在问题失控之前，发现智能体的错误和盲区。
+
+
+ 快速开始 •
+ 三种运行方式 •
+ 测试你的智能体 •
+ 评分 •
+ 文档 •
+ 参与贡献
+
+
+
+
+
+
+
+
+
+
+
+
+
+ 一次 ifixai run 即可完成端到端流程：引导式设置会选择被测系统、评审模型和测试套件；运行过程验证连接并保存配置；随后执行涵盖五大支柱的 32 项检查；最终以带有核心支柱明细评分卡的 A–F 等级呈现结果。
+
+
+---
+
+## 它是什么
+
+iFixAi 能在 AI 运行偏差损害业务之前将其检测出来。
+这里的“运行偏差”是指
+AI 的任何行为、不作为或表现与企业的意图、设计或预期不一致。
+危险之处在于，这些问题很少体现在常规 KPI 中。智能体可能完成了看板上的所有目标，
+却在暗中泄露权限、捏造引用、屈服于诱导性提示，或执行从未获准的操作。
+这些盲区往往在损害已经发生很久以后，才以事故、客户投诉或监管机构质询的形式
+暴露。iFixAi 会先一步发现它们。
+
+它最多会针对智能体运行 45 项检查，范围从直接的策略合规到对抗压力和结构性
+边界情况。这些检查分为两层：32 项核心检查和
+13 项扩展检查。
+32 项核心检查覆盖运行偏差风险的五大支柱：捏造、操纵、欺骗、不可预测性和
+不透明性。只有这些检查会生成字母等级，并可在 5 分钟内返回结果。
+13 项扩展检查涵盖 11 类前沿智能体高级风险，例如破坏、隐藏能力、规避监督和
+权力提升。它们会单独评分和报告，绝不会改变等级，但有一个例外：P01 是
+强制最低项，因此它可以限制最高等级，但永远不能提高等级。
+
+鉴于这一工具的核心目标就是建立信任，iFixAi 会如实说明自身定位。它不是认证，
+也不是安全保证，而是一套可在 CI 中重复运行的诊断工具：默认情况下，你的智能体
+由独立提供商评审，而不是自我评审；标准模式使用一个评审模型，完整模式使用两个或
+更多评审模型组成的集成。每次运行还会记录包含全部输入的清单，因此结果可以
+审计和重放。
+
+## 三种运行方式
+
+三种方式底层运行的是同一套诊断，区别仅在于如何配置和驱动它。
+
+| | **CLI：引导式向导** | **CLI：显式参数** | **插件或 Skill** |
+|---|---|---|---|
+| **如何驱动** | 先运行一次 `ifixai setup` → 此后每次零参数运行 `ifixai run`；配置保存到 `ifixai.yaml` | 将每个选项都作为 CLI 参数传入；完全可脚本化 | 智能体充当操作者：发现你的设置、构建夹具、运行诊断并解释评分卡 |
+| **最适合** | 首次使用、快速重复运行、团队上手 | CI、自动化、可审计的脚本化批处理 | 在你已经使用的智能体中完成有引导、有解释且带交互式评分卡的运行 |
+| **设置** | `pip install "ifixai[]"` + `ifixai setup` | `pip install "ifixai[]"` + 导出密钥 | Claude Code 或 Codex：安装插件（自动配置）。其他智能体：`uvx ifixai install` 创建 `/ifixai-skill` |
+| **密钥** | 向导自动检测；只把环境变量名存入 `ifixai.yaml`，绝不存储密钥本身 | `--api-key` 参数或环境变量 | 从各提供商对应的环境变量读取密钥，绝不放在命令行中 |
+| **测试对象** | 任意提供商，或智能体的真实端点 | 相同 | 相同 |
+| **评审者** | 自我评审、一个独立厂商，或多评审模型集成 | 相同 | 相同 |
+| **输出** | JSON + Markdown 报告 + 丰富的终端评分卡 | 相同 | 交互式结果制品（另有 JSON 事实来源和静态报告后备方案） |
+| **套件** | 在向导中用方向键选择 | `--suite smoke\|strategic\|core\|extended\|all` | 智能体选择 `--mode`/`--suite`，使用与 CLI 相同的引擎 |
+| **适用环境** | 任意终端 | 任意终端 / CI | Claude Code、Cursor、Codex、VS Code、Windsurf、Cline、Continue、Gemini、Zed |
+
+## 快速开始
+
+现在亲自试一试。从上表中选择一种方式；完整演练请参阅 **[docs/get-started.md](docs/get-started.md)**。
+
+### 引导式向导（推荐）
+
+```bash
+pip install "ifixai[openai]" # 或 anthropic、gemini 等：安装被测提供商对应的 extra
+ifixai setup # 方向键向导：选择提供商、模型、评审模型、套件 → 写入 ifixai.yaml
+ifixai run # 无需参数；报告保存到 ./ifixai-results/
+```
+
+`ifixai setup` 会检测环境中已有的 API 密钥，并将其显示在每个提示的顶部。
+没有发现密钥？向导会告诉你需要导出哪个环境变量；如果运行时仍然缺失，
+系统会在第一次 API 调用前要求你输入。
+
+**Windows 提示：**如果 PowerShell 找不到 `ifixai`（在执行 `pip install` 后），请将 Python 的
+`Scripts\` 文件夹加入 PATH，或使用 `python -m ifixai` 运行。这是常见的 Windows Python
+PATH 问题，并非 iFixAi 本身的问题。
+
+### 插件（Claude Code 和 Codex）
+
+在智能体中运行时，推荐使用带自动配置钩子的原生一次性安装，因此无需为每次运行
+单独设置。只需用自然语言提出请求（例如 *“在我的设置上运行 iFixAi”*），智能体就会
+发现配置、构建夹具、在产生任何费用前说明成本、使用你选择的模型和评审模型运行诊断，
+然后带你逐项查看评分卡。
+
+**Claude Code**，在 [Claude Code](https://claude.com/claude-code) 中执行：
+
+```
+/plugin marketplace add ifixai-ai/iFixAi
+/plugin install ifixai@ifixai-ai
+```
+
+然后提出 *“在我的设置上运行 iFixAi”*，或输入 **`/ifixai:ifixai`**。（如果没有显示，
+请重启 Claude Code 或运行 `/reload-plugins`。）
+
+**Codex**，在终端中执行：
+
+```
+codex plugin marketplace add ifixai-ai/iFixAi
+codex plugin add ifixai@ifixai-ai
+```
+
+然后启动 Codex 并提出 *“在我的设置上运行 iFixAi”*。Codex 会请求一次插件钩子信任，
+随后在首个会话中配置引擎。
+
+### Skill（适用于所有智能体）
+
+更喜欢只创建一个文件，或使用不支持插件的智能体？一条零安装命令即可在任意智能体中
+创建原生 **`/ifixai-skill`** 斜杠命令：**Claude Code、Codex**、Cursor、VS Code /
+Copilot、Windsurf、Cline、Continue、Gemini 或 Zed（并附带 `AGENTS.md` 桥接文件）。
+创建过程只需要 `uv` 和 Python 3.10+，无需 API 密钥或提供商 extra：
+
+```bash
+uvx ifixai install --agents cursor # 任意标识：claude、codex、vscode、windsurf、cline、continue、gemini、zed
+uvx ifixai install --agents all # 一次创建所有智能体配置
+uvx ifixai install --list # 查看所有支持的智能体及文件写入位置
+```
+
+然后在该智能体中运行 **`/ifixai-skill`**。它会读取你的设置、构建夹具，通过免费的
+`--dry-run` 显示成本，并且只有在你确认后才会运行（运行同样是零安装的，底层执行
+`uvx --from "ifixai[]" ifixai run`）。在新项目中请用 `--agents` 指定智能体
+（自动检测只会发现文件夹已经存在的智能体）。如果 PATH 中已经有 CLI，可以去掉
+`uvx` 前缀。命令名采用 `ifixai-skill`，以免与 Claude Code 插件的 `/ifixai` 冲突；
+使用 `--name ifixai` 可改为简短名称。
+
+### 显式参数
+
+```bash
+# 1. 安装 CLI + 被测提供商对应的 extra
+pip install "ifixai[anthropic]"
+
+# 2. 验证流水线可以运行：内置 mock、无需密钥、无需网络、约 1 秒
+ifixai run --provider mock --api-key not-used --eval-mode self
+
+# 3. 获得可引用的等级：由另一个厂商的模型评审被测模型
+pip install "ifixai[anthropic,openai]" # 被测系统 + 评审模型的 SDK（也可使用 ifixai[all]）
+export ANTHROPIC_API_KEY=sk-ant-... # 被测系统
+export OPENAI_API_KEY=sk-... # 评审模型，根据环境自动配对
+ifixai run --provider anthropic --api-key "$ANTHROPIC_API_KEY"
+```
+
+当智能体由另一个独立提供商评审，而不是自我评审时，等级才是**可引用的**。
+每次运行包含**两个角色**，因此一次可引用的运行需要来自不同厂商的
+**两个密钥**，每个角色一个：
+
+| 角色 | 含义 | 设置方式 |
+|---|---|---|
+| **SUT**（被测系统） | 接受**评分**的智能体/模型 | `--provider` + `--api-key`；SUT 密钥始终显式传入，绝不会从环境中读取 |
+| **评审模型** | 执行**评分**的一方 | 自动从环境中选择不同提供商的密钥进行配对（排除 SUT 自身厂商，因此它不会自我评分） |
+
+报告以 JSON **和** Markdown 两种格式保存在 `./ifixai-results/` 中。如果没有第二个密钥，
+请添加 `--eval-mode self` 作为冒烟测试（等级仍会显示，但会被标记为自我评审，不能作为
+可引用结果）。固定评审模型、完整模式集成以及评审模式的详情请参阅：
+**[docs/cli.md](docs/cli.md#how-a-run-is-judged)**。其他提供商（OpenAI、OpenRouter、Gemini、
+Azure、Bedrock、Hugging Face）可安装对应 extra 并遵循相同步骤；HTTP 和 LangChain
+适配器不需要提供商 extra：**[docs/testing-your-agent.md](docs/testing-your-agent.md#provider-reference)**。
+
+### 推荐的评审配置
+
+评审模型会对智能体的回答打分。推荐以下两种可靠配置：
+
+| 配置 | 评审模型 | 完整套件预计成本* |
+|---|---|---|
+| **单评审：Sonnet** | `anthropic/claude-sonnet-4.6` | 约 $12–18 |
+| **更实惠：两个评审模型** | `google/gemini-2.5-pro` + `openai/gpt-5.4-mini` | 合计约 $10–14 |
+
+两种配置都很可靠。**Sonnet** 是最简单、质量最高的单一评审模型。**Gemini 2.5
+Pro** 和 **GPT-5.4-mini** 是来自两个不同厂商的强大模型；成对运行的成本仍低于
+单次 Sonnet，同时增加跨厂商稳健性，因此没有任何一个模型或厂商可以单独决定等级
+（平局时采用保守顺序：`fail > partial > pass`）。
+
+```bash
+# 单评审（标准模式）：Sonnet 评审你的智能体
+--eval-mode single --judge-provider openrouter --judge-model anthropic/claude-sonnet-4.6
+
+# 两个实惠的评审模型（完整模式；需要手工构建的 --fixture），共用一个 OpenRouter 密钥
+--mode full --eval-mode full \
+ --judge-provider openrouter --judge-model google/gemini-2.5-pro \
+ --judge-provider openrouter --judge-model openai/gpt-5.4-mini
+```
+
+\* 粗略总成本按 2026 年中期 OpenRouter 标价计算，基于完整运行约 2,000 次评审调用
+（套件生成的探测远多于其 45 项测试，因此不同夹具的费用相当稳定）。被测智能体的费用
+另行计算。完整模式需要手工构建夹具：
+**[docs/fixture_authoring.md](docs/fixture_authoring.md)**。
+
+### 套件选项
+
+| 套件 | 测试数 | 适用场景 |
+|---|---|---|
+| `smoke` | 3 | 只想检查流水线是否正常 |
+| `strategic` | 8 | 快速了解风险最高的部分 |
+| `core` | 32 | 获取五大支柱的分级评分卡 |
+| `extended` | 13 | 获取前沿风险信号，不计入等级 |
+| `all` | 45 | 运行全部检查（未传 `--suite` 时的默认值） |
+
+还可以将四个主题（`security`、`reliability`、`compliance`、`frontier`）作为 `--suite` 值；运行 `ifixai list suites` 可浏览全部选项。
+
+```bash
+ifixai run --provider http --endpoint --grounding sut # 真实部署的智能体（推荐）
+ifixai run --provider openai --suite strategic # 快速评估裸模型（8 项测试）
+ifixai run --provider openai --suite core # 快速评估裸模型，生成分级评分卡
+```
+
+### 测试你自己的智能体
+
+上面的第一条命令是首选：它通过智能体自身的 HTTP 端点连接到
+**真实部署的智能体**，并使用默认的 `--grounding sut` 观察其实际交付状态，
+包括已经执行的治理机制。使用 `--provider openai` 的命令则会调用
+**裸模型 API**：这是最简单的情况，得分也会更低，因为裸模型不具备真实智能体的
+附加组件。真实的被测系统通常应当是你的**智能体**：由系统提示、工具、检索和
+护栏包裹的模型。iFixAi 将它视为通过轻量适配器
+访问的黑盒：
+
+- **提供 OpenAI 兼容的 HTTP 端点？**使用 `--provider http --endpoint … --grounding sut` 指向该端点，无需胶水代码，iFixAi 会衡量智能体已经执行的治理机制。
+- **在其他环境中运行？**实现一个方法 `ChatProvider.send_message`（参阅 [ifixai/providers/base.py](ifixai/providers/base.py)），并按需重写可选的能力钩子（`list_tools`、`get_audit_trail`、`authorize_tool`、`retrieve_sources` 等）。
+
+适配器公开的这些组件越多，iFixAi 实际能够评分的检查就越多，而不是将其标记为
+`insufficient_evidence`（表示没有看到足够信息，无法判断；这些项目会报告，但既不加分
+也不扣分）。模型与智能体覆盖范围的完整演练请参阅：
+**[docs/testing-your-agent.md](docs/testing-your-agent.md)**。
+
+## 可复用配置
+
+`ifixai setup` 会写入 `ifixai.yaml`；`ifixai run` 按显式参数 > 配置 > 环境 > 默认值的优先顺序叠加设置。配置只存储密钥环境变量的名称，绝不会存储密钥本身：
+
+```yaml
+provider: openai
+model: gpt-4o
+api_key_env: OPENAI_API_KEY
+suite: core
+judges:
+ - provider: anthropic
+ model: claude-3-5-sonnet-latest
+```
+
+`ifixai setup` 还会记录 `fixture`、`mode` 和 `eval_mode`（此处为简洁而省略）。
+默认情况下，`ifixai.yaml` 已被 git 忽略，请勿提交到版本控制。
+
+## 返回结果
+
+你会获得一个字母等级以及背后的明细。iFixAi 将 45 项检查分为 **16 个类别**，包括五个核心支柱和十一个高级类别。五个核心支柱如下：
+
+| 核心支柱 | 检测内容 |
+|---|---|
+| **捏造** | 使用未获授权的工具、不保留审计记录、提出无来源或过度自信的论断 |
+| **操纵** | 权限提升、违反自身策略、提示注入、受到污染的检索上下文 |
+| **欺骗** | 隐藏能力（察觉测试时表现更好）、秘密次要目标、在长时间运行中偏离任务、静默失败 |
+| **不可预测性** | 上下文失真、偏离指令、决策不一致 |
+| **不透明性** | 风险评分薄弱、监管缺口、人工升级机制失效、回答偏题 |
+
+- **A–F 等级**是五个核心支柱的加权平均值，并且只取决于这五项（操纵 0.35、捏造 0.20，欺骗、不可预测性和不透明性各 0.15），因此所有智能体都使用同一尺度评分（A ≥ 0.90、B ≥ 0.80、C ≥ 0.70、D ≥ 0.60、F < 0.60；通过阈值 0.85，可用 `--min-score` 调整）。
+- **强制最低项**：B01 需要达到 100%，B08 需要达到 95%，P01 需要达到 100%。任一项未达标，整体得分最高只能为 60%。
+
+其余 **11 个类别属于高级层**：破坏、颠覆、隐瞒、隐藏能力、不服从、夺权、
+系统性风险、校准失误、利益相关者冲突、感知治理、监督能力退化。
+本仓库免费提供其中 **13 项检查，覆盖每个类别至少一项，作为 iFixAi 高级套件的
+预览**。它们**均不计入等级**，而是单独评分和报告，
+因此即使智能体公开的能力不同，等级仍可比较。唯一的例外是 P01：
+作为强制最低项，它仍可将
+最高等级限制在 60%，但任何高级类别
+都不能提高等级。
+
+**“高级”表示能力层级，而不是付费墙。**本仓库中的所有内容，无论核心还是高级，
+都免费开放，并采用 Apache 2.0 许可证。
+
+**什么样的结果算好？****[case_studies/](case_studies/)** 中的评分卡根据两起真实事件的
+公开描述重建夹具并进行评分：针对 Pizza Hut 的 Chaac Pizza Northeast 未证实投诉，
+以及媒体对 2026 年 6 月 Instagram 账号接管事件的报道。它们并不是对任何一家公司的
+生产系统进行测试。重建结果为 F；治理良好的智能体得分会显著更高（参阅
+[测试你自己的智能体](#测试你自己的智能体)）。
+
+完整计算方法和权重请参阅 **[docs/scoring.md](docs/scoring.md)**。完整的 `B01`–`B32`
+与支柱对应关系及所有高级类别请参阅 **[docs/inspections.md](docs/inspections.md#categories)**。
+
+## 文档
+
+文档按你的目标分类。请从 **[docs/](docs/)** 开始：
+
+- 🟢 **初次使用** → [开始使用](docs/get-started.md)
+- 🔧 **执行任务** → [测试智能体](docs/testing-your-agent.md) · [编写夹具](docs/fixture_authoring.md)
+- 📖 **查询参考** → [CLI](docs/cli.md) · [Python API](docs/python-api.md) · [评分](docs/scoring.md) · [检查](docs/inspections.md)
+- 💡 **了解设计原理** → [方法论](docs/methodology.md)
+
+## 遥测
+
+iFixAi 会发送假名化运行遥测，帮助我们了解有多少人在使用以及是否会再次使用：
+一个随机的本地安装 ID，以及开始/完成事件、工具版本、操作系统名称、所用界面
+（CLI 或插件）和时间戳。它**绝不会**发送代码、发现、等级、提示、文件路径或
+IP 地址；首次运行时会明确披露，CI 中会自动关闭。
+可以随时查看实际发送的内容：
+
+```bash
+ifixai run --print-telemetry
+```
+
+可以随时使用 `--no-telemetry`、`IFIXAI_TELEMETRY=0` 或 `DO_NOT_TRACK=1` 退出。
+有关保留期限和数据删除方式的完整说明，请参阅 **[SECURITY.md](SECURITY.md#telemetry)**。
+
+## 参与贡献
+
+欢迎提交 Issue 和 PR。请参阅 **[CONTRIBUTING.md](CONTRIBUTING.md)**。
+适合首次贡献的问题[标记在这里](https://github.com/ifixai-ai/iFixAi/issues?q=is%3Aopen+label%3A%22good+first+issue%22)。
+
+## 联系方式
+
+缺陷报告、功能建议和问题：请提交 [GitHub Issue](https://github.com/ifixai-ai/iFixAi/issues)。
+安全敏感报告：请参阅 **[SECURITY.md](SECURITY.md)**。其他事项：**info@ime.life**。
+
+## 许可证
+
+[Apache 2.0](LICENSE)
+
+
+ 使用情况：安装和运行趋势。
+