pi-web-ui 0.68.2 → 0.70.0

package/dist/server/agent-service.js

@@ -28,12 +28,13 @@ import { MarkerService } from "./marker-service.js";
 import { SlashCommandsService, parseSlash } from "./slash-commands.js";
 import { ModelAdminService } from "./model-admin.js";
 import { FilesService, MACHINE_ROOT, workspacePath } from "./files-service.js";
-import { isExtensionDisabled, isExtensionEnabled, ClientStateStore } from "./client-state.js";
-import { SubagentTemplatesStore } from "./subagent-templates.js";
+import { isExtensionDisabled, isExtensionEnabled, normalizeRetryMaxAttempts, ClientStateStore, } from "./client-state.js";
+import { pick, resolveServerLang } from "./i18n.js";
+import { SubagentTemplatesStore, pickTemplatePrompt } from "./subagent-templates.js";
 import { applyHeadTail, makePersistentTerminalTools, makeTerminalBashTool, stripAnsi, TERMINAL_TOOLS_GUIDANCE, TERMINAL_TOOL_NAMES, } from "./terminals.js";
 import { WebUIContext, mockThemeProxy } from "./webui-context.js";
 import { makeEditSoftTool, SOFT_EDIT_TOOL_NAME } from "./edit-soft-tool.js";
-import { makeSubagentTools, subagentTitle, } from "./subagents.js";
+import { makeSubagentTools, subagentTitle, withSubagentOwner, } from "./subagents.js";
 import { buildAttachmentMessages } from "./attachments.js";
 import { BUILTIN_SOUL, DEFAULT_PROMPT_TEMPLATE, buildToolsSchemaText, renderPromptTemplate, resolveSectionTexts, } from "./prompt-composer.js";
 import { serializeMessage, serializeStreamingMessage, stripTransientRetryErrors, } from "./serialize.js";
@@ -196,11 +197,13 @@ function makeMarkersListTool(getActiveId, markerSvc) {
     return {
         name: "markers_list",
         label: "List marker state",
-        description: "只读查询内联标记状态。状态【写】操作请一律用内联标记（[[todo:new:...]] 等）写在回答正文里，不要调用本工具做写操作。",
+        description: "Read-only query of inline marker state. All WRITE operations must use inline markers ([[todo:new:...]] etc.) in the reply body — never use this tool for writes.\n只读查询内联标记状态。状态【写】操作请一律用内联标记（[[todo:new:...]] 等）写在回答正文里，不要调用本工具做写操作。",
         parameters: Type.Object({
             action: Type.Unsafe({ enum: ["list"] }),
             tool: Type.Optional(Type.Literal("todo")),
-            includeDeleted: Type.Optional(Type.Boolean({ description: "是否包含已删除任务（tombstone，仅 todo）" })),
+            includeDeleted: Type.Optional(Type.Boolean({
+                description: "Whether to include deleted tasks (tombstones, todo only).\n是否包含已删除任务（tombstone，仅 todo）。",
+            })),
         }),
         execute: async (_id, params) => {
             const p = params;
@@ -260,7 +263,7 @@ export function makeAskUserQuestionTool(clientSession) {
                 aborted: signal?.aborted,
             });
             if (answers === null) {
-                throw new Error("用户取消了提问");
+                throw new Error("User cancelled the question.\n用户取消了提问。");
             }
             // 工具结果：把每道题的回答拼成简洁文本给模型，同时留 details 供 UI 展示。
             const lines = answers.map((a) => {
@@ -575,6 +578,8 @@ export class ClientSession {
         isDisposed: () => this.disposed,
         getCwd: () => this.cwd,
         getActiveCwd: () => this.conv?.cwd ?? this.cwd,
+        // issue #91：文件服务错误文案按客户端 UI 语言出中英（英文默认）。
+        getLang: () => this.getLang(),
     });
     bg = new BgServerTracker({
         emit: (msg) => this.emit(msg),
@@ -629,7 +634,9 @@ export class ClientSession {
         return (conversationId ? this.convs.get(conversationId) : this.conv)?.cwd ?? this.cwd;
     }
     makeTerminalManager(conversationId, cwd) {
-        const mgr = new TerminalManager((msg) => this.emitTerminal(conversationId, msg), cwd);
+        const mgr = new TerminalManager((msg) => this.emitTerminal(conversationId, msg), cwd, 
+        // issue #91：终端输入错误按客户端 UI 语言出中英（英文默认）。
+        () => this.getLang());
         // 终端活力检测：AI 触碰过的终端静默 ≥ 阈值（PI_WEB_TERMINAL_IDLE_MS，
         // 默认 15s）且该对话正在运行时，注入一条 steer 消息唤醒 AI 去检查。
         mgr.onAgentIdle = (terminalId, idleMs, title, lastLines) => this.notifyTerminalIdle(conversationId, terminalId, idleMs, title, lastLines);
@@ -699,18 +706,20 @@ export class ClientSession {
      *  `model`（可选）："provider/id"，显式指定子代理模型。不传时由调用方决定是否
      *  回退到模板模型 / 设置面板默认模型；null = 跟随主对话当前模型（默认行为，
      *  runtime 重建时会继承共享 ModelRuntime 的当前默认）。 */
-    async spawnSubagentConversation(prompt, type, cwd, apply, model) {
+    async spawnSubagentConversation(prompt, type, cwd, apply, model, parentId) {
         const conversationId = `sa-${randomUUID().slice(0, 8)}`;
         const terminals = this.makeTerminalManager(conversationId, cwd);
-        const runtime = await createAgentSessionRuntime(this.makeRuntimeFactory(terminals, apply), {
+        const runtime = await createAgentSessionRuntime(this.makeRuntimeFactory(terminals, apply, conversationId), {
             cwd,
             agentDir: this.agentDir,
             sessionManager: SessionManager.inMemory(cwd),
         });
         const conv = this.makeConversation(runtime, conversationId, terminals);
         conv.isSubagent = true;
-        // 派发时刻的 active 即父对话（子代理也可再派发，自然嵌套）。
-        conv.parentId = this.activeId || undefined;
+        // 父对话 = 真正派发它的会话（按会话归属的 host 包装填入）。直接用 active
+        // 会错：后台对话运行时用户可能正看着别的项目对话，孩子会被记到无关
+        // 对话名下、沉到别的项目组底部（issue #95）。缺省才回退到 active。
+        conv.parentId = parentId ?? this.activeId ?? undefined;
         conv.subagentType = type;
         conv.listed = true;
         conv.title = subagentTitle(prompt);
@@ -903,6 +912,8 @@ export class ClientSession {
             windowsPersona: process.platform === "win32" ? WINDOWS_PERSONA : "",
             terminalGuidance: this.settingsSvc.current.terminalToolsEnabled !== false ? TERMINAL_TOOLS_GUIDANCE : "",
             markersGuidance: this.markerSvc.buildGuidance(),
+            // issue #91：组合模板各来源段按客户端 UI 语言渲染（英文默认）。
+            lang: this.getLang(),
             contextFiles: src.contextFiles,
             skills: src.skills,
         };
@@ -983,14 +994,14 @@ export class ClientSession {
      * 切换查看 / 输入补充（steer）/ 中止（abort）/ 移出全部复用现有对话机制。
      */
     subagentHost = {
-        spawnSubagent: (prompt, type, cwd, templateName, model) => {
+        spawnSubagent: (prompt, type, cwd, templateName, model, parentId) => {
             // 模板：存在且启用时应用；传了名字但不可用 → 抛错让工具转给 AI。
             const tpl = templateName ? this.subagentTemplates.get(templateName) : undefined;
             if (templateName && (!tpl || !tpl.enabled)) {
-                throw new Error(`子代理模板不可用：${templateName}（不存在或已停用）`);
+                throw new Error(pick(this.getLang(), `子代理模板不可用：${templateName}（不存在或已停用）`, `Subagent template unavailable: ${templateName} (missing or disabled)`, "agent.subagent.template.unavailable", { templateName: templateName }));
             }
             // 模型优先级：显式 model 参数 > 模板自带模型 > 设置面板默认模型；都不给 = 跟随主对话。
-            return this.spawnSubagentConversation(prompt, type, cwd, tpl, model);
+            return this.spawnSubagentConversation(prompt, type, cwd, tpl, model, parentId);
         },
         getSubagent: (convId) => this.getSubagentSnapshot(convId),
         listSubagents: () => this.listSubagentSnapshots(),
@@ -1003,14 +1014,16 @@ export class ClientSession {
         stopSubagent: async (convId) => {
             const conv = this.convs.get(convId);
             if (conv && (conv.session.isStreaming || !conv.session.isIdle)) {
-                await this.interruptRun(conv, "用户停止子代理");
+                await this.interruptRun(conv, pick(this.getLang(), "用户停止子代理", "User stopped the subagent", "agent.subagent.stop.user"));
             }
         },
+        // issue #91：子代理工具返回按客户端 UI 语言出中英（英文默认）。
+        lang: () => this.getLang(),
         // 只向 AI 暴露 enabled 的模板（停用的对 AI 不可见）。
         listTemplates: () => this.subagentTemplates
             .list()
             .filter((t) => t.enabled)
-            .map((t) => ({ name: t.name, description: t.description, model: t.model })),
+            .map((t) => ({ name: t.name, description: t.description, descriptionEn: t.descriptionEn, model: t.model })),
         isTemplateUsable: (name) => {
             const t = this.subagentTemplates.get(name);
             return !!t && t.enabled;
@@ -1097,7 +1110,15 @@ export class ClientSession {
                 // 复用现有重命名路径（内存标题 + 磁盘 session_info）
                 void this.renameConversation(convId, title);
             },
+            // 标记 widget 合并进扩展 widget 里，跟随当前活动会话渲染（切换会话即刷新）。
+            refreshMarkers: () => this.webUi.refresh(),
+            // issue #91：标记引导/错误按客户端 UI 语言出中英（英文默认）。
+            lang: () => this.getLang(),
         });
+        // 标记 widget 动态渲染「当前活动会话」的 todo/overlay：切换会话时只要刷新
+        // webUi（见 switchConversation/setCwd/newChat）就会显示对应会话的标记，
+        // 且与扩展 widget 合并下发、不会互相覆盖。
+        this.webUi.setDynamicWidget("markers", () => this.markerSvc.overlayLines(this.activeId));
         this.settingsSvc = new SettingsService({
             clientId,
             stateStore,
@@ -1110,10 +1131,14 @@ export class ClientSession {
             isStreaming: () => this.session.isStreaming,
             reloadSession: async () => {
                 await this.session.reload();
+                // reload() 重读磁盘 settings.json，会丢掉内存 applyOverrides
+                // （含重试次数覆盖）——依次重放：重试覆盖 → 终端门控。
+                this.applyRetryOverrides();
                 // reload() 会把 custom 工具重新加回活跃集——重放终端开关。
                 this.applyToolGating(this.session);
                 await this.pushSlashCommands();
             },
+            applyRetryOverrides: () => this.applyRetryOverrides(),
             promptSnapshot: () => this.promptSnapshot(),
             getMarkerState: () => ({
                 markersEnabled: this.markerSvc.current.markersEnabled,
@@ -1130,6 +1155,10 @@ export class ClientSession {
             flushSnapshot: () => this.flushSnapshot(),
             isDisposed: () => this.disposed,
             quiesceBlocked: () => this.quiesceBlocked(),
+            // issue #91：目标/审查文案按客户端 UI 语言出中英（英文默认）。
+            lang: () => this.getLang(),
+            // 目标模式总开关（设置面板「目标审查」页）：关 → 目标入口一律拒绝。
+            goalModeEnabled: () => this.settingsSvc.current.goalModeEnabled !== false,
             activeConvId: () => this.activeId,
             activeConv: () => this.conv,
             getConv: (id) => this.convs.get(id),
@@ -1157,7 +1186,7 @@ export class ClientSession {
         const cs = new ClientSession(clientId, cwd, agentDir, stateStore);
         const conversationId = cs.nextConversationId();
         const terminals = cs.makeTerminalManager(conversationId, cwd);
-        const runtime = await createAgentSessionRuntime(cs.makeRuntimeFactory(terminals), {
+        const runtime = await createAgentSessionRuntime(cs.makeRuntimeFactory(terminals, undefined, conversationId), {
             cwd,
             agentDir,
             // Resume the most recent session for this project — the SDK default
@@ -1195,7 +1224,7 @@ export class ClientSession {
      * 应用（prompt replace/append + 白名单），其余（终端接管、Windows persona
      * 等）仍跟随主会话设置。undefined = 按主会话设置（普通对话/不选模板的子代理）。
      */
-    makeRuntimeFactory(terminals, apply) {
+    makeRuntimeFactory(terminals, apply, ownerId) {
         return async ({ cwd: effectiveCwd, sessionManager }) => {
             const services = await createAgentSessionServices({
                 cwd: effectiveCwd,
@@ -1218,8 +1247,8 @@ export class ClientSession {
                     systemPromptOverride: (base) => {
                         if (typeof base === "string" && base) {
                             this.lastBaseSystemPrompt = base;
-                            if (apply && apply.promptMode === "replace" && apply.systemPrompt.trim()) {
-                                return apply.systemPrompt;
+                            if (apply && apply.promptMode === "replace" && pickTemplatePrompt(apply, this.getLang()).trim()) {
+                                return pickTemplatePrompt(apply, this.getLang());
                             }
                         }
                         return undefined;
@@ -1229,8 +1258,8 @@ export class ClientSession {
                         if (!apply)
                             this.lastSdkAppendFiles = base.slice();
                         const out = [...base];
-                        if (apply && apply.promptMode === "append" && apply.systemPrompt.trim()) {
-                            out.push(apply.systemPrompt);
+                        if (apply && apply.promptMode === "append" && pickTemplatePrompt(apply, this.getLang()).trim()) {
+                            out.push(pickTemplatePrompt(apply, this.getLang()));
                         }
                         // 主会话自定义「追加」已并入组合模板的 {{append}} 覆盖，不再在此注入。
                         if (process.platform === "win32") {
@@ -1294,12 +1323,12 @@ export class ClientSession {
                                     // 把灵魂段换成模板提示词，自动段保留；SYSTEM.md 情形已在
                                     // systemPromptOverride 整体替换，此处边界不存在会自然跳过。
                                     if (apply) {
-                                        if (apply.promptMode !== "replace" || !apply.systemPrompt.trim())
+                                        if (apply.promptMode !== "replace" || !pickTemplatePrompt(apply, this.getLang()).trim())
                                             return undefined;
                                         const boundary = event.systemPrompt.indexOf("\n\nAvailable tools:");
                                         if (boundary === -1)
                                             return undefined;
-                                        const swapped = apply.systemPrompt.trimEnd() + event.systemPrompt.slice(boundary);
+                                        const swapped = pickTemplatePrompt(apply, this.getLang()).trimEnd() + event.systemPrompt.slice(boundary);
                                         return swapped === event.systemPrompt ? undefined : { systemPrompt: swapped };
                                     }
                                     // 主会话：组合模板渲染（模板为空且无覆盖时返回 undefined = 用 SDK 默认）。
@@ -1337,18 +1366,26 @@ export class ClientSession {
                         idleMs: () => Math.max(0, Math.floor(this.settingsSvc.current.terminalBashIdleMs) || 0),
                         kills: this.bashKills,
                         notifyBackgroundDone: (info) => this.notifyTerminalBashDone(terminals, info),
+                        // issue #91：bash 返回按客户端 UI 语言出中英（英文默认）。
+                        lang: () => this.getLang(),
                     }), 
                     // 设置关 → 原生 bash；开 → 终端 bash。
                     () => this.settingsSvc.current.terminalBash),
-                    ...makePersistentTerminalTools(terminals, effectiveCwd),
+                    ...makePersistentTerminalTools(terminals, effectiveCwd, () => this.getLang()),
                     // 不覆盖内置 edit 的独立宽松编辑工具（缩进不敏感匹配；开关看设置）。
-                    makeEditSoftTool(effectiveCwd),
+                    makeEditSoftTool(effectiveCwd, () => this.getLang()),
                     // 插件注册的 AI 工具（创建时刻的实时快照；后续注册经
                     // refreshPluginTools 动态补入已有会话）。
                     ...(this.pluginToolsProvider?.() ?? []).map(pluginToolToDefinition),
                     // 第一方子代理工具（spawn/get_result/steer/list/stop）。子代理会话
-                    // 也注册了它们，因此可自然嵌套派发。
-                    ...makeSubagentTools(this.subagentHost),
+                    // 也注册了它们，因此可自然嵌套派发。host 按 ownerId 包装：子代理的
+                    // 父对话 = 真正调用 spawn 的那个会话（本 runtime 所属会话），而不是
+                    // 派发瞬间的 active——后台对话继续产出时用户可能已切到别的项目，用
+                    // activeId 会把孩子记到无关会话名下、沉到别的组/底部（issue #95）。
+                    // ownerId 即本 runtime 所属会话（创建时就已知，见各调用点）。
+                    ...(ownerId
+                        ? makeSubagentTools(withSubagentOwner(this.subagentHost, ownerId))
+                        : makeSubagentTools(this.subagentHost)),
                     // 内置标记只读查询工具（todo/svc 状态查询，写操作走内联标记）。
                     makeMarkersListTool(() => this.activeId, this.markerSvc),
                     // 标准引擎的 ask_user_question：模型调用 → 浏览器富渲染问卷（复用 DSH
@@ -1776,18 +1813,17 @@ export class ClientSession {
                 conv.queueSteering = [...event.steering];
                 conv.queueFollowUp = [...event.followUp];
                 break;
-            // 手动 /compact 或阈值/溢出自动压缩开始——立即反馈，避免「没反应」
-            // （此前 compaction_start/end 事件被 switch 静默丢弃，issue #33）。
+            // 手动 /compact 或阈值/溢出自动压缩开始——常驻进度条（快照 compaction
+            // 字段），而不是一次性 toast（toast 几秒就消失，而摘要生成可能持续
+            // 数十秒，用户会以为「没反应」）。立即 flush 让进度条第一时间出现。
             case "compaction_start": {
-                this.emit({
-                    type: "notice",
-                    level: "info",
-                    text: "正在压缩上下文…（压缩摘要将显示在消息区）",
-                    textEn: "Compacting context… (the summary will appear in the message list)",
-                });
+                conv.compactionState = { reason: event.reason, startedAt: Date.now() };
+                conv.lastCompactionTokens = null;
+                this.flushSnapshot();
                 break;
             }
             case "compaction_end": {
+                conv.compactionState = null;
                 if (event.errorMessage) {
                     this.emit({
                         type: "notice",
@@ -1807,6 +1843,8 @@ export class ClientSession {
                 else if (event.result) {
                     const { tokensBefore, estimatedTokensAfter } = event.result;
                     const after = estimatedTokensAfter ?? tokensBefore;
+                    // 记住压缩后大小：SDK 在下轮响应前报 null，快照用此回填底栏。
+                    conv.lastCompactionTokens = estimatedTokensAfter ?? null;
                     this.emit({
                         type: "notice",
                         level: "info",
@@ -2144,13 +2182,25 @@ export class ClientSession {
                 totalMessages: s.totalMessages,
                 tokens: s.tokens,
                 cost: s.cost,
-                contextUsage: s.contextUsage
-                    ? {
-                        tokens: s.contextUsage.tokens,
-                        contextWindow: s.contextUsage.contextWindow,
-                        percent: s.contextUsage.percent,
+                contextUsage: (() => {
+                    const cu = s.contextUsage;
+                    if (!cu)
+                        return stats.contextUsage;
+                    // 压缩刚结束、下轮响应未到：SDK 报 null，用压缩结果回填约数。
+                    if (cu.tokens == null && conv.lastCompactionTokens != null && cu.contextWindow > 0) {
+                        return {
+                            tokens: conv.lastCompactionTokens,
+                            contextWindow: cu.contextWindow,
+                            percent: (conv.lastCompactionTokens / cu.contextWindow) * 100,
+                            estimated: true,
+                        };
                     }
-                    : stats.contextUsage,
+                    return {
+                        tokens: cu.tokens,
+                        contextWindow: cu.contextWindow,
+                        percent: cu.percent,
+                    };
+                })(),
             };
         }
         catch {
@@ -2187,6 +2237,7 @@ export class ClientSession {
             queue: { steering: conv.queueSteering, followUp: conv.queueFollowUp },
             errorMessage: state.errorMessage,
             retry: conv.retryState ?? null,
+            compaction: conv.compactionState ?? null,
             tools: state.tools.map((t) => t.name),
             version: ++this.version,
             piConfigured: this.isPiConfigured(),
@@ -2466,7 +2517,7 @@ export class ClientSession {
         }
         try {
             const targets = collectTargets(this.agentDir, ClientSession.currentAppVersion());
-            const items = await checkAllUpdates(targets);
+            const items = await checkAllUpdates(targets, undefined, () => this.getLang());
             this.updatesAllCache = { at: Date.now(), items };
             this.emit({ type: "update_status_all", items });
         }
@@ -2581,7 +2632,11 @@ export class ClientSession {
             this.flushSnapshot();
         },
         refreshSessions: () => this.refreshSessions(),
-        afterReload: () => this.applyToolGating(this.session),
+        afterReload: () => {
+            // /reload 同样重读磁盘 settings.json——重放重试覆盖 + 终端门控。
+            this.applyRetryOverrides();
+            this.applyToolGating(this.session);
+        },
         pluginCommands: () => this.pluginCommandsProvider?.() ?? [],
         execPluginCommand: async (name, args) => {
             const def = this.pluginCommandsProvider?.().find((c) => c.name === name);
@@ -2626,10 +2681,10 @@ export class ClientSession {
         return this.modelAdmin.listModelsConfig();
     }
     fetchModelsList(reqId, baseUrl, apiKey, authHeader, api) {
-        return this.modelAdmin.fetchModelsList(reqId, baseUrl, apiKey, authHeader, api);
+        return this.modelAdmin.fetchModelsList(reqId, baseUrl, apiKey, authHeader, api, () => this.getLang());
     }
     refreshProviderModels(providerId, reqId) {
-        return this.modelAdmin.refreshProviderModels(providerId, reqId);
+        return this.modelAdmin.refreshProviderModels(providerId, reqId, () => this.getLang());
     }
     /** Copy a built-in provider into an editable custom-provider draft
      *  (clone_provider_result) — lets the user run a second API key without
@@ -2766,6 +2821,22 @@ export class ClientSession {
     pushSettings() {
         this.settingsSvc.push();
     }
+    /** 把设置面板的出错重试次数注入全部存活会话的 SDK SettingsManager。
+     *  applyOverrides 只改内存合并视图（不碰 ~/.pi/agent/settings.json），
+     *  且 SDK 每次退避前都重读 getRetrySettings()——即时生效、无需 reload。
+     *  但 session.reload() 会重读磁盘丢掉覆盖，每次 reload 后必须重放
+     *  （reloadSession / afterReload / 标记开关直载路径均已接）。 */
+    applyRetryOverrides() {
+        const n = normalizeRetryMaxAttempts(this.settingsSvc.current.retryMaxAttempts);
+        for (const c of this.convs.values()) {
+            try {
+                c.session.settingsManager.applyOverrides({ retry: { maxRetries: n } });
+            }
+            catch {
+                // 会话未就绪或已释放 → 其 runtime 创建时统一注入。
+            }
+        }
+    }
     /** Extensions/skills changed externally (e.g. `pi remove` finished in the
      *  terminal): re-run session.reload() and re-push state. Streaming-safe —
      *  deferred to agent_end, same as settings reloads. */
@@ -2774,7 +2845,10 @@ export class ClientSession {
     }
     /** Persist + apply a partial settings update (prompt text/mode, toggles). */
     async setSettings(partial) {
-        const { markersEnabled, disabledMarkers, ...rest } = partial;
+        const { markersEnabled, disabledMarkers, quickPhrasesSeeded, ...rest } = partial;
+        // 快捷短语「已 seed」是全局标记（非 per-clientId）：置位一次后永久生效。
+        if (quickPhrasesSeeded)
+            this.stateStore.markQuickPhrasesSeeded();
         let markerChanged = false;
         if (markersEnabled !== undefined || disabledMarkers !== undefined) {
             this.markerSvc.setAll({
@@ -2792,6 +2866,7 @@ export class ClientSession {
             if (!this.session.isStreaming) {
                 try {
                     await this.session.reload();
+                    this.applyRetryOverrides();
                     this.applyToolGating(this.session);
                     await this.pushSlashCommands();
                     this.pushSettings();
@@ -2870,6 +2945,26 @@ export class ClientSession {
         // 兼容旧入口：reload + 刷目录在宿主回调里完成
         return this.settingsSvc.applyRuntime();
     }
+    /** Server language for this client (issue #91): resolved LIVE from the
+     *  persisted UI locale — "zh" only for zh*; everything else (including
+     *  never-reported) is English. Per-call tool return values read this on
+     *  every invocation, so they follow language switches with no rebuild. */
+    getLang() {
+        return resolveServerLang(this.stateStore.get(this.clientId).locale);
+    }
+    /** Persist the browser UI locale (hello.locale / set_locale) and refresh
+     *  lang-aware prompt segments. Reuses the settings reload path, so it is
+     *  streaming-safe (deferred to agent_end mid-run, same as settings). */
+    async setLocale(locale) {
+        const code = locale.trim().slice(0, 16);
+        if (!code)
+            return;
+        const prev = this.getLang();
+        this.stateStore.saveLocale(this.clientId, code);
+        if (this.getLang() === prev)
+            return; // same server language — nothing to re-render
+        await this.applySettingsReload();
+    }
     // ---------------------------------------------------------------------------
     // Commands
     // ---------------------------------------------------------------------------
@@ -2963,6 +3058,8 @@ export class ClientSession {
                 emit: (msg) => this.emit(msg),
                 settings: this.settingsSvc.current,
                 session: this.session,
+                // issue #91：附件/视觉桥文案按客户端 UI 语言出中英（英文默认）。
+                getLang: () => this.getLang(),
             }, attachments);
             for (const aside of asides) {
                 await s.sendCustomMessage(aside.message, { deliverAs: "nextTurn" });
@@ -3224,7 +3321,7 @@ export class ClientSession {
             this.clearAllToolWatchdogs(conv);
             conv.toolStartTimes.clear();
             await conv.runtime.dispose();
-            const runtime = await createAgentSessionRuntime(this.makeRuntimeFactory(conv.terminals), {
+            const runtime = await createAgentSessionRuntime(this.makeRuntimeFactory(conv.terminals, undefined, conv.id), {
                 cwd: conv.cwd,
                 agentDir: this.agentDir,
                 sessionManager: SessionManager.continueRecent(conv.cwd),
@@ -3303,7 +3400,7 @@ export class ClientSession {
         try {
             const conversationId = this.nextConversationId();
             const terminals = this.makeTerminalManager(conversationId, this.cwd);
-            const runtime = await createAgentSessionRuntime(this.makeRuntimeFactory(terminals), {
+            const runtime = await createAgentSessionRuntime(this.makeRuntimeFactory(terminals, undefined, conversationId), {
                 cwd: this.cwd,
                 agentDir: this.agentDir,
                 sessionManager: SessionManager.create(this.cwd),
@@ -3387,7 +3484,7 @@ export class ClientSession {
                 reviewing: conv.goal.reviewing,
                 wizardRunning: conv.wizardRunning,
                 streaming: conv.session.isStreaming,
-                openTerminals: conv.terminals.list().length,
+                openTerminals: conv.terminals.countLive(),
                 listed: conv.listed,
                 promptedSinceActive: conv.promptedSinceActive,
                 hasActiveSubagentRun: () => hasActiveSubagentRun({ sessionId: conv.session.sessionFile }),
@@ -3784,7 +3881,7 @@ export class ClientSession {
                 reviewing: conv.goal.reviewing,
                 wizardRunning: conv.wizardRunning,
                 streaming: conv.session.isStreaming,
-                openTerminals: conv.terminals.list().length,
+                openTerminals: conv.terminals.countLive(),
                 listed: conv.listed,
                 promptedSinceActive: conv.promptedSinceActive,
                 hasActiveSubagentRun: () => hasActiveSubagentRun({ sessionId: conv.session.sessionFile }),
@@ -3799,7 +3896,7 @@ export class ClientSession {
                     textEn: `Conversation "${conv.title}" is still running — wait for it to finish or press Stop before removing`,
                 });
             }
-            else if (conv.terminals.list().length > 0) {
+            else if (conv.terminals.countLive() > 0) {
                 this.emit({
                     type: "notice",
                     level: "warning",
@@ -3857,7 +3954,7 @@ export class ClientSession {
             const targetCwd = sessionManager.getCwd();
             const conversationId = this.nextConversationId();
             openedTerminals = this.makeTerminalManager(conversationId, targetCwd);
-            openedRuntime = await createAgentSessionRuntime(this.makeRuntimeFactory(openedTerminals), {
+            openedRuntime = await createAgentSessionRuntime(this.makeRuntimeFactory(openedTerminals, undefined, conversationId), {
                 cwd: targetCwd,
                 agentDir: this.agentDir,
                 sessionManager,
@@ -4209,7 +4306,7 @@ export class ClientSession {
                 // First visit to this project: resume its most recent session.
                 const conversationId = this.nextConversationId();
                 const terminals = this.makeTerminalManager(conversationId, abs);
-                const newRuntime = await createAgentSessionRuntime(this.makeRuntimeFactory(terminals), {
+                const newRuntime = await createAgentSessionRuntime(this.makeRuntimeFactory(terminals, undefined, conversationId), {
                     cwd: abs,
                     agentDir: this.agentDir,
                     sessionManager: SessionManager.continueRecent(abs),
@@ -4615,6 +4712,25 @@ export class AgentService {
         for (const cs of this.clients.values())
             cs.refreshPluginTools();
     }
+    /** Browser UI locale report (hello.locale / set_locale): persist per client
+     *  and refresh lang-aware prompts (streaming-safe via ClientSession). */
+    async setLocale(clientId, locale) {
+        const cs = this.clients.get(clientId);
+        if (cs) {
+            await cs.setLocale(locale);
+            return;
+        }
+        // hello race: session still being created — wait for it, then apply.
+        const inflight = this.pending.get(clientId);
+        if (inflight) {
+            try {
+                await (await inflight).setLocale(locale);
+            }
+            catch {
+                /* attach failed — nothing to apply to */
+            }
+        }
+    }
     /** 插件斜杠命令集合变化时由 index.ts 触发：重推各客户端的命令目录。 */
     applyPluginCommandCatalog() {
         for (const cs of this.clients.values())

package/dist/server/attachments.js

@@ -188,12 +188,16 @@ export async function buildAttachmentMessages(ctx, attachments) {
             else {
                 // Batch hash so re-sending identical images (edit & re-ask) reuses
                 // the transcript instead of re-burning tokens on the vision API.
+                // issue #91：转写提示词按客户端 UI 语言选用（英文默认），语言进缓存键。
+                const vLang = ctx.getLang?.() ?? "en";
                 // The active transcription prompt is part of the key: changing
                 // the custom prompt must invalidate cached transcripts made with
                 // the old prompt.
                 const batchHash = bridgedImages.map((b) => `${b.att.name ?? "img"}:${b.raw.slice(0, 48)}`).join("|") +
                     "::" +
-                    buildVisionBridgePrompt(ctx.settings.visionBridgePromptMode, ctx.settings.visionBridgePrompt);
+                    buildVisionBridgePrompt(ctx.settings.visionBridgePromptMode, ctx.settings.visionBridgePrompt, vLang) +
+                    "::" +
+                    vLang;
                 let transcript = visionBridgeCache.get(batchHash);
                 if (transcript === undefined) {
                     ctx.emit({
@@ -210,7 +214,8 @@ export async function buildAttachmentMessages(ctx, attachments) {
                             name: b.att.name,
                         })), {
                             model: chosenModel ?? undefined,
-                            systemPrompt: buildVisionBridgePrompt(ctx.settings.visionBridgePromptMode, ctx.settings.visionBridgePrompt),
+                            systemPrompt: buildVisionBridgePrompt(ctx.settings.visionBridgePromptMode, ctx.settings.visionBridgePrompt, vLang),
+                            lang: vLang,
                         });
                         visionBridgeCache.set(batchHash, transcript);
                         ctx.emit({