@lynn123411/dsh-chat-translate 1.8.0 → 1.9.0

package/README.md

@@ -14,7 +14,7 @@ DeepSeek Harness Web 界面的工具调用与思考链智能翻译插件。自
 - **智能内容脱敏与占位符保护**：翻译前对多行代码块、内联代码、URL 链接、文件路径及 CLI 命令行参数进行占位符脱敏与鲁棒还原，杜绝代码与路径被误翻译。占位符为 `⟦<随机短码><序号>⟧` 形式的独立片段，构建时会在紧邻拉丁字母的一侧补一个空格，避免译回时与相邻单词粘连。译文只有在每个占位符都按原顺序被完整还原时才被采用：占位符被改写、遗失或多个重复时整条译文作废并换通道，退回原文，且绝不写入缓存；升级前旧格式写入的污染译文在读取时被驱逐。
 - **当前会话作用域**：仅翻译当前查看的会话，切换会话自动跟随新内容；视口懒加载（150px 缓冲）与文档顺序排队，译文按阅读顺序出现。
 - **智能调度与熔断保护**：工具标题走 1–100 动态并发限流队列、AI 30s / Bing 2s 超时、连续失败熔断自愈、在途请求合并去重、7 天 LRU 磁盘持久化缓存（工具标题 `~/.dsh/dsh-chat-translate/cache.json`，思考链 `~/.dsh/dsh-chat-translate/think-cache.json`）。
-- **DSH 原生配置接入**：配置走 DSH `settings` 服务（用户层写入 `~/.dsh/settings.yaml` 的 `dsh-chat-translate` 段）、密钥走 DSH `credentials` 服务、设置面板经 `settingsScope` 与 `credentials` Remote API 读写——无任何自研配置文件。
+- **DSH 原生配置接入**：配置就是本插件在 profile 里的插件配置——设置面板经 DSH 的共享配置表单（`ctx.configForms`）读写本插件配置条目 `dsh-chat-translate` 的 `config`，用户层落在当前 profile 的 patch；密钥走 DSH `credentials` 服务（`~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`）。无任何自研配置文件。
 - **设置面板集成**：设置面板挂在「设置 - 阅读体验」页（本插件贡献其中一张卡片），页内提供总开关、AI/Bing 通道开关、「显示思考链翻译按钮」（默认打开）与思考链超时、Base URL 与模型配置、通道测试与并发数调节。按钮的显示还要求 AI 通道打开且已配置（Key / Base URL / 模型齐全），缺任何一条都不注入按钮并还原已翻译内容。
 
 ## 安装

package/cordis.patch.yml

@@ -1,6 +1,7 @@
 # @lynn123411/dsh-chat-translate bundle patch
 # 声明在 package.json 的 dsh.bundle.patch，`dsh plugin add` 后自动并入 profile 层栈。
-# 浏览器半区（lib/client.js）由 client-modules 依据 dsh.client 声明自动发现。
+# 这条 insert 行是 root loader entry（不是 preset 子树），client-modules 正是对这类行
+# 依据 dsh.client 声明服务浏览器半区（lib/client.js），所以插件本体单行即可。
 - insert:
     - id: dsh-chat-translate
       name: '@lynn123411/dsh-chat-translate'

package/docs//351/205/215/347/275/256.md

@@ -11,22 +11,24 @@
 
    > ⚠️ **注意**：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 通道」验证。所有设置（开关、并发数、超时等）由 DSH 持久化到 `~/.dsh/settings.yaml` 的 `dsh-chat-translate` 段，可直接编辑该文件（DSH 会热同步）：
+2. **Base URL 与模型等设置**：在「设置 - 阅读体验」中填写 Base URL（如 `https://api.openai.com/v1` 或 `https://api.deepseek.com/v1`）与模型名（如 `gpt-4o-mini`、`deepseek-chat`），点击「测试 AI 通道」验证。所有设置（开关、并发数、超时等）都是本插件在 profile 里的插件配置：写入当前 profile 的 patch（`~/.dsh/profiles/<profile>/cordis.patch.yml`）中 `dsh-chat-translate` 条目的 `config`，可直接编辑该文件——字段都是可实时更新的，改完立即生效，不需重载：
 
    ```yaml
-   dsh-chat-translate:
-     enabled: true
-     concurrency: 3
-     aiEnabled: true
-     bingEnabled: true
-     thinkEnabled: true
-     thinkTimeoutMs: 600000
-     baseUrl: https://api.deepseek.com/v1
-     model: deepseek-chat
-     targetLang: zh-Hans
+   - id: dsh-chat-translate
+     name: '@lynn123411/dsh-chat-translate'
+     config:
+       enabled: true
+       concurrency: 3
+       aiEnabled: true
+       bingEnabled: true
+       thinkEnabled: true
+       thinkTimeoutMs: 600000
+       baseUrl: https://api.deepseek.com/v1
+       model: deepseek-chat
+       targetLang: zh-Hans
    ```
 
-   > 从 1.2 起，插件不再读写独立的 `~/.dsh/dsh-chat-translate-config.json`：升级后首次加载会自动把旧文件的值迁移进上面的 settings 段并删除旧文件（若你已在 UI 中改过设置，则以你的设置为准）。
+   > 从 1.2 起，插件不再读写独立的 `~/.dsh/dsh-chat-translate-config.json`：升级后首次加载会自动把旧文件的值迁移进这个配置条目并删除旧文件（若你已在 UI 中改过设置，则以你的设置为准）。
 
 3. **思考链翻译按钮**：AI 卡片里的「显示思考链翻译按钮」默认打开；按钮的显示还要求总开关打开、AI 通道打开且已配置（Key / Base URL / 模型齐全），缺任何一条都不注入按钮并还原已翻译内容。按钮只在展开的思考卡上出现，位于「Think」右侧；折叠的卡片没有按钮，展开后才插入。点击才翻译这条思考正文，不会自动翻译。
 

package/lib/client.js

@@ -1452,9 +1452,9 @@ var DEFAULT_STATE = {
 var SettingsStore = class {
   state = { ...DEFAULT_STATE };
   listeners = /* @__PURE__ */ new Set();
-  scope = null;
+  form = null;
   credentials = null;
-  unsubscribeScope = null;
+  unsubscribeForm = null;
   keyConfigured = false;
   writeTimer = null;
   pendingFields = /* @__PURE__ */ new Set();
@@ -1462,15 +1462,15 @@ var SettingsStore = class {
    * 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;
+  attach(form, credentials) {
+    if (this.unsubscribeForm) {
+      this.unsubscribeForm();
+      this.unsubscribeForm = null;
     }
-    this.scope = scope;
+    this.form = form;
     this.credentials = credentials;
-    if (scope) {
-      this.unsubscribeScope = scope.subscribe(() => this.derive());
+    if (form) {
+      this.unsubscribeForm = form.subscribe(() => this.derive());
       this.derive();
     }
     void this.refreshKeyStatus();
@@ -1484,10 +1484,10 @@ var SettingsStore = class {
       this.listeners.delete(listener);
     };
   }
-  /** Map the resolved namespace value into client state and notify. */
+  /** Map the resolved section into client state and notify. */
   derive() {
-    if (!this.scope) return;
-    const snap = this.scope.getSnapshot();
+    if (!this.form) return;
+    const snap = this.form.getSnapshot();
     const value = snap.value;
     if (!value || typeof value !== "object") return;
     const next = { ...this.state };
@@ -1552,11 +1552,11 @@ var SettingsStore = class {
   }
   /**
    * Optimistically apply locally, then persist each touched field through the
-   * settings scope. Writes are trailing-debounced (300ms) so typing in the
+   * configuration form. 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
+   * back into the inputs between commits. A failed write makes the form reload
+   * its mirror, which re-derives this store from the Host document
    * (conflict-safe recovery).
    */
   async update(partial) {
@@ -1578,7 +1578,7 @@ var SettingsStore = class {
       thinkTimeoutMs: sanitizedThinkTimeout
     };
     this.applyState(next);
-    if (this.scope) {
+    if (this.form) {
       const fields = [
         "enabled",
         "concurrency",
@@ -1605,7 +1605,7 @@ var SettingsStore = class {
     }, 300);
   }
   async flushWrite() {
-    if (!this.scope) return;
+    if (!this.form) return;
     const fields = [...this.pendingFields];
     this.pendingFields.clear();
     if (fields.length === 0) return;
@@ -1614,7 +1614,7 @@ var SettingsStore = class {
       path: [field],
       value: this.state[field]
     }));
-    await this.scope.mutate(ops).catch(() => {
+    await this.form.mutate(ops).catch(() => {
     });
   }
   async testChannel(channel) {
@@ -1643,11 +1643,11 @@ var SettingsStore = class {
       this.writeTimer = null;
     }
     this.pendingFields.clear();
-    if (this.unsubscribeScope) {
-      this.unsubscribeScope();
-      this.unsubscribeScope = null;
+    if (this.unsubscribeForm) {
+      this.unsubscribeForm();
+      this.unsubscribeForm = null;
     }
-    this.scope = null;
+    this.form = null;
     this.credentials = null;
     this.listeners.clear();
   }
@@ -2256,18 +2256,15 @@ function TidySettingsPanel(props) {
 }
 function setupSettingsUi(ctx) {
   if (typeof window === "undefined") return;
+  const configForms = ctx.configForms;
+  const remoteCredentials = ctx.remote?.credentials ?? null;
   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);
-    }
+    settingsStore.attach(configForms.get(SETTINGS_NAMESPACE), remoteCredentials);
   } catch (err) {
-    console.warn("[dsh-chat-translate] Failed to bind settings scope:", err);
+    console.warn("[dsh-chat-translate] Failed to bind the configuration form:", err);
   }
-  const locale = typeof ctx?.get === "function" ? ctx.get("locale") : null;
-  if (locale && typeof locale.register === "function" && typeof ctx?.effect === "function") {
+  const locale = ctx.locale;
+  if (locale && typeof locale.register === "function") {
     ctx.effect(
       () => locale.register(NS, { zh, en }),
       "dsh-chat-translate: locale dictionaries"
@@ -2275,27 +2272,36 @@ function setupSettingsUi(ctx) {
   }
   const t = locale && typeof locale.bind === "function" ? locale.bind(NS) : (key) => zh[key] ?? key;
   try {
-    const slots = ctx?.slots || (ctx?.get ? ctx.get("slots") : null);
+    const slots = ctx.slots;
     if (!slots || typeof slots.inject !== "function") return;
-    slots.inject(
-      "settings.section",
-      () => claimReadingSettingsPage(ctx, () => t("pageNav"), NS)
-    );
-    slots.inject(
-      READING_ITEM_SLOT,
-      () => slots.register(
-        {
-          name: READING_ITEM_SLOT,
-          // id = 本插件的 Host 设置命名空间（settings.section 时代的 id 沿用）
-          id: SETTINGS_NAMESPACE,
-          // 卡片在共享页里的顺序：丝滑流式 10、吸顶提示 20、聊天翻译 30
-          order: 30,
-          // 共享页按此标签渲染 tab
-          label: () => t("title"),
-          locale: NS
-        },
-        TidySettingsPanel
-      )
+    ctx.effect(
+      () => configForms.whileServed([SETTINGS_NAMESPACE], () => {
+        const offPage = slots.inject(
+          "settings.section",
+          () => claimReadingSettingsPage(ctx, () => t("pageNav"), NS)
+        );
+        const offCard = slots.inject(
+          READING_ITEM_SLOT,
+          () => slots.register(
+            {
+              name: READING_ITEM_SLOT,
+              // id = 本插件的配置条目 id（= profile entry id = 设置命名空间）
+              id: SETTINGS_NAMESPACE,
+              // 卡片在共享页里的顺序：丝滑流式 10、吸顶提示 20、聊天翻译 30
+              order: 30,
+              // 共享页按此标签渲染 tab
+              label: () => t("title"),
+              locale: NS
+            },
+            TidySettingsPanel
+          )
+        );
+        return () => {
+          offCard();
+          offPage();
+        };
+      }),
+      "dsh-chat-translate: shared reading page"
     );
   } catch (err) {
     console.warn("[dsh-chat-translate] Failed to inject settings section:", err);
@@ -2304,7 +2310,7 @@ function setupSettingsUi(ctx) {
 
 // src/client/index.ts
 var name = "dsh-chat-translate";
-var inject = ["slots", "settingsScope", "remote", "remote.credentials", "locale"];
+var inject = ["slots", "configForms", "remote", "remote.credentials", "locale"];
 function apply(ctx) {
   ctx.effect(() => chatTranslateObserver.start(document), "dsh-chat-translate: title translate observer");
   ctx.effect(() => setupSettingsUi(ctx), "dsh-chat-translate: settings section");