From e0b0e9eb8ac3326381b2d6bd8c296ee76f1777f6 Mon Sep 17 00:00:00 2001
From: czj <13261895355@163.com>
Date: Wed, 1 Jul 2026 15:12:48 +0800
Subject: [PATCH] =?UTF-8?q?=E8=A1=A5=E5=85=85=E6=A0=B7=E4=BE=8B=E6=96=87?=
 =?UTF-8?q?=E7=AB=A0=E9=AA=8C=E6=94=B6=E6=B5=8B=E8=AF=95=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 31 +++++++++++++++++++++++++++++++
 1 file changed, 31 insertions(+)

diff --git a/README.md b/README.md
index 6de479b..9d86afc 100644
--- a/README.md
+++ b/README.md
@@ -82,6 +82,37 @@ npm run build
 npx playwright test
 ```
 
+## Sample Article E2E
+
+Run the live sample-article browser workflow:
+
+```bash
+npm run test:e2e:samples
+```
+
+The runner reads `.env.local`, starts an isolated local Next.js server, loads
+`samples/articles/*.json`, opens the web UI with Playwright, runs each sample
+through the one-click optimization flow, validates authenticated exports, and
+writes a report under:
+
+```text
+test-results/geo-sample-flow/<timestamp>/
+```
+
+Useful options:
+
+```bash
+npm run test:e2e:samples -- --limit 1
+npm run test:e2e:samples -- --sample title-quality
+npm run test:e2e:samples -- --headed
+npm run test:e2e:samples -- --reuse-server --base-url http://localhost:3000
+```
+
+This workflow uses the real configured LLM provider by default. It requires
+`API_ACCESS_KEY` and the provider API key in `.env.local` or the shell
+environment. Reports and exports are written to `test-results/`, which is
+ignored by Git.
+
 ## Cloudflare Workers Deployment
 
 Cloudflare deployment is manual. Pushing to Git does not deploy or hot-update