zapmyco 0.6.0 → 0.8.0

package/dist/cli/index.mjs

@@ -1,18 +1,19 @@
 #!/usr/bin/env node
-import { D as eventBus, F as __require, M as APP_NAME, N as SESSION_DIR_NAME, O as buildSkillSnapshot, P as __VERSION__, a as SubAgentManager, c as logger, g as ZapmycoErrorCode, k as loadSkills, m as WebError, s as configureLogger, t as loadConfig, v as createLlmBasedAgent } from "../loader-CyGlMdl7.mjs";
+import { B as APP_NAME, E as createLlmBasedAgent, F as eventBus, H as VERSION, I as buildSkillSnapshot, L as loadSkills, S as WebError, U as __require, V as SESSION_DIR_NAME, g as logger, h as configureLogger, i as AgentLlmFacade, n as loadConfig, p as SubAgentManager, t as HOME_CONFIG_PATH, w as ZapmycoErrorCode } from "../loader-C_55Y7Q_.mjs";
 import { createHash, randomBytes } from "node:crypto";
-import { mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
+import { mkdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
 import { mkdir, readFile, rename, writeFile } from "node:fs/promises";
 import * as os from "node:os";
-import { homedir } from "node:os";
+import { homedir, tmpdir } from "node:os";
 import * as path from "node:path";
 import { dirname, isAbsolute, join, normalize, resolve } from "node:path";
 import { EventEmitter } from "node:events";
+import { getModels, getProviders } from "@mariozechner/pi-ai";
 import chalk, { Chalk } from "chalk";
 import { Command } from "commander";
-import { getModel } from "@mariozechner/pi-ai";
-import { CombinedAutocompleteProvider, Container, Editor, Key, ProcessTerminal, TUI, matchesKey, truncateToWidth, wrapTextWithAnsi } from "@mariozechner/pi-tui";
-import { spawn } from "node:child_process";
+import { spawn, spawnSync } from "node:child_process";
+import { CombinedAutocompleteProvider, Container, Editor, Input, Key, ProcessTerminal, SelectList, TUI, getKeybindings, matchesKey, truncateToWidth, wrapTextWithAnsi } from "@mariozechner/pi-tui";
+import i18next from "i18next";
 import TurndownService from "turndown";
 import { lookup } from "node:dns/promises";
 import { Client } from "@modelcontextprotocol/sdk/client";
@@ -140,14 +141,73 @@ function createClearCommand() {
 //#endregion
 //#region src/cli/repl/commands/config-cmd.ts
 /**
+* /config 命令
+*
+* 查看和修改当前配置信息。
+*/
+/** 判断 key 是否可能触发原型污染 */
+function isPrototypePollutionKey(key) {
+	return key === "__proto__" || key === "constructor" || key === "prototype";
+}
+function getByDotPath(obj, path) {
+	const keys = path.split(".");
+	let current = obj;
+	for (const key of keys) {
+		if (current === null || current === void 0 || typeof current !== "object") return;
+		if (isPrototypePollutionKey(key)) return;
+		current = current[key];
+	}
+	return current;
+}
+/**
+* 通过 dot-path 设置嵌套对象属性（自动创建中间对象）
+*/
+function setByDotPath(obj, path, value) {
+	const keys = path.split(".");
+	let current = obj;
+	for (let i = 0; i < keys.length - 1; i++) {
+		const key = keys[i];
+		if (isPrototypePollutionKey(key)) return;
+		if (!(key in current) || typeof current[key] !== "object" || current[key] === null) current[key] = {};
+		current = current[key];
+	}
+	const lastKey = keys[keys.length - 1];
+	if (isPrototypePollutionKey(lastKey)) return;
+	current[lastKey] = value;
+}
+/**
+* 更新 settings.json 中指定 dot-path 的值
+*/
+function updateSettingsFile(path, value) {
+	try {
+		const raw = readFileSync(HOME_CONFIG_PATH, "utf-8");
+		const config = JSON.parse(raw);
+		let parsedValue = value;
+		try {
+			parsedValue = JSON.parse(value);
+		} catch {}
+		setByDotPath(config, path, parsedValue);
+		writeFileSync(HOME_CONFIG_PATH, JSON.stringify(config, null, 2) + "\n", "utf-8");
+		return {
+			success: true,
+			message: ""
+		};
+	} catch (err) {
+		return {
+			success: false,
+			message: err instanceof Error ? err.message : String(err)
+		};
+	}
+}
+/**
 * 创建 config 命令定义
 */
 function createConfigCommand() {
 	return {
 		name: "config",
 		aliases: ["cfg"],
-		description: "查看配置 [show | get <key>]",
-		usage: "/config [show | get <key>]",
+		description: "查看或修改配置 [show | get <key> | set <key> <value>]",
+		usage: "/config [show | get <key> | set <key> <value>]",
 		handler(args, session) {
 			const config = session.config;
 			const renderer = session.getRenderer();
@@ -161,9 +221,9 @@ function createConfigCommand() {
 				if (value !== void 0) {
 					const displayValue = args[1].toLowerCase().includes("apikey") || args[1].toLowerCase().includes("api_key") ? "***已配置***" : JSON.stringify(value, null, 2);
 					session.appendOutput([
-						``,
+						"",
 						`  ${args[1]}: ${displayValue}`,
-						``
+						""
 					]);
 				} else session.appendOutput([
 					"",
@@ -173,28 +233,40 @@ function createConfigCommand() {
 				]);
 				return;
 			}
+			if (args[0] === "set" && args[1] && args[2] !== void 0) {
+				const key = args[1];
+				const value = args.slice(2).join(" ");
+				const result = updateSettingsFile(key, value);
+				if (result.success) {
+					let parsedValue = value;
+					try {
+						parsedValue = JSON.parse(value);
+					} catch {}
+					setByDotPath(session.config, key, parsedValue);
+					session.applyConfigUpdate(key);
+					const displayValue = key.toLowerCase().includes("apikey") || key.toLowerCase().includes("api_key") ? "***已配置***" : value;
+					session.appendOutput([
+						"",
+						`  ✅ 配置已更新: ${key} = ${displayValue}`,
+						`  已持久化到 ${HOME_CONFIG_PATH}`,
+						""
+					]);
+				} else session.appendOutput([
+					"",
+					`  ❌ 配置更新失败: ${result.message}`,
+					""
+				]);
+				return;
+			}
 			session.appendOutput([
 				"",
-				"  用法: /config [show | get <key>]",
+				"  用法: /config [show | get <key> | set <key> <value>]",
+				"  示例: /config set llm.providers.deepseek.apiKey sk-xxx",
 				""
 			]);
 		}
 	};
 }
-/**
-* 通过 dot-path 获取嵌套对象属性
-*
-* 例如: getByPath(config, 'llm.provider') → config.llm.provider
-*/
-function getByDotPath(obj, path) {
-	const keys = path.split(".");
-	let current = obj;
-	for (const key of keys) {
-		if (current === null || current === void 0 || typeof current !== "object") return;
-		current = current[key];
-	}
-	return current;
-}
 
 //#endregion
 //#region src/cli/repl/commands/help.ts
@@ -294,6 +366,1263 @@ function createQuitCommand() {
 	};
 }
 
+//#endregion
+//#region src/i18n/locales/en.json
+var en_default = {
+	output: {
+		"welcome": "Welcome back!",
+		"error": {
+			"executionFailed": "Execution failed:",
+			"detail": "Details:"
+		},
+		"result": {
+			"title": "Execution Complete",
+			"goal": "Goal:",
+			"status": "Status:",
+			"success": "Success",
+			"partialSuccess": "Partial Success",
+			"failed": "Failed",
+			"duration": "Duration:",
+			"token": "Token:",
+			"cost": "Cost:",
+			"taskBreakdown": "Task Breakdown",
+			"subtaskCount": "subtasks",
+			"artifacts": "Artifacts:",
+			"suggestions": "Suggestions:"
+		},
+		"taskGraph": {
+			"title": "Task Breakdown Overview",
+			"total": "{{count}} subtasks, {{layers}} parallel layers",
+			"layer": "Layer {{index}} (parallel):"
+		},
+		"agents": {
+			"title": "Registered Agents",
+			"empty": "No registered agents",
+			"id": "ID",
+			"status": "Status",
+			"load": "Load",
+			"capability": "Capabilities"
+		},
+		"config": {
+			"title": "Current Configuration",
+			"llm": "LLM:",
+			"defaultModel": "Default Model:",
+			"provider": "Provider:",
+			"modelId": "Model ID:",
+			"inputType": "Input Type:",
+			"apiKey": "API Key:",
+			"apiKeyConfigured": "***Configured***",
+			"apiKeyNotConfigured": "(Not configured)",
+			"apiFormat": "API Format:",
+			"scheduler": "Scheduler:",
+			"maxConcurrency": "Max Concurrency:",
+			"maxPerAgent": "Max Per Agent:",
+			"taskTimeout": "Task Timeout:",
+			"maxRetries": "Max Retries:",
+			"cli": "CLI:",
+			"colorEnabled": "Enabled",
+			"colorDisabled": "Disabled",
+			"debugEnabled": "Enabled",
+			"debugDisabled": "Disabled",
+			"outputFormat": "Output Format:",
+			"uiLanguage": "UI Language:",
+			"agents": "Agents:",
+			"minutes": "min"
+		},
+		"history": {
+			"title": "Session History",
+			"empty": "No history yet"
+		},
+		"status": {
+			"title": "Session Status",
+			"idle": "Idle",
+			"executing": "Executing",
+			"closing": "Closing",
+			"state": "State:",
+			"totalRequests": "Total Requests:",
+			"success": "Success:",
+			"failure": "Failure:",
+			"tokenConsumption": "Token Usage:",
+			"totalCost": "Total Cost:"
+		}
+	},
+	dialog: {
+		"footer": {
+			"search": "Type to search  ·  ↑↓ Navigate  ·  Enter Confirm  ·  Esc Cancel",
+			"normal": "k/j ↑↓ Navigate  ·  / Search  ·  Enter Select  ·  Esc/q Quit  ·  BS/h Back",
+			"searchNarrow": "Enter Confirm  ·  Esc Cancel",
+			"normalNarrow": "↑↓=k/j  /  Enter  Esc/q  BS/h",
+			"textInput": "Enter to confirm · Esc to cancel"
+		},
+		"configView": {
+			"narrow": "q/Esc Back",
+			"wide": "q/Esc Back  ·  Enter/BS/h Back to Menu"
+		}
+	},
+	settings: {
+		"mainMenu": {
+			"defaultModel": "Default Model",
+			"manageProviders": "Manage Providers",
+			"viewConfig": "View Config",
+			"language": "Language / 语言",
+			"notConfigured": "not configured",
+			"nConfigured": "{{count}} configured",
+			"noneConfigured": "none configured",
+			"displayFullConfig": "Display full configuration details"
+		},
+		"apiKeyConfig": {
+			"useEnvVar": "Use env var",
+			"useEnvVarDesc": "Recommended — more secure",
+			"enterManually": "Enter manually",
+			"enterManuallyDesc": "Type the key directly (stored in plaintext in settings.json)",
+			"clear": "Clear",
+			"clearDesc": "Remove the configured key"
+		},
+		"providerActions": {
+			"configureApiKey": "Configure API Key",
+			"selectModel": "Select Model",
+			"baseUrl": "Base URL",
+			"setAsDefault": "Set as Default"
+		},
+		"providerEntry": {
+			"keyConfigured": "key configured",
+			"noKey": "no key",
+			"addProvider": "Add Provider",
+			"addProviderDesc": "Select from a list of known providers",
+			"apiFormat": "API format: {{format}}",
+			"openaiCompatible": "OpenAI compatible"
+		},
+		"addProvider": {
+			"yes": "Yes, configure API Key now",
+			"yesDesc": "Go to API Key settings",
+			"later": "Later",
+			"laterDesc": "Return to main menu"
+		},
+		"messages": {
+			"apiKeyCleared": "[ok] Cleared API key for {{provider}}",
+			"apiKeySetToEnv": "[ok] Set {{provider}} API key to env var ${ {{envVar}} }",
+			"envVarNote": "Make sure {{envVar}} is set in your shell",
+			"apiKeyConfigured": "[ok] Configured API key for {{provider}}",
+			"modelSelected": "[ok] Selected model: {{model}}",
+			"providerAdded": "[ok] Added provider: {{provider}}",
+			"baseUrlReset": "[ok] Reset {{provider}} Base URL to default",
+			"baseUrlSet": "[ok] Set {{provider}} Base URL: {{url}}",
+			"defaultModelSet": "[ok] Default model set to: {{model}}",
+			"languageSet": "[ok] Language set to: {{locale}}",
+			"restartRequired": "Some changes may require a session restart to take full effect.",
+			"noModels": "has no available model list",
+			"configureManually": "Configure models manually in settings.json or check the provider name",
+			"alreadyExists": "already exists, use the provider entry to configure it",
+			"configureFirst": "Configure a model first before setting it as default",
+			"checkApiKeyHelpPrefix": "  Hint: check"
+		},
+		"cliMode": {
+			"usage": "Usage:",
+			"settingsUsage": "/settings                    — Open interactive configuration menu",
+			"listProvidersUsage": "/settings list-providers     — List all known providers",
+			"listModelsUsage": "/settings list-models <name> — List available models for a provider",
+			"knownProviders": "Known providers:",
+			"noModelsAvailable": "No models available from pi-ai registry",
+			"hintConfigureFirst": "Hint: use /settings to configure this provider first",
+			"availableModels": "available models:"
+		},
+		"modelSelector": { "notConfigured": "Not configured - Enter to set API Key" }
+	},
+	session: {
+		"welcome": "ZapMyco: Welcome back!",
+		"errorPrefix": "[Error]",
+		"agentErrorMessage": "Agent execution failed (no detailed error information)",
+		"noContentError": "Model returned no content, please check your API Key configuration",
+		"displayName": "Zapmyco AI Assistant",
+		"editorNotFound": "Editor not found: {{cmd}}, please set $EDITOR environment variable",
+		"editorFailed": "Failed to open editor: {{message}}",
+		"executing": "Executing...",
+		"setEnvVarHint": "Set environment variable: export {{envVar}}=<your-api-key>",
+		"useConfigHint": "Or use in REPL: /config set llm.providers.{{provider}}.apiKey <your-key>"
+	}
+};
+
+//#endregion
+//#region src/i18n/locales/zh-CN.json
+var zh_CN_default = {
+	output: {
+		"welcome": "欢迎回来！",
+		"error": {
+			"executionFailed": "执行失败:",
+			"detail": "详情:"
+		},
+		"result": {
+			"title": "执行完成",
+			"goal": "目标:",
+			"status": "状态:",
+			"success": "成功",
+			"partialSuccess": "部分成功",
+			"failed": "失败",
+			"duration": "耗时:",
+			"token": "Token:",
+			"cost": "成本:",
+			"taskBreakdown": "任务拆分",
+			"subtaskCount": "个子任务",
+			"artifacts": "制品:",
+			"suggestions": "建议:"
+		},
+		"taskGraph": {
+			"title": "任务拆分概览",
+			"total": "共 {{count}} 个子任务，{{layers}} 层并行",
+			"layer": "第 {{index}} 层 (可并行):"
+		},
+		"agents": {
+			"title": "已注册 Agent",
+			"empty": "暂无已注册的 Agent",
+			"id": "ID",
+			"status": "状态",
+			"load": "负载",
+			"capability": "能力"
+		},
+		"config": {
+			"title": "当前配置",
+			"llm": "LLM:",
+			"defaultModel": "默认模型:",
+			"provider": "提供商:",
+			"modelId": "模型 ID:",
+			"inputType": "输入类型:",
+			"apiKey": "API Key:",
+			"apiKeyConfigured": "***已配置***",
+			"apiKeyNotConfigured": "(未配置)",
+			"apiFormat": "API 格式:",
+			"scheduler": "调度器:",
+			"maxConcurrency": "最大并行:",
+			"maxPerAgent": "单 Agent 最大并发:",
+			"taskTimeout": "任务超时:",
+			"maxRetries": "最大重试:",
+			"cli": "CLI:",
+			"colorEnabled": "开启",
+			"colorDisabled": "关闭",
+			"debugEnabled": "开启",
+			"debugDisabled": "关闭",
+			"outputFormat": "输出格式:",
+			"uiLanguage": "UI 语言:",
+			"agents": "Agents:",
+			"minutes": "分钟"
+		},
+		"history": {
+			"title": "会话历史",
+			"empty": "暂无历史记录"
+		},
+		"status": {
+			"title": "会话状态",
+			"idle": "空闲",
+			"executing": "执行中",
+			"closing": "关闭中",
+			"state": "状态:",
+			"totalRequests": "总请求数:",
+			"success": "成功:",
+			"failure": "失败:",
+			"tokenConsumption": "Token 消耗:",
+			"totalCost": "总成本:"
+		}
+	},
+	dialog: {
+		"footer": {
+			"search": "输入文字搜索  ·  ↑↓ 导航  ·  Enter 确认  ·  Esc 取消",
+			"normal": "k/j ↑↓ 导航  ·  / 搜索  ·  Enter 选择  ·  Esc/q 退出  ·  BS/h 返回",
+			"searchNarrow": "Enter 确认  ·  Esc 取消",
+			"normalNarrow": "↑↓=k/j  /  Enter  Esc/q  BS/h",
+			"textInput": "Enter to confirm · Esc to cancel"
+		},
+		"configView": {
+			"narrow": "q/Esc 返回",
+			"wide": "q/Esc 返回  ·  Enter/BS/h 返回菜单"
+		}
+	},
+	settings: {
+		"mainMenu": {
+			"defaultModel": "默认模型",
+			"manageProviders": "管理提供商",
+			"viewConfig": "查看配置",
+			"language": "Language / 语言",
+			"notConfigured": "未配置",
+			"nConfigured": "已配置 {{count}} 个",
+			"noneConfigured": "未配置",
+			"displayFullConfig": "显示完整配置详情"
+		},
+		"apiKeyConfig": {
+			"useEnvVar": "使用环境变量",
+			"useEnvVarDesc": "推荐 — 更安全",
+			"enterManually": "手动输入",
+			"enterManuallyDesc": "直接输入密钥（以明文存储在 settings.json 中）",
+			"clear": "清除",
+			"clearDesc": "移除已配置的密钥"
+		},
+		"providerActions": {
+			"configureApiKey": "配置 API Key",
+			"selectModel": "选择模型",
+			"baseUrl": "Base URL",
+			"setAsDefault": "设为默认"
+		},
+		"providerEntry": {
+			"keyConfigured": "已配置密钥",
+			"noKey": "无密钥",
+			"addProvider": "添加提供商",
+			"addProviderDesc": "从已知提供商列表中选择",
+			"apiFormat": "API 格式: {{format}}",
+			"openaiCompatible": "OpenAI 兼容"
+		},
+		"addProvider": {
+			"yes": "是，立即配置 API Key",
+			"yesDesc": "前往 API Key 设置",
+			"later": "稍后",
+			"laterDesc": "返回主菜单"
+		},
+		"messages": {
+			"apiKeyCleared": "[ok] 已清除 {{provider}} 的 API Key",
+			"apiKeySetToEnv": "[ok] {{provider}} 的 API Key 已设置为环境变量 ${ {{envVar}} }",
+			"envVarNote": "请确保 {{envVar}} 已在 shell 中设置",
+			"apiKeyConfigured": "[ok] 已配置 {{provider}} 的 API Key",
+			"modelSelected": "[ok] 已选择模型: {{model}}",
+			"providerAdded": "[ok] 已添加提供商: {{provider}}",
+			"baseUrlReset": "[ok] 已重置 {{provider}} 的 Base URL 为默认值",
+			"baseUrlSet": "[ok] 已设置 {{provider}} 的 Base URL: {{url}}",
+			"defaultModelSet": "[ok] 默认模型已设置为: {{model}}",
+			"languageSet": "[ok] 语言已设置为: {{locale}}",
+			"restartRequired": "部分更改可能需要重启会话才能完全生效。",
+			"noModels": "没有可用的模型列表",
+			"configureManually": "请在 settings.json 中手动配置模型或检查提供商名称",
+			"alreadyExists": "已存在，请使用该提供商条目进行配置",
+			"configureFirst": "请先配置模型再设为默认",
+			"checkApiKeyHelpPrefix": "  提示: 请检查"
+		},
+		"cliMode": {
+			"usage": "用法:",
+			"settingsUsage": "/settings                    — 打开交互式配置菜单",
+			"listProvidersUsage": "/settings list-providers     — 列出所有已知提供商",
+			"listModelsUsage": "/settings list-models <name> — 列出提供商可用的模型",
+			"knownProviders": "已知提供商:",
+			"noModelsAvailable": "pi-ai 注册表中没有可用的模型",
+			"hintConfigureFirst": "提示: 使用 /settings 先配置此提供商",
+			"availableModels": "可用模型:"
+		},
+		"modelSelector": { "notConfigured": "未配置 - Enter 设置 API Key" }
+	},
+	session: {
+		"welcome": "ZapMyco: 欢迎回来!",
+		"errorPrefix": "[错误]",
+		"agentErrorMessage": "Agent 执行失败（无详细错误信息）",
+		"noContentError": "模型未返回任何内容，请检查 API Key 配置",
+		"displayName": "Zapmyco AI 助手",
+		"editorNotFound": "未找到编辑器: {{cmd}}，请设置 $EDITOR 环境变量",
+		"editorFailed": "打开编辑器失败: {{message}}",
+		"executing": "正在执行...",
+		"setEnvVarHint": "请设置环境变量: export {{envVar}}=<your-api-key>",
+		"useConfigHint": "或在 REPL 中使用: /config set llm.providers.{{provider}}.apiKey <your-key>"
+	}
+};
+
+//#endregion
+//#region src/i18n/index.ts
+/**
+* i18next 国际化模块
+*
+* 使用 i18next 实现国际化支持。
+* 通过传入静态 resources 实现同步初始化，无需 async/await。
+* 翻译文件为标准 JSON 格式，未来 React Web 界面可复用。
+*/
+i18next.init({
+	lng: "zh-CN",
+	fallbackLng: "zh-CN",
+	resources: {
+		"zh-CN": { translation: zh_CN_default },
+		en: { translation: en_default }
+	},
+	initAsync: false,
+	interpolation: {
+		escapeValue: false,
+		prefix: "{{",
+		suffix: "}}"
+	},
+	returnNull: false,
+	returnEmptyString: true
+});
+const { t } = i18next;
+/**
+* 设置当前语言
+*/
+function setLocale(locale) {
+	i18next.changeLanguage(locale).catch(() => {});
+}
+
+//#endregion
+//#region src/cli/repl/components/dialogs.ts
+/**
+* Shared dialog components for TUI overlays
+*
+* Extracted from settings-cmd.ts for reuse across the REPL.
+* Provides SelectList and TextInput overlay dialogs.
+*/
+/** Overlay layout options for menus */
+const OVERLAY_OPTIONS = {
+	width: "100%",
+	anchor: "top-left",
+	margin: {
+		top: 1,
+		bottom: 1
+	}
+};
+const SELECT_THEME = {
+	selectedPrefix: (text) => chalk.green(`❯ ${text}`),
+	selectedText: (text) => chalk.green.bold(text),
+	description: (text) => chalk.gray(text),
+	scrollInfo: (text) => chalk.gray(text),
+	noMatch: (text) => chalk.red(text)
+};
+/**
+* Wraps SelectList with a footer hint showing available keybindings.
+* This lets users discover navigation keys without relying on terminal conventions.
+*/
+var SelectListWithFooter = class {
+	selectList;
+	tui;
+	filterText = "";
+	isFiltering = false;
+	/** Callbacks stored at wrapper level, forwarded through inner SelectList */
+	onSelect;
+	onCancel;
+	/** Called when user presses q/esc — exits settings entirely */
+	onExit;
+	/** Called when user presses backspace/h — goes back one level */
+	onBack;
+	constructor(tui, items, maxVisible, theme) {
+		this.tui = tui;
+		this.selectList = new SelectList(items, maxVisible, theme);
+		this.selectList.onSelect = (item) => {
+			this.onSelect?.(item);
+		};
+		this.selectList.onCancel = () => {
+			this.onCancel?.();
+		};
+	}
+	handleInput(data) {
+		if (this.isFiltering) if (data.length === 1 && data >= " " && data <= "~") {
+			this.filterText += data;
+			this.applyFilter();
+		} else if (data === "backspace" || data === "" || data === "\b") if (this.filterText.length > 0) {
+			this.filterText = this.filterText.slice(0, -1);
+			this.applyFilter();
+		} else {
+			this.isFiltering = false;
+			this.resetFilteredItems();
+			this.selectList.invalidate();
+		}
+		else if (data === "escape") {
+			this.isFiltering = false;
+			this.filterText = "";
+			this.resetFilteredItems();
+			this.selectList.invalidate();
+		} else if (data === "enter") {
+			this.isFiltering = false;
+			this.selectList.handleInput("enter");
+		} else this.selectList.handleInput(data);
+		else if (data === "/") {
+			this.isFiltering = true;
+			this.filterText = "";
+			this.selectList.invalidate();
+		} else if (data === "escape" || data === "q") this.onExit?.();
+		else if (data === "backspace" || data === "" || data === "\b" || data === "h") this.onBack?.();
+		else this.selectList.handleInput(data);
+	}
+	/** Apply current filter text to the SelectList (uses includes, not startsWith) */
+	applyFilter() {
+		const sl = this.selectList;
+		if (!this.filterText) sl.filteredItems = [...sl.items];
+		else {
+			const lower = this.filterText.toLowerCase();
+			sl.filteredItems = sl.items.filter((item) => item.value.toLowerCase().includes(lower));
+		}
+		sl.selectedIndex = 0;
+		this.selectList.invalidate();
+	}
+	/** Restore SelectList to show all unfiltered items */
+	resetFilteredItems() {
+		const sl = this.selectList;
+		sl.filteredItems = [...sl.items];
+		sl.selectedIndex = 0;
+	}
+	invalidate() {
+		this.selectList.invalidate();
+	}
+	render(width) {
+		const lines = [];
+		if (this.isFiltering) {
+			lines.push("");
+			lines.push(chalk.cyan(`  /${this.filterText}█`));
+			lines.push(chalk.gray(`  ${"─".repeat(Math.max(0, width - 4))}`));
+			lines.push("");
+		}
+		const listLines = this.selectList.render(width);
+		lines.push(...listLines);
+		const termHeight = this.tui.terminal.rows;
+		const padding = Math.max(0, termHeight - 1 - lines.length - 3);
+		for (let i = 0; i < padding; i++) lines.push("");
+		if (width >= 50) {
+			lines.push(chalk.gray(`  ${"─".repeat(Math.max(0, width - 4))}`));
+			if (this.isFiltering) lines.push(chalk.gray(`  ${t("dialog.footer.search")}`));
+			else lines.push(chalk.gray(`  ${t("dialog.footer.normal")}`));
+		} else if (this.isFiltering) lines.push(chalk.gray(`  ${t("dialog.footer.searchNarrow")}`));
+		else lines.push(chalk.gray(`  ${t("dialog.footer.normalNarrow")}`));
+		lines.push("");
+		return lines;
+	}
+};
+/**
+* Show a SelectList overlay and wait for user selection
+* @returns The selected item, or null if cancelled
+*/
+function showSelectList(tui, items, options) {
+	return new Promise((resolve) => {
+		const list = new SelectListWithFooter(tui, items, options?.maxVisible ?? 10, SELECT_THEME);
+		let handle = null;
+		list.onSelect = (item) => {
+			handle?.hide();
+			resolve(item);
+		};
+		list.onCancel = () => {
+			handle?.hide();
+			resolve(null);
+		};
+		list.onExit = () => {
+			handle?.hide();
+			resolve(null);
+			options?.onExit?.();
+		};
+		list.onBack = () => {
+			handle?.hide();
+			resolve(null);
+		};
+		handle = tui.showOverlay(list, OVERLAY_OPTIONS);
+	});
+}
+var TextInputComponent = class {
+	input;
+	label;
+	constructor(label, initialValue, placeholder, onSubmit, onCancel) {
+		this.label = label;
+		this.input = new Input();
+		if (initialValue) this.input.setValue(initialValue);
+		this.input.onSubmit = (value) => {
+			onSubmit(value === placeholder ? initialValue : value);
+		};
+		this.input.onEscape = () => {
+			onCancel();
+		};
+	}
+	get focused() {
+		return this.input.focused;
+	}
+	set focused(v) {
+		this.input.focused = v;
+	}
+	handleInput(data) {
+		this.input.handleInput(data);
+	}
+	invalidate() {
+		this.input.invalidate();
+	}
+	render(width) {
+		const c = chalk;
+		return [
+			"",
+			c.bold(`  ${this.label}`),
+			"",
+			c.gray(`  ${"─".repeat(Math.min(width - 4, 50))}`),
+			`  ${this.input.render(width - 4)[0] ?? ""}`,
+			c.gray(`  ${"─".repeat(Math.min(width - 4, 50))}`),
+			"",
+			c.gray(`  ${t("dialog.footer.textInput")}`),
+			""
+		];
+	}
+};
+/**
+* Show a text input overlay
+* @returns The entered text, or null if cancelled
+*/
+function showTextInput(tui, label, initialValue, placeholder) {
+	return new Promise((resolve) => {
+		let handle = null;
+		const component = new TextInputComponent(label, initialValue, placeholder ?? "", (value) => {
+			handle?.hide();
+			resolve(value);
+		}, () => {
+			handle?.hide();
+			resolve(null);
+		});
+		handle = tui.showOverlay(component, {
+			width: "60%",
+			minWidth: 50,
+			maxHeight: 12,
+			anchor: "top-left"
+		});
+	});
+}
+/**
+* A simple overlay component that displays configuration text
+* and dismisses on q/Esc/Enter/BS/h.
+*/
+var ConfigViewComponent = class {
+	lines;
+	onDismiss;
+	constructor(config, renderer) {
+		this.lines = renderer.renderConfig(config);
+	}
+	/** Set the dismiss callback from showConfigView */
+	setDismissCallback(cb) {
+		this.onDismiss = cb;
+	}
+	handleInput(data) {
+		if (data === "escape" || data === "q" || data === "enter" || data === "backspace" || data === "" || data === "\b" || data === "h") this.onDismiss?.();
+	}
+	invalidate() {}
+	render(width) {
+		if (width < 50) return [
+			...this.lines,
+			"",
+			chalk.gray(`  ${t("dialog.configView.narrow")}`)
+		];
+		return [
+			...this.lines,
+			"",
+			chalk.gray(`  ${"─".repeat(Math.max(0, width - 4))}`),
+			chalk.gray(`  ${t("dialog.configView.wide")}`),
+			""
+		];
+	}
+};
+/**
+* Show the current configuration as a dismissible overlay.
+* Returns when the user dismisses it.
+*/
+function showConfigView(tui, config, renderer) {
+	return new Promise((resolve) => {
+		const component = new ConfigViewComponent(config, renderer);
+		const handle = tui.showOverlay(component, {
+			width: "100%",
+			anchor: "top-left",
+			margin: {
+				top: 1,
+				bottom: 1
+			}
+		});
+		component.setDismissCallback(() => {
+			handle.hide();
+			resolve();
+		});
+	});
+}
+
+//#endregion
+//#region src/cli/repl/config-utils.ts
+/**
+* Configuration file utilities
+*
+* Shared read/write helpers for ~/.zapmyco/settings.json,
+* used by settings-cmd.ts and session.ts.
+*/
+/** Read settings.json and return a mutable object */
+function readSettings() {
+	try {
+		return JSON.parse(readFileSync(HOME_CONFIG_PATH, "utf-8"));
+	} catch {
+		return {};
+	}
+}
+/** Write back to settings.json */
+function writeSettings(settings) {
+	writeFileSync(HOME_CONFIG_PATH, JSON.stringify(settings, null, 2) + "\n", "utf-8");
+}
+/** Safely set a nested property (prototype-chain safe) */
+function _setByDotPath(obj, path, value) {
+	const keys = path.split(".");
+	let current = obj;
+	for (let i = 0; i < keys.length - 1; i++) {
+		const key = keys[i];
+		if (key === "__proto__" || key === "constructor" || key === "prototype") return;
+		if (!(key in current) || typeof current[key] !== "object" || current[key] === null) current[key] = {};
+		current = current[key];
+	}
+	const lastKey = keys[keys.length - 1];
+	if (lastKey === "__proto__" || lastKey === "constructor" || lastKey === "prototype") return;
+	current[lastKey] = value;
+}
+/** Get a nested property value via dot-path */
+function _getByDotPath(obj, path) {
+	const keys = path.split(".");
+	let current = obj;
+	for (const key of keys) {
+		if (current === null || current === void 0 || typeof current !== "object") return;
+		if (key === "__proto__" || key === "constructor" || key === "prototype") return void 0;
+		current = current[key];
+	}
+	return current;
+}
+
+//#endregion
+//#region src/cli/repl/commands/settings-cmd.ts
+/**
+* /settings command — interactive configuration menu
+*
+* TUI overlay-based graphical configuration interface:
+* - View and change the default model
+* - Configure API keys, models, and base URLs for existing providers
+* - Add new providers from a curated list
+* - All changes sync to ~/.zapmyco/settings.json in real-time
+*/
+/** Curated list of known providers (sorted by popularity) */
+const KNOWN_PROVIDERS = [
+	{
+		id: "anthropic",
+		label: "Anthropic",
+		apiFormat: "anthropic"
+	},
+	{
+		id: "openai",
+		label: "OpenAI"
+	},
+	{
+		id: "deepseek",
+		label: "DeepSeek"
+	},
+	{
+		id: "google",
+		label: "Google (Gemini)"
+	},
+	{
+		id: "mistral",
+		label: "Mistral AI"
+	},
+	{
+		id: "xai",
+		label: "xAI (Grok)"
+	},
+	{
+		id: "groq",
+		label: "Groq"
+	},
+	{
+		id: "openrouter",
+		label: "OpenRouter"
+	},
+	{
+		id: "cerebras",
+		label: "Cerebras"
+	},
+	{
+		id: "fireworks",
+		label: "Fireworks AI"
+	},
+	{
+		id: "github-copilot",
+		label: "GitHub Copilot"
+	},
+	{
+		id: "huggingface",
+		label: "Hugging Face"
+	},
+	{
+		id: "moonshotai",
+		label: "Moonshot AI (Kimi)"
+	},
+	{
+		id: "cloudflare-workers-ai",
+		label: "Cloudflare Workers AI"
+	},
+	{
+		id: "amazon-bedrock",
+		label: "Amazon Bedrock"
+	},
+	{
+		id: "zai",
+		label: "ZAI"
+	},
+	{
+		id: "minimax",
+		label: "MiniMax"
+	},
+	{
+		id: "opencode",
+		label: "OpenCode"
+	}
+];
+/** Supported language locales */
+const SUPPORTED_LOCALES = [{
+	value: "zh-CN",
+	label: "简体中文",
+	description: "Chinese (Simplified)"
+}, {
+	value: "en",
+	label: "English",
+	description: "English"
+}];
+/** Set a dot-path value, persist to disk and hot-reload agent */
+function setConfigValue(session, dotPath, value) {
+	const settings = readSettings();
+	_setByDotPath(settings, dotPath, value);
+	writeSettings(settings);
+	_setByDotPath(session.config, dotPath, value);
+	session.applyConfigUpdate(dotPath);
+}
+/** Check if a provider has an API key configured */
+function hasApiKey(config, providerName) {
+	const key = _getByDotPath(config, `llm.providers.${providerName}.apiKey`);
+	if (!key) return false;
+	const keyStr = String(key);
+	return keyStr.length > 0 && keyStr !== "${}";
+}
+/** Get available model IDs for a provider (from config or pi-ai) */
+function getProviderModels(config, providerName) {
+	const models = _getByDotPath(config, `llm.providers.${providerName}.models`);
+	if (models && typeof models === "object" && Object.keys(models).length > 0) return Object.keys(models);
+	try {
+		const piModels = getModels(providerName);
+		if (piModels && piModels.length > 0) return piModels.map((m) => m.id);
+	} catch {}
+	return [];
+}
+/**
+* Create the /settings command definition
+*/
+function createSettingsCommand() {
+	return {
+		name: "settings",
+		aliases: ["set"],
+		description: "Interactive configuration menu — manage model providers and API keys",
+		usage: "/settings [list-providers | list-models <provider>]",
+		async handler(args, session) {
+			const tui = session.getTui();
+			const config = readSettings();
+			if (args.length > 0) {
+				await handleCommandLine(args, session, tui, config);
+				return;
+			}
+			await handleInteractiveMode(tui, session, config);
+		}
+	};
+}
+/**
+* CLI mode — quick operations via arguments
+*/
+async function handleCommandLine(args, session, _tui, config) {
+	switch (args[0]) {
+		case "list-providers": {
+			const providers = _getByDotPath(config, "llm.providers");
+			const names = providers ? Object.keys(providers) : [];
+			const lines = ["", t("settings.cliMode.knownProviders")];
+			for (const p of KNOWN_PROVIDERS) {
+				const configured = names.includes(p.id) ? " ✓" : "   ";
+				lines.push(`  ${configured} ${p.label} (${p.id})`);
+			}
+			session.appendOutput(lines);
+			return;
+		}
+		case "list-models": {
+			if (!args[1]) {
+				session.appendOutput([
+					"",
+					`${t("settings.cliMode.usage")} /settings list-models <provider>`,
+					""
+				]);
+				return;
+			}
+			const modelIds = getProviderModels(config, args[1]);
+			if (modelIds.length === 0) {
+				session.appendOutput([
+					"",
+					`Provider "${args[1]}" ${t("settings.messages.noModels")}`,
+					t("settings.cliMode.hintConfigureFirst"),
+					""
+				]);
+				return;
+			}
+			session.appendOutput([
+				"",
+				`${args[1]} ${t("settings.cliMode.availableModels")}`,
+				...modelIds.map((id) => `  - ${id}`),
+				""
+			]);
+			return;
+		}
+		default: session.appendOutput([
+			"",
+			t("settings.cliMode.usage"),
+			`  ${t("settings.cliMode.settingsUsage")}`,
+			`  ${t("settings.cliMode.listProvidersUsage")}`,
+			`  ${t("settings.cliMode.listModelsUsage")}`,
+			""
+		]);
+	}
+}
+/**
+* Interactive menu mode — main flow
+*/
+async function handleInteractiveMode(tui, session, config) {
+	const state = { current: config };
+	/**
+	* Handle API Key configuration
+	*/
+	const handleApiKeyConfig = async (providerName, _currentKey) => {
+		const envVarName = `${providerName.toUpperCase().replace(/-/g, "_")}_API_KEY`;
+		const choice = await showSelectList(tui, [
+			{
+				value: "env",
+				label: `${t("settings.apiKeyConfig.useEnvVar")} \${${envVarName}}`,
+				description: t("settings.apiKeyConfig.useEnvVarDesc")
+			},
+			{
+				value: "manual",
+				label: t("settings.apiKeyConfig.enterManually"),
+				description: t("settings.apiKeyConfig.enterManuallyDesc")
+			},
+			{
+				value: "clear",
+				label: t("settings.apiKeyConfig.clear"),
+				description: t("settings.apiKeyConfig.clearDesc")
+			}
+		], { onExit: exitAll });
+		if (!choice) return;
+		if (choice.value === "clear") {
+			setConfigValue(session, `llm.providers.${providerName}.apiKey`, "");
+			session.appendOutput([
+				"",
+				`  ${t("settings.messages.apiKeyCleared", { provider: providerName })}`,
+				""
+			]);
+		} else if (choice.value === "env") {
+			setConfigValue(session, `llm.providers.${providerName}.apiKey`, `\${${envVarName}}`);
+			session.appendOutput([
+				"",
+				`  ${t("settings.messages.apiKeySetToEnv", {
+					provider: providerName,
+					envVar: envVarName
+				})}`,
+				`  ${t("settings.messages.envVarNote", { envVar: envVarName })}`,
+				""
+			]);
+		} else if (choice.value === "manual") {
+			const key = await showTextInput(tui, `Enter ${providerName} API Key`, "", "sk-...");
+			if (key && key.length > 0) {
+				setConfigValue(session, `llm.providers.${providerName}.apiKey`, key);
+				session.appendOutput([
+					"",
+					`  ${t("settings.messages.apiKeyConfigured", { provider: providerName })}`,
+					""
+				]);
+			}
+		}
+	};
+	/**
+	* Handle Base URL configuration
+	*/
+	const handleBaseUrlConfig = async (providerName, _currentUrl) => {
+		const url = await showTextInput(tui, `Enter ${providerName} Base URL`, "", "https://api.example.com");
+		if (url !== null) {
+			const configPath = `llm.providers.${providerName}.baseUrl`;
+			if (url.length === 0) {
+				const settings = readSettings();
+				_setByDotPath(settings, configPath, void 0);
+				const parent = _getByDotPath(settings, `llm.providers.${providerName}`);
+				if (parent) delete parent.baseUrl;
+				writeSettings(settings);
+				session.appendOutput([
+					"",
+					`  ${t("settings.messages.baseUrlReset", { provider: providerName })}`,
+					""
+				]);
+			} else {
+				setConfigValue(session, configPath, url);
+				session.appendOutput([
+					"",
+					`  ${t("settings.messages.baseUrlSet", {
+						provider: providerName,
+						url
+					})}`,
+					""
+				]);
+			}
+		}
+	};
+	/**
+	* Handle model selection
+	*/
+	const handleModelSelect = async (providerName) => {
+		const modelIds = getProviderModels(state.current, providerName);
+		if (modelIds.length === 0) {
+			session.appendOutput([
+				"",
+				`  ${providerName} ${t("settings.messages.noModels")}`,
+				`  ${t("settings.messages.configureManually")}`,
+				""
+			]);
+			return;
+		}
+		const selected = await showSelectList(tui, modelIds.map((id) => ({
+			value: id,
+			label: id,
+			description: ""
+		})), { onExit: exitAll });
+		if (selected && selected.value) {
+			const modelId = selected.value;
+			const settings = readSettings();
+			_setByDotPath(settings, `llm.providers.${providerName}.models.${modelId}`, { id: modelId });
+			writeSettings(settings);
+			_setByDotPath(session.config, `llm.providers.${providerName}.models`, _getByDotPath(settings, `llm.providers.${providerName}.models`) ?? {});
+			session.appendOutput([
+				"",
+				`  ${t("settings.messages.modelSelected", { model: `${providerName}/${modelId}` })}`,
+				""
+			]);
+		}
+	};
+	/**
+	* Handle setting a provider's model as the default
+	*/
+	const handleSetDefault = async (providerName) => {
+		const modelIds = getProviderModels(state.current, providerName);
+		if (modelIds.length === 0) {
+			session.appendOutput([
+				"",
+				`  ${t("settings.messages.configureFirst")}`,
+				""
+			]);
+			return;
+		}
+		const modelKey = `${providerName}/${modelIds[0]}`;
+		setConfigValue(session, "llm.defaultModel", modelKey);
+		session.appendOutput([
+			"",
+			`  ${t("settings.messages.defaultModelSet", { model: modelKey })}`,
+			""
+		]);
+	};
+	let running = true;
+	const exitAll = () => {
+		running = false;
+	};
+	while (running) {
+		state.current = readSettings();
+		const providers = _getByDotPath(state.current, "llm.providers") ?? {};
+		const providerCount = Object.keys(providers).length;
+		const choice = await showSelectList(tui, [
+			{
+				value: "default-model",
+				label: t("settings.mainMenu.defaultModel"),
+				description: String(_getByDotPath(state.current, "llm.defaultModel") ?? t("settings.mainMenu.notConfigured"))
+			},
+			{
+				value: "manage-providers",
+				label: t("settings.mainMenu.manageProviders"),
+				description: providerCount > 0 ? t("settings.mainMenu.nConfigured", { count: providerCount }) : t("settings.mainMenu.noneConfigured")
+			},
+			{
+				value: "view-config",
+				label: t("settings.mainMenu.viewConfig"),
+				description: t("settings.mainMenu.displayFullConfig")
+			},
+			{
+				value: "language",
+				label: t("settings.mainMenu.language"),
+				description: String(_getByDotPath(state.current, "locale") ?? "zh-CN")
+			}
+		], { onExit: exitAll });
+		if (!choice) {
+			running = false;
+			break;
+		}
+		const value = choice.value;
+		if (value === "default-model") {
+			const configuredProviders = _getByDotPath(state.current, "llm.providers");
+			const allProviders = getProviders();
+			const enabledItems = [];
+			const disabledItems = [];
+			for (const providerName of allProviders) {
+				const models = getProviderModels(state.current, providerName);
+				if (models.length === 0) continue;
+				const isEnabled = configuredProviders !== void 0 && providerName in configuredProviders && hasApiKey(state.current, providerName);
+				for (const modelId of models) {
+					const key = `${providerName}/${modelId}`;
+					if (isEnabled) enabledItems.push({
+						value: key,
+						label: key,
+						description: ""
+					});
+					else disabledItems.push({
+						value: key,
+						label: chalk.gray(key),
+						description: chalk.gray(t("settings.modelSelector.notConfigured"))
+					});
+				}
+			}
+			const modelItems = [...enabledItems, ...disabledItems];
+			if (modelItems.length === 0) {
+				session.appendOutput([
+					"",
+					`  ${t("settings.cliMode.noModelsAvailable")}`,
+					""
+				]);
+				continue;
+			}
+			const selected = await showSelectList(tui, modelItems, { onExit: exitAll });
+			if (!selected || !selected.value) continue;
+			const selectedKey = selected.value;
+			const slashIndex = selectedKey.indexOf("/");
+			const providerName = selectedKey.slice(0, slashIndex);
+			if (configuredProviders !== void 0 && providerName in configuredProviders && hasApiKey(state.current, providerName)) {
+				setConfigValue(session, "llm.defaultModel", selectedKey);
+				session.appendOutput([
+					"",
+					`  ${t("settings.messages.defaultModelSet", { model: selectedKey })}`,
+					""
+				]);
+			} else {
+				if (!configuredProviders || !(providerName in configuredProviders)) {
+					const known = KNOWN_PROVIDERS.find((p) => p.id === providerName);
+					const newProvider = { apiKey: "" };
+					if (known?.apiFormat) newProvider.apiFormat = known.apiFormat;
+					const settings = readSettings();
+					_setByDotPath(settings, `llm.providers.${providerName}`, newProvider);
+					writeSettings(settings);
+					_setByDotPath(session.config, `llm.providers.${providerName}`, newProvider);
+					state.current = readSettings();
+				}
+				await handleApiKeyConfig(providerName, "");
+				state.current = readSettings();
+				if (hasApiKey(state.current, providerName)) {
+					setConfigValue(session, "llm.defaultModel", selectedKey);
+					session.appendOutput([
+						"",
+						`  ${t("settings.messages.defaultModelSet", { model: selectedKey })}`,
+						""
+					]);
+				}
+			}
+		} else if (value === "manage-providers") {
+			const providerChoice = await showSelectList(tui, [...Object.entries(providers).map(([name]) => {
+				const hasK = hasApiKey(state.current, name);
+				return {
+					value: `provider:${name}`,
+					label: name,
+					description: hasK ? t("settings.providerEntry.keyConfigured") : t("settings.providerEntry.noKey")
+				};
+			}), {
+				value: "add-provider",
+				label: t("settings.providerEntry.addProvider"),
+				description: t("settings.providerEntry.addProviderDesc")
+			}], { onExit: exitAll });
+			if (!providerChoice) continue;
+			const providerValue = providerChoice.value;
+			if (providerValue.startsWith("provider:")) {
+				const providerName = providerValue.slice(9);
+				const action = await showSelectList(tui, [
+					{
+						value: "api-key",
+						label: t("settings.providerActions.configureApiKey"),
+						description: ""
+					},
+					{
+						value: "model",
+						label: t("settings.providerActions.selectModel"),
+						description: ""
+					},
+					{
+						value: "base-url",
+						label: t("settings.providerActions.baseUrl"),
+						description: ""
+					},
+					{
+						value: "set-default",
+						label: t("settings.providerActions.setAsDefault"),
+						description: ""
+					}
+				], { onExit: exitAll });
+				if (!action) continue;
+				switch (action.value) {
+					case "api-key":
+						await handleApiKeyConfig(providerName, String(_getByDotPath(state.current, `llm.providers.${providerName}.apiKey`) ?? ""));
+						break;
+					case "model":
+						await handleModelSelect(providerName);
+						break;
+					case "base-url":
+						await handleBaseUrlConfig(providerName, String(_getByDotPath(state.current, `llm.providers.${providerName}.baseUrl`) ?? ""));
+						break;
+					case "set-default":
+						await handleSetDefault(providerName);
+						break;
+				}
+			} else if (providerValue === "add-provider") {
+				const selected = await showSelectList(tui, KNOWN_PROVIDERS.map((p) => ({
+					value: p.id,
+					label: `${p.label} (${p.id})`,
+					description: p.apiFormat ? t("settings.providerEntry.apiFormat", { format: p.apiFormat }) : t("settings.providerEntry.openaiCompatible")
+				})), {
+					maxVisible: 12,
+					onExit: exitAll
+				});
+				if (!selected || !selected.value) continue;
+				const providerName = selected.value;
+				const existingProviders = _getByDotPath(state.current, "llm.providers");
+				if (existingProviders && providerName in existingProviders) {
+					session.appendOutput([
+						"",
+						`  ${providerName} ${t("settings.messages.alreadyExists")}`,
+						""
+					]);
+					continue;
+				}
+				const known = KNOWN_PROVIDERS.find((p) => p.id === providerName);
+				const newProvider = { apiKey: "" };
+				if (known?.apiFormat) newProvider.apiFormat = known.apiFormat;
+				const settings = readSettings();
+				_setByDotPath(settings, `llm.providers.${providerName}`, newProvider);
+				writeSettings(settings);
+				_setByDotPath(session.config, `llm.providers.${providerName}`, newProvider);
+				session.appendOutput([
+					"",
+					`  ${t("settings.messages.providerAdded", { provider: providerName })}`,
+					""
+				]);
+				if ((await showSelectList(tui, [{
+					value: "yes",
+					label: t("settings.addProvider.yes"),
+					description: t("settings.addProvider.yesDesc")
+				}, {
+					value: "no",
+					label: t("settings.addProvider.later"),
+					description: t("settings.addProvider.laterDesc")
+				}], { onExit: exitAll }))?.value === "yes") await handleApiKeyConfig(providerName, "");
+			}
+		} else if (value === "view-config") {
+			const renderer = session.getRenderer();
+			await showConfigView(tui, session.config, renderer);
+		} else if (value === "language") {
+			const currentLocale = String(_getByDotPath(state.current, "locale") ?? "zh-CN");
+			const selected = await showSelectList(tui, SUPPORTED_LOCALES.map((loc) => ({
+				...loc,
+				label: loc.value === currentLocale ? `${loc.label} ✓` : loc.label
+			})), { onExit: exitAll });
+			if (!selected || !selected.value) continue;
+			if (selected.value !== currentLocale) {
+				setConfigValue(session, "locale", selected.value);
+				setLocale(selected.value);
+				session.appendOutput([
+					"",
+					`  ${t("settings.messages.languageSet", { locale: selected.value })}`,
+					`  ${t("settings.messages.restartRequired")}`,
+					""
+				]);
+			}
+		}
+	}
+}
+
 //#endregion
 //#region src/cli/repl/commands/status.ts
 /**
@@ -321,6 +1650,7 @@ function createStatusCommand() {
 * 继承自 pi-tui 的 Editor，添加 zapmyco 特有的快捷键处理：
 * - Ctrl+C: 取消任务 / 二次退出
 * - Ctrl+D: 退出
+* - Ctrl+O: 打开外部编辑器编辑输入
 * - Escape: 取消当前输入
 *
 * 同时 override render() 以：
@@ -357,6 +1687,8 @@ var ZapmycoEditor = class extends Editor {
 	onCtrlC;
 	/** Ctrl+D 回调 */
 	onCtrlD;
+	/** Ctrl+O 回调（打开外部编辑器） */
+	onOpenEditor;
 	/** 是否正在执行（用于显示 loading） */
 	#executing = false;
 	/** 是否显示 spinner（执行期间禁用输入但不一定显示 spinner） */
@@ -378,6 +1710,10 @@ var ZapmycoEditor = class extends Editor {
 			if (this.getText().length === 0 && this.onCtrlD) this.onCtrlD();
 			return;
 		}
+		if (matchesKey(data, Key.ctrl("o")) && this.onOpenEditor) {
+			this.onOpenEditor();
+			return;
+		}
 		super.handleInput(data);
 	}
 	/**
@@ -1286,7 +2622,7 @@ var OutputFormatter = class {
 			"",
 			`  🍄 ${c.bold(`zapmyco@${version}`)}`,
 			"",
-			"  欢迎回来！",
+			`  ${t("output.welcome")}`,
 			"",
 			c.gray("─".repeat(90)),
 			""
@@ -1299,8 +2635,8 @@ var OutputFormatter = class {
 		const zapmycoError = error;
 		if (zapmycoError.code) {
 			lines.push(`${c.red.bold(`  ✗ [${zapmycoError.code}]`)} ${error.message}`);
-			if (zapmycoError.context && Object.keys(zapmycoError.context).length > 0) lines.push(c.gray(`  详情: ${JSON.stringify(zapmycoError.context)}`));
-		} else lines.push(`${c.red.bold("  ✗ 执行失败:")} ${error.message}`);
+			if (zapmycoError.context && Object.keys(zapmycoError.context).length > 0) lines.push(c.gray(`  ${t("output.error.detail")} ${JSON.stringify(zapmycoError.context)}`));
+		} else lines.push(`${c.red.bold(`  ✗ ${t("output.error.executionFailed")}`)} ${error.message}`);
 		lines.push("");
 		return lines;
 	}
@@ -1311,16 +2647,16 @@ var OutputFormatter = class {
 		const lines = [
 			"",
 			c.gray("  ┌────────────────────────────────────────────┐"),
-			`  │  ${statusIcon}  ${c.bold("执行完成")}`,
+			`  │  ${statusIcon}  ${c.bold(t("output.result.title"))}`,
 			c.gray("  ├────────────────────────────────────────────┤"),
-			`  │  ${c.gray("目标:")} ${result.summary.slice(0, 40)}`,
-			`  │  ${c.gray("状态:")} ${result.overallStatus === "success" ? c.green("成功") : result.overallStatus === "partial-failure" ? c.yellow("部分成功") : c.red("失败")}`,
-			`  │  ${c.gray("耗时:")} ${(result.totalDuration / 1e3).toFixed(1)}s  ·  ${c.gray("Token:")} ${result.totalTokenUsage.totalTokens.toLocaleString()}`,
-			`  │  ${c.gray("成本:")} $${result.totalTokenUsage.estimatedCostUsd.toFixed(4)}`
+			`  │  ${c.gray(t("output.result.goal"))} ${result.summary.slice(0, 40)}`,
+			`  │  ${c.gray(t("output.result.status"))} ${result.overallStatus === "success" ? c.green(t("output.result.success")) : result.overallStatus === "partial-failure" ? c.yellow(t("output.result.partialSuccess")) : c.red(t("output.result.failed"))}`,
+			`  │  ${c.gray(t("output.result.duration"))} ${(result.totalDuration / 1e3).toFixed(1)}s  ·  ${c.gray(t("output.result.token"))} ${result.totalTokenUsage.totalTokens.toLocaleString()}`,
+			`  │  ${c.gray(t("output.result.cost"))} $${result.totalTokenUsage.estimatedCostUsd.toFixed(4)}`
 		];
 		if (result.taskResults.length > 0) {
 			lines.push(c.gray("  ├────────────────────────────────────────────┤"));
-			lines.push(`  │  ${c.bold("任务拆分")} (${result.taskResults.length} 个子任务):`);
+			lines.push(`  │  ${c.bold(t("output.result.taskBreakdown"))} (${result.taskResults.length} ${t("output.result.subtaskCount")}):`);
 			for (const tr of result.taskResults) {
 				const icon = tr.status === "success" ? c.green("✓") : tr.status === "partial" ? c.yellow("~") : c.red("✗");
 				lines.push(`  │    ${icon} ${tr.taskId.slice(0, 12)}...`);
@@ -1328,7 +2664,7 @@ var OutputFormatter = class {
 		}
 		if (result.allArtifacts.length > 0) {
 			lines.push(c.gray("  ├────────────────────────────────────────────┤"));
-			lines.push(`  │  ${c.bold("制品:")}`);
+			lines.push(`  │  ${c.bold(t("output.result.artifacts"))}`);
 			for (const artifact of result.allArtifacts) {
 				const icon = artifact.type === "pull-request" ? "🔗" : "📄";
 				lines.push(`  │    ${icon} ${artifact.description} (${artifact.reference})`);
@@ -1336,7 +2672,7 @@ var OutputFormatter = class {
 		}
 		if (result.nextSteps && result.nextSteps.length > 0) {
 			lines.push(c.gray("  ├────────────────────────────────────────────┤"));
-			lines.push(`  │  ${c.bold("建议:")}`);
+			lines.push(`  │  ${c.bold(t("output.result.suggestions"))}`);
 			for (let i = 0; i < result.nextSteps.length; i++) lines.push(`  │    ${i + 1}. ${result.nextSteps[i]}`);
 		}
 		lines.push(c.gray("  └────────────────────────────────────────────┘"));
@@ -1348,14 +2684,17 @@ var OutputFormatter = class {
 		const c = this.getColor();
 		const lines = [
 			"",
-			c.bold("  📋 任务拆分概览"),
-			c.gray(`  共 ${graph.nodes.size} 个子任务，${graph.layers.length} 层并行`),
+			c.bold(`  📋 ${t("output.taskGraph.title")}`),
+			c.gray(`  ${t("output.taskGraph.total", {
+				count: graph.nodes.size,
+				layers: graph.layers.length
+			})}`),
 			""
 		];
 		for (let layerIdx = 0; layerIdx < graph.layers.length; layerIdx++) {
 			const layer = graph.layers[layerIdx];
 			if (!layer) continue;
-			lines.push(c.gray(`  第 ${layerIdx + 1} 层 (可并行):`));
+			lines.push(c.gray(`  ${t("output.taskGraph.layer", { index: layerIdx + 1 })}`));
 			for (const taskId of layer) {
 				const task = graph.nodes.get(taskId);
 				if (task) {
@@ -1372,15 +2711,15 @@ var OutputFormatter = class {
 		const c = this.getColor();
 		const lines = [
 			"",
-			c.bold("  🤖 已注册 Agent"),
+			c.bold(`  🤖 ${t("output.agents.title")}`),
 			""
 		];
 		if (agents.length === 0) {
-			lines.push(c.gray("  暂无已注册的 Agent"));
+			lines.push(c.gray(`  ${t("output.agents.empty")}`));
 			lines.push("");
 			return lines;
 		}
-		lines.push(`  ${c.bold("ID").padEnd(20)} ${c.bold("状态").padEnd(10)} ${c.bold("负载").padEnd(8)} ${c.bold("能力")}`);
+		lines.push(`  ${c.bold(t("output.agents.id")).padEnd(20)} ${c.bold(t("output.agents.status")).padEnd(10)} ${c.bold(t("output.agents.load")).padEnd(8)} ${c.bold(t("output.agents.capability"))}`);
 		lines.push(c.gray(`  ${"─".repeat(60)}`));
 		for (const agent of agents) {
 			const statusDot = agent.status === "online" ? c.green("●") : agent.status === "busy" ? c.yellow("●") : c.gray("○");
@@ -1395,28 +2734,33 @@ var OutputFormatter = class {
 		const c = this.getColor();
 		const lines = [
 			"",
-			c.bold("  ⚙️  当前配置"),
+			c.bold(`  ⚙️  ${t("output.config.title")}`),
 			"",
-			c.bold("  LLM:")
+			c.bold(`  ${t("output.config.llm")}`)
 		];
-		lines.push(`    默认模型: ${config.llm.defaultModel}`);
-		const defaultModelConfig = config.llm.models[config.llm.defaultModel];
-		if (defaultModelConfig) {
-			lines.push(`    提供商: ${defaultModelConfig.provider}`);
-			lines.push(`    模型 ID: ${defaultModelConfig.modelId}`);
-		}
-		const auth = config.llm.providers[defaultModelConfig?.provider ?? "anthropic"];
-		lines.push(`    API Key: ${auth?.apiKey ? c.gray("***已配置***") : c.red("(未配置)")}`);
-		lines.push(c.bold("  调度器:"));
-		lines.push(`    最大并行: ${config.scheduler.maxConcurrency}`);
-		lines.push(`    单 Agent 最大并发: ${config.scheduler.maxPerAgent}`);
-		lines.push(`    任务超时: ${(config.scheduler.taskTimeoutMs / 1e3 / 60).toFixed(0)} 分钟`);
-		lines.push(`    最大重试: ${config.scheduler.maxRetries}`);
-		lines.push(c.bold("  CLI:"));
-		lines.push(`    颜色输出: ${config.cli.color ? c.green("开启") : c.gray("关闭")}`);
-		lines.push(`    调试模式: ${config.cli.debug ? c.green("开启") : c.gray("关闭")}`);
-		lines.push(`    输出格式: ${config.cli.outputFormat}`);
-		lines.push(c.bold("  Agents:"));
+		lines.push(`    ${t("output.config.defaultModel")} ${config.llm.defaultModel}`);
+		const defaultModelKey = config.llm.defaultModel;
+		const slashIdx = defaultModelKey.indexOf("/");
+		const defaultProvider = slashIdx > 0 ? defaultModelKey.slice(0, slashIdx) : "anthropic";
+		const defaultModelName = slashIdx > 0 ? defaultModelKey.slice(slashIdx + 1) : defaultModelKey;
+		const providerConfig = config.llm.providers[defaultProvider];
+		const modelConfig = providerConfig?.models?.[defaultModelName];
+		lines.push(`    ${t("output.config.provider")} ${defaultProvider}`);
+		lines.push(`    ${t("output.config.modelId")} ${modelConfig?.id ?? defaultModelName}`);
+		if (modelConfig?.input && modelConfig.input.length > 0) lines.push(`    ${t("output.config.inputType")} ${modelConfig.input.join(", ")}`);
+		lines.push(`    ${t("output.config.apiKey")} ${providerConfig?.apiKey ? c.gray(t("output.config.apiKeyConfigured")) : c.red(t("output.config.apiKeyNotConfigured"))}`);
+		if (providerConfig?.apiFormat) lines.push(`    ${t("output.config.apiFormat")} ${providerConfig.apiFormat}`);
+		lines.push(c.bold(`  ${t("output.config.scheduler")}`));
+		lines.push(`    ${t("output.config.maxConcurrency")} ${config.scheduler.maxConcurrency}`);
+		lines.push(`    ${t("output.config.maxPerAgent")} ${config.scheduler.maxPerAgent}`);
+		lines.push(`    ${t("output.config.taskTimeout")} ${(config.scheduler.taskTimeoutMs / 1e3 / 60).toFixed(0)} ${t("output.config.minutes")}`);
+		lines.push(`    ${t("output.config.maxRetries")} ${config.scheduler.maxRetries}`);
+		lines.push(c.bold(`  ${t("output.config.cli")}`));
+		lines.push(`    ${t("output.config.colorEnabled")}: ${config.cli.color ? c.green(t("output.config.colorEnabled")) : c.gray(t("output.config.colorDisabled"))}`);
+		lines.push(`    ${t("output.config.debugEnabled")}: ${config.cli.debug ? c.green(t("output.config.debugEnabled")) : c.gray(t("output.config.debugDisabled"))}`);
+		lines.push(`    ${t("output.config.outputFormat")} ${config.cli.outputFormat}`);
+		lines.push(`    ${t("output.config.uiLanguage")} ${config.locale ?? "zh-CN"}`);
+		lines.push(c.bold(`  ${t("output.config.agents")}`));
 		for (const agent of config.agents) {
 			const statusIcon = agent.enabled ? c.green("✓") : c.gray("✗");
 			lines.push(`    ${statusIcon} ${agent.id}`);
@@ -1429,11 +2773,11 @@ var OutputFormatter = class {
 		const c = this.getColor();
 		const lines = [
 			"",
-			c.bold("  📜 会话历史"),
+			c.bold(`  📜 ${t("output.history.title")}`),
 			""
 		];
 		if (entries.length === 0) {
-			lines.push(c.gray("  暂无历史记录"));
+			lines.push(c.gray(`  ${t("output.history.empty")}`));
 			lines.push("");
 			return lines;
 		}
@@ -1452,16 +2796,16 @@ var OutputFormatter = class {
 		const c = this.getColor();
 		const lines = [
 			"",
-			c.bold("  📊 会话状态"),
+			c.bold(`  📊 ${t("output.status.title")}`),
 			""
 		];
-		const stateLabel = stats.state === "idle" ? c.green("空闲") : stats.state === "executing" ? c.magenta("执行中") : c.gray("关闭中");
-		lines.push(`  状态:       ${stateLabel}`);
-		lines.push(`  总请求数:   ${stats.totalRequests}`);
-		lines.push(`  成功:       ${c.green(String(stats.successCount))}`);
-		lines.push(`  失败:       ${stats.failureCount > 0 ? c.red(String(stats.failureCount)) : String(stats.failureCount)}`);
-		lines.push(`  Token 消耗: ${stats.totalTokens.toLocaleString()}`);
-		lines.push(`  总成本:     $${stats.totalCostUsd.toFixed(4)}`);
+		const stateLabel = stats.state === "idle" ? c.green(t("output.status.idle")) : stats.state === "executing" ? c.magenta(t("output.status.executing")) : c.gray(t("output.status.closing"));
+		lines.push(`  ${t("output.status.state").padEnd(10)} ${stateLabel}`);
+		lines.push(`  ${t("output.status.totalRequests").padEnd(10)} ${stats.totalRequests}`);
+		lines.push(`  ${t("output.status.success").padEnd(10)} ${c.green(String(stats.successCount))}`);
+		lines.push(`  ${t("output.status.failure").padEnd(10)} ${stats.failureCount > 0 ? c.red(String(stats.failureCount)) : String(stats.failureCount)}`);
+		lines.push(`  ${t("output.status.tokenConsumption").padEnd(10)} ${stats.totalTokens.toLocaleString()}`);
+		lines.push(`  ${t("output.status.totalCost").padEnd(10)} $${stats.totalCostUsd.toFixed(4)}`);
 		lines.push("");
 		return lines;
 	}
@@ -6613,26 +7957,32 @@ var TaskStore = class {
 };
 
 //#endregion
-//#region src/llm/pi-ai-provider.ts
+//#region src/cli/repl/session.ts
 /**
-* 解析模型标识符
+* REPL 会话核心（pi-tui 版）
 *
-* 支持格式：provider/modelId（如 anthropic/claude-sonnet-4-20250514）
-* 导出供其他模块复用（如 REPL Session 为 Agent 解析 Model 对象）
+* 使用 @mariozechner/pi-tui 框架替代 readline，
+* 实现完整的 TUI 交互式 REPL：
+* - Editor 组件自带上下边框
+* - 差量渲染，无闪烁
+* - 组件化布局，可扩展
 */
-function parseModelKey(key) {
-	const slashIndex = key.indexOf("/");
-	if (slashIndex <= 0 || slashIndex >= key.length - 1) return null;
-	return {
-		provider: key.slice(0, slashIndex),
-		modelId: key.slice(slashIndex + 1)
-	};
-}
-
-//#endregion
-//#region src/cli/repl/session.ts
 const log = logger.child("repl:session");
 /**
+* 检查错误消息是否匹配 "No API key for provider"，返回解决指引行
+*/
+function getApiKeyErrorHelp(errorMessage) {
+	const match = errorMessage.match(/No API key for provider: (\w+)/);
+	if (!match) return [];
+	const providerName = match[1];
+	const envVarName = `${providerName.toUpperCase().replace(/-/g, "_")}_API_KEY`;
+	return [
+		"",
+		chalk.yellow(`  ${t("session.setEnvVarHint", { envVar: envVarName })}`),
+		chalk.yellow(`  ${t("session.useConfigHint", { provider: providerName })}`)
+	];
+}
+/**
 * 输出区域组件
 *
 * 管理所有输出内容的行缓冲，实现 pi-tui 的 render 接口。
@@ -6717,6 +8067,12 @@ var ReplSession = class {
 		const theme = createTheme(this.options.color);
 		const terminal = new ProcessTerminal();
 		this.tui = new TUI(terminal);
+		getKeybindings().setUserBindings({
+			"tui.select.up": ["up", "k"],
+			"tui.select.down": ["down", "j"],
+			"tui.select.cancel": ["escape", "h"],
+			"tui.select.confirm": ["enter", "l"]
+		});
 		this.outputArea = new OutputArea();
 		this.editor = new ZapmycoEditor(this.tui, theme.editorTheme);
 		const root = new Container();
@@ -6758,7 +8114,8 @@ var ReplSession = class {
 	async start() {
 		this._state = "idle";
 		this.updateStatsState();
-		this.outputArea.append(["ZapMyco: 欢迎回来!", ""]);
+		setLocale(this.config.locale ?? "zh-CN");
+		this.outputArea.append([t("session.welcome"), ""]);
 		this.tui.start();
 	}
 	/** 优雅关闭会话 */
@@ -6768,6 +8125,7 @@ var ReplSession = class {
 		this.updateStatsState();
 		log.info("REPL 关闭", { reason: reason ?? "未知" });
 		this.cancelCurrentTask();
+		this.editor.setExecuting(false);
 		eventBus.emit("system:shutdown", { reason });
 		if (this.cronScheduler) {
 			this.cronScheduler.stop();
@@ -6778,11 +8136,16 @@ var ReplSession = class {
 			this.mcpManager = null;
 		}
 		this.tui.stop();
+		process.exit(0);
 	}
 	/** 获取渲染器引用 */
 	getRenderer() {
 		return this.renderer;
 	}
+	/** 获取 TUI 实例（用于显示 overlay 菜单） */
+	getTui() {
+		return this.tui;
+	}
 	/** 获取历史存储引用 */
 	getHistoryStore() {
 		return this.history;
@@ -6813,6 +8176,12 @@ var ReplSession = class {
 		let historyEntry;
 		const taskId = `task-${Date.now()}`;
 		const ZAPMYCO_PREFIX = "ZapMyco: ";
+		const THINKING_PREFIX = "  💭 ";
+		const colorEnabled = this.options.color;
+		const userStyle = (s) => colorEnabled ? chalk.bold.cyan(s) : s;
+		const responseStyle = (s) => s;
+		const toolStyle = (s) => colorEnabled ? chalk.yellow(s) : s;
+		const thinkingStyle = (s) => colorEnabled ? chalk.gray(s) : s;
 		let spinnerActive = true;
 		let spinnerInterval;
 		try {
@@ -6828,37 +8197,64 @@ var ReplSession = class {
 				goalId: `goal-${startTime}`,
 				rawInput
 			});
-			this.outputArea.append([`Me: ${rawInput}`, ZAPMYCO_PREFIX + LOADING_FRAMES[0]]);
+			this.outputArea.append([userStyle(`Me: ${rawInput}`), responseStyle(ZAPMYCO_PREFIX + LOADING_FRAMES[0])]);
 			let spinnerFrame = 0;
 			spinnerActive = true;
 			spinnerInterval = setInterval(() => {
 				if (!spinnerActive) return;
 				spinnerFrame = (spinnerFrame + 1) % LOADING_FRAMES.length;
-				this.outputArea.replaceLastLine(ZAPMYCO_PREFIX + LOADING_FRAMES[spinnerFrame]);
+				this.outputArea.replaceLastLine(responseStyle(ZAPMYCO_PREFIX + LOADING_FRAMES[spinnerFrame]));
 				this.tui.requestRender();
 			}, 100);
 			let firstOutputReceived = false;
+			let outputAccumulator = "";
+			let thinkingAccumulator = "";
+			let streamMode = "response";
 			const outputHandler = (event) => {
-				if (event.taskId === taskId) {
-					if (!firstOutputReceived) {
-						firstOutputReceived = true;
-						spinnerActive = false;
-						clearInterval(spinnerInterval);
-						this.outputArea.replaceLastLine(ZAPMYCO_PREFIX + event.text);
-					} else this.outputArea.appendText(event.text);
-					this.tui.requestRender();
+				if (event.taskId !== taskId || !event.text) return;
+				if (!firstOutputReceived) {
+					firstOutputReceived = true;
+					spinnerActive = false;
+					clearInterval(spinnerInterval);
+					streamMode = "response";
+					thinkingAccumulator = "";
+					outputAccumulator = event.text;
+					this.outputArea.replaceLastLine(responseStyle(ZAPMYCO_PREFIX + outputAccumulator));
+				} else if (streamMode !== "response") {
+					streamMode = "response";
+					thinkingAccumulator = "";
+					outputAccumulator = event.text;
+					this.outputArea.append([responseStyle(ZAPMYCO_PREFIX + outputAccumulator)]);
+				} else {
+					outputAccumulator += event.text;
+					this.outputArea.replaceLastLine(responseStyle(ZAPMYCO_PREFIX + outputAccumulator));
 				}
+				this.tui.requestRender();
+			};
+			const thinkingHandler = (event) => {
+				if (event.taskId !== taskId || !event.text) return;
+				if (streamMode !== "thinking") {
+					streamMode = "thinking";
+					outputAccumulator = "";
+					thinkingAccumulator = event.text;
+					this.outputArea.append([thinkingStyle(THINKING_PREFIX + thinkingAccumulator)]);
+				} else {
+					thinkingAccumulator += event.text;
+					this.outputArea.replaceLastLine(thinkingStyle(THINKING_PREFIX + thinkingAccumulator));
+				}
+				this.tui.requestRender();
 			};
 			const errorHandler = (event) => {
 				if (event.taskId === taskId) log.error("Agent 执行中收到 error 事件", { error: event.error.message });
 			};
 			const progressHandler = (event) => {
 				if (event.taskId === taskId && event.percent === 0) {
-					this.outputArea.append([`  → ${event.message}`]);
+					this.outputArea.append([toolStyle(`  → ${event.message}`)]);
 					this.tui.requestRender();
 				}
 			};
 			this.agent.on(this.agent.EVENT_OUTPUT, outputHandler);
+			this.agent.on(this.agent.EVENT_THINKING, thinkingHandler);
 			this.agent.on(this.agent.EVENT_ERROR, errorHandler);
 			this.agent.on(this.agent.EVENT_PROGRESS, progressHandler);
 			this.currentTaskId = taskId;
@@ -6876,6 +8272,7 @@ var ReplSession = class {
 				}
 			});
 			this.agent.off(this.agent.EVENT_OUTPUT, outputHandler);
+			this.agent.off(this.agent.EVENT_THINKING, thinkingHandler);
 			this.agent.off(this.agent.EVENT_ERROR, errorHandler);
 			this.agent.off(this.agent.EVENT_PROGRESS, progressHandler);
 			log.debug("Agent 执行完成", {
@@ -6888,11 +8285,50 @@ var ReplSession = class {
 			if (spinnerActive) {
 				spinnerActive = false;
 				clearInterval(spinnerInterval);
-				if (outputText) this.outputArea.replaceLastLine(ZAPMYCO_PREFIX + outputText);
+				if (outputText) this.outputArea.replaceLastLine(responseStyle(ZAPMYCO_PREFIX + outputText));
+				else if (taskResult.status !== "success") {
+					const errorMsg = taskResult.error?.message ?? t("session.agentErrorMessage");
+					this.outputArea.replaceLastLine(chalk.red(`ZapMyco: ${t("session.errorPrefix")} ${errorMsg}`));
+					const helpLines = getApiKeyErrorHelp(errorMsg);
+					if (helpLines.length > 0) {
+						this.outputArea.append(helpLines);
+						const providerMatch = errorMsg.match(/No API key for provider: (\w+)/);
+						if (providerMatch) {
+							const providerName = providerMatch[1];
+							this.outputArea.append([""]);
+							if ((await showSelectList(this.tui, [{
+								value: "yes",
+								label: "好的，我来输入 API Key",
+								description: `直接输入 ${providerName} 的 API Key，立即配置并重试`
+							}, {
+								value: "no",
+								label: "稍后再说",
+								description: "回到对话"
+							}], { title: `需要配置 ${providerName} 的 API Key` }))?.value === "yes") {
+								const apiKey = await showTextInput(this.tui, `请输入 ${providerName} 的 API Key:`, "", "sk-...");
+								if (apiKey && apiKey.length > 0) {
+									const dotPath = `llm.providers.${providerName}.apiKey`;
+									const settings = readSettings();
+									_setByDotPath(settings, dotPath, apiKey);
+									writeSettings(settings);
+									_setByDotPath(this.config, dotPath, apiKey);
+									this.applyConfigUpdate(dotPath);
+									this.outputArea.append([
+										"",
+										chalk.green(`已配置 ${providerName} 的 API Key，正在重试...`),
+										""
+									]);
+									return await this.executeGoal(rawInput);
+								}
+							}
+							this.outputArea.append([""]);
+						}
+					}
+				} else this.outputArea.replaceLastLine(chalk.red(`ZapMyco: ${t("session.errorPrefix")} ${t("session.noContentError")}`));
 			}
 			if (taskResult.status !== "success") {
-				const errorMsg = taskResult.error?.message ?? "Agent 执行失败（无详细错误信息）";
-				this.outputArea.appendText(`[错误] ${errorMsg}`);
+				const errorMsg = taskResult.error?.message ?? t("session.agentErrorMessage");
+				if (!spinnerActive || outputText) this.outputArea.appendText(`${t("session.errorPrefix")} ${errorMsg}`);
 				log.error("Agent 执行返回 failure", {
 					taskId,
 					error: taskResult.error,
@@ -6946,7 +8382,42 @@ var ReplSession = class {
 				goalId: `goal-${startTime}`,
 				error: err
 			});
-			this.outputArea.replaceLastLine(`ZapMyco: [错误] ${err.message}`);
+			this.outputArea.replaceLastLine(responseStyle(`${ZAPMYCO_PREFIX}${t("session.errorPrefix")} ${err.message}`));
+			const helpLines = getApiKeyErrorHelp(err.message);
+			if (helpLines.length > 0) {
+				this.outputArea.append(helpLines);
+				const providerMatch = err.message.match(/No API key for provider: (\w+)/);
+				if (providerMatch) {
+					const providerName = providerMatch[1];
+					this.outputArea.append([""]);
+					if ((await showSelectList(this.tui, [{
+						value: "yes",
+						label: "好的，我来输入 API Key",
+						description: `直接输入 ${providerName} 的 API Key，立即配置并重试`
+					}, {
+						value: "no",
+						label: "稍后再说",
+						description: "回到对话"
+					}], { title: `需要配置 ${providerName} 的 API Key` }))?.value === "yes") {
+						const apiKey = await showTextInput(this.tui, `请输入 ${providerName} 的 API Key:`, "", "sk-...");
+						if (apiKey && apiKey.length > 0) {
+							const dotPath = `llm.providers.${providerName}.apiKey`;
+							const settings = readSettings();
+							_setByDotPath(settings, dotPath, apiKey);
+							writeSettings(settings);
+							_setByDotPath(this.config, dotPath, apiKey);
+							this.applyConfigUpdate(dotPath);
+							this.outputArea.append([
+								"",
+								chalk.green(`已配置 ${providerName} 的 API Key，正在重试...`),
+								""
+							]);
+							return await this.executeGoal(rawInput);
+						}
+					}
+					this.outputArea.append([""]);
+				}
+			}
 			const errorLines = this.renderer.renderError(err).slice(1);
 			if (errorLines.length > 0) this.outputArea.append(errorLines);
 			const duration = Date.now() - startTime;
@@ -7012,6 +8483,7 @@ var ReplSession = class {
 		this.registry.register(createConfigCommand());
 		this.registry.register(createAgentsCommand());
 		this.registry.register(createStatusCommand());
+		this.registry.register(createSettingsCommand());
 		this.buildAutocompleteProvider();
 	}
 	/** 构建并设置 autocomplete provider，将命令注册表中的命令接入 pi-tui 补全系统 */
@@ -7042,7 +8514,7 @@ var ReplSession = class {
 	createReplAgent() {
 		const agent = createLlmBasedAgent({
 			agentId: "repl-chat-agent",
-			displayName: "Zapmyco AI 助手",
+			displayName: t("session.displayName"),
 			capabilities: [{
 				id: "chat",
 				name: "对话",
@@ -7051,39 +8523,25 @@ var ReplSession = class {
 			}],
 			runtimeConfig: this.config.agentRuntime ?? {}
 		});
-		agent.innerAgent.state.model = this.resolveModelForAgent();
-		agent.innerAgent.getApiKey = (_provider) => {
-			const modelKey = this.config.llm.defaultModel;
-			const providerName = this.config.llm.models[modelKey]?.provider;
-			if (providerName) return this.config.llm.providers[providerName]?.apiKey;
-		};
-		return agent;
-	}
-	/**
-	* 为 Agent 解析 pi-ai Model 对象
-	*
-	* 复用 PiAiProvider 的模型解析逻辑（parseModelKey + getModel），
-	* 但不依赖 chat/chatStream 方法。
-	*/
-	resolveModelForAgent() {
-		const modelKey = this.config.llm.defaultModel;
-		const parsed = parseModelKey(modelKey);
-		if (!parsed) throw new Error(`无效的模型标识符: ${modelKey}`);
-		const modelConfig = this.config.llm.models[modelKey];
-		const provider = modelConfig?.provider ?? parsed.provider;
-		const modelId = modelConfig?.modelId ?? parsed.modelId;
-		const baseModelId = provider === "anthropic" ? "claude-sonnet-4-20250514" : modelId;
-		let model;
-		try {
-			model = getModel(provider, baseModelId);
-		} catch {
-			model = getModel("anthropic", "claude-sonnet-4-20250514");
+		const facade = new AgentLlmFacade(this.config.llm);
+		agent.innerAgent.state.model = facade.resolvePiModel();
+		agent.innerAgent.getApiKey = facade.createGetApiKeyFn();
+		agent.llmFacade = facade;
+		const defaultModelInfo = facade.getModelInfo();
+		if (defaultModelInfo) {
+			if (!facade.getApiKey(defaultModelInfo.provider)) {
+				const providerName = defaultModelInfo.provider;
+				const envVar = providerName.toUpperCase() + "_API_KEY";
+				this.outputArea.append([
+					chalk.red(`[!] 提供商 "${providerName}" 没有配置 API Key`),
+					chalk.yellow(`    请设置环境变量: export ${envVar}=<your-key>`),
+					chalk.yellow(`    或在 REPL 中使用: /config set llm.providers.${providerName}.apiKey <your-key>`),
+					""
+				]);
+				log.warn("默认提供商缺少 API Key", { provider: providerName });
+			}
 		}
-		if (!model) throw new Error(`无法初始化模型 ${modelKey}：pi-ai 返回了无效的模型对象`);
-		model.name = modelKey;
-		model.id = modelId;
-		if (modelConfig?.baseUrl) model.baseUrl = modelConfig.baseUrl;
-		return model;
+		return agent;
 	}
 	/**
 	* 注册 REPL 场景下的基础工具
@@ -7173,6 +8631,8 @@ var ReplSession = class {
 			}
 			ctrlCPressCount++;
 			if (ctrlCPressCount >= 2) {
+				clearTimeout(ctrlCTimer);
+				ctrlCTimer = void 0;
 				this.shutdown("用户连续按下 Ctrl+C");
 				return;
 			}
@@ -7189,6 +8649,7 @@ var ReplSession = class {
 		this.editor.onCtrlD = () => {
 			this.shutdown("收到 EOF (Ctrl+D)");
 		};
+		this.editor.onOpenEditor = () => this.openInEditor();
 	}
 	/** 设置信号处理 */
 	setupSignalHandlers() {
@@ -7211,6 +8672,71 @@ var ReplSession = class {
 			this.currentTaskAbort = null;
 		}
 	}
+	/**
+	* 打开外部编辑器（vim / $EDITOR）编辑当前输入内容
+	*
+	* 流程：
+	* 1. 将编辑器当前文本写入临时文件
+	* 2. 暂停 TUI（恢复终端 cooked 模式）
+	* 3. 启动外部编辑器，用户编辑并保存退出
+	* 4. 读取编辑后的内容并更新编辑器
+	* 5. 恢复 TUI 并重绘
+	*/
+	openInEditor() {
+		const tmpFile = join(tmpdir(), "zapmyco-editor-input.txt");
+		let tuiStopped = false;
+		try {
+			const currentText = this.editor.getExpandedText();
+			writeFileSync(tmpFile, currentText, "utf-8");
+			this.tui.stop();
+			tuiStopped = true;
+			const editorCmd = process.env.VISUAL || process.env.EDITOR || "vim";
+			const result = spawnSync(editorCmd, [tmpFile], { stdio: "inherit" });
+			const newText = readFileSync(tmpFile, "utf-8");
+			if (newText !== currentText) this.editor.setText(newText);
+			if (result.error) {
+				const err = result.error;
+				if (err.code === "ENOENT") this.outputArea.append([
+					"",
+					t("session.editorNotFound", { cmd: editorCmd }),
+					""
+				]);
+				else this.outputArea.append([
+					"",
+					`编辑器启动失败: ${err.message}`,
+					""
+				]);
+			}
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			this.outputArea.append([
+				"",
+				t("session.editorFailed", { message }),
+				""
+			]);
+		} finally {
+			if (tuiStopped) {
+				this.tui.start();
+				this.tui.requestRender(true);
+			}
+			try {
+				unlinkSync(tmpFile);
+			} catch {}
+		}
+	}
+	/**
+	* 应用配置更新到运行中的 Agent（无需重启）
+	*
+	* 当前处理以 "llm." 开头的配置变更，重新创建 AgentLlmFacade
+	* 并注入到运行中的 Agent 实例，使新 Key/模型立即生效。
+	*/
+	applyConfigUpdate(key) {
+		if (!key.startsWith("llm.")) return;
+		const newFacade = new AgentLlmFacade(this.config.llm);
+		this.agent.innerAgent.state.model = newFacade.resolvePiModel();
+		this.agent.innerAgent.getApiKey = newFacade.createGetApiKeyFn();
+		this.agent.llmFacade = newFacade;
+	}
 	/** 更新统计中的状态字段 */
 	updateStatsState() {
 		this.stats.state = this._state;
@@ -7255,7 +8781,7 @@ async function startRepl() {
 *   zapmyco version      显示版本号
 */
 const program = new Command();
-program.name(APP_NAME).description("AI 原生并行任务编排系统 -- AI 总管").version(__VERSION__, "-v, --version", "显示版本号").helpOption("-h, --help", "显示帮助信息");
+program.name(APP_NAME).description("AI 原生并行任务编排系统 -- AI 总管").version(VERSION, "-v, --version", "显示版本号").helpOption("-h, --help", "显示帮助信息");
 program.action(async () => {
 	try {
 		await startRepl();