feat: AK optional

packages/website/src/constants.ts

@@ -7,4 +7,4 @@ export const CDN_DEMO_CN_URL =
 // Demo LLM for website testing (homepage quick trial uses flash)
 export const DEMO_MODEL = 'qwen3.5-flash'
 export const DEMO_BASE_URL = 'https://page-ag-testing-ohftxirgbn.cn-shanghai.fcapp.run'
-export const DEMO_API_KEY = 'NA'
+// export const DEMO_API_KEY = ''

packages/website/src/pages/docs/advanced/page-agent-core/page.tsx

@@ -129,12 +129,6 @@ const result = await agent.execute('Fill in the form with test data')`}
 								? 'LLM API 的基础 URL（如 https://api.openai.com/v1）'
 								: 'Base URL of the LLM API (e.g., https://api.openai.com/v1)',
 						},
-						{
-							name: 'apiKey',
-							type: 'string',
-							required: true,
-							description: isZh ? 'API 密钥' : 'API key for authentication',
-						},
 						{
 							name: 'model',
 							type: 'string',
@@ -143,6 +137,12 @@ const result = await agent.execute('Fill in the form with test data')`}
 								? '模型名称（如 gpt-5.2, anthropic/claude-4.5-haiku）'
 								: 'Model name (e.g., gpt-5.2, anthropic/claude-4.5-haiku)',
 						},
+						{
+							name: 'apiKey',
+							type: 'string',
+							required: false,
+							description: 'LLM AK',
+						},
 						{
 							name: 'temperature',
 							type: 'number',

packages/website/src/pages/docs/features/chrome-extension/page.tsx

@@ -187,39 +187,7 @@ localStorage.setItem('PageAgentExtUserAuthToken', '<your-token-from-extension>')
 					</p>
 
 					<CodeEditor
-						code={
-							isZh
-								? `import type {
-	AgentActivity,
-	AgentStatus,
-	ExecutionResult,
-	HistoricalEvent
-} from '@page-agent/core'
-
-interface ExecuteConfig {
-	baseURL: string   // LLM API 端点
-	apiKey: string    // API 密钥
-	model: string     // 模型名称
-
-	includeInitialTab?: boolean
-	onStatusChange?: (status: AgentStatus) => void
-	onActivity?: (activity: AgentActivity) => void
-	onHistoryUpdate?: (history: HistoricalEvent[]) => void
-}
-
-type Execute = (task: string, config: ExecuteConfig) => Promise<ExecutionResult>
-
-declare global {
-	interface Window {
-		PAGE_AGENT_EXT_VERSION?: string
-		PAGE_AGENT_EXT?: {
-			version: string
-			execute: Execute
-			stop: () => void
-		}
-	}
-}`
-								: `import type {
+						code={`import type {
 	AgentActivity,
 	AgentStatus,
 	ExecutionResult,
@@ -228,8 +196,8 @@ declare global {
 
 interface ExecuteConfig {
 	baseURL: string   // LLM API endpoint
-	apiKey: string    // API key
 	model: string     // Model name
+	apiKey?: string   // LLM AK
 
 	includeInitialTab?: boolean
 	onStatusChange?: (status: AgentStatus) => void
@@ -248,8 +216,7 @@ declare global {
 			stop: () => void
 		}
 	}
-}`
-						}
+}`}
 						language="typescript"
 					/>
 

packages/website/src/pages/docs/features/models/page.tsx

@@ -129,10 +129,9 @@ const pageAgent = new PageAgent({
   model: 'MiniMax-M2.7'
 });
 
-// Self-hosted models (e.g., Ollama)
+// Self-hosted models (e.g., Ollama) — no apiKey needed
 const pageAgent = new PageAgent({
   baseURL: 'http://localhost:11434/v1',
-  apiKey: 'NA',
   model: 'qwen3:14b'
 });
 
@@ -280,7 +279,6 @@ LLM_MODEL_NAME="qwen3:14b"`}
 				<CodeEditor
 					code={`const agent = new PageAgent({
   baseURL: '/api/llm-proxy',
-  apiKey: 'NA',
   model: 'gpt-5.1',
   customFetch: (url, init) =>
     fetch(url, { ...init, credentials: 'include' }),

packages/website/src/pages/home/HeroSection.tsx

@@ -10,7 +10,7 @@ import { Particles } from '../../components/ui/particles'
 import {
 	CDN_DEMO_CN_URL,
 	CDN_DEMO_URL,
-	DEMO_API_KEY,
+	// DEMO_API_KEY,
 	DEMO_BASE_URL,
 	DEMO_MODEL,
 } from '../../constants'
@@ -94,7 +94,7 @@ export default function HeroSection() {
 				apiKey:
 					import.meta.env.DEV && import.meta.env.LLM_API_KEY
 						? import.meta.env.LLM_API_KEY
-						: DEMO_API_KEY,
+						: undefined,
 			})
 		}