From efe1f3314443ceec75789f3a0f0df02d120fd7dd Mon Sep 17 00:00:00 2001
From: Simon <10131203+gaomeng1900@users.noreply.github.com>
Date: Thu, 22 Jan 2026 17:21:10 +0800
Subject: [PATCH] feat: add custom system prompt configuration

---
 packages/core/src/PageAgentCore.ts | 4 ++++
 packages/core/src/config/index.ts  | 6 ++++++
 2 files changed, 10 insertions(+)

diff --git a/packages/core/src/PageAgentCore.ts b/packages/core/src/PageAgentCore.ts
index 2077544..583da8f 100644
--- a/packages/core/src/PageAgentCore.ts
+++ b/packages/core/src/PageAgentCore.ts
@@ -413,6 +413,10 @@ export class PageAgentCore extends EventTarget {
 	 * Get system prompt, dynamically replace language settings based on configured language
 	 */
 	#getSystemPrompt(): string {
+		if (this.config.customSystemPrompt) {
+			return this.config.customSystemPrompt
+		}
+
 		let systemPrompt = SYSTEM_PROMPT
 
 		const targetLanguage = this.config.language === 'zh-CN' ? '中文' : 'English'
diff --git a/packages/core/src/config/index.ts b/packages/core/src/config/index.ts
index 9c75267..9db66b1 100644
--- a/packages/core/src/config/index.ts
+++ b/packages/core/src/config/index.ts
@@ -141,6 +141,12 @@ export interface AgentConfig {
 	 * }
 	 */
 	transformPageContent?: (content: string) => Promise<string> | string
+
+	/**
+	 * Completely override the default system prompt.
+	 * @experimental Use with caution - incorrect prompts may break agent behavior.
+	 */
+	customSystemPrompt?: string
 }
 
 export type PageAgentConfig = LLMConfig & AgentConfig & PageControllerConfig