xiaozhou-chat 1.0.26 → 1.0.28

package/README.md

@@ -1,37 +1,48 @@
 # xiaozhou-chat
 
-CLI chatbot based on NewAPI with advanced features like Project Context, Multi-Profiles, and AI Tools.
-基于 NewAPI 的高级命令行聊天工具，支持项目上下文感知、多环境配置及 AI 自动化工具。
+![NPM Version](https://img.shields.io/npm/v/xiaozhou-chat)
+![License](https://img.shields.io/npm/l/xiaozhou-chat)
+![Node Version](https://img.shields.io/node/v/xiaozhou-chat)
+
+**A powerful CLI chatbot based on NewAPI, designed for developers.**
+基于 NewAPI 的高级命令行聊天工具，专为开发者打造。支持项目上下文感知、多环境配置、MCP 协议及 AI 自动化工具。
 
 ---
 
-## ✨ 特性 (Features)
+## ✨ 核心特性 (Features)
+
+### 🤖 智能交互与开发
+- **AI 编程助手**：内置文件读写 (`read_file`, `write_file`) 和命令执行 (`run_command`)，可让 AI 帮你重构代码、运行测试。
+- **项目感知**：通过 `/scan` 自动扫描目录结构，智能读取 `package.json` 等关键文件，让 AI 瞬间理解项目全貌。
+- **智能提交**：`/commit` 自动分析暂存区 (`git diff --cached`) 代码变更，生成符合 Conventional Commits 规范的提交信息。
+- **上下文压缩**：`/compress` 利用 AI 对长对话进行深度摘要，保留关键技术细节与决策，大幅节省 Token。
+
+### ⚙️ 灵活配置与管理
+- **多环境切换**：支持 Profiles (`/profile`)，一键在不同 API Key、模型或 BaseURL 之间切换（如：开发环境/生产环境）。
+- **MCP 协议支持**：完整集成 [Model Context Protocol](https://modelcontextprotocol.io/)，可连接外部 MCP Server 扩展能力（如连接数据库、Notion 等）。
+- **配置隔离**：支持项目级 (`./.newapi-chat-config.json`) 和全局级 (`~/.newapi-chat-config.json`) 配置文件，互不干扰。
 
-- **🤖 多模型/多环境管理**：支持通过 `/profile` (或 `/切换模型`) 快速切换不同的 API Key 和模型配置。
-- **📂 项目感知**：通过 `/scan` 自动扫描项目结构、读取 `package.json` 和 `README.md` (智能大文件摘要)，让 AI 理解你的项目。
-- **🛠️ AI 编程助手**：内置文件读写 (`read_file`, `write_file`) 和命令执行 (`run_command`) 工具，AI 可以帮你重构代码、运行测试。
-- **🛡️ 安全机制**：`write_file` 覆盖文件前自动创建 `.bak` 备份；敏感文件自动排除；网络请求失败自动指数退避重试。
-- **🚀 效率工具**：`/commit` 自动分析代码变更并生成 Git Commit Message；`/token` 实时监控上下文消耗。
-- **🎨 交互优化**：
-  - **Ctrl+C 中断**：生成过程中按 `Ctrl+C` 仅中断当前输出，不退出程序。
-  - **Markdown 渲染**：终端内完美渲染 Markdown（代码高亮、表格、粗体等）。
-  - **Esc 快捷键**：按 `Esc` 清除当前输入，空行时按 `Esc` 退出程序。
-- **⚙️ 灵活配置**：支持全局配置及项目级配置文件 (`.newapi-chat-config.json`)，可随项目隔离环境。
-- **🔌 MCP 支持**：集成 Model Context Protocol，可连接外部 MCP Server 扩展能力。
+### 🛡️ 稳健与体验
+- **环境自适应**：自动检测并清洗冲突的环境变量（如代理设置），内置指数退避重试机制，确保网络请求稳定。
+- **极致体验**：
+  - **无缝打字**：防并发锁设计，解决 AI 生成时的光标跳动问题。
+  - **Markdown 渲染**：终端内完美渲染代码高亮、表格、粗体等。
+  - **快捷键支持**：`Ctrl+C` 优雅中断生成，`Esc` 快速清空输入。
+  - **安全写文件**：覆盖文件前自动创建 `.bak` 备份。
 
 ---
 
-## 📦 安装与使用 (Installation & Usage)
+## 📦 安装 (Installation)
 
 ### 方式一：在当前项目中使用 (推荐)
-无需全局安装，直接在你的项目中添加并初始化配置：
+无需全局安装，直接集成到你的项目中：
 
 1. **安装依赖**
    ```bash
    npm install xiaozhou-chat
    ```
 
-2. **初始化配置** (自动在当前目录生成配置文件)
+2. **初始化配置**
    ```bash
    npx xiaozhou-chat init
    ```
@@ -42,7 +53,7 @@ CLI chatbot based on NewAPI with advanced features like Project Context, Multi-P
    ```
 
 ### 方式二：全局安装
-如果你希望在任何目录下都能使用：
+如果你希望在任何目录下随时呼出 AI 助手：
 
 ```bash
 npm i -g xiaozhou-chat
@@ -51,72 +62,80 @@ xiaozhou-chat
 
 ---
 
-## 💬 常用命令 (Commands)
+## 💬 命令指南 (Commands)
 
-在对话中输入 `/` 开头的命令即可触发功能。支持中文别名。
+在对话中输入 `/` 开头的命令即可触发功能。
 
-### 🔧 配置管理
-| 命令 | 中文别名 | 说明 |
+### � 效率工具
+| 命令 | 别名 | 功能说明 |
 |---|---|---|
-| `/init` | `/初始化配置` | (交互式) 在当前目录生成 `.newapi-chat-config.json` |
-| `/config` | `/配置` | 查看或修改当前配置 (如 `/config set model gpt-4`) |
-| `/profile` | `/切换模型` | 管理多套配置 (详情见下文) |
-| `/system` | - | 设置系统提示词 (System Prompt) |
-
-### 🧠 上下文与文件
-| 命令 | 中文别名 | 说明 |
+| `/commit` | - | **AI 自动提交**：分析暂存区代码 -> 生成 Commit Message -> 确认提交 |
+| `/compress` | - | **智能压缩**：AI 总结当前对话历史，释放 Token 空间 |
+| `/scan` | `/当前项目结构` | 扫描并加载项目结构到上下文 |
+| `/load <file>` | - | 加载指定文件内容（支持大文件行号选择） |
+| `/paste` | - | 进入多行粘贴模式（输入 `---` 结束） |
+
+### � 配置与管理
+| 命令 | 别名 | 功能说明 |
 |---|---|---|
-| `/scan` | `/当前项目结构` | 扫描当前目录结构并加载关键文件到上下文 |
-| `/load <file>` | - | 加载指定文件内容给 AI (支持大文件行号选择) |
-| `/save <file>` | - | 将 AI 回复中的代码块保存为本地文件 |
-| `/paste` | - | 进入多行粘贴模式 (避免回车直接发送) |
+| `/config` | `/配置` | 查看或修改配置 (如 `/config apiKey sk-xxx`) |
+| `/profile` | `/切换模型` | 切换配置环境 (如 `/profile use gpt4`) |
+| `/init` | `/初始化配置` | 在当前目录生成配置文件 |
+| `/system` | - | 设置系统提示词 (System Prompt) |
+| `/mcp` | - | 查看已连接的 MCP 服务器状态 |
 
-### 🛠️ 工具与扩展
+### 📊 其他
 | 命令 | 说明 |
 |---|---|
-| `/commit` | 自动执行 `git add -A` 并利用 AI 生成提交信息 |
-| `/token` | 查看当前会话 Token 估算与预警 |
-| `/compress` | 智能压缩对话历史，节省 Token |
-| `/mcp` | 管理 MCP 服务器连接 (如连接外部数据库工具) |
-| `/clear` | 清空当前对话历史 (保留 System Prompt) |
-| `/history` | 查看历史记录 (支持 Markdown 渲染) |
-| `/export` | 导出对话记录为 Markdown |
+| `/token` | 查看当前 Token 消耗估算 |
+| `/clear` | 清空对话历史 |
+| `/history` | 查看最近的对话记录 |
+| `/help` | 查看帮助菜单 |
 
 ---
 
 ## ⚙️ 配置文件 (Configuration)
 
-工具会按以下优先级读取配置：
-1. **项目级配置**：`./.newapi-chat-config.json` (推荐，由 `init` 生成)
-2. **用户级配置**：`~/.newapi-chat-config.json`
+配置文件优先级：**项目级** > **全局级**。
 
-**配置文件示例 (`.newapi-chat-config.json`)：**
+**`.newapi-chat-config.json` 示例：**
 ```json
 {
-  "apiKey": "sk-xxxx",
+  "apiKey": "sk-your-api-key",
   "baseUrl": "https://api.newapi.pro/v1",
   "model": "claude-3-5-sonnet",
+  "systemPrompt": "你是一个资深的全栈工程师...",
   "profiles": {
     "default": { "model": "claude-3-5-sonnet" },
-    "gpt4": { "model": "gpt-4", "apiKey": "sk-special..." }
+    "gpt4": { "model": "gpt-4", "apiKey": "sk-special-key..." },
+    "local": { "baseUrl": "http://localhost:11434/v1", "model": "llama3" }
+  },
+  "mcpServers": {
+    "filesystem": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/me/projects"]
+    }
   }
 }
 ```
 
-> **注意**：建议将 `.newapi-chat-config.json` 添加到 `.gitignore` 中，防止 API Key 泄露。
+> **安全提示**：请务必将 `.newapi-chat-config.json` 添加到 `.gitignore` 中，防止密钥泄露。
 
 ---
 
 ## 🛠️ 本地开发 (Development)
 
-### 依赖安装
 ```bash
+# 安装依赖
 npm install
-```
 
-### 构建与打包
-- **Windows**: `npm run build:win` -> `dist/newapi-chat.exe`
-- **macOS**: `npm run build:mac` -> `dist/xiaozhou-chat`
+# 链接到全局进行测试
+npm link
+xiaozhou-chat
+
+# 构建可执行文件
+npm run build:mac  # or build:win
+```
 
 ---
 

package/bin/cli.js

@@ -37,6 +37,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import readline from "node:readline";
+import { execSync } from "node:child_process";
 import minimist from "minimist";
 import { MCPClient } from "../lib/mcp-lite.js";
 import { 
@@ -54,7 +55,8 @@ import {
   exportHistory 
 } from "../lib/history.js";
 import { 
-  chatStream 
+  chatStream,
+  generateCompletion
 } from "../lib/chat.js";
 import { 
   builtInTools, 
@@ -431,36 +433,71 @@ rl.on("line", async (line) => {
             console.log("⚠️ 历史记录太短，无需压缩。");
             return rl.prompt();
         }
-        // Logic similar to before, but calling chatStream with a summary prompt
-        // To simplify: we construct a temporary context just for summary
+        
         const toCompress = messages.slice(0, -2);
         const recent = messages.slice(-2);
         
         const summaryPrompt = `
 请总结以下对话的主要内容，提取关键信息、代码片段和决策。
 摘要应简洁明了，以便作为后续对话的上下文。
+保留所有重要的技术细节。
 
 对话内容:
 ${JSON.stringify(toCompress)}
 `;
-        // Temporary buffer for summary
-        let summary = "";
-        // Mock printer or capture output?
-        // chatStream prints to stdout. We might want to capture it instead.
-        // But our chatStream prints to StreamPrinter.
-        // For simplicity, let's just let it print the summary to user, then ask user if they want to apply it?
-        // Or just do it.
-        // To capture output, we'd need to modify chatStream or StreamPrinter.
-        // Let's skip modifying chatStream for now and just say:
-        // "Feature: /compress is simplified to just clearing old history for now in this refactor, or we need a non-printing mode."
-        // Actually, let's just keep the old history slice logic for now to save time, or use a "silent" mode.
-        // I'll add `silent: true` option to chatStream later if needed.
-        // For now:
-        messages = [
-            { role: "system", content: "Previous conversation summary: (Compressed)" }, 
-            ...recent
-        ];
-        console.log("✅ 已压缩历史 (Mock implementation)");
+        try {
+            const summary = await generateCompletion(activeConfig, [{role: "user", content: summaryPrompt}]);
+            messages = [
+                { role: "system", content: `Previous conversation summary:\n${summary}` }, 
+                ...recent
+            ];
+            saveHistory(messages);
+            console.log("✅ 历史记录已压缩");
+            console.log("摘要预览:", summary.slice(0, 100).replace(/\n/g, ' ') + "...");
+        } catch (e) {
+            console.error("❌ 压缩失败:", e.message);
+        }
+        return rl.prompt();
+    }
+
+    if (input === "/commit") {
+        try {
+            let diff;
+            try {
+                diff = execSync("git diff --cached", { stdio: ['ignore', 'pipe', 'ignore'] }).toString().trim();
+            } catch (e) {
+                console.log("❌ 获取 git diff 失败，请确认当前目录是 git 仓库");
+                return rl.prompt();
+            }
+
+            if (!diff) {
+                console.log("⚠️  暂存区为空，请先执行 'git add <file>'");
+                return rl.prompt();
+            }
+            
+            console.log("🤖 正在分析 Diff 并生成 Commit Message...");
+            const prompt = `
+你是一个资深的开发者。请根据以下的 Git Diff 内容，生成一个符合 Conventional Commits 规范的 Commit Message。
+只返回 Commit Message 本身，不要包含 markdown 代码块或其他解释。
+
+Diff 内容:
+${diff.slice(0, 8000)}
+`;
+            const msg = await generateCompletion(activeConfig, [{role: "user", content: prompt}]);
+            console.log("\n----- 建议的 Commit Message -----");
+            console.log(`\x1b[32m${msg.trim()}\x1b[0m`);
+            console.log("-----------------------------------");
+            
+            const ans = await askQuestion("提交吗? (y/n) ");
+            if (ans.trim().toLowerCase() === 'y') {
+                execSync(`git commit -m "${msg.trim().replace(/"/g, '\\"')}"`, { stdio: 'inherit' });
+                console.log("✅ 提交成功");
+            } else {
+                console.log("🚫 已取消");
+            }
+        } catch (e) {
+            console.error("❌ Commit 生成失败:", e.message);
+        }
         return rl.prompt();
     }
 

package/lib/chat.js

@@ -105,6 +105,44 @@ export async function requestWithRetry(url, options, maxRetries = 3) {
     throw lastError;
 }
 
+export async function generateCompletion(config, messages, options = {}) {
+    const { 
+        model = config.model, 
+        max_tokens = 4096,
+        jsonMode = false 
+    } = options;
+
+    const requestUrl = `${config.baseUrl}${config.baseUrl.endsWith('/') ? '' : '/'}chat/completions`;
+    
+    // 自动修正 v1
+    const finalUrl = (requestUrl.includes("/v1/") || requestUrl.endsWith("/v1")) 
+        ? requestUrl 
+        : requestUrl.replace("/chat/completions", "/v1/chat/completions");
+
+    const body = {
+        model,
+        messages,
+        stream: false,
+        max_tokens
+    };
+    
+    if (jsonMode) {
+        body.response_format = { type: "json_object" };
+    }
+
+    const res = await requestWithRetry(finalUrl, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            Authorization: `Bearer ${config.apiKey}`
+        },
+        body: JSON.stringify(body)
+    });
+
+    const data = await res.json();
+    return data.choices?.[0]?.message?.content || "";
+}
+
 export async function chatStream(context, userInput = null, options = {}) {
     const { 
         messages, 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xiaozhou-chat",
-  "version": "1.0.26",
+  "version": "1.0.28",
   "description": "CLI chatbot based on NewAPI",
   "bin": {
     "xiaozhou-chat": "bin/cli.js"