@yivan-lab/pretty-please 1.3.1 → 1.5.0

package/dist/src/multi-step.js

@@ -1,10 +1,8 @@
 import { z } from 'zod';
 import { createShellAgent } from './mastra-agent.js';
 import { SHELL_COMMAND_SYSTEM_PROMPT, buildUserContextPrompt } from './prompts.js';
-import { formatSystemInfo } from './sysinfo.js';
+import { formatSystemInfo, getSystemInfo } from './sysinfo.js';
 import { formatHistoryForAI } from './history.js';
-import { formatShellHistoryForAI, getShellHistory } from './shell-hook.js';
-import { getConfig } from './config.js';
 import { formatRemoteHistoryForAI, formatRemoteShellHistoryForAI } from './remote-history.js';
 import { formatRemoteSysInfoForAI } from './remote.js';
 /**
@@ -46,14 +44,18 @@ export async function generateMultiStepCommand(userPrompt, previousSteps = [], o
     }
     else {
         // 本地执行：格式化本地系统信息和历史
-        sysinfoStr = formatSystemInfo();
-        const config = getConfig();
+        sysinfoStr = formatSystemInfo(await getSystemInfo());
         const plsHistory = formatHistoryForAI();
-        const shellHistory = formatShellHistoryForAI();
-        historyStr = (config.shellHook && getShellHistory().length > 0) ? shellHistory : plsHistory;
+        // 使用统一的历史获取接口（自动降级到系统历史）
+        const { formatShellHistoryForAIWithFallback } = await import('./shell-hook.js');
+        const shellHistory = formatShellHistoryForAIWithFallback();
+        historyStr = shellHistory || plsHistory; // 优先使用 shell 历史，降级到 pls 历史
     }
+    // 获取用户偏好
+    const { formatUserPreferences } = await import('./user-preferences.js');
+    const userPreferencesStr = formatUserPreferences();
     // 构建包含所有动态数据的 User Prompt（XML 格式）
-    const userContextPrompt = buildUserContextPrompt(userPrompt, sysinfoStr, historyStr, previousSteps);
+    const userContextPrompt = buildUserContextPrompt(userPrompt, sysinfoStr, historyStr, userPreferencesStr, previousSteps);
     // 只发送一条 User Message
     const messages = [userContextPrompt];
     // 调用 Mastra Agent 生成结构化输出

package/dist/src/project-context.d.ts

@@ -0,0 +1,22 @@
+/**
+ * 项目上下文信息
+ */
+export interface ProjectContext {
+    types: string[];
+    packageManager?: string;
+    git?: {
+        branch: string;
+        status: 'clean' | 'dirty' | 'unknown';
+    };
+    scripts?: string[];
+}
+/**
+ * 检测项目上下文（优化版：< 30ms）
+ * 若未识别到任何特征，返回 null
+ */
+export declare function detectProjectContext(cwd: string): Promise<ProjectContext | null>;
+/**
+ * 格式化项目上下文为字符串（供 AI 使用）
+ * 格式：当前项目: nodejs+docker+git | pnpm | Git分支: main (有改动) | 脚本: dev, build, test
+ */
+export declare function formatProjectContext(project: ProjectContext): string;

package/dist/src/project-context.js

@@ -0,0 +1,168 @@
+import fs from 'fs';
+import path from 'path';
+import { detect as detectPM } from 'detect-package-manager';
+import { execSync } from 'child_process';
+/**
+ * 检测项目上下文（优化版：< 30ms）
+ * 若未识别到任何特征，返回 null
+ */
+export async function detectProjectContext(cwd) {
+    const types = [];
+    let packageManager;
+    let git;
+    let scripts;
+    try {
+        // 1. 快速读取目录文件列表（同步，< 5ms）
+        const files = fs.readdirSync(cwd);
+        // 2. 检测项目类型（纯文件检查，< 10ms）
+        if (files.includes('package.json')) {
+            types.push('nodejs');
+            // 检测 Node.js 包管理器
+            try {
+                packageManager = await detectPM({ cwd });
+            }
+            catch {
+                // 降级：根据 lock 文件推断
+                if (files.includes('pnpm-lock.yaml'))
+                    packageManager = 'pnpm';
+                else if (files.includes('yarn.lock'))
+                    packageManager = 'yarn';
+                else if (files.includes('bun.lockb'))
+                    packageManager = 'bun';
+                else
+                    packageManager = 'npm';
+            }
+            // 读取 package.json scripts（最多 5 个）
+            try {
+                const pkg = JSON.parse(fs.readFileSync(path.join(cwd, 'package.json'), 'utf-8'));
+                if (pkg.scripts) {
+                    scripts = Object.keys(pkg.scripts).slice(0, 5);
+                }
+            }
+            catch {
+                // 忽略读取错误
+            }
+        }
+        // Python
+        if (files.some(f => ['pyproject.toml', 'requirements.txt', 'Pipfile', 'uv.lock', 'poetry.lock'].includes(f))) {
+            types.push('python');
+            if (files.includes('uv.lock'))
+                packageManager = 'uv';
+            else if (files.includes('poetry.lock'))
+                packageManager = 'poetry';
+            else if (files.includes('Pipfile'))
+                packageManager = 'pipenv';
+            else
+                packageManager = 'pip';
+        }
+        // Rust
+        if (files.includes('Cargo.toml')) {
+            types.push('rust');
+            packageManager = 'cargo';
+        }
+        // Go
+        if (files.includes('go.mod')) {
+            types.push('go');
+        }
+        // Docker
+        if (files.some(f => f.includes('docker') || f === 'Dockerfile' || f === 'compose.yaml')) {
+            types.push('docker');
+        }
+        // Makefile
+        if (files.includes('Makefile')) {
+            types.push('make');
+        }
+        // 3. Git 检测优化（< 20ms）
+        if (files.includes('.git') || fs.existsSync(path.join(cwd, '.git'))) {
+            types.push('git');
+            try {
+                // 读取 .git/HEAD 文件获取分支（最快，< 5ms）
+                const headFile = fs.readFileSync(path.join(cwd, '.git/HEAD'), 'utf-8');
+                const refMatch = headFile.match(/ref: refs\/heads\/(.+)/);
+                if (refMatch) {
+                    // 正常分支
+                    git = {
+                        branch: refMatch[1].trim(),
+                        status: quickGitStatus(cwd),
+                    };
+                }
+                else {
+                    // detached HEAD 状态（直接 commit hash）
+                    const shortHash = headFile.trim().substring(0, 7);
+                    git = {
+                        branch: `HEAD (${shortHash})`,
+                        status: quickGitStatus(cwd),
+                    };
+                }
+            }
+            catch {
+                // Git 检测失败，只标记类型，不提供详细信息
+            }
+        }
+    }
+    catch (error) {
+        // 检测失败，返回空上下文
+    }
+    const hasContext = types.length > 0 ||
+        !!packageManager ||
+        !!git ||
+        (scripts && scripts.length > 0);
+    if (!hasContext) {
+        return null;
+    }
+    return { types, packageManager, git, scripts };
+}
+/**
+ * Git status 快速检测（带超时）
+ */
+function quickGitStatus(cwd) {
+    try {
+        // 使用 git status --porcelain，带超时保护
+        const result = execSync('git status --porcelain', {
+            cwd,
+            stdio: 'pipe',
+            timeout: 100, // 100ms 超时
+            encoding: 'utf-8',
+        });
+        return result.trim() === '' ? 'clean' : 'dirty';
+    }
+    catch {
+        // 超时或失败，返回 unknown
+        return 'unknown';
+    }
+}
+/**
+ * 格式化项目上下文为字符串（供 AI 使用）
+ * 格式：当前项目: nodejs+docker+git | pnpm | Git分支: main (有改动) | 脚本: dev, build, test
+ */
+export function formatProjectContext(project) {
+    if (project.types.length === 0) {
+        return '';
+    }
+    const parts = [];
+    // 项目类型
+    parts.push(`当前项目: ${project.types.join('+')}`);
+    // 包管理器
+    if (project.packageManager) {
+        parts.push(` | ${project.packageManager}`);
+    }
+    // Git 信息
+    if (project.git) {
+        let statusDesc = '';
+        if (project.git.status === 'clean') {
+            statusDesc = '干净';
+        }
+        else if (project.git.status === 'dirty') {
+            statusDesc = '有改动';
+        }
+        else {
+            statusDesc = '未知';
+        }
+        parts.push(` | Git分支: ${project.git.branch} (${statusDesc})`);
+    }
+    // 可用脚本
+    if (project.scripts && project.scripts.length > 0) {
+        parts.push(` | 脚本: ${project.scripts.join(', ')}`);
+    }
+    return parts.join('');
+}

package/dist/src/prompts.d.ts

@@ -8,14 +8,14 @@
  * 包含所有核心规则、输出格式定义、判断标准、错误处理策略和示例
  * 不包含任何动态数据（系统信息、历史记录等）
  */
-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";
+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\u3001\u53EF\u7528\u5DE5\u5177\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- <user_preferences>\uFF1A**\u7528\u6237\u7684\u547D\u4EE4\u4F7F\u7528\u504F\u597D**\uFF08\u683C\u5F0F\uFF1A\u547D\u4EE4\u540D(\u4F7F\u7528\u6B21\u6570)\uFF09\uFF0C\u5E2E\u52A9\u4F60\u4E86\u89E3\u7528\u6237\u4E60\u60EF\n  - \u4F8B\u5982\uFF1Agit(234), eza(156) \u8868\u793A\u7528\u6237\u7ECF\u5E38\u4F7F\u7528 git \u548C eza \u547D\u4EE4\n  - \u751F\u6210\u547D\u4EE4\u65F6\u53EF\u53C2\u8003\u504F\u597D\uFF0C\u4F46\u6700\u7EC8\u5E94\u7ED3\u5408\u4EFB\u52A1\u9700\u6C42\u548C <system_info> \u7EFC\u5408\u5224\u65AD\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\n7. **\u5EFA\u8BAE\u4F18\u5148\u4F7F\u7528\u6807\u51C6\u547D\u4EE4**\uFF08ls/find/grep/cat/ps\uFF09\u4EE5\u786E\u4FDD\u517C\u5BB9\u6027\u548C\u8F93\u51FA\u6355\u83B7\uFF0C\u800C\u4E0D\u662F\u4F7F\u7528 eza/bat/delta \u7B49\u73B0\u4EE3\u5DE5\u5177\uFF0C\u9664\u975E\u7528\u6237\u660E\u786E\u8981\u6C42\u4F7F\u7528\u76F8\u5173\u5DE5\u5177\uFF0C\u6216\u8005\u7528\u6237\u7279\u522B\u504F\u597D\u4F7F\u7528\u76F8\u5173\u5DE5\u5177\u3002\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";
 /**
  * ============================================================
  * 构建动态 User Prompt（XML 格式）
  * ============================================================
  * 将系统信息、历史记录、执行日志等动态数据组装成 XML 结构
  */
-export declare function buildUserContextPrompt(userRequest: string, sysInfoStr: string, historyStr: string, executedSteps: Array<{
+export declare function buildUserContextPrompt(userRequest: string, sysInfoStr: string, historyStr: string, userPreferencesStr: string, executedSteps: Array<{
     command: string;
     exitCode: number;
     output: string;
@@ -26,7 +26,7 @@ export declare function buildUserContextPrompt(userRequest: string, sysInfoStr:
  * ============================================================
  * 包含所有核心规则和能力描述，不包含动态数据
  */
-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";
+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_preferences>\uFF1A\u7528\u6237\u7684\u547D\u4EE4\u4F7F\u7528\u504F\u597D\uFF08\u547D\u4EE4\u540D(\u4F7F\u7528\u6B21\u6570)\uFF09\uFF0C\u5E2E\u52A9\u4F60\u4E86\u89E3\u7528\u6237\u4E60\u60EF\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 格式）
@@ -34,4 +34,4 @@ export declare const CHAT_SYSTEM_PROMPT = "\u4F60\u662F\u4E00\u4E2A\u547D\u4EE4\
  * 将系统信息、历史记录等动态数据组装成 XML 结构
  * 这个上下文会作为最新一条 user 消息发送给 AI
  */
-export declare function buildChatUserContext(userQuestion: string, sysInfoStr: string, plsHistory: string, shellHistory: string, shellHookEnabled: boolean): string;
+export declare function buildChatUserContext(userQuestion: string, sysInfoStr: string, plsHistory: string, shellHistory: string, shellHookEnabled: boolean, userPreferencesStr?: string): string;

package/dist/src/prompts.js

@@ -13,8 +13,11 @@ export const SHELL_COMMAND_SYSTEM_PROMPT = `你是一个专业的 shell 脚本
 
 ### 📋 输入数据格式说明
 你会收到以下 XML 标签包裹的上下文信息：
-- <system_info>：用户的操作系统、Shell 类型、当前目录、包管理器等环境信息
+- <system_info>：用户的操作系统、Shell 类型、当前目录、包管理器、可用工具等环境信息
 - <command_history>：用户最近执行的命令历史（用于理解上下文引用，如"刚才的文件"、"上一个命令"）
+- <user_preferences>：**用户的命令使用偏好**（格式：命令名(使用次数)），帮助你了解用户习惯
+  - 例如：git(234), eza(156) 表示用户经常使用 git 和 eza 命令
+  - 生成命令时可参考偏好，但最终应结合任务需求和 <system_info> 综合判断
 - <execution_log>：**多步骤任务的关键信息**，记录了之前步骤的命令、退出码和输出结果
   - 如果存在此标签，说明这是一个多步骤任务
   - 必须检查每个 <step> 中的 <exit_code>，0=成功，非0=失败
@@ -28,6 +31,7 @@ export const SHELL_COMMAND_SYSTEM_PROMPT = `你是一个专业的 shell 脚本
 4. 根据 <system_info> 中的信息选择合适的命令（如包管理器）
 5. 如果用户引用了之前的操作（如"刚才的"、"上一个"），请参考 <command_history>
 6. 绝对不要输出 pls 或 please 命令！
+7. **建议优先使用标准命令**（ls/find/grep/cat/ps）以确保兼容性和输出捕获，而不是使用 eza/bat/delta 等现代工具，除非用户明确要求使用相关工具，或者用户特别偏好使用相关工具。
 
 ### 📤 输出格式 - 非常重要
 
@@ -183,7 +187,7 @@ export const SHELL_COMMAND_SYSTEM_PROMPT = `你是一个专业的 shell 脚本
  * ============================================================
  * 将系统信息、历史记录、执行日志等动态数据组装成 XML 结构
  */
-export function buildUserContextPrompt(userRequest, sysInfoStr, historyStr, executedSteps) {
+export function buildUserContextPrompt(userRequest, sysInfoStr, historyStr, userPreferencesStr, executedSteps) {
     const parts = [];
     // 1. 系统信息
     parts.push(`<system_info>`);
@@ -195,7 +199,13 @@ export function buildUserContextPrompt(userRequest, sysInfoStr, historyStr, exec
         parts.push(historyStr);
         parts.push(`</command_history>`);
     }
-    // 3. 执行日志（多步骤的核心，紧凑 XML 结构）
+    // 3. 用户偏好（如果有）
+    if (userPreferencesStr && userPreferencesStr.trim()) {
+        parts.push(`<user_preferences>`);
+        parts.push(userPreferencesStr);
+        parts.push(`</user_preferences>`);
+    }
+    // 4. 执行日志（多步骤的核心，紧凑 XML 结构）
     if (executedSteps && executedSteps.length > 0) {
         parts.push(`<execution_log>`);
         executedSteps.forEach((step, i) => {
@@ -218,7 +228,7 @@ export function buildUserContextPrompt(userRequest, sysInfoStr, historyStr, exec
         parts.push(``);
         parts.push(`⚠️ 注意：请检查 <execution_log> 中最后一步的 <exit_code>。如果非 0，请分析 <output> 并修复命令。`);
     }
-    // 4. 用户需求
+    // 5. 用户需求
     parts.push(`<user_request>`);
     parts.push(userRequest);
     parts.push(`</user_request>`);
@@ -237,6 +247,7 @@ export const CHAT_SYSTEM_PROMPT = `你是一个命令行专家助手，帮助用
 - <system_info>：用户的操作系统、Shell 类型、当前目录等环境信息
 - <command_history>：用户最近通过 pls 执行的命令（用于理解上下文引用）
 - <shell_history>：用户最近在终端执行的所有命令（如果启用了 Shell Hook）
+- <user_preferences>：用户的命令使用偏好（命令名(使用次数)），帮助你了解用户习惯
 - <user_question>：用户的具体问题
 
 ### 🎯 你的能力
@@ -263,7 +274,7 @@ export const CHAT_SYSTEM_PROMPT = `你是一个命令行专家助手，帮助用
  * 将系统信息、历史记录等动态数据组装成 XML 结构
  * 这个上下文会作为最新一条 user 消息发送给 AI
  */
-export function buildChatUserContext(userQuestion, sysInfoStr, plsHistory, shellHistory, shellHookEnabled) {
+export function buildChatUserContext(userQuestion, sysInfoStr, plsHistory, shellHistory, shellHookEnabled, userPreferencesStr) {
     const parts = [];
     // 1. 系统信息
     parts.push('<system_info>');
@@ -280,7 +291,13 @@ export function buildChatUserContext(userQuestion, sysInfoStr, plsHistory, shell
         parts.push(plsHistory);
         parts.push('</command_history>');
     }
-    // 3. 用户问题
+    // 3. 用户偏好（如果有）
+    if (userPreferencesStr && userPreferencesStr.trim()) {
+        parts.push('<user_preferences>');
+        parts.push(userPreferencesStr);
+        parts.push('</user_preferences>');
+    }
+    // 4. 用户问题
     parts.push('<user_question>');
     parts.push(userQuestion);
     parts.push('</user_question>');

package/dist/src/shell-hook.d.ts

@@ -19,6 +19,7 @@ export interface HookStatus {
 }
 /**
  * 检测当前 shell 类型
+ * 使用 platform 模块进行跨平台检测
  */
 export declare function detectShell(): ShellType;
 /**
@@ -50,6 +51,18 @@ export declare function getHookStatus(): HookStatus;
  * 显示 shell 历史
  */
 export declare function displayShellHistory(): void;
+/**
+ * 重新安装 Shell Hook（通用函数）
+ * 用于版本升级、配置变更等场景
+ *
+ * @param options.silent 是否静默模式（不输出日志）
+ * @param options.reason 重装原因（用于日志显示）
+ * @returns 是否成功重装
+ */
+export declare function reinstallShellHook(options?: {
+    silent?: boolean;
+    reason?: string;
+}): Promise<boolean>;
 /**
  * 当 shellHistoryLimit 变化时，自动重装 Hook
  * 返回是否成功重装
@@ -59,6 +72,25 @@ export declare function reinstallHookForLimitChange(oldLimit: number, newLimit:
  * 清空 shell 历史
  */
 export declare function clearShellHistory(): void;
+/**
+ * 获取 shell 历史（统一接口）
+ * 优先使用 shell hook，降级到系统历史文件
+ *
+ * 这是推荐的历史获取方式，会自动选择最佳来源：
+ * 1. 优先：shell hook（有退出码，最准确）
+ * 2. 降级：系统历史文件（无退出码，兼容未安装 hook 的情况）
+ */
+export declare function getShellHistoryWithFallback(): ShellHistoryItem[];
+/**
+ * 获取最近一条非 pls 的命令（统一接口）
+ * 自动选择最佳历史来源
+ */
+export declare function getLastNonPlsCommand(): ShellHistoryItem | null;
+/**
+ * 格式化 shell 历史供 AI 使用（统一接口）
+ * 自动选择最佳历史来源
+ */
+export declare function formatShellHistoryForAIWithFallback(): string;
 /**
  * 检测远程服务器的 shell 类型
  */