@yivan-lab/pretty-please 1.0.0 → 1.1.0

package/dist/src/config.js

@@ -3,18 +3,37 @@ import path from 'path';
 import os from 'os';
 import readline from 'readline';
 import chalk from 'chalk';
-const CONFIG_DIR = path.join(os.homedir(), '.please');
+// 配置文件路径
+export const CONFIG_DIR = path.join(os.homedir(), '.please');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+// 支持的 Provider 列表
+const VALID_PROVIDERS = [
+    'openai',
+    'anthropic',
+    'deepseek',
+    'google',
+    'groq',
+    'mistral',
+    'cohere',
+    'fireworks',
+    'together',
+];
+// 编辑模式
+const VALID_EDIT_MODES = ['manual', 'auto'];
+/**
+ * 默认配置
+ */
 const DEFAULT_CONFIG = {
     apiKey: '',
     baseUrl: 'https://api.openai.com/v1',
     model: 'gpt-4-turbo',
-    provider: 'openai', // Mastra provider: openai, anthropic, deepseek, google, groq, mistral, cohere 等
-    shellHook: false, // 是否启用 shell hook 记录终端命令
-    chatHistoryLimit: 10 // chat 对话历史保留轮数
+    provider: 'openai',
+    shellHook: false,
+    chatHistoryLimit: 10,
+    commandHistoryLimit: 10,
+    shellHistoryLimit: 15,
+    editMode: 'manual',
 };
-// 导出配置目录路径
-export { CONFIG_DIR };
 /**
  * 确保配置目录存在
  */
@@ -56,25 +75,31 @@ export function setConfigValue(key, value) {
     }
     // 处理特殊类型
     if (key === 'shellHook') {
-        config[key] = value === 'true' || value === true;
+        config.shellHook = value === 'true' || value === true;
     }
-    else if (key === 'chatHistoryLimit') {
-        const num = parseInt(value, 10);
+    else if (key === 'chatHistoryLimit' || key === 'commandHistoryLimit' || key === 'shellHistoryLimit') {
+        const num = typeof value === 'number' ? value : parseInt(String(value), 10);
         if (isNaN(num) || num < 1) {
-            throw new Error('chatHistoryLimit 必须是大于 0 的整数');
+            throw new Error(`${key} 必须是大于 0 的整数`);
         }
         config[key] = num;
     }
     else if (key === 'provider') {
-        // 验证 provider 值
-        const validProviders = ['openai', 'anthropic', 'deepseek', 'google', 'groq', 'mistral', 'cohere', 'fireworks', 'together'];
-        if (!validProviders.includes(value)) {
-            throw new Error(`provider 必须是以下之一: ${validProviders.join(', ')}`);
+        const strValue = String(value);
+        if (!VALID_PROVIDERS.includes(strValue)) {
+            throw new Error(`provider 必须是以下之一: ${VALID_PROVIDERS.join(', ')}`);
         }
-        config[key] = value;
+        config.provider = strValue;
     }
-    else {
-        config[key] = value;
+    else if (key === 'editMode') {
+        const strValue = String(value);
+        if (!VALID_EDIT_MODES.includes(strValue)) {
+            throw new Error(`editMode 必须是以下之一: ${VALID_EDIT_MODES.join(', ')}`);
+        }
+        config.editMode = strValue;
+    }
+    else if (key === 'apiKey' || key === 'baseUrl' || key === 'model') {
+        config[key] = String(value);
     }
     saveConfig(config);
     return config;
@@ -84,7 +109,7 @@ export function setConfigValue(key, value) {
  */
 export function isConfigValid() {
     const config = getConfig();
-    return config.apiKey && config.apiKey.length > 0;
+    return config.apiKey.length > 0;
 }
 /**
  * 隐藏 API Key 中间部分
@@ -100,14 +125,17 @@ export function maskApiKey(apiKey) {
 export function displayConfig() {
     const config = getConfig();
     console.log(chalk.bold('\n当前配置:'));
-    console.log(chalk.gray('━'.repeat(40)));
-    console.log(`  ${chalk.cyan('apiKey')}:           ${maskApiKey(config.apiKey)}`);
-    console.log(`  ${chalk.cyan('baseUrl')}:          ${config.baseUrl}`);
-    console.log(`  ${chalk.cyan('provider')}:         ${config.provider}`);
-    console.log(`  ${chalk.cyan('model')}:            ${config.model}`);
-    console.log(`  ${chalk.cyan('shellHook')}:        ${config.shellHook ? chalk.green('已启用') : chalk.gray('未启用')}`);
-    console.log(`  ${chalk.cyan('chatHistoryLimit')}: ${config.chatHistoryLimit} 轮`);
-    console.log(chalk.gray('━'.repeat(40)));
+    console.log(chalk.gray('━'.repeat(50)));
+    console.log(`  ${chalk.cyan('apiKey')}:              ${maskApiKey(config.apiKey)}`);
+    console.log(`  ${chalk.cyan('baseUrl')}:             ${config.baseUrl}`);
+    console.log(`  ${chalk.cyan('provider')}:            ${config.provider}`);
+    console.log(`  ${chalk.cyan('model')}:               ${config.model}`);
+    console.log(`  ${chalk.cyan('shellHook')}:           ${config.shellHook ? chalk.green('已启用') : chalk.gray('未启用')}`);
+    console.log(`  ${chalk.cyan('editMode')}:            ${config.editMode === 'auto' ? chalk.hex('#00D9FF')('auto (自动编辑)') : chalk.gray('manual (按E编辑)')}`);
+    console.log(`  ${chalk.cyan('chatHistoryLimit')}:    ${config.chatHistoryLimit} 轮`);
+    console.log(`  ${chalk.cyan('commandHistoryLimit')}: ${config.commandHistoryLimit} 条`);
+    console.log(`  ${chalk.cyan('shellHistoryLimit')}:   ${config.shellHistoryLimit} 条`);
+    console.log(chalk.gray('━'.repeat(50)));
     console.log(chalk.gray(`配置文件: ${CONFIG_FILE}\n`));
 }
 /**
@@ -116,7 +144,7 @@ export function displayConfig() {
 function createReadlineInterface() {
     return readline.createInterface({
         input: process.stdin,
-        output: process.stdout
+        output: process.stdout,
     });
 }
 /**
@@ -140,13 +168,12 @@ export async function runConfigWizard() {
     console.log(chalk.gray('直接回车使用默认值，输入值后回车确认\n'));
     try {
         // 1. Provider
-        const validProviders = ['openai', 'anthropic', 'deepseek', 'google', 'groq', 'mistral', 'cohere', 'fireworks', 'together'];
-        const providerHint = chalk.gray(`(可选: ${validProviders.join(', ')})`);
+        const providerHint = chalk.gray(`(可选: ${VALID_PROVIDERS.join(', ')})`);
         const providerPrompt = `${chalk.cyan('Provider')} ${providerHint}\n${chalk.gray('默认:')} ${chalk.yellow(config.provider)} ${chalk.gray('→')} `;
         const provider = await question(rl, providerPrompt);
         if (provider.trim()) {
-            if (!validProviders.includes(provider.trim())) {
-                console.log(chalk.hex('#EF4444')(`\n✗ 无效的 provider，必须是以下之一: ${validProviders.join(', ')}`));
+            if (!VALID_PROVIDERS.includes(provider.trim())) {
+                console.log(chalk.hex('#EF4444')(`\n✗ 无效的 provider，必须是以下之一: ${VALID_PROVIDERS.join(', ')}`));
                 console.log();
                 rl.close();
                 return;
@@ -178,7 +205,20 @@ export async function runConfigWizard() {
         if (shellHook.trim()) {
             config.shellHook = shellHook.trim() === 'true';
         }
-        // 6. Chat History Limit
+        // 6. Edit Mode
+        const editModeHint = chalk.gray('(manual=按E编辑, auto=自动编辑)');
+        const editModePrompt = `${chalk.cyan('编辑模式')} ${editModeHint}\n${chalk.gray('默认:')} ${chalk.yellow(config.editMode)} ${chalk.gray('→')} `;
+        const editMode = await question(rl, editModePrompt);
+        if (editMode.trim()) {
+            if (!VALID_EDIT_MODES.includes(editMode.trim())) {
+                console.log(chalk.hex('#EF4444')(`\n✗ 无效的 editMode，必须是: manual 或 auto`));
+                console.log();
+                rl.close();
+                return;
+            }
+            config.editMode = editMode.trim();
+        }
+        // 7. Chat History Limit
         const chatHistoryPrompt = `${chalk.cyan('Chat 历史保留轮数')}\n${chalk.gray('默认:')} ${chalk.yellow(config.chatHistoryLimit)} ${chalk.gray('→')} `;
         const chatHistoryLimit = await question(rl, chatHistoryPrompt);
         if (chatHistoryLimit.trim()) {
@@ -187,6 +227,24 @@ export async function runConfigWizard() {
                 config.chatHistoryLimit = num;
             }
         }
+        // 8. Command History Limit
+        const commandHistoryPrompt = `${chalk.cyan('命令历史保留条数')}\n${chalk.gray('默认:')} ${chalk.yellow(config.commandHistoryLimit)} ${chalk.gray('→')} `;
+        const commandHistoryLimit = await question(rl, commandHistoryPrompt);
+        if (commandHistoryLimit.trim()) {
+            const num = parseInt(commandHistoryLimit.trim(), 10);
+            if (!isNaN(num) && num > 0) {
+                config.commandHistoryLimit = num;
+            }
+        }
+        // 9. Shell History Limit
+        const shellHistoryPrompt = `${chalk.cyan('Shell 历史保留条数')}\n${chalk.gray('默认:')} ${chalk.yellow(config.shellHistoryLimit)} ${chalk.gray('→')} `;
+        const shellHistoryLimit = await question(rl, shellHistoryPrompt);
+        if (shellHistoryLimit.trim()) {
+            const num = parseInt(shellHistoryLimit.trim(), 10);
+            if (!isNaN(num) && num > 0) {
+                config.shellHistoryLimit = num;
+            }
+        }
         saveConfig(config);
         console.log('\n' + chalk.gray('━'.repeat(50)));
         console.log(chalk.hex('#10B981')('✅ 配置已保存'));
@@ -194,7 +252,8 @@ export async function runConfigWizard() {
         console.log();
     }
     catch (error) {
-        console.log(chalk.hex('#EF4444')(`\n✗ 配置失败: ${error.message}`));
+        const message = error instanceof Error ? error.message : String(error);
+        console.log(chalk.hex('#EF4444')(`\n✗ 配置失败: ${message}`));
         console.log();
     }
     finally {

package/dist/src/history.d.ts

@@ -1,20 +1,34 @@
+/**
+ * 历史记录项
+ */
+export interface HistoryRecord {
+    userPrompt: string;
+    command: string;
+    aiGeneratedCommand?: string;
+    userModified?: boolean;
+    executed: boolean;
+    exitCode: number | null;
+    output?: string;
+    reason?: 'builtin' | string;
+    timestamp?: string;
+}
 /**
  * 读取历史记录
  */
-export function getHistory(): any;
+export declare function getHistory(): HistoryRecord[];
 /**
  * 添加一条历史记录
  */
-export function addHistory(record: any): void;
+export declare function addHistory(record: HistoryRecord): void;
 /**
  * 清空历史记录
  */
-export function clearHistory(): void;
+export declare function clearHistory(): void;
 /**
  * 格式化历史记录供 AI 使用
  */
-export function formatHistoryForAI(): string;
+export declare function formatHistoryForAI(): string;
 /**
  * 获取历史记录文件路径（供显示用）
  */
-export function getHistoryFilePath(): string;
+export declare function getHistoryFilePath(): string;

package/dist/src/history.js

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import os from 'os';
+import { getConfig } from './config.js';
 const CONFIG_DIR = path.join(os.homedir(), '.please');
 const HISTORY_FILE = path.join(CONFIG_DIR, 'history.json');
 const MAX_HISTORY = 10;
@@ -40,6 +41,7 @@ function saveHistory(history) {
  * 添加一条历史记录
  */
 export function addHistory(record) {
+    const config = getConfig();
     const history = getHistory();
     // 截断输出
     if (record.output && record.output.length > MAX_OUTPUT_LENGTH) {
@@ -49,9 +51,10 @@ export function addHistory(record) {
     record.timestamp = new Date().toISOString();
     // 添加到开头
     history.unshift(record);
-    // 保留最近 N 条
-    if (history.length > MAX_HISTORY) {
-        history.length = MAX_HISTORY;
+    // 保留最近 N 条（从配置读取）
+    const maxHistory = config.commandHistoryLimit || MAX_HISTORY;
+    if (history.length > maxHistory) {
+        history.length = maxHistory;
     }
     saveHistory(history);
 }
@@ -69,8 +72,9 @@ export function formatHistoryForAI() {
     if (history.length === 0) {
         return '';
     }
-    const lines = history.map((item, index) => {
-        const timeAgo = getTimeAgo(item.timestamp);
+    const lines = history
+        .map((item, index) => {
+        const timeAgo = getTimeAgo(item.timestamp || '');
         let status;
         if (item.executed) {
             status = item.exitCode === 0 ? '✓' : `✗ 退出码:${item.exitCode}`;
@@ -81,19 +85,30 @@ export function formatHistoryForAI() {
         else {
             status = '(用户取消执行)';
         }
-        let line = `${index + 1}. [${timeAgo}] "${item.userPrompt}" → ${item.command} ${status}`;
-        // 如果有输出且命令失败，附加输出摘要
-        if (item.output && item.exitCode !== 0) {
-            line += `\n   输出: ${item.output.split('\n')[0]}`; // 只取第一行
+        // 检查是否用户修改了命令
+        if (item.userModified && item.aiGeneratedCommand) {
+            // 用户修改了命令
+            return `${index + 1}. [${timeAgo}] "${item.userPrompt}" → AI 生成: ${item.aiGeneratedCommand} / 用户修改为: ${item.command} ${status}`;
         }
-        return line;
-    }).reverse(); // 从旧到新排列
+        else {
+            // 未修改，使用原格式
+            let line = `${index + 1}. [${timeAgo}] "${item.userPrompt}" → ${item.command} ${status}`;
+            // 如果有输出且命令失败，附加输出摘要
+            if (item.output && item.exitCode !== 0) {
+                line += `\n   输出: ${item.output.split('\n')[0]}`; // 只取第一行
+            }
+            return line;
+        }
+    })
+        .reverse(); // 从旧到新排列
     return `【最近通过 pls 执行的命令】\n${lines.join('\n')}`;
 }
 /**
  * 计算时间差的友好显示
  */
 function getTimeAgo(timestamp) {
+    if (!timestamp)
+        return '未知';
     const now = Date.now();
     const then = new Date(timestamp).getTime();
     const diff = Math.floor((now - then) / 1000);

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

@@ -2,6 +2,5 @@ import { Agent } from '@mastra/core';
 /**
  * 创建 Mastra Shell Agent
  * 根据用户配置的 API Key、Base URL、Provider 和 Model
- * 使用 ai.js 中的统一提示词
  */
 export declare function createShellAgent(): Agent<"shell-commander", Record<string, import("@mastra/core").ToolAction<any, any, any, any, import("@mastra/core").ToolExecutionContext<any, any, any>>>, Record<string, import("@mastra/core").Metric>>;

package/dist/src/mastra-agent.js

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

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

@@ -0,0 +1,28 @@
+import { Agent } from '@mastra/core';
+/**
+ * 创建 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 对话（支持流式输出）
+ */
+export declare function chatWithMastra(prompt: string, options?: {
+    debug?: boolean;
+    onChunk?: (chunk: string) => void;
+}): Promise<{
+    reply: string;
+    debug?: {
+        sysinfo: string;
+        model: string;
+        systemPrompt: string;
+        chatHistory: Array<{
+            role: string;
+            content: string;
+        }>;
+        userPrompt: string;
+    };
+}>;

package/dist/src/mastra-chat.js

@@ -0,0 +1,93 @@
+import { Agent } from '@mastra/core';
+import { getConfig } from './config.js';
+import { buildChatSystemPrompt } 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
+ */
+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,
+        model: {
+            url: config.baseUrl,
+            id: modelId,
+            apiKey: config.apiKey,
+        },
+    });
+}
+/**
+ * 获取完整的系统提示词（用于调试）
+ */
+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 对话（支持流式输出）
+ */
+export async function chatWithMastra(prompt, options = {}) {
+    const config = getConfig();
+    const agent = createChatAgent();
+    // 获取对话历史
+    const chatHistory = getChatHistory();
+    // 构建消息数组（将历史和新消息合并）
+    const messages = [];
+    // 添加历史对话
+    for (const msg of chatHistory) {
+        messages.push(msg.content);
+    }
+    // 添加当前用户消息
+    messages.push(prompt);
+    let fullContent = '';
+    // 流式输出模式
+    if (options.onChunk) {
+        const stream = await agent.stream(messages);
+        for await (const chunk of stream.textStream) {
+            if (chunk) {
+                fullContent += chunk;
+                options.onChunk(chunk);
+            }
+        }
+    }
+    else {
+        // 非流式模式
+        const response = await agent.generate(messages);
+        fullContent = response.text || '';
+    }
+    if (!fullContent) {
+        throw new Error('AI 返回了空的响应');
+    }
+    // 保存对话历史
+    addChatMessage(prompt, fullContent);
+    // 返回结果
+    if (options.debug) {
+        return {
+            reply: fullContent,
+            debug: {
+                sysinfo: formatSystemInfo(),
+                model: config.model,
+                systemPrompt: getChatSystemPrompt(),
+                chatHistory,
+                userPrompt: prompt,
+            },
+        };
+    }
+    return { reply: fullContent };
+}

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

@@ -9,13 +9,13 @@ export declare const CommandStepSchema: z.ZodObject<{
     nextStepHint: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     command: string;
-    continue?: boolean | undefined;
     reasoning?: string | undefined;
+    continue?: boolean | undefined;
     nextStepHint?: string | undefined;
 }, {
     command: string;
-    continue?: boolean | undefined;
     reasoning?: string | undefined;
+    continue?: boolean | undefined;
     nextStepHint?: string | undefined;
 }>;
 export type CommandStep = z.infer<typeof CommandStepSchema>;

package/dist/src/multi-step.js

@@ -1,6 +1,6 @@
 import { z } from 'zod';
 import { createShellAgent } from './mastra-agent.js';
-import { buildSystemPrompt } from './ai.js';
+import { buildCommandSystemPrompt } from './prompts.js';
 import { formatSystemInfo } from './sysinfo.js';
 import { formatHistoryForAI } from './history.js';
 import { formatShellHistoryForAI, getShellHistory } from './shell-hook.js';
@@ -23,7 +23,7 @@ export function getFullSystemPrompt() {
     const plsHistory = formatHistoryForAI();
     const shellHistory = formatShellHistoryForAI();
     const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
-    return buildSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
+    return buildCommandSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
 }
 /**
  * 使用 Mastra 生成多步骤命令

package/dist/src/prompts.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 统一管理所有 AI 系统提示词
+ */
+/**
+ * 构建命令生成模式的系统提示词
+ */
+export declare function buildCommandSystemPrompt(sysinfo: string, plsHistory: string, shellHistory: string, shellHookEnabled: boolean): string;
+/**
+ * 构建 Chat 对话模式的系统提示词
+ */
+export declare function buildChatSystemPrompt(sysinfo: string, plsHistory: string, shellHistory: string, shellHookEnabled: boolean): string;

package/dist/src/prompts.js

@@ -0,0 +1,140 @@
+/**
+ * 统一管理所有 AI 系统提示词
+ */
+/**
+ * 构建命令生成模式的系统提示词
+ */
+export function buildCommandSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled) {
+    let prompt = `你是一个专业的 shell 脚本生成器。用户会提供他们的系统信息和一个命令需求。
+你的任务是返回一个可执行的、原始的 shell 命令或脚本来完成他们的目标。
+
+重要规则：
+1. 返回 JSON 格式，command 字段必须是可直接执行的命令（无解释、无注释、无 markdown）
+2. 不要添加 shebang（如 #!/bin/bash）
+3. command 可以包含多条命令（用 && 连接），但整体算一个命令
+4. 根据用户的系统信息选择合适的命令（如包管理器）
+5. 如果用户引用了之前的操作（如"刚才的"、"上一个"），请参考历史记录
+6. 绝对不要输出 pls 或 please 命令！
+
+【输出格式 - 非常重要】
+
+单步模式（一个命令完成）：
+如果任务只需要一个命令就能完成，只返回：
+{
+  "command": "ls -la"
+}
+
+多步模式（需要多个命令，后续依赖前面的结果）：
+如果任务需要多个命令，且后续命令必须根据前面的执行结果来决定，则返回：
+
+【多步骤完整示例】
+用户："查找大于100MB的日志文件并压缩"
+
+第一步你返回：
+{
+  "command": "find . -name '*.log' -size +100M",
+  "continue": true,
+  "reasoning": "查找大日志", （精简即可）
+  "nextStepHint": "压缩找到的文件" （精简即可）
+}
+
+执行后你会收到：
+命令已执行
+退出码: 0
+输出:
+./app.log
+./system.log
+
+然后你返回第二步：
+{
+  "command": "tar -czf logs.tar.gz ./app.log ./system.log",
+  "continue": false,
+  "reasoning": "压缩日志文件"
+}
+
+关键判断标准：
+- 多步 = 后续命令依赖前面的输出（如先 find 看有哪些，再根据结果操作具体文件）
+- 单步 = 一个命令就能完成（即使命令里有 && 连接多条，也算一个命令）
+
+常见场景举例：
+- "删除空文件夹" → 单步：find . -empty -delete （一个命令完成）
+- "查找大文件并压缩" → 多步：先 find 看有哪些，再 tar 压缩具体文件
+- "安装 git" → 单步：brew install git
+- "备份并删除旧日志" → 多步：先 mkdir backup，再 mv 文件到 backup
+- "查看目录" → 单步：ls -la
+
+严格要求：单步模式只返回 {"command": "xxx"}，绝对不要输出 continue/reasoning/nextStepHint！
+
+【错误处理】
+如果你收到命令执行失败的信息（退出码非0），你应该：
+1. 分析错误原因
+2. 调整命令策略，返回修正后的命令
+3. 设置 continue: true 重试，或设置 continue: false 放弃
+
+错误处理示例：
+上一步失败，你收到：
+命令已执行
+退出码: 1
+输出:
+mv: rename ./test.zip to ./c/test.zip: No such file or directory
+
+你分析后返回修正：
+{
+  "command": "cp test.zip a/ && cp test.zip b/ && cp test.zip c/",
+  "continue": false,
+  "reasoning": "改用 cp 复制而非 mv"
+}
+
+或者如果决定放弃（无法修正），返回：
+{
+  "command": "",
+  "continue": false,
+  "reasoning": "文件不存在且无法恢复，任务无法继续"
+}
+
+重要：当 continue: false 且决定放弃时，command 可以留空，重点是在 reasoning 中说明为什么放弃。
+
+关于 pls/please 工具：
+用户正在使用 pls（pretty-please）工具，这是一个将自然语言转换为 shell 命令的 AI 助手。
+当用户输入 "pls <描述>" 时，AI（也就是你）会生成对应的 shell 命令供用户确认执行。
+历史记录中标记为 [pls] 的条目表示用户通过 pls 工具执行的命令。
+
+用户的系统信息：${sysinfo}`;
+    // 根据是否启用 shell hook 决定展示哪个历史
+    if (shellHookEnabled && shellHistory) {
+        prompt += `\n\n${shellHistory}`;
+    }
+    else if (plsHistory) {
+        prompt += `\n\n${plsHistory}`;
+    }
+    return prompt;
+}
+/**
+ * 构建 Chat 对话模式的系统提示词
+ */
+export function buildChatSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled) {
+    let prompt = `你是一个命令行专家助手，帮助用户理解和使用命令行工具。
+
+【你的能力】
+- 解释命令的含义、参数、用法
+- 分析命令的执行效果和潜在风险
+- 回答命令行、Shell、系统管理相关问题
+- 根据用户需求推荐合适的命令并解释
+
+【回答要求】
+- 简洁清晰，避免冗余
+- 危险操作要明确警告
+- 适当给出示例命令
+- 结合用户的系统环境给出针对性建议
+
+【用户系统信息】
+${sysinfo}`;
+    // 根据是否启用 shell hook 决定展示哪个历史
+    if (shellHookEnabled && shellHistory) {
+        prompt += `\n\n${shellHistory}`;
+    }
+    else if (plsHistory) {
+        prompt += `\n\n${plsHistory}`;
+    }
+    return prompt;
+}