dsh-code-ui 1.3.1 → 1.4.0

package/lib/index.js

@@ -4,7 +4,6 @@
 // UI's file / reference / note operations, and a model tool get_referenced_snippets.
 
 import { defineTool } from "@deepseek-ai/dsh-tools";
-import { installSettingsSection, settingsNamespace } from "@deepseek-ai/dsh-settings";
 import z from "@deepseek-ai/schemastery";
 import { spawn } from "node:child_process";
 import { existsSync, mkdirSync, readFileSync, renameSync, rmSync, watch, writeFileSync } from "node:fs";
@@ -36,6 +35,65 @@ const SELF_MANIFEST = readJsonSafe(join(HERE, "..", "package.json")) || { name:
 const SELF_NAME = SELF_MANIFEST.name;
 const SELF_VERSION = SELF_MANIFEST.version;
 
+// —— highlight.js 静态资产：宿主 webServer exact 路由下发 ——
+// /plugins 组合脚本只承载 client.js 本体，vendor 产物（全量包 + 作用域化主题 CSS）无从经其
+// 下发；exact 路由无路径参数，天然无目录穿越面。产物由 tools/vendor-hljs.mjs 生成
+// （升级：node tools/vendor-hljs.mjs <版本号>；只补主题：--themes-only）。
+const VENDOR_ASSETS = {
+  "/dsh-code-ui/vendor/highlight.full.min.js": {
+    file: join(HERE, "vendor", "highlight.full.min.js"),
+    type: "text/javascript; charset=utf-8",
+  },
+  "/dsh-code-ui/vendor/hljs-themes.css": {
+    file: join(HERE, "vendor", "hljs-themes.css"),
+    type: "text/css; charset=utf-8",
+  },
+};
+// 语法配色可取值（与 lib/client.js 的 SYN_THEMES 表、tools/vendor-hljs.mjs 的 THEMES 一一对应）
+const SYN_THEME_IDS = [
+  "auto", "github", "github-dark", "atom-one-dark", "atom-one-light",
+  "monokai", "dracula", "nord", "vs", "vs2015", "tokyo-night-dark",
+];
+function registerVendorRoutes(ctx) {
+  // webServer 为可选宿主服务（web profile 提供）：无该服务的宿主上回调不运行，
+  // 编辑器自动回退自研 tokenizer，不影响其它功能
+  ctx.inject(["webServer"], (c) => {
+    const disposers = [];
+    for (const [path, asset] of Object.entries(VENDOR_ASSETS)) {
+      disposers.push(
+        c.webServer.register({
+          kind: "exact",
+          path,
+          handler: (req, res) => {
+            if (req.method !== "GET" && req.method !== "HEAD") {
+              res.writeHead(405, { allow: "GET, HEAD", "content-length": "0" });
+              res.end();
+              return;
+            }
+            let body = null;
+            try {
+              if (existsSync(asset.file)) body = readFileSync(asset.file);
+            } catch (_) {}
+            if (body === null) {
+              res.writeHead(404, { "cache-control": "no-store" });
+              res.end();
+              return;
+            }
+            res.writeHead(200, {
+              "content-type": asset.type,
+              "content-length": String(body.length),
+              // 客户端以 ?v=<插件版本> 作 cache-bust：同版本字节不变，可放心长缓存
+              "cache-control": "public, max-age=31536000, immutable",
+            });
+            res.end(req.method === "HEAD" ? undefined : body);
+          },
+        }),
+      );
+    }
+    c.effect(() => () => { for (const d of disposers) { try { d(); } catch (_) {} } }, "dsh-code-ui: vendor assets");
+  });
+}
+
 // profile 根 = 向上找 package.json 含 dsh.profile.bundles 的目录（不数层级、不硬编码路径）
 function findProfileRoot() {
   let dir = HERE;
@@ -90,7 +148,15 @@ const REGISTRY_MIRROR = "https://registry.npmmirror.com";
 // -- settings 命名空间：「插件配置」页按 host 服务的命名空间分发卡片 --
 // 卡片的 key 必须是一个 host 实际注册的 settings 命名空间，否则卡片永不渲染
 //（ui-settings-plugins 的 tab-store 只分发 key ∈ 已服务命名空间的卡片，照 dshmarket 的 settings.ts 做法）。
-const CODE_UI_SETTINGS_NS = settingsNamespace("dsh-code-ui");
+// 不 import @deepseek-ai/dsh-settings：该包 0.1.2 起删除了 installSettingsSection /
+// settingsNamespace 具名导出（ESM 缺失具名导出 = 模块求值期 SyntaxError，宿主直接退出 1），
+// 而服务本身 sctx.settings.register(ns, schema, { base }) 从 0.1.0-rc.7 到 0.1.2 完全一致。
+// 照 dshmarket settings.js 的做法内联等价接线；下为旧 settingsNamespace() 的校验规则。
+const SETTINGS_NS_PATTERN = /^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
+const CODE_UI_SETTINGS_NS = "dsh-code-ui";
+if (!SETTINGS_NS_PATTERN.test(CODE_UI_SETTINGS_NS)) {
+  throw new TypeError(`settings namespace "${CODE_UI_SETTINGS_NS}" must match ${SETTINGS_NS_PATTERN}`);
+}
 const CodeUiSettingsSchema = z.object({
   // 检查更新用的 registry（只影响在线「检查」；安装仍走 profile 自己的 .npmrc）
   updateRegistry: z.string().default(REGISTRY_DEFAULT),
@@ -102,39 +168,44 @@ const CodeUiSettingsSchema = z.object({
   layout: z.string().default("dock"),
   // 界面模式：native(隐藏编辑器,默认——新装不自动占屏,由 ⌨ 按钮唤出) / codeui(显示编辑器)
   uiMode: z.string().default("native"),
-  // 切换按钮样式：header(会话头 ⌨ 按钮,默认) / bar(悬浮模式条)
-  toggle: z.string().default("header"),
+  // 切换按钮样式：bar(悬浮模式条,默认) / header(会话头 ⌨ 按钮)
+  toggle: z.string().default("bar"),
+  // 语法配色：auto(默认,随编辑器明暗 GitHub/GitHub Dark) 或 SYN_THEME_IDS 之一
+  synTheme: z.string().default("auto"),
 });
 // 解析后的当前值：settings 服务未挂载/未写入时保持默认
-const selfSettings = { updateRegistry: REGISTRY_DEFAULT, enabled: true, theme: "dsh", layout: "dock", uiMode: "native", toggle: "header" };
+const selfSettings = { updateRegistry: REGISTRY_DEFAULT, enabled: true, theme: "dsh", layout: "dock", uiMode: "native", toggle: "bar", synTheme: "auto" };
 // settings 服务引用（「启用/禁用」开关写入用；由 installSelfSettings 捕获）
 let settingsServiceRef = null;
 function installSelfSettings(ctx) {
-  let source = () => ({ updateRegistry: selfSettings.updateRegistry, enabled: selfSettings.enabled, theme: selfSettings.theme, layout: selfSettings.layout, uiMode: selfSettings.uiMode, toggle: selfSettings.toggle });
-  installSettingsSection(
-    ctx,
-    CODE_UI_SETTINGS_NS,
-    CodeUiSettingsSchema,
-    { updateRegistry: selfSettings.updateRegistry, enabled: selfSettings.enabled, theme: selfSettings.theme, layout: selfSettings.layout, uiMode: selfSettings.uiMode, toggle: selfSettings.toggle },
-    {
-      setSource: (current) => { source = current; },
-      onChange: () => {
-        try {
-          const v = source() || {};
-          if (typeof v.updateRegistry === "string" && /^https?:\/\//.test(v.updateRegistry)) {
-            selfSettings.updateRegistry = v.updateRegistry.replace(/\/+$/, "");
-          }
-          if (typeof v.enabled === "boolean") selfSettings.enabled = v.enabled;
-          if (v.theme === "dsh" || v.theme === "system" || v.theme === "light" || v.theme === "dark") selfSettings.theme = v.theme;
-          if (v.layout === "dock" || v.layout === "float") selfSettings.layout = v.layout;
-          if (v.uiMode === "codeui" || v.uiMode === "native") selfSettings.uiMode = v.uiMode;
-          if (v.toggle === "header" || v.toggle === "bar") selfSettings.toggle = v.toggle;
-        } catch (_) {}
-      },
-    },
-  );
-  // 捕获 settings 服务实例：卡片的「启用/禁用」开关经 set-enabled RPC 写入本命名空间
-  ctx.inject(["settings"], (sctx) => { settingsServiceRef = sctx.settings; });
+  // 组合基线（base）：settings 服务缺席/卸载时的回落取值
+  const entry = { updateRegistry: selfSettings.updateRegistry, enabled: selfSettings.enabled, theme: selfSettings.theme, layout: selfSettings.layout, uiMode: selfSettings.uiMode, toggle: selfSettings.toggle, synTheme: selfSettings.synTheme };
+  let source = () => entry;
+  const onChange = () => {
+    try {
+      const v = source() || {};
+      if (typeof v.updateRegistry === "string" && /^https?:\/\//.test(v.updateRegistry)) {
+        selfSettings.updateRegistry = v.updateRegistry.replace(/\/+$/, "");
+      }
+      if (typeof v.enabled === "boolean") selfSettings.enabled = v.enabled;
+      if (v.theme === "dsh" || v.theme === "system" || v.theme === "light" || v.theme === "dark") selfSettings.theme = v.theme;
+      if (v.layout === "dock" || v.layout === "float") selfSettings.layout = v.layout;
+      if (v.uiMode === "codeui" || v.uiMode === "native") selfSettings.uiMode = v.uiMode;
+      if (v.toggle === "header" || v.toggle === "bar") selfSettings.toggle = v.toggle;
+      if (typeof v.synTheme === "string" && SYN_THEME_IDS.indexOf(v.synTheme) >= 0) selfSettings.synTheme = v.synTheme;
+    } catch (_) {}
+  };
+  // inject 是优雅降级边界：无 settings 服务的宿主上回调不运行，基线值照常生效
+  //（等价于旧 installSettingsSection：inject + register + watch + 卸载回落，照 dshmarket settings.js）
+  ctx.inject(["settings"], (sctx) => {
+    settingsServiceRef = sctx.settings; // 写路径（set-* RPC）用服务级 update(ns, patch)，新旧版签名一致
+    const scope = sctx.settings.register(CODE_UI_SETTINGS_NS, CodeUiSettingsSchema, { base: entry });
+    source = () => scope.get();
+    // 卸载恢复基线取值，避免路由读到无人可见/可改的值
+    sctx.effect(() => () => { source = () => entry; onChange(); });
+    onChange();
+    scope.watch(onChange);
+  });
 }
 
 async function fetchLatestVersion(name, registry) {
@@ -349,13 +420,12 @@ function unwatchAllFiles() {
 
 function rpcHandler(ctx) {
   const fs = ctx.get("fs");
-  let currentRootRef = detectWorkspaceRoot(ctx);
+  let currentRootRef = detectWorkspaceRoot(ctx); // 最近一次解析的根：list-dir 的兜底
+  // 每会话根目录记忆：sessionId -> 手动设置的根（「以此文件夹为根」）。
+  // 按会话隔离——手动根只影响设置它的那个会话，不再全局污染其它会话的自动解析；
+  // 重启 DSH 即清空，各会话回到各自 cwd 解析。自动解析结果不缓存（会话 cwd 可变，保持实时）。
+  const sessionRoots = new Map();
 
-  // 每次 get-root 动态回读会话工作区根，避免一次缓存导致拿不到当前项目目录
-  function baseRoot() {
-    if (currentRootRef) return currentRootRef;
-    return detectWorkspaceRoot(ctx);
-  }
   function detectWorkspaceRoot(_ctx) {
     // 1) 当前会话的真实工作区根(项目根)：优先取正在发起调用的 agent 的 session cwd。
     //    sandboxPolicy.workspaceRoot 只是「部署回退根」，常是 DSH 进程 cwd 而非项目目录。
@@ -388,14 +458,58 @@ function rpcHandler(ctx) {
       const args = payload && typeof payload === "object" ? payload : {};
 
       if (endpoint === "get-root") {
-        const root = baseRoot();
+        // 优先级（按会话隔离）：该会话手动设置的根 > 该会话的 agent cwd（agent 已启动，
+        // agent/session id 共享，agents.get 可查）> 该会话的 SessionHeader.cwd（新会话未发
+        // 消息时 agents 里还没有记录，但会话创建时 cwd 已从所选工作区写入不可变 header，
+        // 经 sessions 服务可查）> initiator 会话 cwd > 部署回退根 > 进程 cwd。
+        // 手动根仅对本会话生效，其它会话不受污染。
+        const sid = args.sessionId ? String(args.sessionId) : "";
+        let root = sid ? sessionRoots.get(sid) || null : null;
+        if (!root && sid) {
+          const agentsSvc = ctx.get("agents");
+          if (agentsSvc) {
+            try {
+              const a = agentsSvc.get(sid);
+              if (a && a.session && a.session.header && a.session.header.cwd) {
+                root = a.session.header.cwd;
+              }
+            } catch (_) {}
+          }
+        }
+        // 新会话（尚未发消息、agent 未启动）：从会话存储取 SessionHeader.cwd
+        if (!root && sid) {
+          const sessionsSvc = ctx.get("sessions");
+          if (sessionsSvc && typeof sessionsSvc.get === "function") {
+            try {
+              const s = sessionsSvc.get(sid);
+              if (s && s.header && s.header.cwd) root = s.header.cwd;
+            } catch (_) {}
+          }
+        }
+        // 会话已持久化但未在内存存储（如重启 DSH 后重开旧对话、agent 尚未恢复）：
+        // 经 sessionController.inspect 读持久化 header（官方语义：不激活 agent）
+        if (!root && sid) {
+          const sc = ctx.get("sessionController");
+          if (sc && typeof sc.inspect === "function") {
+            try {
+              const r = await sc.inspect(sid);
+              if (r && r.meta && r.meta.cwd) root = r.meta.cwd;
+            } catch (_) {}
+          }
+        }
+        if (!root) root = detectWorkspaceRoot(ctx);
+        if (root) currentRootRef = root;
         return ok({ root });
       }
 
       if (endpoint === "set-root") {
         if (!args.path) return ok({ error: "no-path" });
-        currentRootRef = String(args.path);
-        return ok({ root: currentRootRef });
+        // 手动根按会话记录：只影响发起设置的会话；无会话上下文时退化为全局兜底
+        const path = String(args.path);
+        const sid = args.sessionId ? String(args.sessionId) : "";
+        if (sid) sessionRoots.set(sid, path);
+        currentRootRef = path;
+        return ok({ root: path });
       }
 
       if (endpoint === "list-dir") {
@@ -452,9 +566,17 @@ function rpcHandler(ctx) {
       if (endpoint === "write-file") {
         if (!args.path) return ok({ error: "no-path" });
         if (typeof args.content !== "string") return ok({ error: "no-content" });
-        writeSuppress.set(args.path, Date.now() + 1500); // 自己的保存不进事件队列（回声抑制）
-        await fs.writeText(await fs.resolve(args.path), args.content);
-        return ok({ ok: true });
+        try {
+          writeSuppress.set(args.path, Date.now() + 1500); // 自己的保存不进事件队列（回声抑制）
+          // 原生写入：code UI 的 Ctrl+S 是用户显式编辑动作，不受会话沙箱限制
+          // （与文件树右键新建/重命名/删除一致；沙箱 fs 只允许写会话工作区，
+          //  工作区之外的文件会报 file access denied under workspace-write mode）
+          writeFileSync(args.path, args.content, "utf8");
+          return ok({ ok: true });
+        } catch (err) {
+          writeSuppress.delete(args.path);
+          return ok({ error: "保存失败：" + ((err && err.message) || String(err)) });
+        }
       }
 
       if (endpoint === "watch-file") {
@@ -606,6 +728,7 @@ function rpcHandler(ctx) {
           layout: selfSettings.layout,
           uiMode: selfSettings.uiMode,
           toggle: selfSettings.toggle,
+          synTheme: selfSettings.synTheme,
         });
       }
 
@@ -669,6 +792,21 @@ function rpcHandler(ctx) {
         }
       }
 
+      if (endpoint === "set-syn-theme") {
+        const v = args.synTheme;
+        if (SYN_THEME_IDS.indexOf(v) < 0) return ok({ error: "synTheme 需为 auto 或受支持的主题 id" });
+        if (!settingsServiceRef || typeof settingsServiceRef.update !== "function") {
+          return ok({ error: "settings 服务不可用，重启 DSH 后再试" });
+        }
+        try {
+          await settingsServiceRef.update(CODE_UI_SETTINGS_NS, { synTheme: v });
+          selfSettings.synTheme = v;
+          return ok({ ok: true, synTheme: v });
+        } catch (err) {
+          return ok({ error: "写入设置失败：" + ((err && err.message) || String(err)) });
+        }
+      }
+
       if (endpoint === "set-enabled") {
         if (typeof args.enabled !== "boolean") return ok({ error: "enabled 参数需为布尔值" });
         if (!settingsServiceRef || typeof settingsServiceRef.update !== "function") {
@@ -800,6 +938,10 @@ export function apply(ctx) {
   // 无 settings 服务的宿主上静默不运行，不影响其它功能）
   installSelfSettings(ctx);
 
+  // vendor 静态资产路由（highlight.js 全量包 + 主题 CSS）：webServer 服务存在时注册 exact 路由，
+  // 客户端编辑器懒加载；无 webServer 的宿主上静默跳过（编辑器回退自带 tokenizer）
+  registerVendorRoutes(ctx);
+
   // 注册模型工具：通过 ctx.inject 拿 tools 服务（避免 Cordis guard 直接访问 ctx.tools）
   ctx.inject(["tools"], (c) => {
     registerSnippetsTool(c.tools);