feat(ext): extending execute api

packages/website/src/pages/docs/Layout.tsx

@@ -36,7 +36,7 @@ export default function DocsLayout({ children }: DocsLayoutProps) {
 				{ title: t('nav.custom_tools'), path: '/features/custom-tools' },
 				{ title: t('nav.knowledge_injection'), path: '/features/custom-instructions' },
 				{ title: t('nav.data_masking'), path: '/features/data-masking' },
-				{ title: '🧪 ' + t('nav.chrome_extension'), path: '/features/chrome-extension' },
+				{ title: t('nav.chrome_extension'), path: '/features/chrome-extension' },
 			],
 		},
 		{

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

@@ -126,34 +126,46 @@ localStorage.setItem('PageAgentExtUserAuthToken', '<your-token-from-extension>')
 				<section>
 					<h2 className="text-2xl font-bold mb-4">{isZh ? 'API 参考' : 'API Reference'}</h2>
 
-					<h3 className="text-xl font-semibold mb-3">window.execute(task, llmConfig)</h3>
+					<h3 className="text-xl font-semibold mb-3">window.execute(task, llmConfig, hooks?)</h3>
 					<p className="text-gray-600 dark:text-gray-300 mb-4">
 						{isZh
-							? '使用 LLM 配置执行任务。返回一个 Promise，在任务完成时 resolve。'
-							: 'Execute a task with LLM configuration. Returns a Promise that resolves when the task completes.'}
+							? '使用 LLM 配置执行任务。返回一个 Promise，在任务完成时 resolve。可选的 hooks 参数用于监听任务执行过程中的事件。'
+							: 'Execute a task with LLM configuration. Returns a Promise that resolves when the task completes. Optional hooks parameter for listening to events during task execution.'}
 					</p>
 
 					<CodeEditor
 						code={
 							isZh
-								? `// 使用 LLM 配置执行任务
+								? `// 使用 LLM 配置和 hooks 执行任务
 const result = await window.execute(
 	'在 GitHub 上搜索 "page-agent" 并打开第一个结果',
 	{
 		baseURL: 'https://api.openai.com/v1',
 		apiKey: 'your-api-key',
 		model: 'gpt-5-2'
+	},
+	{
+		onStatusChange: status => console.log('状态变化:', status),
+		onActivity: activity => console.log('活动:', activity),
+		onHistoryUpdate: history => console.log('历史更新:', history),
+		onDispose: () => console.log('已停止')
 	}
 )
 
 console.log(result) // 任务执行结果`
-								: `// Execute a task with LLM configuration
+								: `// Execute a task with LLM configuration and hooks
 const result = await window.execute(
 	'Search for "page-agent" on GitHub and open the first result',
 	{
 		baseURL: 'https://api.openai.com/v1',
 		apiKey: 'your-api-key',
 		model: 'gpt-5-2'
+	},
+	{
+		onStatusChange: status => console.log('Status change:', status),
+		onActivity: activity => console.log('Activity:', activity),
+		onHistoryUpdate: history => console.log('History update:', history),
+		onDispose: () => console.log('Disposed')
 	}
 )
 
@@ -203,6 +215,49 @@ window.dispose()`
 					/>
 				</section>
 
+				{/* Execute Hooks */}
+				<section>
+					<h2 className="text-2xl font-bold mb-4">{isZh ? 'Execute Hooks' : 'Execute Hooks'}</h2>
+					<p className="text-gray-600 dark:text-gray-300 mb-4">
+						{isZh
+							? '通过 hooks 参数，你可以监听任务执行过程中的各种事件，实现实时更新 UI、日志记录等功能。'
+							: 'With hooks parameter, you can listen to various events during task execution for real-time UI updates, logging, and more.'}
+					</p>
+
+					<CodeEditor
+						code={
+							isZh
+								? `interface ExecuteHooks {
+	// Agent 状态变化时调用（idle, running, error, completed 等）
+	onStatusChange?: (status: AgentStatus) => void
+
+	// Agent 执行活动时调用（如点击、输入、导航等操作）
+	onActivity?: (activity: AgentActivity) => void
+
+	// 历史记录更新时调用（包含完整的事件历史）
+	onHistoryUpdate?: (history: HistoricalEvent[]) => void
+
+	// Agent 被停止时调用
+	onDispose?: () => void
+}`
+								: `interface ExecuteHooks {
+	// Called when agent status changes (idle, running, error, completed, etc.)
+	onStatusChange?: (status: AgentStatus) => void
+
+	// Called when agent performs an activity (click, input, navigation, etc.)
+	onActivity?: (activity: AgentActivity) => void
+
+	// Called when history is updated (contains full event history)
+	onHistoryUpdate?: (history: HistoricalEvent[]) => void
+
+	// Called when agent is disposed
+	onDispose?: () => void
+}`
+						}
+						language="typescript"
+					/>
+				</section>
+
 				{/* Security Notice */}
 				<section className="p-4 bg-yellow-50 dark:bg-yellow-900/20 rounded-lg">
 					<h3 className="text-lg font-semibold text-yellow-900 dark:text-yellow-300 mb-2">