@lynn123411/dsh-chat-translate 2.0.0 → 3.0.1

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

@@ -24,14 +24,20 @@ export declare class TranslationDispatcher {
      * 调用都独立决定成败，不会出现「前一段已挂译文、后一段失败」的半截结果。
      */
     translateReplyBlocks(blocks: string[]): Promise<ReplyBlockResult[]>;
+    /** 熔断授予之后的正文执行段：切块、打包、请求、拼装。 */
+    private serveReplyBlocks;
     /**
      * 一整批一次请求；失败则该批逐片段单发重试一次，仍失败的片段直接放弃
      * （保留原文），不在界面上留提示。失败的片段不进缓存，因此下一次滚回视口
      * 时会自然重试。
      *
      * 熔断记账按「批」算：一次批请求失败记一次，逐片段重试失败再各记一次。
+     * 内容级拒收除外：响应都正常回来了，通道是活的——拒收记一次成功，
+     * 坏内容只作废坏内容自己，不把其他行挡在冷却期外。
      */
     private translateReplyBatch;
+    /** 失败记账的分类：传输故障计数，内容拒收证明通道活着。 */
+    private accountBatch;
     /** 发出一次正文请求并把结果还原成每个片段的最终译文。 */
     private requestReplyBatch;
     /** 串行执行器：同时最多一个在途请求。 */

package/lib/types/server/pipeline/mask-tokens.d.ts

@@ -5,13 +5,11 @@
  * Wire format: `⟦xkbdt3⟧` — U+27E6/U+27E7 (mathematical white square brackets)
  * around `<4-letter random id><index>`.
  *
- * Design constraints, each one a measured failure of an earlier format against
- * real MT engines:
+ * Design constraints, each one a measured failure against real MT engines:
  *
- *  - No letters spelling a pronounceable word and no underscores. The previous
- *    `__DSHMASKxkbdt_3__` format named a token that small models abbreviated
- *    back to its recognizable core: the UI showed bare `DSH` runs instead of
- *    the protected fragments.
+ *  - No letters spelling a pronounceable word and no underscores: engines
+ *    abbreviate tokens with such a shape back to their recognizable core, and
+ *    bare `DSH` runs then show in the UI instead of the protected fragments.
  *  - Random letters keep two mask passes in the same session from colliding and
  *    make the token unambiguous in the translated text.
  *  - `matchMaskToken` accepts exactly what this module emits (plus the same
@@ -41,8 +39,6 @@ export declare const MASK_TOKEN_PATTERN_SOURCE = "\u27E6([a-z]{4})(\\d+)\u27E7";
  * bracket. Used to resolve a token the engine truncated.
  */
 export declare const MASK_TOKEN_PREFIX_PATTERN_SOURCE = "\u27E6\\s*([a-z]{4})(\\d+)";
-/** Regex source for one retired-format token, for text that still contains one. */
-export declare const LEGACY_MASK_TOKEN_PATTERN_SOURCE = "_{1,2}DSH\\s*_*\\s*MASKx?\\s*(?:_?\\s*\\d+|_*([a-z]{2,8})\\s*_+\\s*(\\d+))_{0,2}";
 export interface MaskTokenMatch {
     /** Index into the mask list of the `mask()` call that produced the token. */
     index: number;
@@ -66,17 +62,3 @@ export declare function findMaskTokens(text: string): Array<{
 }>;
 /** True when `text` still carries a token of the current format. */
 export declare function hasMaskResidue(text: string): boolean;
-/** True when `text` carries a token of a retired format. */
-export declare function hasLegacyMaskResidue(text: string): boolean;
-/**
- * Residue test for a value that must never be shown or cached: either a
- * current-format token or any retired-format token.
- */
-export declare function hasAnyMaskResidue(text: string): boolean;
-/**
- * Retired-format tokens inside source text, so `mask()` can protect them with a
- * current-format token of their own. A source that talks about the old
- * placeholder format must survive translation, and the unmask step rejects any
- * retired-format token it sees.
- */
-export declare function findLegacyMaskTokens(text: string): string[];

package/lib/types/server/pipeline/masking.d.ts

@@ -7,11 +7,6 @@ export interface MaskResult {
      * must discard that translation instead of showing a repaired guess.
      */
     unmask: (translatedText: string) => string;
-    /**
-     * Retired-format tokens the source itself contained. They come back on
-     * purpose and are content, so the caller's leak check must not flag them.
-     */
-    legacyFragments: string[];
 }
 /** Which spaces `mask()` inserted directly before and after a token. */
 export interface InsertedSpacing {
@@ -36,15 +31,15 @@ export declare class ContentMaskingPipeline {
  * spacing the translation produced around the fragment survives untouched.
  *
  * @throws MaskRestoreError when the text does not carry every token exactly
- *   once, or still shows a current-format token or a retired token that the
- *   source did not already contain — the caller discards such a translation
- *   instead of rendering a repaired guess.
+ *   once, or still shows a token of some other pass or a damaged one — the
+ *   caller discards such a translation instead of rendering a repaired guess.
  */
-export declare function replaceMaskTokens(text: string, id: string, masks: string[], inserted?: InsertedSpacing[], legacyIndexes?: ReadonlySet<number>): string;
+export declare function replaceMaskTokens(text: string, id: string, masks: string[], inserted?: InsertedSpacing[]): string;
 /**
- * True when a translated string still shows a mask token to the user.
- * Callers use it to discard a poisoned translation (and to evict poisoned
- * cache entries written by earlier releases).
+ * True when a translated string still shows a mask token to the user. Callers
+ * use it to discard a poisoned translation, to keep it out of the caches, and
+ * to drop poisoned entries when a cache document is loaded (the file on disk
+ * outlives the process and may carry anything).
  */
 export declare function isMaskLeak(translatedText: string): boolean;
 export { hasMaskResidue };

package/lib/types/server/prompt-revision.d.ts

@@ -0,0 +1,14 @@
+/**
+ * The single registration of the translation prompt's semantic revision.
+ *
+ * The reply cache stores results keyed by source text; a cache document
+ * written under a different prompt semantics would replay stale translations
+ * into a new policy (the exact poisoning that makes "already-Chinese blocks
+ * look untranslated" persist for a TTL after a prompt change). The document
+ * therefore carries this revision, and a load whose revision differs starts
+ * from an empty pool.
+ *
+ * Bump it — and only here — whenever the prompt below `buildSystemPrompt`
+ * changes what the model is asked to do. Copy-only edits may ride.
+ */
+export declare const PROMPT_REVISION = "r1";

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

@@ -4,8 +4,8 @@ import type { TranslationDispatcher } from './dispatcher.ts';
  * Translation proxy surface, carried by Connection's exact Fetch routes below
  * the shared `/api` channel.
  *
- * Config and credentials have no HTTP endpoints: since 1.2 the settings panel
- * reads and writes through DSH's own channels — the shared configuration form
+ * Config and credentials have no HTTP endpoints: the settings panel reads and
+ * writes through DSH's own channels — the shared configuration form
  * (`ctx.configForms`) over the profile entry, and the `credentials` Remote API
  * for the key — so the plugin owns exactly two routes: reply-body block
  * translation, and the channel probe.

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

@@ -3,7 +3,6 @@ export interface PluginConfig {
     aiTimeoutMs: number;
     baseUrl: string;
     model: string;
-    targetLang: string;
 }
 export interface TranslateItemResult {
     original: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lynn123411/dsh-chat-translate",
-  "version": "2.0.0",
+  "version": "3.0.1",
   "description": "Assistant reply-body translation for the DeepSeek Harness Web UI (OpenAI-compatible channel)",
   "license": "MIT",
   "author": "lynn123411",
@@ -61,22 +61,22 @@
   "scripts": {
     "build": "node build.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
-    "test": "node scripts/test-client-wiring.mjs && node scripts/test-regression-suite.mjs && node scripts/test-channel-logic.mjs && node scripts/test-store.mjs && node scripts/test-toggle-restore.mjs && node scripts/test-reply-pipeline.mjs && node scripts/test-reply-client.mjs",
+    "test": "node scripts/test-client-wiring.mjs && node scripts/test-chat-translate.mjs && node scripts/test-regression-suite.mjs && node scripts/test-channel-logic.mjs && node scripts/test-store.mjs && node scripts/test-reply-pipeline.mjs",
     "assert:lib-untracked": "node scripts/assert-lib-untracked.mjs",
     "check": "pnpm typecheck && pnpm build && pnpm test && pnpm assert:lib-untracked"
   },
   "engines": {
     "node": "^22.19 || >=24",
-    "dsh": "0.1.7-rc.2"
+    "dsh": ">=0.1.7-rc.2"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.4",
-    "@deepseek-ai/dsh-client-connection": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-renderer": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-settings": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-home-paths": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-connection": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-renderer": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-settings": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-home-paths": ">=0.1.7-rc.2",
     "@deepseek-ai/schemastery": "^3.18.4",
     "@eslint/js": "^9.30.0",
     "@types/node": "^22.19.0",
@@ -86,8 +86,8 @@
     "typescript": "^6.0.0"
   },
   "peerDependencies": {
-    "@deepseek-ai/dsh-client-ui-primitives": "0.1.7-rc.2",
-    "@deepseek-ai/dsh-home-paths": "0.1.7-rc.2"
+    "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.7-rc.2",
+    "@deepseek-ai/dsh-home-paths": ">=0.1.7-rc.2"
   },
   "peerDependenciesMeta": {
     "@deepseek-ai/dsh-client-ui-primitives": {

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

@@ -1,17 +0,0 @@
-export declare class ClientCache {
-    private memCache;
-    private dirty;
-    private saveTimer;
-    private storageKey;
-    private maxEntries;
-    constructor(storageKey?: string, maxEntries?: number);
-    private load;
-    get(text: string): string | undefined;
-    set(text: string, translated: string): void;
-    private scheduleSave;
-    flushSync(): void;
-    clear(): void;
-    size(): number;
-}
-/** 正文译文缓存：本插件唯一的客户端缓存池。 */
-export declare const clientCache: ClientCache;

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

@@ -1,16 +0,0 @@
-declare class LazyTranslationQueue {
-    private enabled;
-    private observer;
-    private pending;
-    setEnabled(enabled: boolean): void;
-    observe(body: HTMLElement, immediate?: boolean): void;
-    private intersectionObserver;
-    /**
-     * 进入视口后稍等一拍再翻，避开「刚出现、还在布局」的那一瞬。已经在等的那条
-     * 不重复排队。
-     */
-    private scheduleTranslation;
-    disconnect(): void;
-}
-export declare const lazyQueue: LazyTranslationQueue;
-export {};

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

@@ -1,57 +0,0 @@
-/**
- * Non-destructive translation DOM mount mechanism.
- *
- * Preserves the original React Fiber tree, event listeners, and nested DOM nodes
- * by wrapping them in a hidden container (<span class="dsh-tidy-original-hidden">)
- * rather than destroying them with `element.textContent = translated`.
- *
- * Displays the translated text in a companion container (<span class="dsh-tidy-translated-block">).
- * Clicking the translation switches that one block back to its original, and
- * clicking the original switches it back to the translation.
- */
-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;
-}
-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;
-    /**
-     * Unmounts translation and restores original DOM nodes completely.
-     */
-    static unmount(element: HTMLElement): void;
-    /**
-     * Checks if an element has non-destructive translation mounted.
-     */
-    static isMounted(element: HTMLElement): boolean;
-    /**
-     * Gets the original text recorded on the element or contained in origWrapper.
-     */
-    static getOriginal(element: HTMLElement): string | undefined;
-    /**
-     * Extracts text content excluding our own translation wrappers.
-     */
-    static extractVisibleText(element: HTMLElement): string;
-}

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

@@ -1,52 +0,0 @@
-export declare class ChatTranslateObserver {
-    private observer;
-    private rootElement;
-    private rootCheckTimer;
-    private isEnabled;
-    /**
-     * 已经交给翻译器的正文容器，避免同一条回答在每次 DOM 变动时重扫。总开关重开
-     * 时清空：关着的那段时间落定的回答需要补翻。
-     */
-    private handled;
-    constructor();
-    setEnabled(enabled: boolean): void;
-    private restoreOriginals;
-    /**
-     * The active session's scroll container. Only the currently-viewed session
-     * is translated; switching sessions replaces this subtree and the observer
-     * naturally follows the new content.
-     */
-    private isVisible;
-    private findRoot;
-    start(documentRef?: Document): () => void;
-    private scheduleRootCheck;
-    private restart;
-    private handleMutations;
-    /**
-     * 扫一棵子树，把里面**全部**该翻的正文容器交给翻译器。
-     *
-     * 不再「命中第一个就返回」：一个容器里可以有好几行 response（折叠块里每一步
-     * 露出的一段正文就是一行），只取第一个会把后面那些整片漏掉。
-     */
-    private scanContainer;
-    /** 扫一个刚变动过的节点（含它所在的这一行，以及它内部的每一行）。 */
-    private scanNode;
-    /** 一行 flow item 里的**每一个**正文容器；工具行、Think 卡会被排除规则挡掉。 */
-    private tryRow;
-    /** 判定并交给翻译器：这个元素自己或它内部的每一条落定正文容器。 */
-    private tryBodies;
-    /** 判定并交给翻译器：这一个元素自己是不是一条该翻的正文容器。 */
-    private tryBody;
-    /**
-     * 这个元素自己是不是一条该翻的正文容器：落定的、落在过程折叠块里的 markdown
-     * 正文，且不被排除规则挡住（Think 卡、工具行、最终汇总都不算）。
-     */
-    private isTranslatableBody;
-    /**
-     * 把一条落定的正文交给视口懒队列：视口内立刻翻、视口外的等滚到再翻，
-     * 命中缓存的由翻译器立即挂上。同一条回答只登记一次。
-     */
-    private requestTranslate;
-    disconnect(): void;
-}
-export declare const chatTranslateObserver: ChatTranslateObserver;

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

@@ -1,38 +0,0 @@
-/** 稳定的翻译单位：一块级元素，或一段行内节点。 */
-export interface ReplyUnit {
-    element?: HTMLElement;
-    nodes?: Node[];
-    text: string;
-    anchor: Node;
-}
-/** 该单位是否需要翻译：含拉丁字母才送，纯中文块原样留着。 */
-export declare function needsTranslation(text: string): boolean;
-/** 收集正文里全部可翻译单位，跳过已挂译文的部分、代码块与纯中文块。 */
-export declare function collectReplyUnits(body: HTMLElement): ReplyUnit[];
-/** 按估算 token 把单位切成若干次客户端请求，顺序不变。 */
-export declare function chunkUnits(units: ReplyUnit[], maxTokens?: number): ReplyUnit[][];
-/**
- * 一条回答正文的翻译控制器。观察器把落定的正文容器交给 {@link translateBody}；
- * 同一条回答的在途翻译只跑一次。
- */
-declare class ReplyTranslateController {
-    /** 正文容器 → 在途 Promise，避免同一条回答被重复翻译。 */
-    private inFlight;
-    /**
-     * 翻译一条回答的正文容器。已命中缓存的单位立即挂上，其余按块请求；
-     * 失败的块保留原文（结果不入缓存，下次滚回视口会自然重试）。
-     * @param body - 正文容器（markdown body）。
-     * @returns 本次翻译完成后结算（已在途则返回同一次在途）。
-     */
-    translateBody(body: HTMLElement): Promise<void>;
-    private run;
-    /**
-     * 逐块请求并挂载。失败的块保持原文：界面上不留提示，控制台留一条警告，结果
-     * 不进缓存，因此这一块在下次进入视口时会自然重试。
-     */
-    private translateUnits;
-    /** 把译文挂到单位上；期间文本或节点已经变动的单位直接放弃（结果已进缓存）。 */
-    private applyUnit;
-}
-export declare const replyTranslator: ReplyTranslateController;
-export {};