zhitalk 0.0.9 → 0.0.11

package/README.md

@@ -2,22 +2,32 @@
 
 [智语 Zhitalk](https://zhitalk.chat/) 是一个 AI Agent 个人助手，像 OpenClaw 小龙虾一样。 包含 tools skills memory hook subagent MCP-server 等 Agent 功能。你可以和它聊天，给它分配任务，让它操作文件...
 
+📖 你可以免费围观项目进展，也可以加入学习 [跟双越老师从 0 开发一个 AI Agent 智能体](https://www.huashuiai.com/pub/ai-agent-camp-new)
+
 ## Usage
 
-Docs https://zhitalk.chat/
+本地安装 Nodejs 版本>=22 ，执行如下命令安装 Zhitalk
 
-Install
+【注意】Windows 操作系统，使用管理员身份打开 cmd ，再执行命令
 
 ```
 npm install zhitalk -g
 ```
 
-Run in terminal
+能查看到 Zhitalk 的版本号，说明安装成功
+
+```
+zhitalk --version
+```
+
+运行 zhitalk 命令，初始化
 
 ```
 zhitalk
 ```
 
+第一次执行时，需要你修改配置文件，参考 https://zhitalk.chat/#config
+
 ## Dev
 
 ### Tech

package/dist/agent/agent.js

@@ -1,6 +1,6 @@
 import { SqliteSaver } from '@langchain/langgraph-checkpoint-sqlite';
 import { SystemMessage, AIMessage, HumanMessage, ToolMessage, } from '@langchain/core/messages';
-import { StateGraph, Annotation, START, END, interrupt, Command, } from '@langchain/langgraph';
+import { StateGraph, Annotation, START, END, interrupt, Command, GraphRecursionError, } from '@langchain/langgraph';
 import { messagesStateReducer } from '@langchain/langgraph';
 import { DB_PATH } from './db.js';
 import { tools, maybePersistedOutput, initTools } from './tools.js';
@@ -295,32 +295,43 @@ async function _runAgent(compiledAgent, userMessage, onToken, onToolConfirmation
     let fullResponse = '';
     let usageMetadata;
     let input = { messages: [new HumanMessage(userMessage)] };
+    const recursionLimit = 50;
     while (true) {
-        const stream = await compiledAgent.stream(input, {
-            ...config,
-            streamMode: 'messages',
-            signal,
-            recursionLimit: 50,
-        });
-        for await (const chunk of stream) {
-            if (signal?.aborted) {
-                throw new Error('abort');
+        try {
+            const stream = await compiledAgent.stream(input, {
+                ...config,
+                streamMode: 'messages',
+                signal,
+                recursionLimit,
+            });
+            for await (const chunk of stream) {
+                if (signal?.aborted) {
+                    throw new Error('abort');
+                }
+                const message = chunk[0];
+                const metadata = chunk[1];
+                if (metadata?.langgraph_node !== 'model_request')
+                    continue;
+                const msgUsage = message.usage_metadata;
+                if (msgUsage) {
+                    usageMetadata = msgUsage;
+                }
+                // AIMessageChunk 的 content 在 message.content 属性上，不在 kwargs.content
+                const content = message.content ?? message.kwargs?.content ?? '';
+                const toolCallChunks = message.tool_call_chunks ?? [];
+                if (!content || toolCallChunks.length > 0)
+                    continue;
+                onToken(content);
+                fullResponse += content;
             }
-            const message = chunk[0];
-            const metadata = chunk[1];
-            if (metadata?.langgraph_node !== 'model_request')
-                continue;
-            const msgUsage = message.usage_metadata;
-            if (msgUsage) {
-                usageMetadata = msgUsage;
+        }
+        catch (err) {
+            if (err instanceof GraphRecursionError) {
+                const hint = `我已经思考了 ${recursionLimit} 个步骤，仍未得到最终结果，我暂停歇会儿～ 你可以随时让我“继续”`;
+                onToken('\n\n' + hint);
+                return { response: fullResponse + '\n\n' + hint, usageMetadata };
             }
-            // AIMessageChunk 的 content 在 message.content 属性上，不在 kwargs.content
-            const content = message.content ?? message.kwargs?.content ?? '';
-            const toolCallChunks = message.tool_call_chunks ?? [];
-            if (!content || toolCallChunks.length > 0)
-                continue;
-            onToken(content);
-            fullResponse += content;
+            throw err;
         }
         const state = await compiledAgent.getState(config);
         const interruptedTask = state.tasks?.find((t) => t.interrupts?.length > 0);

package/dist/agent/cli.js

@@ -49,9 +49,43 @@ function prompt(question) {
         });
     });
 }
+function createSpinner(text) {
+    const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
+    let i = 0;
+    let timer = null;
+    let running = false;
+    const tick = () => {
+        i = (i + 1) % frames.length;
+        readline.cursorTo(process.stdout, 0);
+        process.stdout.write(color.gray(`${text} ${frames[i]}`));
+    };
+    return {
+        start() {
+            if (running)
+                return;
+            running = true;
+            i = 0;
+            readline.cursorTo(process.stdout, 0);
+            process.stdout.write(color.gray(`${text} ${frames[0]}`));
+            timer = setInterval(tick, 80);
+        },
+        stop() {
+            if (!running)
+                return;
+            running = false;
+            if (timer) {
+                clearInterval(timer);
+                timer = null;
+            }
+            readline.cursorTo(process.stdout, 0);
+            readline.clearLine(process.stdout, 0);
+        },
+    };
+}
 async function chat(userInput) {
     const rl = createInterface();
-    process.stdout.write('\n' + color.aiPrefix());
+    // AI: 前缀延迟到第一个 token 输出，此前显示 spinner
+    // process.stdout.write('\n' + color.aiPrefix())
     const controller = new AbortController();
     // 监听 ESC 键，中断 AI 请求
     const escListener = (_str, key) => {
@@ -64,18 +98,32 @@ async function chat(userInput) {
     readline.emitKeypressEvents(process.stdin);
     process.stdin.on('keypress', escListener);
     let usageMetadata;
+    let needsPrefix = true;
+    const spinner = createSpinner('AI 思考中');
     try {
+        spinner.start();
         const result = await runAgentStream(userInput, (token) => {
+            if (needsPrefix) {
+                needsPrefix = false;
+                spinner.stop();
+                process.stdout.write('\n' + color.aiPrefix());
+            }
             process.stdout.write(token);
         }, async (toolCalls) => {
+            spinner.stop();
             for (const call of toolCalls) {
                 console.log(formatToolLog(call.name, JSON.stringify(call.args)));
             }
             const answer = await new Promise((resolve) => {
                 rl.question('确认执行以上工具? (y/n): ', resolve);
             });
-            return (answer.trim().toLowerCase() === 'y' ||
-                answer.trim().toLowerCase() === 'yes');
+            const confirmed = answer.trim().toLowerCase() === 'y' ||
+                answer.trim().toLowerCase() === 'yes';
+            if (confirmed) {
+                needsPrefix = true;
+                spinner.start();
+            }
+            return confirmed;
         }, threadId, controller.signal);
         usageMetadata = result.usageMetadata;
     }
@@ -85,6 +133,7 @@ async function chat(userInput) {
         }
     }
     finally {
+        spinner.stop();
         process.stdin.removeListener('keypress', escListener);
         rl.close();
     }

package/dist/agent/config.js

@@ -36,7 +36,10 @@ export function getModelConfig() {
     if (!config.model.baseURL) {
         throw new Error(`配置文件 ${CONFIG_PATH} 中缺少 model.baseURL 字段，请参考 https://zhitalk.chat/#config 修改配置`);
     }
-    return config.model;
+    return {
+        ...config.model,
+        model: config.model.model.toLowerCase(),
+    };
 }
 export function getEnv(key) {
     const config = loadConfig();

package/dist/agent/model.js

@@ -3,11 +3,12 @@ import { getModelConfig } from './config.js';
 const modelConfig = getModelConfig();
 export function createModel(options) {
     const modelKwargs = {};
-    if (modelConfig.model.startsWith('kimi')) {
+    if (modelConfig.model.startsWith('kimi') ||
+        modelConfig.model.startsWith('minimax')) {
         modelKwargs.thinking = { type: 'disabled' };
     }
     // GLM 模型的流式 function calling 存在兼容性问题，禁用流式输出
-    const isGlm = modelConfig.model.toLowerCase().startsWith('glm');
+    const isGlm = modelConfig.model.startsWith('glm');
     return new ChatOpenAI({
         model: modelConfig.model,
         apiKey: modelConfig.apiKey,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zhitalk",
-  "version": "0.0.9",
+  "version": "0.0.11",
   "description": "A personal AI Agent like OpenClaw, including tools, skills, memory, hook, sub-agent, MCP server, etc. Run in the terminal.",
   "type": "module",
   "main": "dist/index.js",
@@ -21,6 +21,9 @@
   "keywords": [],
   "author": "双越",
   "license": "ISC",
+  "engines": {
+    "node": ">=22"
+  },
   "docs": "https://zhitalk.chat/",
   "devDependencies": {
     "@jest/globals": "^29.7.0",