@jingyi0605/codingns4dsh 0.2.1-beta.10 → 0.2.1-beta.12

package/data/build/dist/host/cli-adapters/feature.js

@@ -31,7 +31,14 @@ import { containsDelegationCarrier, delegationAdapterIds, rewriteDelegationMessa
 import { clearDelegationAuthorization, setDelegationAuthorization } from './delegation-authorization.js';
 import { debugInfo } from '../../shared/debug.js';
 import { hasLegacySessionAdapterHint } from './legacy-session-adapter.js';
-import {} from '../../shared/contracts/session-translation.js';
+import { DSH_NATIVE_SESSION_ADAPTER_ID, formatSessionTranslationOutput, readSessionTranslationMetrics, } from '../../shared/contracts/session-translation.js';
+import { createInteractionTranslation } from '../features/interaction-translation.js';
+import { createSessionTranslationRecovery, SessionTranslationCancelled } from '../features/session-translation-recovery.js';
+import { ASSISTANT_AGENT_PREFIX } from '../../dsh-capabilities/host/assistant-agent-adapter.js';
+import { createDshCapabilityRegistry } from '../../dsh-capabilities/routes.js';
+import { attachmentFileNotice } from '../../shared/attachment-prompts.js';
+import { sessionPromptScope } from '../../dsh-capabilities/host/session-prompt-adapter.js';
+import { createSessionPromptTranslation } from '../features/session-prompt-translation.js';
 export function createCliAdaptersFeature(options = {}) {
     return {
         descriptor: {
@@ -40,8 +47,10 @@ export function createCliAdaptersFeature(options = {}) {
             enabledByDefault: true,
             dependencies: [],
             runtime: 'host',
+            requires: [{ capability: 'session.external-model-selection', required: false, fallback: 'degrade' }],
         },
         async start(context) {
+            const lifetime = new AbortController();
             // 用量查询超时对所有适配器统一生效：同一个 timeoutMs 下发给全部网络读取器，
             // 设置变更时整体重建，避免旧超时继续生效。
             const buildSubscriptions = (settings) => {
@@ -91,6 +100,18 @@ export function createCliAdaptersFeature(options = {}) {
             virtualProviders?.setProviders(registry.enabledAdapterIds());
             if (virtualProviders !== undefined)
                 context.resources.add(() => virtualProviders.dispose());
+            if (context.services.dshContext !== undefined && context.services.dshVersion !== undefined) {
+                const selection = createDshCapabilityRegistry(context.services.dshVersion, 'host', context.services.dshContext)
+                    .getProfile(context.services.dshContext).capabilities.get('session.external-model-selection')
+                    ?.value;
+                if (selection !== undefined)
+                    context.resources.add(selection.install((sessionId) => {
+                        const config = registry.getSession(sessionId);
+                        if (config.adapterId === 'dsh' || !registry.isEnabled(config.adapterId))
+                            return undefined;
+                        return { provider: config.adapterId, model: config.modelId?.trim() || 'provider-default' };
+                    }));
+            }
             registry.warmCatalog();
             // 外部适配器没有经过 DSH 原生 Agent Loop，必须把同一套运行状态投影给
             // subagentCatalog。这里集中去重，避免 llm/stream、原生 session/event 和
@@ -130,8 +151,27 @@ export function createCliAdaptersFeature(options = {}) {
                 });
                 context.resources.add(disposeNativeEvents);
             }
-            registerDelegationAgentHooks(context.services.dshContext, registry, context.resources, publishExternalStatus, translation);
-            context.resources.add(context.services.rpc.register('cli', (action, payload) => {
+            const translationRecovery = createSessionTranslationRecovery(translation, sessionId => registry.getSession(sessionId));
+            context.resources.add(() => translationRecovery.dispose());
+            const promptTranslation = createSessionPromptTranslation(translation, sessionId => {
+                if (!sessionId || isAssistantSession(sessionId) || readNativeSessionHeader(nativeSessions, sessionId)?.origin === 'subagent')
+                    return undefined;
+                const config = registry.getSession(sessionId);
+                return (config.translationEnabled ?? (config.adapterId === 'dsh' && translation?.nativeEnabled === true)) ? config.adapterId : undefined;
+            });
+            context.resources.add(() => promptTranslation.dispose());
+            if (context.services.dshContext !== undefined && context.services.dshVersion !== undefined) {
+                const adapter = createDshCapabilityRegistry(context.services.dshVersion, 'host', context.services.dshContext)
+                    .getProfile(context.services.dshContext).capabilities.get('session.prompt-assembly')?.value;
+                if (adapter !== undefined)
+                    context.resources.add(adapter.install((assembly, scope) => promptTranslation.translateAssembly(assembly, scope)));
+            }
+            registerDelegationAgentHooks(context.services.dshContext, registry, context.resources, publishExternalStatus, translation, translationRecovery, promptTranslation, nativeSessions);
+            const interactionTranslation = createInteractionTranslation(translation, sessionId => registry.getSession(sessionId));
+            context.resources.add(() => interactionTranslation.dispose());
+            context.resources.add(context.services.rpc.register('cli', (action, payload, rpcContext) => {
+                const rpcSignal = asRecord(rpcContext)?.signal;
+                const signal = isAbortSignal(rpcSignal) ? rpcSignal : undefined;
                 switch (action) {
                     case 'catalog': return registry.catalog();
                     case 'catalog/refresh': return registry.refreshCatalog(asRecord(payload)?.adapterId === undefined ? undefined : readAdapterId(payload)).then((catalog) => {
@@ -143,6 +183,10 @@ export function createCliAdaptersFeature(options = {}) {
                         return adapterId === 'dsh' ? readDshModelCatalog(context.services.dshContext) : registry.models(adapterId);
                     }
                     case 'translation/models': return context.services.sessionTranslation?.catalog() ?? { models: [], default: null, errors: ['翻译模型目录不可用'] };
+                    case 'translation/pending': return translationRecovery.pending(payload);
+                    case 'translation/resolve': return translationRecovery.resolve(payload);
+                    case 'translation/retry-output': return translationRecovery.retryOutput(payload, signal);
+                    case 'translation/fields': return interactionTranslation.translate(payload, signal);
                     case 'skills': {
                         const request = readSkillsRequest(payload);
                         const cwd = resolveSessionCwd(context.services.nativeSessions, request.sessionId, null);
@@ -160,15 +204,26 @@ export function createCliAdaptersFeature(options = {}) {
                         }
                         return registry.getSession(sessionId);
                     }
-                    case 'session/set': return registry.setSession(readSessionId(payload), readSessionConfig(payload));
+                    case 'session/set': {
+                        const sessionId = readSessionId(payload);
+                        const previous = registry.getSession(sessionId);
+                        const config = registry.setSession(sessionId, readSessionConfig(payload));
+                        if (config.translationEnabled === false || previous.adapterId !== config.adapterId)
+                            translationRecovery.cancelSession(sessionId);
+                        return config;
+                    }
                     case 'session/list': return registry.listSessions(readSessionListOptions(payload));
                     case 'session/adapter-map':
                         // 列表查询只返回持久化索引，不能触发会话加载或历史解析。
                         return sessionStore.adapterBindings();
                     case 'session/archive': return registry.archiveSession(readSessionId(payload));
-                    case 'session/steer': return translateSteerPrompt(translation, registry, readSessionId(payload), readPrompt(payload), false);
-                    case 'session/follow-up': return translateSteerPrompt(translation, registry, readSessionId(payload), readPrompt(payload), true);
-                    case 'session/interrupt': return registry.interrupt(readSessionId(payload));
+                    case 'session/steer': return translateSteerPrompt(translationRecovery, registry, readSessionId(payload), readPrompt(payload), false, signal);
+                    case 'session/follow-up': return translateSteerPrompt(translationRecovery, registry, readSessionId(payload), readPrompt(payload), true, signal);
+                    case 'session/interrupt': {
+                        const sessionId = readSessionId(payload);
+                        translationRecovery.cancelSession(sessionId);
+                        return registry.interrupt(sessionId);
+                    }
                     case 'team/status': return context.services.nativeTeam?.diagnostic() ?? registry.teamDiagnostic();
                     case 'team/members': return requireTeam(context).invoke('members', payload);
                     case 'team/tasks': return requireTeam(context).invoke('tasks', payload);
@@ -259,6 +314,7 @@ export function createCliAdaptersFeature(options = {}) {
                     virtualProviders?.setProviders(registry.enabledAdapterIds());
                     registry.syncPreferences(next.agentAdapterPreferences);
                     sessionStore.sync(next.cliSessions);
+                    translationRecovery.cancelDisabled(next.sessionTranslation?.nativeEnabled === true, next.sessionTranslation?.inputEnabled !== false);
                     const nextSubscriptionSettings = JSON.stringify(next.subscriptionUsage ?? null);
                     if (nextSubscriptionSettings !== subscriptionSettings) {
                         subscriptionSettings = nextSubscriptionSettings;
@@ -344,6 +400,18 @@ export function createCliAdaptersFeature(options = {}) {
                         if (sessionId !== '' && (selection.modelId !== undefined || selection.effortId !== undefined)) {
                             registry.setSession(sessionId, { adapterId: 'dsh', ...selection });
                         }
+                        // Native-session output translation wraps only DSH's own Provider stream:
+                        // preserve text/reasoning and attach the translation record; the client renders it.
+                        if (!isSessionTranslationLlmRequest(value)
+                            && translation !== undefined
+                            && translation.enabled
+                            && (config.translationEnabled ?? translation.nativeEnabled === true)
+                            && sessionId !== ''
+                            && !isAssistantSession(sessionId)
+                            && readNativeSessionHeader(nativeSessions, sessionId)?.origin !== 'subagent') {
+                            yield* guardDshNativeStream(() => translateNativeStream(next(), translation, translation.bilingual === true, isAbortSignal(value?.signal) ? value.signal : undefined));
+                            return;
+                        }
                         yield* guardDshNativeStream(next);
                         return;
                     }
@@ -351,19 +419,24 @@ export function createCliAdaptersFeature(options = {}) {
                     const turnInput = extractTurnInput(messages, context.services.dshContext);
                     const turnOptions = readCliTurnOptions(value);
                     const runtimeEnv = readCliRuntimeEnv(value);
-                    const requestSignal = isAbortSignal(value?.signal) ? value.signal : undefined;
+                    const requestSignal = isAbortSignal(value?.signal)
+                        ? AbortSignal.any([value.signal, lifetime.signal])
+                        : lifetime.signal;
+                    const translationLanguage = translation?.enabled && translation.inputEnabled !== false && config.translationEnabled === true ? readInputTargetLanguage(translation) : undefined;
                     let translatedPrompt = turnInput.translationPrompt;
-                    if (turnInput.translatePrompt && translation !== undefined) {
+                    if (turnInput.translatePrompt && turnInput.translationPrompt.trim() !== '' && translationLanguage !== undefined) {
                         try {
-                            translatedPrompt = await translation.translateInput(config.adapterId, turnInput.translationPrompt, requestSignal, config.translationEnabled === true);
+                            translatedPrompt = (await translationRecovery.translateInput(sessionId, config.adapterId, turnInput.translationPrompt, requestSignal)).translated;
                         }
-                        catch {
-                            // 翻译服务异常不能阻断外部 Agent 主任务；本轮直接发送原文。
-                            translatedPrompt = turnInput.translationPrompt;
+                        catch (error) {
+                            if (!(error instanceof SessionTranslationCancelled) && !requestSignal?.aborted)
+                                throw error;
+                            yield { type: 'finish', reason: { kind: 'stop' } };
+                            return;
                         }
                     }
                     const prompt = turnInput.translatePrompt
-                        ? [translatedPrompt, turnInput.untranslatedPrompt].filter((part) => part.trim() !== '').join('\n\n')
+                        ? [translatedPrompt, translationLanguage === undefined ? turnInput.untranslatedPrompt : attachmentNotices(turnInput.attachments, translationLanguage)].filter((part) => part.trim() !== '').join('\n\n')
                         : turnInput.prompt;
                     // 权限状态必须与 DSH 会话当前生效值同源。驱动不能自行假设“完全权限”，
                     // 也不能把缺省当成“已确认无限制”：解析失败时留空，由驱动沿用保守默认。
@@ -376,6 +449,7 @@ export function createCliAdaptersFeature(options = {}) {
                         sessionId,
                         messages: turnInput.messages,
                         prompt,
+                        ...(translationLanguage === undefined ? {} : { translationLanguage }),
                         ...(turnInput.attachments.length === 0 ? {} : { attachments: turnInput.attachments }),
                         ...(permission === undefined ? {} : { permission }),
                         ...(turnOptions.plan === true ? { plan: true } : {}),
@@ -472,6 +546,8 @@ export function createCliAdaptersFeature(options = {}) {
                 // DSH 先停用设置上下文再执行异步资源清理时，旧的写队列不能继续调用
                 // configEditor，否则会出现 inactive context 并污染退出日志。
                 sessionStore.dispose();
+                // Close native interaction cards before unloading their provider transports.
+                lifetime.abort();
                 await registry.dispose();
                 await sessionStore.flush();
                 setAdapterRegistry(undefined);
@@ -526,12 +602,13 @@ function createExternalSessionStatusPublisher(events, registry, sessionStore) {
  * `messages`，会直接抛出只读属性异常。`agent/pre-step` 返回的新消息保留用户原文，并把
  * 译文写入 source 元数据；外部适配器再据此构造发给 Agent 的译文。
  */
-function registerDelegationAgentHooks(dshContext, registry, resources, publishExternalStatus, translation) {
+function registerDelegationAgentHooks(dshContext, registry, resources, publishExternalStatus, translation, translationRecovery, promptTranslation, nativeSessions) {
     if (dshContext === undefined || typeof dshContext.on !== 'function')
         return;
     const disposers = [];
     const register = (name, listener) => {
-        const disposer = dshContext.on(name, listener, { global: true });
+        // Wrap existing pre-step producers so their after-next catalogs are visible.
+        const disposer = dshContext.on(name, listener, { global: true, prepend: name === 'agent/pre-step' });
         if (typeof disposer === 'function')
             disposers.push(disposer);
     };
@@ -588,20 +665,44 @@ function registerDelegationAgentHooks(dshContext, registry, resources, publishEx
                 messages = [...delegation.value.messages];
             }
         }
-        const translatedInput = await translatePreStepInput(translation, registry, sessionId, messages, dshContext, isAbortSignal(record?.signal) ? record.signal : undefined);
+        let translatedInput;
+        try {
+            translatedInput = await translatePreStepInput(translation, translationRecovery, registry, sessionId, messages, dshContext, isAbortSignal(record?.signal) ? record.signal : undefined, nativePreStepContext(translation, registry, sessionId, nativeSessions));
+        }
+        catch (error) {
+            if (error instanceof SessionTranslationCancelled || record?.signal?.aborted === true)
+                return { kind: 'reject' };
+            throw error;
+        }
         if (translatedInput !== undefined)
             messages = [...translatedInput];
         const decision = await next();
         if (!isEnterPreStepDecision(decision))
             return decision;
-        if (delegation?.kind !== 'rewritten' && translatedInput === undefined)
-            return decision;
-        // `next()` 可能已经追加系统上下文或模型切换通知，只替换它前面的本轮用户消息。
-        const suffix = decision.messages.slice(messages.length);
-        return {
-            ...decision,
-            messages: [...messages, ...suffix],
-        };
+        // Match producer-owned messages by identity. Downstream middleware may insert
+        // instructions before the human message, so a positional prefix loses data.
+        const incoming = Array.isArray(record?.messages) ? record.messages.filter(isMessage) : [];
+        const replaced = new Set();
+        const accepted = delegation?.kind === 'rewritten' || translatedInput !== undefined
+            ? decision.messages.map(message => {
+                const index = incoming.findIndex((original, position) => !replaced.has(position) && (original === message || typeof original.id === 'string' && original.id === message.id
+                    // Legacy callers can return detached messages without durable IDs.
+                    || original.id === undefined && message.id === undefined && original.role === message.role
+                        && original.source?.kind === message.source?.kind && original.source?.form === message.source?.form
+                        && JSON.stringify(original.content) === JSON.stringify(message.content)));
+                if (index >= 0)
+                    replaced.add(index);
+                return index < 0 ? message : messages[index] ?? message;
+            }) : decision.messages;
+        try {
+            const scope = sessionPromptScope(record?.agent, isAbortSignal(record?.signal) ? record.signal : undefined);
+            return { ...decision, messages: await promptTranslation.translateMessages(accepted, scope) };
+        }
+        catch (error) {
+            if (error instanceof SessionTranslationCancelled || record?.signal?.aborted === true)
+                return { kind: 'reject' };
+            throw error;
+        }
     });
     // 正常结束、异常结束和中断最终都会进入 idle；在此清理本轮授权，避免下一轮
     // 没有 carrier 时继承上一轮的目标白名单。
@@ -611,12 +712,14 @@ function registerDelegationAgentHooks(dshContext, registry, resources, publishEx
         if (record?.status === 'running')
             publishExternalStatus(sessionId, true);
         else if (record?.status === 'idle') {
+            translationRecovery.cancelSession(sessionId);
             publishExternalStatus(sessionId, false);
             clearDelegationAuthorization(sessionId);
         }
     });
     register('agent/disposed', (payload) => {
         const sessionId = readAgentSessionId(asRecord(payload)?.agent);
+        translationRecovery.cancelSession(sessionId);
         // disposed 只代表运行时释放；subagentCatalog 没有删除语义，保留目录项并
         // 把它标成 idle，后续若 DSH 重新激活会再次收到 running。
         publishExternalStatus(sessionId, false);
@@ -979,18 +1082,20 @@ async function setAdapterEnabled(settings, registry, value) {
     return { adapterId, enabled };
 }
 /** 运行中的外部 Agent 插话也必须经过同一条输入翻译路径。 */
-async function translateSteerPrompt(translation, registry, sessionId, prompt, followUp) {
+async function translateSteerPrompt(translationRecovery, registry, sessionId, prompt, followUp, signal) {
     const session = registry.getSession(sessionId);
     let translated = prompt;
-    if (translation !== undefined) {
+    if (session.translationEnabled === true) {
         try {
-            translated = await translation.translateInput(session.adapterId, prompt, undefined, session.translationEnabled === true);
+            translated = (await translationRecovery.translateInput(sessionId, session.adapterId, prompt, signal)).translated;
         }
-        catch {
-            // 插话翻译失败时仍把用户原文交给外部 Agent。
-            translated = prompt;
+        catch (error) {
+            if (error instanceof SessionTranslationCancelled)
+                return;
+            throw error;
         }
     }
+    signal?.throwIfAborted();
     await registry.steer(sessionId, translated, followUp);
 }
 /**
@@ -999,9 +1104,42 @@ async function translateSteerPrompt(translation, registry, sessionId, prompt, fo
  * DSH 随后会把返回的消息写入 `user/message`。正文只放实际发送的译文；原文和模型
  * 记录在 source 元数据中供 Client 详情按钮读取。外部 CLI 边界也会移除该元数据。
  */
-async function translatePreStepInput(translation, registry, sessionId, messages, dshContext, signal) {
-    if (translation === undefined || !translation.enabled || sessionId.trim() === '')
+async function translatePreStepInput(translation, translationRecovery, registry, sessionId, messages, dshContext, signal, nativeSession) {
+    if (translation === undefined || !translation.enabled || translation.inputEnabled === false || sessionId.trim() === '')
+        return undefined;
+    const messageIndex = findLatestHumanMessage(messages);
+    const current = messageIndex < 0 ? undefined : messages[messageIndex];
+    if (current === undefined || readInputTranslation(current.source) !== undefined)
         return undefined;
+    if (nativeSession !== undefined) {
+        // DSH 原生会话：消息本身就是发给 Provider 的正文，直接替换为译文并把原文留在元数据。
+        if (nativeSession.translationEnabled !== true)
+            return undefined;
+        const input = extractTurnInput(messages, dshContext);
+        if (input.prompt.trim() === '')
+            return undefined;
+        const result = await translationRecovery.translateInput(sessionId, nativeSession.adapterId, input.translationPrompt, signal);
+        const translated = [result.translated, attachmentNotices(input.attachments, readInputTargetLanguage(translation))].filter((part) => part.trim() !== '').join('\n\n').trim();
+        if (translated === '')
+            return undefined;
+        const record = {
+            original: input.prompt,
+            translated,
+            ...(result.sourceLanguage === undefined ? {} : { sourceLanguage: result.sourceLanguage }),
+            targetLanguage: readInputTargetLanguage(translation),
+            ...(result.alreadyTargetLanguage === true ? { alreadyTargetLanguage: true } : {}),
+            ...(result.model === undefined ? {} : { model: result.model }),
+            ...readSessionTranslationMetrics(result),
+            ...(result.failed === true ? { failed: true } : {}),
+        };
+        const next = [...messages];
+        next[messageIndex] = {
+            ...current,
+            content: result.failed ? current.content : replaceInputTranslationContent(nativeTranslationContent(current.content, dshContext), translated),
+            source: { ...(current.source ?? {}), kind: 'user', codingnsTranslationInput: record },
+        };
+        return next;
+    }
     let session;
     try {
         session = registry.getSession(sessionId);
@@ -1011,37 +1149,11 @@ async function translatePreStepInput(translation, registry, sessionId, messages,
     }
     if (session.adapterId === 'dsh' || session.translationEnabled !== true)
         return undefined;
-    const messageIndex = findLatestHumanMessage(messages);
-    const current = messageIndex < 0 ? undefined : messages[messageIndex];
-    if (current === undefined || readInputTranslation(current.source) !== undefined)
-        return undefined;
     const input = extractTurnInput(messages, dshContext);
-    if (input.translationPrompt.trim() === '')
+    if (input.prompt.trim() === '')
         return undefined;
-    let translatedNatural;
-    let translationSourceLanguage = undefined;
-    let alreadyTargetLanguage = false;
-    let translationModel;
-    let translationFailed = false;
-    try {
-        if (translation.translateInputDetailed !== undefined) {
-            const detailed = await translation.translateInputDetailed(session.adapterId, input.translationPrompt, signal, true);
-            translatedNatural = detailed.translated;
-            translationSourceLanguage = detailed.sourceLanguage;
-            alreadyTargetLanguage = detailed.alreadyTargetLanguage === true;
-            translationModel = detailed.model;
-            translationFailed = detailed.failed === true;
-        }
-        else {
-            translatedNatural = await translation.translateInput(session.adapterId, input.translationPrompt, signal, true);
-        }
-    }
-    catch {
-        // 翻译只是增强能力；异常时保持现有外部 Agent 回合继续使用原文。
-        translatedNatural = input.translationPrompt;
-        translationFailed = true;
-    }
-    const translated = [translatedNatural, input.untranslatedPrompt]
+    const result = await translationRecovery.translateInput(sessionId, session.adapterId, input.translationPrompt, signal);
+    const translated = [result.translated, attachmentNotices(input.attachments, readInputTargetLanguage(translation))]
         .filter((part) => part.trim() !== '')
         .join('\n\n')
         .trim();
@@ -1050,11 +1162,12 @@ async function translatePreStepInput(translation, registry, sessionId, messages,
     const record = {
         original: input.prompt,
         translated,
-        ...(translationSourceLanguage === undefined ? {} : { sourceLanguage: translationSourceLanguage }),
-        targetLanguage: translation.inputLanguage ?? 'en',
-        ...(alreadyTargetLanguage ? { alreadyTargetLanguage: true } : {}),
-        ...(translationModel === undefined ? {} : { model: translationModel }),
-        ...(translationFailed ? { failed: true } : {}),
+        ...(result.sourceLanguage === undefined ? {} : { sourceLanguage: result.sourceLanguage }),
+        targetLanguage: readInputTargetLanguage(translation),
+        ...(result.alreadyTargetLanguage === true ? { alreadyTargetLanguage: true } : {}),
+        ...(result.model === undefined ? {} : { model: result.model }),
+        ...readSessionTranslationMetrics(result),
+        ...(result.failed === true ? { failed: true } : {}),
     };
     const next = [...messages];
     next[messageIndex] = {
@@ -1067,6 +1180,177 @@ async function translatePreStepInput(translation, registry, sessionId, messages,
     };
     return next;
 }
+/** 旧测试替身没有 inputLanguage 时沿用历史默认值英语。 */
+function readInputTargetLanguage(translation) {
+    const language = translation.inputLanguage;
+    return language === undefined ? 'en' : language;
+}
+/**
+ * 判断本次 pre-step 是否按 DSH 原生会话翻译。
+ *
+ * 原生会话的翻译记录来自全局 `nativeEnabled` 与适配器偏好（会话索引对 `dsh` 不落盘），
+ * 子代理与插件自己的助理会话必须排除，避免把内部执行流水线翻译掉。
+ */
+function nativePreStepContext(translation, registry, sessionId, nativeSessions) {
+    if (translation === undefined || !translation.enabled || sessionId.trim() === '')
+        return undefined;
+    if (isAssistantSession(sessionId))
+        return undefined;
+    if (readNativeSessionHeader(nativeSessions, sessionId)?.origin === 'subagent')
+        return undefined;
+    let session;
+    try {
+        session = registry.getSession(sessionId);
+    }
+    catch {
+        return undefined;
+    }
+    if (session.adapterId !== DSH_NATIVE_SESSION_ADAPTER_ID)
+        return undefined;
+    return {
+        adapterId: DSH_NATIVE_SESSION_ADAPTER_ID,
+        // 会话级开关优先；用户没有单独设置过该会话时跟随「DSH 原生会话」总开关。
+        translationEnabled: session.translationEnabled ?? translation.nativeEnabled === true,
+    };
+}
+/** 读取原生会话 header；测试替身或会话尚未装载时返回 undefined。 */
+function readNativeSessionHeader(nativeSessions, sessionId) {
+    if (nativeSessions === undefined)
+        return undefined;
+    try {
+        return asRecord(asRecord(nativeSessions.get(sessionId))?.header) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** 插件自己的全局助理会话不属于用户对话，不能被翻译改写。 */
+function isAssistantSession(sessionId) {
+    // 复用助理适配器导出的会话前缀常量：会话身份的唯一定义在那里，重复字面量会漂移。
+    return sessionId.startsWith(ASSISTANT_AGENT_PREFIX);
+}
+/**
+ * DSH 原生会话的输出翻译。
+ *
+ * 原生回复由 DSH 自己组装成 `assistant/message`，插件只能在 Provider 流边界改写：
+ * 文本与思考增量先缓存，块结束时一次性发出原文，并把译文放进记录供客户端显示；
+ * 工具调用、usage 与 finish 原样透传。翻译失败、流中断或异常都会补发原文块，保证回复不丢失。
+ */
+async function* translateNativeStream(stream, translation, bilingual, signal) {
+    const blocks = new Map();
+    const bufferOf = (index, kind) => {
+        const existing = blocks.get(index);
+        if (existing !== undefined)
+            return existing.kind === kind && !existing.closed ? existing : undefined;
+        const created = {
+            index, kind, text: '', closed: false,
+            translate: translation.shouldTranslate(DSH_NATIVE_SESSION_ADAPTER_ID, kind === 'reasoning' ? 'reasoning' : 'assistant', true),
+        };
+        blocks.set(index, created);
+        return created;
+    };
+    const translateBlock = async (block) => {
+        const original = block.text;
+        if (original.trim() === '')
+            return [];
+        const kind = block.kind === 'reasoning' ? 'reasoning' : 'assistant';
+        let record;
+        try {
+            const result = await translation.translateOutput(DSH_NATIVE_SESSION_ADAPTER_ID, kind, original, signal, true);
+            if (result !== null && result !== undefined) {
+                record = {
+                    original: result.original,
+                    translated: result.translated,
+                    ...(result.sourceLanguage === undefined ? {} : { sourceLanguage: result.sourceLanguage }),
+                    targetLanguage: result.targetLanguage,
+                    outputKind: kind,
+                    bilingual: result.bilingual,
+                    ...(result.alreadyTargetLanguage === true ? { alreadyTargetLanguage: true } : {}),
+                    ...(result.model === undefined ? {} : { model: result.model }),
+                    ...readSessionTranslationMetrics(result),
+                    ...(result.failed === true ? { failed: true } : {}),
+                };
+            }
+        }
+        catch {
+            record = { original, translated: original, targetLanguage: translation.outputLanguage ?? 'zh', outputKind: kind, bilingual, failed: true };
+        }
+        if (record === undefined)
+            return [];
+        const visible = formatSessionTranslationOutput(record);
+        if (visible.trim() === '' || visible === original && record.failed !== true)
+            return [];
+        return [
+            // Keep the provider text in the native history. The client chooses the translated
+            // text for display from codingnsTranslation.translated.
+            { type: `${block.kind}-delta`, index: block.index, text: original, codingnsTranslation: record },
+            { type: 'block-end', index: block.index, block: { type: block.kind, text: original, codingnsTranslation: record }, codingnsTranslation: record },
+        ];
+    };
+    try {
+        for await (const chunk of stream) {
+            const record = asRecord(chunk);
+            const type = typeof record?.type === 'string' ? record.type : '';
+            const index = typeof record?.index === 'number' ? record.index : undefined;
+            if (type === 'text-delta' || type === 'reasoning-delta') {
+                if (index === undefined || typeof record?.text !== 'string') {
+                    yield chunk;
+                    continue;
+                }
+                const kind = type === 'text-delta' ? 'text' : 'reasoning';
+                const block = bufferOf(index, kind);
+                // Decide once per block: changing settings must not translate only a suffix
+                // or drop a prefix that was already buffered.
+                if (block === undefined || !block.translate) {
+                    yield chunk;
+                    continue;
+                }
+                block.text += record.text;
+                continue;
+            }
+            if (type === 'block-end' && index !== undefined) {
+                const block = blocks.get(index);
+                if (block !== undefined && !block.closed) {
+                    block.closed = true;
+                    if (block.text.trim() !== '') {
+                        const emitted = await translateBlock(block);
+                        for (const item of emitted)
+                            yield item;
+                        if (emitted.length > 0)
+                            continue;
+                        yield { type: `${block.kind}-delta`, index: block.index, text: block.text };
+                    }
+                }
+                yield chunk;
+                continue;
+            }
+            yield chunk;
+        }
+    }
+    catch (error) {
+        // 流异常时先把缓存正文按原文补发，再把原始错误交给 DSH，保证回复不丢失。
+        for (const item of flushBuffered())
+            yield item;
+        throw error;
+    }
+    for (const item of flushBuffered())
+        yield item;
+    /**
+     * Provider 未发送 block-end（中断或异常）时，把缓存正文按原文补发。
+     *
+     * 不能用 `finally` 里的 `yield`：异常正在传播时生成器已经结束，后续 yield 会被
+     * 直接丢弃，用户会看不到已经生成的半截回复。
+     */
+    function* flushBuffered() {
+        for (const block of [...blocks.values()]) {
+            if (block.closed || block.text.trim() === '')
+                continue;
+            block.closed = true;
+            yield { type: `${block.kind}-delta`, index: block.index, text: block.text };
+            yield { type: 'block-end', index: block.index, block: { type: block.kind, text: block.text } };
+        }
+    }
+}
 function extractTurnInput(messages, dshContext) {
     for (let index = messages.length - 1; index >= 0; index -= 1) {
         const message = messages[index];
@@ -1125,7 +1409,7 @@ function readInputTranslation(value) {
         return undefined;
     if (candidate.original.trim() === '' || candidate.translated.trim() === '')
         return undefined;
-    const targetLanguage = candidate.targetLanguage === 'fr' || candidate.targetLanguage === 'de' || candidate.targetLanguage === 'ja'
+    const targetLanguage = candidate.targetLanguage === 'fr' || candidate.targetLanguage === 'de' || candidate.targetLanguage === 'ja' || candidate.targetLanguage === 'zh'
         ? candidate.targetLanguage
         : 'en';
     const sourceLanguage = candidate.sourceLanguage === 'zh' || candidate.sourceLanguage === 'en' || candidate.sourceLanguage === 'fr' || candidate.sourceLanguage === 'de' || candidate.sourceLanguage === 'ja'
@@ -1175,6 +1459,19 @@ function replaceInputTranslationContent(content, text) {
     });
     return replaced ? blocks : [{ type: 'text', text }, ...content];
 }
+/** Resolved files already have localized path notices. Leaving their file blocks
+ * would make DSH append another, English-only file notice at adapter dispatch.
+ * Preserve images and unresolved files so DSH retains modality/error handling.
+ */
+function nativeTranslationContent(content, dshContext) {
+    if (!Array.isArray(content))
+        return content;
+    return content.filter(part => {
+        if (!isRecord(part) || part.type !== 'file')
+            return true;
+        return resolveDshAttachmentPath(dshContext, 'file', isRecord(part.attachment) ? part.attachment : part) === undefined;
+    });
+}
 /** DSH 为工具分段注入的继续提示必须成为下一次 Provider 请求的 prompt。 */
 function isInjectedStepNotice(message) {
     if (message.role !== 'user' || !isRecord(message.source))
@@ -1230,11 +1527,13 @@ function extractMessageInput(content, dshContext) {
         const mimeType = typeof reference.mediaType === 'string' && reference.mediaType.trim() !== '' ? reference.mediaType.trim() : undefined;
         attachments.push({ kind, path, ...(name === undefined ? {} : { name }), ...(mimeType === undefined ? {} : { mimeType }) });
     }
-    const fileNotes = attachments.filter((attachment) => attachment.kind === 'file').map((attachment) => `附件文件${attachment.name === undefined ? '' : `「${attachment.name}」`}位于：${attachment.path}\n请使用工具读取该文件的内容。`);
     const translationPrompt = text.join('\n\n').trim();
-    const untranslatedPrompt = fileNotes.join('\n\n').trim();
+    const untranslatedPrompt = attachmentNotices(attachments);
     return { prompt: [translationPrompt, untranslatedPrompt].filter(value => value !== '').join('\n\n'), translationPrompt, untranslatedPrompt, attachments };
 }
+function attachmentNotices(attachments, language) {
+    return attachments.filter(attachment => attachment.kind === 'file').map(attachment => attachmentFileNotice(attachment, language)).join('\n\n');
+}
 function resolveDshAttachmentPath(dshContext, kind, reference) {
     if (dshContext === undefined || typeof reference.attachmentId !== 'string')
         return undefined;