jinzd-ai-cli 0.1.85 → 0.1.86

package/CLAUDE.md

@@ -352,6 +352,59 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 - [x] **web_fetch DNS 解析时 SSRF 防护**（v0.1.25）：新增 `resolveAndCheck()` 函数，用 `dns.promises.lookup()` 预解析域名，检查结果 IP 是否为私有地址。初始 URL 和 redirect 目标均校验。
 - [ ] **`persistentCwd` 全局状态**：bash 工具的当前工作目录是模块级全局变量，多 session 并发时可能串扰。现阶段单 session REPL 无影响，GUI 多会话扩展时需重构为 per-session 状态。
 
+## 本轮开发完成记录（2026-03-16，v0.1.85 → v0.1.86）
+
+### Web UI P1 增强（续）：命令扩展 + 键盘快捷键 + 导出 + 断线重连
+
+**P1-3：更多命令支持**
+
+| 文件 | 变更类型 | 说明 |
+|------|---------|------|
+| `src/web/protocol.ts` | 修改 | 新增 `S2C_ExportData`（format/filename/content）+ `S2C_MemoryContent` 消息类型 |
+| `src/web/session-handler.ts` | 修改 | 新增 `/export [md\|json]` + `/memory [show\|add\|clear]` 命令 + 3 个实现方法 |
+| `src/web/client/app.js` | 修改 | `handleExportData()` 浏览器 Blob 下载 + `handleMemoryContent()` 卡片渲染 |
+
+- `/export md`：格式化 session 消息为 Markdown（标题/元数据/User+Assistant 分段），触发浏览器下载
+- `/export json`：导出结构化 JSON（title/provider/model/messages），触发浏览器下载
+- `/memory`：读取 `~/.aicli/memory.md` 显示为带样式卡片
+- `/memory add <text>`：追加带时间戳的条目
+- `/memory clear`：清空记忆文件
+
+**P1-4：键盘快捷键**
+
+| 快捷键 | 功能 |
+|--------|------|
+| `Esc` | 停止 AI 生成（发送 abort） |
+| `Ctrl+L` | 清屏（保留欢迎消息） |
+| `Ctrl+K` | 清空输入框 |
+| `↑` / `↓` | 历史消息回溯（最多 50 条，支持命令和聊天输入） |
+
+- 输入历史在 `sendMessage()` 中记录，去重 + 50 条上限
+- ↑ 键首次按下保存当前草稿，↓ 键到底恢复草稿
+- 单行输入时 ↑ 触发历史，多行输入时保持原有光标移动
+
+**P1-5：Markdown 导出**（合并到 P1-3 的 `/export md` 命令实现）
+
+**P1-6：断线重连恢复**
+
+| 文件 | 变更类型 | 说明 |
+|------|---------|------|
+| `src/web/client/app.js` | 修改 | 30s 心跳 ping + 指数退避重连（1s→2s→4s→10s）+ 重连后 UI 状态恢复 |
+| `src/web/server.ts` | 修改 | WebSocket message handler 中识别 `ping` 并回复 `pong` |
+
+- 心跳：客户端每 30s 发送 `{ type: 'ping' }`，服务器回复 `{ type: 'pong' }`
+- 断线检测：连接关闭后显示 "Disconnected — reconnecting..."
+- 指数退避：重连间隔 1s→2s→4s→8s→10s（上限），连接成功后重置
+- 状态恢复：重连成功后自动请求 session list + tools list，processing 中断时显示提示
+
+### 版本与收尾
+- `src/core/constants.ts`：VERSION `0.1.85` → `0.1.86`
+- `package.json`：version 同步
+- 构建验证：`npm run build` 零错误（ESM + CJS 双产物）
+- Web UI 预览测试：/help 新命令显示、/memory 卡片渲染、/export 空 session 提示、心跳状态 全部通过
+
+---
+
 ## 本轮开发完成记录（2026-03-16，v0.1.84 → v0.1.85）
 
 ### Web UI P1 增强：侧边栏 Tools Tab + Diff 语法高亮
@@ -1978,10 +2031,10 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 |---|------|------|------|
 | P1-1 | **侧边栏增强** | [x] | Sessions/Tools 双 Tab + Built-in Tools（危险级别圆点）+ MCP Servers（连接状态+工具数）+ Skills 列表 + 搜索过滤 |
 | P1-2 | **Diff 渲染增强** | [x] | confirm 对话框 diff 语法高亮（绿色增行、红色删行、紫色 hunk header、灰色上下文） |
-| P1-3 | **更多命令支持** | [~] | `/cost`、`/session list\|load\|delete` 已实现；待增加 `/undo`、`/export [md\|json]`、`/tools`、`/memory` |
-| P1-4 | **键盘快捷键** | [ ] | `Ctrl+L` 清屏、`Ctrl+K` 清空输入、`Esc` 停止生成、`↑` 历史消息回溯 |
-| P1-5 | **Markdown 导出** | [ ] | 一键导出当前对话为 `.md` 文件下载 |
-| P1-6 | **断线重连恢复** | [ ] | WebSocket 重连后恢复 session 状态（当前重连=全丢）；心跳 ping/pong |
+| P1-3 | **更多命令支持** | [x] | `/export [md\|json]`（浏览器下载）、`/memory [show\|add\|clear]`、`/tools`、`/cost`、`/session` |
+| P1-4 | **键盘快捷键** | [x] | `Ctrl+L` 清屏、`Ctrl+K` 清空输入、`Esc` 停止生成、`↑↓` 历史消息回溯（50 条） |
+| P1-5 | **Markdown 导出** | [x] | `/export md` 一键导出对话为 `.md` 文件浏览器下载、`/export json` 导出 JSON |
+| P1-6 | **断线重连恢复** | [x] | 30s 心跳 ping/pong、指数退避重连（1s→2s→4s→10s）、重连后状态恢复提示 |
 
 ### P2 — 差异化功能（Web 独有优势）
 

package/dist/{chunk-QHZGVP5X.js → chunk-PCT4OP6Q.js}

@@ -16,7 +16,7 @@ import {
   SUBAGENT_MAX_ROUNDS_LIMIT,
   VERSION,
   runTestsTool
-} from "./chunk-VR7VECPG.js";
+} from "./chunk-SMLN357K.js";
 
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";

package/dist/{chunk-VR7VECPG.js → chunk-SMLN357K.js}

@@ -14,7 +14,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.1.85";
+var VERSION = "0.1.86";
 var APP_NAME = "ai-cli";
 var CONFIG_DIR_NAME = ".aicli";
 var CONFIG_FILE_NAME = "config.json";

package/dist/index.js

@@ -35,7 +35,7 @@ import {
   theme,
   truncateOutput,
   undoStack
-} from "./chunk-QHZGVP5X.js";
+} from "./chunk-PCT4OP6Q.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -55,7 +55,7 @@ import {
   REPO_URL,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-VR7VECPG.js";
+} from "./chunk-SMLN357K.js";
 
 // src/index.ts
 import { program } from "commander";
@@ -1904,7 +1904,7 @@ ${hint}` : "")
       description: "Run project tests and show structured report",
       usage: "/test [command|filter]",
       async execute(args, _ctx) {
-        const { executeTests } = await import("./run-tests-IFXCV4UW.js");
+        const { executeTests } = await import("./run-tests-Y2PN5FYJ.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -5292,7 +5292,7 @@ program.command("web").description("Start Web UI server with browser-based chat
     console.error("Error: Invalid port number. Must be between 1 and 65535.");
     process.exit(1);
   }
-  const { startWebServer } = await import("./server-2LECXHO6.js");
+  const { startWebServer } = await import("./server-BFNZIL3O.js");
   await startWebServer({ port, host: options.host });
 });
 program.command("sessions").description("List recent conversation sessions").action(async () => {

package/dist/{run-tests-IFXCV4UW.js → run-tests-Y2PN5FYJ.js}

@@ -2,7 +2,7 @@
 import {
   executeTests,
   runTestsTool
-} from "./chunk-VR7VECPG.js";
+} from "./chunk-SMLN357K.js";
 export {
   executeTests,
   runTestsTool

package/dist/{server-2LECXHO6.js → server-BFNZIL3O.js}

@@ -23,7 +23,7 @@ import {
   setupProxy,
   spawnAgentContext,
   truncateOutput
-} from "./chunk-QHZGVP5X.js";
+} from "./chunk-PCT4OP6Q.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   CONTEXT_FILE_CANDIDATES,
@@ -36,7 +36,7 @@ import {
   SKILLS_DIR_NAME,
   VERSION,
   __require
-} from "./chunk-VR7VECPG.js";
+} from "./chunk-SMLN357K.js";
 
 // src/web/server.ts
 import express from "express";
@@ -390,7 +390,7 @@ function loadMemoryContent(configDir) {
 }
 
 // src/web/session-handler.ts
-import { existsSync as existsSync3, readFileSync as readFileSync3 } from "fs";
+import { existsSync as existsSync3, readFileSync as readFileSync3, appendFileSync, writeFileSync, mkdirSync } from "fs";
 import { join as join2, resolve } from "path";
 var MAX_TOOL_ROUNDS = 25;
 var FREE_ROUND_TOOLS = /* @__PURE__ */ new Set(["write_todos"]);
@@ -962,6 +962,10 @@ Tokens: in=${this.sessionTokenUsage.inputTokens} out=${this.sessionTokenUsage.ou
             "  /status              \u2014 Show session info & token usage",
             "  /cost                \u2014 Show cumulative token usage",
             "  /tools               \u2014 Show tools, MCP servers & skills in sidebar",
+            "  /export [md|json]    \u2014 Export conversation as Markdown or JSON",
+            "  /memory              \u2014 Show persistent memory contents",
+            "  /memory add <text>   \u2014 Add entry to persistent memory",
+            "  /memory clear        \u2014 Clear persistent memory",
             "  /help                \u2014 Show this help message",
             "",
             "\u{1F4A1} Tips:",
@@ -969,7 +973,9 @@ Tokens: in=${this.sessionTokenUsage.inputTokens} out=${this.sessionTokenUsage.ou
             "  \u2022 Drag & drop or Ctrl+V to paste images",
             "  \u2022 Type @ to reference files from your project",
             "  \u2022 Use Shift+Enter for multi-line input",
-            "  \u2022 During AI processing, type to send corrections"
+            "  \u2022 During AI processing, type to send corrections",
+            "  \u2022 Ctrl+L to clear screen, Esc to stop generation",
+            "  \u2022 \u2191/\u2193 arrow keys to recall previous messages"
           ].join("\n")
         });
         break;
@@ -989,6 +995,22 @@ Tokens: in=${this.sessionTokenUsage.inputTokens} out=${this.sessionTokenUsage.ou
       case "tools":
         this.sendToolsList();
         break;
+      case "export": {
+        const format = args[0] === "json" ? "json" : "md";
+        this.exportConversation(format);
+        break;
+      }
+      case "memory": {
+        const sub = args[0];
+        if (sub === "add" && args.length > 1) {
+          this.memoryAdd(args.slice(1).join(" "));
+        } else if (sub === "clear") {
+          this.memoryClear();
+        } else {
+          this.memoryShow();
+        }
+        break;
+      }
       default:
         this.send({ type: "error", message: `Unknown command: /${name}. Type /help for available commands.` });
     }
@@ -1072,6 +1094,90 @@ Tokens: in=${this.sessionTokenUsage.inputTokens} out=${this.sessionTokenUsage.ou
       skills
     });
   }
+  exportConversation(format) {
+    const session = this.sessions.current;
+    if (!session || session.messages.length === 0) {
+      this.send({ type: "info", message: "No messages to export." });
+      return;
+    }
+    const title = session.title ?? "Untitled";
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
+    if (format === "json") {
+      const data = {
+        title,
+        provider: this.currentProvider,
+        model: this.currentModel,
+        exported: (/* @__PURE__ */ new Date()).toISOString(),
+        messages: session.messages.map((m) => ({
+          role: m.role,
+          content: getContentText(m.content),
+          timestamp: m.timestamp?.toISOString()
+        }))
+      };
+      this.send({
+        type: "export_data",
+        format: "json",
+        filename: `aicli-${timestamp}.json`,
+        content: JSON.stringify(data, null, 2)
+      });
+    } else {
+      const lines = [`# ${title}`, "", `> Exported: ${(/* @__PURE__ */ new Date()).toLocaleString()} | Provider: ${this.currentProvider} | Model: ${this.currentModel}`, ""];
+      for (const m of session.messages) {
+        const text = getContentText(m.content);
+        if (m.role === "user") {
+          lines.push(`## \u{1F9D1} User`, "", text, "");
+        } else if (m.role === "assistant") {
+          lines.push(`## \u{1F916} Assistant`, "", text, "");
+        }
+      }
+      this.send({
+        type: "export_data",
+        format: "md",
+        filename: `aicli-${timestamp}.md`,
+        content: lines.join("\n")
+      });
+    }
+  }
+  memoryShow() {
+    const configDir = this.config.getConfigDir();
+    const memPath = join2(configDir, MEMORY_FILE_NAME);
+    let content = "";
+    try {
+      if (existsSync3(memPath)) {
+        content = readFileSync3(memPath, "utf-8");
+      }
+    } catch {
+    }
+    this.send({
+      type: "memory_content",
+      content: content || "(empty \u2014 no persistent memory entries yet)",
+      filePath: memPath
+    });
+  }
+  memoryAdd(text) {
+    const configDir = this.config.getConfigDir();
+    const memPath = join2(configDir, MEMORY_FILE_NAME);
+    try {
+      mkdirSync(configDir, { recursive: true });
+      const timestamp = (/* @__PURE__ */ new Date()).toISOString().slice(0, 19).replace("T", " ");
+      appendFileSync(memPath, `
+- [${timestamp}] ${text}
+`, "utf-8");
+      this.send({ type: "info", message: `\u{1F4DD} Memory entry added: "${text}"` });
+    } catch (err) {
+      this.send({ type: "error", message: `Failed to write memory: ${err.message}` });
+    }
+  }
+  memoryClear() {
+    const configDir = this.config.getConfigDir();
+    const memPath = join2(configDir, MEMORY_FILE_NAME);
+    try {
+      writeFileSync(memPath, "", "utf-8");
+      this.send({ type: "info", message: "\u{1F5D1}\uFE0F Persistent memory cleared." });
+    } catch (err) {
+      this.send({ type: "error", message: `Failed to clear memory: ${err.message}` });
+    }
+  }
   sendSessionMessages() {
     const session = this.sessions.current;
     if (!session) return;
@@ -1329,7 +1435,15 @@ async function startWebServer(options = {}) {
     activeHandler = handler;
     ws.on("message", async (data) => {
       try {
-        await handler.handleMessage(data.toString());
+        const raw = data.toString();
+        const parsed = JSON.parse(raw);
+        if (parsed.type === "ping") {
+          if (ws.readyState === ws.OPEN) {
+            ws.send(JSON.stringify({ type: "pong" }));
+          }
+          return;
+        }
+        await handler.handleMessage(raw);
       } catch (err) {
         const message = err instanceof Error ? err.message : String(err);
         console.error(`   Error: ${message}`);

package/dist/web/client/app.js

@@ -14,6 +14,9 @@ let currentThinkingEl = null;
 let currentThinkingContent = '';
 let providers = [];
 let pendingImages = []; // { name, data (base64), mime }
+let inputHistory = []; // Previous user inputs for ↑/↓ navigation
+let historyIndex = -1; // -1 = not browsing history
+let savedInputDraft = ''; // Saved current input when entering history mode
 
 // ── DOM refs ───────────────────────────────────────────────────────
 
@@ -56,22 +59,41 @@ marked.setOptions({
 
 // ── WebSocket ──────────────────────────────────────────────────────
 
+let heartbeatTimer = null;
+let reconnectDelay = 1000; // Start at 1s, exponential backoff
+
 function connect() {
   const protocol = location.protocol === 'https:' ? 'wss:' : 'ws:';
   ws = new WebSocket(`${protocol}//${location.host}`);
 
   ws.onopen = () => {
     connected = true;
+    reconnectDelay = 1000; // Reset backoff on success
     connectionStatus.textContent = '🟢 Connected';
     connectionStatus.className = 'status-connected';
     requestSessionList();
+    // Start heartbeat ping every 30s
+    clearInterval(heartbeatTimer);
+    heartbeatTimer = setInterval(() => {
+      if (ws && ws.readyState === WebSocket.OPEN) {
+        ws.send(JSON.stringify({ type: 'ping' }));
+      }
+    }, 30000);
+    // If we had a session & were processing, reset UI state
+    if (processing) {
+      setProcessing(false);
+      addInfoMessage('⚡ Reconnected — previous generation may have been interrupted.');
+    }
   };
 
   ws.onclose = () => {
     connected = false;
-    connectionStatus.textContent = '🔴 Disconnected';
+    clearInterval(heartbeatTimer);
+    connectionStatus.textContent = '🔴 Disconnected — reconnecting...';
     connectionStatus.className = 'status-disconnected';
-    setTimeout(connect, 3000);
+    // Exponential backoff: 1s, 2s, 4s, max 10s
+    setTimeout(connect, reconnectDelay);
+    reconnectDelay = Math.min(reconnectDelay * 2, 10000);
   };
 
   ws.onerror = () => {
@@ -81,7 +103,9 @@ function connect() {
 
   ws.onmessage = (event) => {
     try {
-      handleServerMessage(JSON.parse(event.data));
+      const msg = JSON.parse(event.data);
+      if (msg.type === 'pong') return; // Heartbeat response, ignore
+      handleServerMessage(msg);
     } catch (e) {
       console.error('Failed to parse message:', e);
     }
@@ -113,6 +137,8 @@ function handleServerMessage(msg) {
     case 'session_list':    renderSessionList(msg.sessions); break;
     case 'session_messages':renderSessionMessages(msg.messages); break;
     case 'tools_list':      renderToolsList(msg); switchSidebarTab('tools'); break;
+    case 'export_data':     handleExportData(msg); break;
+    case 'memory_content':  handleMemoryContent(msg); break;
     case 'info':            addInfoMessage(msg.message); break;
     case 'error':           addErrorMessage(msg.message); setProcessing(false); break;
     case 'round_progress':  break;
@@ -519,6 +545,12 @@ async function sendMessage() {
     const args = parts.slice(1);
     send({ type: 'command', name, args });
     addInfoMessage(`/${text.slice(1)}`);
+    // Track command in history
+    if (inputHistory[inputHistory.length - 1] !== text) {
+      inputHistory.push(text);
+      if (inputHistory.length > 50) inputHistory.shift();
+    }
+    historyIndex = -1;
     userInput.value = '';
     userInput.style.height = 'auto';
     return;
@@ -545,6 +577,14 @@ async function sendMessage() {
     }
   }
 
+  // Track input history
+  if (inputHistory[inputHistory.length - 1] !== text) {
+    inputHistory.push(text);
+    if (inputHistory.length > 50) inputHistory.shift();
+  }
+  historyIndex = -1;
+  savedInputDraft = '';
+
   addUserMessage(text, pendingImages);
   const msg = { type: 'chat', content: resolvedText };
   if (pendingImages.length > 0) {
@@ -936,6 +976,72 @@ userInput.addEventListener('keydown', (e) => {
     }
   }
 
+  // ── Keyboard shortcuts ───────────────────────────────────────
+
+  // Escape: stop generation
+  if (e.key === 'Escape') {
+    if (processing) {
+      e.preventDefault();
+      send({ type: 'abort' });
+      return;
+    }
+  }
+
+  // Ctrl+L: clear screen (keep welcome)
+  if (e.key === 'l' && (e.ctrlKey || e.metaKey)) {
+    e.preventDefault();
+    const welcome = messagesEl.querySelector('.chat');
+    messagesEl.innerHTML = '';
+    if (welcome) messagesEl.appendChild(welcome);
+    return;
+  }
+
+  // Ctrl+K: clear input
+  if (e.key === 'k' && (e.ctrlKey || e.metaKey)) {
+    e.preventDefault();
+    userInput.value = '';
+    userInput.style.height = 'auto';
+    return;
+  }
+
+  // ↑/↓: input history navigation (only when input is empty or browsing history, single-line)
+  if (e.key === 'ArrowUp' && !e.shiftKey) {
+    const isAtStart = userInput.selectionStart === 0 && userInput.selectionEnd === 0;
+    const isSingleLine = !userInput.value.includes('\n');
+    if ((isSingleLine || userInput.value === '') && (isAtStart || userInput.value === '')) {
+      if (inputHistory.length > 0) {
+        e.preventDefault();
+        if (historyIndex === -1) {
+          savedInputDraft = userInput.value;
+          historyIndex = inputHistory.length - 1;
+        } else if (historyIndex > 0) {
+          historyIndex--;
+        }
+        userInput.value = inputHistory[historyIndex] || '';
+        userInput.style.height = 'auto';
+        userInput.style.height = Math.min(userInput.scrollHeight, 200) + 'px';
+        return;
+      }
+    }
+  }
+
+  if (e.key === 'ArrowDown' && !e.shiftKey) {
+    if (historyIndex >= 0) {
+      e.preventDefault();
+      if (historyIndex < inputHistory.length - 1) {
+        historyIndex++;
+        userInput.value = inputHistory[historyIndex] || '';
+      } else {
+        historyIndex = -1;
+        userInput.value = savedInputDraft;
+      }
+      userInput.style.height = 'auto';
+      userInput.style.height = Math.min(userInput.scrollHeight, 200) + 'px';
+      return;
+    }
+  }
+
+  // Enter: send message
   if (e.key === 'Enter' && !e.shiftKey) {
     e.preventDefault();
     sendMessage();
@@ -1015,6 +1121,34 @@ userInput.addEventListener('paste', (e) => {
   }
 });
 
+// ── Export & Memory handlers ────────────────────────────────────────
+
+function handleExportData(msg) {
+  // Trigger browser download
+  const blob = new Blob([msg.content], { type: msg.format === 'json' ? 'application/json' : 'text/markdown' });
+  const url = URL.createObjectURL(blob);
+  const a = document.createElement('a');
+  a.href = url;
+  a.download = msg.filename;
+  document.body.appendChild(a);
+  a.click();
+  document.body.removeChild(a);
+  URL.revokeObjectURL(url);
+  addInfoMessage(`📥 Exported: ${msg.filename}`);
+}
+
+function handleMemoryContent(msg) {
+  const el = document.createElement('div');
+  el.className = 'msg-assistant my-2';
+  el.innerHTML = `
+    <div class="text-xs opacity-50 mb-1">📝 Persistent Memory</div>
+    <pre class="text-sm whitespace-pre-wrap opacity-80">${escapeHtml(msg.content)}</pre>
+    <div class="text-xs opacity-30 mt-1">${escapeHtml(msg.filePath)}</div>
+  `;
+  messagesEl.appendChild(el);
+  scrollToBottom();
+}
+
 // ── Initialize ─────────────────────────────────────────────────────
 
 // Restore theme

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "jinzd-ai-cli",
-  "version": "0.1.85",
+  "version": "0.1.86",
   "description": "Cross-platform REPL-style AI CLI with multi-provider support",
   "type": "module",
   "main": "./dist/index.js",