dsh-x-core 0.1.21 → 0.1.23

package/settings.js

@@ -90,6 +90,27 @@ export function updateSourceForDownload(value) {
   return safeDownloadSource(value) === 'official' ? 'direct' : 'mirror'
 }
 
+/**
+ * 跑 dsh 用哪个 node：bundled = 启动器自带（打包后是 Electron 内嵌的 Node），
+ * system = 用户机器上装的那个。只影响 dsh 子进程，启动器自己始终跑在 Electron 里。
+ * 换档要重启启动器：platform.js 在加载时就把 RUNTIME_NODE 定成了常量。
+ */
+export const NODE_RUNTIMES = ['bundled', 'system']
+export const DEFAULT_NODE_RUNTIME = 'bundled'
+
+export function safeNodeRuntime(value) {
+  const name = String(value ?? '').trim().toLowerCase()
+  return NODE_RUNTIMES.includes(name) ? name : DEFAULT_NODE_RUNTIME
+}
+
+/** 系统 node 的路径；空 = 从 PATH 自动找。存在性在保存时验证，这里只清空白与粘贴带上的引号。 */
+export function safeSystemNodePath(value) {
+  const text = String(value ?? '').trim().replace(/^"(.*)"$/, '$1').trim()
+  if (!text) return ''
+  if (text.length > 4096) throw new Error('node 路径太长')
+  return text
+}
+
 /**
  * 网络代理的三种模式：跟随系统（默认，自己探测系统代理）/ 手动填地址 / 不走代理。
  *
@@ -185,6 +206,19 @@ export function safeDshHome(dir) {
   return resolve(trimmed)
 }
 
+/**
+ * 项目目录：启动项把 `DSH_HOME` 放进 `<项目>/.dsh` 时，它就是用户的项目根（也当新会话的工作目录）。
+ * 和用户目录分开一个校验，报错才说得清该填哪一个；两者的取值规则一样（绝对路径、去掉首尾空白）。
+ */
+export function safeWorkdir(dir) {
+  if (dir === undefined || dir === null) return ''
+  if (typeof dir !== 'string') throw new Error('项目目录填一个路径，别填别的')
+  const trimmed = dir.trim()
+  if (!trimmed) return ''
+  if (!isAbsolute(trimmed)) throw new Error('请使用绝对路径（例如 D:\\projects\\demo）')
+  return resolve(trimmed)
+}
+
 export function safeDshHomes(value) {
   const homes = new Map()
   for (const item of Array.isArray(value) ? value : []) {
@@ -235,6 +269,25 @@ export const DEFAULTS = {
   reduceMotion: false,
   hideBackground: false,
   hideBigFish: false,
+  // ---- 桌面端系统开关（Electron 外壳直接读 settings.json，见 shell/prefs.mjs）----
+  // Chromium 硬件加速：关闭能规避显卡/驱动导致的白屏与闪退，代价是动画更吃 CPU，重启生效
+  hardwareAcceleration: true,
+  // 发现更新就自动下载；没有 dsh 实例在跑时直接装上并重启
+  autoUpdate: false,
+  // dsh 实例启动完成 / 启动失败时发桌面通知（外壳实现）
+  taskNotifications: true,
+  // 通知是否带提示音；关掉只影响启动器自己发的通知
+  notificationSound: true,
+  // 关窗口 = 隐藏到托盘（开着才有后台实例可找回）；关掉就是真退出
+  closeToTray: true,
+  // 阻止系统空闲休眠（跑长任务时用）
+  keepAwake: false,
+  // 内置浏览器（官方右侧栏浏览器）：关掉后不再给新启动的 dsh 实例放开那一行插件
+  browserControl: true,
+  // 内置浏览器不校验 HTTPS 证书（自签名 / 过期证书的站点也能打开），只影响浏览器分区
+  browserIgnoreCertificate: false,
+  // 右键菜单（dsh-x-context-menu）：关掉后新启动的 dsh 实例不再加载这个插件（不卸载）
+  contextMenu: true,
   downloadSource: DEFAULT_SOURCE,
   // 启动器更新的下载源：direct（默认）/ mirror（国内加速）
   updateSource: DEFAULT_UPDATE_SOURCE,
@@ -245,6 +298,9 @@ export const DEFAULTS = {
   openMode: DEFAULT_OPEN_MODE,
   // dsh 的用户目录（DSH_HOME）。留空 = 默认 ~/.dsh；用户把 .dsh 挪到别的盘时在这里指回去
   dshHome: '',
+  // 跑 dsh 用哪个 node：bundled（启动器自带，默认）/ system（系统装的那个；路径留空就按 PATH 找）
+  nodeRuntime: DEFAULT_NODE_RUNTIME,
+  systemNodePath: '',
   // 单独登记的目录不依赖启动项，删掉最后一个 Profile 后仍能回到这里新建。
   dshHomes: [],
   dshHomeNames: {},
@@ -420,6 +476,10 @@ export function safeLaunchPresets(value) {
     try { icon = safeLaunchIcon(item.icon) } catch { /* 旧设置里的坏图片退回默认图标，保留启动项。 */ }
     let dshHome = ''
     try { dshHome = safeDshHome(item.dshHome) } catch { return [] }
+    // 项目目录跟着启动项走：丢了它就只剩一个平平无奇的独立目录，工作目录也回不到项目根，
+    // 所以和 dshHome 一样，坏值宁可整条丢掉，别留下半截环境。
+    let workdir = ''
+    try { workdir = safeWorkdir(item.workdir) } catch { return [] }
     // 启动项最近用过的两个版本（当前用/上一次用）：清理旧版本时按启动项保留，给回退用。
     const usedVersion = String(item.usedVersion ?? '')
     const prevVersion = String(item.prevVersion ?? '')
@@ -431,7 +491,7 @@ export function safeLaunchPresets(value) {
       ...(updateChannel !== DEFAULT_UPDATE_CHANNEL ? { updateChannel } : {}),
       ...(VERSION_RE.test(usedVersion) ? { usedVersion } : {}),
       ...(VERSION_RE.test(prevVersion) ? { prevVersion } : {}),
-      ...(dshHome ? { dshHome } : {}), ...(icon !== 'terminal' ? { icon } : {}) }]
+      ...(workdir ? { workdir } : {}), ...(dshHome ? { dshHome } : {}), ...(icon !== 'terminal' ? { icon } : {}) }]
   })
   const builtin = presets.find((item) => item.id === DEFAULT_LAUNCH_ID) || { ...DEFAULT_LAUNCH }
   if (builtin.name === '默认启动') builtin.name = 'DSH'
@@ -640,12 +700,16 @@ function mergeStoredSettings(stored) {
     merged.hideBackground = stored.disableBackgroundAnimation === true
   }
   delete merged.disableBackgroundAnimation
+  // 更新通道开关已撤：通道跟着当前版本走，旧文件里的键顺手清掉
+  delete merged.acceptPrerelease
   // 内置插件的预置开关已撤（插件改由整合包分发），旧文件里的键顺手清掉
   delete merged.seedBundled
   delete merged.seedMarket
   try { merged.pluginMarketSources = safePluginMarketSources(merged.pluginMarketSources) } catch { merged.pluginMarketSources = [] }
   delete merged.seedMemory
   try { merged.keepVersions = safeKeepVersions(merged.keepVersions) } catch { merged.keepVersions = 2 }
+  merged.nodeRuntime = safeNodeRuntime(merged.nodeRuntime)
+  try { merged.systemNodePath = safeSystemNodePath(merged.systemNodePath) } catch { merged.systemNodePath = '' }
   return merged
 }
 
@@ -740,11 +804,24 @@ async function saveSettingsNow(patch) {
   merged.dshHomeNames = safeDshHomeNames(merged.dshHomeNames)
   merged.lang = 'lang' in patch ? safeLang(patch.lang) : safeLang(merged.lang)
   merged.theme = safeTheme(merged.theme)
+  merged.nodeRuntime = 'nodeRuntime' in patch ? safeNodeRuntime(patch.nodeRuntime) : safeNodeRuntime(merged.nodeRuntime)
+  merged.systemNodePath = 'systemNodePath' in patch ? safeSystemNodePath(patch.systemNodePath) : safeSystemNodePath(merged.systemNodePath)
   merged.launchIsolation = safeLaunchIsolation(merged.launchIsolation)
   merged.panelTransparency = safePanelTransparency(merged.panelTransparency)
   merged.reduceMotion = merged.reduceMotion === true
   merged.hideBackground = merged.hideBackground === true
   merged.hideBigFish = merged.hideBigFish === true
+  // 桌面端系统开关：只认布尔，脏值回默认（true 的两个用 !== false，其余 === true）
+  merged.hardwareAcceleration = merged.hardwareAcceleration !== false
+  merged.autoUpdate = merged.autoUpdate === true
+  merged.taskNotifications = merged.taskNotifications !== false
+  merged.notificationSound = merged.notificationSound !== false
+  merged.closeToTray = merged.closeToTray !== false
+  merged.keepAwake = merged.keepAwake === true
+  // 内置浏览器开关与证书校验：和上面一组同一套布尔语义
+  merged.browserControl = merged.browserControl !== false
+  merged.browserIgnoreCertificate = merged.browserIgnoreCertificate === true
+  merged.contextMenu = merged.contextMenu !== false
   // 同 webBind：脏值顺手修回默认（回环），显式改绑定方式时才把错误抛给调用方
   try {
     merged.webBind = safeWebBind(merged.webBind)