beauticode-dsh 1.0.26 → 1.0.28

package/README.zh-CN.md

@@ -2,6 +2,8 @@
 
 该 Cordis 插件向 DSH Web 和官方 Desktop 注入 beautiCode 浏览器客户端，并提供本机鉴权接口。支持图片、MP4 / MOV、播放位置、静音、摸鱼模式以及清除背景。Web 和 Desktop 使用同一组结构化页面注入；Desktop 的页面请求经原生壳转发，回执由每次 Host 启动生成的页面密钥验证。
 
+DSH Web 和 Desktop 启动及普通点击不会自动进入全屏。需要全屏时，在「设置 → 背景 → 全屏显示」中主动开启，按 `Esc` 或点击「退出全屏」退出。
+
 ## 官方 Desktop
 
 先启动 Desktop 一次，让它创建 `desktop` profile，然后从系统托盘明确退出（关闭窗口通常只会隐藏）。可在 Desktop 的插件页面安装 `beauticode-dsh`，或使用 **Desktop 安装的** `dsh` 命令：
@@ -14,6 +16,8 @@ dsh plugin --profile desktop add beauticode-dsh
 
 重新打开 Desktop，在「设置」中使用「背景」。Desktop 默认 Host 端口是 `19387`；如果还使用 beautiCode 托盘，将托盘的 `-DshUrl` 指向 `http://127.0.0.1:19387`（若 Desktop profile 改过 `webserver.config.port`，请使用实际端口）。Desktop 插件由 Desktop 自己管理；下方的 `npx beauticode-dsh` 安装器针对 Web profile。
 
+「设置 → 背景」默认开启「功能面板不透明」，保证设置、弹层、菜单与消息编辑栏遮住后方内容。关闭后恢复原有透明效果；选择会保存在当前应用的本地偏好中，不受背景阴影、会话阶段或画窗模式影响。
+
 ## Web
 
 装好插件并运行 `dsh web` 后，打开「设置」，左侧导航里会多出一项「背景」：在 Windows 上点击图片或视频会打开系统文件选择器，选好后在页面内命名，背景立即应用并进入已保存主题；也可以清除、开关声音、切换或删除主题，进入全屏把浏览器的标签页和地址栏收起来，以及打开「皮肤中心」安装已审核的社区皮肤。本地导入只在 Node 端保存绝对路径，并通过带 Range 支持的回环媒体服务读取原文件，不复制用户选择的图片或整段视频主文件。Windows 强制使用本地引用；原生选择器不可用时会明确报错，不会静默上传或复制媒体。非 Windows 环境保留兼容上传，并明确提示该模式会保存托管副本。网页控制台没有摸鱼；浅色/深色跟 DSH 自己的外观走。下次打开会恢复上次背景。设置 `BEAUTICODE_SKIN_CENTER` 或填写 `skin-center.json` 后，皮肤中心才会显示远程目录。

package/client.js

@@ -1861,50 +1861,4 @@ html[data-bc-fish="true"] #root{opacity:0!important;visibility:hidden!important;
       }).catch(() => {});
     }
   }, 1_000);
-
-  // Fullscreen by default. A browser only grants fullscreen from inside a user
-  // gesture, so a page cannot open in it; the closest honest reading of
-  // "starts fullscreen" is the first click after load. Typing in the composer
-  // must not count: DSH's main action is a keydown. Escape or the settings row
-  // still exits. Stay armed until the request actually succeeds — a rejected
-  // first gesture used to spend the listener and leave the page windowed.
-  function armFullscreenDefault() {
-    const root = document.documentElement;
-    if (typeof root?.requestFullscreen !== "function" &&
-        typeof root?.webkitRequestFullscreen !== "function") {
-      return;
-    }
-    let spent = false;
-    const enter = () => {
-      if (spent) return;
-      if (document.fullscreenElement || document.webkitFullscreenElement) {
-        spent = true;
-        document.removeEventListener?.("pointerdown", enter, true);
-        return;
-      }
-      for (const name of ["requestFullscreen", "webkitRequestFullscreen"]) {
-        const request = root?.[name];
-        if (typeof request !== "function") continue;
-        let started;
-        try {
-          started = request.call(root, { navigationUI: "hide" });
-        } catch {
-          continue;
-        }
-        Promise.resolve(started).then(
-          () => {
-            spent = true;
-            document.removeEventListener?.("pointerdown", enter, true);
-          },
-          () => {
-            /* gesture rejected — stay armed for the next click */
-          },
-        );
-        return;
-      }
-    };
-    document.addEventListener?.("pointerdown", enter, { capture: true });
-  }
-
-  armFullscreenDefault();
 })();

package/console.js

@@ -131,6 +131,10 @@ div[role="dialog"][aria-modal="true"][data-bc-page="on"] nav button[aria-current
     "</div>" +
     '<div class="bc-control"><button type="button" class="bc-btn bc-pill" data-act="fullscreen" aria-pressed="false">进入全屏</button></div></div>' +
     '<div class="bc-row"><div class="bc-row-text">' +
+    '<span class="bc-row-title">功能面板不透明</span>' +
+    '<span class="bc-row-desc">遮住设置、弹层和消息编辑栏后方的内容</span>' +
+    '</div><div class="bc-control"><button type="button" class="bc-btn bc-pill on" data-act="readability" aria-pressed="true">已开</button></div></div>' +
+    '<div class="bc-row"><div class="bc-row-text">' +
     '<span class="bc-row-title">背景阴影</span>' +
     '<span class="bc-row-desc">压暗背景，让内容更清楚</span>' +
     "</div>" +
@@ -210,6 +214,7 @@ div[role="dialog"][aria-modal="true"][data-bc-page="on"] nav button[aria-current
   document.body.append(fileInput);
 
   const soundBtn = page.querySelector('[data-act="sound"]');
+  const readabilityBtn = page.querySelector('[data-act="readability"]');
   const dimSlider = page.querySelector(".bc-dim-slider");
   const dimValue = page.querySelector(".bc-dim-value");
   const dimReset = page.querySelector('[data-act="dim-reset"]');
@@ -251,6 +256,13 @@ div[role="dialog"][aria-modal="true"][data-bc-page="on"] nav button[aria-current
     dimValue.textContent = `${percent}%`;
   }
 
+  function renderReadability() {
+    const enabled = globalThis.BeauticodeReadableSurfaces?.get?.() !== false;
+    readabilityBtn.classList.toggle("on", enabled);
+    readabilityBtn.textContent = enabled ? "已开" : "已关";
+    readabilityBtn.setAttribute("aria-pressed", String(enabled));
+  }
+
   function isOurs(node) {
     for (let el = node; el; el = el.parentElement ?? null) {
       if (String(el.id || "").startsWith("beauticode-")) return true;
@@ -323,6 +335,7 @@ div[role="dialog"][aria-modal="true"][data-bc-page="on"] nav button[aria-current
     }
     dialogEl.setAttribute("data-bc-page", "on");
     navButton.setAttribute("aria-current", "true");
+    renderReadability();
     renderDim();
   renderBlur();
     void refresh();
@@ -792,6 +805,14 @@ div[role="dialog"][aria-modal="true"][data-bc-page="on"] nav button[aria-current
       }
     })();
   });
+  readabilityBtn.addEventListener("click", (event) => {
+    event.stopPropagation();
+    const enabled = globalThis.BeauticodeReadableSurfaces?.get?.() !== false;
+    globalThis.BeauticodeReadableSurfaces?.set?.(!enabled);
+    renderReadability();
+  });
+  globalThis.addEventListener?.("beauticode-readability-change", renderReadability);
+  renderReadability();
   dimSlider.addEventListener("input", () => {
     const n = Number(dimSlider.value);
     if (!Number.isFinite(n)) return;

package/index.mjs

@@ -332,7 +332,12 @@ export function apply(ctx, config = {}) {
             res.writeHead(405).end();
             return;
           }
-          const source = await fs.readFile(path.join(here, "client.js"));
+          // Keep one ordered client entry point: readability owns surface
+          // preferences; client.js owns the media/transport lifecycle.
+          const scripts = await Promise.all(["readability.js", "client.js"].map(
+            (file) => fs.readFile(path.join(here, file)),
+          ));
+          const source = Buffer.concat([scripts[0], Buffer.from("\n"), scripts[1]]);
           res.writeHead(200, {
             "content-type": "text/javascript; charset=utf-8",
             "cache-control": "no-store",

package/package.json

@@ -1,61 +1,62 @@
-{
-  "name": "beauticode-dsh",
-  "version": "1.0.26",
-  "description": "Cordis plugin: image/video backgrounds for DeepSeek Harness Web and Desktop.",
-  "type": "module",
-  "main": "./index.mjs",
-  "bin": {
-    "beauticode-dsh": "bin/beauticode-dsh"
-  },
-  "exports": {
-    ".": {
-      "import": "./index.mjs"
-    }
-  },
-  "files": [
-    "index.mjs",
-    "browser-injection.mjs",
-    "transport.js",
-    "client.js",
-    "console.js",
-    "gallery.js",
-    "gallery-host.mjs",
-    "skin-center.json",
-    "atmosphere.js",
-    "presets.mjs",
-    "agent.mjs",
-    "control-client.mjs",
-    "host-apply.mjs",
-    "ui-host.mjs",
-    "cli.js",
-    "bin/beauticode-dsh",
-    "cordis.patch.yml",
-    "vendor",
-    "themes"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    }
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "keywords": [
-    "dsh",
-    "dsh-plugin",
-    "deepseek",
-    "deepseek-harness",
-    "background",
-    "wallpaper"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/starsstreaming/beautiCode.git",
-    "directory": "integrations/deepseek-harness"
-  },
-  "engines": {
-    "node": ">=22"
-  },
-  "license": "MIT"
-}
+{
+  "name": "beauticode-dsh",
+  "version": "1.0.28",
+  "description": "Cordis plugin: image/video backgrounds for DeepSeek Harness Web and Desktop.",
+  "type": "module",
+  "main": "./index.mjs",
+  "bin": {
+    "beauticode-dsh": "bin/beauticode-dsh"
+  },
+  "exports": {
+    ".": {
+      "import": "./index.mjs"
+    }
+  },
+  "files": [
+    "index.mjs",
+    "browser-injection.mjs",
+    "transport.js",
+    "client.js",
+    "readability.js",
+    "console.js",
+    "gallery.js",
+    "gallery-host.mjs",
+    "skin-center.json",
+    "atmosphere.js",
+    "presets.mjs",
+    "agent.mjs",
+    "control-client.mjs",
+    "host-apply.mjs",
+    "ui-host.mjs",
+    "cli.js",
+    "bin/beauticode-dsh",
+    "cordis.patch.yml",
+    "vendor",
+    "themes"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek",
+    "deepseek-harness",
+    "background",
+    "wallpaper"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/starsstreaming/beautiCode.git",
+    "directory": "integrations/deepseek-harness"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT"
+}

package/readability.js

@@ -0,0 +1,73 @@
+(() => {
+  "use strict";
+  if (globalThis.BeauticodeReadableSurfaces) return;
+
+  const STORAGE_KEY = "beauticode-readable-surfaces";
+  const root = document.documentElement;
+  // Only an explicit opt-out disables protection. Missing/corrupt preferences
+  // and unavailable storage must not make text behind a panel visible again.
+  function readPreference() {
+    try {
+      return globalThis.localStorage?.getItem(STORAGE_KEY) !== "false";
+    } catch {
+      return true;
+    }
+  }
+
+  let enabled = readPreference();
+  function applyPreference() {
+    root.dataset.bcReadableSurfaces = String(enabled);
+    globalThis.dispatchEvent?.(new CustomEvent("beauticode-readability-change"));
+  }
+
+  const style = document.createElement("style");
+  style.dataset.beauticodeReadability = "true";
+  style.textContent = `
+html[data-bc-active="true"] body{
+  --bc-readable-fill:var(--dsw-static-neutral-bluish-800,#232833);
+}
+html[data-bc-active="true"][data-bc-resolved-tone="light"] body{
+  --bc-readable-fill:var(--dsw-static-neutral-bluish-00,#fff);
+}
+/* DSH settings are body portals; its sticky composer sits over the transcript.
+   Protect the actual surface, rather than keying readability to a conversation
+   phase or dim preference. Local aliases also beat gallery's body overrides.
+   Semantic roles and data-composer-card are shipped DSH contracts, not hashes. */
+html[data-bc-active="true"]:not([data-bc-readable-surfaces="false"]) :is(
+  [role="dialog"],[role="alertdialog"],[role="menu"],[role="listbox"],
+  [role="tooltip"],[data-composer-card]
+){
+  --dsw-alias-bg-base:var(--bc-readable-fill);
+  --dsw-alias-bg-layer-1:var(--bc-readable-fill);
+  --dsw-alias-bg-layer-2:var(--bc-readable-fill);
+  --dsw-alias-bg-layer-3:var(--bc-readable-fill);
+  --dsw-alias-bg-overlay:var(--bc-readable-fill);
+  --dsw-specific-input-major:var(--bc-readable-fill);
+  --dsw-specific-menu:var(--bc-readable-fill);
+  --dsw-alias-tooltip-bg:var(--bc-readable-fill);
+  background-color:var(--bc-readable-fill);
+}
+`;
+  document.head.append(style);
+  applyPreference();
+
+  globalThis.BeauticodeReadableSurfaces = {
+    get: () => enabled,
+    set(value) {
+      if (typeof value !== "boolean") return enabled;
+      enabled = value;
+      try {
+        globalThis.localStorage?.setItem(STORAGE_KEY, String(enabled));
+      } catch {
+        // Storage can be denied; the current page still honors the selection.
+      }
+      applyPreference();
+      return enabled;
+    },
+  };
+  globalThis.addEventListener?.("storage", (event) => {
+    if (event.key !== STORAGE_KEY && event.key !== null) return;
+    enabled = readPreference();
+    applyPreference();
+  });
+})();