@lynn123411/dsh-chat-translate 1.1.0 → 1.2.1

package/README.md

@@ -5,12 +5,13 @@ DeepSeek Harness Web 界面的工具调用与思考摘要智能翻译插件。
 ## 特性
 
 - **工具调用与思考摘要自动翻译**：仅在渲染层将工具调用动作描述（如 `Locate DSH home directory structure`）与思考折叠摘要自动翻译为中文，对话正文永不翻译，保持思考正文原生不干扰。
-- **AI 翻译通道（OpenAI 兼容协议）**：对接任意 OpenAI 兼容的 `chat/completions` 服务（OpenAI、DeepSeek、通义、Ollama 等），Base URL 与模型可在设置面板配置；API Key 从 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY` 读取，填写后立即生效。
+- **AI 翻译通道（OpenAI 兼容协议）**：对接任意 OpenAI 兼容的 `chat/completions` 服务（OpenAI、DeepSeek、通义、Ollama 等），Base URL 与模型可在设置面板配置；API Key 经 DSH 凭据服务读写 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，填写后立即生效。
 - **Bing 免 Key 兜底通道**：内置微软 Bing 网页翻译（免 Key、国内直连），AI 未配置或请求失败时自动兜底；双通道均有独立开关，同时关闭则不翻译。
 - **非侵入式 DOM 挂载与双语对照**：非侵入式包装保留原始 DOM 节点与 React Fiber 事件系统；点击译文可原地在原文与中文之间切换。
 - **智能内容脱敏与占位符保护**：翻译前对多行代码块、内联代码、URL 链接、文件路径及 CLI 命令行参数进行占位符脱敏与鲁棒还原，杜绝代码与路径被误翻译。
 - **当前会话作用域**：仅翻译当前查看的会话，切换会话自动跟随新内容；视口懒加载（150px 缓冲）与文档顺序排队，译文按阅读顺序出现。
-- **智能调度与熔断保护**：1–100 动态并发限流队列、AI 30s / Bing 2s 超时、连续失败熔断自愈、在途请求合并去重、7 天 LRU 双级缓存（Client `localStorage` + Host 磁盘持久化）。
+- **智能调度与熔断保护**：1–100 动态并发限流队列、AI 30s / Bing 2s 超时、连续失败熔断自愈、在途请求合并去重、7 天 LRU 磁盘持久化缓存（`~/.dsh/dsh-chat-translate/cache.json`）。
+- **DSH 原生配置接入**：配置走 DSH `settings` 服务（用户层写入 `~/.dsh/settings.yaml` 的 `dsh-chat-translate` 段）、密钥走 DSH `credentials` 服务、设置面板经 `settingsScope` 与 `credentials` Remote API 读写——无任何自研配置文件。
 - **设置面板集成**：在「设置 - 聊天翻译」中提供总开关、AI/Bing 通道开关、Base URL 与模型配置、通道测试与并发数调节。
 
 ## 安装
@@ -21,7 +22,7 @@ dsh plugin --profile web add @lynn123411/dsh-chat-translate
 
 ## 配置
 
-1. **API Key**：打开「设置 - 聊天翻译」，在 AI 翻译卡片中直接填写 API Key 并保存（写入 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，权限 0600，保存后立即生效；留空保存 = 清除该键）。也可以手动编辑该文件：
+1. **API Key**：打开「设置 - 聊天翻译」，在 AI 翻译卡片中直接填写 API Key 并保存（经 DSH 凭据服务写入 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，权限 0600，保存后立即生效；留空保存 = 清除该键）。也可以手动编辑该文件：
 
    ```yaml
    refs:
@@ -30,6 +31,19 @@ dsh plugin --profile web add @lynn123411/dsh-chat-translate
 
    > ⚠️ **注意**：DSH 的凭据加载器要求 refs 键值非空。手动编辑时要么填写真实 Key，要么**直接删除该行**——不要写成 `TRANSLATE_API_KEY: ""` 这类空值，否则 DSH 启动会失败。未配置时插件自动由 Bing 通道兜底，不会报错。
 
-2. **Base URL 与模型**：在「设置 - 聊天翻译」中填写 Base URL（如 `https://api.openai.com/v1` 或 `https://api.deepseek.com/v1`）与模型名（如 `gpt-4o-mini`、`deepseek-chat`），点击「测试 AI 通道」验证。
+2. **Base URL 与模型等设置**：在「设置 - 聊天翻译」中填写 Base URL（如 `https://api.openai.com/v1` 或 `https://api.deepseek.com/v1`）与模型名（如 `gpt-4o-mini`、`deepseek-chat`），点击「测试 AI 通道」验证。所有设置（开关、并发数、超时等）由 DSH 持久化到 `~/.dsh/settings.yaml` 的 `dsh-chat-translate` 段，可直接编辑该文件（DSH 会热同步）：
+
+   ```yaml
+   dsh-chat-translate:
+     enabled: true
+     concurrency: 3
+     aiEnabled: true
+     bingEnabled: true
+     baseUrl: http://172.24.52.126:8081/v1
+     model: hy-mt2-1.8b
+     targetLang: zh-Hans
+   ```
+
+   > 从 1.2 起，插件不再读写独立的 `~/.dsh/dsh-chat-translate-config.json`：升级后首次加载会自动把旧文件的值迁移进上面的 settings 段并删除旧文件（若你已在 UI 中改过设置，则以你的设置为准）。
 
 3. **通道行为**：AI 开启且已配置 → AI 优先、失败降级 Bing；AI 开启但未配置 + Bing 开启 → Bing 翻译；AI 未配置 + Bing 关闭 → 不翻译；AI 关闭 + Bing 开启 → 直接 Bing；双关 → 不翻译。

package/dsh.plugin.json

@@ -1,6 +1,6 @@
 {
   "id": "dsh-chat-translate",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "main": "lib/index.js",
   "description": "Tool-call & think-summary translation with dual AI (OpenAI-compatible) + Bing channels for the DeepSeek Harness Web UI.",
   "engines": {

package/lib/client.js

@@ -174,30 +174,6 @@ async function requestTranslateBatch(texts, options = {}) {
     cached: false
   }));
 }
-async function fetchServerConfig() {
-  try {
-    const res = await fetch("/api/dsh-chat-translate/config");
-    if (!res.ok) return null;
-    const json = await res.json();
-    return json.config;
-  } catch {
-    return null;
-  }
-}
-async function updateServerConfig(updates) {
-  try {
-    const res = await fetch("/api/dsh-chat-translate/config", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify(updates)
-    });
-    if (!res.ok) return null;
-    const json = await res.json();
-    return json.config;
-  } catch {
-    return null;
-  }
-}
 async function testServerChannel(channel) {
   try {
     const res = await fetch("/api/dsh-chat-translate/test-channel", {
@@ -210,18 +186,6 @@ async function testServerChannel(channel) {
     return { ok: false, latencyMs: 0, error: err?.message || String(err) };
   }
 }
-async function saveCredentials(apiKey) {
-  try {
-    const res = await fetch("/api/dsh-chat-translate/credentials", {
-      method: "POST",
-      headers: { "Content-Type": "application/json" },
-      body: JSON.stringify({ apiKey })
-    });
-    return await res.json();
-  } catch (err) {
-    return { ok: false, error: err?.message || String(err) };
-  }
-}
 
 // src/client/translate/mount.ts
 var CLASS_ORIGINAL_HIDDEN = "dsh-tidy-original-hidden";
@@ -745,13 +709,8 @@ var chatTranslateObserver = new ChatTranslateObserver();
 var import_react = require("react");
 
 // src/client/settings/store.ts
-var LS_PREFIX = "dsh-chat-translate:";
-var LS_ENABLED = `${LS_PREFIX}enabled`;
-var LS_CONCURRENCY = `${LS_PREFIX}concurrency`;
-var LS_AI_ENABLED = `${LS_PREFIX}aiEnabled`;
-var LS_BING_ENABLED = `${LS_PREFIX}bingEnabled`;
-var LS_BASE_URL = `${LS_PREFIX}baseUrl`;
-var LS_MODEL = `${LS_PREFIX}model`;
+var SETTINGS_NAMESPACE = "dsh-chat-translate";
+var TRANSLATE_API_KEY_REF = "TRANSLATE_API_KEY";
 var DEFAULT_STATE = {
   enabled: true,
   concurrency: 3,
@@ -764,115 +723,28 @@ var DEFAULT_STATE = {
 var SettingsStore = class {
   state = { ...DEFAULT_STATE };
   listeners = /* @__PURE__ */ new Set();
-  storageListener = null;
-  pushTimer = null;
-  pushSeq = 0;
-  userTouched = false;
-  constructor() {
-    this.loadFromLocalStorage();
-    this.initStorageListener();
-    this.syncFromServer();
-  }
-  loadFromLocalStorage() {
-    if (typeof localStorage === "undefined") return;
-    try {
-      const enabledRaw = localStorage.getItem(LS_ENABLED);
-      if (enabledRaw !== null) {
-        this.state.enabled = enabledRaw === "true";
-      }
-      const concurrencyRaw = localStorage.getItem(LS_CONCURRENCY);
-      if (concurrencyRaw !== null) {
-        const c = parseInt(concurrencyRaw, 10);
-        if (Number.isFinite(c) && c >= 1 && c <= 100) {
-          this.state.concurrency = c;
-        }
-      }
-      const aiRaw = localStorage.getItem(LS_AI_ENABLED);
-      if (aiRaw !== null) {
-        this.state.aiEnabled = aiRaw === "true";
-      }
-      const bingRaw = localStorage.getItem(LS_BING_ENABLED);
-      if (bingRaw !== null) {
-        this.state.bingEnabled = bingRaw === "true";
-      }
-      const baseUrlRaw = localStorage.getItem(LS_BASE_URL);
-      if (baseUrlRaw !== null) {
-        this.state.baseUrl = baseUrlRaw;
-      }
-      const modelRaw = localStorage.getItem(LS_MODEL);
-      if (modelRaw !== null) {
-        this.state.model = modelRaw;
-      }
-    } catch {
-    }
-    try {
-      chatTranslateObserver.setEnabled(this.state.enabled);
-    } catch {
+  scope = null;
+  credentials = null;
+  unsubscribeScope = null;
+  keyConfigured = false;
+  writeTimer = null;
+  pendingFields = /* @__PURE__ */ new Set();
+  /**
+   * Bind the DSH services. Called once from the settings UI setup; re-binding
+   * (e.g. after a reconnect) detaches the previous subscription first.
+   */
+  attach(scope, credentials) {
+    if (this.unsubscribeScope) {
+      this.unsubscribeScope();
+      this.unsubscribeScope = null;
     }
-  }
-  initStorageListener() {
-    if (typeof window === "undefined" || typeof window.addEventListener !== "function") return;
-    this.storageListener = (e) => {
-      if (!e.key || !e.key.startsWith(LS_PREFIX)) return;
-      let changed = false;
-      if (e.key === LS_ENABLED && e.newValue !== null) {
-        const val = e.newValue === "true";
-        if (this.state.enabled !== val) {
-          this.state.enabled = val;
-          chatTranslateObserver.setEnabled(val);
-          changed = true;
-        }
-      } else if (e.key === LS_CONCURRENCY && e.newValue !== null) {
-        const c = parseInt(e.newValue, 10);
-        if (Number.isFinite(c) && c >= 1 && c <= 100 && this.state.concurrency !== c) {
-          this.state.concurrency = c;
-          changed = true;
-        }
-      } else if (e.key === LS_AI_ENABLED && e.newValue !== null) {
-        const val = e.newValue === "true";
-        if (this.state.aiEnabled !== val) {
-          this.state.aiEnabled = val;
-          changed = true;
-        }
-      } else if (e.key === LS_BING_ENABLED && e.newValue !== null) {
-        const val = e.newValue === "true";
-        if (this.state.bingEnabled !== val) {
-          this.state.bingEnabled = val;
-          changed = true;
-        }
-      } else if (e.key === LS_BASE_URL && e.newValue !== null && this.state.baseUrl !== e.newValue) {
-        this.state.baseUrl = e.newValue;
-        changed = true;
-      } else if (e.key === LS_MODEL && e.newValue !== null && this.state.model !== e.newValue) {
-        this.state.model = e.newValue;
-        changed = true;
-      }
-      if (changed) {
-        this.notify();
-        this.schedulePush();
-      }
-    };
-    window.addEventListener("storage", this.storageListener);
-  }
-  async syncFromServer() {
-    try {
-      const config = await fetchServerConfig();
-      if (config) {
-        const touched = this.userTouched;
-        this.state = {
-          enabled: !touched && typeof config.enabled === "boolean" ? config.enabled : this.state.enabled,
-          concurrency: !touched && typeof config.concurrency === "number" && Number.isFinite(config.concurrency) ? config.concurrency : this.state.concurrency,
-          aiEnabled: !touched && typeof config.aiEnabled === "boolean" ? config.aiEnabled : this.state.aiEnabled,
-          bingEnabled: !touched && typeof config.bingEnabled === "boolean" ? config.bingEnabled : this.state.bingEnabled,
-          baseUrl: !touched && typeof config.baseUrl === "string" ? config.baseUrl : this.state.baseUrl,
-          model: !touched && typeof config.model === "string" ? config.model : this.state.model,
-          aiConfigured: typeof config.aiConfigured === "boolean" ? config.aiConfigured : this.state.aiConfigured
-        };
-        chatTranslateObserver.setEnabled(this.state.enabled);
-        this.notify();
-      }
-    } catch {
+    this.scope = scope;
+    this.credentials = credentials;
+    if (scope) {
+      this.unsubscribeScope = scope.subscribe(() => this.derive());
+      this.derive();
     }
+    void this.refreshKeyStatus();
   }
   getState() {
     return { ...this.state };
@@ -883,130 +755,139 @@ var SettingsStore = class {
       this.listeners.delete(listener);
     };
   }
-  notify() {
-    this.listeners.forEach((l) => {
+  /** Map the resolved namespace value into client state and notify. */
+  derive() {
+    if (!this.scope) return;
+    const snap = this.scope.getSnapshot();
+    const value = snap.value;
+    if (!value || typeof value !== "object") return;
+    const next = { ...this.state };
+    if (typeof value.enabled === "boolean") next.enabled = value.enabled;
+    const c = value.concurrency;
+    if (typeof c === "number" && Number.isFinite(c)) {
+      next.concurrency = Math.min(Math.max(Math.round(c), 1), 100);
+    }
+    if (typeof value.aiEnabled === "boolean") next.aiEnabled = value.aiEnabled;
+    if (typeof value.bingEnabled === "boolean") next.bingEnabled = value.bingEnabled;
+    if (typeof value.baseUrl === "string") next.baseUrl = value.baseUrl;
+    if (typeof value.model === "string") next.model = value.model;
+    this.applyState(next);
+  }
+  applyState(next) {
+    next.aiConfigured = Boolean(next.baseUrl && next.model && this.keyConfigured);
+    const enabledChanged = next.enabled !== this.state.enabled;
+    this.state = next;
+    if (enabledChanged) {
       try {
-        l();
+        chatTranslateObserver.setEnabled(this.state.enabled);
       } catch {
       }
-    });
+    }
+    this.notify();
   }
-  /**
-   * Debounced server push: fast typing in the baseUrl/model/concurrency inputs
-   * collapses into a single POST (300ms trailing). A monotonic sequence number
-   * ensures an out-of-order older response never overwrites newer state.
-   */
-  schedulePush() {
-    if (this.pushTimer !== null || typeof window === "undefined") return;
-    this.pushTimer = window.setTimeout(() => {
-      this.pushTimer = null;
-      this.pushToServer();
-    }, 300);
+  notify() {
+    for (const listener of this.listeners) {
+      try {
+        listener();
+      } catch {
+      }
+    }
   }
-  async pushToServer() {
-    const seq = ++this.pushSeq;
-    const sent = {
-      enabled: this.state.enabled,
-      concurrency: this.state.concurrency,
-      aiEnabled: this.state.aiEnabled,
-      bingEnabled: this.state.bingEnabled,
-      baseUrl: this.state.baseUrl,
-      model: this.state.model
-    };
+  /** Pull the key's status-only view and re-derive aiConfigured. */
+  async refreshKeyStatus() {
+    if (!this.credentials) return;
     try {
-      const updated = await updateServerConfig(sent);
-      if (!updated || seq !== this.pushSeq) return;
-      this.state = {
-        ...this.state,
-        enabled: this.state.enabled === sent.enabled && typeof updated.enabled === "boolean" ? updated.enabled : this.state.enabled,
-        concurrency: this.state.concurrency === sent.concurrency && typeof updated.concurrency === "number" ? updated.concurrency : this.state.concurrency,
-        aiEnabled: this.state.aiEnabled === sent.aiEnabled && typeof updated.aiEnabled === "boolean" ? updated.aiEnabled : this.state.aiEnabled,
-        bingEnabled: this.state.bingEnabled === sent.bingEnabled && typeof updated.bingEnabled === "boolean" ? updated.bingEnabled : this.state.bingEnabled,
-        baseUrl: this.state.baseUrl === sent.baseUrl && typeof updated.baseUrl === "string" ? updated.baseUrl : this.state.baseUrl,
-        model: this.state.model === sent.model && typeof updated.model === "string" ? updated.model : this.state.model,
-        aiConfigured: typeof updated.aiConfigured === "boolean" ? updated.aiConfigured : this.state.aiConfigured
-      };
-      this.notify();
+      const res = await this.credentials.describe([TRANSLATE_API_KEY_REF]);
+      if (!res.ok) return;
+      const info = res.value[TRANSLATE_API_KEY_REF];
+      const configured = Boolean(info?.configured);
+      if (configured !== this.keyConfigured) {
+        this.keyConfigured = configured;
+        this.applyState({ ...this.state });
+      }
     } catch {
     }
   }
+  /**
+   * Optimistically apply locally, then persist each touched field through the
+   * settings scope. Writes are trailing-debounced (300ms) so typing in the
+   * baseUrl/model inputs collapses into a single queued mutation instead of
+   * one write per keystroke — which would otherwise flash stale mirror values
+   * back into the inputs between commits. A failed write makes the scope
+   * reload its mirror, which re-derives this store from the host document
+   * (conflict-safe recovery).
+   */
   async update(partial) {
-    this.userTouched = true;
     let sanitizedConcurrency = this.state.concurrency;
-    if (typeof partial.concurrency === "number") {
-      if (Number.isFinite(partial.concurrency)) {
-        sanitizedConcurrency = Math.min(Math.max(Math.round(partial.concurrency), 1), 100);
-      }
+    if (typeof partial.concurrency === "number" && Number.isFinite(partial.concurrency)) {
+      sanitizedConcurrency = Math.min(Math.max(Math.round(partial.concurrency), 1), 100);
     }
-    this.state = {
+    const next = {
       ...this.state,
       ...partial,
       concurrency: sanitizedConcurrency
     };
-    if (typeof partial.enabled === "boolean") {
-      try {
-        localStorage.setItem(LS_ENABLED, String(partial.enabled));
-      } catch {
-      }
-      chatTranslateObserver.setEnabled(partial.enabled);
-    }
-    if (typeof partial.concurrency === "number" && Number.isFinite(partial.concurrency)) {
-      try {
-        localStorage.setItem(LS_CONCURRENCY, String(sanitizedConcurrency));
-      } catch {
-      }
-    }
-    if (typeof partial.aiEnabled === "boolean") {
-      try {
-        localStorage.setItem(LS_AI_ENABLED, String(partial.aiEnabled));
-      } catch {
-      }
-    }
-    if (typeof partial.bingEnabled === "boolean") {
-      try {
-        localStorage.setItem(LS_BING_ENABLED, String(partial.bingEnabled));
-      } catch {
-      }
-    }
-    if (typeof partial.baseUrl === "string") {
-      try {
-        localStorage.setItem(LS_BASE_URL, partial.baseUrl);
-      } catch {
+    this.applyState(next);
+    if (this.scope) {
+      const fields = ["enabled", "concurrency", "aiEnabled", "bingEnabled", "baseUrl", "model"];
+      for (const field of fields) {
+        if (partial[field] !== void 0) {
+          this.pendingFields.add(field);
+        }
       }
+      this.scheduleWrite();
     }
-    if (typeof partial.model === "string") {
-      try {
-        localStorage.setItem(LS_MODEL, partial.model);
-      } catch {
-      }
+  }
+  scheduleWrite() {
+    if (this.writeTimer !== null || typeof window === "undefined") return;
+    this.writeTimer = window.setTimeout(() => {
+      this.writeTimer = null;
+      void this.flushWrite();
+    }, 300);
+  }
+  async flushWrite() {
+    if (!this.scope) return;
+    const fields = [...this.pendingFields];
+    this.pendingFields.clear();
+    const writes = [];
+    for (const field of fields) {
+      writes.push(this.scope.set(field, this.state[field]));
     }
-    this.notify();
-    this.schedulePush();
+    await Promise.all(writes).catch(() => {
+    });
   }
   async testChannel(channel) {
     return testServerChannel(channel);
   }
-  /** Persist the API key via the host and refresh the server-derived status. */
+  /** Write (or clear) the API key through the credentials Remote API. */
   async saveApiKey(apiKey) {
-    const res = await saveCredentials(apiKey);
-    if (res.ok) {
-      await this.syncFromServer();
+    if (!this.credentials) {
+      return { ok: false, error: "\u51ED\u636E\u670D\u52A1\u4E0D\u53EF\u7528\uFF08\u975E\u56DE\u73AF\u9875\u9762\uFF09" };
+    }
+    try {
+      const key = apiKey.trim();
+      const res = key ? await this.credentials.set(TRANSLATE_API_KEY_REF, key) : await this.credentials.unset(TRANSLATE_API_KEY_REF);
+      if (!res.ok) {
+        return { ok: false, error: res.error?.message || "\u4FDD\u5B58\u5931\u8D25" };
+      }
+      await this.refreshKeyStatus();
+      return { ok: true };
+    } catch (err) {
+      return { ok: false, error: err?.message || String(err) };
     }
-    return { ok: Boolean(res.ok), error: res.error };
-  }
-  /** Re-pull the server config (e.g. after the API key changed). */
-  async refreshFromServer() {
-    await this.syncFromServer();
   }
   dispose() {
-    if (this.pushTimer !== null && typeof window !== "undefined") {
-      clearTimeout(this.pushTimer);
-      this.pushTimer = null;
+    if (this.writeTimer !== null && typeof window !== "undefined") {
+      clearTimeout(this.writeTimer);
+      this.writeTimer = null;
     }
-    if (this.storageListener && typeof window !== "undefined") {
-      window.removeEventListener("storage", this.storageListener);
-      this.storageListener = null;
+    this.pendingFields.clear();
+    if (this.unsubscribeScope) {
+      this.unsubscribeScope();
+      this.unsubscribeScope = null;
     }
+    this.scope = null;
+    this.credentials = null;
     this.listeners.clear();
   }
 };
@@ -1535,6 +1416,16 @@ function TidySettingsPanel() {
 }
 function setupSettingsUi(ctx) {
   if (typeof window === "undefined") return;
+  try {
+    const settingsScope = ctx?.settingsScope || (ctx?.get ? ctx.get("settingsScope") : null);
+    const remoteCredentials = ctx?.remote?.credentials || (ctx?.get ? ctx.get("remote.credentials") : null);
+    if (settingsScope && typeof settingsScope.bind === "function") {
+      const scope = settingsScope.bind({ namespace: SETTINGS_NAMESPACE });
+      settingsStore.attach(scope, remoteCredentials ?? null);
+    }
+  } catch (err) {
+    console.warn("[dsh-chat-translate] Failed to bind settings scope:", err);
+  }
   try {
     const slots = ctx?.slots || (ctx?.get ? ctx.get("slots") : null);
     if (!slots || typeof slots.inject !== "function") return;
@@ -1543,7 +1434,8 @@ function setupSettingsUi(ctx) {
         {
           name: "settings.section",
           id: "dsh-chat-translate",
-          order: 5,
+          // 约定：自有插件设置项 order 从 110 起步进 10（原生最大 100=桌面设置），保证排在所有原生项之下
+          order: 110,
           label: () => "\u804A\u5929\u7FFB\u8BD1"
         },
         TidySettingsPanel
@@ -1556,7 +1448,7 @@ function setupSettingsUi(ctx) {
 
 // src/client/index.ts
 var name = "dsh-chat-translate";
-var inject = ["slots"];
+var inject = ["slots", "settingsScope", "remote", "remote.credentials"];
 function apply(ctx) {
   ctx.effect(() => chatTranslateObserver.start(document), "dsh-chat-translate: title translate observer");
   ctx.effect(() => setupSettingsUi(ctx), "dsh-chat-translate: settings section");