@aalis/plugin-cli 0.13.0 → 0.14.0

package/dist/index.js

@@ -1,29 +1,26 @@
 import { stdin as input, stdout as output } from 'node:process';
 import * as readline from 'node:readline';
-import { approvals, sanitizeForCard, } from '@aalis/api-approval';
+import { approvals, clipForCard, sanitizeForCard, } from '@aalis/api-approval';
 import { commands } from '@aalis/api-commands';
 import { unmetDependencies } from '@aalis/api-doctor';
 import { hostConfig } from '@aalis/api-host-config';
 import { hostLogs } from '@aalis/api-host-logs';
+import { i18n, localizeFor } from '@aalis/api-i18n';
 import { persona } from '@aalis/api-persona';
 import { getPlatformAdapters, platform, resolvePlatformBySession, } from '@aalis/api-platform';
-import { sessionManager } from '@aalis/api-session-manager';
+import { isUnfiled, sessionManager } from '@aalis/api-session-manager';
+import { sessionProtocol } from '@aalis/api-session-protocol';
 import { storage } from '@aalis/api-storage';
 import { config, definePlugin, defineService, events, lifecycle, logger, optional, pluginsService, provide, services, } from '@aalis/core';
 import { defineConfig, parseConfig } from '@aalis/schema-config';
-import { AttachmentRefKind, } from '@aalis/schema-message';
+import { textOf } from '@aalis/schema-i18n';
 import chalk from 'chalk';
 import cliTruncate from 'cli-truncate';
 import stringWidth from 'string-width';
-import { ChatBuffer } from './chat-buffer.js';
-/** 附件说明里的大小 */
-function formatBytes(n) {
-    if (n < 1024)
-        return `${n} B`;
-    if (n < 1024 * 1024)
-        return `${(n / 1024).toFixed(1)} KB`;
-    return `${(n / 1024 / 1024).toFixed(1)} MB`;
-}
+import { ChatLog } from './chat-log.js';
+import { groupSummary, languageOf, toolLine } from './fold.js';
+import { SessionView } from './session-view.js';
+import { t } from './texts.js';
 // ----- 服务描述符（调用型：业务层就是提供者的形状）-----
 export const cli = defineService('cli');
 // ===== 插件元数据 =====
@@ -31,38 +28,40 @@ const name = '@aalis/plugin-cli';
 const configSchema = defineConfig({
     sessionId: {
         type: 'string',
-        label: '默认会话 ID',
+        label: t('sessionIdLabel'),
         default: 'cli-default',
         onInvalid: 'error',
-        description: 'CLI 聊天所在的会话标识。',
+        description: t('sessionIdDescription'),
     },
     lastView: {
         type: 'string',
-        label: '上次视图',
+        label: t('lastViewLabel'),
         default: 'chat',
-        description: '运行时自动写回；startupView=last 时启动恢复到这里记录的视图。',
+        description: t('lastViewDescription'),
     },
-    prompt: { type: 'string', label: '提示符', default: 'You', description: '命令行输入提示符前缀' },
+    prompt: { type: 'string', label: t('promptLabel'), default: 'You', description: t('promptDescription') },
     maxLogEntries: {
         type: 'number',
-        label: '日志内存缓冲上限（条）',
+        label: t('maxLogEntriesLabel'),
         default: 50000,
-        description: '日志页内存驻留的最大条数，超出后从最旧成块丢弃；完整日志始终在家目录的 logs/latest.log',
+        description: t('maxLogEntriesDescription'),
     },
     startupView: {
         type: 'select',
-        label: '启动视图',
+        label: t('startupViewLabel'),
         default: 'last',
-        description: 'CLI 接管终端后的默认视图。last 表示恢复上次视图',
+        description: t('startupViewDescription'),
         options: [
-            { label: '恢复上次', value: 'last' },
-            { label: '聊天', value: 'chat' },
-            { label: '日志', value: 'logs' },
-            { label: '状态', value: 'status' },
-            { label: '帮助', value: 'help' },
+            { label: t('viewLast'), value: 'last' },
+            { label: t('viewChat'), value: 'chat' },
+            { label: t('viewLogs'), value: 'logs' },
+            { label: t('viewStatus'), value: 'status' },
+            { label: t('viewHelp'), value: 'help' },
         ],
     },
 });
+/** 本地终端身份：物理访问即运维者本人。接审批面、接会话协议都以它 */
+const CONSOLE = { platform: 'cli', userId: 'console' };
 // ===== 插件入口 =====
 // platform 既被本插件提供又被状态页枚举，只能是可选依赖：required 会让激活等一个由自己提供的服务。
 const uses = {
@@ -85,10 +84,14 @@ const uses = {
     commands: optional(commands),
     /** 发出入站之前给配置的会话建档，创建来源写 cli 审批面的登记名 */
     sessionManager: optional(sessionManager),
+    /** 界面文字按全局层的语言显示；缺席时按原文 */
+    i18n: optional(i18n),
+    /** 聊天区她的输出取会话协议里本会话的条目；缺席时只写整条回复 */
+    sessionProtocol: optional(sessionProtocol),
 };
 export default definePlugin({
     name,
-    displayName: 'CLI 终端',
+    displayName: t('displayName'),
     subsystem: 'platform',
     configSchema,
     provides: [cli, platform],
@@ -108,6 +111,17 @@ function startCli(caps) {
     const sessionId = cliConfig.sessionId;
     const approvalSurface = caps.approvals.use.registerSurface('cli');
     let tui = null;
+    /** i18n 渲染界面文字抛错时告警过了：之后再出错不再告警 */
+    let renderWarned = false;
+    const onRenderError = (err) => {
+        if (renderWarned)
+            return;
+        renderWarned = true;
+        logger.use.warn('按全局层的语言渲染界面文字出错，按原文显示（之后再出错不再告警）:', err);
+    };
+    // 终端是 owner 自己看的：界面文字按全局层的语言，不看终端会话自己的语言设置（聊天输出已由网关按会话渲染）。终端不做
+    // Markdown 转义
+    const localize = value => localizeFor(caps.i18n, value, { host: true }, { onError: onRenderError });
     const adapter = {
         adapterName: 'CLI',
         platform: 'cli',
@@ -133,69 +147,57 @@ function startCli(caps) {
     };
     caps.provide.use(cli, cliService);
     // 附件：终端就是这个会话的平台，显示不了图片本身，写一行说明（类型、名称、大小、本机路径），写出即算送达并照常归档。
-    // 路径在支持超链接的终端里可以点开
+    // 路径在支持超链接的终端里可以点开。类型的显示名取本插件字典（归档协议的类别占位符不当显示名）
     const attachmentStorage = caps.storage.use;
-    const KIND_LABELS = {
-        image: AttachmentRefKind.Image,
-        audio: AttachmentRefKind.Audio,
-        video: AttachmentRefKind.Video,
-        file: AttachmentRefKind.File,
-    };
     async function attachmentLine(att) {
-        const label = `[${KIND_LABELS[att.kind] ?? '附件'}]`;
+        const label = `[${localize(t('attachmentKind', { kind: att.kind }))}]`;
         if (/^https?:\/\//i.test(att.data))
             return `${label} ${att.name ?? ''} ${att.data}`.replace(/\s+/g, ' ').trim();
         if (att.data.startsWith('data:') && att.data.includes(';base64,')) {
             const bytes = Math.floor(((att.data.length - att.data.indexOf(',') - 1) * 3) / 4);
-            return `${label} ${att.name ?? '内联数据'} · ${formatBytes(bytes)}`;
+            return `${label} ${att.name ?? localize(t('inlineData'))} · ${localize(t('size', { bytes }))}`;
         }
         let path = att.data;
         let size = '';
         try {
             path = await attachmentStorage.resolveLocalPath(att.data, 'read');
-            size = formatBytes((await attachmentStorage.stat(att.data)).size);
+            size = localize(t('size', { bytes: (await attachmentStorage.stat(att.data)).size }));
         }
         catch {
             // 取不到本机路径时照写存储地址
         }
         return [`${label} ${att.name ?? path.split('/').pop() ?? ''}`, size, path].filter(Boolean).join(' · ');
     }
-    function sendAttachments(msg) {
-        const attachments = (msg.attachments ?? []).map(att => ({ ...att }));
-        // 同步认领：发起方 await emit 之后就要能等到它
-        msg.delivery = (async () => {
-            try {
-                for (const att of attachments)
-                    adapter.sendMessage(msg.sessionId, await attachmentLine(att));
-                void events.use.emit('outbound:delivered', { ...msg, attachments, delivery: undefined });
-                return { ok: true };
-            }
-            catch (err) {
-                return { ok: false, error: err instanceof Error ? err.message : String(err) };
-            }
-        })();
+    /**
+     * 写到终端：她回复的正文由会话协议的条目画，终端订着这个会话时不再写一遍（订阅在途时等它落定再定）；没订上（会话服务不在、
+     * 会话还没建档）时整条写出。系统与指令消息照常写。附件消息的文字先写（非空时），再依次写各附件
+     */
+    async function write(msg, attachments) {
+        const drawn = msg.source === 'agent' && (await tui?.drawsReplies()) === true;
+        if (!drawn && (attachments.length === 0 || msg.content.trim()))
+            await adapter.sendMessage(msg.sessionId, msg.content);
+        for (const att of attachments)
+            await adapter.sendMessage(msg.sessionId, await attachmentLine(att));
     }
     events.use.on('outbound:message', msg => {
         if (msg.sessionId !== sessionId)
             return;
-        if (msg.attachments?.length) {
-            sendAttachments(msg);
-            // 附件消息里的文字照常显示；它不是流式正文的整条重复，不消耗流式标记
-            if (msg.content.trim())
-                adapter.sendMessage(msg.sessionId, msg.content);
+        const attachments = (msg.attachments ?? []).map(att => ({ ...att }));
+        // 由条目画的正文不再写，其余照常显示。content 已由网关按会话的语言渲染（网关缺席时是原文）
+        const written = write(msg, attachments);
+        // 出站的平台另有在场的适配器（如 owner 从 WebUI 驱动这个会话）由那个平台认领并记进历史；回执已被别的入口认领的不覆盖。
+        // 这两种照样写到终端，不认领、不发 outbound:delivered，免得再记一份。平台没有适配器的（如工作流注入的）由终端认领
+        const handedOff = msg.platform !== adapter.platform && getPlatformAdapters(caps.platform).some(a => a.platform === msg.platform);
+        if (handedOff || msg.delivery) {
+            written.catch(err => logger.use.warn('[cli] 写到终端失败:', err));
             return;
         }
-        // 纯文本同样写出即算送达，同步认领回执（作品通知等要等它）。同一轮已流式输出时，agent 的整条回复是重复、
-        // 正文早已写出；系统/指令消息不是流式正文，照常显示
-        const written = msg.source === 'agent' && tui?.consumeStreamedSend()
-            ? Promise.resolve()
-            : adapter.sendMessage(msg.sessionId, msg.content);
-        msg.delivery = written.then(() => ({ ok: true }), err => ({ ok: false, error: err instanceof Error ? err.message : String(err) }));
-    });
-    events.use.on('outbound:stream', chunk => {
-        if (chunk.sessionId !== sessionId)
-            return;
-        tui?.applyStreamChunk(chunk);
+        // 写出即算送达，同步认领回执（作品通知等要等它）；写不出时回执交出原因。送达之后发 outbound:delivered，存档据此把
+        // 不是她回复的文字与发出的附件记进历史
+        msg.delivery = written.then(() => {
+            void events.use.emit('outbound:delivered', { ...msg, attachments, delivery: undefined });
+            return { ok: true };
+        }, err => ({ ok: false, error: textOf(err) }));
     });
     // 日志从激活起订阅：先补发最近 2000 条，之后实时接着送，seq 连续。界面起来之前攒着，起来之后交给它
     const earlyLogs = [];
@@ -209,7 +211,7 @@ function startCli(caps) {
             logger.use.info('stdin/stdout 非 TTY，CLI 界面未启动');
             return;
         }
-        const started = new CliTui(caps, cliConfig, sessionId, approvalSurface, earlyLogs);
+        const started = new CliTui(caps, cliConfig, sessionId, approvalSurface, localize, earlyLogs);
         onLog = entry => started.appendLog(entry);
         tui = started;
         tui.start();
@@ -223,6 +225,7 @@ class CliTui {
     config;
     sessionId;
     approvalSurface;
+    localize;
     view;
     previousView = 'chat';
     /** 非 chat 视图期间进入聊天区的条数（确认提示、回复）；header 的 CHAT 页签带计数，切回即清 */
@@ -236,15 +239,17 @@ class CliTui {
     delivering = Promise.resolve();
     /** 已告警过配置的会话 id 由别的平台适配器认领 */
     warnedForeign = false;
-    chat = new ChatBuffer();
+    log = new ChatLog();
+    /** 连续的工具调用全部展开（Ctrl+O）；不存配置，重启回到收起 */
+    expanded = false;
+    /** 经会话协议订阅终端的会话，条目进聊天区 */
+    session;
+    unfollow;
     logLines;
     logScroll = 0;
     logWrap = false;
     statusScroll = 0;
     helpScroll = 0;
-    // 流式状态：正在生成的 assistant 回复，其行由 ChatBuffer 维护为末尾一段
-    streamingContent = '';
-    streamedRecently = false;
     renderQueued = false;
     closing = false;
     restoreOnExit = () => restoreTerminalState();
@@ -253,22 +258,28 @@ class CliTui {
     /** 卡上选中的应答。推出时不选：正在打字时按下的回车不会落到卡上 */
     choice;
     attendance;
-    constructor(caps, config, sessionId, approvalSurface, initialEntries = []) {
+    constructor(caps, config, sessionId, approvalSurface, localize, initialEntries = []) {
         this.caps = caps;
         this.config = config;
         this.sessionId = sessionId;
         this.approvalSurface = approvalSurface;
+        this.localize = localize;
         this.view = config.startupView === 'last' ? config.lastView : config.startupView;
         // 日志由插件入口的订阅送来：界面起来之前的这一批，之后经 appendLog 一条条接着
         this.logLines = initialEntries.slice();
-        // 以本地终端身份接入审批面（与输入消息的 userId 相同）。有按键才上报在场
-        this.attendance = this.approvalSurface.attend({ platform: 'cli', userId: 'console' }, {
+        // 以本地终端身份接入审批面（与输入消息的 userId 相同）。有按键才上报在场。卡上的文字按全局层的语言渲染，事实原样
+        this.attendance = this.approvalSurface.attend(CONSOLE, {
             requested: approval => {
                 this.cards.push(approval);
                 this.queueRender();
             },
-            settled: (approvalId, { state }) => this.closeCard(approvalId, SETTLED_LINES[state]),
+            settled: (approvalId, { state }) => this.closeCard(approvalId, tool => t(SETTLED_LINES[state], { tool })),
         });
+        this.session = new SessionView(sessionId, { identity: CONSOLE, surface: approvalSurface }, {
+            item: item => this.timelineChanged(this.log.upsert(item)),
+            delta: (itemId, text) => this.timelineChanged(this.log.delta(itemId, text)),
+            tasks: this.queueRender,
+        }, caps.logger.use);
     }
     isRunning() {
         return this.running;
@@ -290,13 +301,17 @@ class CliTui {
             input.setRawMode(true);
         input.resume();
         process.once('exit', this.restoreOnExit);
-        const assistantName = this.personaName() ?? 'Aalis';
-        this.chat.append([
-            chalk.gray(this.formatCont()) + chalk.gray(`欢迎使用 ${assistantName}。按 ${chalk.cyan('Ctrl+G')} 查看快捷键。`),
-        ]);
+        const welcome = t('welcome', { name: this.personaName() ?? 'Aalis', key: chalk.cyan('Ctrl+G') });
+        this.log.append([chalk.gray(this.formatCont()) + chalk.gray(this.localize(welcome))]);
         void this.pointToUnready();
+        // 她的输出取会话协议里本会话的条目：会话服务在就接上，换提供者时断开旧的、接上新的
+        this.unfollow = this.caps.sessionProtocol.follow(service => this.session.attach(service));
         input.on('keypress', this.handleKeypress);
         output.on('resize', this.queueRender);
+        // 设置变了（全局层的语言、终端会话的人设，在宿主配置文档或会话设置里）：界面立即按新的设置重绘。聊天区的本地行写进时定住，
+        // 她的回复与工具行随当前设置重绘
+        this.caps.events.use.on('session-settings:changed', this.queueRender);
+        this.caps.events.use.on('host-config:changed', this.queueRender);
         this.caps.lifecycle.use.onDispose(() => this.stop());
         this.render();
     }
@@ -314,10 +329,10 @@ class CliTui {
         const count = status.filter(p => p.state === 'error').length + lacking.length;
         if (count === 0)
             return;
-        const how = (this.caps.commands.present ? this.caps.commands.use.has('doctor') : undefined)
-            ? `输入 ${chalk.cyan('/doctor')} 查看原因与修法`
-            : `按 ${chalk.cyan('Ctrl+L')} 看日志`;
-        this.chat.append([chalk.gray(this.formatCont()) + chalk.yellow(`有 ${count} 个插件没起来，${how}`)]);
+        const hint = (this.caps.commands.present ? this.caps.commands.use.has('doctor') : undefined)
+            ? t('unreadyDoctor', { count, command: chalk.cyan('/doctor') })
+            : t('unreadyLogs', { count, key: chalk.cyan('Ctrl+L') });
+        this.log.append([chalk.gray(this.formatCont()) + chalk.yellow(this.localize(hint))]);
         this.queueRender();
     }
     stop() {
@@ -325,6 +340,7 @@ class CliTui {
             return;
         this.closing = true;
         this.running = false;
+        this.unfollow?.();
         input.off('keypress', this.handleKeypress);
         output.off('resize', this.queueRender);
         process.off('exit', this.restoreOnExit);
@@ -344,59 +360,30 @@ class CliTui {
         if (this.view === 'logs')
             this.queueRender();
     }
+    /** 写一段她名下的本地行（整条回复、指令回复与系统消息、附件说明） */
     pushAssistant(content) {
         if (!content.trim())
             return;
-        this.chat.append(this.formatAssistantBlock(content));
+        this.log.append(this.formatAssistantBlock(content));
         if (this.view !== 'chat')
             this.unreadChat++;
         this.queueRender();
     }
-    /**
-     * 上一轮 是否有流式内容。调用后会重置。转发文件时 outbound:message 看到流完整后重复发送，需要跳过。
-     */
-    consumeStreamedSend() {
-        if (this.streamedRecently) {
-            this.streamedRecently = false;
-            return true;
-        }
-        return false;
+    /** 她回复的正文由条目画：订着终端的会话（订阅在途时等它落定） */
+    drawsReplies() {
+        return this.session.drawsReplies();
     }
-    applyStreamChunk(chunk) {
-        if (chunk.done) {
-            // 完结本轮流式
-            if (this.chat.streaming) {
-                this.streamedRecently = true;
-                this.chat.endStreaming();
-                this.streamingContent = '';
-                if (this.view === 'chat')
-                    this.queueRender();
-            }
-            return;
-        }
-        if (!chunk.contentDelta)
-            return;
-        // 首个块：开一个新的 assistant 条目；上一轮遗留的「已流式」标记一并作废
-        if (!this.chat.streaming) {
-            this.streamingContent = '';
-            this.streamedRecently = false;
-            if (this.view !== 'chat') {
-                this.unreadChat++;
-                this.queueRender();
-            }
-        }
-        this.streamingContent += chunk.contentDelta;
-        // 根据累积内容重建该消息占据的行
-        this.chat.replaceStreamingBlock(this.formatAssistantBlock(this.streamingContent));
-        if (this.view === 'chat')
-            this.queueRender();
+    /** 条目来了：有字的回复刚出现、又不在聊天页时计一条未读 */
+    timelineChanged(fresh) {
+        if (fresh && this.view !== 'chat')
+            this.unreadChat++;
+        this.queueRender();
     }
-    /** 终端会话生效的人设的名字：按会话设置的「人设」取卡，与回合同一口径；没有人设服务时为 undefined */
+    /** 终端会话生效的人设的名字：人设服务按这个会话取卡，与回合同一口径；没有人设服务或卡没取名时为 undefined */
     personaName() {
-        const config = this.caps.sessionManager.present
-            ? this.caps.sessionManager.use.resolveConfig(this.sessionId, 'cli')
+        return this.caps.persona.present
+            ? this.caps.persona.use.getPersonaName({ sessionId: this.sessionId, platform: 'cli' }) || undefined
             : undefined;
-        return this.caps.persona.present ? this.caps.persona.use.getPersonaName({ persona: config?.persona }) : undefined;
     }
     /** 所有标签对齐到同一列宽，确保 │ 竖线垂直对齐 */
     labelCol() {
@@ -450,6 +437,11 @@ class CliTui {
             this.switchView('help');
             return;
         }
+        if (key.ctrl && key.name === 'o') {
+            this.expanded = !this.expanded;
+            this.queueRender();
+            return;
+        }
         if (key.name === 'escape') {
             this.switchView(this.previousView);
             return;
@@ -556,9 +548,9 @@ class CliTui {
         const card = this.cards[0];
         const reply = this.attendance.respond({ approvalId: card.id, decision, contentHash: card.contentHash });
         if (!reply.ok)
-            this.closeCard(card.id, `应答没有生效：${reply.message}`);
+            this.closeCard(card.id, tool => t('answerRefused', { tool, reason: reply.message }));
     }
-    /** 审批结算了：卡片关掉，聊天区留一行 */
+    /** 审批结算了：卡片关掉，聊天区留一行（line 按工具名给出这一行） */
     closeCard(approvalId, line) {
         const index = this.cards.findIndex(card => card.id === approvalId);
         if (index < 0)
@@ -566,7 +558,7 @@ class CliTui {
         const [card] = this.cards.splice(index, 1);
         if (index === 0)
             this.choice = undefined;
-        this.chat.append([`${this.formatHead(chalk.yellow('◆ System'))}审批 ${sanitizeForCard(card.tool)}：${line}`]);
+        this.log.append([`${this.formatHead(chalk.yellow('◆ System'))}${this.localize(line(sanitizeForCard(card.tool)))}`]);
         if (this.view !== 'chat')
             this.unreadChat++;
         this.queueRender();
@@ -622,7 +614,7 @@ class CliTui {
             this.history.shift();
         const firstHead = this.formatHead(chalk.cyan(`❯ ${this.config.prompt}`));
         const contHead = this.formatCont();
-        this.chat.append(text.split('\n').map((line, i) => (i === 0 ? firstHead : contHead) + line));
+        this.log.append(text.split('\n').map((line, i) => (i === 0 ? firstHead : contHead) + line));
         // 指令解析已统一到全局 inbound:command 相位（plugin-commands）。
         // 适配器不再内联解析：未注册命令被放行为普通消息进入 agent，命中命令
         // 由该相位执行并经 outbound:message 回送渲染到 TUI，与 onebot/webui 一致。
@@ -642,10 +634,12 @@ class CliTui {
     async deliver(text) {
         const sm = this.caps.sessionManager.present ? this.caps.sessionManager.use : undefined;
         const session = sm?.getSession(this.sessionId);
-        const unfiled = !session || (!session.createdFrom && !session.originPlatform && !session.work);
+        const unfiled = !session || isUnfiled(session);
         if (sm && unfiled && !(await this.claimedElsewhere())) {
             await sm.ensureSession(this.sessionId, {}, { createdFrom: this.approvalSurface.name });
         }
+        // 订上这个会话再发：这一轮的条目从头画进聊天区
+        await this.session.ensureSubscribed();
         await this.caps.events.use.emit('inbound:message', {
             content: text,
             sessionId: this.sessionId,
@@ -725,17 +719,21 @@ class CliTui {
             return;
         const width = Math.max(40, output.columns || 100);
         const height = Math.max(14, output.rows || 30);
-        // 输入框可变高度（多行输入）：内容行数 + 上下边框，最多 8 行内容。有审批卡时卡片占这个位置
+        // 正文下面的框：有审批卡时是卡片；chat 视图是输入框，可变高度（多行输入）：内容行数 + 上下边框，最多 8 行内容；
+        // 别的视图是一行视图说明（框高 3 行），在正文之后算，滚动值取正文钳制过的
         const box = this.cards.length > 0
             ? this.renderCard(width, height)
-            : this.renderInputBox(width, this.computeInputDisplayLines(width));
+            : this.view === 'chat'
+                ? this.renderInputBox(width, this.computeInputDisplayLines(width))
+                : undefined;
         // 布局：header(1) + sep(1) + body + box + footer(1)
-        const bodyHeight = Math.max(3, height - 3 - box.length);
+        const bodyHeight = Math.max(3, height - 3 - (box?.length ?? 3));
+        const body = this.renderBody(width, bodyHeight);
         const out = [];
         out.push(this.renderHeader(width));
         out.push(chalk.gray(LINE_H.repeat(width)));
-        out.push(...this.renderBody(width, bodyHeight));
-        out.push(...box);
+        out.push(...body);
+        out.push(...(box ?? this.renderInputBox(width, [this.viewLine(width)])));
         out.push(this.renderFooter(width));
         output.write('\x1b[?25l\x1b[H');
         output.write(out.map(line => clearLine(line, width)).join('\n'));
@@ -751,7 +749,8 @@ class CliTui {
         }
     }
     renderHeader(width) {
-        const persona = this.personaName() ?? 'default';
+        // 卡没取名时写 -，同状态页
+        const persona = this.personaName() ?? '-';
         const left = ` ${chalk.bold.magenta('●')} ${chalk.bold('Aalis')} ${chalk.gray('·')} ${chalk.cyan(persona)} `;
         const tabs = ['chat', 'logs', 'status', 'help']
             .map(v => {
@@ -804,17 +803,41 @@ class CliTui {
         if (this.view === 'status')
             return this.getStatusViewLines();
         if (this.view === 'help')
-            return this.getHelpViewLines();
+            return this.getHelpViewLines(width);
         return this.getChatViewLines(width);
     }
     getChatViewLines(width) {
-        const lines = [];
         const inner = width - 2; // 缩进 2 列
-        for (const raw of this.chat.lines) {
-            // 宽度感知截断为单行；超长内容直接尾部省略。
-            lines.push(`  ${clipAnsi(raw, inner)}`);
+        // 宽度感知截断为单行；超长内容直接尾部省略。
+        return this.log
+            .layout(this.session.taskRunning)
+            .flatMap(part => ('lines' in part ? part.lines : this.rowLines(part.row)))
+            .map(raw => `  ${clipAnsi(raw, inner)}`);
+    }
+    /**
+     * 条目的一行画成的行：她的正文另起一块、第一行带人设名的标签；工具调用一行，收起的一组一行（展开时这一组的工具调用各一行），
+     * 都用续行的空标签头。思考、提问、通知与回合条目不画：输入回显、指令回复与附件说明是本地行，思考不显示
+     */
+    rowLines(row) {
+        if ('group' in row) {
+            const calls = row.group.filter((item) => item.kind === 'tool-call');
+            if (this.expanded)
+                return calls.map(call => this.callLine(call));
+            return [this.formatCont() + chalk.gray(this.localize(groupSummary(calls)))];
         }
-        return lines;
+        const { item } = row;
+        if (item.kind === 'agent-message')
+            return item.text.trim() ? this.formatAssistantBlock(item.text) : [];
+        return item.kind === 'tool-call' ? [this.callLine(item)] : [];
+    }
+    /** 工具调用一行：做了什么与状态，等你批准写成黄色、失败写成红色 */
+    callLine(call) {
+        const { summary, status } = toolLine(call, this.session.taskRunning, languageOf(this.localize));
+        const head = this.formatCont() + chalk.gray(this.localize(summary));
+        if (!status)
+            return head;
+        const paint = status.tone === 'attention' ? chalk.yellow : status.tone === 'danger' ? chalk.red : chalk.gray;
+        return `${head}${chalk.gray(' · ')}${paint(this.localize(status.text))}`;
     }
     /** 日志视图的增量格式化缓存。logLines 只追加、从不改写，因此已格式化的行
      * 可以按 (width, wrap) 为键永久复用——每帧只格式化"上次之后新增"的条目，
@@ -893,21 +916,28 @@ class CliTui {
         const adapter = getPlatformAdapters(this.caps.platform).find(a => a.platform === 'cli');
         const connections = adapter?.getConnections?.() ?? [];
         const persona = this.personaName() ?? '-';
-        const sec = (t) => chalk.bold.cyan(`▎ ${t}`);
+        const text = this.localize({
+            runtime: t('statusRuntime'),
+            logs: t('logCount', { count: this.logLines.length }),
+            services: t('statusServices', { count: serviceNames.length }),
+            connections: t('statusConnections', { count: connections.length }),
+            none: t('noConnections'),
+        });
+        const sec = (title) => chalk.bold.cyan(`▎ ${title}`);
         const kv = (k, v) => `    ${chalk.gray(k.padEnd(14))} ${v}`;
         const out = [];
-        out.push(sec('运行时'));
+        out.push(sec(text.runtime));
         out.push(kv('persona', persona));
         out.push(kv('cli session', this.sessionId));
-        out.push(kv('log buffer', `${this.logLines.length} 条`));
+        out.push(kv('log buffer', text.logs));
         out.push('');
-        out.push(sec(`服务 (${serviceNames.length})`));
+        out.push(sec(text.services));
         for (const s of serviceNames)
             out.push(`    ${chalk.green('●')} ${s}`);
         out.push('');
-        out.push(sec(`平台连接 (${connections.length})`));
+        out.push(sec(text.connections));
         if (connections.length === 0)
-            out.push(`    ${chalk.gray('— 无')}`);
+            out.push(`    ${chalk.gray(text.none)}`);
         else
             for (const c of connections) {
                 const dot = c.status === 'online' ? chalk.green('●') : c.status === 'connecting' ? chalk.yellow('●') : chalk.red('●');
@@ -915,55 +945,34 @@ class CliTui {
             }
         return out.map(l => (l.length === 0 ? '' : ` ${l}`));
     }
-    getHelpViewLines() {
-        const sec = (t) => chalk.bold.cyan(`▎ ${t}`);
-        const row = (k, v) => `    ${chalk.cyan(k.padEnd(10))} ${chalk.gray(v)}`;
+    getHelpViewLines(width) {
+        const help = this.localize(HELP);
+        /** text 按宽度折行：第一行接在 head 后面，续行缩进到同一列 */
+        const wrap = (head, text, style) => {
+            const indent = ' '.repeat(visibleLen(head));
+            return wrapWords(text, width - indent.length).map((seg, i) => (i === 0 ? head : indent) + style(seg));
+        };
+        const sec = (title) => wrap(` ${chalk.bold.cyan('▎')} `, title, chalk.bold.cyan);
+        const row = (k, v) => wrap(`     ${chalk.cyan(k.padEnd(10))} `, v, chalk.gray);
         const out = [];
-        out.push(sec('视图切换'));
-        out.push(row('Ctrl+T', 'Chat   ·  聊天 / 命令输入'));
-        out.push(row('Ctrl+L', 'Logs   ·  实时日志'));
-        out.push(row('Ctrl+S', 'Status ·  服务与平台状态'));
-        out.push(row('Ctrl+G', 'Help   ·  当前页'));
-        out.push(row('Esc', '返回上一个视图'));
-        out.push(row('Ctrl+C', '退出'));
-        out.push('');
-        out.push(sec('滚动 (Logs / Status / Help)'));
-        out.push(row('↑ / ↓', '逐行滚动'));
-        out.push(row('PgUp/Dn', '翻页'));
-        out.push(row('Home', '回到顶部'));
-        out.push(row('End', '到底部'));
-        out.push(row('Ctrl+W', '日志页：切换换行模式（多行完整展示）'));
-        out.push('');
-        out.push(sec('编辑'));
-        out.push(row('Enter', '提交输入'));
-        out.push(row('Ctrl+J', '插入换行（macOS Ctrl+Enter）'));
-        out.push(row('Shift+Ent', '插入换行（如终端支持）'));
-        out.push(row('↑ / ↓', '历史记录回溯（chat 视图）'));
-        out.push('');
-        out.push(sec('审批卡（卡在时打字与回车不算应答，也不进输入框）'));
-        out.push(row('← / →', '选批准 / 拒绝，Enter 确定'));
-        out.push(row('Ctrl+Y', '批准'));
-        out.push(row('Ctrl+N', '拒绝'));
-        out.push('');
-        out.push(sec('提示'));
-        out.push(`    ${chalk.gray('• 完整日志写入家目录的 logs/latest.log，每次启动时上一轮改名为 latest.1.log，保留 5 份；跨重启持续跟随用 tail -F。')}`);
-        out.push(`    ${chalk.gray('• 退出时自动恢复原终端内容（alternate screen）。')}`);
-        out.push(`    ${chalk.gray('• 输入以 / 开头会按命令解析，否则发给 agent。')}`);
-        out.push(`    ${chalk.gray('• ↑/↓、PgUp/PgDn、Home/End 滚动 Logs / Status / Help；选择 / 复制文本直接用终端原生操作。')}`);
-        return out.map(l => (l.length === 0 ? '' : ` ${l}`));
+        for (const { title, rows } of help.sections)
+            out.push(...sec(title), ...rows.flatMap(([k, v]) => row(k, v)), '');
+        out.push(...sec(help.tipsTitle), ...help.tips.flatMap(tip => wrap('     ', tip, chalk.gray)));
+        return out;
+    }
+    /** chat 以外的视图在输入框位置的说明：视图名、总行数与滚动值（正文渲染之后取，是钳制过的） */
+    viewLine(width) {
+        const total = this.view === 'logs'
+            ? this.logLines.length
+            : this.view === 'status'
+                ? this.getStatusViewLines().length
+                : this.getHelpViewLines(width).length;
+        const scroll = this.view === 'logs' ? this.logScroll : this.view === 'status' ? this.statusScroll : this.helpScroll;
+        return chalk.gray(this.localize(t('viewLine', { view: this.view, total, scroll })));
     }
     /** 计算输入框的多行内容（不含边框、不含 padding） */
     computeInputDisplayLines(width) {
         const inner = width - 2;
-        if (this.view !== 'chat') {
-            const total = this.view === 'logs'
-                ? this.logLines.length
-                : this.view === 'status'
-                    ? this.getStatusViewLines().length
-                    : this.getHelpViewLines().length;
-            const scroll = this.view === 'logs' ? this.logScroll : this.view === 'status' ? this.statusScroll : this.helpScroll;
-            return [chalk.gray(`${this.view} · ${total} 行 · scroll ${scroll}  ·  按 Ctrl+T 回到聊天`)];
-        }
         const inputLines = this.inputLine.split('\n');
         const display = [];
         const promptLen = visibleLen(this.makePrompt());
@@ -996,30 +1005,52 @@ class CliTui {
         return [top, ...mid, bot];
     }
     /**
-     * 审批卡：标题行、事实、应答项，上下边框。卡片最多高到正文只剩 3 行：事实放不下时保留首尾几行，写明省略了多少行。
-     * 事实显示前经 sanitizeForCard 清洗，太长的保留首尾、写明省略了多少字
+     * 审批卡：标题行、事实、应答项，上下边框。子会话里的审批在事实之前多一行「子任务」，写根会话以下的各级标题。卡片最多高到
+     * 正文只剩 3 行：事实放不下时保留首尾几行，写明省略了多少行。事实显示前经 clipForCard 清洗，太长的保留首尾、写明省略了多少字
      */
     renderCard(width, height) {
         const card = this.cards[0];
         const inner = width - 2;
-        const waiting = this.cards.length > 1 ? ` · 还有 ${this.cards.length - 1} 张` : '';
-        const title = `${chalk.bold.yellow('需要批准')} ${sanitizeForCard(card.tool)} · 会话 ${sanitizeForCard(card.sessionId)}${waiting}`;
-        const facts = cardFacts(card.facts).flatMap(([label, text]) => factLines(label, text, inner - 2));
+        const tool = sanitizeForCard(card.tool);
+        const session = sanitizeForCard(card.sessionId);
+        const text = this.localize({
+            heading: t('cardHeading'),
+            subject: this.cards.length > 1
+                ? t('cardSubjectWaiting', { tool, session, count: this.cards.length - 1 })
+                : t('cardSubject', { tool, session }),
+            labels: FACT_LABELS,
+            chain: card.chain?.map(level => level.title),
+            approve: t('approve'),
+            deny: t('deny'),
+            keys: t('cardKeys'),
+        });
+        const title = `${chalk.bold.yellow(text.heading)} ${text.subject}`;
+        const rows = cardFacts(card.facts, text.chain, text.labels);
+        const labelWidth = Math.max(0, ...rows.map(([label]) => visibleLen(label)));
+        const clipped = (value) => {
+            const { head, omitted, tail } = clipForCard(value, CARD_FACT_LIMIT);
+            return omitted === 0 ? head : `${head}${this.localize(t('charsOmitted', { count: omitted }))}${tail}`;
+        };
+        const facts = rows.flatMap(([label, value]) => factLines(label, labelWidth, clipped(value), inner - 2));
+        const option = (decision, label) => this.choice === decision ? chalk.inverse(`❯ ${label}`) : `  ${label}`;
+        const choices = `${option('approve', text.approve)}   ${option('deny', text.deny)}`;
+        // 应答行放不下按键提示时，提示另起一行（再放不下就折行）
+        const answer = visibleLen(`${choices}   ${text.keys}`) < inner
+            ? [`${choices}   ${chalk.gray(text.keys)}`]
+            : [choices, ...wrapWords(text.keys, inner - 1).map(line => chalk.gray(line))];
         // 高度：header、sep、footer 各一行，正文至少 3 行，卡片的上下边框、标题行与应答行
-        const room = height - 10;
+        const room = height - 9 - answer.length;
         const shown = facts.length <= room
             ? facts
             : [
                 ...facts.slice(0, Math.ceil((room - 1) / 2)),
-                chalk.gray(`…（省略 ${facts.length - room + 1} 行）…`),
+                chalk.gray(this.localize(t('linesOmitted', { count: facts.length - room + 1 }))),
                 ...facts.slice(facts.length - Math.floor((room - 1) / 2)),
             ];
-        const option = (decision, label) => this.choice === decision ? chalk.inverse(`❯ ${label}`) : `  ${label}`;
-        const options = `${option('approve', '批准')}   ${option('deny', '拒绝')}   ${chalk.gray('←/→ 选择 · Enter 确定 · Ctrl+Y 批准 · Ctrl+N 拒绝')}`;
         const edge = chalk.yellow(BOX_V);
         return [
             chalk.yellow(`${BOX_TL}${LINE_H.repeat(inner)}${BOX_TR}`),
-            ...[title, ...shown, options].map(line => `${edge}${padAnsi(` ${line}`, inner)}${edge}`),
+            ...[title, ...shown, ...answer].map(line => `${edge}${padAnsi(` ${line}`, inner)}${edge}`),
             chalk.yellow(`${BOX_BL}${LINE_H.repeat(inner)}${BOX_BR}`),
         ];
     }
@@ -1029,50 +1060,112 @@ class CliTui {
     makeContPrompt() {
         return `${chalk.gray('…')} ${' '.repeat(this.config.prompt.length)} `;
     }
+    /** 底栏：按键记号后面写它的作用（视图名同启动视图的选项，退出同帮助页），日志页另写换行的开关；按显示宽度截到一行 */
     renderFooter(width) {
-        const baseItems = [
-            `${chalk.cyan('^T')} chat`,
-            `${chalk.cyan('^L')} logs`,
-            `${chalk.cyan('^S')} status`,
-            `${chalk.cyan('^G')} help`,
-            `${chalk.cyan('Esc')} back`,
-            `${chalk.cyan('^C')} exit`,
+        const keys = [
+            ['^T', t('viewChat')],
+            ['^L', t('viewLogs')],
+            ['^S', t('viewStatus')],
+            ['^G', t('viewHelp')],
+            ['Esc', t('footerBack')],
+            ['^C', t('helpExit')],
         ];
+        const items = keys.map(([key, text]) => `${chalk.cyan(key)} ${this.localize(text)}`);
         if (this.view === 'logs') {
-            baseItems.push(`${chalk.cyan('^W')} wrap:${this.logWrap ? chalk.green('on') : chalk.gray('off')}`);
+            const state = this.logWrap ? chalk.green(this.localize(t('wrapOn'))) : chalk.gray(this.localize(t('wrapOff')));
+            items.push(`${chalk.cyan('^W')} ${this.localize(t('footerWrap', { state }))}`);
         }
-        const items = baseItems.join(chalk.gray('  ·  '));
-        const left = ` ${items} `;
-        return padAnsi(chalk.gray.dim(left), width);
+        return padAnsi(chalk.gray.dim(` ${items.join(chalk.gray('  ·  '))} `), width);
     }
 }
+// ===== 帮助页 =====
+/** 帮助页：各节的标题与「按键、作用」行，末尾一节是提示 */
+const HELP = {
+    sections: [
+        {
+            title: t('helpViews'),
+            rows: [
+                ['Ctrl+T', t('helpChat')],
+                ['Ctrl+O', t('helpExpand')],
+                ['Ctrl+L', t('helpLogs')],
+                ['Ctrl+S', t('helpStatus')],
+                ['Ctrl+G', t('helpHelp')],
+                ['Esc', t('helpBack')],
+                ['Ctrl+C', t('helpExit')],
+            ],
+        },
+        {
+            title: t('helpScrolling'),
+            rows: [
+                ['↑ / ↓', t('helpLine')],
+                ['PgUp/Dn', t('helpPage')],
+                ['Home', t('helpTop')],
+                ['End', t('helpBottom')],
+                ['Ctrl+W', t('helpWrap')],
+            ],
+        },
+        {
+            title: t('helpEditing'),
+            rows: [
+                ['Enter', t('helpSubmit')],
+                ['Ctrl+J', t('helpNewline')],
+                ['Shift+Ent', t('helpShiftNewline')],
+                ['↑ / ↓', t('helpHistory')],
+            ],
+        },
+        {
+            title: t('helpCard'),
+            rows: [
+                ['← / →', t('helpChoose')],
+                ['Ctrl+Y', t('approve')],
+                ['Ctrl+N', t('deny')],
+            ],
+        },
+    ],
+    tipsTitle: t('helpTips'),
+    tips: [t('tipLogFile'), t('tipRestore'), t('tipCommands'), t('tipKeys')],
+};
 /** 卡片结算后在聊天区留的话 */
 const SETTLED_LINES = {
-    approved: '已批准',
-    denied: '已拒绝',
-    expired: '没有人应答，按拒绝处理',
-    cancelled: '已撤销',
+    approved: 'settledApproved',
+    denied: 'settledDenied',
+    expired: 'settledExpired',
+    cancelled: 'settledCancelled',
 };
 /** 每项事实显示的字数上限，超出的保留首尾 */
 const CARD_FACT_LIMIT = 1000;
-/** 卡上的事实：标签与原文 */
-function cardFacts(facts) {
+/** 卡上事实的标签 */
+const FACT_LABELS = {
+    subtask: t('factSubtask'),
+    command: t('factCommand'),
+    cwd: t('factCwd'),
+    file: t('factFile'),
+    patch: t('factPatch'),
+    params: t('factParams'),
+};
+/**
+ * 卡上的事实：标签（已按读者渲染）与原文。子会话里的审批先写来源链的各级标题（已按读者渲染），以「 › 」相接；标题里的换行与
+ * 别的多行事实一样成续行，缩进到值的那一列，冒充不了带标签的一行
+ */
+function cardFacts(facts, chain, labels) {
     const rows = [];
+    if (chain?.length)
+        rows.push([labels.subtask, chain.join(' › ')]);
     if (facts.command !== undefined)
-        rows.push(['命令', facts.command]);
+        rows.push([labels.command, facts.command]);
     if (facts.cwd !== undefined)
-        rows.push(['目录', facts.cwd]);
+        rows.push([labels.cwd, facts.cwd]);
     if (facts.diff)
-        rows.push(['文件', facts.diff.path], ['改动', facts.diff.patch ?? '疑似含密钥，不显示内容']);
+        rows.push([labels.file, facts.diff.path], [labels.patch, facts.diff.patch]);
     if (Object.keys(facts.params).length > 0)
-        rows.push(['参数', JSON.stringify(facts.params)]);
+        rows.push([labels.params, JSON.stringify(facts.params)]);
     return rows;
 }
-/** 一项事实：清洗后按换行拆开、按宽度折行，标签只在第一行 */
-function factLines(label, text, width) {
-    const head = `${chalk.gray(label)}  `;
-    const indent = ' '.repeat(visibleLen(head));
-    return sanitizeForCard(text, CARD_FACT_LIMIT)
+/** 一项清洗过的事实：按换行拆开、按宽度折行；标签只在第一行，补齐到 labelWidth，续行缩进到值的那一列 */
+function factLines(label, labelWidth, text, width) {
+    const head = `${padAnsi(chalk.gray(label), labelWidth)}  `;
+    const indent = ' '.repeat(labelWidth + 2);
+    return text
         .replace(/\t/g, '    ')
         .split('\n')
         .flatMap(line => wrapByVisibleWidth(line, width - indent.length))
@@ -1134,6 +1227,32 @@ function clipExact(s, width) {
  * 把单行字符串按可见宽度软折行（CJK 算 2 列，emoji/ANSI 不破坏）。
  * 返回若干段，每段宽度 ≤ width。空字符串返回 [''] 以保留视觉空行。
  */
+/** 按宽度折行，优先在空格处断开（断处的空白去掉）：一行放不下的词（含不带空格的中日韩长句）再按宽度切 */
+function wrapWords(s, width) {
+    if (width <= 0 || stringWidth(s) <= width)
+        return [s];
+    const lines = [];
+    let line = '';
+    for (const token of s.split(/(\s+)/)) {
+        if (stringWidth(line + token) <= width) {
+            line += token;
+            continue;
+        }
+        if (/^\s+$/.test(token)) {
+            lines.push(line);
+            line = '';
+            continue;
+        }
+        if (line.trim())
+            lines.push(line.trimEnd());
+        const pieces = wrapByVisibleWidth(token, width);
+        line = pieces.pop() ?? '';
+        lines.push(...pieces);
+    }
+    if (line)
+        lines.push(line);
+    return lines;
+}
 function wrapByVisibleWidth(s, width) {
     if (width <= 0)
         return [s];