jinzd-ai-cli 0.4.71 → 0.4.73

package/dist/chunk-LR7IV4SK.js

@@ -0,0 +1,318 @@
+#!/usr/bin/env node
+import {
+  ConfigError,
+  EnvLoader
+} from "./chunk-2ZD3YTVM.js";
+import {
+  CONFIG_DIR_NAME,
+  CONFIG_FILE_NAME,
+  HISTORY_DIR_NAME,
+  PLUGINS_DIR_NAME
+} from "./chunk-T2OUKQOX.js";
+
+// src/config/config-manager.ts
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { join } from "path";
+import { homedir } from "os";
+
+// src/config/schema.ts
+import { z } from "zod";
+var CustomModelSchema = z.object({
+  id: z.string(),
+  displayName: z.string().optional(),
+  contextWindow: z.number().optional()
+});
+var CustomProviderConfigSchema = z.object({
+  id: z.string(),
+  // 唯一 ID，不能与内置 provider 重名
+  displayName: z.string(),
+  // 显示名称
+  apiKey: z.string().optional(),
+  // 可选：直接在此写 key（也可通过 apiKeys 字段或环境变量提供）
+  baseUrl: z.string(),
+  // OpenAI 兼容 API 的 base URL（必填）
+  defaultModel: z.string(),
+  // 默认使用的模型 ID
+  models: z.array(CustomModelSchema).default([]),
+  timeout: z.number().optional()
+  // 请求超时（ms），覆盖全局默认值
+});
+var ModelParamsSchema = z.object({
+  temperature: z.number().min(0).max(2).optional(),
+  maxTokens: z.number().int().positive().optional(),
+  timeout: z.number().int().positive().optional(),
+  /** 是否启用深度思考（thinking）模式，Claude Sonnet/Opus、GLM-5 等 */
+  thinking: z.boolean().optional(),
+  /** thinking 模式的 token 预算（最小 1024，仅 Claude Extended Thinking 使用） */
+  thinkingBudget: z.number().int().min(1024).optional()
+});
+var UserProfileSchema = z.object({
+  /** 真实姓名（如 "Jin Zhengdong"） */
+  name: z.string().optional(),
+  /** 昵称/称呼偏好（如 "东叔"），AI 会以此称呼你 */
+  nickname: z.string().optional(),
+  /** 职业角色（如 "Full-stack developer"、"Data scientist"） */
+  role: z.string().optional(),
+  /** 个人简介 / 专长描述（1-3 句话） */
+  bio: z.string().optional(),
+  /** 兴趣领域或技术栈（如 ["TypeScript", "Rust", "AI/ML"]） */
+  interests: z.array(z.string()).default([]),
+  /** 语言偏好（如 "zh-CN"、"en"），AI 将据此选择交流语言 */
+  locale: z.string().optional(),
+  /** 自定义人设补充（自由格式，直接注入 system prompt） */
+  extra: z.string().optional()
+}).default({});
+var ConfigSchema = z.object({
+  version: z.string().default("1.0.0"),
+  // 用户身份档案 — 跨 Provider 的 "灵魂"
+  userProfile: UserProfileSchema,
+  defaultProvider: z.string().default("claude"),
+  // 每个 provider 的默认模型（key 为 provider ID）
+  defaultModels: z.record(z.string()).default({}),
+  // API Keys：放宽为任意 record，支持自定义 provider ID
+  apiKeys: z.record(z.string()).default({}),
+  customBaseUrls: z.record(z.string()).default({}),
+  // Per-provider timeout in ms (e.g. { deepseek: 60000 })
+  // ⚠️  Timeout 优先级说明（L5）：
+  //   1. modelParams[modelId].timeout  — 最高优先级，精确到具体模型（如 deepseek-reasoner 需要更长超时）
+  //   2. timeouts[providerId]          — Provider 级默认，覆盖内置默认值
+  //   3. 内置 Provider 的硬编码默认值  — 最低兜底（如 OpenAI 兼容系列默认 60000ms）
+  //   实现位置：src/providers/registry.ts initialize()，将 timeouts[id] 注入 provider
+  timeouts: z.record(z.number()).default({}),
+  // HTTP/HTTPS 代理地址（Node.js 不自动使用系统代理，需显式配置）
+  // 例：http://127.0.0.1:10809
+  // 也可通过环境变量 HTTPS_PROXY / HTTP_PROXY 覆盖
+  proxy: z.string().optional(),
+  // 自定义 Provider 列表（OpenAI 兼容接口，无需改代码）
+  customProviders: z.array(CustomProviderConfigSchema).default([]),
+  // 按模型 ID 存储的推理参数（key 为模型 ID，如 "deepseek-chat"）
+  modelParams: z.record(ModelParamsSchema).default({}),
+  ui: z.object({
+    streaming: z.boolean().default(true),
+    markdownRendering: z.boolean().default(true),
+    showTokenCount: z.boolean().default(true),
+    /** 桌面通知阈值（毫秒）：AI 任务耗时超过此值时发送系统通知。0 = 禁用。默认 10000 (10s) */
+    notificationThreshold: z.number().default(1e4),
+    /** 终端输出折行宽度。0 = 自动（使用终端宽度），>0 = 固定列宽。默认 0 */
+    wordWrap: z.number().int().min(0).default(0),
+    /** 颜色主题：'dark'（默认）| 'light' | 'custom' */
+    theme: z.enum(["dark", "light", "custom"]).default("dark"),
+    /** 自定义颜色覆盖（仅在 theme='custom' 时生效）。值为 chalk 颜色名或 '#hex'，支持 'bold.cyan' 组合 */
+    colors: z.object({
+      prompt: z.string().optional(),
+      info: z.string().optional(),
+      warning: z.string().optional(),
+      error: z.string().optional(),
+      success: z.string().optional(),
+      dim: z.string().optional(),
+      accent: z.string().optional(),
+      toolCall: z.string().optional(),
+      toolResult: z.string().optional(),
+      heading: z.string().optional()
+    }).optional()
+  }).default({}),
+  session: z.object({
+    autoSave: z.boolean().default(true),
+    maxHistoryDays: z.number().default(30),
+    systemPrompt: z.string().optional()
+  }).default({}),
+  // 项目上下文文件配置
+  // 启动时自动读取并注入 system prompt，类似 Claude Code 的 CLAUDE.md 机制
+  // 默认按顺序查找：AICLI.md → CLAUDE.md → .aicli/context.md
+  // 设为 false 可禁用此功能
+  contextFile: z.union([z.string(), z.literal(false)]).default("auto"),
+  // Google Custom Search API 的 Search Engine ID (cx 参数)
+  // API Key 通过 apiKeys['google-search'] 或 AICLI_API_KEY_GOOGLESEARCH 环境变量配置
+  // CX 也可通过 AICLI_GOOGLE_CX 环境变量覆盖
+  googleSearchEngineId: z.string().optional(),
+  // MCP (Model Context Protocol) 服务器配置
+  // 声明外部 MCP 服务器，启动时自动连接、发现工具并注册
+  // 配置格式兼容 Claude Desktop（command + args + env）
+  // 示例：{ "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path"] } }
+  mcpServers: z.record(z.object({
+    command: z.string(),
+    args: z.array(z.string()).default([]),
+    env: z.record(z.string()).optional(),
+    timeout: z.number().default(3e4)
+  })).default({}),
+  // 工具执行钩子（shell 命令，模板变量：{tool} {dangerLevel} {args} {status}）
+  hooks: z.object({
+    preToolExecution: z.string().optional(),
+    postToolExecution: z.string().optional()
+  }).optional(),
+  // 工具权限规则（按顺序匹配第一个生效）
+  permissionRules: z.array(z.object({
+    tool: z.string(),
+    action: z.enum(["auto-approve", "deny", "confirm"]),
+    when: z.object({
+      dangerLevel: z.enum(["safe", "write", "destructive"]).optional(),
+      pathPattern: z.string().optional()
+    }).optional()
+  })).default([]),
+  // 无规则匹配时的默认权限动作
+  defaultPermission: z.enum(["auto-approve", "deny", "confirm"]).default("confirm"),
+  // 自动上下文压缩开关
+  // 当对话估算 token 数超过模型 contextWindow 的 80% 时，自动触发 compact 压缩旧消息
+  // 默认开启。设为 false 则仅在手动 /compact 时压缩
+  autoCompact: z.boolean().default(true),
+  // Agentic 工具调用循环单次对话最大轮次（默认 200）。
+  // 超过此值后 AI 被强制停止调用工具并生成总结。
+  // 建议范围：25（保守）~ 1000（宽松，接近 Claude Code）。
+  // CLI `--max-tool-rounds <n>` 可覆盖此值。
+  maxToolRounds: z.number().int().min(1).max(1e4).default(200),
+  // Auto-pause checkpoint：Agentic 循环每隔多少轮暂停一次，让用户确认方向或中途介入。
+  // 默认 50；设为 0 禁用（完全自动执行到完成或 maxToolRounds 用尽）。
+  // CLI 与 Web UI 行为一致：CLI 用 readline question 提示，Web UI 弹出对话框。
+  autoPauseInterval: z.number().int().min(0).max(1e4).default(50),
+  // 单次工具输出（如 read_file、bash、grep_files）返回给 AI 的最大字符数上限。
+  // 默认 500_000 (~500K chars ≈ 6000-8000 行代码)。
+  // 实际上限还会受模型 contextWindow 动态约束（取 contextWindow/4 作为下限）。
+  // 设置为 0 或未配置时使用默认值；不建议设为小于 12_000 或大于模型 contextWindow/2。
+  maxToolOutputChars: z.number().int().min(0).default(5e5),
+  // 月度成本预算（USD）。
+  // 设置后，每次 AI 回复后会跟踪成本，接近或超过预算时在 /status 和 /cost 中显示警告。
+  // 默认 0 = 不限制。例：50 表示每月最多花 $50。
+  monthlyBudget: z.number().min(0).default(0),
+  // 插件加载开关（安全控制）
+  // 默认 false：不自动加载 ~/.aicli/plugins/ 中的插件文件。
+  // 插件以完整 Node.js 权限在主进程中执行（可读写文件、访问网络、执行命令），
+  // 必须确认插件来源可信后，再设为 true 启用。
+  // 可通过 /config 命令或直接编辑 ~/.aicli/config.json 开启。
+  allowPlugins: z.boolean().default(false),
+  // 智能模型路由（v0.4.68+）
+  // 按用户每轮输入的内容/标签/长度动态选择模型，在同一 provider 内切换，
+  // 例：短问题走 haiku（省钱），planning 走 opus（质量）。
+  // enabled=false 时永远返回当前模型。rules 按顺序匹配，首个命中的规则生效。
+  // 每个 rule 的 match 必须至少有一个条件（tag/contains/maxLength/minLength）。
+  // 详见 src/core/model-router.ts。
+  routing: z.object({
+    enabled: z.boolean().default(false),
+    rules: z.array(z.object({
+      match: z.object({
+        contains: z.array(z.string()).optional(),
+        maxLength: z.number().int().positive().optional(),
+        minLength: z.number().int().positive().optional(),
+        tag: z.string().optional()
+      }),
+      model: z.string(),
+      name: z.string().optional()
+    })).default([]),
+    fallback: z.string().optional()
+  }).default({ enabled: false, rules: [] })
+});
+
+// src/config/config-manager.ts
+var ConfigManager = class {
+  configDir;
+  configPath;
+  config;
+  constructor(configDir) {
+    this.configDir = configDir ?? join(homedir(), CONFIG_DIR_NAME);
+    this.configPath = join(this.configDir, CONFIG_FILE_NAME);
+    this.config = this.load();
+  }
+  load() {
+    if (!existsSync(this.configPath)) {
+      return ConfigSchema.parse({});
+    }
+    try {
+      const raw = JSON.parse(readFileSync(this.configPath, "utf-8"));
+      return ConfigSchema.parse(raw);
+    } catch (err) {
+      throw new ConfigError(
+        `Config file at ${this.configPath} is invalid. Delete it and run 'ai-cli config' to recreate.
+${err}`
+      );
+    }
+  }
+  save() {
+    mkdirSync(this.configDir, { recursive: true });
+    writeFileSync(this.configPath, JSON.stringify(this.config, null, 2), "utf-8");
+  }
+  getApiKey(providerId) {
+    const envKey = EnvLoader.getApiKey(providerId);
+    if (envKey) return envKey;
+    return this.config.apiKeys[providerId];
+  }
+  setApiKey(providerId, key) {
+    this.config.apiKeys[providerId] = key;
+    this.save();
+  }
+  get(key) {
+    return this.config[key];
+  }
+  set(key, value) {
+    this.config[key] = value;
+    this.save();
+  }
+  /**
+   * 仅修改内存中的配置值，不持久化到磁盘。
+   * 用于 CLI 命令行参数覆盖（-p, -m, --no-stream），使其只对当前进程生效。
+   */
+  setTransient(key, value) {
+    this.config[key] = value;
+  }
+  isFirstRun() {
+    return !existsSync(this.configPath);
+  }
+  getConfigDir() {
+    return this.configDir;
+  }
+  getHistoryDir() {
+    return join(this.configDir, HISTORY_DIR_NAME);
+  }
+  getPluginsDir() {
+    return join(this.configDir, PLUGINS_DIR_NAME);
+  }
+  getDefaultProvider() {
+    return EnvLoader.getDefaultProvider() ?? this.config.defaultProvider;
+  }
+  /** 点分路径读取配置值，如 `ui.theme` → config.ui.theme */
+  getByPath(path) {
+    const keys = path.split(".");
+    let current = this.config;
+    for (const key of keys) {
+      if (current == null || typeof current !== "object") return void 0;
+      current = current[key];
+    }
+    return current;
+  }
+  /** 点分路径写入配置值，自动类型转换（boolean/number/string）并持久化 */
+  setByPath(path, rawValue) {
+    const keys = path.split(".");
+    if (keys.length === 0) return;
+    let value = rawValue;
+    if (rawValue === "true") value = true;
+    else if (rawValue === "false") value = false;
+    else if (rawValue !== "" && !isNaN(Number(rawValue))) value = Number(rawValue);
+    const draft = JSON.parse(JSON.stringify(this.config));
+    let current = draft;
+    for (let i = 0; i < keys.length - 1; i++) {
+      const key = keys[i];
+      if (current[key] == null || typeof current[key] !== "object") {
+        current[key] = {};
+      }
+      current = current[key];
+    }
+    current[keys[keys.length - 1]] = value;
+    const result = ConfigSchema.safeParse(draft);
+    if (!result.success) {
+      const firstErr = result.error.errors[0];
+      throw new ConfigError(`Invalid config value for "${path}": ${firstErr?.message ?? "validation failed"}`);
+    }
+    this.config = result.data;
+    this.save();
+  }
+  /** 获取完整配置对象的格式化 JSON 字符串（用于 /config show 等展示） */
+  toFormattedJSON() {
+    return JSON.stringify(this.config, null, 2);
+  }
+  /** 获取完整配置对象（JSON 兼容的原始对象） */
+  toJSON() {
+    return structuredClone(this.config);
+  }
+};
+
+export {
+  ConfigManager
+};

package/dist/chunk-T2OUKQOX.js

@@ -0,0 +1,155 @@
+#!/usr/bin/env node
+
+// src/core/constants.ts
+var VERSION = "0.4.73";
+var APP_NAME = "ai-cli";
+var CONFIG_DIR_NAME = ".aicli";
+var CONFIG_FILE_NAME = "config.json";
+var HISTORY_DIR_NAME = "history";
+var PLUGINS_DIR_NAME = "plugins";
+var SKILLS_DIR_NAME = "skills";
+var CUSTOM_COMMANDS_DIR_NAME = "commands";
+var CONTEXT_FILE_CANDIDATES = ["AICLI.md", "CLAUDE.md"];
+var MEMORY_FILE_NAME = "memory.md";
+var MEMORY_MAX_CHARS = 1e4;
+var DEV_STATE_FILE_NAME = "dev-state.md";
+var DEFAULT_MAX_TOKENS = 8192;
+var DEFAULT_MAX_TOOL_ROUNDS = 200;
+var DEFAULT_MAX_TOOL_OUTPUT_CHARS_CAP = 5e5;
+var MCP_TOOL_PREFIX = "mcp__";
+var MCP_PROJECT_CONFIG_NAME = ".mcp.json";
+var MCP_CONNECT_TIMEOUT = 3e4;
+var MCP_CALL_TIMEOUT = 6e4;
+var MCP_PROTOCOL_VERSION = "2024-11-05";
+var PLAN_MODE_READONLY_TOOLS = /* @__PURE__ */ new Set([
+  "read_file",
+  "list_dir",
+  "grep_files",
+  "glob_files",
+  "web_fetch",
+  "google_search",
+  "ask_user",
+  // 允许：可向用户澄清需求
+  "write_todos"
+  // 允许：可输出任务列表作为实施计划
+]);
+var PLAN_MODE_SYSTEM_ADDON = `# \u{1F50D} Plan Mode \u2014 Read-Only Planning Mode
+
+You are currently in read-only planning (Plan) mode.
+
+**Allowed tools**: read_file \xB7 list_dir \xB7 grep_files \xB7 glob_files \xB7 web_fetch \xB7 google_search \xB7 ask_user \xB7 write_todos
+**Disabled tools**: bash \xB7 write_file \xB7 edit_file \xB7 run_interactive \xB7 save_last_response \xB7 save_memory and all MCP tools
+
+**Your task**:
+1. Use read-only tools to thoroughly analyze the codebase, file structure, and existing implementation
+2. Use ask_user to clarify any ambiguous requirements with the user
+3. Develop a detailed implementation plan (you may use write_todos to present the task list), including:
+   - List of files to be modified or created
+   - Specific changes for each file
+   - Execution order and dependencies
+   - Potential risks and considerations
+
+**CRITICAL RULES**:
+- Do NOT attempt to call bash, write_file, edit_file, or any disabled tool \u2014 they will fail silently.
+- Do NOT write shell commands, SQL queries, or code in your text response as a substitute for tool calls \u2014 the user's system will misinterpret this as a pseudo-tool-call error.
+- If the user asks you to run commands, test connections, or modify files, respond with: "This requires execution tools. Please type \`/plan execute\` to switch to execute mode, then I can perform these operations."
+- Do NOT call write_todos repeatedly with the same content \u2014 call it once, then give a text response.
+- Focus your analysis on reading files and producing actionable plans.
+
+Once planning is complete, clearly inform the user: type \`/plan execute\` to begin executing the plan, or \`/plan exit\` to discard it.`;
+var SUBAGENT_DEFAULT_MAX_ROUNDS = 15;
+var SUBAGENT_MAX_ROUNDS_LIMIT = 30;
+var SUBAGENT_ALLOWED_TOOLS = /* @__PURE__ */ new Set([
+  "bash",
+  "read_file",
+  "write_file",
+  "edit_file",
+  "list_dir",
+  "grep_files",
+  "glob_files",
+  "run_interactive",
+  "web_fetch",
+  "google_search",
+  "write_todos",
+  "run_tests"
+]);
+var CONTEXT_PRESSURE_THRESHOLD = 0.8;
+var TEST_TIMEOUT = 3e5;
+var AGENTIC_BEHAVIOR_GUIDELINE = `# Important Behavioral Guidelines
+
+**Respond appropriately to the user's intent \u2014 do NOT over-react**:
+- For **greetings and casual chat** (e.g., "hello", "hi", "hey", "\u4F60\u597D", "what's up"): respond naturally with a friendly greeting. Do NOT use any tools. Do NOT explore directories, read files, or start any project work. Just chat.
+- When the user asks you to "read", "understand", "review", "analyze", "examine", or "look at" files or a project, your task is only to **read and summarize**, then wait for the user's next instruction. Do not automatically start executing tasks described in the project.
+- Only begin using write/execute tools when the user **explicitly requests** an action (e.g., "generate", "create", "modify", "run", "start", etc.).
+- Project context files (CLAUDE.md, AICLI.md) provide background information about the project. They are NOT instructions to start working. Only use them as reference when the user asks a project-related question or task.
+- If you are unsure about the user's intent, use the ask_user tool to confirm with the user, rather than assuming and executing on your own.
+- **Do NOT abuse ask_user for redundant confirmations**: When the user has already given a clear, explicit instruction (e.g., "write lesson 142", "generate file X", "create the report"), execute it immediately. Do NOT ask "are you sure?" or request details that can be found in project documents. Repeatedly asking the user to confirm wastes their time and is extremely frustrating. Only use ask_user when critical information is genuinely missing and cannot be inferred from context files.`;
+function buildUserIdentityPrompt(profile) {
+  const lines = [];
+  const displayName = profile.nickname || profile.name;
+  if (displayName) {
+    lines.push(`The user's name is **${profile.name || displayName}**${profile.nickname && profile.name ? ` (prefers to be called **${profile.nickname}**)` : ""}.`);
+  }
+  if (profile.role) {
+    lines.push(`Role: ${profile.role}.`);
+  }
+  if (profile.bio) {
+    lines.push(`About: ${profile.bio}`);
+  }
+  if (profile.interests && profile.interests.length > 0) {
+    lines.push(`Interests & expertise: ${profile.interests.join(", ")}.`);
+  }
+  if (profile.locale) {
+    lines.push(`Preferred language: ${profile.locale}. Please respond in this language unless the user explicitly uses another language.`);
+  }
+  if (profile.extra) {
+    lines.push(`
+${profile.extra}`);
+  }
+  if (lines.length === 0) return null;
+  return `# Who You're Talking To
+
+${lines.join("\n")}
+
+Address the user personally and adapt your communication style to their background. This identity persists across all conversations and all AI providers.`;
+}
+var AUTHOR = "Jin Zhengdong";
+var AUTHOR_EMAIL = "zhengdong.jin@gmail.com";
+var DESCRIPTION = "Cross-platform REPL-style AI conversation tool with multi-provider and agentic tool calling support";
+var REPO_URL = "https://github.com/jinzhengdong/ai-cli";
+
+export {
+  VERSION,
+  APP_NAME,
+  CONFIG_DIR_NAME,
+  CONFIG_FILE_NAME,
+  HISTORY_DIR_NAME,
+  PLUGINS_DIR_NAME,
+  SKILLS_DIR_NAME,
+  CUSTOM_COMMANDS_DIR_NAME,
+  CONTEXT_FILE_CANDIDATES,
+  MEMORY_FILE_NAME,
+  MEMORY_MAX_CHARS,
+  DEV_STATE_FILE_NAME,
+  DEFAULT_MAX_TOKENS,
+  DEFAULT_MAX_TOOL_ROUNDS,
+  DEFAULT_MAX_TOOL_OUTPUT_CHARS_CAP,
+  MCP_TOOL_PREFIX,
+  MCP_PROJECT_CONFIG_NAME,
+  MCP_CONNECT_TIMEOUT,
+  MCP_CALL_TIMEOUT,
+  MCP_PROTOCOL_VERSION,
+  PLAN_MODE_READONLY_TOOLS,
+  PLAN_MODE_SYSTEM_ADDON,
+  SUBAGENT_DEFAULT_MAX_ROUNDS,
+  SUBAGENT_MAX_ROUNDS_LIMIT,
+  SUBAGENT_ALLOWED_TOOLS,
+  CONTEXT_PRESSURE_THRESHOLD,
+  TEST_TIMEOUT,
+  AGENTIC_BEHAVIOR_GUIDELINE,
+  buildUserIdentityPrompt,
+  AUTHOR,
+  AUTHOR_EMAIL,
+  DESCRIPTION,
+  REPO_URL
+};