@huaqiu/dsh-tool-plugin-update 0.6.6 → 0.6.7

package/lib/index.mjs

@@ -65,6 +65,18 @@ function readBody(req) {
 * forwarder answers 405 rather than forwarding a GET to a POST-only upstream
 * and surfacing hq-edge's 404 as a plugin bug.
 */
+/**
+* Match a dynamic `/status/<jobId>` sub-path. Returns the job id for a single
+* non-empty segment (no nested slashes), else null. The id is opaque — this
+* route forwards it verbatim; hq-edge owns validation and the 404 for unknown
+* ids.
+*/
+function matchJobStatusPath(sub) {
+	if (!sub.startsWith("/status/")) return null;
+	const id = sub.slice(8);
+	if (id.length === 0 || id.includes("/") || id.includes("?")) return null;
+	return id;
+}
 function routeFor(sub, method) {
 	if (sub === "/runtime-source") {
 		if (method === "GET") return {
@@ -92,6 +104,15 @@ function routeFor(sub, method) {
 		method: "GET",
 		path: "/api/v1/plugin-updates"
 	} : null;
+	if (sub === "/status") return method === "GET" ? {
+		method: "GET",
+		path: "/api/v1/plugin-updates/status"
+	} : null;
+	const jobId = matchJobStatusPath(sub);
+	if (jobId !== null) return method === "GET" ? {
+		method: "GET",
+		path: `/api/v1/plugin-updates/status/${encodeURIComponent(jobId)}`
+	} : null;
 	if (sub === "/runtime") return method === "GET" ? {
 		method: "GET",
 		path: "/api/v1/runtime-update"
@@ -119,8 +140,9 @@ function routeFor(sub, method) {
 	} : null;
 	return null;
 }
-/** Every sub-path this forwarder serves — used to tell a 404 from a 405. */
-const ROUTE_SUB_PATHS = /* @__PURE__ */ new Set([
+/** Every static sub-path this forwarder serves — used to tell a 404 from a
+*  405. The dynamic `/status/<id>` path is matched separately. */
+const STATIC_SUB_PATHS = /* @__PURE__ */ new Set([
 	"",
 	"/report",
 	"/check",
@@ -130,8 +152,17 @@ const ROUTE_SUB_PATHS = /* @__PURE__ */ new Set([
 	"/runtime",
 	"/runtime-request",
 	"/runtime-source",
-	"/plugin-source"
+	"/plugin-source",
+	"/status"
 ]);
+/**
+* Whether a sub-path names a route this forwarder recognizes at all. A
+* recognized sub-path hit with an unsupported method is a 405; an unrecognized
+* one is a 404. `/status/<id>` is recognized for any single-segment id.
+*/
+function isKnownSubPath(sub) {
+	return STATIC_SUB_PATHS.has(sub) || matchJobStatusPath(sub) !== null;
+}
 /** Create the prefix-route handler forwarding to hq-edge. */
 function createUpdateForwarder(baseUrlResolver, timeoutMs = DEFAULT_FORWARD_TIMEOUT_MS) {
 	return async (req, res) => {
@@ -142,7 +173,8 @@ function createUpdateForwarder(baseUrlResolver, timeoutMs = DEFAULT_FORWARD_TIME
 		}
 		const target = routeFor(sub, req.method === "HEAD" ? "GET" : req.method ?? "");
 		if (target === null) {
-			sendJson(res, sub === "" || ROUTE_SUB_PATHS.has(sub) ? 405 : 404, { error: sub === "" || ROUTE_SUB_PATHS.has(sub) ? `method ${req.method} not allowed on ${sub || "/"}` : "not found" });
+			const known = isKnownSubPath(sub);
+			sendJson(res, known ? 405 : 404, { error: known ? `method ${req.method} not allowed on ${sub || "/"}` : "not found" });
 			return;
 		}
 		if (req.method !== "GET" && req.method !== "POST" && req.method !== "HEAD") {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huaqiu/dsh-tool-plugin-update",
-  "version": "0.6.6",
+  "version": "0.6.7",
   "type": "module",
   "main": "./lib/index.mjs",
   "types": "./lib/index.d.mts",
@@ -31,8 +31,8 @@
     "@deepseek-ai/dsh-host-webserver": "^0.2.1-rc.2"
   },
   "dependencies": {
-    "@huaqiu/dsh-plugin-log": "0.6.6",
-    "@huaqiu/dsh-sidebar-entry": "0.6.6"
+    "@huaqiu/dsh-sidebar-entry": "0.6.7",
+    "@huaqiu/dsh-plugin-log": "0.6.7"
   },
   "files": [
     "lib",

package/src/client/api.ts

@@ -29,6 +29,15 @@ export interface PluginUpdateItem {
   ignored?: boolean
   reasons?: string[]
   notes?: string[]
+  /**
+   * User-facing release metadata (schemaVersion-2 manifests). ALL optional and
+   * absent for v1 manifests — the view falls back to the package short name
+   * and version line when they are missing.
+   */
+  displayName?: string
+  description?: string
+  sizeBytes?: number
+  changes?: string[]
 }
 
 /**
@@ -49,6 +58,33 @@ export interface RuntimeUpdateEntry {
   arch?: string
   /** Exact absolute HTTPS URL of the release archive. */
   url: string
+  /**
+   * Optional user-facing metadata (schemaVersion-2 runtime manifest). All
+   * absent for v1 manifests; the panel degrades gracefully without them.
+   */
+  publishedAt?: string
+  sizeBytes?: number
+  summary?: string
+  notesUrl?: string
+  notes?: string[]
+  breaking?: string[]
+  channel?: string
+}
+
+/**
+ * The EDA host's own report of the last runtime replacement, read from
+ * `runtime-update-result.json` by hq-edge. This is the authoritative outcome
+ * after HQ Edge exits and the host swaps the runtime — it must be rendered,
+ * not discarded. `state` is `succeeded`, `rolled_back` (swap failed but the
+ * previous runtime was restored) or `failed` (no confirmed rollback).
+ */
+export interface RuntimeLastResult {
+  state: 'succeeded' | 'rolled_back' | 'failed'
+  targetVersion?: string | null
+  installedVersion?: string | null
+  at?: string
+  errorCode?: string
+  message?: string
 }
 
 export interface RuntimeUpdateInfo {
@@ -59,6 +95,8 @@ export interface RuntimeUpdateInfo {
   updateAvailable: boolean
   checkedAt?: string | null
   lastError?: string | null
+  /** The host-reported outcome of the last runtime swap; null when none. */
+  lastResult?: RuntimeLastResult | null
   /**
    * Where the runtime-update manifest is read from. Optional: an older hq-edge
    * does not send it, and the panel must degrade to a read-only source row.
@@ -110,6 +148,21 @@ export function runtimeLatestVersion(
   return null
 }
 
+/**
+ * Set-level release metadata from a schemaVersion-2 plugin manifest. ALL
+ * fields optional: v1 manifests send none, and the panel must fall back to
+ * showing just the version then.
+ */
+export interface ReleaseInfo {
+  publishedAt?: string
+  channel?: string
+  requiresRestart?: boolean
+  summary?: string
+  notesUrl?: string
+  notes?: string[]
+  breaking?: string[]
+}
+
 export interface PluginUpdateReport {
   /** The evaluated release set; null while no manifest has been read. */
   manifestVersion: string | null
@@ -118,7 +171,13 @@ export interface PluginUpdateReport {
   actionableCount: number
   ignoredSet: boolean
   fetchedAt?: string
+  /** When the last plugin discovery ran (ISO); drives the "上次检查" row. */
+  checkedAt?: string | null
+  /** Non-empty when the last plugin discovery FAILED — the panel must show
+   *  an error row with a Retry, never the silent "no updates" empty state. */
   lastError?: string | null
+  /** Set-level release metadata; absent for v1 manifests. */
+  release?: ReleaseInfo | null
   runtime: RuntimeUpdateInfo
   /**
    * Where the plugin release manifest is read from. Optional: an older
@@ -127,6 +186,198 @@ export interface PluginUpdateReport {
   pluginSource?: PluginUpdateSource
 }
 
+// ── Durable update-job lifecycle (GET /status, GET /status/:id) ────────────
+
+/** Lifecycle phases of one durable update job. Terminal phases end the poll. */
+export type UpdatePhase =
+  | 'queued'
+  | 'resolving'
+  | 'downloading'
+  | 'verifying'
+  | 'staging'
+  | 'activating'
+  | 'awaiting-host'
+  | 'restarting'
+  | 'verifying-after-restart'
+  | 'done'
+  | 'failed'
+  | 'rolled-back'
+  | 'abandoned'
+
+/** Phases after which a job never runs again — polling stops and a result view
+ *  replaces the active-job view. */
+export const TERMINAL_PHASES: ReadonlySet<UpdatePhase> = new Set<UpdatePhase>([
+  'done',
+  'failed',
+  'rolled-back',
+  'abandoned',
+])
+
+export type UpdateKind = 'plugin-set' | 'runtime'
+
+export interface UpdateJobProgress {
+  /** 0..100 when the phase has a meaningful percentage; null otherwise. */
+  percent: number | null
+  bytesDone?: number
+  bytesTotal?: number
+  bytesPerSecond?: number
+  etaSeconds?: number
+}
+
+export interface UpdateStep {
+  name: string
+  state: 'pending' | 'running' | 'installed' | 'skipped' | 'failed'
+  percent?: number
+  message?: string
+}
+
+export interface UpdateJobResult {
+  ok: boolean
+  installedVersion: string | null
+  errorCode?: string
+  message?: string
+  rolledBack: boolean
+  finishedAt: string
+}
+
+/**
+ * One durable update job, as hq-edge reports it (`GET /status` and
+ * `/status/:id`). The UI is a projection of this job: opening the panel
+ * resumes whatever the server says is active, rather than owning the
+ * lifecycle in a DOM closure.
+ */
+export interface UpdateJob {
+  id: string
+  kind: UpdateKind
+  targetVersion: string
+  previousVersion: string | null
+  startedAt: string
+  updatedAt: string
+  phase: UpdatePhase
+  message?: string
+  progress: UpdateJobProgress
+  steps?: UpdateStep[]
+  result?: UpdateJobResult
+  logHint?: string
+}
+
+/** `GET /status`: the current active job plus a bounded list of recent ones. */
+export interface UpdateJobStatus {
+  activeJob: UpdateJob | null
+  recentJobs: UpdateJob[]
+}
+
+const PHASE_VALUES: ReadonlySet<string> = new Set<string>([
+  'queued',
+  'resolving',
+  'downloading',
+  'verifying',
+  'staging',
+  'activating',
+  'awaiting-host',
+  'restarting',
+  'verifying-after-restart',
+  'done',
+  'failed',
+  'rolled-back',
+  'abandoned',
+])
+
+function asStringArray(value: unknown): string[] | undefined {
+  if (!Array.isArray(value)) return undefined
+  const out = value.filter((entry): entry is string => typeof entry === 'string')
+  return out.length > 0 ? out : undefined
+}
+
+function asFiniteNumber(value: unknown): number | undefined {
+  return typeof value === 'number' && Number.isFinite(value) ? value : undefined
+}
+
+/** Defensively normalize one job payload from the wire into {@link UpdateJob}.
+ *  Unknown/older servers may omit fields; a malformed `phase` falls back to
+ *  `queued` rather than crashing the view. */
+export function normalizeJob(raw: unknown): UpdateJob | null {
+  if (raw === null || typeof raw !== 'object') return null
+  const r = raw as Record<string, unknown>
+  if (typeof r.id !== 'string' || r.id.length === 0) return null
+  const phase = typeof r.phase === 'string' && PHASE_VALUES.has(r.phase)
+    ? (r.phase as UpdatePhase)
+    : 'queued'
+  const progressRaw = (r.progress ?? {}) as Record<string, unknown>
+  const percentRaw = asFiniteNumber(progressRaw.percent)
+  const progress: UpdateJobProgress = {
+    percent: percentRaw === undefined ? null : Math.min(100, Math.max(0, percentRaw)),
+  }
+  const bytesDone = asFiniteNumber(progressRaw.bytesDone)
+  const bytesTotal = asFiniteNumber(progressRaw.bytesTotal)
+  const bytesPerSecond = asFiniteNumber(progressRaw.bytesPerSecond)
+  const etaSeconds = asFiniteNumber(progressRaw.etaSeconds)
+  if (bytesDone !== undefined) progress.bytesDone = bytesDone
+  if (bytesTotal !== undefined) progress.bytesTotal = bytesTotal
+  if (bytesPerSecond !== undefined) progress.bytesPerSecond = bytesPerSecond
+  if (etaSeconds !== undefined) progress.etaSeconds = etaSeconds
+
+  const job: UpdateJob = {
+    id: r.id,
+    kind: r.kind === 'runtime' ? 'runtime' : 'plugin-set',
+    targetVersion: typeof r.targetVersion === 'string' ? r.targetVersion : '',
+    previousVersion:
+      typeof r.previousVersion === 'string' ? r.previousVersion : null,
+    startedAt: typeof r.startedAt === 'string' ? r.startedAt : '',
+    updatedAt: typeof r.updatedAt === 'string' ? r.updatedAt : '',
+    phase,
+    progress,
+  }
+  if (typeof r.message === 'string' && r.message.length > 0) job.message = r.message
+  if (typeof r.logHint === 'string' && r.logHint.length > 0) job.logHint = r.logHint
+
+  if (Array.isArray(r.steps)) {
+    const steps: UpdateStep[] = []
+    for (const entry of r.steps) {
+      if (entry === null || typeof entry !== 'object') continue
+      const s = entry as Record<string, unknown>
+      if (typeof s.name !== 'string') continue
+      const state =
+        s.state === 'running' || s.state === 'installed' || s.state === 'skipped' || s.state === 'failed'
+          ? s.state
+          : 'pending'
+      const step: UpdateStep = { name: s.name, state }
+      const pct = asFiniteNumber(s.percent)
+      if (pct !== undefined) step.percent = pct
+      if (typeof s.message === 'string' && s.message.length > 0) step.message = s.message
+      steps.push(step)
+    }
+    if (steps.length > 0) job.steps = steps
+  }
+
+  if (r.result !== null && typeof r.result === 'object') {
+    const res = r.result as Record<string, unknown>
+    const result: UpdateJobResult = {
+      ok: res.ok === true,
+      installedVersion:
+        typeof res.installedVersion === 'string' ? res.installedVersion : null,
+      rolledBack: res.rolledBack === true,
+      finishedAt: typeof res.finishedAt === 'string' ? res.finishedAt : '',
+    }
+    if (typeof res.errorCode === 'string' && res.errorCode.length > 0) result.errorCode = res.errorCode
+    if (typeof res.message === 'string' && res.message.length > 0) result.message = res.message
+    job.result = result
+  }
+  return job
+}
+
+/** Normalize a `GET /status` payload; an empty/absent body degrades to "no
+ *  active job" rather than throwing. */
+export function normalizeJobStatus(raw: unknown): UpdateJobStatus {
+  if (raw === null || typeof raw !== 'object') return { activeJob: null, recentJobs: [] }
+  const r = raw as Record<string, unknown>
+  const activeJob = normalizeJob(r.activeJob)
+  const recentJobs = Array.isArray(r.recentJobs)
+    ? r.recentJobs.map(normalizeJob).filter((j): j is UpdateJob => j !== null)
+    : []
+  return { activeJob, recentJobs }
+}
+
 async function request<T>(path: string, init?: RequestInit): Promise<T> {
   const res = await fetch(`${UPDATE_BASE}${path}`, {
     cache: 'no-store',
@@ -153,7 +404,14 @@ export function checkUpdates(): Promise<PluginUpdateReport> {
 }
 
 export interface InstallResult {
-  ok: boolean
+  /**
+   * New durable contract: `202 { jobId, state: 'accepted' }`. The install is
+   * now an async job — poll `/status/:jobId` for progress, don't read success
+   * off this response. Legacy boolean fields are kept for older hq-edge.
+   */
+  jobId?: string
+  state?: string
+  ok?: boolean
   installedSetVersion?: string
   installed?: number
   skipped?: number
@@ -183,6 +441,8 @@ export function ignoreOffer(setVersion: string): Promise<unknown> {
  * updating → `busy`), 422 (preflight/manifest/download refused) or 503.
  */
 export interface RuntimeUpdateRequestResult {
+  /** Durable job id — poll `/status/:jobId` for the accepted job's progress. */
+  jobId?: string
   requestId?: string
   targetVersion?: string
   state?: string
@@ -258,3 +518,23 @@ export function setPluginUpdateSource(url: string): Promise<PluginUpdateSource>
     body: JSON.stringify({ url }),
   })
 }
+
+/**
+ * GET the durable job status: the currently active job (if any) plus a bounded
+ * list of recent jobs. This is what the panel reads BEFORE running discovery
+ * on open, so an in-flight install/runtime update is resumed instead of
+ * forgotten. An older hq-edge without the status route 404s — callers catch
+ * that and degrade to "no active job".
+ */
+export function fetchJobStatus(): Promise<UpdateJobStatus> {
+  return request<unknown>('/status').then(normalizeJobStatus)
+}
+
+/** GET one job by id; rejects (upstream 404 `unknown job`) for an unknown id. */
+export function fetchJob(id: string): Promise<UpdateJob> {
+  return request<unknown>(`/status/${encodeURIComponent(id)}`).then((raw) => {
+    const job = normalizeJob(raw)
+    if (job === null) throw new Error('malformed job payload')
+    return job
+  })
+}

package/src/client/copy.ts

@@ -20,9 +20,16 @@ const zh = {
   loading: '正在读取插件更新…',
   empty: '没有可用的插件更新',
   checkFailed: '检查更新失败，请重试',
-  installAll: (count: number) => `安装 ${count} 项更新`,
-  installOne: '安装',
+  // The button installs the ENTIRE offered set at once (not one card) — label
+  // it honestly rather than per-plugin.
+  installAll: (count: number) => `安装整套更新（${count} 项）`,
+  installOne: '安装整套',
+  installOneTip: '将安装整套 N 项更新并自动重启 DSH，而不仅是此插件',
   installing: '正在安装…（DSH 将自动重启）',
+  retry: '重试',
+  checkedAt: (when: string) => `上次检查：${when}`,
+  checkFailedBanner: (message: string) => `检查更新失败：${message}`,
+  staleNote: '以下为上次成功检查的结果，可能已过期',
   nothingToInstall: '暂无可安装的更新',
   ignore: '忽略此版本',
   unignore: '恢复提醒',
@@ -56,11 +63,23 @@ const zh = {
     unknown: '版本未知',
     notConfigured: '未配置更新源',
     note: '运行时更新由 EDA 安装器处理',
+    sizeLabel: '包大小',
     update: '安装运行时更新',
     updateConfirm: (version: string) =>
       `安装 HQ Edge 运行时 ${version}？HQ Edge 会先关闭并完成替换，然后重新启动。`,
-    updating: '正在下载并校验运行时包，可能需要一分钟…',
+    // No fixed "takes one minute" claim: duration depends on download speed
+    // and package size (the bundle is hundreds of MB).
+    updating: '正在下载并校验运行时包…',
+    durationNote: '耗时取决于下载速度与包体大小；运行时包较大，替换后 HQ Edge 会自动重启。',
     updateAccepted: '运行时更新已受理，HQ Edge 正在重启…',
+    size: (bytes: number) => `约 ${formatMb(bytes)}`,
+    lastResult: {
+      title: '上次运行时更新结果',
+      succeeded: '运行时更新成功',
+      failed: '运行时更新失败',
+      rolledBack: '运行时更新已回滚（已恢复旧版本）',
+      elevation: '系统级安装可能弹出 UAC 提权窗口；拒绝提权会导致替换失败并自动回滚到旧版本。',
+    },
     // ── Update-source editor ──
     sourceHint: '运行时更新清单的下载地址，保存后立即生效',
     sourceEdit: '修改',
@@ -92,6 +111,59 @@ const zh = {
   installSuccess: '更新已安装，正在重启 DSH…',
   confirmInstall: '确认安装',
   cancel: '取消',
+  // ── Durable update job (active / result / recent) ──
+  job: {
+    kindPluginSet: '插件集更新',
+    kindRuntime: 'HQ Edge 运行时更新',
+    phase: {
+      queued: '排队中',
+      resolving: '解析版本',
+      downloading: '下载中',
+      verifying: '校验完整性',
+      staging: '暂存文件',
+      activating: '启用插件集',
+      'awaiting-host': '等待主机替换运行时',
+      restarting: '正在重启',
+      'verifying-after-restart': '重启后校验',
+      done: '已完成',
+      failed: '失败',
+      'rolled-back': '已回滚',
+      abandoned: '已中断',
+    } as Record<string, string>,
+    willRestartDsh: '完成后 DSH 将自动重启，更新本身会在后台继续。',
+    willSwapRuntime: 'HQ Edge 会下载完整运行时包并退出，由 EDA 主机替换后重启；系统级安装可能弹出 UAC 提权窗口。',
+    closeNote: '关闭此面板不会取消更新。',
+    bytes: (done: string, total: string) => `${done} / ${total}`,
+    speed: (v: string) => `${v}/s`,
+    eta: (s: string) => `剩余约 ${s}`,
+    nextDone: '正在完成，请稍候…',
+    // Terminal result view
+    resultDone: '更新已完成',
+    resultFailed: '更新失败',
+    resultRolledBack: '更新已回滚',
+    resultAbandoned: '更新未完成',
+    retry: '重新尝试（发起新的更新）',
+    recentTitle: '最近更新',
+    stepsTitle: '各组件进度',
+    logHint: (hint: string) => `日志标识：${hint}`,
+  },
+  // ── Release metadata ──
+  release: {
+    summaryTitle: '版本说明',
+    notesLink: '查看发布说明',
+    breakingTitle: '破坏性变更',
+    changesTitle: '更新内容',
+    advanced: '高级：更新源',
+    publishedAt: (when: string) => `发布于 ${when}`,
+  },
+}
+
+/** Compact a byte count for display: "约 12.3 MB" / "约 480 MB". */
+export function formatMb(bytes: number): string {
+  if (!Number.isFinite(bytes) || bytes <= 0) return ''
+  const mb = bytes / (1024 * 1024)
+  if (mb >= 100) return `${Math.round(mb)} MB`
+  return `${mb.toFixed(1)} MB`
 }
 
 export type UpdateCopy = typeof zh
@@ -107,9 +179,14 @@ const en: UpdateCopy = {
   loading: 'Reading plugin updates…',
   empty: 'No plugin updates available',
   checkFailed: 'Failed to check for updates — please retry',
-  installAll: (count: number) => `Install ${count} update${count === 1 ? '' : 's'}`,
-  installOne: 'Install',
+  installAll: (count: number) => `Install whole set (${count})`,
+  installOne: 'Install set',
+  installOneTip: 'Installs the whole set of N updates and restarts DSH — not just this plugin',
   installing: 'Installing… (DSH will restart)',
+  retry: 'Retry',
+  checkedAt: (when: string) => `Last checked: ${when}`,
+  checkFailedBanner: (message: string) => `Update check failed: ${message}`,
+  staleNote: 'Showing the last successful check — it may be stale',
   nothingToInstall: 'Nothing to install right now',
   ignore: 'Ignore this release',
   unignore: 'Show again',
@@ -143,11 +220,21 @@ const en: UpdateCopy = {
     unknown: 'Version unknown',
     notConfigured: 'No update source configured',
     note: 'Runtime updates are handled by the EDA installer',
+    sizeLabel: 'Package size',
     update: 'Install runtime update',
     updateConfirm: (version: string) =>
       `Install HQ Edge runtime ${version}? HQ Edge shuts down to swap the runtime, then restarts.`,
-    updating: 'Downloading and verifying the runtime bundle — this can take a minute…',
+    updating: 'Downloading and verifying the runtime bundle…',
+    durationNote: 'Duration depends on download speed and package size; the runtime bundle is large, and HQ Edge restarts after the swap.',
     updateAccepted: 'Runtime update accepted — HQ Edge is restarting…',
+    size: (bytes: number) => `~ ${formatMb(bytes)}`,
+    lastResult: {
+      title: 'Last runtime update result',
+      succeeded: 'Runtime update succeeded',
+      failed: 'Runtime update failed',
+      rolledBack: 'Runtime update rolled back (previous version restored)',
+      elevation: 'A system-wide install may show a UAC elevation prompt; declining it fails the swap and rolls back to the previous version.',
+    },
     // ── Update-source editor ──
     sourceHint: 'Where the runtime update manifest is fetched from; saved changes take effect immediately',
     sourceEdit: 'Edit',
@@ -180,6 +267,50 @@ const en: UpdateCopy = {
   installSuccess: 'Update installed — restarting DSH…',
   confirmInstall: 'Confirm install',
   cancel: 'Cancel',
+  // ── Durable update job (active / result / recent) ──
+  job: {
+    kindPluginSet: 'Plugin-set update',
+    kindRuntime: 'HQ Edge runtime update',
+    phase: {
+      queued: 'Queued',
+      resolving: 'Resolving version',
+      downloading: 'Downloading',
+      verifying: 'Verifying integrity',
+      staging: 'Staging files',
+      activating: 'Activating plugin set',
+      'awaiting-host': 'Waiting for host to swap runtime',
+      restarting: 'Restarting',
+      'verifying-after-restart': 'Verifying after restart',
+      done: 'Done',
+      failed: 'Failed',
+      'rolled-back': 'Rolled back',
+      abandoned: 'Abandoned',
+    } as Record<string, string>,
+    willRestartDsh: 'DSH restarts automatically once this finishes; the update continues in the background.',
+    willSwapRuntime: 'HQ Edge downloads the full runtime bundle and exits; the EDA host swaps and relaunches it. A system-wide install may show a UAC prompt.',
+    closeNote: 'Closing this panel does not cancel the update.',
+    bytes: (done: string, total: string) => `${done} / ${total}`,
+    speed: (v: string) => `${v}/s`,
+    eta: (s: string) => `~${s} left`,
+    nextDone: 'Finishing — please wait…',
+    resultDone: 'Update completed',
+    resultFailed: 'Update failed',
+    resultRolledBack: 'Update rolled back',
+    resultAbandoned: 'Update did not complete',
+    retry: 'Retry (start a new update)',
+    recentTitle: 'Recent updates',
+    stepsTitle: 'Per-component progress',
+    logHint: (hint: string) => `Log id: ${hint}`,
+  },
+  // ── Release metadata ──
+  release: {
+    summaryTitle: 'Release notes',
+    notesLink: 'View release notes',
+    breakingTitle: 'Breaking changes',
+    changesTitle: 'What changed',
+    advanced: 'Advanced: update sources',
+    publishedAt: (when: string) => `Published ${when}`,
+  },
 }
 
 export const COPY = { zh, en } as const