dsh-x-core 0.1.22 → 0.1.23

package/core-npm.js

@@ -1,183 +1,201 @@
-// 核心的 npm 分发：查 registry 的 dist-tags → 下载 tarball → 校验 → 解压。
-//
-// 安装包只负责外壳和 Electron；核心作为一个 npm 包独立发版，启动器在运行时从 registry
-// 取新版本，解到暂存目录后仍走 apply-update.mjs 换核心目录。
-// 核心包跨平台（三套 filemanager 和 node 包装都在里面），Windows / mac / Linux 用同一个
-// dsh-x-core；只有外壳/Electron 按平台分开。
-// 完整性用 npm 的 dist.integrity（sha512）校验；registry 走设置里的下载源（官方/镜像）。
-
-import { spawnSync } from 'node:child_process'
-import { createHash } from 'node:crypto'
-import { chmodSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from 'node:fs'
-import { join } from 'node:path'
-
-import { netFetch } from './proxy.js'
-import { cmpVer, parseVer, VERSION_CHANNEL } from './version.js'
-
-/** 核心包跨平台：Windows / mac / Linux 共用同一个 dsh-x-core。 */
-export const CORE_PACKAGE = String(process.env.DSH_CORE_PACKAGE || 'dsh-x-core').trim()
-
-export const CORE_REGISTRIES = {
-  official: 'https://registry.npmjs.org',
-  mirror: 'https://registry.npmmirror.com',
-}
-
-/** 核心包上限：app 层约 15 MB，超过这个数八成是错误页或别的文件。 */
-export const CORE_MAX_BYTES = 128 * 1024 * 1024
-
-const CHANNEL_TAG = {
-  [VERSION_CHANNEL.OFFICIAL]: 'latest',
-  [VERSION_CHANNEL.RC]: 'rc',
-  [VERSION_CHANNEL.ALPHA]: 'alpha',
-}
-
-/** 测试通道可以显式指定 registry；否则按下载源在官方/镜像之间选。 */
-export function coreRegistry(source = 'official') {
-  const override = String(process.env.DSH_CORE_REGISTRY || '').trim().replace(/\/+$/, '')
-  if (override) return override
-  return CORE_REGISTRIES[source] || CORE_REGISTRIES.official
-}
-
-export function coreMetadataUrl(registry, name = CORE_PACKAGE) {
-  return `${String(registry).replace(/\/+$/, '')}/${name.startsWith('@') ? name.replace('/', '%2F') : name}`
-}
-
-export function coreDistTag(channel = VERSION_CHANNEL.OFFICIAL) {
-  return CHANNEL_TAG[channel] || 'latest'
-}
-
-/** 从 npm 元数据里挑当前通道对应的版本；挑不到返回 null。 */
-export function resolveCoreRelease(metadata, channel = VERSION_CHANNEL.OFFICIAL) {
-  const tags = metadata?.['dist-tags'] || {}
-  const version = String(tags[coreDistTag(channel)] || tags.latest || '')
-  const info = version ? metadata?.versions?.[version] : null
-  if (!info) return null
-  const dist = info.dist || {}
-  return {
-    version,
-    tarball: String(dist.tarball || ''),
-    integrity: String(dist.integrity || ''),
-    shasum: String(dist.shasum || ''),
-    unpackedSize: Number(dist.unpackedSize) || 0,
-    // 发布脚本写进核心 package.json：这份核心是按哪个 Electron 版本构建/验证的
-    electron: String(info.dshX?.electron || ''),
-  }
-}
-
-export async function fetchCoreMetadata({ registry = coreRegistry(), name = CORE_PACKAGE, signal } = {}) {
-  const url = coreMetadataUrl(registry, name)
-  const res = await netFetch(url, {
-    redirect: 'follow',
-    headers: { accept: 'application/json', 'user-agent': 'dsh-x' },
-    signal,
-  })
-  if (!res.ok) throw new Error(`读取 ${name} 的 npm 元数据失败：HTTP ${res.status}`)
-  return res.json()
-}
-
-/** 查核心更新：返回 { available, current, latest, release }。 */
-export async function checkCoreUpdate({ current, source = 'official', channel = VERSION_CHANNEL.OFFICIAL, signal } = {}) {
-  const metadata = await fetchCoreMetadata({ registry: coreRegistry(source), signal })
-  const release = resolveCoreRelease(metadata, channel)
-  if (!release) return { available: false, current, latest: '' }
-  const next = parseVer(release.version)
-  const cur = parseVer(current)
-  return { available: Boolean(next && cur && cmpVer(next, cur) > 0), current, latest: release.version, release }
-}
-
-/** 下载 tarball，边下边算 sha512；有 integrity 就按 npm 的 SRI 校验，否则退回 sha1。 */
-export async function downloadCoreTarball(url, dest, { integrity = '', shasum = '', signal, onProgress, limit = CORE_MAX_BYTES } = {}) {
-  if (!url) throw new Error('核心包没有下载地址')
-  const res = await netFetch(url, { redirect: 'follow', signal })
-  if (!res.ok) throw new Error(`下载核心包失败：HTTP ${res.status}`)
-  const total = Number(res.headers.get('content-length')) || 0
-  if (total > limit) throw new Error(`核心包太大（${Math.round(total / 1048576)} MB，上限 ${Math.round(limit / 1048576)} MB）`)
-  const hash = createHash('sha512')
-  const out = createWriteStream(dest, { flags: 'w' })
-  let done = 0
-  const closed = new Promise((resolve, reject) => {
-    out.once('close', resolve)
-    out.once('error', reject)
-  })
-  try {
-    for await (const chunk of res.body) {
-      signal?.throwIfAborted()
-      done += chunk.length
-      if (done > limit) throw new Error('核心包太大，已停下')
-      hash.update(chunk)
-      if (!out.write(chunk)) {
-        await new Promise((resolve, reject) => {
-          out.once('drain', resolve)
-          out.once('error', reject)
-        })
-      }
-      onProgress?.({ done, total })
-    }
-    out.end()
-    await closed
-  } catch (error) {
-    out.destroy()
-    await closed.catch(() => {})
-    throw error
-  }
-  const digest = hash.digest('base64')
-  if (integrity) {
-    const expected = String(integrity).replace(/^sha512-/, '')
-    if (digest !== expected) throw new Error('核心包的 sha512 校验失败')
-  } else if (shasum) {
-    const sha1 = createHash('sha1').update(readFileSync(dest)).digest('hex')
-    if (sha1 !== String(shasum).toLowerCase()) throw new Error('核心包的 sha1 校验失败')
-  }
-  return { bytes: done, sha512: digest }
-}
-
-/** 解压用的 tar：Windows 上用系统自带的 bsdtar（Git 的 GNU tar 会把 C: 当远程主机）。 */
-export function tarCommand() {
-  if (process.platform === 'win32') {
-    const system = join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'tar.exe')
-    return existsSync(system) ? system : 'tar'
-  }
-  return '/usr/bin/tar'
-}
-
-/** 在 Windows 上打的 tarball 里 POSIX 包装可能没有可执行位；解到 mac 后补上。 */
-function ensurePosixShims(dest) {
-  if (process.platform === 'win32') return
-  for (const name of ['node', 'npm', 'npx', 'pnpm', 'pnpx']) {
-    try { chmodSync(join(dest, 'node', name), 0o755) } catch { /* 没有就跳过 */ }
-  }
-}
-
-/** npm tarball 里所有文件都在 package/ 下；解包时剥掉这一层。 */
-export function extractCoreTarball(tarball, dest) {
-  rmSync(dest, { recursive: true, force: true })
-  mkdirSync(dest, { recursive: true })
-  const result = spawnSync(tarCommand(), ['-xzf', tarball, '-C', dest, '--strip-components=1'], { windowsHide: true, encoding: 'utf8' })
-  if (result.status !== 0) throw new Error(`解压核心包失败：${String(result.stderr || result.status).trim()}`)
-  if (!existsSync(join(dest, 'server.js')) || !existsSync(join(dest, 'package.json'))) {
-    throw new Error('核心包里缺少 server.js 或 package.json')
-  }
-  ensurePosixShims(dest)
-  return JSON.parse(readFileSync(join(dest, 'package.json'), 'utf8'))
-}
-
-export function stagingExists(dir, marker = 'server.js') {
-  return Boolean(dir) && existsSync(join(dir, marker))
-}
-
-export function stagingStats(dir) {
-  let files = 0
-  let bytes = 0
-  const walk = (current) => {
-    for (const entry of readdirSync(current, { withFileTypes: true })) {
-      const path = join(current, entry.name)
-      if (entry.isDirectory()) walk(path)
-      else if (entry.isFile()) {
-        files += 1
-        bytes += statSync(path).size
-      }
-    }
-  }
-  walk(dir)
-  return { files, bytes }
-}
+// 核心的 npm 分发：查 registry 的 dist-tags → 下载 tarball → 校验 → 解压。
+//
+// 安装包只负责外壳和 Electron；核心作为一个 npm 包独立发版，启动器在运行时从 registry
+// 取新版本，解到暂存目录后仍走 apply-update.mjs 换核心目录。
+// 核心包跨平台（三套 filemanager 和 node 包装都在里面），Windows / mac / Linux 用同一个
+// dsh-x-core；只有外壳/Electron 按平台分开。
+// 完整性用 npm 的 dist.integrity（sha512）校验；registry 走设置里的下载源（官方/镜像）。
+
+import { spawnSync } from 'node:child_process'
+import { createHash } from 'node:crypto'
+import { chmodSync, createWriteStream, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from 'node:fs'
+import { join } from 'node:path'
+
+import { netFetch } from './proxy.js'
+import { cmpVer, parseVer, VERSION_CHANNEL } from './version.js'
+
+/** 核心包跨平台：Windows / mac / Linux 共用同一个 dsh-x-core。 */
+export const CORE_PACKAGE = String(process.env.DSH_CORE_PACKAGE || 'dsh-x-core').trim()
+
+export const CORE_REGISTRIES = {
+  official: 'https://registry.npmjs.org',
+  mirror: 'https://registry.npmmirror.com',
+}
+
+/** 核心包上限：app 层约 15 MB，超过这个数八成是错误页或别的文件。 */
+export const CORE_MAX_BYTES = 128 * 1024 * 1024
+
+const CHANNEL_TAG = {
+  [VERSION_CHANNEL.OFFICIAL]: 'latest',
+  [VERSION_CHANNEL.RC]: 'rc',
+  [VERSION_CHANNEL.ALPHA]: 'alpha',
+}
+
+/** 测试通道可以显式指定 registry；否则按下载源在官方/镜像之间选。 */
+export function coreRegistry(source = 'official') {
+  const override = String(process.env.DSH_CORE_REGISTRY || '').trim().replace(/\/+$/, '')
+  if (override) return override
+  return CORE_REGISTRIES[source] || CORE_REGISTRIES.official
+}
+
+export function coreMetadataUrl(registry, name = CORE_PACKAGE) {
+  return `${String(registry).replace(/\/+$/, '')}/${name.startsWith('@') ? name.replace('/', '%2F') : name}`
+}
+
+export function coreDistTag(channel = VERSION_CHANNEL.OFFICIAL) {
+  return CHANNEL_TAG[channel] || 'latest'
+}
+
+/** 从 npm 元数据里挑当前通道对应的版本；挑不到返回 null。 */
+export function resolveCoreRelease(metadata, channel = VERSION_CHANNEL.OFFICIAL) {
+  const tags = metadata?.['dist-tags'] || {}
+  const version = String(tags[coreDistTag(channel)] || tags.latest || '')
+  const info = version ? metadata?.versions?.[version] : null
+  if (!info) return null
+  const dist = info.dist || {}
+  return {
+    version,
+    tarball: String(dist.tarball || ''),
+    integrity: String(dist.integrity || ''),
+    shasum: String(dist.shasum || ''),
+    unpackedSize: Number(dist.unpackedSize) || 0,
+    // 发布脚本写进核心 package.json：这份核心是按哪个 Electron 版本构建/验证的
+    electron: String(info.dshX?.electron || ''),
+  }
+}
+
+export async function fetchCoreMetadata({ registry = coreRegistry(), name = CORE_PACKAGE, signal } = {}) {
+  const url = coreMetadataUrl(registry, name)
+  const res = await netFetch(url, {
+    redirect: 'follow',
+    headers: { accept: 'application/json', 'user-agent': 'dsh-x' },
+    signal,
+  })
+  if (!res.ok) throw new Error(`读取 ${name} 的 npm 元数据失败：HTTP ${res.status}`)
+  return res.json()
+}
+
+/** 查核心更新：返回 { available, current, latest, release }。 */
+export async function checkCoreUpdate({ current, source = 'official', channel = VERSION_CHANNEL.OFFICIAL, signal } = {}) {
+  const metadata = await fetchCoreMetadata({ registry: coreRegistry(source), signal })
+  const release = resolveCoreRelease(metadata, channel)
+  if (!release) return { available: false, current, latest: '' }
+  const next = parseVer(release.version)
+  const cur = parseVer(current)
+  return { available: Boolean(next && cur && cmpVer(next, cur) > 0), current, latest: release.version, release }
+}
+
+/**
+ * 一次元数据查询里看多个通道，取高于当前版本里最高的那个（「接受预览版」开关用）。
+ * 只查一次 registry：三个 dist-tag 在同一份文档里，分三次查纯属浪费。
+ */
+export async function checkCoreUpdateAny({ current, source = 'official', channels = [], signal } = {}) {
+  const metadata = await fetchCoreMetadata({ registry: coreRegistry(source), signal })
+  const cur = parseVer(current)
+  let best = null
+  for (const channel of channels) {
+    const release = resolveCoreRelease(metadata, channel)
+    const next = release ? parseVer(release.version) : null
+    if (!next || !cur || cmpVer(next, cur) <= 0) continue
+    if (!best || cmpVer(next, parseVer(best.version)) > 0) best = release
+  }
+  if (!best) return { available: false, current, latest: '' }
+  return { available: true, current, latest: best.version, release: best }
+}
+
+/** 下载 tarball，边下边算 sha512；有 integrity 就按 npm 的 SRI 校验，否则退回 sha1。 */
+export async function downloadCoreTarball(url, dest, { integrity = '', shasum = '', signal, onProgress, limit = CORE_MAX_BYTES } = {}) {
+  if (!url) throw new Error('核心包没有下载地址')
+  const res = await netFetch(url, { redirect: 'follow', signal })
+  if (!res.ok) throw new Error(`下载核心包失败：HTTP ${res.status}`)
+  const total = Number(res.headers.get('content-length')) || 0
+  if (total > limit) throw new Error(`核心包太大（${Math.round(total / 1048576)} MB，上限 ${Math.round(limit / 1048576)} MB）`)
+  const hash = createHash('sha512')
+  const out = createWriteStream(dest, { flags: 'w' })
+  let done = 0
+  const closed = new Promise((resolve, reject) => {
+    out.once('close', resolve)
+    out.once('error', reject)
+  })
+  try {
+    for await (const chunk of res.body) {
+      signal?.throwIfAborted()
+      done += chunk.length
+      if (done > limit) throw new Error('核心包太大，已停下')
+      hash.update(chunk)
+      if (!out.write(chunk)) {
+        await new Promise((resolve, reject) => {
+          out.once('drain', resolve)
+          out.once('error', reject)
+        })
+      }
+      onProgress?.({ done, total })
+    }
+    out.end()
+    await closed
+  } catch (error) {
+    out.destroy()
+    await closed.catch(() => {})
+    throw error
+  }
+  const digest = hash.digest('base64')
+  if (integrity) {
+    const expected = String(integrity).replace(/^sha512-/, '')
+    if (digest !== expected) throw new Error('核心包的 sha512 校验失败')
+  } else if (shasum) {
+    const sha1 = createHash('sha1').update(readFileSync(dest)).digest('hex')
+    if (sha1 !== String(shasum).toLowerCase()) throw new Error('核心包的 sha1 校验失败')
+  }
+  return { bytes: done, sha512: digest }
+}
+
+/** 解压用的 tar：Windows 上用系统自带的 bsdtar（Git 的 GNU tar 会把 C: 当远程主机）。 */
+export function tarCommand() {
+  if (process.platform === 'win32') {
+    const system = join(process.env.SystemRoot || 'C:\\Windows', 'System32', 'tar.exe')
+    return existsSync(system) ? system : 'tar'
+  }
+  return '/usr/bin/tar'
+}
+
+/** 在 Windows 上打的 tarball 里 POSIX 包装可能没有可执行位；解到 mac 后补上。 */
+function ensurePosixShims(dest) {
+  if (process.platform === 'win32') return
+  for (const name of ['node', 'npm', 'npx', 'pnpm', 'pnpx']) {
+    try { chmodSync(join(dest, 'node', name), 0o755) } catch { /* 没有就跳过 */ }
+  }
+}
+
+/** npm tarball 里所有文件都在 package/ 下；解包时剥掉这一层。 */
+export function extractCoreTarball(tarball, dest) {
+  rmSync(dest, { recursive: true, force: true })
+  mkdirSync(dest, { recursive: true })
+  const result = spawnSync(tarCommand(), ['-xzf', tarball, '-C', dest, '--strip-components=1'], { windowsHide: true, encoding: 'utf8' })
+  if (result.status !== 0) throw new Error(`解压核心包失败：${String(result.stderr || result.status).trim()}`)
+  if (!existsSync(join(dest, 'server.js')) || !existsSync(join(dest, 'package.json'))) {
+    throw new Error('核心包里缺少 server.js 或 package.json')
+  }
+  ensurePosixShims(dest)
+  return JSON.parse(readFileSync(join(dest, 'package.json'), 'utf8'))
+}
+
+export function stagingExists(dir, marker = 'server.js') {
+  return Boolean(dir) && existsSync(join(dir, marker))
+}
+
+export function stagingStats(dir) {
+  let files = 0
+  let bytes = 0
+  const walk = (current) => {
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      const path = join(current, entry.name)
+      if (entry.isDirectory()) walk(path)
+      else if (entry.isFile()) {
+        files += 1
+        bytes += statSync(path).size
+      }
+    }
+  }
+  walk(dir)
+  return { files, bytes }
+}

package/desktop-plugins.js

@@ -0,0 +1,86 @@
+/**
+ * DSH-X 桌面增强：随启动器自动装进 web profile 的三个首方插件。
+ *
+ * 它们是普通的 dsh 插件（host / client 分开），只有装进 profile 才会加载。启动器在每次
+ * 拉起实例前检查一遍，缺哪个就补哪个；装法复用插件页那条链路（`dsh plugin add` + 写
+ * `dsh.profile.bundles`），所以从 npm 装、能在插件页更新。
+ *
+ * 只看「装没装」，不看行是否启用：用户在 dsh 插件页关掉的插件不会被这里重新打开。
+ *
+ * 纯函数（不读盘、不起进程），单测见 test/desktop-plugins.test.mjs；真正的安装留在
+ * server.js 的 addPlugin。
+ */
+
+/**
+ * 三个首方插件。
+ *
+ * `spec` 钉精确版本：核心的 safeSpec 不接受 `^`；也不用 `latest`——新包首发会先出一个
+ * `0.0.0-stage` 占位版本，`@latest` 在那段时间装到的是空壳。升级交给插件页（它按
+ * registry 上的最新版本 add），这里只负责把缺的装上。
+ *
+ * `minDsh` 是插件 dsh.compatibility.dsh 的下限；同一版本的预发布（0.2.1-rc.4）算满足。
+ */
+export const DESKTOP_PLUGINS = Object.freeze([
+  { name: 'dsh-x-desktop-notify', spec: '0.1.1', label: '原生通知', minDsh: '0.2.0' },
+  { name: 'dsh-x-context-menu', spec: '0.1.1', label: '右键菜单', minDsh: '0.2.0' },
+  { name: 'dsh-x-sidebar-browser', spec: '0.1.1', label: '侧栏浏览器控制', minDsh: '0.2.1-rc.2' },
+])
+
+/** dsh 自己的 desktop profile 归 dsh-desktop 管，DSH-X 不往里塞插件（同 --patch 的例外）。 */
+export const DESKTOP_PLUGINS_SKIP_PROFILES = Object.freeze(['desktop'])
+
+/**
+ * `x.y.z` / `x.y.z-rc.1` → `[x, y, z]`；认不出来返回 null。
+ * @param {string} text - dsh 版本。
+ * @returns {number[] | null} 主次修订三个数字。
+ */
+export function parseDshVersion(text) {
+  const match = String(text ?? '').trim().match(/^(\d+)\.(\d+)\.(\d+)(?:[-+].*)?$/)
+  if (!match) return null
+  return [Number(match[1]), Number(match[2]), Number(match[3])]
+}
+
+/**
+ * 版本够不够插件要求的下限。
+ *
+ * 只比主次修订：同一版本的预发布（`0.2.1-rc.4` 对 `0.2.1-rc.2`）算满足——插件的
+ * compatibility 写的是「从哪个版本开始有这些接口」，预发布同样有。
+ *
+ * @param {string} version - 要启动的 dsh 版本。
+ * @param {string} min - 插件要求的最低版本。
+ * @returns {boolean} 够不够；任一边认不出来都算不够（宁可不装，也不装坏一个 profile）。
+ */
+export function versionAtLeast(version, min) {
+  const left = parseDshVersion(version)
+  const right = parseDshVersion(min)
+  if (!left || !right) return false
+  for (let i = 0; i < 3; i += 1) {
+    if (left[i] > right[i]) return true
+    if (left[i] < right[i]) return false
+  }
+  return true
+}
+
+/**
+ * 这个 dsh 版本能装的桌面增强插件。
+ * @param {string} version - 要启动的 dsh 版本。
+ * @returns {{ name: string, spec: string, label: string, minDsh: string }[]} 子集。
+ */
+export function desktopPluginsForDsh(version) {
+  return DESKTOP_PLUGINS.filter((plugin) => versionAtLeast(version, plugin.minDsh))
+}
+
+/**
+ * profile 还缺哪些桌面增强插件。
+ *
+ * 已经写在 `dependencies` 里就算装了（不管是 registry 版本、`link:` 还是 `file:`）：
+ * 开发机上 link 的本地包不该被换成 npm 版。
+ *
+ * @param {object} manifest - profile 的 package.json 内容。
+ * @param {string} version - 要启动的 dsh 版本。
+ * @returns {{ name: string, spec: string, label: string, minDsh: string }[]} 需要安装的插件。
+ */
+export function desktopPluginsToInstall(manifest, version) {
+  const dependencies = manifest?.dependencies && typeof manifest.dependencies === 'object' ? manifest.dependencies : {}
+  return desktopPluginsForDsh(version).filter((plugin) => !Object.hasOwn(dependencies, plugin.name))
+}