@ww_nero/mini-cli 1.0.60 → 1.0.61

package/README.md

@@ -0,0 +1,24 @@
+# Mini CLI
+
+极简的 AI 命令行助手，支持工具调用、上下文压缩以及会话历史管理。
+
+## 快速开始
+- 安装依赖：`npm install`
+- 填写配置：首次运行会在 `~/.mini` 生成 `chat.json` 等文件，修改其中的 `key` 为你的接口密钥即可。
+- 运行方式：`npm start` 或 `node bin/mini.js`，也可在全局安装后直接执行 `mini`。
+
+## 常用启动参数
+- `mini -i "你好"`：启动后立即发送首条问题。
+- `mini -m <model>`：指定默认模型（等同于会话内的 `/model <name>`）。
+- `mini --resume`：启动时自动恢复当前工作目录最近一次对话。
+- `mini --help`：查看全部参数说明。
+
+## 对话内快捷命令
+- `/model`：查看或切换模型。
+- `/clear`：清空上下文。
+- `/resume [序号]`：列出或恢复历史会话。
+- `/exit`：退出对话。
+
+## 会话历史
+- 每个工作目录的历史记录保存在 `~/.mini/cli/<workspace-hash>/YYYYMMDDHHMMSS.json` 中。
+- 可通过 `mini --resume` 自动载入最近一次会话，或在对话中使用 `/resume` 按序号恢复。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ww_nero/mini-cli",
-  "version": "1.0.60",
+  "version": "1.0.61",
   "description": "极简的 AI 命令行助手",
   "bin": {
     "mini": "bin/mini.js"

package/src/chat.js

@@ -173,6 +173,7 @@ const setLoadingCursorState = (isLoading) => {
 const startChatSession = async ({
   initialQuestion = '',
   initialModelName,
+  initialResume = false,
   cliOptions = []
 } = {}) => {
   const initResult = ensureConfigFiles();
@@ -423,6 +424,38 @@ const startChatSession = async ({
     console.log(chalk.gray('-------- 历史会话结束，可继续提问 --------'));
   };
 
+  const resumeHistoryByIndex = (index = 0, { auto = false } = {}) => {
+    const entries = listHistoryFiles(workspaceRoot);
+
+    if (entries.length === 0) {
+      const notice = auto
+        ? '未找到可恢复的历史记录，将开始新的会话。'
+        : '暂无历史记录。';
+      console.log(chalk.yellow(notice));
+      return false;
+    }
+
+    const target = entries[index];
+    if (!target) {
+      console.log(chalk.yellow(`序号 ${index + 1} 超出范围，当前共有 ${entries.length} 条历史记录。`));
+      return false;
+    }
+
+    const historyMessages = readHistoryMessages(target.filePath);
+    if (!Array.isArray(historyMessages) || historyMessages.length === 0) {
+      console.log(chalk.yellow('该历史记录为空或已损坏，无法恢复。'));
+      return false;
+    }
+
+    const refreshedPath = refreshHistoryFilePath(target.filePath, workspaceRoot) || target.filePath;
+    loadHistoryFromFile(refreshedPath, historyMessages);
+
+    const prefix = auto ? '已自动恢复最近一条历史记录' : `已切换到历史记录 #${index + 1}`;
+    console.log(chalk.green(`${prefix}，可继续对话。`));
+    replayHistoryConversation(historyMessages);
+    return true;
+  };
+
   const handleResumeCommand = (rawArgs = '') => {
     const entries = listHistoryFiles(workspaceRoot);
     if (entries.length === 0) {
@@ -451,22 +484,7 @@ const startChatSession = async ({
       return;
     }
 
-    const target = entries[numeric - 1];
-    if (!target) {
-      console.log(chalk.yellow(`序号 ${numeric} 超出范围，当前共有 ${entries.length} 条历史记录。`));
-      return;
-    }
-
-    const historyMessages = readHistoryMessages(target.filePath);
-    if (!Array.isArray(historyMessages) || historyMessages.length === 0) {
-      console.log(chalk.yellow('该历史记录为空或已损坏，无法恢复。'));
-      return;
-    }
-
-    const refreshedPath = refreshHistoryFilePath(target.filePath, workspaceRoot) || target.filePath;
-    loadHistoryFromFile(refreshedPath, historyMessages);
-    console.log(chalk.green(`已切换到历史记录 #${numeric}，可继续对话。`));
-    replayHistoryConversation(historyMessages);
+    resumeHistoryByIndex(numeric - 1);
   };
 
   console.log(chalk.blueBright('Mini CLI 已启动，随时输入问题开始提问。'));
@@ -499,6 +517,10 @@ const startChatSession = async ({
     console.log(chalk.gray(`  ${cmd.value} - ${cmd.description}`));
   });
 
+  if (initialResume) {
+    resumeHistoryByIndex(0, { auto: true });
+  }
+
   const rl = readline.createInterface({
     input: process.stdin,
     output: process.stdout,

package/src/index.js

@@ -1,38 +1,39 @@
-const { Command } = require('commander');
-const chalk = require('chalk');
-
-const pkg = require('../package.json');
-const { startChatSession } = require('./chat');
-const { getDefaultConfigPath } = require('./config');
-const { CLI_OPTIONS } = require('./utils/cliOptions');
-
-const run = async () => {
-  const program = new Command();
-
-  program
-    .name('mini')
-    .description('Mini CLI · 极简 AI 命令行助手')
-    .version(pkg.version, '-v, --version')
-    .addHelpText('after', `\n退出方法：输入 /exit 或按 Ctrl+C。\n配置模板会自动生成于 ${getDefaultConfigPath()}。`)
-    .showHelpAfterError('(使用 mini --help 查看完整帮助)')
-    .action(async (options) => {
-      await startChatSession({
-        initialQuestion: options.input || '',
-        initialModelName: options.model,
-        cliOptions: CLI_OPTIONS
-      });
-    });
-
-  CLI_OPTIONS.forEach((option) => {
-    program.option(option.flags, option.description);
-  });
-
-  try {
-    await program.parseAsync(process.argv);
-  } catch (error) {
-    console.error(chalk.red(`Mini CLI 运行失败: ${error.message}`));
-    process.exitCode = 1;
-  }
-};
-
-run();
+const { Command } = require('commander');
+const chalk = require('chalk');
+
+const pkg = require('../package.json');
+const { startChatSession } = require('./chat');
+const { getDefaultConfigPath } = require('./config');
+const { CLI_OPTIONS } = require('./utils/cliOptions');
+
+const run = async () => {
+  const program = new Command();
+
+  program
+    .name('mini')
+    .description('Mini CLI · 极简 AI 命令行助手')
+    .version(pkg.version, '-v, --version')
+    .addHelpText('after', `\n退出方法：输入 /exit 或按 Ctrl+C。\n配置模板会自动生成于 ${getDefaultConfigPath()}。`)
+    .showHelpAfterError('(使用 mini --help 查看完整帮助)')
+    .action(async (options) => {
+      await startChatSession({
+        initialQuestion: options.input || '',
+        initialModelName: options.model,
+        initialResume: Boolean(options.resume),
+        cliOptions: CLI_OPTIONS
+      });
+    });
+
+  CLI_OPTIONS.forEach((option) => {
+    program.option(option.flags, option.description);
+  });
+
+  try {
+    await program.parseAsync(process.argv);
+  } catch (error) {
+    console.error(chalk.red(`Mini CLI 运行失败: ${error.message}`));
+    process.exitCode = 1;
+  }
+};
+
+run();

package/src/utils/cliOptions.js

@@ -1,6 +1,7 @@
 const CLI_OPTIONS = [
   { flags: '-i, --input <text>', description: '启动后先发送一条问题' },
-  { flags: '-m, --model <name>', description: '指定启动模型名称（等同于运行 /model <name>）' }
+  { flags: '-m, --model <name>', description: '指定启动模型名称（等同于运行 /model <name>）' },
+  { flags: '-r, --resume', description: '启动时自动恢复最近一条历史会话' }
 ];
 
 module.exports = {