From 31b0d6c02c0748b0f6dc7be2f2991781f65f44ca Mon Sep 17 00:00:00 2001
From: echoVic <137844255@qq.com>
Date: Fri, 18 Sep 2026 18:04:03 +0800
Subject: [PATCH] docs: add Pilion Browser integration section

---
 README.en.md | 4 ++++
 README.md    | 4 ++++
 2 files changed, 8 insertions(+)

diff --git a/README.en.md b/README.en.md
index bde7f7343..7dcd9a9b6 100644
--- a/README.en.md
+++ b/README.en.md
@@ -71,6 +71,10 @@ blade --headless --output-format jsonl "analyze this repo"
 
 On first launch, a setup wizard guides you: **Pick Provider → Select Model → Enter API Key**.
 
+### Use Blade from Pilion Browser
+
+[Pilion Browser](https://github.com/echoVic/pilion-browser) is a desktop browser that works as an ACP client. Choose **Blade** in its Agent panel: Pilion launches `blade --acp` and exposes its own tabs to Blade as MCP tools (`browser_snapshot`, `browser_screenshot`, navigate, click, type) with approval-before-action and human takeover; Blade keeps using the credentials in `~/.blade/auth.json`. Installers for macOS, Windows and Linux are on the [Pilion releases page](https://github.com/echoVic/pilion-browser/releases).
+
 ---
 
 ## ⚙️ Configuration
diff --git a/README.md b/README.md
index d84048938..5790297d9 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,10 @@ blade --headless --output-format jsonl "分析这个仓库"
 
 首次启动会自动进入模型配置向导：**选择 Provider → 选择模型 → 输入 API Key**。
 
+### 在 Pilion Browser 中使用
+
+[Pilion Browser](https://github.com/echoVic/pilion-browser) 是一个作为 ACP 客户端的桌面浏览器。在它的 Agent 面板中选择 **Blade**，Pilion 会以 `blade --acp` 启动 Blade，并把自己的标签页作为 MCP 工具（`browser_snapshot`、`browser_screenshot`、导航、点击、输入）交给 Blade 操作，支持操作前确认和人工接管；Blade 继续使用 `~/.blade/auth.json` 中的凭证。安装包见 [Pilion Releases](https://github.com/echoVic/pilion-browser/releases)。
+
 ---
 
 ## ⚙️ 配置