zapmyco 0.4.0 → 0.7.0

package/dist/cli/index.mjs

@@ -1,25 +1,25 @@
 #!/usr/bin/env node
-import { D as buildSkillSnapshot, E as eventBus, M as __VERSION__, N as __require, O as loadSkills, _ as createLlmBasedAgent, a as SubAgentManager, h as ZapmycoErrorCode, j as APP_NAME, p as WebError, s as logger, t as loadConfig } from "../loader-BK1Z72gI.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-B5_elj6d.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 { 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 TurndownService from "turndown";
 import { lookup } from "node:dns/promises";
 import { Client } from "@modelcontextprotocol/sdk/client";
 import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
 
 //#region src/cli/repl/command-registry.ts
-const log$5 = logger.child("repl:command-registry");
+const log$6 = logger.child("repl:command-registry");
 /**
 * 命令注册表
 */
@@ -34,7 +34,7 @@ var CommandRegistry = class {
 	*/
 	register(cmd) {
 		const canonicalName = cmd.name.toLowerCase();
-		if (this.commands.has(canonicalName)) log$5.warn(`命令 "${canonicalName}" 已存在，将被覆盖`);
+		if (this.commands.has(canonicalName)) log$6.warn(`命令 "${canonicalName}" 已存在，将被覆盖`);
 		this.commands.set(canonicalName, cmd);
 		for (const alias of cmd.aliases) {
 			const lowerAlias = alias.toLowerCase();
@@ -62,7 +62,7 @@ var CommandRegistry = class {
 	*/
 	async dispatch(parsed) {
 		if (parsed.kind !== "command") {
-			log$5.warn("dispatch 收到了非 command 类型的输入");
+			log$6.warn("dispatch 收到了非 command 类型的输入");
 			return;
 		}
 		const cmd = this.getCommand(parsed.name);
@@ -74,7 +74,7 @@ var CommandRegistry = class {
 			await cmd.handler(parsed.args, this.session);
 		} catch (error) {
 			const message = error instanceof Error ? error.message : String(error);
-			log$5.error(`命令 /${cmd.name} 执行出错`, {}, error);
+			log$6.error(`命令 /${cmd.name} 执行出错`, {}, error);
 			console.log(`\n  命令执行出错: ${message}\n`);
 		}
 	}
@@ -140,14 +140,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 +220,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 +232,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 +365,840 @@ function createQuitCommand() {
 	};
 }
 
+//#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("  输入文字搜索  ·  ↑↓ 导航  ·  Enter 确认  ·  Esc 取消"));
+			else lines.push(chalk.gray("  k/j ↑↓ 导航  ·  / 搜索  ·  Enter 选择  ·  Esc/q 退出  ·  BS/h 返回"));
+		} else if (this.isFiltering) lines.push(chalk.gray("  Enter 确认  ·  Esc 取消"));
+		else lines.push(chalk.gray("  ↑↓=k/j  /  Enter  Esc/q  BS/h"));
+		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("  Enter to confirm · Esc to cancel"),
+			""
+		];
+	}
+};
+/**
+* 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("  q/Esc 返回")
+		];
+		return [
+			...this.lines,
+			"",
+			chalk.gray(`  ${"─".repeat(Math.max(0, width - 4))}`),
+			chalk.gray("  q/Esc 返回  ·  Enter/BS/h 返回菜单"),
+			""
+		];
+	}
+};
+/**
+* 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"
+	}
+];
+/** 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 = ["", "Known providers:"];
+			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([
+					"",
+					"Usage: /settings list-models <provider>",
+					""
+				]);
+				return;
+			}
+			const modelIds = getProviderModels(config, args[1]);
+			if (modelIds.length === 0) {
+				session.appendOutput([
+					"",
+					`Provider "${args[1]}" has no known models`,
+					"Hint: use /settings to configure this provider first",
+					""
+				]);
+				return;
+			}
+			session.appendOutput([
+				"",
+				`${args[1]} available models:`,
+				...modelIds.map((id) => `  - ${id}`),
+				""
+			]);
+			return;
+		}
+		default: session.appendOutput([
+			"",
+			"Usage:",
+			"  /settings                    — Open interactive configuration menu",
+			"  /settings list-providers     — List all known providers",
+			"  /settings list-models <name> — List available models for a provider",
+			""
+		]);
+	}
+}
+/**
+* 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: `Use env var ${"${" + envVarName + "}"}`,
+				description: "Recommended — more secure"
+			},
+			{
+				value: "manual",
+				label: "Enter manually",
+				description: "Type the key directly (stored in plaintext in settings.json)"
+			},
+			{
+				value: "clear",
+				label: "Clear",
+				description: "Remove the configured key"
+			}
+		], { onExit: exitAll });
+		if (!choice) return;
+		if (choice.value === "clear") {
+			setConfigValue(session, `llm.providers.${providerName}.apiKey`, "");
+			session.appendOutput([
+				"",
+				`  [ok] Cleared API key for ${providerName}`,
+				""
+			]);
+		} else if (choice.value === "env") {
+			setConfigValue(session, `llm.providers.${providerName}.apiKey`, `\${${envVarName}}`);
+			session.appendOutput([
+				"",
+				`  [ok] Set ${providerName} API key to env var \${${envVarName}}`,
+				`  Make sure ${envVarName} is set in your shell`,
+				""
+			]);
+		} 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([
+					"",
+					`  [ok] Configured API key for ${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([
+					"",
+					`  [ok] Reset ${providerName} Base URL to default`,
+					""
+				]);
+			} else {
+				setConfigValue(session, configPath, url);
+				session.appendOutput([
+					"",
+					`  [ok] Set ${providerName} Base URL: ${url}`,
+					""
+				]);
+			}
+		}
+	};
+	/**
+	* Handle model selection
+	*/
+	const handleModelSelect = async (providerName) => {
+		const modelIds = getProviderModels(state.current, providerName);
+		if (modelIds.length === 0) {
+			session.appendOutput([
+				"",
+				`  ${providerName} has no available model list`,
+				"  Configure models manually in settings.json or check the provider name",
+				""
+			]);
+			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([
+				"",
+				`  [ok] Selected 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([
+				"",
+				"  Configure a model first before setting it as default",
+				""
+			]);
+			return;
+		}
+		const modelKey = `${providerName}/${modelIds[0]}`;
+		setConfigValue(session, "llm.defaultModel", modelKey);
+		session.appendOutput([
+			"",
+			`  [ok] Default model set to: ${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: "Default Model",
+				description: String(_getByDotPath(state.current, "llm.defaultModel") ?? "not configured")
+			},
+			{
+				value: "manage-providers",
+				label: "Manage Providers",
+				description: providerCount > 0 ? `${providerCount} configured` : "none configured"
+			},
+			{
+				value: "view-config",
+				label: "View Config",
+				description: "Display full configuration details"
+			}
+		], { 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("未配置 - Enter 设置 API Key")
+					});
+				}
+			}
+			const modelItems = [...enabledItems, ...disabledItems];
+			if (modelItems.length === 0) {
+				session.appendOutput([
+					"",
+					"  No models available from pi-ai registry",
+					""
+				]);
+				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([
+					"",
+					`  [ok] Default model set to: ${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([
+						"",
+						`  [ok] Default model set to: ${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 ? "key configured" : "no key"
+				};
+			}), {
+				value: "add-provider",
+				label: "Add Provider",
+				description: "Select from a list of known providers"
+			}], { 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: "Configure API Key",
+						description: ""
+					},
+					{
+						value: "model",
+						label: "Select Model",
+						description: ""
+					},
+					{
+						value: "base-url",
+						label: "Base URL",
+						description: ""
+					},
+					{
+						value: "set-default",
+						label: "Set as Default",
+						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 ? `API format: ${p.apiFormat}` : "OpenAI compatible"
+				})), {
+					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} already exists, use the provider entry to configure it`,
+						""
+					]);
+					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([
+					"",
+					`  [ok] Added provider: ${providerName}`,
+					""
+				]);
+				if ((await showSelectList(tui, [{
+					value: "yes",
+					label: "Yes, configure API Key now",
+					description: "Go to API Key settings"
+				}, {
+					value: "no",
+					label: "Later",
+					description: "Return to main menu"
+				}], { onExit: exitAll }))?.value === "yes") await handleApiKeyConfig(providerName, "");
+			}
+		} else if (value === "view-config") {
+			const renderer = session.getRenderer();
+			await showConfigView(tui, session.config, renderer);
+		}
+	}
+}
+
 //#endregion
 //#region src/cli/repl/commands/status.ts
 /**
@@ -321,6 +1226,7 @@ function createStatusCommand() {
 * 继承自 pi-tui 的 Editor，添加 zapmyco 特有的快捷键处理：
 * - Ctrl+C: 取消任务 / 二次退出
 * - Ctrl+D: 退出
+* - Ctrl+O: 打开外部编辑器编辑输入
 * - Escape: 取消当前输入
 *
 * 同时 override render() 以：
@@ -357,8 +1263,12 @@ var ZapmycoEditor = class extends Editor {
 	onCtrlC;
 	/** Ctrl+D 回调 */
 	onCtrlD;
+	/** Ctrl+O 回调（打开外部编辑器） */
+	onOpenEditor;
 	/** 是否正在执行（用于显示 loading） */
 	#executing = false;
+	/** 是否显示 spinner（执行期间禁用输入但不一定显示 spinner） */
+	#showSpinner = true;
 	/** loading 动画帧索引 */
 	#loadingFrame = 0;
 	/** loading 动画定时器 */
@@ -376,15 +1286,22 @@ 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);
 	}
 	/**
 	* 设置执行状态（控制 loading spinner 显示）
+	* @param executing 是否正在执行
+	* @param showSpinner 是否显示 spinner（默认 true）。设为 false 时仅禁用输入，不显示动画
 	*/
-	setExecuting(executing) {
-		if (this.#executing === executing) return;
+	setExecuting(executing, showSpinner = true) {
+		if (this.#executing === executing && this.#showSpinner === showSpinner) return;
 		this.#executing = executing;
-		if (executing) {
+		this.#showSpinner = showSpinner;
+		if (executing && showSpinner) {
 			this.#loadingFrame = 0;
 			this.#loadingTimer = setInterval(() => {
 				this.#loadingFrame = (this.#loadingFrame + 1) % LOADING_FRAMES.length;
@@ -417,7 +1334,7 @@ var ZapmycoEditor = class extends Editor {
 		for (let i = 0; i < contentLines.length; i++) {
 			const prefix = i === 0 ? PROMPT_PREFIX : " ".repeat(promptWidth);
 			let line;
-			if (i === 0 && this.#executing) line = `${prefix}${LOADING_FRAMES[this.#loadingFrame]} ${contentLines[i]}`;
+			if (i === 0 && this.#executing && this.#showSpinner) line = `${prefix}${LOADING_FRAMES[this.#loadingFrame]} ${contentLines[i]}`;
 			else line = prefix + contentLines[i];
 			contentLines[i] = truncateToWidth(line, width);
 		}
@@ -718,7 +1635,7 @@ const CRON_CONSTANTS = {
 *
 * @module cli/repl/cron/cron-scheduler
 */
-const log$4 = logger.child("cron:scheduler");
+const log$5 = logger.child("cron:scheduler");
 var CronScheduler = class extends EventEmitter {
 	store;
 	jobs = [];
@@ -739,7 +1656,7 @@ var CronScheduler = class extends EventEmitter {
 		if (this.running) return;
 		const loadedJobs = await this.store.load();
 		this.jobs = loadedJobs;
-		log$4.info(`调度器启动，加载 ${loadedJobs.length} 个 durable 任务`);
+		log$5.info(`调度器启动，加载 ${loadedJobs.length} 个 durable 任务`);
 		await this.handleMissedJobs();
 		this.checkAutoExpiry();
 		this.running = true;
@@ -755,7 +1672,7 @@ var CronScheduler = class extends EventEmitter {
 			clearInterval(this.timer);
 			this.timer = null;
 		}
-		log$4.info("调度器已停止");
+		log$5.info("调度器已停止");
 	}
 	/** 添加任务 */
 	async addJob(job) {
@@ -767,7 +1684,7 @@ var CronScheduler = class extends EventEmitter {
 			this.jobs.push(job);
 			await this.store.persist(this.jobs);
 		} else this.sessionJobs.push(job);
-		log$4.info("任务已添加", {
+		log$5.info("任务已添加", {
 			id: job.id,
 			cron: job.cron,
 			durable: job.durable
@@ -897,7 +1814,7 @@ var CronScheduler = class extends EventEmitter {
 			}, delay);
 		}
 		if (toDelete.length > 0) {
-			log$4.info(`跳过 ${toDelete.length} 个错过的一次性任务（超出补发上限）`);
+			log$5.info(`跳过 ${toDelete.length} 个错过的一次性任务（超出补发上限）`);
 			this.emit("missed-overflow", {
 				count: toDelete.length,
 				jobIds: toDelete.map((m) => m.id)
@@ -915,7 +1832,7 @@ var CronScheduler = class extends EventEmitter {
 				job.lastFiredAt = now;
 				job.fireCount++;
 				this.removeJob(job.id);
-				log$4.info("任务已过期并触发最后一次", { id: job.id });
+				log$5.info("任务已过期并触发最后一次", { id: job.id });
 			}
 		}
 	}
@@ -976,7 +1893,7 @@ function applyOneShotJitter(jobId, rawNext) {
 *
 * @module cli/repl/cron/cron-store
 */
-const log$3 = logger.child("cron:store");
+const log$4 = logger.child("cron:store");
 const STORE_FILE = join(join(homedir(), ".zapmyco", "cron"), "scheduled_tasks.json");
 var CronStore = class {
 	filePath;
@@ -1000,13 +1917,13 @@ var CronStore = class {
 			const raw = await readFile(this.filePath, "utf-8");
 			const data = JSON.parse(raw);
 			if (!Array.isArray(data)) {
-				log$3.warn("存储文件格式无效（非数组），将使用空列表");
+				log$4.warn("存储文件格式无效（非数组），将使用空列表");
 				return [];
 			}
 			return this.validateJobs(data);
 		} catch (err) {
 			if (err.code === "ENOENT") return [];
-			log$3.warn("加载定时任务文件失败，将使用空列表", { error: err instanceof Error ? err.message : String(err) });
+			log$4.warn("加载定时任务文件失败，将使用空列表", { error: err instanceof Error ? err.message : String(err) });
 			return [];
 		}
 	}
@@ -1053,7 +1970,7 @@ var CronStore = class {
 			if (typeof obj.maxFires === "number") job.maxFires = obj.maxFires;
 			valid.push(job);
 		}
-		if (valid.length < raw.length) log$3.warn(`跳过 ${raw.length - valid.length} 个无效任务条目`);
+		if (valid.length < raw.length) log$4.warn(`跳过 ${raw.length - valid.length} 个无效任务条目`);
 		return valid;
 	}
 };
@@ -1065,8 +1982,19 @@ function getCronStore() {
 
 //#endregion
 //#region src/cli/repl/history-store.ts
+/**
+* 会话历史存储
+*
+* 基于内存的环形缓冲区，记录 REPL 会话中的用户输入和执行结果。
+* 支持文件持久化到 ~/.zapmyco/history.json，跨会话恢复。
+*/
+const log$3 = logger.child("history:store");
 /** 默认最大历史条数 */
 const DEFAULT_MAX_SIZE = 100;
+/** 历史文件存储路径 */
+function getHistoryFilePath() {
+	return join(homedir(), SESSION_DIR_NAME, "history.json");
+}
 /**
 * 历史存储类
 */
@@ -1074,8 +2002,11 @@ var HistoryStore = class {
 	entries = [];
 	nextId = 1;
 	maxSize;
+	filePath;
 	constructor(maxSize = DEFAULT_MAX_SIZE) {
 		this.maxSize = maxSize;
+		this.filePath = getHistoryFilePath();
+		this.load();
 	}
 	/** 添加条目 */
 	push(entry) {
@@ -1085,6 +2016,7 @@ var HistoryStore = class {
 		};
 		this.entries.push(newEntry);
 		if (this.entries.length > this.maxSize) this.entries.shift();
+		this.save();
 		return newEntry;
 	}
 	/** 获取所有条目 */
@@ -1096,16 +2028,52 @@ var HistoryStore = class {
 		const count = Math.min(n, this.entries.length);
 		return this.entries.slice(-count);
 	}
-	/** 清空所有条目 */
+	/** 清空所有条目（同时清除持久化文件） */
 	clear() {
 		this.entries = [];
+		this.save();
 	}
 	/** 搜索条目（按输入内容模糊匹配） */
 	search(query) {
 		const lowerQuery = query.toLowerCase();
 		return this.entries.filter((entry) => entry.input.toLowerCase().includes(lowerQuery));
 	}
+	/** 从文件加载历史记录 */
+	load() {
+		try {
+			ensureDir(dirname(this.filePath));
+			const raw = readFileSync(this.filePath, "utf-8");
+			const data = JSON.parse(raw);
+			if (Array.isArray(data.entries)) {
+				this.entries = data.entries.slice(-this.maxSize);
+				this.nextId = typeof data.nextId === "number" ? data.nextId : 1;
+				log$3.debug("历史记录已加载", {
+					count: this.entries.length,
+					nextId: this.nextId
+				});
+			}
+		} catch {
+			log$3.debug("无历史文件或加载失败，使用空历史");
+		}
+	}
+	/** 持久化历史记录到文件 */
+	save() {
+		try {
+			ensureDir(dirname(this.filePath));
+			const data = JSON.stringify({
+				entries: this.entries,
+				nextId: this.nextId
+			}, null, 2);
+			writeFileSync(this.filePath, data, "utf-8");
+		} catch (err) {
+			log$3.warn("历史记录保存失败", { error: err instanceof Error ? err.message : String(err) });
+		}
+	}
 };
+/** 确保目录存在 */
+function ensureDir(dir) {
+	mkdirSync(dir, { recursive: true });
+}
 
 //#endregion
 //#region src/cli/repl/input-parser.ts
@@ -1344,13 +2312,17 @@ var OutputFormatter = class {
 			c.bold("  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("(未配置)")}`);
+		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(`    提供商: ${defaultProvider}`);
+		lines.push(`    模型 ID: ${modelConfig?.id ?? defaultModelName}`);
+		if (modelConfig?.input && modelConfig.input.length > 0) lines.push(`    输入类型: ${modelConfig.input.join(", ")}`);
+		lines.push(`    API Key: ${providerConfig?.apiKey ? c.gray("***已配置***") : c.red("(未配置)")}`);
+		if (providerConfig?.apiFormat) lines.push(`    API 格式: ${providerConfig.apiFormat}`);
 		lines.push(c.bold("  调度器:"));
 		lines.push(`    最大并行: ${config.scheduler.maxConcurrency}`);
 		lines.push(`    单 Agent 最大并发: ${config.scheduler.maxPerAgent}`);
@@ -6557,26 +7529,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(`  请设置环境变量: export ${envVarName}=<your-api-key>`),
+		chalk.yellow(`  或在 REPL 中使用: /config set llm.providers.${providerName}.apiKey <your-key>`)
+	];
+}
+/**
 * 输出区域组件
 *
 * 管理所有输出内容的行缓冲，实现 pi-tui 的 render 接口。
@@ -6599,6 +7577,12 @@ var OutputArea = class extends Container {
 		else this.lines[this.lines.length - 1] += text;
 		this.invalidate();
 	}
+	/** 替换最后一行的完整内容（用于 spinner 动画和首 chunk 替换） */
+	replaceLastLine(text) {
+		if (this.lines.length > 0) this.lines[this.lines.length - 1] = text;
+		else this.lines.push(text);
+		this.invalidate();
+	}
 	/** 清空所有内容 */
 	clear() {
 		this.lines = [];
@@ -6655,6 +7639,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();
@@ -6666,6 +7656,7 @@ var ReplSession = class {
 		this.registry = new CommandRegistry(this);
 		this.renderer = new Renderer(this.options);
 		this.history = new HistoryStore(this.options.maxHistorySize);
+		for (const entry of this.history.getAll()) this.editor.addToHistory(entry.input);
 		this.agent = this.createReplAgent();
 		this.taskStore = new TaskStore();
 		this.taskStore.load();
@@ -6720,6 +7711,10 @@ var ReplSession = class {
 	getRenderer() {
 		return this.renderer;
 	}
+	/** 获取 TUI 实例（用于显示 overlay 菜单） */
+	getTui() {
+		return this.tui;
+	}
 	/** 获取历史存储引用 */
 	getHistoryStore() {
 		return this.history;
@@ -6749,10 +7744,19 @@ var ReplSession = class {
 		const startTime = Date.now();
 		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 {
 			this._state = "executing";
 			this.updateStatsState();
-			this.editor.setExecuting(true);
+			this.editor.setExecuting(true, false);
 			this.currentTaskAbort = new AbortController();
 			historyEntry = this.history.push({
 				timestamp: Date.now(),
@@ -6762,24 +7766,64 @@ var ReplSession = class {
 				goalId: `goal-${startTime}`,
 				rawInput
 			});
-			const goalLines = [`Me: ${rawInput}`, "ZapMyco: "];
-			this.outputArea.append(goalLines);
+			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(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) {
-					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;
@@ -6797,6 +7841,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 执行完成", {
@@ -6806,9 +7851,53 @@ var ReplSession = class {
 				duration: Date.now() - startTime
 			});
 			const outputText = typeof taskResult.output === "string" ? taskResult.output : taskResult.output != null ? JSON.stringify(taskResult.output) : null;
+			if (spinnerActive) {
+				spinnerActive = false;
+				clearInterval(spinnerInterval);
+				if (outputText) this.outputArea.replaceLastLine(responseStyle(ZAPMYCO_PREFIX + outputText));
+				else if (taskResult.status !== "success") {
+					const errorMsg = taskResult.error?.message ?? "Agent 执行失败（无详细错误信息）";
+					this.outputArea.replaceLastLine(chalk.red(`ZapMyco: [错误] ${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: [错误] 模型未返回任何内容，请检查 API Key 配置"));
+			}
 			if (taskResult.status !== "success") {
 				const errorMsg = taskResult.error?.message ?? "Agent 执行失败（无详细错误信息）";
-				this.outputArea.appendText(`[错误] ${errorMsg}`);
+				if (!spinnerActive || outputText) this.outputArea.appendText(`[错误] ${errorMsg}`);
 				log.error("Agent 执行返回 failure", {
 					taskId,
 					error: taskResult.error,
@@ -6854,14 +7943,52 @@ var ReplSession = class {
 		} catch (error) {
 			const err = error instanceof Error ? error : new Error(String(error));
 			log.error("目标执行失败", { input: rawInput }, err);
+			spinnerActive = false;
+			clearInterval(spinnerInterval);
 			this.stats.totalRequests++;
 			this.stats.failureCount++;
 			eventBus.emit("goal:failed", {
 				goalId: `goal-${startTime}`,
 				error: err
 			});
-			const errorLines = this.renderer.renderError(err);
-			this.outputArea.append(errorLines);
+			this.outputArea.replaceLastLine(responseStyle(`${ZAPMYCO_PREFIX}[错误] ${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;
 			return {
 				goalId: `goal-${startTime}`,
@@ -6878,6 +8005,8 @@ var ReplSession = class {
 				}
 			};
 		} finally {
+			spinnerActive = false;
+			if (spinnerInterval) clearInterval(spinnerInterval);
 			this._state = "idle";
 			this.updateStatsState();
 			this.editor.setExecuting(false);
@@ -6906,9 +8035,11 @@ var ReplSession = class {
 			case "incomplete": break;
 			case "command":
 				await this.registry.dispatch(parsed);
+				this.editor.addToHistory(line);
 				break;
 			case "goal":
 				await this.executeGoal(parsed.rawInput);
+				this.editor.addToHistory(line);
 				break;
 		}
 	}
@@ -6921,6 +8052,27 @@ 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 补全系统 */
+	buildAutocompleteProvider() {
+		const slashCommands = [];
+		for (const cmd of this.registry.listCommands()) {
+			const base = {
+				name: cmd.name,
+				description: cmd.description
+			};
+			if (cmd.usage !== `/${cmd.name}`) base.argumentHint = cmd.usage;
+			slashCommands.push(base);
+			for (const alias of cmd.aliases) slashCommands.push({
+				name: alias,
+				description: `${cmd.description}（别名: /${cmd.name}）`
+			});
+		}
+		const provider = new CombinedAutocompleteProvider(slashCommands, process.cwd(), null);
+		this.editor.setAutocompleteProvider(provider);
+		this.editor.setAutocompleteMaxVisible(12);
 	}
 	/**
 	* 创建 REPL 专用的 Agent 实例
@@ -6940,39 +8092,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 场景下的基础工具
@@ -7010,6 +8148,7 @@ var ReplSession = class {
 			const snapshot = buildSkillSnapshot(entries, skillConfig.maxSkillsInPrompt);
 			this.agent.skillPrompt = snapshot.prompt;
 			this._registerSkillCommands(entries);
+			this.buildAutocompleteProvider();
 			log.info("Skill 系统初始化完成", {
 				count: snapshot.count,
 				names: snapshot.names
@@ -7077,6 +8216,7 @@ var ReplSession = class {
 		this.editor.onCtrlD = () => {
 			this.shutdown("收到 EOF (Ctrl+D)");
 		};
+		this.editor.onOpenEditor = () => this.openInEditor();
 	}
 	/** 设置信号处理 */
 	setupSignalHandlers() {
@@ -7099,6 +8239,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([
+					"",
+					`未找到编辑器: ${editorCmd}，请设置 $EDITOR 环境变量`,
+					""
+				]);
+				else this.outputArea.append([
+					"",
+					`编辑器启动失败: ${err.message}`,
+					""
+				]);
+			}
+		} catch (err) {
+			const message = err instanceof Error ? err.message : String(err);
+			this.outputArea.append([
+				"",
+				`打开编辑器失败: ${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;
@@ -7118,7 +8323,14 @@ var ReplSession = class {
 * 加载配置 → 创建会话 → 进入输入循环
 */
 async function startRepl() {
-	await new ReplSession(await loadConfig()).start();
+	configureLogger({
+		logFilePath: join(homedir(), ".zapmyco", "logs", "zapmyco.log"),
+		quiet: true
+	});
+	const config = await loadConfig();
+	if (config.logging?.level) configureLogger({ level: config.logging.level });
+	if (config.logging?.file) configureLogger({ logFilePath: config.logging.file });
+	await new ReplSession(config).start();
 }
 
 //#endregion