@yivan-lab/pretty-please 1.0.0 → 1.1.0

package/dist/bin/pls.js

@@ -5,30 +5,34 @@ import { Command } from 'commander';
 import { fileURLToPath } from 'url';
 import { dirname, join } from 'path';
 import { exec } from 'child_process';
-import fs from 'fs';
 import os from 'os';
 import chalk from 'chalk';
 import { MultiStepCommandGenerator } from '../src/components/MultiStepCommandGenerator.js';
 import { Chat } from '../src/components/Chat.js';
 import { isConfigValid, setConfigValue, getConfig, maskApiKey } from '../src/config.js';
 import { clearHistory, addHistory, getHistory, getHistoryFilePath } from '../src/history.js';
-import { clearChatHistory, getChatRoundCount, getChatHistoryFilePath } from '../src/chat-history.js';
-import { installShellHook, uninstallShellHook, getHookStatus, detectShell, getShellConfigPath, } from '../src/shell-hook.js';
+import { clearChatHistory, getChatRoundCount, getChatHistoryFilePath, displayChatHistory } from '../src/chat-history.js';
+import { installShellHook, uninstallShellHook, getHookStatus, detectShell, getShellConfigPath, displayShellHistory, clearShellHistory, } from '../src/shell-hook.js';
 import * as console2 from '../src/utils/console.js';
-// 获取 package.json 版本
+// 导入 package.json（Bun 会自动打包进二进制）
+import packageJson from '../package.json';
+// 保留这些用于其他可能的用途
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
-const packageJson = JSON.parse(fs.readFileSync(join(__dirname, '../package.json'), 'utf-8'));
 const program = new Command();
 /**
  * 执行命令（原生版本）
  */
-function executeCommand(command, prompt) {
+function executeCommand(command) {
     return new Promise((resolve) => {
         let output = '';
         let hasOutput = false;
         console.log(''); // 空行
-        console2.printSeparator('输出');
+        // 计算命令框宽度，让分隔线长度一致
+        const lines = command.split('\n');
+        const maxContentWidth = Math.max(...lines.map(l => console2.getDisplayWidth(l)));
+        const boxWidth = Math.max(maxContentWidth + 4, console2.getDisplayWidth('生成命令') + 6, 20);
+        console2.printSeparator('输出', boxWidth);
         const child = exec(command);
         child.stdout?.on('data', (data) => {
             output += data;
@@ -42,16 +46,16 @@ function executeCommand(command, prompt) {
         });
         child.on('close', (code) => {
             if (hasOutput) {
-                console2.printSeparator('');
+                console2.printSeparator('', boxWidth);
             }
             resolve({ exitCode: code || 0, output });
         });
         child.on('error', (err) => {
             if (!hasOutput) {
-                console2.printSeparator('');
+                console2.printSeparator('', boxWidth);
             }
             console2.error(err.message);
-            console2.printSeparator('');
+            console2.printSeparator('', boxWidth);
             resolve({ exitCode: 1, output: err.message });
         });
     });
@@ -73,14 +77,17 @@ configCmd
     const CONFIG_FILE = join(os.homedir(), '.please', 'config.json');
     console.log('');
     console2.title('当前配置:');
-    console2.muted('━'.repeat(40));
-    console.log(`  ${chalk.hex('#00D9FF')('apiKey')}:           ${maskApiKey(config.apiKey)}`);
-    console.log(`  ${chalk.hex('#00D9FF')('baseUrl')}:          ${config.baseUrl}`);
-    console.log(`  ${chalk.hex('#00D9FF')('provider')}:         ${config.provider}`);
-    console.log(`  ${chalk.hex('#00D9FF')('model')}:            ${config.model}`);
-    console.log(`  ${chalk.hex('#00D9FF')('shellHook')}:        ${config.shellHook ? chalk.hex('#10B981')('已启用') : chalk.gray('未启用')}`);
-    console.log(`  ${chalk.hex('#00D9FF')('chatHistoryLimit')}: ${config.chatHistoryLimit} 轮`);
-    console2.muted('━'.repeat(40));
+    console2.muted('━'.repeat(50));
+    console.log(`  ${chalk.hex('#00D9FF')('apiKey')}:              ${maskApiKey(config.apiKey)}`);
+    console.log(`  ${chalk.hex('#00D9FF')('baseUrl')}:             ${config.baseUrl}`);
+    console.log(`  ${chalk.hex('#00D9FF')('provider')}:            ${config.provider}`);
+    console.log(`  ${chalk.hex('#00D9FF')('model')}:               ${config.model}`);
+    console.log(`  ${chalk.hex('#00D9FF')('shellHook')}:           ${config.shellHook ? chalk.hex('#10B981')('已启用') : chalk.gray('未启用')}`);
+    console.log(`  ${chalk.hex('#00D9FF')('editMode')}:            ${config.editMode === 'auto' ? chalk.hex('#00D9FF')('auto (自动编辑)') : chalk.gray('manual (按E编辑)')}`);
+    console.log(`  ${chalk.hex('#00D9FF')('chatHistoryLimit')}:    ${config.chatHistoryLimit} 轮`);
+    console.log(`  ${chalk.hex('#00D9FF')('commandHistoryLimit')}: ${config.commandHistoryLimit} 条`);
+    console.log(`  ${chalk.hex('#00D9FF')('shellHistoryLimit')}:   ${config.shellHistoryLimit} 条`);
+    console2.muted('━'.repeat(50));
     console2.muted(`配置文件: ${CONFIG_FILE}`);
     console.log('');
 });
@@ -129,7 +136,14 @@ historyCmd
                 : chalk.hex('#EF4444')(`✗ 退出码:${item.exitCode}`)
             : chalk.gray('(未执行)');
         console.log(`\n${chalk.gray(`${index + 1}.`)} ${chalk.hex('#00D9FF')(item.userPrompt)}`);
-        console.log(`   ${chalk.dim('→')} ${item.command} ${status}`);
+        // 显示用户修改信息
+        if (item.userModified && item.aiGeneratedCommand) {
+            console.log(`   ${chalk.dim('AI 生成:')} ${chalk.gray(item.aiGeneratedCommand)}`);
+            console.log(`   ${chalk.dim('用户修改为:')} ${item.command} ${status} ${chalk.yellow('(已修改)')}`);
+        }
+        else {
+            console.log(`   ${chalk.dim('→')} ${item.command} ${status}`);
+        }
         console.log(`   ${chalk.gray(item.timestamp)}`);
     });
     console.log('');
@@ -145,7 +159,32 @@ historyCmd
     console2.success('历史记录已清空');
     console.log('');
 });
-// 默认 history 命令（显示历史）
+// history chat 子命令
+const historyChatCmd = historyCmd.command('chat').description('查看或管理对话历史');
+historyChatCmd.action(() => {
+    displayChatHistory();
+});
+historyChatCmd
+    .command('clear')
+    .description('清空对话历史')
+    .action(() => {
+    clearChatHistory();
+    console.log('');
+    console2.success('对话历史已清空');
+    console.log('');
+});
+// history shell 子命令
+const historyShellCmd = historyCmd.command('shell').description('查看或管理 Shell 历史');
+historyShellCmd.action(() => {
+    displayShellHistory();
+});
+historyShellCmd
+    .command('clear')
+    .description('清空 Shell 历史')
+    .action(() => {
+    clearShellHistory();
+});
+// 默认 history 命令（显示命令历史）
 historyCmd.action(() => {
     const history = getHistory();
     if (history.length === 0) {
@@ -164,7 +203,14 @@ historyCmd.action(() => {
                 : chalk.hex('#EF4444')(`✗ 退出码:${item.exitCode}`)
             : chalk.gray('(未执行)');
         console.log(`\n${chalk.gray(`${index + 1}.`)} ${chalk.hex('#00D9FF')(item.userPrompt)}`);
-        console.log(`   ${chalk.dim('→')} ${item.command} ${status}`);
+        // 显示用户修改信息
+        if (item.userModified && item.aiGeneratedCommand) {
+            console.log(`   ${chalk.dim('AI 生成:')} ${chalk.gray(item.aiGeneratedCommand)}`);
+            console.log(`   ${chalk.dim('用户修改为:')} ${item.command} ${status} ${chalk.yellow('(已修改)')}`);
+        }
+        else {
+            console.log(`   ${chalk.dim('→')} ${item.command} ${status}`);
+        }
         console.log(`   ${chalk.gray(item.timestamp)}`);
     });
     console.log('');
@@ -324,6 +370,7 @@ program
     (async () => {
         const executedSteps = [];
         let currentStepNumber = 1;
+        let lastStepFailed = false; // 跟踪上一步是否失败
         while (true) {
             let stepResult = null;
             // 使用 Ink 渲染命令生成
@@ -344,6 +391,8 @@ program
                 addHistory({
                     userPrompt: currentStepNumber === 1 ? prompt : `[步骤${currentStepNumber}] ${prompt}`,
                     command: stepResult.command,
+                    aiGeneratedCommand: stepResult.aiGeneratedCommand, // AI 原始命令
+                    userModified: stepResult.userModified || false,
                     executed: false,
                     exitCode: null,
                     output: '',
@@ -352,9 +401,31 @@ program
                 process.exit(0);
             }
             if (stepResult.confirmed) {
+                // 如果命令为空，说明 AI 决定放弃
+                if (!stepResult.command || stepResult.command.trim() === '') {
+                    console.log('');
+                    if (stepResult.reasoning) {
+                        console2.info(`💡 AI 分析: ${stepResult.reasoning}`);
+                    }
+                    console2.muted('❌ AI 决定停止尝试，任务失败');
+                    console.log('');
+                    process.exit(1);
+                }
+                // 特殊处理：如果上一步失败，且 AI 决定放弃（continue: false），直接显示原因并退出
+                if (lastStepFailed &&
+                    stepResult.needsContinue === false &&
+                    stepResult.command.startsWith('echo')) {
+                    console.log('');
+                    if (stepResult.reasoning) {
+                        console2.info(`💡 AI 分析: ${stepResult.reasoning}`);
+                    }
+                    console2.muted('❌ AI 决定停止尝试，任务失败');
+                    console.log('');
+                    process.exit(1);
+                }
                 // 执行命令
                 const execStart = Date.now();
-                const { exitCode, output } = await executeCommand(stepResult.command, prompt);
+                const { exitCode, output } = await executeCommand(stepResult.command);
                 const execDuration = Date.now() - execStart;
                 // 保存到执行历史
                 const executedStep = {
@@ -370,6 +441,8 @@ program
                 addHistory({
                     userPrompt: currentStepNumber === 1 ? prompt : `[步骤${currentStepNumber}] ${stepResult.reasoning || prompt}`,
                     command: stepResult.command,
+                    aiGeneratedCommand: stepResult.aiGeneratedCommand, // AI 原始命令
+                    userModified: stepResult.userModified || false,
                     executed: true,
                     exitCode,
                     output,
@@ -385,13 +458,18 @@ program
                         // 多步命令
                         console2.success(`步骤 ${currentStepNumber} 执行完成 ${console2.formatDuration(execDuration)}`);
                     }
+                    lastStepFailed = false;
                 }
                 else {
-                    // 执行失败，但不立即退出，让 AI 分析错误并调整策略
+                    // 执行失败，标记状态
                     console2.error(`步骤 ${currentStepNumber} 执行失败，退出码: ${exitCode} ${console2.formatDuration(execDuration)}`);
                     console.log('');
                     console2.warning('正在请 AI 分析错误并调整策略...');
-                    // 不退出，继续循环，AI 会收到错误信息
+                    lastStepFailed = true;
+                    // 继续循环，让 AI 分析错误
+                    console.log('');
+                    currentStepNumber++;
+                    continue;
                 }
                 // 判断是否继续
                 if (stepResult.needsContinue !== true) {
@@ -405,6 +483,21 @@ program
                 console.log('');
                 currentStepNumber++;
             }
+            else if (!stepResult.confirmed && !stepResult.cancelled) {
+                // AI 返回了结果但没有确认（空命令的情况）
+                if (lastStepFailed && stepResult.reasoning) {
+                    console.log('');
+                    console2.info(`💡 AI 分析: ${stepResult.reasoning}`);
+                    console2.muted('❌ AI 决定停止尝试，任务失败');
+                    console.log('');
+                    process.exit(1);
+                }
+                // 其他情况也退出
+                console.log('');
+                console2.muted('任务结束');
+                console.log('');
+                process.exit(0);
+            }
         }
     })();
 });

package/dist/package.json

@@ -0,0 +1,80 @@
+{
+    "name": "@yivan-lab/pretty-please",
+    "version": "1.1.0",
+    "description": "AI 驱动的命令行工具，将自然语言转换为可执行的 Shell 命令",
+    "type": "module",
+    "bin": {
+        "pls": "./dist/bin/pls.js",
+        "please": "./dist/bin/pls.js"
+    },
+    "scripts": {
+        "dev": "tsx bin/pls.tsx",
+        "build": "tsc && node scripts/postbuild.js",
+        "start": "node dist/bin/pls.js",
+        "link:dev": "mkdir -p ~/.local/bin && ln -sf \"$(pwd)/bin/pls.tsx\" ~/.local/bin/pls-dev && echo '✅ pls-dev 已链接到 ~/.local/bin/pls-dev'",
+        "unlink:dev": "rm -f ~/.local/bin/pls-dev && echo '✅ pls-dev 已移除'",
+        "prepublishOnly": "pnpm build"
+    },
+    "keywords": [
+        "cli",
+        "ai",
+        "shell",
+        "openai",
+        "command-line",
+        "natural-language",
+        "terminal",
+        "assistant",
+        "mastra",
+        "deepseek"
+    ],
+    "author": "yivan-lab",
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/yivan-lab/pretty-please.git"
+    },
+    "bugs": {
+        "url": "https://github.com/yivan-lab/pretty-please/issues"
+    },
+    "homepage": "https://github.com/yivan-lab/pretty-please#readme",
+    "publishConfig": {
+        "access": "public"
+    },
+    "files": [
+        "bin",
+        "dist/bin",
+        "dist/src",
+        "dist/package.json",
+        "src",
+        "README.md",
+        "LICENSE",
+        "tsconfig.json"
+    ],
+    "dependencies": {
+        "@mastra/core": "^0.24.8",
+        "chalk": "^5.6.2",
+        "cli-highlight": "^2.1.11",
+        "commander": "^14.0.2",
+        "ink": "^6.5.1",
+        "ink-box": "^2.0.0",
+        "ink-markdown": "^1.0.4",
+        "ink-select-input": "^6.2.0",
+        "ink-spinner": "^5.0.0",
+        "ink-text-input": "^6.0.0",
+        "lowlight": "^3.3.0",
+        "marked": "^17.0.1",
+        "react": "^19.2.3",
+        "shiki": "^3.20.0",
+        "string-width": "^8.1.0",
+        "wrap-ansi": "^9.0.2",
+        "zod": "^3.25.76"
+    },
+    "devDependencies": {
+        "@types/hast": "^3.0.4",
+        "@types/node": "^25.0.2",
+        "@types/react": "^19.2.7",
+        "react-devtools-core": "^7.0.1",
+        "tsx": "^4.21.0",
+        "typescript": "^5.9.3"
+    }
+}

package/dist/src/ai.d.ts

@@ -1,45 +1,5 @@
 /**
- * 调用 AI 生成命令
- * @param {string} prompt 用户输入的自然语言描述
- * @param {object} options 选项
- * @param {boolean} options.debug 是否返回调试信息
- */
-export function generateCommand(prompt: string, options?: {
-    debug: boolean;
-}): Promise<string | {
-    command: string;
-    debug: {
-        sysinfo: string;
-        model: any;
-        systemPrompt: string;
-        userPrompt: string;
-    };
-}>;
-/**
- * 调用 AI 进行对话（chat 模式，支持流式输出）
- * @param {string} prompt 用户输入的问题
- * @param {object} options 选项
- * @param {boolean} options.debug 是否返回调试信息
- * @param {function} options.onChunk 流式输出回调，接收每个文本片段
- */
-export function chatWithAI(prompt: string, options?: {
-    debug: boolean;
-    onChunk: Function;
-}): Promise<string | {
-    reply: string;
-    debug: {
-        sysinfo: string;
-        model: any;
-        systemPrompt: string;
-        chatHistory: {
-            role: string;
-            content: string;
-        }[];
-        userPrompt: string;
-    };
-}>;
-/**
- * 生成系统提示词
+ * 生成命令生成模式的系统提示词
  * @param {string} sysinfo - 系统信息
  * @param {string} plsHistory - pls 命令历史
  * @param {string} shellHistory - shell 终端历史

package/dist/src/ai.js

@@ -1,27 +1,11 @@
-import OpenAI from 'openai';
-import { getConfig } from './config.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';
 /**
- * 创建 OpenAI 客户端
- */
-function createClient() {
-    const config = getConfig();
-    return new OpenAI({
-        apiKey: config.apiKey,
-        baseURL: config.baseUrl
-    });
-}
-/**
- * 生成系统提示词
+ * 生成命令生成模式的系统提示词
  * @param {string} sysinfo - 系统信息
  * @param {string} plsHistory - pls 命令历史
  * @param {string} shellHistory - shell 终端历史
  * @param {boolean} shellHookEnabled - 是否启用了 shell hook
  */
-function buildSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled) {
+export function buildSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled) {
     let prompt = `你是一个专业的 shell 脚本生成器。用户会提供他们的系统信息和一个命令需求。
 你的任务是返回一个可执行的、原始的 shell 命令或脚本来完成他们的目标。
 
@@ -51,8 +35,8 @@ function buildSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled)
 {
   "command": "find . -name '*.log' -size +100M",
   "continue": true,
-  "reasoning": "查找大日志",
-  "nextStepHint": "压缩找到的文件"
+  "reasoning": "查找大日志", （精简即可）
+  "nextStepHint": "压缩找到的文件" （精简即可）
 }
 
 执行后你会收到：
@@ -102,13 +86,15 @@ mv: rename ./test.zip to ./c/test.zip: No such file or directory
   "reasoning": "改用 cp 复制而非 mv"
 }
 
-或者放弃：
+或者如果决定放弃（无法修正），返回：
 {
-  "command": "echo '任务无法完成：文件已被移动'",
+  "command": "",
   "continue": false,
-  "reasoning": "文件不存在，无法继续"
+  "reasoning": "文件不存在且无法恢复，任务无法继续"
 }
 
+重要：当 continue: false 且决定放弃时，command 可以留空，重点是在 reasoning 中说明为什么放弃。
+
 关于 pls/please 工具：
 用户正在使用 pls（pretty-please）工具，这是一个将自然语言转换为 shell 命令的 AI 助手。
 当用户输入 "pls <描述>" 时，AI（也就是你）会生成对应的 shell 命令供用户确认执行。
@@ -126,170 +112,3 @@ mv: rename ./test.zip to ./c/test.zip: No such file or directory
     }
     return prompt;
 }
-// 导出给其他模块使用
-export { buildSystemPrompt };
-/**
- * 调用 AI 生成命令
- * @param {string} prompt 用户输入的自然语言描述
- * @param {object} options 选项
- * @param {boolean} options.debug 是否返回调试信息
- */
-export async function generateCommand(prompt, options = {}) {
-    const config = getConfig();
-    const client = createClient();
-    const sysinfo = formatSystemInfo();
-    const plsHistory = formatHistoryForAI();
-    const shellHistory = formatShellHistoryForAI();
-    const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
-    const systemPrompt = buildSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
-    const response = await client.chat.completions.create({
-        model: config.model,
-        messages: [
-            {
-                role: 'system',
-                content: systemPrompt
-            },
-            {
-                role: 'user',
-                content: prompt
-            }
-        ],
-        max_tokens: 1024,
-        temperature: 0.2
-    });
-    const command = response.choices[0]?.message?.content?.trim();
-    if (!command) {
-        throw new Error('AI 返回了空的响应');
-    }
-    if (options.debug) {
-        return {
-            command,
-            debug: {
-                sysinfo,
-                model: config.model,
-                systemPrompt,
-                userPrompt: prompt
-            }
-        };
-    }
-    return command;
-}
-/**
- * 生成 chat 模式的系统提示词
- * @param {string} sysinfo - 系统信息
- * @param {string} plsHistory - pls 命令历史
- * @param {string} shellHistory - shell 终端历史
- * @param {boolean} shellHookEnabled - 是否启用了 shell hook
- */
-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;
-}
-/**
- * 调用 AI 进行对话（chat 模式，支持流式输出）
- * @param {string} prompt 用户输入的问题
- * @param {object} options 选项
- * @param {boolean} options.debug 是否返回调试信息
- * @param {function} options.onChunk 流式输出回调，接收每个文本片段
- */
-export async function chatWithAI(prompt, options = {}) {
-    const config = getConfig();
-    const client = createClient();
-    const sysinfo = formatSystemInfo();
-    const plsHistory = formatHistoryForAI();
-    const shellHistory = formatShellHistoryForAI();
-    const shellHookEnabled = config.shellHook && getShellHistory().length > 0;
-    const systemPrompt = buildChatSystemPrompt(sysinfo, plsHistory, shellHistory, shellHookEnabled);
-    // 获取对话历史
-    const chatHistory = getChatHistory();
-    // 构建消息数组
-    const messages = [
-        { role: 'system', content: systemPrompt },
-        ...chatHistory,
-        { role: 'user', content: prompt }
-    ];
-    // 流式输出模式
-    if (options.onChunk) {
-        const stream = await client.chat.completions.create({
-            model: config.model,
-            messages,
-            max_tokens: 2048,
-            temperature: 0.7,
-            stream: true
-        });
-        let fullContent = '';
-        for await (const chunk of stream) {
-            const content = chunk.choices[0]?.delta?.content || '';
-            if (content) {
-                fullContent += content;
-                options.onChunk(content);
-            }
-        }
-        if (!fullContent) {
-            throw new Error('AI 返回了空的响应');
-        }
-        // 保存对话历史
-        addChatMessage(prompt, fullContent);
-        if (options.debug) {
-            return {
-                reply: fullContent,
-                debug: {
-                    sysinfo,
-                    model: config.model,
-                    systemPrompt,
-                    chatHistory,
-                    userPrompt: prompt
-                }
-            };
-        }
-        return fullContent;
-    }
-    // 非流式模式（保持兼容）
-    const response = await client.chat.completions.create({
-        model: config.model,
-        messages,
-        max_tokens: 2048,
-        temperature: 0.7
-    });
-    const reply = response.choices[0]?.message?.content?.trim();
-    if (!reply) {
-        throw new Error('AI 返回了空的响应');
-    }
-    // 保存对话历史
-    addChatMessage(prompt, reply);
-    if (options.debug) {
-        return {
-            reply,
-            debug: {
-                sysinfo,
-                model: config.model,
-                systemPrompt,
-                chatHistory,
-                userPrompt: prompt
-            }
-        };
-    }
-    return reply;
-}

package/dist/src/builtin-detector.d.ts

@@ -1,15 +1,21 @@
 /**
- * 检测命令中是否包含 builtin
- * @param {string} command - 要检测的命令
- * @returns {{ hasBuiltin: boolean, builtins: string[] }} 检测结果
+ * Shell builtin 命令检测器
+ *
+ * 用于检测命令中是否包含 shell 内置命令（builtin）
+ * 这些命令在子进程中执行可能无效或行为异常
+ */
+/**
+ * Builtin 检测结果
  */
-export function detectBuiltin(command: string): {
+export interface BuiltinResult {
     hasBuiltin: boolean;
     builtins: string[];
-};
+}
+/**
+ * 检测命令中是否包含 builtin
+ */
+export declare function detectBuiltin(command: string): BuiltinResult;
 /**
  * 格式化 builtin 列表为易读的字符串
- * @param {string[]} builtins - builtin 命令数组
- * @returns {string} 格式化后的字符串
  */
-export function formatBuiltins(builtins: string[]): string;
+export declare function formatBuiltins(builtins: string[]): string;