dsh-long-plugins 2.4.6 → 2.6.0

package/lib/index.js

@@ -718,67 +718,6 @@ async function officePreviewHtml(name, buffer) {
 }
 
 /** 仅保留毛玻璃配置允许字段并 clamp，避免写入任意/超大内容。背景图只收 data:image/*;base64 且限 2MB。 */
-function sanitizeGlass(input) {
-  const out = {};
-  if ("enabled" in input) out.enabled = input.enabled === true;
-  if ("blur" in input) { const n = Number(input.blur); out.blur = Number.isFinite(n) ? Math.max(0, Math.min(80, Math.round(n))) : undefined; }
-  if ("mask" in input) { const n = Number(input.mask); out.mask = Number.isFinite(n) ? Math.max(0, Math.min(0.95, n)) : undefined; }
-  if ("color" in input) out.color = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(String(input.color)) ? String(input.color) : undefined;
-  const sanitizeUri = (v) => { const s = String(v ?? ""); return (/^data:image\/(png|jpe?g|webp|gif);base64,/.test(s) && s.length <= 2 * 1024 * 1024 + 256) ? s : undefined; };
-  if ("bgImage" in input) out.bgImage = sanitizeUri(input.bgImage);
-  if ("bgColor" in input) out.bgColor = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(String(input.bgColor)) ? String(input.bgColor) : undefined;
-  if ("bgMask" in input) { const n = Number(input.bgMask); out.bgMask = Number.isFinite(n) ? Math.max(0, Math.min(0.95, n)) : undefined; }
-  if ("bgBlur" in input) { const n = Number(input.bgBlur); out.bgBlur = Number.isFinite(n) ? Math.max(0, Math.min(80, n)) : undefined; }
-  if ("bgOpacity" in input) { const n = Number(input.bgOpacity); out.bgOpacity = Number.isFinite(n) ? Math.max(0, Math.min(1, n)) : undefined; }
-  // 背景罩(整页背景图上叠的罩色)：浅/深主题各一套 color + mask(罩强度)
-  if (input.bgTint && typeof input.bgTint === "object") {
-    const bt = {};
-    for (const key of ["light", "dark"]) {
-      const z = input.bgTint[key];
-      if (z && typeof z === "object") {
-        const o = {};
-        if ("color" in z) o.color = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(String(z.color)) ? String(z.color) : "#1a2332";
-        if ("mask" in z) { const n = Number(z.mask); o.mask = Number.isFinite(n) ? Math.max(0, Math.min(0.95, n)) : 0.28; }
-        bt[key] = Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
-      }
-    }
-    if (Object.keys(bt).length) out.bgTint = bt;
-  }
-  // 输入框(独立于 zone.input 的 DSH 玻璃变量)：浅/深主题各一套 custom color + opacity(1=实底)。color 空串=用主题原生色
-  if (input.inputBox && typeof input.inputBox === "object") {
-    const ib = {};
-    for (const key of ["light", "dark"]) {
-      const z = input.inputBox[key];
-      if (z && typeof z === "object") {
-        const o = {};
-        const c = z.color;
-        if (c === "" || c === null || c === undefined) o.color = "";
-        else o.color = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(String(c)) ? String(c) : "";
-        if ("opacity" in z) { const n = Number(z.opacity); o.opacity = Number.isFinite(n) ? Math.max(0, Math.min(1, n)) : 1; }
-        ib[key] = Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
-      }
-    }
-    if (Object.keys(ib).length) out.inputBox = ib;
-  }
-  // 会话区/输入区各自独立罩色+罩强度
-  if (input.zone && typeof input.zone === "object") {
-    const zo = {};
-    for (const key of ["session", "input"]) {
-      const z = input.zone[key];
-      if (z && typeof z === "object") {
-        const o = {};
-        if ("enabled" in z) o.enabled = z.enabled === true;
-        if ("color" in z) o.color = /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{6})$/.test(String(z.color)) ? String(z.color) : undefined;
-        if ("mask" in z) { const n = Number(z.mask); o.mask = Number.isFinite(n) ? Math.max(0, Math.min(0.95, n)) : undefined; }
-        if ("opacity" in z) { const n = Number(z.opacity); o.opacity = Number.isFinite(n) ? Math.max(0, Math.min(1, n)) : undefined; }
-        zo[key] = Object.fromEntries(Object.entries(o).filter(([, v]) => v !== undefined));
-      }
-    }
-    if (Object.keys(zo).length) out.zone = zo;
-  }
-  return Object.fromEntries(Object.entries(out).filter(([, v]) => v !== undefined));
-}
-
 export function createHandlers(options = {}) {
   const root = resolve(options.root || resolveUploadRoot());
   const maxFileBytes = positiveInteger(options.maxFileBytes, resolveMaxFileBytes());
@@ -1134,6 +1073,10 @@ export function createHandlers(options = {}) {
         // Markdown → 直接渲染成 HTML（真实效果），失败回退源码文本。
         editable = true; rawText = buffer.toString("utf8");
         body = `<article class="md">${markdownToHtml(rawText)}</article>`;
+      } else if (/\.(html?|xhtml)$/i.test(name)) {
+        // HTML/HTM → 直接渲染成实际效果(iframe + srcdoc, 保留其样式/脚本)
+        editable = true; rawText = buffer.toString("utf8");
+        body = `<iframe class="html" srcDoc="${escapeHtml(rawText)}"></iframe>`;
       } else if (/\.(json|ya?ml|py|js|mjs|cjs|ts|sh|css|html?|xml|csv|ini|conf|env|toml|sql|rs|go|c|h|cpp|java|kt|swift|rb|php|vue|jsx|tsx)$/i.test(name)) {
         editable = true; rawText = buffer.toString("utf8");
         body = `<pre class="text">${escapeHtml(rawText)}</pre>`;
@@ -1672,160 +1615,6 @@ window.addEventListener('resize',function(){ try{ if(fitMode) zoomFit(); else ap
     }
   };
 
-  // ---- 毛玻璃界面 (glass UI) 配置：读写 ~/.dsh-long-plugins/glass.json ----
-  // 背景图以 data-URI 存进配置，随配置持久化。enabled=总开关；blur=磨砂模糊；mask=整页罩强度；
-  // color=叠加/罩色；bgImage=共用背景图。顶栏/左栏的"罩"与整页共用 mask+color（不再单独存，简化）。
-  const GLASS_DEFAULTS = {
-    enabled: false, blur: 20, bgImage: "", bgColor: "#1a2332", bgMask: 0.28,
-    bgTint: { light: { color: "#1a2332", mask: 0.28 }, dark: { color: "#1a2332", mask: 0.28 } },
-    inputBox: { light: { color: "", opacity: 1 }, dark: { color: "", opacity: 1 } },
-    zone: { session: { color: "#1a2332", mask: 0.45, opacity: 0.5 }, input: { color: "#1a2332", mask: 0.6, opacity: 0.55 } },
-    // 各模块开关(「dsh-long」设置区)：false=禁用该模块功能(避免与 DSH 新版自带功能冲突/按需关闭)
-    modules: { glass: false, uploadAttach: true, uploadDragDrop: true, uploadPaste: true, uploadPreview: true, skillDocs: true, balance: true, mobile: true, workspace: true, turnRuler: false },
-  };
-  const glassDir = resolve(homedir(), ".dsh-long-plugins");
-  const glassFile = join(glassDir, "glass.json");
-  const bgDir = join(glassDir, "backgrounds");
-  const currentBgFile = join(bgDir, "current.uri");
-  // 背景图文件引用: 配置里 bgImage 为 "current"(存 bgDir/current.uri) 或 ""(无) ；不再内嵌大图 data-URI
-  const decodeDataUri = (s) => { const m = /^data:(image\/[a-zA-Z0-9.+-]+);base64,([A-Za-z0-9+/=]+)$/.exec(String(s || "")); return m ? { mime: m[1], base64: m[2] } : null; };
-  const bgImageUrl = (cfg) => (cfg.bgImage === "current") ? "/api/dsh-uploads/glass-background" : "";
-  // 只保留当前背景图(current.uri), 删除其它历史图片文件(旧图清理)
-  async function pruneBackgrounds() {
-    try {
-      const names = await readdir(bgDir);
-      for (const n of names) {
-        if (n === "current.uri" || !n.endsWith(".uri")) continue;
-        try { await unlink(join(bgDir, n)); } catch (_) {}
-      }
-    } catch (_) {}
-  }
-  async function readGlassJSON() {
-    try {
-      const raw = JSON.parse(await readFile(glassFile, "utf8"));
-      const cfg = { ...GLASS_DEFAULTS, ...(raw && typeof raw === "object" ? raw : {}) };
-      // 迁移旧版: bgImage 是内嵌 data-URI(大图) → 存成文件 + 改引用
-      if (typeof cfg.bgImage === "string" && cfg.bgImage.startsWith("data:image/")) {
-        try {
-          await mkdir(bgDir, { recursive: true, mode: 0o700 });
-          await writeFile(currentBgFile, cfg.bgImage, "utf8");
-          cfg.bgImage = "current";
-          await writeFile(glassFile, JSON.stringify(cfg, null, 2), "utf8");
-        } catch (_) {}
-      }
-      // 插件升级时：版本号变化 → 默认关闭「会话导航」「RA-Span」(避免与 DSH 新版自带功能冲突)
-      if (PLUGIN_VERSION && cfg._pluginVersion !== PLUGIN_VERSION) {
-        try {
-          cfg.modules = { glass: false, uploadAttach: true, uploadDragDrop: true, uploadPaste: true, uploadPreview: true, skillDocs: true, balance: true, mobile: true, workspace: true, turnRuler: false, ...(cfg.modules || {}) };
-          cfg.modules.glass = false;
-          cfg.modules.turnRuler = false;
-          cfg._pluginVersion = PLUGIN_VERSION;
-          await writeFile(glassFile, JSON.stringify(cfg, null, 2), "utf8");
-        } catch (_) {}
-      }
-      return cfg;
-    } catch { return { ...GLASS_DEFAULTS }; }
-  }
-  const glassConfig = async (req, res) => {
-    try {
-      requireTrusted(req);
-      if (req.method === "GET" || req.method === "HEAD") {
-        const cfg = await readGlassJSON();
-        // 背景图只返回"是否存在 + 图片 URL", 不再返回内嵌大图 data-URI(减小响应)
-        let imgMeta = { present: false, bytes: 0 };
-        let imgUrl = "";
-        if (cfg.bgImage === "current") {
-          imgUrl = "/api/dsh-uploads/glass-background";
-          try { imgMeta = { present: true, bytes: (await stat(currentBgFile)).size || 0 }; } catch (_) { imgMeta = { present: true, bytes: 0 }; }
-        }
-        sendJson(res, 200, {
-          found: true,
-          cfg: {
-            enabled: cfg.enabled, blur: cfg.blur,
-            session: cfg.zone?.session || { enabled: true, color: "#1a2332", mask: 0.45, opacity: 0.5 },
-            input: cfg.zone?.input || { color: "#1a2332", mask: 0.6, opacity: 0.55 },
-            inputBox: cfg.inputBox || { light: { color: "", opacity: 1 }, dark: { color: "", opacity: 1 } },
-            bgTint: cfg.bgTint || { light: { color: "#1a2332", mask: 0.28 }, dark: { color: "#1a2332", mask: 0.28 } },
-            bgColor: cfg.bgColor || "#1a2332", bgMask: cfg.bgMask ?? 0.28,
-            bgBlur: cfg.bgBlur ?? 0, bgOpacity: cfg.bgOpacity ?? 1,
-            turnRuler: (cfg.modules && cfg.modules.turnRuler) !== false,
-            modules: { glass: false, uploadAttach: true, uploadDragDrop: true, uploadPaste: true, uploadPreview: true, skillDocs: true, balance: true, mobile: true, workspace: true, turnRuler: false, ...(cfg.modules || {}) },
-            bgImage: imgMeta,
-          },
-          bgImage: imgMeta,
-          bgImageUrl: imgUrl,
-        });
-        return;
-      }
-      if (req.method === "POST") {
-        const body = await readJsonBody(req, 4 * 1024 * 1024);
-        const current = await readGlassJSON();
-        const next = { ...current, ...sanitizeGlass(typeof body === "object" && body !== null ? body : {}) };
-        // 各模块开关表：body.modules 里有的键按布尔合并
-        if (body && typeof body.modules === "object" && body.modules !== null) {
-          const m = { glass: true, uploadAttach: true, uploadDragDrop: true, uploadPaste: true, uploadPreview: true, skillDocs: true, balance: true, mobile: true, workspace: true, turnRuler: true, ...(current.modules || {}) };
-          for (const k of Object.keys(body.modules)) m[k] = body.modules[k] !== false;
-          next.modules = m;
-        }
-        // 背景图改为"文件 + 引用": 用户上传的 data-URI 存入 current.uri, 配置只存 "current" 引用
-        if (typeof next.bgImage === "string" && next.bgImage.startsWith("data:image/")) {
-          try {
-            await mkdir(bgDir, { recursive: true, mode: 0o700 });
-            await writeFile(currentBgFile, next.bgImage, "utf8");
-            next.bgImage = "current";
-          } catch (_) { next.bgImage = ""; }
-        } else if ("bgImage" in body && body.bgImage === "") {
-          next.bgImage = ""; // 显式清除
-          try { await unlink(currentBgFile); } catch (_) {}
-        }
-        // 只保留当前背景图, 删除历史旧图
-        await pruneBackgrounds();
-        await mkdir(glassDir, { recursive: true, mode: 0o700 });
-        await writeFile(glassFile, JSON.stringify(next, null, 2), "utf8");
-        sendJson(res, 200, { ok: true, saved: true });
-        return;
-      }
-      methodNotAllowed(res, ["GET", "HEAD", "POST"]);
-    } catch (error) {
-      sendError(res, error, onError);
-    }
-  };
-  // 背景图历史（供设置面板"选择旧图"）：GET 列出，GET ?name= 返回对应 data-URI
-  const glassBackgrounds = async (req, res) => {
-    try {
-      requireTrusted(req);
-      const url = new URL(req.url, "http://x");
-      const name = url.searchParams.get("name");
-      if (name) {
-        if (!/^[\w.:-]+\.uri$/.test(name)) { sendError(res, new Error("bad name"), onError); return; }
-        try { const buf = await readFile(join(bgDir, name)); res.writeHead(200, { "content-type": "text/plain; charset=utf-8", "cache-control": "no-store" }); res.end(buf); return; }
-        catch { sendJson(res, 404, { error: "not found" }); return; }
-      }
-      let list = [];
-      // 只保留当前背景图, 删除历史旧图; 列表排除当前图
-      try { await pruneBackgrounds(); } catch (_) {}
-      try { list = (await readdir(bgDir)).filter((n) => n.endsWith(".uri") && n !== "current.uri").sort().reverse().slice(0, 30); } catch (_) {}
-      sendJson(res, 200, { list });
-    } catch (error) {
-      sendError(res, error, onError);
-    }
-  };
-  // 返回当前背景图（文件存的 data-URI 解码为真实图片）
-  const glassBackground = async (req, res) => {
-    try {
-      requireTrusted(req);
-      const cfg = await readGlassJSON();
-      if (cfg.bgImage !== "current") { sendJson(res, 404, { error: "no background" }); return; }
-      const buf = await readFile(currentBgFile, "utf8");
-      const d = decodeDataUri(buf);
-      if (!d) { sendJson(res, 404, { error: "bad image" }); return; }
-      const bytes = Buffer.from(d.base64, "base64");
-      res.writeHead(200, { "content-type": d.mime, "cache-control": "no-store", "x-content-type-options": "nosniff" });
-      res.end(bytes);
-    } catch (error) {
-      sendError(res, error, onError);
-    }
-  };
   // 补丁状态：只读检测 DSH 核心各补丁的「已打 / 未打 / 原生无需」，供 dsh-long 设置区显示
   const patchStatus = async (req, res) => {
     try {
@@ -1859,7 +1648,42 @@ window.addEventListener('resize',function(){ try{ if(fitMode) zoomFit(); else ap
     }
   };
 
-  return { root, maxFileBytes, totalMaxBytes, api, download, preview, workspaceList, workspaceFile, workspacePreview, workspaceBrowse, workspaceDelete, workspaceRename, workspaceSave, docxPreviewPage, docxPreviewAsset, pptxPreviewPage, xlsxPreviewPage, xlsxPreviewAsset, glassConfig, glassBackgrounds, glassBackground, patchStatus };
+  // 各模块开关（dsh-long 设置区）：读写 ~/.dsh-long-plugins/modules.json（独立于 dsh-span 的 RA-Span 配置）。
+  const MODULES_DEFAULTS = { uploadAttach: true, uploadDragDrop: true, uploadPaste: true, uploadPreview: true, skillDocs: true, balance: true, mobile: true, workspace: true, turnRuler: false };
+  const modulesFile = join(homedir(), ".dsh-long-plugins", "modules.json");
+  async function readModulesJSON() {
+    try {
+      const raw = JSON.parse(await readFile(modulesFile, "utf8"));
+      return { ...MODULES_DEFAULTS, ...(raw && typeof raw === "object" && raw.modules ? raw.modules : {}) };
+    } catch { return { ...MODULES_DEFAULTS }; }
+  }
+  const modulesConfig = async (req, res) => {
+    try {
+      requireTrusted(req);
+      if (req.method === "GET" || req.method === "HEAD") {
+        const modules = await readModulesJSON();
+        sendJson(res, 200, { ok: true, cfg: { modules } });
+        return;
+      }
+      if (req.method === "POST") {
+        const body = await readJsonBody(req, 1024 * 1024);
+        const current = await readModulesJSON();
+        const next = { ...current };
+        if (body && typeof body.modules === "object" && body.modules !== null) {
+          for (const k of Object.keys(body.modules)) next[k] = body.modules[k] !== false;
+        }
+        await mkdir(join(homedir(), ".dsh-long-plugins"), { recursive: true, mode: 0o700 });
+        await writeFile(modulesFile, JSON.stringify({ modules: next }, null, 2), "utf8");
+        sendJson(res, 200, { ok: true, saved: true });
+        return;
+      }
+      methodNotAllowed(res, ["GET", "HEAD", "POST"]);
+    } catch (error) {
+      sendError(res, error, onError);
+    }
+  };
+
+  return { root, maxFileBytes, totalMaxBytes, api, download, preview, workspaceList, workspaceFile, workspacePreview, workspaceBrowse, workspaceDelete, workspaceRename, workspaceSave, docxPreviewPage, docxPreviewAsset, pptxPreviewPage, xlsxPreviewPage, xlsxPreviewAsset, patchStatus, modulesConfig };
 }
 
 /** 人类可读文件大小。 */
@@ -2553,6 +2377,7 @@ function previewPageHtml(name, rel, size, downloadHref, body, inlineHref = "", e
   body.maximized .md { max-width:none; }
   .image { max-width:100%; border-radius:8px; }
   .pdf { display:block; width:100%; height:86vh; border:1px solid var(--lp-border); border-radius:8px; background:#fff; }
+  .html { display:block; width:100%; height:86vh; border:1px solid var(--lp-border); border-radius:8px; background:#fff; }
   .office { background:#fff; color:#111; border-radius:8px; padding:16px; overflow:auto; }
   .unsupported { color:#f59e0b; text-align:center; padding:40px 0; }
   /* 放大模式：顶栏常驻（固定悬浮），内容占满视口、PDF 全高 */
@@ -2560,6 +2385,7 @@ function previewPageHtml(name, rel, size, downloadHref, body, inlineHref = "", e
   body.maximized .content { max-width:none; padding:0; margin:0; height:100vh; padding-top:53px; }
   body.maximized .md { padding:24px 32px 48px; max-width:820px; margin:0 auto; }
   body.maximized .pdf { height:calc(100vh - 53px); border:none; border-radius:0; }
+  body.maximized .html { height:calc(100vh - 53px); border:none; border-radius:0; }
   body.maximized .text { height:calc(100vh - 53px); border:none; border-radius:0; overflow:auto; }
   body.maximized .office { height:calc(100vh - 53px); overflow:auto; }
   body.maximized .image { max-width:100vw; max-height:100vh; object-fit:contain; }
@@ -2644,72 +2470,6 @@ export async function apply(ctx, config = {}) {
 
   const handlers = createHandlers({ trustedHosts, onError, excludedWorkspaceNames: config.excludedWorkspaceNames });
 
-  // ---- md2docx 工具: Markdown → Word (.docx, 带页码) ----
-  // 调用 md2docx.py (pandoc-free, python-docx + 页脚 PAGE 字段)。
-  // 默认脚本随插件包分发（lib/md2docx.py），换机器也可靠；可用 config.md2docxScript 覆盖。
-  const PACKAGE_DIR = dirname(fileURLToPath(import.meta.url));
-  const MD2DOCX_SCRIPT = resolve(config.md2docxScript ?? join(PACKAGE_DIR, "md2docx.py"));
-  const runScript = (script, args) => new Promise((resolvePromise) => {
-    const child = spawn("python3", [script, ...args], { stdio: ["ignore", "pipe", "pipe"] });
-    let stdout = "", stderr = "";
-    child.stdout.on("data", (d) => { stdout += d.toString(); });
-    child.stderr.on("data", (d) => { stderr += d.toString(); });
-    child.on("error", (error) => resolvePromise({ ok: false, error: String(error), stdout, stderr }));
-    child.on("close", (code) => resolvePromise({ ok: code === 0, code, stdout, stderr }));
-  });
-  ctx.tools.register(defineTool({
-    name: "md2docx",
-    description: "Convert a Markdown file to a styled Word (.docx) document with a page-number footer. Ships a bundled python-docx script (lib/md2docx.py) that renders headings, tables, bold/italic, and lists; the docx includes a footer '第 N 页' field that updates when opened in Word or exported to PDF. Requires python3 and python-docx installed on the host. Override the script path via config.md2docxScript if needed.",
-    parameters: {
-      input: {
-        type: "string",
-        required: true,
-        description: "Absolute path to the input .md file."
-      },
-      output: {
-        type: "string",
-        description: "Optional absolute path for the output .docx. Defaults to the input path with a .docx extension."
-      }
-    },
-    output: {
-      schema: {
-        type: "object",
-        additionalProperties: false,
-        properties: {
-          ok: { type: "boolean", required: true },
-          docxPath: { type: "string" },
-          error: { type: "string" }
-        }
-      },
-      render: (_args, value) => [{
-        type: "text",
-        text: value && value.ok === true
-          ? `已生成 Word 文档：${value.docxPath}\n（含页码页脚，Word/另存 PDF 时自动更新）`
-          : `md2docx 失败：${value?.error ?? "未知错误"}`
-      }]
-    },
-    // 声明交付物：DSH 从 presentCall 的 locations 识别本工具产出的文件，
-    // 从而把 docx 渲染成可点击的交付物卡片（消息里的文件引用也能打开）。
-    presentCall: (args) => {
-      const inPath = resolve(String(args.input ?? ""));
-      const outPath = args.output ? resolve(String(args.output)) : inPath.replace(/\.md$/i, ".docx");
-      return {
-        card: "generic",
-        title: "md2docx",
-        kind: "edit",
-        locations: [{ path: outPath }]
-      };
-    },
-    async execute(args) {
-      const inPath = resolve(String(args.input ?? ""));
-      const outPath = args.output ? resolve(String(args.output)) : inPath.replace(/\.md$/i, ".docx");
-      const result = await runScript(MD2DOCX_SCRIPT, [inPath, outPath]);
-      if (!result.ok) {
-        return { ok: false, error: (result.stderr || result.stdout || String(result.error)).trim() || `md2docx failed (exit ${result.code})` };
-      }
-      return { ok: true, docxPath: outPath };
-    }
-  }));
 
   await sweepUploadTemps(handlers.root);
 
@@ -2784,29 +2544,16 @@ export async function apply(ctx, config = {}) {
   }), "dsh-long-plugins: xlsx-preview vendor assets");
 
   ctx.effect(() => ctx.webServer.register({
-    kind: "exact",
-    path: "/api/dsh-uploads/glass-config",
-    handler: handlers.glassConfig,
-  }), "dsh-long-plugins: glass-ui config route");
-
-  ctx.effect(() => ctx.webServer.register({
-    kind: "exact",
-    path: "/api/dsh-uploads/glass-backgrounds",
-    handler: handlers.glassBackgrounds,
-  }), "dsh-long-plugins: glass-ui backgrounds route");
-
-  ctx.effect(() => ctx.webServer.register({
-    kind: "exact",
-    path: "/api/dsh-uploads/glass-background",
-    handler: handlers.glassBackground,
-  }), "dsh-long-plugins: glass-ui background image route");
-
-  ctx.effect(() => ctx.webServer.register({
-    kind: "exact",
     path: "/api/dsh-uploads/patch-status",
     handler: handlers.patchStatus,
   }), "dsh-long-plugins: patch status route");
 
+  ctx.effect(() => ctx.webServer.register({
+    kind: "exact",
+    path: "/api/dsh-uploads/modules-config",
+    handler: handlers.modulesConfig,
+  }), "dsh-long-plugins: modules config route");
+
   ctx.effect(() => ctx.webServer.register({
     kind: "exact",
     path: "/api/dsh-uploads/workspace-browse",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-long-plugins",
-  "version": "2.4.6",
-  "description": "Merged DSH web plugins: upload manager (drag-and-drop attach any file to the message), workspace output files, skill docs, account balance, Markdown-to-Word (md2docx), and polished file preview (Word & PowerPoint real preview with zoom/pan, rendered Markdown), plus an auto-repair install for DSH core patches (reverse-proxy WebSocket heartbeat, upgrade relink). | 一个插件整合 DSH Web 的常用增强：上传管理（拖放上传：拖任意文件到会话框直接附加）、工作区「输出文件」面板、技能文档浏览、账户余额显示、Markdown 转 Word（md2docx）、Word/PowerPoint 真实预览（可缩放、翻页）；并自带修复安装，自动重连 DSH 核心补丁（反代 WebSocket 心跳、升级重连）。",
+  "version": "2.6.0",
+  "description": "Merged DSH web plugins: upload manager (drag-and-drop attach any file to the message), workspace output files, skill docs, account balance, and polished file preview (Word & PowerPoint real preview with zoom/pan, rendered Markdown), plus an auto-repair install for DSH core patches (reverse-proxy WebSocket heartbeat, upgrade relink). | 一个插件整合 DSH Web 的常用增强：上传管理（拖放上传：拖任意文件到会话框直接附加）、工作区「输出文件」面板、技能文档浏览、账户余额显示、Word/PowerPoint 真实预览（可缩放、翻页）；并自带修复安装，自动重连 DSH 核心补丁（反代 WebSocket 心跳、升级重连）。Office 读取/生成已独立到 dsh-office-reader；RA-Span 已独立到 dsh-span。",
   "type": "module",
   "license": "MIT",
   "main": "lib/index.js",
@@ -12,7 +12,6 @@
   },
   "files": [
     "lib",
-    "lib/md2docx.py",
     "client",
     "!client/*.bak",
     "cordis.patch.yml",

package/skill/dsh-upgrade/SKILL.md

@@ -91,6 +91,29 @@ fi
 9. 设置面板「技能管理」「上传文件」「输出文件」的 🔍 搜索框：点击后弹出框紧贴按钮下方、滚动不脱离。
 10. **「技能管理」区（全局技能 / 工作区技能两 tab）**：全局技能列 `<DSH_HOME>/skills`；工作区技能扫描工作区根下各子目录的 `.dsh/skills`（无 `.dsh/skills` 则该工作区组为空）。若该区不出现/工作区技能为空，可能 DSH `settings.section` 槽或工作区结构变化——复核。
 
+## 插件依赖 DSH 内部接口（升级脆弱清单）⚠️
+dsh-long-plugins 大量依赖 DSH 内部接口/结构，DSH 升级改动后这些会**静默失效**（不注册/不显示/报错）。升级后逐项复核：
+
+| 依赖 | 用途 | 升级失效表现 |
+|---|---|---|
+| `settings.section` 槽 | 上传文件/输出文件/技能管理/dsh-long/RA-Span 设置区 | 对应设置区不出现 |
+| `conversation.composer.dock` 槽 | 余额 chip | 余额不显示 |
+| `conversation.input.dock` 槽 | 待发送文件栏、拖放/粘贴上传 | 待发送栏/拖放失效 |
+| `conversation.input.left` 槽 | 附件上传（回形针） | 回形针消失 |
+| `conversation.session.header.actions` 槽 | 会话历史/工作区按钮 | 按钮消失 |
+| `shell.overlay` 槽 | 文件浏览器浮层 | 文件浮层打不开 |
+| `data-slot-conversation="..."` 属性 | 余额 chip / dock 样式定位 | 对应样式失效 |
+| `ctx.webServer.register` | 所有路由（上传/工作区/技能/预览/glass/补丁状态） | 路由 404/无响应 |
+| `ctx.inputTriggers.registerSource` | 文件引用 codec（`@`） | 附件引用失效 |
+| `ctx.locale.register` | 多语言 | 文案不翻译 |
+| `window.__ModuleLoader__.load` | 插件客户端加载 | 插件整个不加载 |
+| `useSessions` / 会话 store | 工作区按钮拿 cwd / 当前工作区 | 工作区按钮/当前工作区失效 |
+| 混淆类名 `wSkVaW_/uV2eYG_/o3BgMG_/CY-8Ka_/QWLzLg_/M8wy4a_/lXshSW_/7yHdaG_/VOzbGW_/p-xYUq_/osXY9a_` | RA-Span 玻璃观感/排版 | 观感/配色/排版错(见"RA-Span 升级后需重新校准") |
+| DSH 设置面板 DOM(`VOzbGW` 面板) | 各设置区在其内渲染 | 设置区排版乱 |
+| DSH 核心 `dsh-client-connection` | 心跳补丁(补丁3) | 补丁被覆盖→心跳失效(需重打) |
+
+> 处置：某项失效 → 让用户右键抓新元素 class/槽名/接口，更新插件对应选择器/槽名/调用；或集成 DSH 新 API。**稳定项**：插件自己的路由表、`data-slot` 状态栏(部分)、注入 `<head>` 的 CSS(部分)。
+
 ## 硬性安全边界（必须遵守）
 - **不主动 push / 打 tag / 发 Release**；需要发布版本时停下用 ask_user_question 等确认。
 - 升级会重启 DSH 服务，可能中断当前会话——先向用户说明再执行。

package/lib/md2docx.py

@@ -1,210 +0,0 @@
-#!/usr/bin/env python3
-# -*- coding: utf-8 -*-
-"""Generic Markdown -> styled .docx converter with a page-number footer.
-
-Usage:
-  python3 md2docx.py <input.md> [output.docx]
-
-If output.docx is omitted, it defaults to <input-name>.docx next to the input.
-
-Renders headings (h1-h3), bold/italic inline, tables (pipe syntax),
-ordered/unordered lists, blockquotes, and horizontal rules. Adds a centered
-footer with an auto-updating PAGE field (updates when opened in Word or
-exported to PDF).
-
-Requires: python3 + python-docx (`pip install python-docx`).
-"""
-import re
-import sys
-import os
-
-from docx import Document
-from docx.shared import Pt, RGBColor
-from docx.enum.text import WD_ALIGN_PARAGRAPH
-from docx.enum.table import WD_TABLE_ALIGNMENT
-from docx.oxml.ns import qn
-from docx.oxml import OxmlElement
-
-
-def die(msg):
-    print(f"md2docx: {msg}", file=sys.stderr)
-    sys.exit(1)
-
-
-if len(sys.argv) < 2:
-    die("usage: md2docx.py <input.md> [output.docx]")
-
-SRC = os.path.abspath(sys.argv[1])
-if not os.path.isfile(SRC):
-    die(f"input file not found: {SRC}")
-OUT = (
-    os.path.abspath(sys.argv[2])
-    if len(sys.argv) > 2
-    else os.path.splitext(SRC)[0] + ".docx"
-)
-
-with open(SRC, encoding="utf-8") as f:
-    lines = f.read().splitlines()
-
-
-def add_page_number(paragraph):
-    """Insert an auto-updating '第 N 页' page field into a footer paragraph."""
-    run = paragraph.add_run("第 ")
-    set_east_asia(run)
-    fld = OxmlElement("w:fldChar")
-    fld.set(qn("w:fldCharType"), "begin")
-    instr = OxmlElement("w:instrText")
-    instr.set(qn("xml:space"), "preserve")
-    instr.text = " PAGE "
-    sep = OxmlElement("w:fldChar")
-    sep.set(qn("w:fldCharType"), "separate")
-    t = OxmlElement("w:t")
-    t.text = "1"
-    end = OxmlElement("w:fldChar")
-    end.set(qn("w:fldCharType"), "end")
-    r = paragraph.add_run()
-    set_east_asia(r)
-    for el in (fld, instr, sep, t, end):
-        r._r.append(el)
-    run2 = paragraph.add_run(" 页")
-    set_east_asia(run2)
-
-
-doc = Document()
-doc.add_heading(os.path.splitext(os.path.basename(SRC))[0], level=0)
-
-
-# --- base styles ---
-normal = doc.styles["Normal"]
-normal.font.name = "Calibri"
-normal.font.size = Pt(10.5)
-normal._element.rPr.rFonts.set(qn("w:eastAsia"), "微软雅黑")
-
-
-def set_east_asia(run):
-    run.font.name = "Calibri"
-    r = run._element
-    rPr = r.get_or_add_rPr()
-    rf = rPr.find(qn("w:rFonts"))
-    if rf is None:
-        rf = OxmlElement("w:rFonts")
-        rPr.append(rf)
-    rf.set(qn("w:eastAsia"), "微软雅黑")
-
-
-def add_runs_with_bold(par, text):
-    """Add text to paragraph, honoring **bold** and *italic* markers."""
-    for tok in re.split(r"(\*\*.*?\*\*|\*.*?\*)", text):
-        if not tok:
-            continue
-        if tok.startswith("**") and tok.endswith("**") and len(tok) > 4:
-            r = par.add_run(tok[2:-2])
-            r.bold = True
-        elif tok.startswith("*") and tok.endswith("*") and len(tok) > 2:
-            r = par.add_run(tok[1:-1])
-            r.italic = True
-        else:
-            r = par.add_run(tok)
-        set_east_asia(r)
-
-
-def add_body_paragraph(text, style=None):
-    p = doc.add_paragraph(style=style)
-    add_runs_with_bold(p, text)
-    return p
-
-
-def flush_table():
-    global table_rows, in_table
-    if not table_rows:
-        in_table = False
-        return
-    ncols = max(len(r) for r in table_rows)
-    tbl = doc.add_table(rows=len(table_rows), cols=ncols)
-    tbl.style = "Light Grid Accent 1"
-    tbl.alignment = WD_TABLE_ALIGNMENT.CENTER
-    for ri, row in enumerate(table_rows):
-        for ci in range(ncols):
-            cell = tbl.cell(ri, ci)
-            cell.text = ""
-            cp = cell.paragraphs[0]
-            text = row[ci] if ci < len(row) else ""
-            add_runs_with_bold(cp, text)
-            if ri == 0:
-                for run in cp.runs:
-                    run.bold = True
-    tbl.autofit = True
-    table_rows = []
-    in_table = False
-
-
-table_rows = []
-in_table = False
-
-i = 0
-while i < len(lines):
-    stripped = lines[i].strip()
-    if not stripped:
-        i += 1
-        continue
-    if re.fullmatch(r"-{3,}", stripped):
-        flush_table()
-        doc.add_paragraph()
-        i += 1
-        continue
-    if in_table and "|" in stripped and re.fullmatch(r"\|?[\s:|-]+\|?", stripped):
-        i += 1
-        continue
-    if stripped.startswith("|"):
-        in_table = True
-        table_rows.append([c.strip() for c in stripped.strip("|").split("|")])
-        i += 1
-        continue
-    if in_table:
-        flush_table()
-    if stripped.startswith("### "):
-        h = doc.add_heading(level=3)
-        add_runs_with_bold(h, stripped[4:])
-        i += 1
-        continue
-    if stripped.startswith("## "):
-        h = doc.add_heading(level=2)
-        add_runs_with_bold(h, stripped[3:])
-        i += 1
-        continue
-    if stripped.startswith("# "):
-        h = doc.add_heading(level=1)
-        add_runs_with_bold(h, stripped[2:])
-        i += 1
-        continue
-    if stripped.startswith("> "):
-        p = doc.add_paragraph(style="Intense Quote")
-        add_runs_with_bold(p, stripped[2:] + " ")
-        i += 1
-        continue
-    m = re.match(r"^(\d+)\.\s+(.*)$", stripped)
-    if m:
-        p = doc.add_paragraph(style="List Number")
-        add_runs_with_bold(p, m.group(2))
-        i += 1
-        continue
-    if stripped.startswith("- "):
-        p = doc.add_paragraph(style="List Bullet")
-        add_runs_with_bold(p, stripped[2:])
-        i += 1
-        continue
-    p = doc.add_paragraph()
-    add_runs_with_bold(p, stripped)
-    i += 1
-
-if in_table:
-    flush_table()
-
-# --- footer with page number field ---
-footer = doc.sections[0].footer
-fp = footer.paragraphs[0]
-fp.alignment = WD_ALIGN_PARAGRAPH.CENTER
-add_page_number(fp)
-
-doc.save(OUT)
-print("Saved:", OUT)