@yivan-lab/pretty-please 1.2.0 → 1.3.1

package/dist/src/mastra-agent.js

@@ -1,26 +1,18 @@
 import { Agent } from '@mastra/core';
 import { getConfig } from './config.js';
-import { buildCommandSystemPrompt } from './prompts.js';
-import { formatSystemInfo } from './sysinfo.js';
-import { formatHistoryForAI } from './history.js';
-import { formatShellHistoryForAI, getShellHistory } from './shell-hook.js';
+import { SHELL_COMMAND_SYSTEM_PROMPT } from './prompts.js';
 /**
  * 创建 Mastra Shell Agent
  * 根据用户配置的 API Key、Base URL、Provider 和 Model
+ * 使用静态的 System Prompt（不包含动态数据）
  */
 export function createShellAgent() {
     const config = getConfig();
     // 组合 provider/model 格式（Mastra 要求）
     const modelId = `${config.provider}/${config.model}`;
-    // 构建系统提示词
-    const sysinfo = formatSystemInfo();
-    const plsHistory = formatHistoryForAI();
-    const shellHistory = formatShellHistoryForAI();
-    const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
-    const systemPrompt = buildCommandSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
     return new Agent({
         name: 'shell-commander',
-        instructions: systemPrompt,
+        instructions: SHELL_COMMAND_SYSTEM_PROMPT,
         model: {
             url: config.baseUrl,
             id: modelId,

package/dist/src/mastra-chat.d.ts

@@ -1,14 +1,21 @@
 import { Agent } from '@mastra/core';
 /**
- * 创建 Mastra Chat Agent
+ * 创建 Mastra Chat Agent（使用静态系统提示词）
  */
 export declare function createChatAgent(): Agent<"chat-assistant", Record<string, import("@mastra/core").ToolAction<any, any, any, any, import("@mastra/core").ToolExecutionContext<any, any, any>>>, Record<string, import("@mastra/core").Metric>>;
-/**
- * 获取完整的系统提示词（用于调试）
- */
-export declare function getChatSystemPrompt(): string;
 /**
  * 使用 Mastra 进行 AI 对话（支持流式输出）
+ *
+ * 消息结构：
+ * [
+ *   "历史问题1",                          // user (纯粹的问题)
+ *   "历史回答1",                          // assistant
+ *   "历史问题2",                          // user
+ *   "历史回答2",                          // assistant
+ *   "<system_info>...\n                  // user (最新消息，包含完整上下文)
+ *    <command_history>...\n
+ *    <user_question>最新问题</user_question>"
+ * ]
  */
 export declare function chatWithMastra(prompt: string, options?: {
     debug?: boolean;
@@ -23,6 +30,6 @@ export declare function chatWithMastra(prompt: string, options?: {
             role: string;
             content: string;
         }>;
-        userPrompt: string;
+        userContext: string;
     };
 }>;

package/dist/src/mastra-chat.js

@@ -1,26 +1,20 @@
 import { Agent } from '@mastra/core';
 import { getConfig } from './config.js';
-import { buildChatSystemPrompt } from './prompts.js';
+import { CHAT_SYSTEM_PROMPT, buildChatUserContext } from './prompts.js';
 import { formatSystemInfo } from './sysinfo.js';
 import { formatHistoryForAI } from './history.js';
 import { formatShellHistoryForAI, getShellHistory } from './shell-hook.js';
 import { getChatHistory, addChatMessage } from './chat-history.js';
 /**
- * 创建 Mastra Chat Agent
+ * 创建 Mastra Chat Agent（使用静态系统提示词）
  */
 export function createChatAgent() {
     const config = getConfig();
     // 组合 provider/model 格式（Mastra 要求）
     const modelId = `${config.provider}/${config.model}`;
-    // 构建系统提示词
-    const sysinfo = formatSystemInfo();
-    const plsHistory = formatHistoryForAI();
-    const shellHistory = formatShellHistoryForAI();
-    const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
-    const systemPrompt = buildChatSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
     return new Agent({
         name: 'chat-assistant',
-        instructions: systemPrompt,
+        instructions: CHAT_SYSTEM_PROMPT, // 只包含静态规则
         model: {
             url: config.baseUrl,
             id: modelId,
@@ -28,36 +22,42 @@ export function createChatAgent() {
         },
     });
 }
-/**
- * 获取完整的系统提示词（用于调试）
- */
-export function getChatSystemPrompt() {
-    const config = getConfig();
-    const sysinfo = formatSystemInfo();
-    const plsHistory = formatHistoryForAI();
-    const shellHistory = formatShellHistoryForAI();
-    const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
-    return buildChatSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
-}
 /**
  * 使用 Mastra 进行 AI 对话（支持流式输出）
+ *
+ * 消息结构：
+ * [
+ *   "历史问题1",                          // user (纯粹的问题)
+ *   "历史回答1",                          // assistant
+ *   "历史问题2",                          // user
+ *   "历史回答2",                          // assistant
+ *   "<system_info>...\n                  // user (最新消息，包含完整上下文)
+ *    <command_history>...\n
+ *    <user_question>最新问题</user_question>"
+ * ]
  */
 export async function chatWithMastra(prompt, options = {}) {
     const config = getConfig();
     const agent = createChatAgent();
-    // 获取对话历史
+    // 1. 获取历史对话（纯粹的问答）
     const chatHistory = getChatHistory();
-    // 构建消息数组（将历史和新消息合并）
+    // 2. 构建消息数组
     const messages = [];
-    // 添加历史对话
+    // 加载历史对话
     for (const msg of chatHistory) {
         messages.push(msg.content);
     }
-    // 添加当前用户消息
-    messages.push(prompt);
+    // 3. 构建最新消息（动态上下文 + 用户问题）
+    const sysinfo = formatSystemInfo();
+    const plsHistory = formatHistoryForAI();
+    const shellHistory = formatShellHistoryForAI();
+    const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
+    const latestUserContext = buildChatUserContext(prompt, sysinfo, plsHistory, shellHistory, shellHookEnabled);
+    messages.push(latestUserContext);
+    // 4. 发送给 AI（流式或非流式）
     let fullContent = '';
-    // 流式输出模式
     if (options.onChunk) {
+        // 流式输出模式
         const stream = await agent.stream(messages);
         for await (const chunk of stream.textStream) {
             if (chunk) {
@@ -74,18 +74,18 @@ export async function chatWithMastra(prompt, options = {}) {
     if (!fullContent) {
         throw new Error('AI 返回了空的响应');
     }
-    // 保存对话历史
+    // 5. 保存对话历史（只保存纯粹的问题和回答，不保存 XML）
     addChatMessage(prompt, fullContent);
-    // 返回结果
+    // 6. 返回结果
     if (options.debug) {
         return {
             reply: fullContent,
             debug: {
-                sysinfo: formatSystemInfo(),
+                sysinfo,
                 model: config.model,
-                systemPrompt: getChatSystemPrompt(),
+                systemPrompt: CHAT_SYSTEM_PROMPT,
                 chatHistory,
-                userPrompt: prompt,
+                userContext: latestUserContext,
             },
         };
     }

package/dist/src/multi-step.d.ts

@@ -38,11 +38,11 @@ export interface RemoteContext {
     shellHistory: RemoteShellHistoryItem[];
 }
 /**
- * 生成系统上下文信息（供 Mastra 使用）
+ * 获取静态 System Prompt（供 Mastra 使用）
  */
 export declare function getFullSystemPrompt(): string;
 /**
- * 生成远程系统上下文信息
+ * 获取静态 System Prompt（远程执行也使用相同的 System Prompt）
  */
 export declare function getRemoteFullSystemPrompt(remoteContext: RemoteContext): string;
 /**

package/dist/src/multi-step.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { createShellAgent } from './mastra-agent.js';
-import { buildCommandSystemPrompt } from './prompts.js';
+import { SHELL_COMMAND_SYSTEM_PROMPT, buildUserContextPrompt } from './prompts.js';
 import { formatSystemInfo } from './sysinfo.js';
 import { formatHistoryForAI } from './history.js';
 import { formatShellHistoryForAI, getShellHistory } from './shell-hook.js';
@@ -18,50 +18,44 @@ export const CommandStepSchema = z.object({
     nextStepHint: z.string().optional().default(''),
 });
 /**
- * 生成系统上下文信息（供 Mastra 使用）
+ * 获取静态 System Prompt（供 Mastra 使用）
  */
 export function getFullSystemPrompt() {
-    const config = getConfig();
-    const sysinfo = formatSystemInfo();
-    const plsHistory = formatHistoryForAI();
-    const shellHistory = formatShellHistoryForAI();
-    const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
-    return buildCommandSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
+    return SHELL_COMMAND_SYSTEM_PROMPT;
 }
 /**
- * 生成远程系统上下文信息
+ * 获取静态 System Prompt（远程执行也使用相同的 System Prompt）
  */
 export function getRemoteFullSystemPrompt(remoteContext) {
-    // 格式化远程系统信息
-    const sysinfo = formatRemoteSysInfoForAI(remoteContext.name, remoteContext.sysInfo);
-    // 格式化远程 pls 命令历史
-    const plsHistory = formatRemoteHistoryForAI(remoteContext.name);
-    // 格式化远程 shell 历史
-    const shellHistory = formatRemoteShellHistoryForAI(remoteContext.shellHistory);
-    const shellHookEnabled = remoteContext.shellHistory.length > 0;
-    return buildCommandSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
+    return SHELL_COMMAND_SYSTEM_PROMPT;
 }
 /**
  * 使用 Mastra 生成多步骤命令
  */
 export async function generateMultiStepCommand(userPrompt, previousSteps = [], options = {}) {
     const agent = createShellAgent();
-    // 根据是否有远程上下文选择不同的系统提示词
-    const fullSystemPrompt = options.remoteContext
-        ? getRemoteFullSystemPrompt(options.remoteContext)
-        : getFullSystemPrompt();
-    // 构建消息数组（string[] 格式）
-    const messages = [userPrompt];
-    // 添加之前步骤的执行结果
-    previousSteps.forEach((step) => {
-        messages.push(JSON.stringify({
-            command: step.command,
-            continue: step.continue,
-            reasoning: step.reasoning,
-            nextStepHint: step.nextStepHint,
-        }));
-        messages.push(`命令已执行\n退出码: ${step.exitCode}\n输出:\n${step.output.slice(0, 500)}`);
-    });
+    // 准备动态数据
+    let sysinfoStr = '';
+    let historyStr = '';
+    if (options.remoteContext) {
+        // 远程执行：格式化远程系统信息和历史
+        sysinfoStr = formatRemoteSysInfoForAI(options.remoteContext.name, options.remoteContext.sysInfo);
+        const plsHistory = formatRemoteHistoryForAI(options.remoteContext.name);
+        const shellHistory = formatRemoteShellHistoryForAI(options.remoteContext.shellHistory);
+        historyStr = options.remoteContext.shellHistory.length > 0 ? shellHistory : plsHistory;
+    }
+    else {
+        // 本地执行：格式化本地系统信息和历史
+        sysinfoStr = formatSystemInfo();
+        const config = getConfig();
+        const plsHistory = formatHistoryForAI();
+        const shellHistory = formatShellHistoryForAI();
+        historyStr = (config.shellHook && getShellHistory().length > 0) ? shellHistory : plsHistory;
+    }
+    // 构建包含所有动态数据的 User Prompt（XML 格式）
+    const userContextPrompt = buildUserContextPrompt(userPrompt, sysinfoStr, historyStr, previousSteps);
+    // 只发送一条 User Message
+    const messages = [userContextPrompt];
     // 调用 Mastra Agent 生成结构化输出
     const response = await agent.generate(messages, {
         structuredOutput: {
@@ -75,14 +69,16 @@ export async function generateMultiStepCommand(userPrompt, previousSteps = [], o
         return {
             stepData,
             debugInfo: {
-                fullPrompt: fullSystemPrompt,
-                userPrompt,
+                systemPrompt: SHELL_COMMAND_SYSTEM_PROMPT,
+                userPrompt: userContextPrompt,
                 previousStepsCount: previousSteps.length,
                 response: stepData,
-                remoteContext: options.remoteContext ? {
-                    name: options.remoteContext.name,
-                    sysInfo: options.remoteContext.sysInfo,
-                } : undefined,
+                remoteContext: options.remoteContext
+                    ? {
+                        name: options.remoteContext.name,
+                        sysInfo: options.remoteContext.sysInfo,
+                    }
+                    : undefined,
             },
         };
     }

package/dist/src/prompts.d.ts

@@ -2,10 +2,36 @@
  * 统一管理所有 AI 系统提示词
  */
 /**
- * 构建命令生成模式的系统提示词
+ * ============================================================
+ * 命令生成模式的静态 System Prompt
+ * ============================================================
+ * 包含所有核心规则、输出格式定义、判断标准、错误处理策略和示例
+ * 不包含任何动态数据（系统信息、历史记录等）
  */
-export declare function buildCommandSystemPrompt(sysinfo: string, plsHistory: string, shellHistory: string, shellHookEnabled: boolean): string;
+export declare const SHELL_COMMAND_SYSTEM_PROMPT = "\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 shell \u811A\u672C\u751F\u6210\u5668\u3002\n\u4F60\u5C06\u63A5\u6536\u5230\u5305\u542B XML \u6807\u7B7E\u7684\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF0C\u7136\u540E\u6839\u636E\u7528\u6237\u9700\u6C42\u751F\u6210\u53EF\u6267\u884C\u7684 shell \u547D\u4EE4\u3002\n\n### \uD83D\uDCCB \u8F93\u5165\u6570\u636E\u683C\u5F0F\u8BF4\u660E\n\u4F60\u4F1A\u6536\u5230\u4EE5\u4E0B XML \u6807\u7B7E\u5305\u88F9\u7684\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF1A\n- <system_info>\uFF1A\u7528\u6237\u7684\u64CD\u4F5C\u7CFB\u7EDF\u3001Shell \u7C7B\u578B\u3001\u5F53\u524D\u76EE\u5F55\u3001\u5305\u7BA1\u7406\u5668\u7B49\u73AF\u5883\u4FE1\u606F\n- <command_history>\uFF1A\u7528\u6237\u6700\u8FD1\u6267\u884C\u7684\u547D\u4EE4\u5386\u53F2\uFF08\u7528\u4E8E\u7406\u89E3\u4E0A\u4E0B\u6587\u5F15\u7528\uFF0C\u5982\"\u521A\u624D\u7684\u6587\u4EF6\"\u3001\"\u4E0A\u4E00\u4E2A\u547D\u4EE4\"\uFF09\n- <execution_log>\uFF1A**\u591A\u6B65\u9AA4\u4EFB\u52A1\u7684\u5173\u952E\u4FE1\u606F**\uFF0C\u8BB0\u5F55\u4E86\u4E4B\u524D\u6B65\u9AA4\u7684\u547D\u4EE4\u3001\u9000\u51FA\u7801\u548C\u8F93\u51FA\u7ED3\u679C\n  - \u5982\u679C\u5B58\u5728\u6B64\u6807\u7B7E\uFF0C\u8BF4\u660E\u8FD9\u662F\u4E00\u4E2A\u591A\u6B65\u9AA4\u4EFB\u52A1\n  - \u5FC5\u987B\u68C0\u67E5\u6BCF\u4E2A <step> \u4E2D\u7684 <exit_code>\uFF0C0=\u6210\u529F\uFF0C\u975E0=\u5931\u8D25\n  - \u6839\u636E <output> \u7684\u5185\u5BB9\u51B3\u5B9A\u4E0B\u4E00\u6B65\u64CD\u4F5C\n- <user_request>\uFF1A\u7528\u6237\u7684\u539F\u59CB\u81EA\u7136\u8BED\u8A00\u9700\u6C42\n\n### \u26A0\uFE0F \u91CD\u8981\u89C4\u5219\n1. \u8FD4\u56DE JSON \u683C\u5F0F\uFF0Ccommand \u5B57\u6BB5\u5FC5\u987B\u662F\u53EF\u76F4\u63A5\u6267\u884C\u7684\u547D\u4EE4\uFF08\u65E0\u89E3\u91CA\u3001\u65E0\u6CE8\u91CA\u3001\u65E0 markdown\uFF09\n2. \u4E0D\u8981\u6DFB\u52A0 shebang\uFF08\u5982 #!/bin/bash\uFF09\n3. command \u53EF\u4EE5\u5305\u542B\u591A\u6761\u547D\u4EE4\uFF08\u7528 && \u8FDE\u63A5\uFF09\uFF0C\u4F46\u6574\u4F53\u7B97\u4E00\u4E2A\u547D\u4EE4\n4. \u6839\u636E <system_info> \u4E2D\u7684\u4FE1\u606F\u9009\u62E9\u5408\u9002\u7684\u547D\u4EE4\uFF08\u5982\u5305\u7BA1\u7406\u5668\uFF09\n5. \u5982\u679C\u7528\u6237\u5F15\u7528\u4E86\u4E4B\u524D\u7684\u64CD\u4F5C\uFF08\u5982\"\u521A\u624D\u7684\"\u3001\"\u4E0A\u4E00\u4E2A\"\uFF09\uFF0C\u8BF7\u53C2\u8003 <command_history>\n6. \u7EDD\u5BF9\u4E0D\u8981\u8F93\u51FA pls \u6216 please \u547D\u4EE4\uFF01\n\n### \uD83D\uDCE4 \u8F93\u51FA\u683C\u5F0F - \u975E\u5E38\u91CD\u8981\n\n**\u5355\u6B65\u6A21\u5F0F\uFF08\u4E00\u4E2A\u547D\u4EE4\u5B8C\u6210\uFF09\uFF1A**\n\u5982\u679C\u4EFB\u52A1\u53EA\u9700\u8981\u4E00\u4E2A\u547D\u4EE4\u5C31\u80FD\u5B8C\u6210\uFF0C\u53EA\u8FD4\u56DE\uFF1A\n{\n  \"command\": \"ls -la\"\n}\n\n**\u591A\u6B65\u6A21\u5F0F\uFF08\u9700\u8981\u591A\u4E2A\u547D\u4EE4\uFF0C\u540E\u7EED\u4F9D\u8D56\u524D\u9762\u7684\u7ED3\u679C\uFF09\uFF1A**\n\u5982\u679C\u4EFB\u52A1\u9700\u8981\u591A\u4E2A\u547D\u4EE4\uFF0C\u4E14\u540E\u7EED\u547D\u4EE4\u5FC5\u987B\u6839\u636E\u524D\u9762\u7684\u6267\u884C\u7ED3\u679C\u6765\u51B3\u5B9A\uFF0C\u5219\u8FD4\u56DE\uFF1A\n\n\u3010\u591A\u6B65\u9AA4\u5B8C\u6574\u793A\u4F8B\u3011\n\u7528\u6237\uFF1A\"\u67E5\u627E\u5927\u4E8E100MB\u7684\u65E5\u5FD7\u6587\u4EF6\u5E76\u538B\u7F29\"\n\n\u7B2C\u4E00\u6B65\u4F60\u8FD4\u56DE\uFF1A\n{\n  \"command\": \"find . -name '*.log' -size +100M\",\n  \"continue\": true,\n  \"reasoning\": \"\u5148\u67E5\u627E\u7B26\u5408\u6761\u4EF6\u7684\u65E5\u5FD7\u6587\u4EF6\",\n  \"nextStepHint\": \"\u6839\u636E\u67E5\u627E\u7ED3\u679C\u538B\u7F29\u6587\u4EF6\"\n}\n\n\u6267\u884C\u540E\u4F60\u4F1A\u6536\u5230\uFF08\u5728 <execution_log> \u4E2D\uFF09\uFF1A\n<execution_log>\n<step index=\"1\">\n<command>find . -name '*.log' -size +100M</command>\n<exit_code>0</exit_code>\n<output>\n./app.log\n./system.log\n</output>\n</step>\n</execution_log>\n\n\u7136\u540E\u4F60\u8FD4\u56DE\u7B2C\u4E8C\u6B65\uFF1A\n{\n  \"command\": \"tar -czf logs.tar.gz ./app.log ./system.log\",\n  \"continue\": false,\n  \"reasoning\": \"\u538B\u7F29\u627E\u5230\u7684\u65E5\u5FD7\u6587\u4EF6\"\n}\n\n### \uD83C\uDFAF \u5173\u952E\u5224\u65AD\u6807\u51C6\n- **\u591A\u6B65** = \u540E\u7EED\u547D\u4EE4\u4F9D\u8D56\u524D\u9762\u7684\u8F93\u51FA\uFF08\u5982\u5148 find \u770B\u6709\u54EA\u4E9B\uFF0C\u518D\u6839\u636E\u7ED3\u679C\u64CD\u4F5C\u5177\u4F53\u6587\u4EF6\uFF09\n- **\u5355\u6B65** = \u4E00\u4E2A\u547D\u4EE4\u5C31\u80FD\u5B8C\u6210\uFF08\u5373\u4F7F\u547D\u4EE4\u91CC\u6709 && \u8FDE\u63A5\u591A\u6761\uFF0C\u4E5F\u7B97\u4E00\u4E2A\u547D\u4EE4\uFF09\n\n### \uD83D\uDCDA \u5E38\u89C1\u573A\u666F\u4E3E\u4F8B\n- \"\u5220\u9664\u7A7A\u6587\u4EF6\u5939\" \u2192 \u5355\u6B65\uFF1A`find . -empty -delete` \uFF08\u4E00\u4E2A\u547D\u4EE4\u5B8C\u6210\uFF09\n- \"\u67E5\u627E\u5927\u6587\u4EF6\u5E76\u538B\u7F29\" \u2192 \u591A\u6B65\uFF1A\u5148 find \u770B\u6709\u54EA\u4E9B\uFF0C\u518D tar \u538B\u7F29\u5177\u4F53\u6587\u4EF6\n- \"\u5B89\u88C5 git\" \u2192 \u5355\u6B65\uFF1A`brew install git` \u6216 `apt-get install git`\n- \"\u5907\u4EFD\u5E76\u5220\u9664\u65E7\u65E5\u5FD7\" \u2192 \u591A\u6B65\uFF1A\u5148 `mkdir backup`\uFF0C\u518D `mv` \u6587\u4EF6\u5230 backup\n- \"\u67E5\u770B\u76EE\u5F55\" \u2192 \u5355\u6B65\uFF1A`ls -la`\n- \"\u67E5\u770B\u78C1\u76D8\u4F7F\u7528\u60C5\u51B5\u5E76\u6392\u5E8F\" \u2192 \u5355\u6B65\uFF1A`df -h | sort -k5 -rh` \uFF08\u4E00\u4E2A\u7BA1\u9053\u547D\u4EE4\uFF09\n- \"\u67E5\u770B\u8FDB\u7A0B\u5E76\u6740\u6B7B\u67D0\u4E2A\u8FDB\u7A0B\" \u2192 \u591A\u6B65\uFF1A\u5148 `ps aux | grep xxx` \u770B PID\uFF0C\u518D `kill` \u5177\u4F53 PID\n\n**\u4E25\u683C\u8981\u6C42**\uFF1A\u5355\u6B65\u6A21\u5F0F\u53EA\u8FD4\u56DE {\"command\": \"xxx\"}\uFF0C\u7EDD\u5BF9\u4E0D\u8981\u8F93\u51FA continue/reasoning/nextStepHint\uFF01\n\n### \uD83D\uDD27 \u9519\u8BEF\u5904\u7406\u7B56\u7565\n\n**\u5F53 <execution_log> \u4E2D\u6700\u540E\u4E00\u6B65\u7684 <exit_code> \u4E0D\u4E3A 0 \u65F6\uFF1A**\n\n1. **\u5206\u6790\u9519\u8BEF\u539F\u56E0**\uFF1A\u4ED4\u7EC6\u9605\u8BFB <output> \u4E2D\u7684\u9519\u8BEF\u4FE1\u606F\n2. **\u8C03\u6574\u547D\u4EE4\u7B56\u7565**\uFF1A\u751F\u6210\u4FEE\u6B63\u540E\u7684\u547D\u4EE4\n3. **\u51B3\u5B9A\u662F\u5426\u7EE7\u7EED**\uFF1A\n   - \u8BBE\u7F6E `continue: true` \u91CD\u8BD5\u4FEE\u6B63\u540E\u7684\u547D\u4EE4\n   - \u8BBE\u7F6E `continue: false` \u653E\u5F03\u4EFB\u52A1\n\n**\u9519\u8BEF\u5904\u7406\u793A\u4F8B 1\uFF1A\u6743\u9650\u9519\u8BEF**\n<execution_log>\n<step index=\"1\">\n<command>mkdir /var/log/myapp</command>\n<exit_code>1</exit_code>\n<output>mkdir: cannot create directory '/var/log/myapp': Permission denied</output>\n</step>\n</execution_log>\n\n\u4F60\u5206\u6790\u540E\u8FD4\u56DE\u4FEE\u6B63\uFF1A\n{\n  \"command\": \"sudo mkdir /var/log/myapp\",\n  \"continue\": true,\n  \"reasoning\": \"\u6743\u9650\u4E0D\u8DB3\uFF0C\u4F7F\u7528 sudo \u91CD\u8BD5\"\n}\n\n**\u9519\u8BEF\u5904\u7406\u793A\u4F8B 2\uFF1A\u6587\u4EF6\u4E0D\u5B58\u5728**\n<execution_log>\n<step index=\"1\">\n<command>mv test.zip backup/</command>\n<exit_code>1</exit_code>\n<output>mv: cannot stat 'test.zip': No such file or directory</output>\n</step>\n</execution_log>\n\n\u4F60\u5206\u6790\u540E\u51B3\u5B9A\u653E\u5F03\uFF1A\n{\n  \"command\": \"\",\n  \"continue\": false,\n  \"reasoning\": \"\u6E90\u6587\u4EF6 test.zip \u4E0D\u5B58\u5728\uFF0C\u65E0\u6CD5\u79FB\u52A8\uFF0C\u4EFB\u52A1\u65E0\u6CD5\u7EE7\u7EED\"\n}\n\n**\u9519\u8BEF\u5904\u7406\u793A\u4F8B 3\uFF1A\u547D\u4EE4\u4E0D\u5B58\u5728\uFF0C\u5C1D\u8BD5\u5B89\u88C5**\n<execution_log>\n<step index=\"1\">\n<command>docker ps</command>\n<exit_code>127</exit_code>\n<output>bash: docker: command not found</output>\n</step>\n</execution_log>\n\n\u4F60\u6839\u636E <system_info> \u4E2D\u7684\u5305\u7BA1\u7406\u5668\u8FD4\u56DE\uFF1A\n{\n  \"command\": \"brew install docker\",\n  \"continue\": true,\n  \"reasoning\": \"docker \u672A\u5B89\u88C5\uFF0C\u6839\u636E\u7CFB\u7EDF\u5305\u7BA1\u7406\u5668\u5B89\u88C5\"\n}\n\n**\u9519\u8BEF\u5904\u7406\u793A\u4F8B 4\uFF1A\u7F51\u7EDC\u9519\u8BEF**\n<execution_log>\n<step index=\"1\">\n<command>ping -c 3 example.com</command>\n<exit_code>2</exit_code>\n<output>ping: example.com: Name or service not known</output>\n</step>\n</execution_log>\n\n\u4F60\u5206\u6790\u540E\u8FD4\u56DE\uFF1A\n{\n  \"command\": \"\",\n  \"continue\": false,\n  \"reasoning\": \"\u7F51\u7EDC\u4E0D\u53EF\u8FBE\u6216 DNS \u89E3\u6790\u5931\u8D25\uFF0C\u65E0\u6CD5\u7EE7\u7EED\"\n}\n\n### \uD83D\uDED1 \u4F55\u65F6\u5E94\u8BE5\u653E\u5F03\uFF08continue: false\uFF09\n- \u7528\u6237\u8F93\u5165\u7684\u8DEF\u5F84\u4E0D\u5B58\u5728\u4E14\u65E0\u6CD5\u63A8\u6D4B\n- \u9700\u8981\u7684\u5DE5\u5177\u672A\u5B89\u88C5\u4E14\u65E0\u6CD5\u81EA\u52A8\u5B89\u88C5\uFF08\u5982\u975E root \u7528\u6237\u65E0\u6CD5 apt install\uFF09\n- \u6743\u9650\u95EE\u9898\u4E14\u65E0\u6CD5\u7528 sudo \u89E3\u51B3\uFF08\u5982 SELinux \u9650\u5236\uFF09\n- \u7F51\u7EDC\u4E0D\u53EF\u8FBE\u6216 DNS \u89E3\u6790\u5931\u8D25\n- \u91CD\u8BD5 2 \u6B21\u540E\u4ECD\u7136\u5931\u8D25\n- \u4EFB\u52A1\u672C\u8EAB\u4E0D\u5408\u7406\uFF08\u5982\"\u5220\u9664\u6839\u76EE\u5F55\"\uFF09\n\n**\u653E\u5F03\u65F6\u7684\u8981\u6C42**\uFF1A\n- `command` \u5B57\u6BB5\u53EF\u4EE5\u7559\u7A7A\uFF08\"\"\uFF09\n- `continue` \u5FC5\u987B\u4E3A false\n- `reasoning` \u5FC5\u987B\u8BE6\u7EC6\u8BF4\u660E\u4E3A\u4EC0\u4E48\u653E\u5F03\uFF0C\u4EE5\u53CA\u5C1D\u8BD5\u4E86\u4EC0\u4E48\n\n### \uD83D\uDCCC \u5173\u4E8E pls/please \u5DE5\u5177\n\u7528\u6237\u6B63\u5728\u4F7F\u7528 pls\uFF08pretty-please\uFF09\u5DE5\u5177\uFF0C\u8FD9\u662F\u4E00\u4E2A\u5C06\u81EA\u7136\u8BED\u8A00\u8F6C\u6362\u4E3A shell \u547D\u4EE4\u7684 AI \u52A9\u624B\u3002\n\u5F53\u7528\u6237\u8F93\u5165 \"pls <\u63CF\u8FF0>\" \u65F6\uFF0CAI\uFF08\u4E5F\u5C31\u662F\u4F60\uFF09\u4F1A\u751F\u6210\u5BF9\u5E94\u7684 shell \u547D\u4EE4\u4F9B\u7528\u6237\u786E\u8BA4\u6267\u884C\u3002\n<command_history> \u4E2D\u6807\u8BB0\u4E3A [pls] \u7684\u6761\u76EE\u8868\u793A\u7528\u6237\u901A\u8FC7 pls \u5DE5\u5177\u6267\u884C\u7684\u547D\u4EE4\u3002\n";
 /**
- * 构建 Chat 对话模式的系统提示词
+ * ============================================================
+ * 构建动态 User Prompt（XML 格式）
+ * ============================================================
+ * 将系统信息、历史记录、执行日志等动态数据组装成 XML 结构
  */
-export declare function buildChatSystemPrompt(sysinfo: string, plsHistory: string, shellHistory: string, shellHookEnabled: boolean): string;
+export declare function buildUserContextPrompt(userRequest: string, sysInfoStr: string, historyStr: string, executedSteps: Array<{
+    command: string;
+    exitCode: number;
+    output: string;
+}>): string;
+/**
+ * ============================================================
+ * Chat 对话模式的静态 System Prompt
+ * ============================================================
+ * 包含所有核心规则和能力描述，不包含动态数据
+ */
+export declare const CHAT_SYSTEM_PROMPT = "\u4F60\u662F\u4E00\u4E2A\u547D\u4EE4\u884C\u4E13\u5BB6\u52A9\u624B\uFF0C\u5E2E\u52A9\u7528\u6237\u7406\u89E3\u548C\u4F7F\u7528\u547D\u4EE4\u884C\u5DE5\u5177\u3002\n\n### \uD83D\uDCCB \u8F93\u5165\u6570\u636E\u683C\u5F0F\u8BF4\u660E\n\u4F60\u4F1A\u6536\u5230\u4EE5\u4E0B XML \u6807\u7B7E\u5305\u88F9\u7684\u4E0A\u4E0B\u6587\u4FE1\u606F\uFF1A\n- <system_info>\uFF1A\u7528\u6237\u7684\u64CD\u4F5C\u7CFB\u7EDF\u3001Shell \u7C7B\u578B\u3001\u5F53\u524D\u76EE\u5F55\u7B49\u73AF\u5883\u4FE1\u606F\n- <command_history>\uFF1A\u7528\u6237\u6700\u8FD1\u901A\u8FC7 pls \u6267\u884C\u7684\u547D\u4EE4\uFF08\u7528\u4E8E\u7406\u89E3\u4E0A\u4E0B\u6587\u5F15\u7528\uFF09\n- <shell_history>\uFF1A\u7528\u6237\u6700\u8FD1\u5728\u7EC8\u7AEF\u6267\u884C\u7684\u6240\u6709\u547D\u4EE4\uFF08\u5982\u679C\u542F\u7528\u4E86 Shell Hook\uFF09\n- <user_question>\uFF1A\u7528\u6237\u7684\u5177\u4F53\u95EE\u9898\n\n### \uD83C\uDFAF \u4F60\u7684\u80FD\u529B\n- \u89E3\u91CA\u547D\u4EE4\u7684\u542B\u4E49\u3001\u53C2\u6570\u3001\u7528\u6CD5\n- \u5206\u6790\u547D\u4EE4\u7684\u6267\u884C\u6548\u679C\u548C\u6F5C\u5728\u98CE\u9669\n- \u56DE\u7B54\u547D\u4EE4\u884C\u3001Shell\u3001\u7CFB\u7EDF\u7BA1\u7406\u76F8\u5173\u95EE\u9898\n- \u6839\u636E\u7528\u6237\u9700\u6C42\u63A8\u8350\u5408\u9002\u7684\u547D\u4EE4\u5E76\u89E3\u91CA\n\n### \uD83D\uDCDD \u56DE\u7B54\u8981\u6C42\n- \u7B80\u6D01\u6E05\u6670\uFF0C\u907F\u514D\u5197\u4F59\u89E3\u91CA\n- \u5371\u9669\u64CD\u4F5C\u8981\u660E\u786E\u8B66\u544A\uFF08\u5982 rm -rf\u3001chmod 777 \u7B49\uFF09\n- \u9002\u5F53\u7ED9\u51FA\u793A\u4F8B\u547D\u4EE4\uFF08\u4F7F\u7528\u4EE3\u7801\u5757\u683C\u5F0F\uFF09\n- \u7ED3\u5408 <system_info> \u4E2D\u7684\u7CFB\u7EDF\u73AF\u5883\u7ED9\u51FA\u9488\u5BF9\u6027\u5EFA\u8BAE\n- \u5982\u679C\u7528\u6237\u5F15\u7528\u4E86\"\u521A\u624D\u7684\u547D\u4EE4\"\u3001\"\u4E0A\u4E00\u4E2A\u64CD\u4F5C\"\uFF0C\u8BF7\u53C2\u8003\u5386\u53F2\u8BB0\u5F55\n\n### \uD83D\uDCCC \u5173\u4E8E pls/please \u5DE5\u5177\n\u7528\u6237\u6B63\u5728\u4F7F\u7528 pls\uFF08pretty-please\uFF09\u5DE5\u5177\uFF0C\u8FD9\u662F\u4E00\u4E2A\u5C06\u81EA\u7136\u8BED\u8A00\u8F6C\u6362\u4E3A shell \u547D\u4EE4\u7684 AI \u52A9\u624B\u3002\n<command_history> \u4E2D\u6807\u8BB0\u4E3A [pls] \u7684\u6761\u76EE\u8868\u793A\u7528\u6237\u901A\u8FC7 pls \u5DE5\u5177\u6267\u884C\u7684\u547D\u4EE4\u3002\n\u4F60\u53EF\u4EE5\u89E3\u91CA\u8FD9\u4E9B\u547D\u4EE4\uFF0C\u5E2E\u52A9\u7528\u6237\u7406\u89E3\u5B83\u4EEC\u7684\u4F5C\u7528\u3002";
+/**
+ * ============================================================
+ * 构建 Chat 动态 User Context（XML 格式）
+ * ============================================================
+ * 将系统信息、历史记录等动态数据组装成 XML 结构
+ * 这个上下文会作为最新一条 user 消息发送给 AI
+ */
+export declare function buildChatUserContext(userQuestion: string, sysInfoStr: string, plsHistory: string, shellHistory: string, shellHookEnabled: boolean): string;