@lynn123411/dsh-chat-translate 1.2.5 → 1.3.0

package/README.md

@@ -12,7 +12,7 @@ DeepSeek Harness Web 界面的工具调用与思考摘要智能翻译插件。
 - **当前会话作用域**：仅翻译当前查看的会话，切换会话自动跟随新内容；视口懒加载（150px 缓冲）与文档顺序排队，译文按阅读顺序出现。
 - **智能调度与熔断保护**：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 与模型配置、通道测试与并发数调节。
+- **设置面板集成**：设置面板已迁入与 `dsh-smooth-stream`、`dsh-oil-sticky-prompt` 共用的「设置 - 阅读体验」共享页（本插件贡献其中一张卡片），页内提供总开关、AI/Bing 通道开关、Base URL 与模型配置、通道测试与并发数调节。
 
 ## 安装
 

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

@@ -2,7 +2,7 @@
 
 > 本文档为 [@lynn123411/dsh-chat-translate](../README.md) 的配置说明（自 README 的「## 配置」段迁出，内容保持一致）。
 
-1. **API Key**：打开「设置 - 聊天翻译」，在 AI 翻译卡片中直接填写 API Key 并保存（经 DSH 凭据服务写入 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，权限 0600，保存后立即生效；留空保存 = 清除该键）。也可以手动编辑该文件：
+1. **API Key**：打开「设置 - 阅读体验」，在 AI 翻译卡片中直接填写 API Key 并保存（经 DSH 凭据服务写入 `~/.dsh/.credentials.yaml` 的 `TRANSLATE_API_KEY`，权限 0600，保存后立即生效；留空保存 = 清除该键）。也可以手动编辑该文件：
 
    ```yaml
    refs:
@@ -11,7 +11,7 @@
 
    > ⚠️ **注意**：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 通道」验证。所有设置（开关、并发数、超时等）由 DSH 持久化到 `~/.dsh/settings.yaml` 的 `dsh-chat-translate` 段，可直接编辑该文件（DSH 会热同步）：
 
    ```yaml
    dsh-chat-translate:

package/lib/client.js

@@ -129,6 +129,32 @@ var ClientCache = class {
 };
 var clientCache = new ClientCache();
 
+// src/describe-error.ts
+function describeError(err) {
+  if (err === null || err === void 0) return String(err);
+  const parts = [];
+  const push = (s) => {
+    const t = String(s || "").trim();
+    if (t && !parts.includes(t)) parts.push(t);
+  };
+  const head = err.message || String(err);
+  push(head);
+  const headCode = err.code;
+  if (headCode && !head.includes(headCode)) push("[" + headCode + "]");
+  let cause = err.cause;
+  for (let depth = 0; cause && depth < 4; depth++) {
+    const label = cause.message || String(cause);
+    push(cause.code && !label.includes(cause.code) ? label + " [" + cause.code + "]" : label);
+    if (Array.isArray(cause.errors)) {
+      for (const sub of cause.errors.slice(0, 3)) {
+        if (sub) push(sub.code || sub.message || String(sub));
+      }
+    }
+    cause = cause.cause;
+  }
+  return parts.join(" \u2190 ");
+}
+
 // src/client/translate/api.ts
 async function requestTranslateBatch(texts, options = {}) {
   if (!Array.isArray(texts) || texts.length === 0) return [];
@@ -183,7 +209,7 @@ async function testServerChannel(channel) {
     });
     return await res.json();
   } catch (err) {
-    return { ok: false, latencyMs: 0, error: err?.message || String(err) };
+    return { ok: false, latencyMs: 0, error: describeError(err) };
   }
 }
 
@@ -712,7 +738,7 @@ var ChatTranslateObserver = class {
 var chatTranslateObserver = new ChatTranslateObserver();
 
 // src/client/settings/ui.tsx
-var import_react = require("react");
+var import_react2 = require("react");
 
 // src/client/settings/store.ts
 var SETTINGS_NAMESPACE = "dsh-chat-translate";
@@ -879,7 +905,7 @@ var SettingsStore = class {
       await this.refreshKeyStatus();
       return { ok: true };
     } catch (err) {
-      return { ok: false, error: err?.message || String(err) };
+      return { ok: false, error: describeError(err) };
     }
   }
   dispose() {
@@ -1182,6 +1208,152 @@ var SETTINGS_CSS = String.raw`
 }
 `;
 
+// src/client/reading-settings-page.tsx
+var import_react = require("react");
+var READING_PAGE_ID = "reading";
+var READING_PAGE_ORDER = 110;
+var READING_ITEM_SLOT = "reading.settings.item";
+function readLabel(label) {
+  if (typeof label === "function") return label();
+  return typeof label === "string" ? label : "";
+}
+var TABLIST_STYLE = {
+  display: "flex",
+  alignItems: "flex-end",
+  gap: "22px",
+  marginTop: "2px",
+  marginBottom: "16px"
+};
+var TAB_STYLE = {
+  appearance: "none",
+  background: "transparent",
+  // No border on ANY tab: the marker below is the active tab's own element, so
+  // an inactive tab has nothing that could render a line.
+  border: "none",
+  position: "relative",
+  padding: "7px 1px 11px",
+  cursor: "pointer",
+  font: "inherit",
+  fontSize: "13px",
+  lineHeight: "20px",
+  color: "var(--dsw-alias-label-tertiary, inherit)"
+};
+var TAB_ACTIVE_STYLE = {
+  ...TAB_STYLE,
+  color: "var(--dsw-alias-label-primary, inherit)"
+};
+var TAB_MARKER_STYLE = {
+  position: "absolute",
+  left: 0,
+  right: 0,
+  bottom: 0,
+  height: "2px",
+  borderRadius: "2px 2px 0 0",
+  background: "var(--dsw-alias-label-primary, currentColor)"
+};
+var PANEL_STYLE = { listStyle: "none", margin: 0, padding: 0 };
+var PANEL_HIDDEN_STYLE = { ...PANEL_STYLE, display: "none" };
+function createReadingTabs(ctx) {
+  const locale = ctx.get("locale");
+  let version = -1;
+  let revision = -1;
+  let tabs = [];
+  return {
+    getSnapshot: () => {
+      const nextVersion = ctx.slots.getVersion(READING_ITEM_SLOT);
+      const nextRevision = locale === void 0 ? 0 : locale.getSnapshot().revision;
+      if (nextVersion === version && nextRevision === revision) return tabs;
+      version = nextVersion;
+      revision = nextRevision;
+      tabs = ctx.slots.entries(READING_ITEM_SLOT).map((entry) => ({
+        id: entry.options.id ?? "",
+        order: entry.options.order ?? 0,
+        label: readLabel(entry.options.label)
+      })).sort((left, right) => left.order - right.order);
+      return tabs;
+    },
+    subscribe: (listener) => {
+      const offSlots = ctx.slots.subscribe(READING_ITEM_SLOT, listener);
+      const offLocale = locale?.subscribe(listener);
+      return () => {
+        offSlots();
+        offLocale?.();
+      };
+    }
+  };
+}
+function ReadingSettingsSection({ renderSlot, readingTabs }) {
+  const tabs = (0, import_react.useSyncExternalStore)(
+    readingTabs.subscribe,
+    readingTabs.getSnapshot,
+    readingTabs.getSnapshot
+  );
+  const [requested, setRequested] = (0, import_react.useState)(null);
+  const selected = requested !== null && tabs.some((tab) => tab.id === requested) ? requested : tabs[0]?.id ?? null;
+  if (selected === null) return null;
+  return (0, import_react.createElement)(
+    "div",
+    null,
+    (0, import_react.createElement)(
+      "div",
+      { role: "tablist", style: TABLIST_STYLE },
+      tabs.map((tab) => (0, import_react.createElement)(
+        "button",
+        {
+          key: tab.id,
+          type: "button",
+          role: "tab",
+          "aria-selected": tab.id === selected,
+          style: tab.id === selected ? TAB_ACTIVE_STYLE : TAB_STYLE,
+          onClick: () => {
+            setRequested(tab.id);
+          }
+        },
+        tab.label,
+        tab.id === selected ? (0, import_react.createElement)("span", { style: TAB_MARKER_STYLE, "aria-hidden": true }) : null
+      ))
+    ),
+    tabs.map((tab) => (0, import_react.createElement)(
+      "ul",
+      {
+        key: tab.id,
+        role: "tabpanel",
+        hidden: tab.id !== selected,
+        style: tab.id === selected ? PANEL_STYLE : PANEL_HIDDEN_STYLE
+      },
+      renderSlot(READING_ITEM_SLOT, {}, { only: tab.id })
+    ))
+  );
+}
+function readingPageClaimed(ctx) {
+  return ctx.slots.entries("settings.section").some((entry) => entry.options.id === READING_PAGE_ID);
+}
+function claimReadingSettingsPage(ctx, label, locale) {
+  if (readingPageClaimed(ctx)) return () => {
+  };
+  const readingTabs = createReadingTabs(ctx);
+  return ctx.slots.register({
+    name: "settings.section",
+    id: READING_PAGE_ID,
+    order: READING_PAGE_ORDER,
+    label,
+    locale,
+    inject: () => ({ readingTabs }),
+    children: { "reading.settings.item": { kind: "list", scope: "root" } }
+  }, ReadingSettingsSection);
+}
+
+// src/client/locales.ts
+var NS = "settings.chatTranslate";
+var en = {
+  pageNav: "Reading",
+  title: "Chat translate"
+};
+var zh = {
+  pageNav: "\u9605\u8BFB\u4F53\u9A8C",
+  title: "\u804A\u5929\u7FFB\u8BD1"
+};
+
 // src/client/settings/ui.tsx
 var import_jsx_runtime = require("react/jsx-runtime");
 var stylesInjected = false;
@@ -1206,14 +1378,14 @@ function Switch(props) {
     }
   );
 }
-function TidySettingsPanel() {
+function TidySettingsPanel(_props) {
   ensureSettingsStyles();
-  const [state, setState] = (0, import_react.useState)(() => settingsStore.getState());
-  const [testing, setTesting] = (0, import_react.useState)(null);
-  const [apiKeyInput, setApiKeyInput] = (0, import_react.useState)("");
-  const [savingKey, setSavingKey] = (0, import_react.useState)(false);
-  const [keyMsg, setKeyMsg] = (0, import_react.useState)(null);
-  (0, import_react.useEffect)(() => {
+  const [state, setState] = (0, import_react2.useState)(() => settingsStore.getState());
+  const [testing, setTesting] = (0, import_react2.useState)(null);
+  const [apiKeyInput, setApiKeyInput] = (0, import_react2.useState)("");
+  const [savingKey, setSavingKey] = (0, import_react2.useState)(false);
+  const [keyMsg, setKeyMsg] = (0, import_react2.useState)(null);
+  (0, import_react2.useEffect)(() => {
     return settingsStore.subscribe(() => {
       setState(settingsStore.getState());
     });
@@ -1432,21 +1604,37 @@ function setupSettingsUi(ctx) {
   } catch (err) {
     console.warn("[dsh-chat-translate] Failed to bind settings scope:", err);
   }
+  const locale = typeof ctx?.get === "function" ? ctx.get("locale") : null;
+  if (locale && typeof locale.register === "function" && typeof ctx?.effect === "function") {
+    ctx.effect(
+      () => locale.register(NS, { zh, en }),
+      "dsh-chat-translate: locale dictionaries"
+    );
+  }
+  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);
     if (!slots || typeof slots.inject !== "function") return;
-    slots.inject("settings.section", () => {
-      return slots.register(
+    slots.inject(
+      "settings.section",
+      () => claimReadingSettingsPage(ctx, () => t("pageNav"), NS)
+    );
+    slots.inject(
+      READING_ITEM_SLOT,
+      () => slots.register(
         {
-          name: "settings.section",
-          id: "dsh-chat-translate",
-          // 约定：自有插件设置项 order 从 110 起步进 10（原生最大 100=桌面设置），保证排在所有原生项之下
-          order: 110,
-          label: () => "\u804A\u5929\u7FFB\u8BD1"
+          name: READING_ITEM_SLOT,
+          // id = 本插件的 Host 设置命名空间（settings.section 时代的 id 沿用）
+          id: SETTINGS_NAMESPACE,
+          // 卡片在共享页里的顺序：丝滑流式 10、吸顶提示 20、聊天翻译 30
+          order: 30,
+          // 共享页按此标签渲染 tab
+          label: () => t("title"),
+          locale: NS
         },
         TidySettingsPanel
-      );
-    });
+      )
+    );
   } catch (err) {
     console.warn("[dsh-chat-translate] Failed to inject settings section:", err);
   }