dsh-mobile-plugin 0.1.58 → 0.1.60

package/lib/shell/updater.js

@@ -0,0 +1,267 @@
+/**
+ * 更新编排：替用户去问 DSH 插件市场要新版，装完**就地换代**（不重启 DSH）。
+ *
+ * ## 为什么这件事归外壳做，而不是归面板（浏览器）
+ *
+ * 面板里那颗「更新」按钮只能覆盖「用户正开着页面点一下」这一种情形；自动更新的定义是
+ * **没人看着也要发生**。所以轮询和「装完切换」都必须在宿主进程里做，面板只是给它一个开关。
+ *
+ * ## 为什么下载交给市场、切换留给自己
+ *
+ * 市场在 profile 里跑 pnpm，还会做版本核验、release-age 策略、回滚点、重启守卫 —— 抄一遍
+ * 只会抄漏。它装完会报 `restartRequired: true`（因为绝大多数插件换版本确实得重启 DSH），
+ * 而本插件有外壳，可以自己把运行中的实现换掉，所以这里**故意不调它的重启**。
+ *
+ * 装完新一代是**新目录**（pnpm 换链接），外壳照着新 realpath 重新 import 一代即可，见
+ * `lib/shell/manager.js` 与 `lib/shell/runtime.js`。
+ *
+ * ## 这个模块不做的事
+ *
+ * 不下载、不解包、不校验、不写 profile —— 全是市场的职责。它只回答四个问题：有没有新版、
+ * 请它装、装完了没、盘上现在是什么版本。
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+import { createHash } from 'node:crypto'
+import { createRequire } from 'node:module'
+import { installedVersion } from './manager.js'
+
+const require_ = createRequire(import.meta.url)
+const { dshHome } = require_('../shared/paths.js')
+
+
+/**
+ * 外壳自己的指纹（`lib/index.js` + `lib/shell/*.js` 的内容哈希）。
+ *
+ * **外壳换不掉**：它在进程启动时被 Node 缓存，改它必须重启 DSH —— 而重启是被明令禁止的。
+ * 所以「新版本连外壳一起改了」这件事**不会**在这次更新里生效：实现换成新的了，装载它的
+ * 那层还是旧的。这本身通常无害（外壳的接口是加法式的），但用户有权知道，所以这里算一个
+ * 指纹，把「盘上的外壳和跑着的外壳不一样」如实报给面板。
+ *
+ * 缺文件按空串算：拿不到指纹时报「没变」，免得每次开面板都喊一句要重启。
+ */
+export function shellFingerprint(pkgDir) {
+  if (!pkgDir) return null
+  const files = ['lib/index.js', 'lib/shell/runtime.js', 'lib/shell/manager.js', 'lib/shell/updater.js']
+  const hash = createHash('sha256')
+  let seen = 0
+  for (const rel of files) {
+    try {
+      hash.update(rel).update(fs.readFileSync(path.join(pkgDir, rel)))
+      seen += 1
+    } catch {
+      // 缺一个文件就少算一个：宁愿指纹弱一点，也不要在这里抛。
+    }
+  }
+  return seen === 0 ? null : hash.digest('hex').slice(0, 16)
+}
+
+/** 本插件的 npm 包名（市场按它找依赖）。 */
+export const PACKAGE_NAME = 'dsh-mobile-plugin'
+
+/** 自动检查的间隔与「检查一次」的超时。 */
+export const AUTO_INTERVAL_MS = 10 * 60 * 1000
+const REQUEST_TIMEOUT_MS = 15000
+/** 等一次安装走完的上限：pnpm 装一个包 + 校验，给足但别无限等。 */
+const INSTALL_TIMEOUT_MS = 10 * 60 * 1000
+const POLL_INTERVAL_MS = 1000
+
+/** 宿主自己的 web 端口 → 市场的本机地址。端口拿不到就别问（自动更新如实报不可用）。 */
+export function marketBase(port) {
+  const value = Number(port)
+  if (!Number.isFinite(value) || value <= 0) return null
+  return `http://127.0.0.1:${value}`
+}
+
+/** 市场接口的错误：把状态码、它给的稳定 code 与给人看的话一起带出来。 */
+export class MarketError extends Error {
+  constructor(status, code, message) {
+    super(message)
+    this.name = 'MarketError'
+    this.status = status
+    this.code = code
+  }
+}
+
+/**
+ * 调一次市场接口。
+ *
+ * 形状是**外部契约**，一律防御式读：拿不到就当「没这个能力」，绝不让外壳因此崩掉
+ * （外壳崩掉等于插件从宿主里消失、手机连不上，是最贵的失败）。
+ *
+ * 不带 `Origin` 头：请求来自宿主进程而不是浏览器，本机来源由对端按 socket 判定。
+ */
+async function marketJson(base, route, init) {
+  if (!base) throw new MarketError(0, 'market-unavailable', '拿不到本机 web 端口，问不了市场')
+  const controller = new AbortController()
+  const timer = setTimeout(() => controller.abort(), REQUEST_TIMEOUT_MS)
+  let response
+  try {
+    response = await fetch(`${base}/dsh-market/api/v1${route}`, {
+      ...init,
+      signal: controller.signal,
+      headers: { 'content-type': 'application/json', ...(init?.headers || {}) },
+    })
+  } catch (error) {
+    throw new MarketError(0, 'market-unreachable', `插件市场不可达：${error?.message || error}`)
+  } finally {
+    clearTimeout(timer)
+  }
+  let body = null
+  try {
+    body = await response.json()
+  } catch {
+    body = null
+  }
+  if (!response.ok) {
+    const code = body?.error?.code || body?.code || `http-${response.status}`
+    const message = body?.error?.message || body?.message || `市场返回 ${response.status}`
+    throw new MarketError(response.status, code, message)
+  }
+  return body
+}
+
+/** 市场在不在、能不能代劳重启（我们不用后者，只为与面板口径一致）。 */
+export async function capabilities(base) {
+  const body = await marketJson(base, '/capabilities', { method: 'GET' })
+  return {
+    available: true,
+    restartSupported: body?.restart?.supported === true,
+  }
+}
+
+/**
+ * 问有没有新版。`installedVersion` 为 null = 市场看不见这个包（多半不是 npm 装的）。
+ *
+ * 路径与字段与面板那份客户端（`React/src/lib/market.ts`）逐字对齐：同一个市场接口，
+ * 两处写法不一致时踩的是「宿主能装、面板说看不见」这类最难查的偏差。
+ */
+export async function checkUpdate(base, name = PACKAGE_NAME, { force = false } = {}) {
+  const body = await marketJson(base, `/updates?name=${encodeURIComponent(name)}${force ? '&force=1' : ''}`, { method: 'GET' })
+  const update = body?.package || body || {}
+  return {
+    installedVersion: typeof update.installedVersion === 'string' ? update.installedVersion : null,
+    latestVersion: typeof update.latestVersion === 'string' ? update.latestVersion : null,
+    updateAvailable: update.updateAvailable === true,
+    source: typeof update.source === 'string' ? update.source : null,
+    channelSwitch: update.channelSwitch === true,
+  }
+}
+
+/**
+ * 这条链能不能自动更新。
+ *
+ * 市场只从注册表装包：本地 link / `file:` 装的那些（`source: 'linked'`）它一概拒绝
+ * （`locally linked plugins update from their checkout`）。所以「自动更新」在那种机器上
+ * **做不到**，而且必须**说出来** —— 否则用户开着开关等一晚上，什么都不会发生。
+ */
+export function updatableSource(source) {
+  return source === 'npm'
+}
+
+/** 请市场去装。返回它的 operationId，供轮询。 */
+export async function startUpdate(base, name = PACKAGE_NAME, { force = false } = {}) {
+  const body = await marketJson(base, '/updates', {
+    method: 'POST',
+    body: JSON.stringify({ packageName: name, ...(force ? { force: true } : {}) }),
+  })
+  const operation = body?.operation || body || {}
+  if (typeof operation.operationId !== 'string') {
+    throw new MarketError(200, 'market-bad-response', '市场没有给出 operationId，无法跟踪这次更新')
+  }
+  return operation
+}
+
+/** 查一次操作结果。 */
+export async function operation(base, operationId) {
+  const body = await marketJson(base, `/operations?operationId=${encodeURIComponent(operationId)}`, { method: 'GET' })
+  return body?.operation || body || {}
+}
+
+const TERMINAL = new Set(['succeeded', 'failed', 'cancelled', 'rolled-back'])
+
+/**
+ * 一套完整的「装新版」：问市场、请它装、盯到终态。
+ *
+ * **不重启 DSH**：市场报的 `restartRequired` 只往上传，装完由外壳换代解决（见 index.js）。
+ * 装完了但盘上版本没变（市场报成功、文件没落），这里如实返回 `installed: false`，不让调用方
+ * 以为换过代码 —— 「状态说成功、代码没换」是这个仓库吃过最贵的一次亏。
+ */
+export async function installIfNeeded(base, { name = PACKAGE_NAME, force = false, onEvent = () => {}, now = Date.now } = {}) {
+  const before = installedVersion()
+  const check = await checkUpdate(base, name, { force })
+  if (check.source !== null && !updatableSource(check.source)) {
+    // 本地 link / file: 装的：市场不会碰它（见 updatableSource）。如实返回，别去试。
+    return {
+      installed: false,
+      skipped: true,
+      reason: 'linked-source',
+      detail: `这台机器上的插件是 ${check.source} 来源装的（本地目录 / tgz），市场只从注册表更新；要自动更新得先在插件市场里按包名重装一次切到 npm 来源`,
+      beforeVersion: before,
+      installedVersion: before,
+      check,
+    }
+  }
+  if (!check.updateAvailable && !force) {
+    return { installed: false, skipped: true, beforeVersion: before, installedVersion: before, check }
+  }
+  const started = await startUpdate(base, name, { force })
+  onEvent({ phase: 'started', operationId: started.operationId })
+  const deadline = now() + INSTALL_TIMEOUT_MS
+  let last = started
+  while (!TERMINAL.has(last.state) && now() < deadline) {
+    await new Promise(resolve => setTimeout(resolve, POLL_INTERVAL_MS))
+    last = await operation(base, started.operationId)
+    onEvent({ phase: 'progress', state: last.state, operationId: started.operationId })
+  }
+  if (!TERMINAL.has(last.state)) {
+    throw new MarketError(0, 'market-operation-timeout', `更新操作 ${started.operationId} 在 ${Math.round(INSTALL_TIMEOUT_MS / 1000)}s 内没有结束`)
+  }
+  // 市场同一时刻只允许一个操作，有 agent 在跑时也会直接拒（`AGENTS_RUNNING`）—— 这类
+  // 失败是「现在不行」，不是「坏了」：自动更新下个 tick 再试就好，别当成故障喊。
+  const RETRYABLE_CODES = new Set(['OPERATION_BUSY', 'AGENTS_RUNNING', 'UPDATE_TIMEOUT', 'RELEASE_TOO_FRESH'])
+  const retryable = typeof last.failure?.code === 'string' ? RETRYABLE_CODES.has(last.failure.code) : false
+  const after = installedVersion()
+  return {
+    installed: last.state === 'succeeded' && after !== before && after !== null,
+    state: last.state,
+    operationId: started.operationId,
+    beforeVersion: last.beforeVersion ?? before,
+    installedVersion: after,
+    // 市场认为要重启：本插件自己换代，**故意不照做**。留着上报给面板做说明。
+    restartRequired: last.restartRequired === true,
+    refreshRequired: last.refreshRequired === true,
+    failure: last.failure || null,
+    retryable,
+    check,
+  }
+}
+
+/** 自动更新开关的落盘文件：`<DSH_HOME>/storages/mobile-plugin/auto-update.json`。 */
+function autoUpdateFile() {
+  return path.join(dshHome(), 'storages', 'mobile-plugin', 'auto-update.json')
+}
+
+/** 读开关。读不到 / 读坏了都当「关」——自动装东西这种事，缺省必须在用户这一侧。 */
+export function autoUpdateEnabled() {
+  try {
+    const raw = JSON.parse(fs.readFileSync(autoUpdateFile(), 'utf8'))
+    return raw?.enabled === true
+  } catch {
+    return false
+  }
+}
+
+/** 写开关。 */
+export function setAutoUpdate(enabled) {
+  const file = autoUpdateFile()
+  fs.mkdirSync(path.dirname(file), { recursive: true })
+  fs.writeFileSync(file, `${JSON.stringify({ enabled: enabled === true }, null, 2)}\n`)
+  return autoUpdateEnabled()
+}
+
+/** 开关文件的路径（诊断用）。 */
+export function autoUpdateFilePath() {
+  return autoUpdateFile()
+}

package/package.json

@@ -1,13 +1,15 @@
 {
   "name": "dsh-mobile-plugin",
-  "version": "0.1.58",
+  "version": "0.1.60",
   "description": "Mobile API (/api/mobile/v1) and relay client for the DSH mobile app — desktop profile build (0.2.0-rc.2 compatible, peers resolved by the host)",
   "license": "MIT",
   "type": "module",
-  "main": "lib/impl.js",
-  "bin": "host.js",
+  "main": "lib/index.js",
+  "bin": {
+    "dsh-mobile-plugin": "host.js"
+  },
   "exports": {
-    ".": "./lib/impl.js",
+    ".": "./lib/index.js",
     "./client": "./lib/client.js",
     "./package.json": "./package.json"
   },