docs: add SETUP.md for agent self-configuration and fix README prompts

- Add SETUP.md: step-by-step guide for AI agents to auto-configure pilot
- Fix README prompts: send to chat (not paste to CLAUDE.md)
- Fix English README: use English prompt instead of Chinese
- Remove skill-specific references, keep CLI-only usage guide

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: 2234839

README.md

@@ -53,13 +53,14 @@ npm install -D vite-plugin-pilot
 
 ### Option 1: Vite Plugin Mode
 
-Send the following to your AI agent (paste into Claude Code `CLAUDE.md` or Cursor `.cursorrules`):
+Copy the following and **send it to your AI agent in the chat**:
 
 ```
-Read https://raw.githubusercontent.com/2234839/vite-plugin-pilot/master/SKILL.md,
-follow its instructions to install vite-plugin-pilot and configure yourself, then start testing browser pages.
+Read https://raw.githubusercontent.com/2234839/vite-plugin-pilot/master/SETUP.md and follow its steps to configure vite-plugin-pilot for my project, including installing the plugin, configuring vite.config.ts, and writing the usage guide into the project instruction file.
 ```
 
+The agent will automatically install the plugin, configure options, and write the usage guide into your project's instruction file.
+
 ### Option 2: Standalone Server Mode (No Vite Required)
 
 ```bash

README_zh.md

@@ -48,13 +48,14 @@ npm install -D vite-plugin-pilot
 
 ### 方式一：Vite 插件模式
 
-把以下内容发送给你的 AI Agent（粘贴到 Claude Code 的 `CLAUDE.md` 或 Cursor 的 `.cursorrules`）：
+复制以下内容，**粘贴到 AI Agent 的对话框中发送**：
 
 ```
-请阅读 https://raw.githubusercontent.com/2234839/vite-plugin-pilot/master/SKILL.md ，
-按照其中的指示安装 vite-plugin-pilot 并配置自己，然后开始测试浏览器页面。
+请阅读 https://raw.githubusercontent.com/2234839/vite-plugin-pilot/master/SETUP.md ，按照其中的步骤为我配置 vite-plugin-pilot，包括安装插件、配置 vite.config.ts、将使用指南写入项目指令文件。
 ```
 
+Agent 会自动完成安装、配置，并将使用指南写入项目的 AI 指令文件。
+
 ### 方式二：独立 Server 模式（不依赖 Vite）
 
 ```bash

SETUP.md

@@ -0,0 +1,58 @@
+# vite-plugin-pilot — 自动配置指南
+
+你是 AI Agent（Claude Code、Cursor、Windsurf、Cline 等），请按照以下步骤为用户项目配置 vite-plugin-pilot。
+
+## 步骤 1：安装插件
+
+检查项目是否已安装 vite-plugin-pilot：
+- 检查 `package.json` 的 `devDependencies` 是否包含 `vite-plugin-pilot`
+- 如果没有，执行 `pnpm add -D vite-plugin-pilot`（或 `npm install -D vite-plugin-pilot`）
+
+检查 Vite 配置是否已包含插件：
+- 检查 `vite.config.ts`（或 `vite.config.js`）的 `plugins` 数组是否包含 `pilot()`
+- 如果没有，在文件顶部添加 `import pilot from 'vite-plugin-pilot'`，并在 plugins 数组中添加 `pilot()`
+- 如果已有 `pilot({...})` 配置，不要覆盖已有字段
+
+## 步骤 2：配置插件选项
+
+**语言环境**：分析项目语言环境（UI 文本、README 语言、i18n 配置等），在 vite.config.ts 中追加 `locale` 字段：
+- 中文项目：`pilot({ locale: 'zh' })`
+- 英文项目：`pilot({ locale: 'en' })`
+- 默认 `zh`，已有配置时只追加字段不覆盖
+
+**更新检查**：默认开启 CLI 自动检查 npm 新版本。如用户选择关闭，追加 `checkUpdate: false`。
+
+## 步骤 3：确保 .gitignore 包含 .pilot
+
+检查项目根目录的 `.gitignore` 是否包含 `.pilot`（运行时数据目录，不应提交），如果没有则添加。
+
+## 步骤 4：将使用指南写入项目指令文件
+
+**这是最关键的一步**：在你自己的项目指令文件中追加 pilot 使用指南，让未来的会话自动获得浏览器测试能力。
+
+例如 Claude Code 写入 `CLAUDE.md`，Cursor 写入 `.cursorrules`，其他 agent 写入对应的指令文件。
+
+读取文件现有内容，在末尾追加以下内容（不要覆盖已有内容）：
+
+````markdown
+## 浏览器测试（vite-plugin-pilot）
+
+使用 vite-plugin-pilot 操控浏览器页面进行测试。已安装并配置。
+
+- `npx pilot run '代码'` — 执行 JS 并获取结果+日志+页面快照
+- `npx pilot page` — 查看页面状态
+- `npx pilot status` — 查看已连接的实例
+
+详见 https://raw.githubusercontent.com/2234839/vite-plugin-pilot/master/SKILL.md
+````
+
+**重要**：不要删除或覆盖文件中的已有内容，只追加。
+
+## 步骤 5：启动 dev server 并验证
+
+1. 启动 dev server（`pnpm dev` 或 `npm run dev`）
+2. 在浏览器中打开页面
+3. 执行 `npx pilot status` 确认浏览器已连接
+4. 执行 `npx pilot page` 确认能看到页面快照
+
+全部完成后告诉用户：配置完成，现在可以通过 `/pilot` 或 `npx pilot` 命令测试浏览器页面了。

package.json

@@ -1,6 +1,6 @@
 {
   "name": "vite-plugin-pilot",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "AI Agent 驾驶浏览器的导航工具 — 打通 浏览器运行时 → Dev Server → 源码 → IDE 的完整链路",
   "type": "module",
   "bin": {