@lynn123411/dsh-chat-translate 1.3.2 → 1.5.0

package/lib/types/client/index.d.ts

@@ -3,10 +3,11 @@ export declare const name = "dsh-chat-translate";
 /**
  * Declared services: slots for the shared 「阅读体验」 settings page (page claim
  * plus the card registration), settingsScope for the per-namespace settings
- * mirror, and the remote + remote.credentials pair for the credentials Remote
- * namespace — the runtime withholds any service not declared here, so
- * `ctx.remote.credentials` would be undefined otherwise. The locale service is
- * optional and read through `ctx.get`, like the renderer's slots registry.
+ * mirror, the remote + remote.credentials pair for the credentials Remote
+ * namespace, and locale for the card's own dictionary. The runtime withholds any
+ * service not declared here; `locale` is declared rather than sampled because
+ * `ctx.get('locale')` at apply time can beat the locale plugin's `provide`,
+ * which silently left the card's dictionary unregistered.
  */
 export declare const inject: string[];
 interface ClientContext {
@@ -20,7 +21,7 @@ interface ClientContext {
     };
 }
 /**
- * Mount the tool-call / think-summary translation observer and the settings UI
+ * Mount the tool-call / think-chain translation observer and the settings UI
  * card inside the shared reading-settings page.
  * @param ctx - DSH browser client context.
  */

package/lib/types/client/locales.d.ts

@@ -1,12 +1,59 @@
 /** Locale bundles for the chat-translate card inside the shared 「阅读体验」 page. */
 /** Dictionary namespace owned by this plugin's settings card. */
 export declare const NS = "settings.chatTranslate";
+/**
+ * Chinese copy — the single source of truth for the key set. `{name}` markers
+ * are either template params filled through `t(key, params)` / `.replace()`, or
+ * inline technical samples rendered by `withSamples` at the call site.
+ */
+export declare const zh: {
+    readonly pageNav: "阅读体验";
+    readonly title: "聊天翻译";
+    readonly masterTitle: "翻译总开关";
+    readonly enableTranslation: "启用翻译";
+    readonly masterDesc: "自动将当前会话中工具调用标题（如 {example}）翻译为中文，点击译文可原地切换原文/译文。思考正文默认不翻译，由 AI 卡片里的「显示思考链翻译按钮」控制：打开后每张思考卡右侧出现按钮，点击才翻译。思考卡折叠起来的那一行摘要永不翻译。仅作用于当前查看的会话，回答正文永不翻译。";
+    readonly aiTitle: "AI 翻译（OpenAI 兼容协议）";
+    readonly enableAi: "启用 AI 翻译通道";
+    readonly badgeConfigured: "已配置";
+    readonly badgeUnconfigured: "未配置";
+    readonly aiFallbackNote: "未配置时 AI 通道自动跳过，由 Bing 兜底。";
+    readonly apiKeyTitle: "API Key";
+    readonly apiKeyDesc: "保存至 {home} 的 {ref}，保存后立即生效；留空保存 = 清除";
+    readonly apiKeyPlaceholderConfigured: "已配置（如需更换请直接输入）";
+    readonly save: "保存";
+    readonly saving: "保存中…";
+    readonly keySaved: "已保存到 {home}，立即生效";
+    readonly keyCleared: "已清除 API Key（AI 通道将不可用，Bing 兜底）";
+    readonly saveFailed: "保存失败：{error}";
+    readonly unknownError: "未知错误";
+    readonly baseUrlTitle: "Base URL";
+    readonly baseUrlDesc: "任意 OpenAI 兼容服务端点，如 {url1}、{url2}";
+    readonly modelTitle: "模型";
+    readonly modelDesc: "如 {model1}、{model2}；留空视为未配置";
+    readonly test: "测试 AI 通道";
+    readonly testing: "测试中…";
+    readonly testOk: "连接正常，延迟 {latency}ms";
+    readonly testFail: "失败：{error}";
+    readonly thinkEnableTitle: "显示思考链翻译按钮";
+    readonly thinkEnableDesc: "在每张思考卡的「Think」右侧显示一个按钮，点击才翻译这条思考正文（不会自动翻译）；翻译中按钮转圈，翻好后实心高亮，再点一下整条切回原文（正文里的点击不切换）。代码块与折叠摘要不动，Bing 通道不参与。关闭此开关会撤掉按钮并还原已翻译内容。";
+    readonly thinkTimeoutTitle: "思考链翻译超时";
+    readonly thinkTimeoutDesc: "单位毫秒，范围 500-900000。整块思考可能要几分钟，默认 600000。";
+    readonly bingTitle: "Bing 网页翻译（免 Key 兜底）";
+    readonly enableBing: "启用 Bing 翻译通道";
+    readonly bingDesc: "内置免 Key 翻译通道，无需任何配置，只翻译工具调用标题。AI 未配置或请求失败时自动兜底；思考链翻译永远不走这条通道。AI 与 Bing 同时关闭则工具调用标题也不翻译。";
+    readonly behaviorTitle: "通道行为";
+    readonly behavior1: "AI 开启且已配置 → AI 优先翻译，失败自动降级 Bing";
+    readonly behavior2: "AI 开启但未配置 + Bing 开启 → 由 Bing 翻译";
+    readonly behavior3: "AI 开启但未配置 + Bing 关闭 → 不翻译";
+    readonly behavior4: "AI 关闭 + Bing 开启 → 直接使用 Bing";
+    readonly behavior5: "AI 关闭 + Bing 关闭 → 不翻译";
+    readonly concurrencyTitle: "最大翻译并发数";
+    readonly concurrencyDesc: "控制视口滚动与多工具卡片时的最大并行请求数（范围 1-100，推荐 3）。";
+};
 /** Locale keys this plugin renders. */
-export type ChatTranslateLocaleKey = 'pageNav' | 'title';
-/** English copy. */
+export type ChatTranslateLocaleKey = keyof typeof zh;
+/** English copy; the same key set as {@link zh}. */
 export declare const en: Record<ChatTranslateLocaleKey, string>;
-/** Chinese copy. */
-export declare const zh: Record<ChatTranslateLocaleKey, string>;
 declare module '@deepseek-ai/dsh-client-ui-slots' {
     interface LocaleNamespaceMap {
         'settings.chatTranslate': ChatTranslateLocaleKey;

package/lib/types/client/reading-settings-page.d.ts

@@ -19,7 +19,7 @@
  * mounted but hidden, so a card's local state survives a tab switch.
  *
  * Keep this file identical across the participating plugins
- * (`dsh-smooth-stream`, `dsh-oil-sticky-prompt`, `dsh-chat-translate`).
+ * (`dsh-smooth-stream`, `dsh-chat-translate`).
  * Participants own their own card component, locale dictionaries, settings
  * namespace and Host half — only the page shell below is shared, because
  * cross-plugin value imports are forbidden by the client bundle purity gate.

package/lib/types/client/settings/store.d.ts

@@ -3,10 +3,15 @@ export interface ClientSettingsState {
     concurrency: number;
     aiEnabled: boolean;
     bingEnabled: boolean;
+    thinkEnabled: boolean;
+    thinkTimeoutMs: number;
     baseUrl: string;
     model: string;
     aiConfigured: boolean;
 }
+/** 思考链翻译超时的取值范围，与宿主半边保持一致。 */
+export declare const THINK_TIMEOUT_MIN = 500;
+export declare const THINK_TIMEOUT_MAX = 900000;
 /** Settings namespace + credentials ref, mirroring the host constants. */
 export declare const SETTINGS_NAMESPACE = "dsh-chat-translate";
 export declare const TRANSLATE_API_KEY_REF = "TRANSLATE_API_KEY";
@@ -16,6 +21,14 @@ export declare const TRANSLATE_API_KEY_REF = "TRANSLATE_API_KEY";
  * `credentials` Remote namespace. Keeping them structural keeps this bundle
  * free of host-service imports and lets tests inject fakes.
  */
+export type SettingsPathOpLike = {
+    op: 'set';
+    path: string[];
+    value: unknown;
+} | {
+    op: 'unset';
+    path: string[];
+};
 export interface SettingsScopeLike {
     getSnapshot(): {
         status: string;
@@ -23,8 +36,7 @@ export interface SettingsScopeLike {
         writable: boolean;
     };
     subscribe(listener: () => void): () => void;
-    set(field: string, value: unknown): Promise<unknown>;
-    unset(field: string): Promise<unknown>;
+    mutate(ops: readonly SettingsPathOpLike[]): Promise<unknown>;
 }
 /** Shape of every DSH client Remote call: {ok, value} / {ok, error} wrapper. */
 export type RemoteResult<T> = {
@@ -52,8 +64,9 @@ export interface CredentialsRemoteLike {
  *
  * Since 1.2 there is no localStorage overlay and no custom config HTTP
  * endpoint: the store derives from the bound `settingsScope` (which mirrors
- * the host document and folds every write answer back), and writes go
- * through `scope.set` — serialized, revision-checked, persisted by DSH.
+ * the host document and folds every write answer back), and each debounced
+ * flush commits its touched fields as one `scope.mutate` batch — one
+ * revision fence, serialized and persisted by DSH.
  * Without a bound scope (e.g. non-loopback pages, unit tests) it degrades to
  * an in-memory store with the same semantics DSH itself uses for memory
  * persistence.

package/lib/types/client/settings/ui.d.ts

@@ -1,13 +1,15 @@
 import * as React from 'react';
-import type { PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import type { PropsLocale, PropsRuntime } from '@deepseek-ai/dsh-client-ui-slots';
+import { NS } from '../locales.ts';
 /**
  * Chat-translate's card inside the shared 「阅读体验」 settings page. The card
  * keeps its own chrome (title rows, switches, credential form); the shared page
  * only stacks the participants' cards.
- * @param _props - renderer-bound seat of the `reading.settings.item` slot.
+ * @param props - renderer-bound seat of the `reading.settings.item` slot plus
+ * the `t` seat its `locale: NS` registration injects.
  * @returns The card element.
  */
-export declare function TidySettingsPanel(_props: PropsRuntime<'reading.settings.item'>): React.ReactElement;
+export declare function TidySettingsPanel(props: PropsRuntime<'reading.settings.item'> & PropsLocale<typeof NS>): React.ReactElement;
 /**
  * Bind the settings store to DSH's native settings/credentials services and
  * join the shared 「阅读体验」 settings page: whichever participant activates

package/lib/types/client/translate/api.d.ts

@@ -8,7 +8,20 @@ export interface TranslateBatchOptions {
     signal?: AbortSignal;
     timeoutMs?: number;
 }
+/** 思考正文一个块的翻译结果，与请求的块列表按下标对齐。 */
+export interface ThinkBlockResult {
+    original: string;
+    translated: string;
+    ok: boolean;
+    cached: boolean;
+    channel: string;
+}
 export declare function requestTranslateBatch(texts: string[], options?: TranslateBatchOptions): Promise<TranslateItemResult[]>;
+/**
+ * 请求翻译思考正文的块。宿主侧按输入上限打包、串行发送，客户端超时交给
+ * 宿主（思考块可能要几分钟），这里不设自己的截止时间。
+ */
+export declare function requestTranslateThink(blocks: string[]): Promise<ThinkBlockResult[]>;
 export declare function testServerChannel(channel: string): Promise<{
     ok: boolean;
     latencyMs: number;

package/lib/types/client/translate/client-cache.d.ts

@@ -2,7 +2,9 @@ export declare class ClientCache {
     private memCache;
     private dirty;
     private saveTimer;
-    constructor();
+    private storageKey;
+    private maxEntries;
+    constructor(storageKey?: string, maxEntries?: number);
     private load;
     get(text: string): string | undefined;
     set(text: string, translated: string): void;
@@ -11,4 +13,7 @@ export declare class ClientCache {
     clear(): void;
     size(): number;
 }
+/** 工具标题译文缓存。 */
 export declare const clientCache: ClientCache;
+/** 思考正文译文缓存：独立存储键与容量，不挤占工具标题的缓存。 */
+export declare const thinkClientCache: ClientCache;

package/lib/types/client/translate/mount.d.ts

@@ -11,6 +11,8 @@
 export declare const CLASS_ORIGINAL_HIDDEN = "dsh-tidy-original-hidden";
 export declare const CLASS_ORIGINAL_SHOWN = "dsh-tidy-original-shown";
 export declare const CLASS_TRANSLATED_BLOCK = "dsh-tidy-translated-block";
+/** 混合块里的行内片段容器（我们自建、自拆）。 */
+export declare const CLASS_RUN = "dsh-tidy-run";
 export interface MountOptions {
     originalText?: string;
     interactive?: boolean;
@@ -20,6 +22,26 @@ export declare class NonDestructiveTranslationMount {
      * Mounts a translated string onto the target element non-destructively.
      */
     static mount(element: HTMLElement, translated: string, options?: MountOptions): void;
+    /**
+     * 把一段连续的行内节点包进自建容器后挂载译文。
+     *
+     * 混合块（列表项文字 + 子列表 / 代码块）里的行内片段没有自己的元素，
+     * 只能先包一层再走同一条非侵入式挂载；嵌套的块级子节点留在容器之外，
+     * 排版原样保留。
+     * @returns 自建容器；节点不再相邻或没有共同父节点时返回 null。
+     */
+    static mountRun(nodes: Node[], translated: string, options?: MountOptions): HTMLElement | null;
+    /** 还原行内片段并撤掉自建容器。 */
+    static unmountRun(run: HTMLElement): void;
+    /** 还原一个作用域内我们挂过的全部译文（元素单位与行内片段都算）。 */
+    static restore(scope: ParentNode): void;
+    /** 我们自己的挂载容器与还原容器，观察器必须跳过它们。 */
+    static isOwnNode(element: HTMLElement): boolean;
+    /**
+     * 把一个作用域里的全部挂载译文一起翻面。思考链只由卡片标题右侧的按钮调用
+     * 它，正文里的点击不再改变原文与译文。
+     */
+    static toggleGroup(scope: ParentNode, showOriginal: boolean): void;
     /**
      * Unmounts translation and restores original DOM nodes completely.
      */

package/lib/types/client/translate/observer.d.ts

@@ -3,9 +3,21 @@ export declare class ChatTranslateObserver {
     private rootElement;
     private rootCheckTimer;
     private isEnabled;
+    /** 设置里的思考链开关；与总开关一起决定按钮是否存在。 */
+    private thinkEnabled;
     constructor();
     setEnabled(enabled: boolean): void;
     private restoreOriginals;
+    /**
+     * 设置里的思考链开关：关掉就撤掉所有翻译按钮并还原思考卡里的译文，工具标题
+     * 译文不动。
+     */
+    setThinkEnabled(enabled: boolean): void;
+    /**
+     * AI 通道的可用性（通道开关打开且 Key / Base URL / 模型齐全）。不可用时同样
+     * 不注入按钮：思考链翻译只能走这条通道。
+     */
+    setThinkConfigured(configured: boolean): void;
     /**
      * The active session's scroll container. Only the currently-viewed session
      * is translated; switching sessions replaces this subtree and the observer
@@ -19,6 +31,11 @@ export declare class ChatTranslateObserver {
     private handleMutations;
     private scanContainer;
     private scanNode;
+    /**
+     * 交给思考正文翻译控制器：命中节点所在的卡片，以及它下面（或它就是）的
+     * 全部思考卡片。
+     */
+    private scanThink;
     private processSpan;
     disconnect(): void;
 }

package/lib/types/client/translate/think-button.d.ts

@@ -0,0 +1,19 @@
+/**
+ * 思考卡标题右侧的翻译按钮。
+ *
+ * 三态：idle（描边「译」字，点击开始翻译）、working（圈内圆环旋转，点击忽略）、
+ * translated（实心高亮，点击整条切回原文）。样式只在首次使用注入一次，配色沿用
+ * 内核的 dsw-* 变量；系统开启「减弱动态效果」时圆环不旋转。
+ */
+export type ThinkButtonState = 'idle' | 'working' | 'translated';
+export declare const THINK_BUTTON_CLASS = "dsh-tidy-think-button";
+/** 注入按钮样式，重复调用无副作用。 */
+export declare function ensureThinkButtonStyles(): void;
+export interface ThinkButtonHandle {
+    element: HTMLButtonElement;
+    getState(): ThinkButtonState;
+    setState(state: ThinkButtonState): void;
+    setDisabled(disabled: boolean, reason: string): void;
+}
+/** 创建一个按钮实例；onActivate 由调用方决定点下去做什么。 */
+export declare function createThinkButton(onActivate: () => void): ThinkButtonHandle;

package/lib/types/client/translate/think.d.ts

@@ -0,0 +1,52 @@
+/** 稳定的翻译单位：一块级元素，或一段行内节点。 */
+export interface ThinkUnit {
+    element?: HTMLElement;
+    nodes?: Node[];
+    text: string;
+    anchor: Node;
+}
+/** 收集正文里全部可翻译单位，跳过已挂译文的部分与代码块。 */
+export declare function collectThinkUnits(body: HTMLElement): ThinkUnit[];
+/** 按估算 token 把单位切成若干次客户端请求，顺序不变。 */
+export declare function chunkUnits(units: ThinkUnit[], maxTokens?: number): ThinkUnit[][];
+declare class ThinkTranslateController {
+    /** 总开关与设置里的思考链开关同时打开。 */
+    private enabled;
+    /** AI 通道开关打开且已配置；缺任何一条都不注入按钮。 */
+    private configured;
+    private states;
+    private syncTimers;
+    /** 只处理当前会话的容器；由观察器在会话切换时更新。 */
+    private scope;
+    /** 观察器把当前会话的根交给控制器，插入按钮时只看这一棵子树。 */
+    setScope(scope: ParentNode): void;
+    isEnabled(): boolean;
+    setEnabled(enabled: boolean): void;
+    setConfigured(configured: boolean): void;
+    /** 按钮是否可以存在：两个开关与 AI 通道配置缺一不可。 */
+    private usable;
+    private applyVisibility;
+    /** 扫描当前会话里的全部思考卡（开关、配置或会话变化后调用）。 */
+    syncAll(): void;
+    /** 防抖后同步一张卡片。 */
+    syncCard(card: HTMLElement): void;
+    private stateFor;
+    private runSync;
+    private updateDisabled;
+    private ensureButton;
+    private removeButton;
+    /** 卡片当前显示的是译文（至少有一个译文块可见）。 */
+    private isShowingTranslation;
+    private bodyOf;
+    /** 展开时若整条都命中缓存，直接显示中文，不点按钮也不发请求。 */
+    private showCachedWhenComplete;
+    /** 按钮被点击。 */
+    private activate;
+    /** 翻译这张卡片的全部单位：命中缓存的先挂上，其余按块请求。 */
+    private translateCard;
+    private translateUnits;
+    /** 把译文挂到单位上；期间文本或节点已经变动的单位直接放弃（结果已进缓存）。 */
+    private applyUnit;
+}
+export declare const thinkTranslator: ThinkTranslateController;
+export {};

package/lib/types/index.d.ts

@@ -1,30 +1,23 @@
+import type { HostConnectionHandle } from '@deepseek-ai/dsh-client-connection';
+import { type SettingsMigrationTarget } from './server/config.ts';
 /** Stable Cordis loader name. */
 export declare const name = "dsh-chat-translate";
 /**
- * Hard dependencies: webServer serves the translation proxy; settings and
- * credentials are the DSH-owned config/secret surfaces this plugin now rides
- * on (no standalone config file since 1.2).
+ * Hard dependencies: settings and credentials are the DSH-owned config/secret
+ * surfaces this plugin rides on (no standalone config file since 1.2). The
+ * translation routes register through the connection service when a Web
+ * carrier composes it, so apply takes that service through ctx.inject and the
+ * plugin still loads in compositions without one.
  */
 export declare const inject: string[];
 interface HostContext {
-    webServer?: {
-        register(route: {
-            kind: 'prefix' | 'exact';
-            path: string;
-            handler: (req: any, res: any) => Promise<void> | void;
-        }): () => void;
-    };
-    settings: {
+    connection: HostConnectionHandle;
+    settings: SettingsMigrationTarget & {
         register(ns: string, schema: unknown): {
             get(): any;
             watch(listener: (config: any) => void): () => void;
             update(patch: Record<string, unknown>): Promise<unknown>;
         };
-        describe(): Array<{
-            ns: string;
-            user?: unknown;
-        }>;
-        update(ns: string, patch: Record<string, unknown>): Promise<unknown>;
     };
     credentials: {
         resolve(ref: string): Promise<{
@@ -40,8 +33,8 @@ interface HostContext {
         unset(ref: string): Promise<void>;
     };
     on(event: string, listener: (...args: any[]) => void): () => void;
-    effect(factory: () => void | (() => void), label: string): void;
-    get?(serviceName: string): any;
+    /** Optional-service injection: the callback runs once connection is present. */
+    inject(names: string[], callback: (ctx: HostContext) => void | (() => void)): void;
 }
 /** Mount the host half; provides the translation proxy and rides DSH config. */
 export declare function apply(ctx: HostContext): void;

package/lib/types/server/adapters/base.d.ts

@@ -1 +1 @@
-export type { ITranslationAdapter, PluginConfig } from '../types.ts';
+export type { ITranslationAdapter, PluginConfig, TranslateAdapterOptions, } from '../types.ts';

package/lib/types/server/adapters/openai.d.ts

@@ -1,4 +1,4 @@
-import type { ITranslationAdapter, PluginConfig } from './base.ts';
+import type { ITranslationAdapter, PluginConfig, TranslateAdapterOptions } from './base.ts';
 import type { KeyReader } from '../credentials.ts';
 export declare class OpenAiCompatibleAdapter implements ITranslationAdapter {
     readonly id = "openai";
@@ -6,5 +6,5 @@ export declare class OpenAiCompatibleAdapter implements ITranslationAdapter {
     private credentials;
     constructor(credentials: KeyReader);
     isAvailable(config: PluginConfig): boolean;
-    translate(text: string, signal: AbortSignal, config: PluginConfig): Promise<string>;
+    translate(text: string, signal: AbortSignal, config: PluginConfig, options?: TranslateAdapterOptions): Promise<string>;
 }

package/lib/types/server/cache.d.ts

@@ -6,8 +6,12 @@ export declare class LruDiskCache {
     private dirty;
     /** Legacy root-level cache file (<=1.1); moved under the plugin subdir. */
     private legacyPath;
-    constructor(maxEntries?: number);
+    /** Only the original title cache carries a pre-1.2 root-level predecessor. */
+    private hasLegacyPredecessor;
+    constructor(maxEntries?: number, fileName?: string);
     init(): Promise<void>;
+    /** Load one cache document into memory, dropping poisoned or malformed entries. */
+    private loadFile;
     get(key: string): string | undefined;
     set(key: string, value: string): void;
     private scheduleSave;

package/lib/types/server/config.d.ts

@@ -5,6 +5,15 @@ export declare const MAX_CONCURRENCY = 100;
 /** Bounds for the AI channel request timeout. */
 export declare const AI_TIMEOUT_MIN = 500;
 export declare const AI_TIMEOUT_MAX = 120000;
+/**
+ * Bounds for the think-chain request timeout. A full reasoning block can take
+ * minutes on a local model, so this budget is far larger than the short-text
+ * AI timeout and is bounded separately.
+ */
+export declare const THINK_TIMEOUT_MIN = 500;
+export declare const THINK_TIMEOUT_MAX = 900000;
+/** Entries kept in the think-chain cache pool, separate from the title pool. */
+export declare const THINK_CACHE_ENTRIES = 300;
 /**
  * The settings namespace this plugin owns. The user-editable layer lives in
  * the DSH-managed document (~/.dsh/settings.yaml) under this key; the
@@ -25,6 +34,31 @@ export interface SettingsScopeLike {
     /** Merge a patch into the user layer and persist through the provider. */
     update(patch: Partial<PluginConfig>): Promise<unknown>;
 }
+/**
+ * One path-addressed edit to a settings namespace's user section, matching
+ * DSH's `SettingsPathOp` wire shape.
+ */
+export type SettingsPathOpLike = {
+    op: 'set';
+    path: string[];
+    value: unknown;
+} | {
+    op: 'unset';
+    path: string[];
+};
+/**
+ * Provider-level write face the legacy migration needs: the settings service
+ * itself (not the per-namespace owner scope), whose `mutate` applies path ops
+ * under one revision fence.
+ */
+export interface SettingsMigrationTarget {
+    describe(): Array<{
+        ns: string;
+        user?: unknown;
+        revision?: number;
+    }>;
+    mutate(ns: string, ops: readonly SettingsPathOpLike[], expectedRevision?: number): Promise<unknown>;
+}
 /**
  * Config facade over the DSH `ctx.settings` service. No file I/O lives here
  * anymore: persistence, atomic writes, external-edit hot reload and the
@@ -64,10 +98,4 @@ export declare function sanitizePatch(input: Record<string, unknown>): Partial<P
  * or not a migration happened.
  * @returns whether any legacy values were migrated.
  */
-export declare function migrateLegacyConfigFile(settings: {
-    describe(): Array<{
-        ns: string;
-        user?: unknown;
-    }>;
-    update(ns: string, patch: Record<string, unknown>): Promise<unknown>;
-}, legacyPath: string): Promise<boolean>;
+export declare function migrateLegacyConfigFile(settings: SettingsMigrationTarget, legacyPath: string): Promise<boolean>;

package/lib/types/server/dispatcher.d.ts

@@ -1,10 +1,12 @@
-import type { TranslateItemResult } from './types.ts';
+import type { ThinkBlockResult, TranslateItemResult } from './types.ts';
 import type { ConfigManager } from './config.ts';
-import type { LruDiskCache } from './cache.ts';
+import { LruDiskCache } from './cache.ts';
 import type { KeyReader } from './credentials.ts';
 export declare class TranslationDispatcher {
     private configManager;
     private cache;
+    /** 思考正文译文的独立缓存池，与工具标题的池互不挤占。 */
+    private thinkCache;
     private credentials;
     private masking;
     private adapters;
@@ -12,7 +14,9 @@ export declare class TranslationDispatcher {
     private inFlightMap;
     private activeCount;
     private queue;
-    constructor(configManager: ConfigManager, cache: LruDiskCache, credentials?: KeyReader);
+    /** 思考链请求的串行队列尾，保证同时最多一个在途请求。 */
+    private thinkTail;
+    constructor(configManager: ConfigManager, cache: LruDiskCache, credentials?: KeyReader, thinkCache?: LruDiskCache);
     private registerAdapter;
     /**
      * Decide which channels are active for the current config, in priority order.
@@ -27,6 +31,29 @@ export declare class TranslationDispatcher {
     private computeChannels;
     translateBatch(texts: string[], forceRefresh?: boolean): Promise<TranslateItemResult[]>;
     translateOne(rawText: string, forceRefresh?: boolean): Promise<TranslateItemResult>;
+    /**
+     * 翻译思考正文的块。整条链路与工具标题翻译分离：只走 AI 通道、独立串行
+     * 队列、独立超时、独立缓存池，Bing 从不参与。
+     *
+     * 每个块先按输入上限切成片段，再各自掩码、相邻片段打包成一个请求；整批
+     * 失败时退回逐片段单发，仍失败的片段保留原文。块内任一片段失败即整块不译，
+     * 避免半中半英的段落。
+     */
+    translateThinkBlocks(blocks: string[]): Promise<ThinkBlockResult[]>;
+    /**
+     * 一整批一次请求；失败则该批逐片段单发重试一次，仍失败的片段直接放弃
+     * （保留原文），不在界面上留提示。
+     */
+    private translateThinkBatch;
+    /** 发出一次思考链请求并把结果还原成每个片段的最终译文。 */
+    private requestThinkBatch;
+    /** 串行执行器：同时最多一个在途请求，与工具标题的并发池完全独立。 */
+    private runThinkSerial;
+    /**
+     * 只读判断某通道是否还在熔断冷却期。思考链翻译只借用这个判断避开已经
+     * 出问题的服务，不改动熔断状态本身（那是工具标题通道的记账）。
+     */
+    private isChannelCoolingDown;
     testChannel(channelId: string): Promise<{
         ok: boolean;
         latencyMs: number;