jinzd-ai-cli 0.1.82 → 0.1.84

package/CLAUDE.md

@@ -2,7 +2,7 @@
 
 ## 项目简介
 
-一个跨平台的 REPL 风格 AI 对话工具，支持多个主流 AI 提供商（OpenAI、Claude、Gemini、DeepSeek、智谱清言、Kimi），
+一个跨平台的 REPL 风格 AI 对话工具，支持多个主流 AI 提供商（OpenAI、Claude、Gemini、DeepSeek、智谱清言、Kimi、OpenRouter），
 带有 **AI 工具调用（Agentic）** 能力，支持执行 bash 命令、读写文件、运行交互式程序、流式生成大文档。
 代理支持（`proxy` 配置字段 + 环境变量），Gemini 完整支持（2.5 Pro/Flash，array items schema 修复）。
 **MCP 协议支持**：可接入外部 MCP 服务器，自动发现并注册工具，无缝融入 agentic 循环。
@@ -32,6 +32,7 @@ src/
 │   ├── claude.ts                   # Anthropic SDK provider
 │   ├── gemini.ts                   # Google Generative AI provider（role: assistant → model）
 │   ├── openai.ts                   # OpenAI provider（GPT-5.4/5/4.1/4o/o3/o4-mini）
+│   ├── openrouter.ts               # OpenRouter provider（多模型聚合，16 个热门模型）
 │   ├── deepseek.ts / zhipu.ts / kimi.ts  # 继承 OpenAICompatibleProvider；deepseek/kimi 覆写 chatWithTools 实现虚假声明检测
 ├── config/
 │   ├── schema.ts                   # Zod schema（含 timeouts / customBaseUrls / defaultModels）
@@ -165,6 +166,7 @@ AICLI_API_KEY_GEMINI     Gemini API Key
 AICLI_API_KEY_DEEPSEEK   DeepSeek API Key
 AICLI_API_KEY_ZHIPU      智谱 API Key
 AICLI_API_KEY_KIMI       Kimi API Key
+AICLI_API_KEY_OPENROUTER OpenRouter API Key
 AICLI_API_KEY_GOOGLESEARCH  Google Custom Search API Key
 AICLI_GOOGLE_CX          Google Search Engine ID (cx)
 AICLI_PROVIDER           默认 Provider ID
@@ -350,6 +352,44 @@ 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.82 → v0.1.83）
+
+### 新增功能：OpenRouter 内置 Provider
+
+**背景**：OpenRouter 是多模型聚合 API 平台，提供统一的 OpenAI 兼容接口访问数百个模型。用户可通过单个 API Key 使用来自 Anthropic、OpenAI、Google、Meta、DeepSeek、Qwen、Mistral 等厂商的模型。
+
+**实现**：继承 `OpenAICompatibleProvider`，无需覆写任何方法（API 完全兼容）。
+
+| 文件 | 变更类型 | 说明 |
+|------|---------|------|
+| `src/providers/openrouter.ts` | **新增** | OpenRouterProvider 类，16 个热门模型 |
+| `src/providers/registry.ts` | 修改 | BUILT_IN_PROVIDERS 新增 OpenRouterProvider |
+| `src/config/env-loader.ts` | 修改 | ENV_KEY_MAP 新增 `openrouter → AICLI_API_KEY_OPENROUTER` |
+| `src/repl/setup-wizard.ts` | 修改 | PROVIDERS 列表新增 OpenRouter |
+| `src/core/constants.ts` | 修改 | VERSION 0.1.82 → 0.1.83 |
+| `package.json` | 修改 | version 0.1.82 → 0.1.83 |
+
+**内置模型列表（16 个）**：
+- Anthropic：Claude Opus 4 / Sonnet 4 / Haiku 4
+- OpenAI：GPT-5.4 / GPT-4o / GPT-4o Mini
+- Google：Gemini 2.5 Pro / Flash
+- Meta：Llama 4 Maverick / Scout
+- DeepSeek：V3 0324 / R1
+- Qwen：Qwen3 Coder / Qwen 2.5 72B
+- Mistral：Large / Small 3.1 24B
+
+**Web UI 无需修改**：Web UI 采用动态注册架构，provider 列表通过 WebSocket S2C_Status 从后端 ProviderRegistry 动态获取，自动支持新 Provider。
+
+**同步更新 CLAUDE.md**：项目简介、项目结构、环境变量、Web UI 路线图（P0 全部标记已完成）。
+
+### 版本与收尾
+- `src/core/constants.ts`：VERSION `0.1.82` → `0.1.83`
+- `package.json`：version 同步
+- 构建验证：`npm run build` 零错误（ESM + CJS 双产物）
+- 发布：`npm publish` → `jinzd-ai-cli@0.1.83`
+
+---
+
 ## 本轮开发完成记录（2026-03-10，v0.1.57 → v0.1.58）
 
 ### 代码质量修复：19 个低危问题修复 + 代码重构
@@ -1860,7 +1900,7 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 
 > 目标：将 `aicli web` 从"可用的聊天界面"升级为功能完备、体验出色的 AI 代码助手 Web 端。
 
-### 当前 Web UI 已实现功能（v0.1.76 基线）
+### 当前 Web UI 已实现功能（v0.1.82 基线）
 
 - 实时流式聊天（WebSocket）
 - 完整 Agentic 循环（25 轮工具调用 + 流式工具调用）
@@ -1871,27 +1911,30 @@ const stdinLines = Array.isArray(rawStdin) ? rawStdin.map(String)
 - Plan Mode 只读规划
 - Markdown 渲染 + 代码高亮（marked.js + highlight.js）
 - 代码块复制按钮
-- 图片上传协议支持（C2S `images` 字段）
 - 用户纠偏（interjection）— 处理中可发送纠正指令
-- /clear /compact /think /plan /status /provider /model 命令
+- Session 持久化与管理（侧边栏列表、新建/切换/恢复/删除会话）
+- `@文件` 引用（`@` 触发文件选择下拉、目录遍历、服务端文件读取 API）
+- 图片拖拽/粘贴上传（D&D + Ctrl+V + 预览缩略图 + 10MB 限制）
+- 工具卡片折叠（safe 默认折叠、write/destructive 展开、可手动 toggle）
+- /clear /compact /think /plan /status /provider /model /cost /session /help 命令
 
-### P0 — 最痛问题（当前就会遇到）
+### P0 — 最痛问题（全部已完成 ✅）
 
 | # | 功能 | 状态 | 说明 |
 |---|------|------|------|
-| P0-1 | **Session 持久化与管理** | [ ] | 刷新页面不丢对话；会话列表侧边栏；新建/切换/恢复/删除会话；历史搜索 |
-| P0-2 | **`@文件` 引用** | [ ] | CLI 支持 `@file.ts` 读文件注入上下文，Web 需要：`@` 触发文件选择 + 服务端文件读取 API |
-| P0-3 | **图片拖拽/粘贴上传** | [ ] | 协议层已有 `images` 字段，缺少客户端 UI：拖拽到输入区 + `Ctrl+V` 粘贴截图 + 预览缩略图 |
-| P0-4 | **工具卡片折叠** | [ ] | 多轮工具调用后聊天区被淹没；safe 级别默认折叠、write/destructive 展开；可手动 toggle |
-| P0-5 | **`/help` 命令** | [ ] | 显示所有支持的 Web 命令及用法说明；输入不存在的命令给出提示 |
+| P0-1 | **Session 持久化与管理** | [x] | 侧边栏会话列表 + 新建/切换/恢复/删除 + JSON 持久化 |
+| P0-2 | **`@文件` 引用** | [x] | `@` 触发文件选择下拉 + `/api/file-content` 读取 + 路径穿越安全检查 |
+| P0-3 | **图片拖拽/粘贴上传** | [x] | D&D + Ctrl+V 粘贴 + 预览缩略图 + base64 传输 + 10MB 限制 |
+| P0-4 | **工具卡片折叠** | [x] | safe 默认折叠、write/destructive 展开、手动 toggle、结果 badge |
+| P0-5 | **`/help` 命令** | [x] | 显示所有支持的 Web 命令及用法说明 |
 
 ### P1 — 明显提升体验
 
 | # | 功能 | 状态 | 说明 |
 |---|------|------|------|
-| P1-1 | **侧边栏布局** | [ ] | 左侧：Session 列表 + Skills + MCP 工具列表 + 搜索；右侧：聊天区；响应式 mobile 折叠 |
+| P1-1 | **侧边栏增强** | [x] | Session 列表已实现；待增加 Skills + MCP 工具列表 + 搜索 |
 | P1-2 | **Diff 渲染增强** | [ ] | confirm 对话框中的 diff 从纯文本升级为语法高亮的 diff 视图（绿/红增删行） |
-| P1-3 | **更多命令支持** | [ ] | `/cost`（token 用量统计）、`/session list\|load`、`/undo`、`/export [md\|json]`、`/tools`（工具列表） |
+| 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 |

package/dist/{chunk-53QOLO5G.js → chunk-L2PQET5S.js}

@@ -16,7 +16,7 @@ import {
   SUBAGENT_MAX_ROUNDS_LIMIT,
   VERSION,
   runTestsTool
-} from "./chunk-FT3ADEOO.js";
+} from "./chunk-YHB3S2KS.js";
 
 // src/config/config-manager.ts
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
@@ -161,6 +161,7 @@ var ENV_KEY_MAP = {
   zhipu: "AICLI_API_KEY_ZHIPU",
   kimi: "AICLI_API_KEY_KIMI",
   openai: "AICLI_API_KEY_OPENAI",
+  openrouter: "AICLI_API_KEY_OPENROUTER",
   "google-search": "AICLI_API_KEY_GOOGLESEARCH"
 };
 var EnvLoader = class {
@@ -1890,6 +1891,124 @@ var OpenAIProvider = class extends OpenAICompatibleProvider {
   };
 };
 
+// src/providers/openrouter.ts
+var OpenRouterProvider = class extends OpenAICompatibleProvider {
+  defaultBaseUrl = "https://openrouter.ai/api/v1";
+  info = {
+    id: "openrouter",
+    displayName: "OpenRouter",
+    defaultModel: "anthropic/claude-sonnet-4",
+    apiKeyEnvVar: "AICLI_API_KEY_OPENROUTER",
+    requiresApiKey: true,
+    baseUrl: this.defaultBaseUrl,
+    models: [
+      // Anthropic Claude 系列
+      {
+        id: "anthropic/claude-opus-4",
+        displayName: "Claude Opus 4",
+        contextWindow: 2e5,
+        supportsStreaming: true
+      },
+      {
+        id: "anthropic/claude-sonnet-4",
+        displayName: "Claude Sonnet 4",
+        contextWindow: 2e5,
+        supportsStreaming: true
+      },
+      {
+        id: "anthropic/claude-haiku-4",
+        displayName: "Claude Haiku 4",
+        contextWindow: 2e5,
+        supportsStreaming: true
+      },
+      // OpenAI 系列
+      {
+        id: "openai/gpt-5.4",
+        displayName: "GPT-5.4",
+        contextWindow: 105e4,
+        supportsStreaming: true
+      },
+      {
+        id: "openai/gpt-4o",
+        displayName: "GPT-4o",
+        contextWindow: 128e3,
+        supportsStreaming: true
+      },
+      {
+        id: "openai/gpt-4o-mini",
+        displayName: "GPT-4o Mini",
+        contextWindow: 128e3,
+        supportsStreaming: true
+      },
+      // Google Gemini 系列
+      {
+        id: "google/gemini-2.5-pro",
+        displayName: "Gemini 2.5 Pro",
+        contextWindow: 1048576,
+        supportsStreaming: true
+      },
+      {
+        id: "google/gemini-2.5-flash",
+        displayName: "Gemini 2.5 Flash",
+        contextWindow: 1048576,
+        supportsStreaming: true
+      },
+      // Meta Llama 系列
+      {
+        id: "meta-llama/llama-4-maverick",
+        displayName: "Llama 4 Maverick",
+        contextWindow: 1048576,
+        supportsStreaming: true
+      },
+      {
+        id: "meta-llama/llama-4-scout",
+        displayName: "Llama 4 Scout",
+        contextWindow: 512e3,
+        supportsStreaming: true
+      },
+      // DeepSeek 系列
+      {
+        id: "deepseek/deepseek-chat-v3-0324",
+        displayName: "DeepSeek V3 0324",
+        contextWindow: 131072,
+        supportsStreaming: true
+      },
+      {
+        id: "deepseek/deepseek-r1",
+        displayName: "DeepSeek R1",
+        contextWindow: 163840,
+        supportsStreaming: true
+      },
+      // Qwen 系列
+      {
+        id: "qwen/qwen3-coder",
+        displayName: "Qwen3 Coder",
+        contextWindow: 262144,
+        supportsStreaming: true
+      },
+      {
+        id: "qwen/qwen-2.5-72b-instruct",
+        displayName: "Qwen 2.5 72B",
+        contextWindow: 131072,
+        supportsStreaming: true
+      },
+      // Mistral 系列
+      {
+        id: "mistralai/mistral-large",
+        displayName: "Mistral Large",
+        contextWindow: 131072,
+        supportsStreaming: true
+      },
+      {
+        id: "mistralai/mistral-small-3.1-24b-instruct",
+        displayName: "Mistral Small 3.1 24B",
+        contextWindow: 128e3,
+        supportsStreaming: true
+      }
+    ]
+  };
+};
+
 // src/providers/custom.ts
 var CustomProvider = class extends OpenAICompatibleProvider {
   defaultBaseUrl;
@@ -1931,7 +2050,8 @@ var BUILT_IN_PROVIDERS = [
   DeepSeekProvider,
   ZhipuProvider,
   KimiProvider,
-  OpenAIProvider
+  OpenAIProvider,
+  OpenRouterProvider
 ];
 var ProviderRegistry = class {
   providers = /* @__PURE__ */ new Map();

package/dist/{chunk-FT3ADEOO.js → chunk-YHB3S2KS.js}

@@ -14,7 +14,7 @@ import { platform } from "os";
 import chalk from "chalk";
 
 // src/core/constants.ts
-var VERSION = "0.1.82";
+var VERSION = "0.1.84";
 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-53QOLO5G.js";
+} from "./chunk-L2PQET5S.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   AUTHOR,
@@ -55,7 +55,7 @@ import {
   REPO_URL,
   SKILLS_DIR_NAME,
   VERSION
-} from "./chunk-FT3ADEOO.js";
+} from "./chunk-YHB3S2KS.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-UZ7FHZMQ.js");
+        const { executeTests } = await import("./run-tests-V2VE7ST5.js");
         const argStr = args.join(" ").trim();
         let testArgs = {};
         if (argStr) {
@@ -2894,7 +2894,8 @@ var PROVIDERS = [
   { value: "deepseek", name: "DeepSeek" },
   { value: "zhipu", name: "Zhipu (GLM)" },
   { value: "kimi", name: "Kimi (Moonshot AI)" },
-  { value: "openai", name: "OpenAI" }
+  { value: "openai", name: "OpenAI" },
+  { value: "openrouter", name: "OpenRouter" }
 ];
 function maskKey(key) {
   if (key.length <= 10) return "****";
@@ -5291,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-XNXTXMUH.js");
+  const { startWebServer } = await import("./server-XWSMOXVH.js");
   await startWebServer({ port, host: options.host });
 });
 program.command("sessions").description("List recent conversation sessions").action(async () => {

package/dist/{run-tests-UZ7FHZMQ.js → run-tests-V2VE7ST5.js}

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

package/dist/{server-XNXTXMUH.js → server-XWSMOXVH.js}

@@ -23,7 +23,7 @@ import {
   setupProxy,
   spawnAgentContext,
   truncateOutput
-} from "./chunk-53QOLO5G.js";
+} from "./chunk-L2PQET5S.js";
 import {
   AGENTIC_BEHAVIOR_GUIDELINE,
   CONTEXT_FILE_CANDIDATES,
@@ -36,7 +36,7 @@ import {
   SKILLS_DIR_NAME,
   VERSION,
   __require
-} from "./chunk-FT3ADEOO.js";
+} from "./chunk-YHB3S2KS.js";
 
 // src/web/server.ts
 import express from "express";
@@ -1322,7 +1322,7 @@ async function startWebServer(options = {}) {
   process.on("SIGINT", () => {
     console.log("\n   Shutting down...");
     if (activeHandler) activeHandler.onDisconnect();
-    if (mcpManager) mcpManager.disconnectAll();
+    if (mcpManager) mcpManager.closeAll();
     wss.close();
     server.close();
     process.exit(0);

package/package.json

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