From cef0c22f52a2e80694432e09ae8f77c815d666e2 Mon Sep 17 00:00:00 2001
From: Soulter <905617992@qq.com>
Date: Thu, 2 Oct 2025 14:20:52 +0800
Subject: [PATCH] feat: update prompt prefix handling to support placeholder
 replacement

---
 astrbot/core/config/default.py          | 6 ++++--
 packages/astrbot/process_llm_request.py | 6 +++++-
 2 files changed, 9 insertions(+), 3 deletions(-)

diff --git a/astrbot/core/config/default.py b/astrbot/core/config/default.py
index e1b25a92b..3b6be8662 100644
--- a/astrbot/core/config/default.py
+++ b/astrbot/core/config/default.py
@@ -64,7 +64,7 @@ DEFAULT_CONFIG = {
         "datetime_system_prompt": True,
         "default_personality": "default",
         "persona_pool": ["*"],
-        "prompt_prefix": "",
+        "prompt_prefix": "{{prompt}}",
         "max_context_length": -1,
         "dequeue_context_length": 1,
         "streaming_response": False,
@@ -2118,10 +2118,12 @@ CONFIG_METADATA_3 = {
                     "provider_settings.wake_prefix": {
                         "description": "LLM 聊天额外唤醒前缀 ",
                         "type": "string",
+                        "hint": "例子: 如果唤醒前缀为 `/`, 额外聊天唤醒前缀为 `chat`，则需要 `/chat` 才会触发 LLM 请求。默认为空。",
                     },
                     "provider_settings.prompt_prefix": {
-                        "description": "额外前缀提示词",
+                        "description": "用户提示词",
                         "type": "string",
+                        "hint": "可使用 {{prompt}} 作为用户输入的占位符。如果不输入占位符则代表添加在用户输入的前面。",
                     },
                     "provider_tts_settings.dual_output": {
                         "description": "开启 TTS 时同时输出语音和文字内容",
diff --git a/packages/astrbot/process_llm_request.py b/packages/astrbot/process_llm_request.py
index e1d7ab42b..2b785fd4d 100644
--- a/packages/astrbot/process_llm_request.py
+++ b/packages/astrbot/process_llm_request.py
@@ -106,7 +106,11 @@ class ProcessLLMRequest:
 
         # prompt prefix
         if prefix := cfg.get("prompt_prefix"):
-            req.prompt = prefix + req.prompt
+            # 支持 {{prompt}} 作为用户输入的占位符
+            if "{{prompt}}" in prefix:
+                req.prompt = prefix.replace("{{prompt}}", req.prompt)
+            else:
+                req.prompt = prefix + req.prompt
 
         # user identifier
         if cfg.get("identifier"):