min-agent 0.2.1 → 0.4.0

package/dist/tui/slash-handler.js

@@ -0,0 +1,545 @@
+export function sysMsg(tui, content) {
+    tui.addMessage({
+        id: `sys-${Date.now()}-${Math.random().toString(36).slice(2, 6)}`,
+        role: "system",
+        content,
+        timestamp: Date.now(),
+    });
+}
+export async function handleSlashCommand(input, tui, messages, currentModel, tracker, setModel, requestExit, state) {
+    const { parseSlashArgs } = await import("./slash-commands.js");
+    const parsed = parseSlashArgs(input);
+    const rawParts = input.slice(1).trim().split(/\s+/);
+    const cmd = (parsed?.command || rawParts[0] || "").toLowerCase();
+    const rest = parsed ? [...parsed.tokens, ...(parsed.partial ? [parsed.partial] : [])] : rawParts.slice(1);
+    const arg = rest.join(" ");
+    const { truncateDisplay } = await import("../tool-display.js");
+    switch (cmd) {
+        case "exit":
+        case "quit":
+        case "q":
+            requestExit();
+            break;
+        case "new":
+            state.startNewSession();
+            break;
+        case "undo": {
+            const { popTurn } = await import("./undo-stack.js");
+            const popped = popTurn(state.undoStack);
+            if (!popped) {
+                sysMsg(tui, "没有可撤销的内容");
+                break;
+            }
+            state.setUndoStack(popped.stack);
+            messages.splice(popped.turn.start, popped.turn.end - popped.turn.start);
+            tui.truncateMessages(popped.turn.uiEnd);
+            sysMsg(tui, "✓ 已撤销 1 轮");
+            break;
+        }
+        case "redo": {
+            if (!state.lastUserMessage) {
+                sysMsg(tui, "没有可重发的消息");
+                break;
+            }
+            const text = state.lastUserMessage;
+            tui.addMessage({ id: `user-${Date.now()}`, role: "user", content: text, timestamp: Date.now() });
+            messages.push({ role: "user", content: text });
+            return "run";
+        }
+        case "diff": {
+            const { getWorkingTreeDiff } = await import("./diff-view.js");
+            const result = await getWorkingTreeDiff();
+            if (!result.ok) {
+                const msg = result.reason === "not_git"
+                    ? "非 git 仓库，无法显示 diff"
+                    : result.reason === "no_changes"
+                        ? "工作区无未提交变更"
+                        : `diff 失败: ${result.message}`;
+                sysMsg(tui, msg);
+            }
+            else
+                sysMsg(tui, result.diff);
+            break;
+        }
+        case "plan": {
+            state.togglePlanMode();
+            sysMsg(tui, state.planMode ? "✓ 计划模式已开启：仅只读工具可用，输出计划后再次输入 /plan 确认并执行" : "✓ 已退出计划模式");
+            break;
+        }
+        case "reload":
+            await state.reloadSystemPrompt();
+            break;
+        case "resume":
+        case "sessions": {
+            const id = arg.trim();
+            if (!id) {
+                state.openSessionPicker();
+                break;
+            }
+            state.applySession(id);
+            break;
+        }
+        case "rename": {
+            const title = arg.trim();
+            if (!title) {
+                sysMsg(tui, "用法: /rename <标题>");
+                break;
+            }
+            const { saveSession, renameSession } = await import("../sessions.js");
+            let id = state.sessionId;
+            if (!id) {
+                id = saveSession(messages, undefined, undefined, undefined, state.taskState);
+                state.setSessionId(id);
+            }
+            if (renameSession(id, title))
+                sysMsg(tui, `✓ 会话已重命名为: ${title}`);
+            else
+                sysMsg(tui, "重命名失败: 会话不存在");
+            break;
+        }
+        case "attach":
+        case "image": {
+            const filePath = arg;
+            if (!filePath) {
+                sysMsg(tui, "用法: /attach <图片路径>");
+                break;
+            }
+            const { loadImageParts } = await import("../agent.js");
+            const notify = (kind, imgPath) => {
+                if (kind === "not_found")
+                    sysMsg(tui, `⚠ 图片不存在: ${imgPath}`);
+                else if (kind === "too_large")
+                    sysMsg(tui, `⚠ 图片超过 5MB 限制: ${imgPath}`);
+            };
+            const parts = [{ type: "text", text: "" }, ...loadImageParts([filePath], notify)];
+            if (parts.length <= 1)
+                break;
+            messages.push({ role: "user", content: parts });
+            tui.addMessage({
+                id: `user-${Date.now()}`,
+                role: "user",
+                content: `[📎 图片] ${filePath}`,
+                timestamp: Date.now(),
+            });
+            return "run";
+        }
+        case "compact": {
+            const { compactMessages } = await import("../compaction.js");
+            const { estimateTokens } = await import("../compaction.js");
+            const { resolveModel } = await import("../provider.js");
+            const { clearStack } = await import("./undo-stack.js");
+            if (messages.length < 4)
+                sysMsg(tui, "消息太少，无需压缩");
+            else {
+                sysMsg(tui, "⟳ 正在压缩上下文...");
+                const model = resolveModel(currentModel);
+                state.setUndoStack(clearStack(state.undoStack));
+                const result = await compactMessages(messages, model, {
+                    keepRecentTurns: 2,
+                    taskGoal: state.taskState.goal || undefined,
+                });
+                messages.length = 0;
+                messages.push(...result.messages);
+                if (tracker)
+                    tracker.resetContext();
+                sysMsg(tui, `✓ 已压缩 (约 ${estimateTokens(messages)} tokens)`);
+                const { snapshotTokenInfo } = await import("./token-info.js");
+                tui.setTokenInfo(await snapshotTokenInfo(tracker, currentModel, messages));
+            }
+            break;
+        }
+        case "provider": {
+            const { loadConfig, saveConfig } = await import("../config.js");
+            const cfg = loadConfig();
+            const providers = cfg.providers ?? [];
+            if (arg) {
+                const target = providers.find((p) => p.name === arg);
+                if (!target) {
+                    sysMsg(tui, `Provider "${arg}" 不存在`);
+                    break;
+                }
+                cfg.activeProvider = arg;
+                saveConfig(cfg);
+                setModel(target.defaultModel ?? "");
+                sysMsg(tui, `✓ 当前 Provider 已切换为: ${arg}`);
+            }
+            else {
+                if (providers.length === 0) {
+                    sysMsg(tui, "无已配置 Provider，运行: min-agent setup");
+                    break;
+                }
+                const lines = providers.map((p) => {
+                    const cur = p.name === cfg.activeProvider ? " ← 当前" : "";
+                    return `  ${p.name}  ${p.baseURL}${cur}`;
+                });
+                sysMsg(tui, `Providers:\n${lines.join("\n")}\n\n切换: /provider <name>`);
+            }
+            break;
+        }
+        case "model": {
+            if (arg) {
+                const config = await import("../config.js");
+                const cfg = config.loadConfig();
+                const provider = config.getActiveProvider(cfg);
+                if (provider) {
+                    provider.defaultModel = arg;
+                    config.saveConfig(cfg);
+                }
+                setModel(arg);
+                sysMsg(tui, `✓ 默认模型已设为: ${arg}`);
+            }
+            else
+                tui.showModelPicker();
+            break;
+        }
+        case "models": {
+            const { fetchModels } = await import("../config.js");
+            const { loadConfig, getActiveProvider } = await import("../config.js");
+            const cfg = loadConfig();
+            const provider = getActiveProvider(cfg);
+            if (!provider?.baseURL || !provider?.apiKey) {
+                sysMsg(tui, "未配置 Provider，运行: min-agent setup");
+                break;
+            }
+            sysMsg(tui, "正在获取模型列表...");
+            const models = await fetchModels(provider.baseURL, provider.apiKey);
+            if (models.length === 0)
+                sysMsg(tui, "无法获取模型列表");
+            else {
+                const lines = models.map((m) => {
+                    const marker = m === provider.defaultModel ? " ← 默认" : "";
+                    return `  ${m}${marker}`;
+                });
+                sysMsg(tui, `可用模型 (${models.length}):\n${lines.join("\n")}`);
+            }
+            break;
+        }
+        case "memory": {
+            const { takeScopeFlags, defaultMemoryScope } = await import("../memory.js");
+            const { scope, rest: memRest } = takeScopeFlags(rest);
+            const text = memRest.join(" ").trim();
+            if (text) {
+                const { addMemory } = await import("../memory.js");
+                const resolved = scope ?? defaultMemoryScope();
+                addMemory(text, [], resolved);
+                sysMsg(tui, `✓ 已保存${resolved === "project" ? "项目" : "全局"}记忆: "${text}"`);
+            }
+            else {
+                const { loadMemories } = await import("../memory.js");
+                const scopes = scope ? [scope] : ["project", "global"];
+                const sections = scopes.map((s) => {
+                    const memories = loadMemories(s);
+                    const label = s === "project" ? "项目记忆" : "全局记忆";
+                    if (memories.length === 0)
+                        return `${label}: 无`;
+                    const lines = memories.map((m, i) => {
+                        const tags = m.tags.length > 0 ? ` [${m.tags.join(", ")}]` : "";
+                        return `  #${i + 1}: ${m.content}${tags}`;
+                    });
+                    return `${label} (${memories.length}):\n${lines.join("\n")}`;
+                });
+                if (!scope && loadMemories("project").length === 0 && loadMemories("global").length === 0) {
+                    sysMsg(tui, "无已保存的记忆");
+                }
+                else
+                    sysMsg(tui, sections.join("\n"));
+            }
+            break;
+        }
+        case "path":
+        case "pwd":
+            sysMsg(tui, process.cwd());
+            break;
+        case "paste": {
+            const { getClipboardImage } = await import("../clipboard.js");
+            const img = getClipboardImage();
+            if (!img) {
+                sysMsg(tui, "剪贴板中未找到图片");
+                break;
+            }
+            sysMsg(tui, `📎 剪贴板图片 (${(img.data.length / 1024).toFixed(1)} KB)`);
+            const text = arg || "What's in this image?";
+            const content = [
+                { type: "text", text },
+                { type: "image", image: img.data, mimeType: img.mimeType },
+            ];
+            messages.push({ role: "user", content });
+            tui.addMessage({ id: `user-${Date.now()}`, role: "user", content: `${text} [📎 图片]`, timestamp: Date.now() });
+            return "run";
+        }
+        case "tokens": {
+            const { getContextWindowInfo } = await import("../context-window.js");
+            const { getModelPrice, estimateCost, formatCost } = await import("../pricing.js");
+            const { estimateTokens } = await import("../compaction.js");
+            const ctx = await getContextWindowInfo(currentModel);
+            const estimated = estimateTokens(messages);
+            const occupied = tracker.lastInputTokens > 0 ? tracker.lastInputTokens : estimated;
+            const pct = ctx.tokens > 0 && occupied > 0 ? Math.round((occupied / ctx.tokens) * 100) : 0;
+            const price = await getModelPrice(currentModel ?? "");
+            const cost = estimateCost({ inputTokens: tracker.totalInputTokens, outputTokens: tracker.totalOutputTokens }, price);
+            const occupancyNote = tracker.lastInputTokens > 0 ? "" : "，按对话内容估算";
+            const windowNote = ctx.source === "fallback" ? "，未读到接口窗口，按 512k 默认" : "";
+            sysMsg(tui, [
+                `上下文: ${occupied} / ${ctx.tokens} tokens (${pct}%${occupancyNote}${windowNote})`,
+                `累计: ${tracker.totalInputTokens} in / ${tracker.totalOutputTokens} out`,
+                ...(cost != null ? [`成本: 约 ${formatCost(cost)}`] : []),
+                `消息: ${messages.length}`,
+            ].join("\n"));
+            break;
+        }
+        case "budget": {
+            const { takeScopeFlags } = await import("../memory.js");
+            const { getBudgetSnapshot, setBudgetMaxCost } = await import("../config.js");
+            const { getModelPrice, estimateCost, formatCost } = await import("../pricing.js");
+            const { scope, rest: budgetRest } = takeScopeFlags(rest);
+            const amount = budgetRest.join(" ").trim();
+            if (amount) {
+                const n = parseFloat(amount);
+                if (Number.isNaN(n) || n <= 0) {
+                    sysMsg(tui, "用法: /budget <USD 金额> [--project]");
+                    break;
+                }
+                const resolved = scope === "project" ? "project" : "global";
+                setBudgetMaxCost(n, resolved);
+                sysMsg(tui, `✓ 预算上限已设为: $${n}（${resolved === "project" ? "项目" : "全局"}）`);
+                break;
+            }
+            const snap = getBudgetSnapshot();
+            const maxCost = snap.maxCostUSD;
+            const sourceLabel = snap.source === "project" ? "项目" : snap.source === "global" ? "全局" : null;
+            const price = await getModelPrice(currentModel ?? "");
+            const cost = estimateCost({ inputTokens: tracker.totalInputTokens, outputTokens: tracker.totalOutputTokens }, price);
+            const costStr = cost != null ? `约 ${formatCost(cost)}` : "--";
+            const cap = maxCost != null ? `上限 $${maxCost}${sourceLabel ? `（${sourceLabel}）` : ""}` : "未设置上限";
+            sysMsg(tui, `预算: 已用${costStr} / ${cap}\n设置: /budget <金额>  或  /budget <金额> --project`);
+            break;
+        }
+        case "permission": {
+            const { takeScopeFlags } = await import("../memory.js");
+            const { getPermissionSnapshot, parsePermissionMode, permissionModeLabel, setPermissionMode } = await import("../config.js");
+            const { getPermissionOverride, setPermissionOverride } = await import("../confirm.js");
+            const { scope, rest: permRest } = takeScopeFlags(rest);
+            const sourceLabel = (source) => source === "cli" ? "本次启动参数" : source === "project" ? "项目" : source === "global" ? "全局" : "默认";
+            if (permRest.length === 0) {
+                const snap = getPermissionSnapshot();
+                const override = getPermissionOverride();
+                const mode = override ?? snap.permission;
+                const source = override ? "cli" : snap.source;
+                sysMsg(tui, [
+                    `当前确认: ${permissionModeLabel(mode)}（${sourceLabel(source)}）`,
+                    "设置: /permission ask|accept-edits|allow-all [--project]",
+                ].join("\n"));
+                break;
+            }
+            const parsed = parsePermissionMode(permRest[0]);
+            if (!parsed || permRest.length > 1) {
+                sysMsg(tui, "用法: /permission ask|accept-edits|allow-all [--project]");
+                break;
+            }
+            const resolved = scope === "project" ? "project" : "global";
+            setPermissionMode(parsed, resolved);
+            setPermissionOverride(parsed);
+            sysMsg(tui, `✓ 确认已设为${permissionModeLabel(parsed)}（${resolved === "project" ? "项目" : "全局"}）`);
+            break;
+        }
+        case "mcp": {
+            const { loadMcpConfig } = await import("../mcp.js");
+            const { getMcpStatus } = await import("../mcp.js");
+            const config = loadMcpConfig();
+            const servers = Object.entries(config.mcpServers);
+            if (servers.length === 0)
+                sysMsg(tui, "无 MCP 服务器配置");
+            else {
+                const status = getMcpStatus();
+                const lines = servers.map(([name, cfg]) => {
+                    const disabled = cfg.enabled === false;
+                    const st = status[name];
+                    const connected = st?.connected ?? false;
+                    const toolCount = st?.tools.length ?? 0;
+                    const extra = [
+                        toolCount > 0 ? `${toolCount} tools` : "",
+                        (st?.resource_count ?? 0) > 0 ? `${st.resource_count} resources` : "",
+                        (st?.prompt_count ?? 0) > 0 ? `${st.prompt_count} prompts` : "",
+                    ]
+                        .filter(Boolean)
+                        .join(", ");
+                    const state = disabled ? "disabled" : connected ? "connected" : "disconnected";
+                    const err = !disabled && !connected && st?.error ? ` — ${st.error}` : "";
+                    return `  ${name}: ${state}${extra ? ` (${extra})` : ""}${err}`;
+                });
+                sysMsg(tui, `MCP 服务器 (${servers.length}):\n${lines.join("\n")}`);
+            }
+            break;
+        }
+        case "skills": {
+            const { discoverSkills, getAllSkills, getSkill, getStaleDisabledSkills, setSkillEnabled } = await import("../skills.js");
+            discoverSkills({ silent: true });
+            const tokens = rest.filter(Boolean);
+            const action = tokens[0];
+            const all = getAllSkills().sort((a, b) => a.name.localeCompare(b.name));
+            if (action === "enable" || action === "disable") {
+                const scope = tokens.includes("--project") ? "project" : "global";
+                const names = tokens.slice(1).filter((t) => t !== "--project" && t !== "--global");
+                if (names.length === 0) {
+                    sysMsg(tui, `用法: /skills ${action} <name...> [--project]`);
+                    break;
+                }
+                const known = new Set(all.map((s) => s.name));
+                const unknown = names.filter((n) => !known.has(n));
+                if (unknown.length > 0) {
+                    sysMsg(tui, `未找到 skill: ${unknown.join(", ")}\n可用: ${known.size ? [...known].join(", ") : "无"}`);
+                    break;
+                }
+                const results = setSkillEnabled(names, action === "enable", scope);
+                const notes = results
+                    .filter((r) => r.blockedBy)
+                    .map((r) => `  ⚠ ${r.name} 仍为${r.enabled ? "启用" : "禁用"}（被 ${r.blockedBy} 范围覆盖）`);
+                sysMsg(tui, [`✓ 已${action === "enable" ? "启用" : "禁用"}(${scope}): ${names.join(", ")}`, ...notes].join("\n"));
+                break;
+            }
+            if (action === "info") {
+                const name = tokens[1];
+                const skill = name ? getSkill(name) : undefined;
+                if (!skill) {
+                    sysMsg(tui, `未找到 skill: ${name ?? "(未指定)"}\n可用: ${all.length ? all.map((s) => s.name).join(", ") : "无"}`);
+                    break;
+                }
+                const status = skill.enabled ? "enabled" : `disabled(${skill.disabledScope === "project" ? "proj" : "glob"})`;
+                const meta = [
+                    `Name:        ${skill.name}`,
+                    `Status:      ${status}`,
+                    ...(skill.builtin ? ["Source:      内置"] : []),
+                    ...(skill.version ? [`Version:     ${skill.version}`] : []),
+                    `Description: ${skill.description.replace(/\s+/g, " ")}`,
+                    `Location:    ${skill.location}`,
+                    ...(skill.allowedTools.length ? [`Tools:       ${skill.allowedTools.join(", ")}`] : []),
+                    ...(skill.requiredBins.length ? [`Requires:    ${skill.requiredBins.join(", ")}`] : []),
+                ];
+                const content = skill.content.trim();
+                sysMsg(tui, [...meta, ...(content ? ["", "--- Content ---", "", content.slice(0, 4000)] : [])].join("\n"));
+                break;
+            }
+            if (action && action !== "list") {
+                sysMsg(tui, "用法: /skills [list|info <name>|enable <name...> [--project]|disable <name...> [--project]]");
+                break;
+            }
+            const stale = getStaleDisabledSkills();
+            if (all.length === 0 && stale.length === 0) {
+                sysMsg(tui, "无可用 skills。添加 SKILL.md 到 .min-agent/skills/<name>/");
+                break;
+            }
+            const lines = all.map((s) => {
+                const status = s.enabled ? "enabled" : `disabled(${s.disabledScope === "project" ? "proj" : "glob"})`;
+                const origin = s.builtin ? " 内置" : "";
+                return `  ${s.name}  ${status}${origin}  ${truncateDisplay(s.description.replace(/\s+/g, " "), 56)}`;
+            });
+            if (stale.length > 0)
+                lines.push(`  ⚠ disabledSkills/enabledSkills 中无对应 skill: ${stale.join(", ")}`);
+            sysMsg(tui, `Skills (${all.filter((s) => s.enabled).length} enabled / ${all.length}):\n${lines.join("\n")}\n切换: /skills disable <name> [--project]`);
+            break;
+        }
+        case "sandbox": {
+            const { takeScopeFlags } = await import("../memory.js");
+            const { getSandboxSnapshot, setSandboxConfig } = await import("../config.js");
+            const { parseSandboxMode, parseNetworkPolicy, getEffectiveSandboxPolicy, sandboxEnforcementCaveat, sandboxModeLabel, setSandboxOverride, } = await import("../sandbox.js");
+            const { scope, rest: sbRest } = takeScopeFlags(rest);
+            const sourceLabel = (source) => source === "cli"
+                ? "本次启动参数"
+                : source === "env"
+                    ? "环境变量"
+                    : source === "project"
+                        ? "项目"
+                        : source === "global"
+                            ? "全局"
+                            : "默认";
+            if (sbRest.length === 0) {
+                const snap = getSandboxSnapshot();
+                const extras = [
+                    ...(snap.extraWriteRoots.length > 0 ? [`额外可写目录: ${snap.extraWriteRoots.join(", ")}`] : []),
+                    ...(snap.extraReadRoots.length > 0 ? [`额外可读目录: ${snap.extraReadRoots.join(", ")}`] : []),
+                ];
+                const caveat = sandboxEnforcementCaveat(getEffectiveSandboxPolicy().mode);
+                sysMsg(tui, [
+                    `当前隔离: ${snap.label}（${sourceLabel(snap.source)}）`,
+                    ...extras,
+                    ...(caveat ? [caveat] : []),
+                    "设置: /sandbox off|workspace|strict [--project]",
+                    "      /sandbox network allow|deny [--project]",
+                ].join("\n"));
+                break;
+            }
+            const resolved = scope === "project" ? "project" : "global";
+            const scopeLabel = resolved === "project" ? "项目" : "全局";
+            if (sbRest[0] === "network") {
+                const parsed = parseNetworkPolicy(sbRest[1]);
+                if (!parsed || sbRest.length > 2) {
+                    sysMsg(tui, "用法: /sandbox network allow|deny [--project]");
+                    break;
+                }
+                setSandboxConfig({ network: parsed }, resolved);
+                setSandboxOverride({ network: parsed });
+                sysMsg(tui, `✓ 联网已设为${parsed === "deny" ? "禁止" : "允许"}（${scopeLabel}）`);
+                break;
+            }
+            const parsed = parseSandboxMode(sbRest[0]);
+            if (!parsed || sbRest.length > 1) {
+                sysMsg(tui, "用法: /sandbox off|workspace|strict [--project]\n      /sandbox network allow|deny [--project]");
+                break;
+            }
+            setSandboxConfig({ mode: parsed }, resolved);
+            setSandboxOverride({ mode: parsed });
+            const caveat = sandboxEnforcementCaveat(parsed);
+            sysMsg(tui, [`✓ 隔离已设为${sandboxModeLabel(parsed)}（${scopeLabel}）`, ...(caveat ? [caveat] : [])].join("\n"));
+            break;
+        }
+        case "help":
+            sysMsg(tui, [
+                "命令:",
+                "  输入 / 弹出命令菜单 (输入过滤, Tab/Enter 执行, Esc 关闭)",
+                "  /new          新建会话（保留当前）",
+                "  /compact      压缩上下文",
+                "  /model [n]    交互式选择/切换模型",
+                "  /models       列出可用模型",
+                "  /provider [n] 查看/切换 Provider",
+                "  /memory [t]   查看/保存记忆（--project 写入当前项目）",
+                "  /tokens       显示上下文占用、累计用量与成本",
+                "  /budget [n]   查看/设置预算上限（--project 写入当前项目）",
+                "  /permission   查看/设置确认模式（ask|accept-edits|allow-all，--project 写入当前项目）",
+                "  /sandbox      查看/设置隔离（off|workspace|strict，--project 写入当前项目）",
+                "  /undo         撤销上一轮",
+                "  /redo         重发最后一条消息",
+                "  /diff         显示工作区未提交变更",
+                "  /plan         切换只读计划模式",
+                "  /sessions     列出/切换已保存会话",
+                "  /resume [id]  同 /sessions",
+                "  /reload       重新加载规则",
+                "  /rename <t>   重命名当前会话",
+                "  /attach <p>   附加本地图片",
+                "  /mcp          显示 MCP 状态",
+                "  /skills       显示/启用/禁用 skills（/skills info <name> 查看详情）",
+                "  /path         显示工作目录",
+                "  /paste [t]    粘贴剪贴板图片 + 可选提示",
+                "  /help         显示帮助",
+                "  /exit         退出",
+                "",
+                "快捷键:",
+                "  Esc           取消当前任务",
+                "  Ctrl+J        输入框换行",
+                "  Ctrl+C        清空输入（↑↓ 可找回）；生成中则中断，空输入连按两次退出",
+                "  Ctrl+B        消息区选择模式",
+                "  Home/End      行首/行尾",
+                "  PageUp/Down   滚动消息",
+                "  鼠标滚轮      滚动消息",
+                "  鼠标拖拽      选择文本并自动复制",
+                "  鼠标双击      选词并复制",
+                "  鼠标三击      选中该条消息并复制",
+                "  鼠标点击      工具调用行展开/收起",
+                "  ↑↓           翻阅输入历史",
+                "  ← →           移动输入框光标",
+                "  鼠标点击      输入框内定位光标",
+            ].join("\n"));
+            break;
+        default:
+            sysMsg(tui, `未知命令: /${cmd}，输入 /help 查看可用命令`);
+    }
+}

package/dist/tui/text-width.js

@@ -0,0 +1,113 @@
+/**
+ * Terminal display-width helpers.
+ *
+ * CJK / fullwidth characters occupy two terminal cells, combining marks and
+ * variation selectors occupy none. Width is measured per grapheme cluster so
+ * ZWJ emoji (and Ink's own layout, which uses the same cluster rules) stay
+ * aligned with the mouse column.
+ */
+const segmenter = new Intl.Segmenter(undefined, { granularity: "grapheme" });
+const EXT_PICT = /\p{Extended_Pictographic}/u;
+/** Zero-width: combining marks, variation selectors, zero-width spaces. */
+function isZeroWidth(cp) {
+    return ((cp >= 0x0300 && cp <= 0x036f) ||
+        (cp >= 0x0483 && cp <= 0x0489) ||
+        (cp >= 0x0591 && cp <= 0x05bd) ||
+        (cp >= 0x0610 && cp <= 0x061a) ||
+        (cp >= 0x064b && cp <= 0x065f) ||
+        (cp >= 0x0e31 && cp <= 0x0e3a) ||
+        (cp >= 0x0e47 && cp <= 0x0e4e) ||
+        (cp >= 0x1ab0 && cp <= 0x1aff) ||
+        (cp >= 0x1dc0 && cp <= 0x1dff) ||
+        (cp >= 0x200b && cp <= 0x200f) ||
+        (cp >= 0x2060 && cp <= 0x2064) ||
+        (cp >= 0x20d0 && cp <= 0x20ff) ||
+        (cp >= 0xfe00 && cp <= 0xfe0f) ||
+        (cp >= 0xfe20 && cp <= 0xfe2f) ||
+        cp === 0xfeff ||
+        (cp >= 0xe0100 && cp <= 0xe01ef));
+}
+/** East Asian Wide / Fullwidth, plus the emoji blocks terminals render double. */
+function isFullWidth(cp) {
+    return ((cp >= 0x1100 && cp <= 0x115f) ||
+        (cp >= 0x2e80 && cp <= 0x303e) ||
+        (cp >= 0x3041 && cp <= 0x33ff) ||
+        (cp >= 0x3400 && cp <= 0x4dbf) ||
+        (cp >= 0x4e00 && cp <= 0x9fff) ||
+        (cp >= 0xa000 && cp <= 0xa4cf) ||
+        (cp >= 0xa960 && cp <= 0xa97f) ||
+        (cp >= 0xac00 && cp <= 0xd7a3) ||
+        (cp >= 0xf900 && cp <= 0xfaff) ||
+        (cp >= 0xfe10 && cp <= 0xfe19) ||
+        (cp >= 0xfe30 && cp <= 0xfe6f) ||
+        (cp >= 0xff00 && cp <= 0xff60) ||
+        (cp >= 0xffe0 && cp <= 0xffe6) ||
+        (cp >= 0x1f300 && cp <= 0x1f64f) ||
+        (cp >= 0x1f680 && cp <= 0x1f6ff) ||
+        (cp >= 0x1f900 && cp <= 0x1f9ff) ||
+        (cp >= 0x20000 && cp <= 0x2fffd) ||
+        (cp >= 0x30000 && cp <= 0x3fffd));
+}
+function codePointWidth(char) {
+    const cp = char.codePointAt(0);
+    if (cp === undefined)
+        return 0;
+    if (cp < 0x20 || (cp >= 0x7f && cp < 0xa0))
+        return 0;
+    if (isZeroWidth(cp))
+        return 0;
+    if (isFullWidth(cp) || EXT_PICT.test(char))
+        return 2;
+    return 1;
+}
+/** Display width of a grapheme cluster (or a single code point), in terminal cells. */
+export function clusterWidth(cluster) {
+    if (cluster.length === 0)
+        return 0;
+    if (EXT_PICT.test(cluster) || cluster.includes("\u200D"))
+        return 2;
+    let width = 0;
+    for (const ch of cluster)
+        width += codePointWidth(ch);
+    return cluster.includes("\uFE0F") ? Math.max(width, 2) : width;
+}
+/** Display width of a single code point, in terminal cells. */
+export function charWidth(char) {
+    return clusterWidth(char);
+}
+export function* clustersOf(text) {
+    for (const { segment } of segmenter.segment(text)) {
+        yield { text: segment, width: clusterWidth(segment) };
+    }
+}
+/** Display width of a string (single logical line, no ANSI escapes). */
+export function displayWidth(text) {
+    let width = 0;
+    for (const { width: w } of clustersOf(text))
+        width += w;
+    return width;
+}
+/**
+ * Break a single logical line into visual rows of at most `maxWidth` cells.
+ * Breaks on cluster boundaries (not word boundaries) so the caret column can
+ * be derived exactly — a fullwidth character or emoji is never split across rows.
+ */
+export function wrapByWidth(line, maxWidth) {
+    const text = typeof line === "string" ? line : line == null ? "" : String(line);
+    if (maxWidth < 1)
+        return [text];
+    const rows = [];
+    let current = "";
+    let width = 0;
+    for (const { text: g, width: w } of clustersOf(text)) {
+        if (width + w > maxWidth && current.length > 0) {
+            rows.push(current);
+            current = "";
+            width = 0;
+        }
+        current += g;
+        width += w;
+    }
+    rows.push(current);
+    return rows;
+}

package/dist/tui/theme.js

@@ -0,0 +1,12 @@
+export const theme = {
+    inputBorder: "cyan",
+    inputBorderDisabled: "gray",
+    confirmBorder: "blue",
+    pickerBorder: "blue",
+    questionBorder: "blue",
+    accent: "cyan",
+    muted: "gray",
+    tool: "yellow",
+    error: "red",
+    success: "green",
+};