beauticode-dsh 1.0.0

package/cli.js

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+/**
+ * One-line installer: npx beauticode-dsh
+ *
+ * Copies this package to a stable local folder and writes the DSH patch so
+ * `dsh web` loads beautiCode. Does not start DeepSeek Harness.
+ */
+import fs from "node:fs";
+import fsp from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+
+const here = path.dirname(fileURLToPath(import.meta.url));
+const pluginName = "beauticode-dsh";
+const bridgeId = "beauticode-bridge";
+
+function argValue(argv, name) {
+  const idx = argv.indexOf(name);
+  if (idx === -1) return null;
+  const value = argv[idx + 1];
+  return value && !value.startsWith("--") ? value : null;
+}
+
+function defaultDataRoot() {
+  if (process.env.BEAUTICODE_DATA_ROOT) return process.env.BEAUTICODE_DATA_ROOT;
+  if (process.env.LOCALAPPDATA) {
+    return path.join(process.env.LOCALAPPDATA, "beautiCode");
+  }
+  return path.join(os.homedir(), ".beauticode");
+}
+
+function defaultDshHome() {
+  return process.env.DSH_HOME || path.join(os.homedir(), ".dsh");
+}
+
+function toFileUri(filePath) {
+  const full = path.resolve(filePath).replaceAll("\\", "/");
+  if (/^[A-Za-z]:/.test(full)) return `file:///${full}`;
+  return pathToFileURL(full).href;
+}
+
+function fileUriInsert(uri) {
+  return [
+    "# beauticode-bridge (installer)",
+    "- insert:",
+    "    - id: beauticode-bridge",
+    `      name: '${uri}'`,
+    "      inject: [webServer]",
+    "",
+  ].join("\n");
+}
+
+function packageInsert() {
+  return [
+    "# beauticode-bridge (installer)",
+    "- insert:",
+    "    - id: beauticode-bridge",
+    `      name: '${pluginName}'`,
+    "      inject: [webServer]",
+    "",
+  ].join("\n");
+}
+
+function hasBridge(text) {
+  return new RegExp(`^\\s*-\\s*id:\\s*${bridgeId}\\s*$`, "m").test(text);
+}
+
+function stripBridge(text) {
+  const patterns = [
+    /(?:^|\r?\n)# beauticode-bridge \(installer\)\r?\n- insert:\r?\n(?:[ \t]+.*\r?\n)*/g,
+    /(?:^|\r?\n)- insert:\r?\n(?:[ \t]+.*\r?\n)*?[ \t]+-\s*id:\s*beauticode-bridge\r?\n(?:[ \t]+.*\r?\n)*/g,
+  ];
+  let next = text;
+  for (const pattern of patterns) next = next.replace(pattern, "\n");
+  return next;
+}
+
+async function writePatch(filePath, body) {
+  await fsp.mkdir(path.dirname(filePath), { recursive: true });
+  if (!fs.existsSync(filePath)) {
+    await fsp.writeFile(filePath, body, "utf8");
+    return;
+  }
+  const raw = await fsp.readFile(filePath, "utf8");
+  if (hasBridge(raw)) {
+    const replaced = raw.replace(
+      /(?:# beauticode-bridge \(installer\)\r?\n)?- insert:\r?\n(?:[ \t]+.*\r?\n)*?[ \t]+-\s*id:\s*beauticode-bridge\r?\n(?:[ \t]+.*\r?\n)*/,
+      body,
+    );
+    await fsp.writeFile(filePath, replaced.endsWith("\n") ? replaced : `${replaced}\n`, "utf8");
+    return;
+  }
+  const stripped = raw.trim();
+  if (stripped === "" || stripped === "[]") {
+    await fsp.writeFile(filePath, body, "utf8");
+    return;
+  }
+  await fsp.writeFile(filePath, `${stripped}\n\n${body}`, "utf8");
+}
+
+async function removePatch(filePath) {
+  if (!fs.existsSync(filePath)) return false;
+  const raw = await fsp.readFile(filePath, "utf8");
+  if (!hasBridge(raw)) return false;
+  const cleaned = stripBridge(raw).trim();
+  if (cleaned === "" || cleaned === "[]") {
+    await fsp.writeFile(
+      filePath,
+      "# Your patch layer for this dsh profile.\n[]\n",
+      "utf8",
+    );
+    return true;
+  }
+  await fsp.writeFile(filePath, `${cleaned}\n`, "utf8");
+  return true;
+}
+
+function shouldCopy(source) {
+  const relative = path.relative(here, source);
+  if (relative.startsWith("test") || relative.includes(`${path.sep}test${path.sep}`)) {
+    return false;
+  }
+  if (relative.endsWith(".test.mjs")) return false;
+  return true;
+}
+
+async function copyPackage(dest) {
+  await fsp.rm(dest, { recursive: true, force: true });
+  await fsp.cp(here, dest, {
+    recursive: true,
+    filter: (source) => shouldCopy(source),
+  });
+}
+
+async function ensureEngine(dest) {
+  const vendor = path.join(dest, "vendor", "adapter-dsh", "index.js");
+  if (fs.existsSync(vendor)) return;
+  const packPath = path.resolve(here, "../../scripts/pack-dsh-plugin.mjs");
+  if (!fs.existsSync(packPath)) {
+    throw new Error("插件包不完整：缺少本机导入引擎。请重新执行 npx beauticode-dsh。");
+  }
+  const { stageEngineInto } = await import(pathToFileURL(packPath).href);
+  await stageEngineInto(dest);
+}
+
+async function install(opts) {
+  const dest = path.resolve(opts.pluginHome);
+  const dshHome = path.resolve(opts.dshHome);
+  const webProfile = path.join(dshHome, "profiles", "web");
+  const webPatch = path.join(webProfile, "cordis.patch.yml");
+  const webPackage = path.join(webProfile, "package.json");
+  const homePatch = path.join(dshHome, "cordis.patch.yml");
+
+  await fsp.mkdir(dest, { recursive: true });
+  await copyPackage(dest);
+  await ensureEngine(dest);
+  const indexFile = path.join(dest, "index.mjs");
+  if (!fs.existsSync(indexFile)) {
+    throw new Error(`缺少插件入口：${indexFile}`);
+  }
+
+  if (fs.existsSync(webPackage)) {
+    await writePatch(webPatch, packageInsert());
+    if (fs.existsSync(homePatch)) {
+      const homeRaw = await fsp.readFile(homePatch, "utf8");
+      if (hasBridge(homeRaw)) await removePatch(homePatch);
+    }
+    console.log(`已写入 ${webPatch}`);
+    console.log(`插件已复制到 ${dest}`);
+    console.log("请自己运行：npx @deepseek-ai/dsh web");
+    return { dest, patch: webPatch };
+  }
+
+  await fsp.mkdir(dshHome, { recursive: true });
+  await writePatch(homePatch, fileUriInsert(toFileUri(indexFile)));
+  console.log(`DSH web profile 还不存在，已写入 ${homePatch}`);
+  console.log(`插件已复制到 ${dest}`);
+  console.log("请自己运行：npx @deepseek-ai/dsh web");
+  return { dest, patch: homePatch };
+}
+
+async function uninstall(opts) {
+  const dshHome = path.resolve(opts.dshHome);
+  const removed = [];
+  if (await removePatch(path.join(dshHome, "profiles", "web", "cordis.patch.yml"))) {
+    removed.push("web patch");
+  }
+  if (await removePatch(path.join(dshHome, "cordis.patch.yml"))) {
+    removed.push("home patch");
+  }
+  const dest = path.resolve(opts.pluginHome);
+  if (fs.existsSync(dest)) {
+    await fsp.rm(dest, { recursive: true, force: true });
+    removed.push(dest);
+  }
+  console.log(removed.length ? `已移除：${removed.join("、")}` : "没有可移除的 beautiCode 插件接线。");
+  return { removed };
+}
+
+export async function runCli(argv = process.argv.slice(2)) {
+  const dshHome = argValue(argv, "--dsh-home") || defaultDshHome();
+  const pluginHome =
+    argValue(argv, "--plugin-home") || path.join(defaultDataRoot(), "plugin");
+  const opts = { dshHome, pluginHome };
+  if (argv.includes("--remove")) return uninstall(opts);
+  return install(opts);
+}
+
+const launchedDirectly =
+  Boolean(process.argv[1]) &&
+  pathToFileURL(path.resolve(process.argv[1])).href.toLowerCase() ===
+    import.meta.url.toLowerCase();
+if (launchedDirectly) {
+  runCli().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  });
+}

package/client.js

@@ -0,0 +1,370 @@
+(() => {
+  "use strict";
+  if (window.__beauticodeBridgeLoaded) return;
+  window.__beauticodeBridgeLoaded = true;
+  window.__beauticodeBridgeVersion = 4;
+
+  const clientId =
+    globalThis.crypto?.randomUUID?.() ||
+    `bc-${Date.now().toString(36)}-${Math.random().toString(36).slice(2)}`;
+  const desiredModes = { fish: false, muted: true, tone: "auto" };
+  let activePayload = null;
+  let playbackBlocked = false;
+  const systemDarkMedia = globalThis.matchMedia?.("(prefers-color-scheme: dark)") ?? null;
+  let themeSyncQueued = false;
+
+  const style = document.createElement("style");
+  style.dataset.beauticodeBridge = "true";
+  style.textContent = `
+html[data-bc-active="true"],html[data-bc-active="true"] body{background:transparent!important}
+html[data-bc-active="true"] body{
+  --dsw-alias-bg-base:rgba(17,20,27,.10);
+  --dsw-alias-bg-layer-1:rgba(26,30,39,.28);
+  --dsw-alias-bg-layer-2:rgba(35,40,51,.32);
+  --dsw-alias-bg-overlay:rgba(17,20,27,.12);
+  --dsw-specific-sidebar-fill:rgba(23,27,35,.28);
+}
+html[data-bc-resolved-tone="light"][data-bc-active="true"] body{
+  --dsw-alias-bg-base:rgba(248,250,252,.12);
+  --dsw-alias-bg-layer-1:rgba(255,255,255,.28);
+  --dsw-alias-bg-layer-2:rgba(248,250,252,.32);
+  --dsw-alias-bg-overlay:rgba(255,255,255,.14);
+  --dsw-specific-sidebar-fill:rgba(255,255,255,.28);
+}
+html[data-bc-active="true"]:has(#root [data-phase="active"]) body,
+html[data-bc-active="true"]:has(#root [data-phase="settling"]) body{
+  --dsw-alias-bg-base:rgba(17,20,27,.42);
+  --dsw-alias-bg-layer-1:rgba(26,30,39,.72);
+  --dsw-alias-bg-layer-2:rgba(35,40,51,.80);
+  --dsw-alias-bg-overlay:rgba(17,20,27,.86);
+  --dsw-specific-sidebar-fill:rgba(23,27,35,.78);
+}
+html[data-bc-resolved-tone="light"][data-bc-active="true"]:has(#root [data-phase="active"]) body,
+html[data-bc-resolved-tone="light"][data-bc-active="true"]:has(#root [data-phase="settling"]) body{
+  --dsw-alias-bg-base:rgba(248,250,252,.48);
+  --dsw-alias-bg-layer-1:rgba(255,255,255,.74);
+  --dsw-alias-bg-layer-2:rgba(248,250,252,.82);
+  --dsw-alias-bg-overlay:rgba(255,255,255,.86);
+  --dsw-specific-sidebar-fill:rgba(255,255,255,.78);
+}
+#beauticode-bg-stage{position:fixed;inset:0;z-index:0;overflow:hidden;pointer-events:none;background:#11141b}
+#beauticode-bg-stage::after{content:"";position:absolute;inset:0;z-index:2;background:transparent;pointer-events:none}
+html[data-bc-resolved-tone="light"] #beauticode-bg-stage{background:#f8fafc}
+html[data-bc-active="true"]:has(#root [data-phase="active"]) #beauticode-bg-stage::after,
+html[data-bc-active="true"]:has(#root [data-phase="settling"]) #beauticode-bg-stage::after{background:rgba(0,0,0,.42)}
+html[data-bc-resolved-tone="light"][data-bc-active="true"]:has(#root [data-phase="active"]) #beauticode-bg-stage::after,
+html[data-bc-resolved-tone="light"][data-bc-active="true"]:has(#root [data-phase="settling"]) #beauticode-bg-stage::after{background:rgba(255,255,255,.22)}
+html[data-bc-fish="true"] #beauticode-bg-stage::after{background:transparent!important}
+#beauticode-bg-stage img,#beauticode-bg-stage video{position:absolute;inset:0;width:100%;height:100%;object-fit:cover;display:block;pointer-events:none}
+#beauticode-bg-stage img{z-index:0}
+#beauticode-bg-stage video{z-index:1}
+html[data-bc-active="true"] #root{position:relative;z-index:1;background:transparent!important}
+html[data-bc-active="true"] [class*="_fade"]{display:none!important}
+html[data-bc-fish="true"] #root{opacity:0!important;visibility:hidden!important;pointer-events:none!important}
+`;
+  document.head.append(style);
+
+  function dshAppearance() {
+    const body = document.body;
+    if (body?.hasAttribute("data-ds-dark-theme")) return "dark";
+    const scheme = document.documentElement.style.colorScheme;
+    if (scheme === "dark" || scheme === "light") return scheme;
+    return systemDarkMedia?.matches ? "dark" : "light";
+  }
+
+  function resolvedTone() {
+    return dshAppearance();
+  }
+
+  function isDshThemeSynced(tone = resolvedTone()) {
+    return document.documentElement.dataset.bcResolvedTone === tone;
+  }
+
+  function syncDshTheme() {
+    const tone = resolvedTone();
+    document.documentElement.dataset.bcResolvedTone = tone;
+    return isDshThemeSynced(tone);
+  }
+
+  function scheduleDshThemeSync() {
+    if (themeSyncQueued) return;
+    themeSyncQueued = true;
+    queueMicrotask(() => {
+      themeSyncQueued = false;
+      syncDshTheme();
+    });
+  }
+
+  const themeObserver = new MutationObserver(scheduleDshThemeSync);
+  themeObserver.observe(document.documentElement, {
+    attributes: true,
+    attributeFilter: ["style"],
+  });
+  if (document.body) {
+    themeObserver.observe(document.body, {
+      attributes: true,
+      attributeFilter: ["data-ds-dark-theme"],
+    });
+  }
+  systemDarkMedia?.addEventListener("change", () => {
+    if (desiredModes.tone === "auto") {
+      syncDshTheme();
+      void acknowledgeMode();
+    }
+  });
+  syncDshTheme();
+
+  function stage() {
+    let node = document.getElementById("beauticode-bg-stage");
+    if (!node) {
+      node = document.createElement("div");
+      node.id = "beauticode-bg-stage";
+      document.body.prepend(node);
+    }
+    return node;
+  }
+
+  /**
+   * Fail closed on DSH DOM drift: the injected CSS depends on `#root`.
+   * If the shell no longer exposes it, report a clear error through the
+   * render ack instead of silently painting a broken page.
+   */
+  function dshStructureIssue() {
+    if (!document.getElementById("root")) {
+      return "DSH 页面结构不兼容：未找到 #root。";
+    }
+    return null;
+  }
+
+  function activeVideo() {
+    return document.querySelector("#beauticode-bg-stage video");
+  }
+
+  async function postAck(body) {
+    await fetch("/__beauticode/ack", {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify({ clientId, ...body }),
+    }).catch(() => {});
+  }
+
+  function playbackSnapshot(video) {
+    if (!(video instanceof HTMLVideoElement)) return null;
+    return {
+      currentTime: Number.isFinite(video.currentTime) ? Math.max(0, video.currentTime) : 0,
+      duration: Number.isFinite(video.duration) ? Math.max(0, video.duration) : 0,
+      hasVideo: true,
+      muted: video.muted,
+      paused: video.paused,
+      blocked: playbackBlocked,
+    };
+  }
+
+  async function acknowledgeRender(payload, ok, visible, error = null) {
+    await postAck({
+      kind: "render",
+      generation: payload.generation,
+      media: payload.media,
+      ok,
+      visible,
+      error,
+      playback: payload.media === "video" ? playbackSnapshot(activeVideo()) : null,
+    });
+  }
+
+  async function acknowledgeMode() {
+    const video = activeVideo();
+    const effectiveTone = resolvedTone();
+    await postAck({
+      kind: "mode",
+      fish: document.documentElement.dataset.bcFish === "true",
+      muted: video instanceof HTMLVideoElement ? video.muted : desiredModes.muted,
+      tone: document.documentElement.dataset.bcTone || "dark",
+      resolvedTone: effectiveTone,
+      themeSynced: isDshThemeSynced(effectiveTone),
+      blocked: playbackBlocked,
+    });
+  }
+
+  function loadImage(url) {
+    const image = new Image();
+    image.alt = "";
+    image.crossOrigin = "anonymous";
+    image.decoding = "async";
+    return new Promise((resolve, reject) => {
+      image.onload = () => resolve(image);
+      image.onerror = () => reject(new Error("图片加载失败"));
+      image.src = url;
+    });
+  }
+
+  function waitForVideo(video) {
+    if (video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA) return Promise.resolve();
+    return new Promise((resolve, reject) => {
+      const done = () => {
+        cleanup();
+        resolve();
+      };
+      const failed = () => {
+        cleanup();
+        reject(new Error("MP4 加载或解码失败"));
+      };
+      const cleanup = () => {
+        video.removeEventListener("loadeddata", done);
+        video.removeEventListener("error", failed);
+      };
+      video.addEventListener("loadeddata", done, { once: true });
+      video.addEventListener("error", failed, { once: true });
+    });
+  }
+
+  function seekVideo(video, value) {
+    const requested = Number(value);
+    const duration = Number(video.duration);
+    const safe =
+      Number.isFinite(requested) &&
+      requested >= 0 &&
+      (!Number.isFinite(duration) || duration <= 0 || requested < duration)
+        ? requested
+        : 0;
+    try {
+      video.currentTime = safe;
+    } catch {
+      video.currentTime = 0;
+    }
+  }
+
+  async function playWithPreference(video) {
+    playbackBlocked = false;
+    video.muted = desiredModes.muted;
+    try {
+      await video.play();
+    } catch (error) {
+      if (desiredModes.muted) throw error;
+      playbackBlocked = true;
+      video.muted = true;
+      await video.play();
+    }
+  }
+
+  function syncGallery(payload) {
+    const on = payload?.atmosphere?.preset === "gallery";
+    globalThis.BeauticodeAtmosphere?.setWindowMode?.(on ? "on" : "closed");
+  }
+
+  async function applyBackground(payload) {
+    if (!Number.isSafeInteger(payload?.generation)) return;
+    activePayload = payload;
+    document.documentElement.dataset.bcGeneration = String(payload.generation);
+    syncGallery(payload);
+    if (payload.media === "clear") {
+      desiredModes.fish = false;
+      playbackBlocked = false;
+      document.documentElement.removeAttribute("data-bc-active");
+      document.documentElement.removeAttribute("data-bc-media");
+      document.documentElement.removeAttribute("data-bc-fish");
+      document.getElementById("beauticode-bg-stage")?.remove();
+      if (document.documentElement.dataset.bcGallery === "true") {
+        document.documentElement.dataset.bcActive = "true";
+      }
+      await acknowledgeRender(payload, true, false);
+      await acknowledgeMode();
+      return;
+    }
+    if (typeof payload.imageUrl !== "string") return;
+    const structureIssue = dshStructureIssue();
+    if (structureIssue) {
+      await acknowledgeRender(payload, false, false, structureIssue);
+      return;
+    }
+    try {
+      const image = await loadImage(payload.imageUrl);
+      if (activePayload !== payload) return;
+      const node = stage();
+      if (payload.media === "image") {
+        playbackBlocked = false;
+        node.replaceChildren(image);
+        document.documentElement.dataset.bcActive = "true";
+        document.documentElement.dataset.bcMedia = "image";
+        const visible = image.naturalWidth > 0 && image.naturalHeight > 0;
+        await acknowledgeRender(payload, visible, visible, visible ? null : "图片尺寸无效");
+        await acknowledgeMode();
+        return;
+      }
+      if (payload.media !== "video" || typeof payload.videoUrl !== "string") return;
+      const video = document.createElement("video");
+      video.autoplay = true;
+      video.loop = true;
+      video.playsInline = true;
+      video.preload = "auto";
+      video.poster = payload.imageUrl;
+      video.crossOrigin = "anonymous";
+      video.src = payload.videoUrl;
+      node.replaceChildren(image, video);
+      await waitForVideo(video);
+      if (activePayload !== payload) return;
+      seekVideo(video, payload.startAt);
+      await playWithPreference(video);
+      document.documentElement.dataset.bcActive = "true";
+      document.documentElement.dataset.bcMedia = "video";
+      const visible = video.readyState >= HTMLMediaElement.HAVE_CURRENT_DATA && !video.paused;
+      await acknowledgeRender(payload, visible, visible, visible ? null : "视频未开始播放");
+      await acknowledgeMode();
+    } catch (error) {
+      if (activePayload !== payload) return;
+      await acknowledgeRender(
+        payload,
+        false,
+        false,
+        error instanceof Error ? error.message : String(error),
+      );
+    }
+  }
+
+  async function applyModes(payload) {
+    if (typeof payload.fish === "boolean") desiredModes.fish = payload.fish;
+    if (typeof payload.muted === "boolean") desiredModes.muted = payload.muted;
+    if (["dark", "light", "auto"].includes(payload.tone)) desiredModes.tone = payload.tone;
+    document.documentElement.dataset.bcTone = desiredModes.tone;
+    syncDshTheme();
+    if (desiredModes.fish && document.documentElement.dataset.bcActive === "true") {
+      document.documentElement.dataset.bcFish = "true";
+    } else {
+      document.documentElement.removeAttribute("data-bc-fish");
+    }
+    const video = activeVideo();
+    if (video instanceof HTMLVideoElement) {
+      try {
+        await playWithPreference(video);
+      } catch {
+        playbackBlocked = desiredModes.muted === false;
+      }
+      if (activePayload?.media === "video") {
+        await acknowledgeRender(activePayload, video.readyState >= 2 && !video.paused, true);
+      }
+    } else {
+      playbackBlocked = false;
+    }
+    await acknowledgeMode();
+  }
+
+  const events = new EventSource(
+    `/__beauticode/events?clientId=${encodeURIComponent(clientId)}`,
+  );
+  events.onmessage = (event) => {
+    try {
+      const payload = JSON.parse(event.data);
+      if (payload?.type === "mode") void applyModes(payload);
+      else if (payload?.type === "apply") void applyBackground(payload);
+    } catch {
+      /* EventSource will continue with the next valid frame. */
+    }
+  };
+
+  setInterval(() => {
+    const video = activeVideo();
+    if (activePayload?.media === "video" && video instanceof HTMLVideoElement) {
+      void acknowledgeRender(activePayload, video.readyState >= 2 && !video.paused, true);
+    }
+  }, 1_000);
+})();