dsh-opencode-palette 2.0.6 → 2.0.7

package/lib/client.js

@@ -1,5 +1,5 @@
 /**
- * dsh-opencode-palette v2.0.6 — 浏览器半（构建产物，勿手改）
+ * dsh-opencode-palette v2.0.7 — 浏览器半（构建产物，勿手改）
  * 数据驱动管线：opencode v1.18.12 官方主题 JSON → 颜色解析 → DSH 适配注入
  * 面板「检查更新」：dsh-plugin-update 客户端入口经构建期内联（vendor）
  * 源：src/engine/* + runtime/*.mjs + npm 包 dsh-log / dsh-plugin-update 的客户端入口
@@ -9724,6 +9724,9 @@ __mods["channel"] = { CHANNEL, ENDPOINT, ROUTE_PATH, PLUGIN_ID, PHONE_PREFIX, TA
  * 电话名与轮询间隔由调用方从更新包的客户端入口派生后传进来（本文件不写字面量）。
  */
 
+/** 与 runtime/channel.mjs 的 PLUGIN_ID 同值：本文件是纯逻辑模块，不引运行时模块，故就地声明一次。 */
+const PLUGIN_ID = 'dsh-opencode-palette'
+
 /** 宿主回包 → 面板要的几个事实（纯函数，便于离线核对）。 */
 function readSnapshot(res) {
   const snap = res && res.snapshot ? res.snapshot : null
@@ -9805,6 +9808,9 @@ function createUpdateController(deps) {
     jobMessage: null,
     pending: false,
     failure: null,
+    // 弹窗外的可见结果（{key, kind} 或 null）：失败与「装好了但没进待重启」都走这里，
+    // 否则用户点一下没动静，看不出是成功、失败还是没反应（2026-09-30 真机反馈）。
+    notice: null,
   }
   let pollTimer = null
   const listeners = []
@@ -9821,6 +9827,14 @@ function createUpdateController(deps) {
   function record(level, event, fields, latencyMs) {
     try { log(level, event, fields) } catch (e) { /* 忽略 */ }
   }
+  /** 回包里的错误码（宿主半判词，如 invalid-release / check-failed）；取不到就退成 unknown。
+   *  更新包的失败形状是 {ok:false, error:'<code>', errorKind}——error 是字符串，不是对象。 */
+  function codeOf(res) {
+    const error = res && res.error !== undefined && res.error !== null ? res.error : null
+    if (typeof error === 'string') return error.slice(0, 40)
+    const code = error && (error.code || error.message) ? String(error.code || error.message) : 'unknown'
+    return code.slice(0, 40)
+  }
   function stopPolling() {
     if (pollTimer !== null) {
       try { clearTimer(pollTimer) } catch (e) { /* 忽略 */ }
@@ -9861,7 +9875,7 @@ function createUpdateController(deps) {
       method: phone,
       kind: kind,
       errorHash: hash8(String((error && error.message) || error || kind)),
-      pluginId: 'dsh-opencode-palette',
+      pluginId: PLUGIN_ID,
     })
   }
 
@@ -9874,7 +9888,7 @@ function createUpdateController(deps) {
         latencyMs: Date.now() - startedAt,
         ok: true,
         kind: String((args && args.kind) || phone),
-        pluginId: 'dsh-opencode-palette',
+        pluginId: PLUGIN_ID,
       })
     } else {
       transportFail(phone, 'not-ok', (res && res.error) || 'not-ok')
@@ -9900,19 +9914,34 @@ function createUpdateController(deps) {
     if (!state.available) return 'failed'
     if (state.checking || state.installing) return 'busy'
     // 已查到有新版且凭证还在：直接开弹窗，不重复联网
-    if (state.hasNew && state.checkId) { patch({ dialogOpen: true, failure: null }); return 'new' }
-    patch({ checking: true, failure: null })
+    if (state.hasNew && state.checkId) { patch({ dialogOpen: true, failure: null, notice: null }); return 'new' }
+    patch({ checking: true, failure: null, notice: null })
+    record('info', 'update.check.start', { trigger: 'manual', pluginId: PLUGIN_ID })
+    const startedAt = Date.now()
     try {
       const res = await invoke(phones.updateCheck, {})
       patch({ checking: false })
-      if (!res || res.ok !== true) { return 'failed' }
+      if (!res || res.ok !== true) {
+        const code = codeOf(res)
+        record('warn', 'update.check.fail', { trigger: 'manual', code: code, errorHash: hash8(code), pluginId: PLUGIN_ID })
+        patch({ notice: { key: 'updateCheckFail', kind: 'error' } })
+        return 'failed'
+      }
       const facts = absorb(res)
+      record('info', 'update.check.ok', {
+        trigger: 'manual', hasNew: facts.canInstall, latest: facts.latest || '',
+        latencyMs: Date.now() - startedAt, pluginId: PLUGIN_ID,
+      })
       if (facts.canInstall) { patch({ dialogOpen: true }); return 'new' }
       if (facts.pending) return 'latest'
       return 'latest'
     } catch (e) {
       patch({ checking: false })
       transportFail(phones.updateCheck, 'throw', e)
+      record('warn', 'update.check.fail', {
+        trigger: 'manual', code: 'transport', errorHash: hash8(String((e && e.message) || e)), pluginId: PLUGIN_ID,
+      })
+      patch({ notice: { key: 'updateCheckFail', kind: 'error' } })
       return 'failed'
     }
   }
@@ -9926,16 +9955,29 @@ function createUpdateController(deps) {
     if (state.pending) return 'latest'
     if (state.hasNew && state.checkId) return 'new'
     patch({ checking: true, failure: null })
+    record('info', 'update.check.start', { trigger: 'auto', pluginId: PLUGIN_ID })
+    const startedAt = Date.now()
     try {
       const res = await invoke(phones.updateCheck, {})
       patch({ checking: false })
-      if (!res || res.ok !== true) return 'failed'
+      if (!res || res.ok !== true) {
+        const code = codeOf(res)
+        record('warn', 'update.check.fail', { trigger: 'auto', code: code, errorHash: hash8(code), pluginId: PLUGIN_ID })
+        return 'failed'
+      }
       const facts = absorb(res)
+      record('info', 'update.check.ok', {
+        trigger: 'auto', hasNew: facts.canInstall, latest: facts.latest || '',
+        latencyMs: Date.now() - startedAt, pluginId: PLUGIN_ID,
+      })
       if (facts.canInstall) return 'new'
       return 'latest'
     } catch (e) {
       patch({ checking: false })
       transportFail(phones.updateCheck, 'throw', e)
+      record('warn', 'update.check.fail', {
+        trigger: 'auto', code: 'transport', errorHash: hash8(String((e && e.message) || e)), pluginId: PLUGIN_ID,
+      })
       return 'failed'
     }
   }
@@ -9954,23 +9996,38 @@ function createUpdateController(deps) {
   async function install() {
     if (!state.available || state.installing) return false
     if (!state.checkId) return false
-    patch({ installing: true, failure: null })
+    patch({ installing: true, failure: null, notice: null })
+    record('info', 'update.install.start', { latest: String(state.latest || ''), pluginId: PLUGIN_ID })
     const requestId = 'req-' + String(Date.now()) + '-' + String(Math.floor(Math.random() * 100000))
     try {
       const res = await invoke(phones.updateInstall, { checkId: state.checkId, requestId: requestId })
       patch({ installing: false })
       if (res && res.ok === true) {
-        absorb(res)
+        const facts = absorb(res)
         patch({ dialogOpen: false })
+        record('info', 'update.install.ok', {
+          latest: String((facts && facts.latest) || state.latest || ''),
+          pending: !!(facts && facts.pending),
+          pluginId: PLUGIN_ID,
+        })
+        // 待重启由常驻横幅承接；万一没进待重启，至少留一句「重启后生效」，别让用户对着没动静的按钮猜
+        if (!(facts && facts.pending)) patch({ notice: { key: 'updateRestartHint', kind: 'warn' } })
         return true
       }
       const facts = readSnapshot(res)
+      const code = codeOf(res)
       patch({ blocked: facts.blocked || state.blocked, failure: 'install-failed' })
+      record('warn', 'update.install.fail', { code: code, errorHash: hash8(code), pluginId: PLUGIN_ID })
+      patch({ notice: { key: facts.blocked ? blockedReasonKey(facts.blocked) : 'updateFailInstall', kind: 'error' } })
       await readStatus()
       return false
     } catch (e) {
       patch({ installing: false, failure: 'install-failed' })
       transportFail(phones.updateInstall, 'throw', e)
+      record('warn', 'update.install.fail', {
+        code: 'transport', errorHash: hash8(String((e && e.message) || e)), pluginId: PLUGIN_ID,
+      })
+      patch({ notice: { key: 'updateFailInstall', kind: 'error' } })
       try { await readStatus() } catch (e2) { /* 忽略 */ }
       return false
     }
@@ -9992,6 +10049,8 @@ function createUpdateController(deps) {
     install: install,
     openDialog: function () { patch({ dialogOpen: true }) },
     closeDialog: function () { patch({ dialogOpen: false, failure: null }) },
+    /** 面板其它部件（如日志开关）也能借这行可见提示，别让它们的失败静默掉。 */
+    setNotice: function (key, kind) { patch({ notice: key ? { key: key, kind: kind || 'error' } : null }) },
     dispose: function () { stopPolling(); listeners.length = 0 },
   }
 }
@@ -10031,7 +10090,7 @@ const STORAGE_KEY = 'dsh.opencode-palette.v2'
 const LEGACY_STORAGE_KEY = 'dsh.opencode-tui-theme.v2'
 const DEFAULT_STATE = { enabled: true, theme: 'opencode', mode: 'mono', size: 13, fontKey: 'JetBrains Mono' }
 // 构建时由 scripts/build-client.mjs 替换为 package.json 版本（面板底部署小字）
-const PALETTE_VERSION = '2.0.6'
+const PALETTE_VERSION = '2.0.7'
 
 function getReact() {
   if (typeof require === 'function') { try { return require('react') } catch (e) { /* 动态版无 require */ } }
@@ -10175,6 +10234,14 @@ const I18N = {
   'blocked.incompatible-node': { zh: '新版要求的 Node 更高，先升级 Node', en: 'The new version needs a newer Node — upgrade it first' },
   'blocked.recovery-required': { zh: '上次安装被打断，重新点一次安装', en: 'The last install was interrupted — retry the install' },
   'blocked.unknown': { zh: '当前装不了：重开 DSH 再查一次', en: 'Cannot update right now — reopen DSH and try again' },
+  // 升级已写入但没进「待重启」时的兜底提示（正常路径由常驻横幅承接）
+  updateRestartHint: { zh: '升级已写入，重启 DSH 后生效', en: 'Update written — restart DSH to apply' },
+  // ── 日志开关（面板头行的小开关；开的是 dsh-log 的落盘开关，排障用）──
+  logSwitch: { zh: '日志', en: 'Log' },
+  logOn: { zh: '开', en: 'On' },
+  logOff: { zh: '关', en: 'Off' },
+  logSwitchHint: { zh: '打开后把关键节点写进 <DSH_HOME>/logs/dsh-opencode-palette/（排障用；失败级别的日志恒记，不受此开关控制）', en: 'Write key nodes to <DSH_HOME>/logs/dsh-opencode-palette/ (for troubleshooting; warn/error lines are always kept)' },
+  logSwitchFail: { zh: '日志开关没能写入宿主，请重开面板再试', en: 'The host did not accept the log switch — reopen the panel and retry' },
 }
 
 // 语言检测（回退）：html[lang] 优先，回退浏览器语言
@@ -10258,8 +10325,10 @@ function createClient(slotTarget) {
       pollMs: CLIENT_POLL.defaultMs,
       log: function (level, event, fields) { try { clientLog.log(level, event, fields) } catch (e) { /* 忽略 */ } },
     })
-    // 启动时向宿主对账调试开关（以宿主为准）；宿主不可用时静默，不抛错
-    try { clientLog.reconcileLogSwitch() } catch (e) { /* 忽略 */ }
+    // 启动时向宿主对账调试开关（以宿主为准）；宿主不可用时静默，不抛错。
+    // 面板的日志开关复用这一次对账的结果，不重复打扰宿主（对账失败会记一条 watchdog warn）。
+    let logSwitchReady = null
+    try { logSwitchReady = clientLog.reconcileLogSwitch() } catch (e) { /* 忽略 */ }
     try { clientLog.log('info', 'host.call', { method: 'boot', latencyMs: 0, ok: true, kind: 'boot', pluginId: PLUGIN_ID }) } catch (e) { /* 忽略 */ }
 
     // ── i18n 运行时：语言跟随 DSH（官方 locale 服务为信号源，html[lang] 仅作回退）──
@@ -10864,12 +10933,52 @@ function createClient(slotTarget) {
             ]))
           : null
 
+        // ── 日志开关（排障用的小开关）──
+        // 状态以宿主为准；首帧先按本地缓存渲染，对账回来再校正。开关本体归 dsh-log 管，
+        // 这里只调它的 setLogSwitch，不自己写开关文件（否则会成第二份真源）。
+        const [logOn, setLogOn] = react.useState(!!(clientLog && clientLog.logSwitch && clientLog.logSwitch.enabled))
+        react.useEffect(function () {
+          let alive = true
+          Promise.resolve(props.reconcileLog()).then(function (res) {
+            if (!alive || !res) return
+            if (typeof res.enabled === 'boolean') setLogOn(res.enabled)
+          }, function () { /* 读不到就维持本地缓存值 */ })
+          return function () { alive = false }
+        }, [])
+        const flipLog = function () {
+          const next = !logOn
+          setLogOn(next)
+          Promise.resolve(props.log.setLogSwitch(next)).then(function (res) {
+            const ok = !!(res && res.ok)
+            if (res && typeof res.enabled === 'boolean') setLogOn(res.enabled)
+            else if (!ok) setLogOn(!next)
+            try {
+              props.log.log('info', 'log.switch.set', {
+                enabled: ok ? !!next : logOn,
+                ok: ok,
+                reason: ok ? 'ok' : String((res && res.error) || 'unknown').slice(0, 40),
+                pluginId: PLUGIN_ID,
+              })
+            } catch (e) { /* 忽略 */ }
+            if (!ok) props.update.setNotice('logSwitchFail')
+          }, function () { setLogOn(!next) })
+        }
+
         return h('div', { style: { display: 'flex', flexDirection: 'column', gap: 14, maxWidth: 920 } }, [
           restartBanner,
           // 头行：标题 + 状态开关（一个状态一个控制）
           h('div', { style: { display: 'flex', alignItems: 'center', justifyContent: 'space-between' } }, [
             h('strong', null, '🎨 ' + tr('panelName')),
             h('div', { style: { display: 'inline-flex', alignItems: 'center', gap: 8 } }, [
+              h('span', {
+                key: 'log',
+                onClick: flipLog,
+                title: tr('logSwitchHint'),
+                style: {
+                  fontSize: 11, cursor: 'pointer', userSelect: 'none',
+                  color: logOn ? 'var(--dsw-alias-state-success-primary)' : 'var(--dsw-alias-label-tertiary)',
+                },
+              }, tr('logSwitch') + ' ' + (logOn ? tr('logOn') : tr('logOff'))),
               h('span', { style: { fontSize: 11, color: 'var(--dsw-alias-label-tertiary)' } }, 'v' + PALETTE_VERSION),
               updateButton,
               h('a', {
@@ -10920,6 +11029,18 @@ function createClient(slotTarget) {
           ]),
           h('div', { style: { fontSize: 12, color: muted } },
             tr('subtitle')),
+          // 弹窗之外的可见结果：检查/升级失败、以及「装好了但没进待重启」都在这里落地，
+          // 否则用户点一下没动静，分不清是成功、失败还是没反应。
+          (updState && updState.notice)
+            ? h('div', {
+                style: {
+                  fontSize: 12,
+                  color: updState.notice.kind === 'warn'
+                    ? 'var(--dsw-alias-state-warn-primary)'
+                    : 'var(--dsw-alias-state-error-primary)',
+                },
+              }, tr(updState.notice.key))
+            : null,
           // ── 排印调节（置顶）──
           h('div', { style: secTitle }, [
             h('span', null, tr('typography')),
@@ -10989,6 +11110,11 @@ function createClient(slotTarget) {
           // 检查更新：控制器 + 日志器交给面板（宿主不可用时 update.available 为假，按钮不渲染）
           update: update,
           log: clientLog,
+          // 日志开关的初始状态：复用启动时那次对账，别为显示一个开关再打扰一次宿主
+          reconcileLog: function () {
+            if (logSwitchReady && typeof logSwitchReady.then === 'function') return logSwitchReady
+            try { return clientLog.reconcileLogSwitch() } catch (e) { return Promise.resolve(null) }
+          },
           // 本机字体清单：面板打开下拉时调（要用户手势），未打开下拉不读；失败恒回退预设
           collectFonts: collectFontCandidates,
           // 面板文案（测试/调试用，走同一份双语表）

package/lib/event-list.json

@@ -1,42 +1,87 @@
-{
-  "version": 1,
-  "pluginId": "dsh-opencode-palette",
-  "counts": { "resident": 7, "ondemand": 0, "selfmon": 0 },
-  "events": {
-    "host.call": {
-      "level": "info",
-      "kind": "resident",
-      "fields": ["method", "latencyMs", "ok", "kind", "pluginId"]
-    },
-    "host.call.fail": {
-      "level": "warn",
-      "kind": "resident",
-      "fields": ["method", "kind", "errorHash", "pluginId"]
-    },
-    "update.install.exec": {
-      "level": "info",
-      "kind": "resident",
-      "fields": ["route", "ok", "exitCode", "durationMs", "pluginId"]
-    },
-    "log.forward.summary": {
-      "level": "warn",
-      "kind": "resident",
-      "fields": ["droppedDelta", "totalDropped", "reason", "windowMs"]
-    },
-    "log.switch.watchdog": {
-      "level": "warn",
-      "kind": "resident",
-      "fields": ["op", "timeoutMs", "stage"]
-    },
-    "log.export.fail": {
-      "level": "warn",
-      "kind": "resident",
-      "fields": ["op", "reason", "errorHash"]
-    },
-    "host.channel.fail": {
-      "level": "error",
-      "kind": "resident",
-      "fields": ["stage", "path", "reason"]
-    }
-  }
-}
+{
+  "version": 1,
+  "pluginId": "dsh-opencode-palette",
+  "counts": { "resident": 16, "ondemand": 0, "selfmon": 0 },
+  "events": {
+    "host.call": {
+      "level": "info",
+      "kind": "resident",
+      "fields": ["method", "latencyMs", "ok", "kind", "pluginId"]
+    },
+    "host.call.fail": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["method", "kind", "errorHash", "pluginId"]
+    },
+    "update.install.exec": {
+      "level": "info",
+      "kind": "resident",
+      "fields": ["route", "ok", "exitCode", "durationMs", "pluginId"]
+    },
+    "update.check.start": {
+      "level": "info",
+      "kind": "resident",
+      "fields": ["trigger", "pluginId"]
+    },
+    "update.check.ok": {
+      "level": "info",
+      "kind": "resident",
+      "fields": ["trigger", "hasNew", "latest", "latencyMs", "pluginId"]
+    },
+    "update.check.fail": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["trigger", "code", "errorHash", "pluginId"]
+    },
+    "update.check.retry": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["attempt", "ok", "reason", "pluginId"]
+    },
+    "update.check.probe": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["stage", "httpStatus", "bytes", "reason", "detail", "pluginId"]
+    },
+    "update.install.start": {
+      "level": "info",
+      "kind": "resident",
+      "fields": ["latest", "pluginId"]
+    },
+    "update.install.ok": {
+      "level": "info",
+      "kind": "resident",
+      "fields": ["latest", "pending", "pluginId"]
+    },
+    "update.install.fail": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["code", "errorHash", "pluginId"]
+    },
+    "log.switch.set": {
+      "level": "info",
+      "kind": "resident",
+      "fields": ["enabled", "ok", "reason", "pluginId"]
+    },
+    "log.forward.summary": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["droppedDelta", "totalDropped", "reason", "windowMs"]
+    },
+    "log.switch.watchdog": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["op", "timeoutMs", "stage"]
+    },
+    "log.export.fail": {
+      "level": "warn",
+      "kind": "resident",
+      "fields": ["op", "reason", "errorHash"]
+    },
+    "host.channel.fail": {
+      "level": "error",
+      "kind": "resident",
+      "fields": ["stage", "path", "reason"]
+    }
+  }
+}

package/lib/index.js

@@ -26,6 +26,7 @@ import { dirname, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { createHostLog, registerHostLogPhones } from 'dsh-log/host'
 import { createHostUpdate } from './vendor/dsh-plugin-update/host.js'
+import { buildPhoneNames, DEFAULT_REGISTRY } from './vendor/dsh-plugin-update/config.js'
 import { PLUGIN_ID, PHONE_PREFIX, ROUTE_PATH, TARGET_PACKAGE_NAME } from './channel.mjs'
 
 export const name = PLUGIN_ID
@@ -111,6 +112,189 @@ export function createLogFileService(readTextImpl, writeTextImpl, mkdirImpl, unl
   }
 }
 
+// ── 查更新的自检探针与重试（2026-09-30 加；起因：面板点「检查更新」静默无反应，日志只剩一个散列）──
+// 更新包把 fetch→校验链路里每一步失败都归成同一个 invalid-release（service.js 的兜底 catch），
+// 线上因此只剩 8 位散列，分不清是「响应被截断」还是「tarball 指向了别的源」。
+// 探针按同一条链路再走一遍，但一步一记、绝不抛错：把现象写进日志，而不是只给判词。
+// 重试一次：截断、抖动这类瞬时故障本会自愈，用户不该为它再看一次失败。
+/** 探针阈值：必须与更新包 service.js 里的同名常量一致（tests/update-panel.test.mjs 有门禁比对）。 */
+export const PROBE_LIMITS = {
+  maxBytes: 256 * 1024,
+  integrityPattern: '^sha512-[A-Za-z0-9+/]{86}==$',
+}
+
+/** 取一小段文本进日志：够定位就行，别把整份响应写进去。 */
+function probeBrief(value, limit) {
+  const text = value === null || value === undefined ? '' : String(value)
+  return text.length > limit ? text.slice(0, limit) : text
+}
+
+/**
+ * 按更新包的同一条链路重走一遍发布清单，把观察到的现象原样回给调用方（不抛错）。
+ * @returns {Promise<{stage: string, httpStatus: number|null, bytes: number, reason: string, detail: string}>}
+ */
+export async function probeRelease(fetchImpl, options) {
+  const opts = options || {}
+  const targetName = String(opts.targetPackageName || TARGET_PACKAGE_NAME)
+  const registry = String(opts.registryUrl || DEFAULT_REGISTRY)
+  const timeoutMs = typeof opts.timeoutMs === 'number' && opts.timeoutMs > 0 ? opts.timeoutMs : 10000
+  const limits = opts.limits || PROBE_LIMITS
+  const facts = { stage: 'fetch', httpStatus: null, bytes: 0, reason: 'fetch-threw', detail: '' }
+
+  let response = null
+  try {
+    const signal = typeof AbortSignal !== 'undefined' && typeof AbortSignal.timeout === 'function'
+      ? AbortSignal.timeout(timeoutMs)
+      : undefined
+    response = await fetchImpl(`${registry}${encodeURIComponent(targetName)}/latest`, {
+      headers: { accept: 'application/json' },
+      redirect: 'error',
+      signal: signal,
+    })
+  } catch (e) {
+    facts.detail = probeBrief((e && e.message) || e, 120)
+    return facts
+  }
+
+  facts.stage = 'status'
+  facts.httpStatus = response && typeof response.status === 'number' ? response.status : null
+  if (!response || response.ok !== true) {
+    facts.reason = 'not-ok'
+    return facts
+  }
+
+  facts.stage = 'body'
+  let text = ''
+  try {
+    text = await response.text()
+  } catch (e) {
+    facts.reason = 'body-threw'
+    facts.detail = probeBrief((e && e.message) || e, 120)
+    return facts
+  }
+  facts.bytes = Buffer.byteLength(text, 'utf8')
+  if (facts.bytes > limits.maxBytes) {
+    facts.reason = 'body-too-large'
+    return facts
+  }
+
+  facts.stage = 'json'
+  let value = null
+  try {
+    value = JSON.parse(text)
+  } catch (e) {
+    facts.reason = 'json-parse'
+    facts.detail = probeBrief(text.slice(0, 60), 60)
+    return facts
+  }
+
+  facts.stage = 'name'
+  if (value.name !== targetName) {
+    facts.reason = 'name-mismatch'
+    facts.detail = probeBrief(value.name, 60)
+    return facts
+  }
+
+  facts.stage = 'version'
+  if (!(typeof value.version === 'string' && /^\d+\.\d+\.\d+$/.test(value.version))) {
+    facts.reason = 'version-invalid'
+    facts.detail = probeBrief(value.version, 40)
+    return facts
+  }
+
+  facts.stage = 'engines'
+  if (value.engines && value.engines.node !== undefined && typeof value.engines.node !== 'string') {
+    facts.reason = 'engines-node-type'
+    return facts
+  }
+
+  facts.stage = 'tarball'
+  let tarball = null
+  try {
+    tarball = new URL(String(value.dist && value.dist.tarball))
+  } catch (e) {
+    facts.reason = 'tarball-url'
+    facts.detail = probeBrief(value.dist && value.dist.tarball, 80)
+    return facts
+  }
+  const wantPath = `/${targetName}/-/${targetName}-${value.version}.tgz`
+  if (tarball.origin !== new URL(registry).origin) {
+    facts.reason = 'tarball-origin'
+    facts.detail = probeBrief(tarball.origin, 80)
+    return facts
+  }
+  if (tarball.pathname !== wantPath) {
+    facts.reason = 'tarball-path'
+    facts.detail = probeBrief(tarball.pathname, 80)
+    return facts
+  }
+
+  facts.stage = 'integrity'
+  const integrity = value.dist && value.dist.integrity
+  if (typeof integrity !== 'string') {
+    facts.reason = 'integrity-missing'
+    return facts
+  }
+  if (!new RegExp(limits.integrityPattern).test(integrity)) {
+    facts.reason = 'integrity-shape'
+    facts.detail = probeBrief(integrity, 40)
+    return facts
+  }
+
+  facts.stage = 'ok'
+  facts.reason = 'valid'
+  return facts
+}
+
+/** 从更新包的回包形状里取错误码（没有就退成 unknown）。
+ *  更新包的失败形状是 {ok:false, error:'<code>', errorKind}——error 是字符串，不是对象。 */
+function errorCodeOf(res) {
+  const error = res && res.error !== undefined && res.error !== null ? res.error : null
+  if (typeof error === 'string') return error.slice(0, 40)
+  const code = error && (error.code || error.message) ? String(error.code || error.message) : 'unknown'
+  return code.slice(0, 40)
+}
+
+/**
+ * 给「查更新」这条电话包一层：失败 → 重试一次 → 仍失败则跑探针并落日志。
+ * 只包这一条：查状态与装更新各自有明确的失败语义，重试它们只会拖长用户的等待。
+ */
+export function wrapUpdateCheck(handler, deps) {
+  const input = deps || {}
+  const log = typeof input.log === 'function' ? input.log : function () {}
+  const probe = typeof input.probe === 'function' ? input.probe : null
+  const pluginId = input.pluginId || PLUGIN_ID
+  return async function (args) {
+    const first = await handler(args)
+    if (first && first.ok === true) return first
+    const reason = errorCodeOf(first)
+    log('warn', 'update.check.retry', { attempt: 1, ok: false, reason: reason, pluginId: pluginId })
+    let second = null
+    try {
+      second = await handler(args)
+    } catch (e) {
+      second = null
+    }
+    const recovered = !!(second && second.ok === true)
+    log('warn', 'update.check.retry', { attempt: 2, ok: recovered, reason: reason, pluginId: pluginId })
+    if (recovered) return second
+    if (probe !== null) {
+      try {
+        const facts = await probe()
+        log('warn', 'update.check.probe', {
+          stage: facts.stage,
+          httpStatus: facts.httpStatus,
+          bytes: facts.bytes,
+          reason: facts.reason,
+          detail: facts.detail,
+          pluginId: pluginId,
+        })
+      } catch (e) { /* 探针自己失败不该改变回给面板的结果 */ }
+    }
+    return second || first
+  }
+}
+
 /** 宿主半装配入口：建日志库 → 建更新电话 → 合成电话表 → 注册通道。 */
 export function apply(ctx) {
   const homeDir = dshHomeDir(process.env, homedir())
@@ -144,6 +328,20 @@ export function apply(ctx) {
   )
   for (const phoneName of Object.keys(update.handlers)) registry.set(phoneName, update.handlers[phoneName])
 
+  // 查更新外面再包一层：失败重试一次，仍失败就跑探针把真实原因落日志。
+  // 电话名从更新包派生（本文件不写字面量），装更新与查状态两条保持原样。
+  const updateCheckPhone = buildPhoneNames(PHONE_PREFIX).updateCheck
+  const rawUpdateCheck = registry.get(updateCheckPhone)
+  if (typeof rawUpdateCheck === 'function') {
+    registry.set(updateCheckPhone, wrapUpdateCheck(rawUpdateCheck, {
+      log: function (level, event, fields) {
+        try { hostLog.store.log(level, event, fields) } catch (e) { /* 忽略 */ }
+      },
+      probe: function () { return probeRelease(globalThis.fetch, { targetPackageName: TARGET_PACKAGE_NAME }) },
+      pluginId: PLUGIN_ID,
+    }))
+  }
+
   const fail = function (stage, reason) {
     try { hostLog.store.log('error', 'host.channel.fail', { stage: stage, path: ROUTE_PATH, reason: String(reason).slice(0, 120) }) } catch (e) { /* 忽略 */ }
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-opencode-palette",
-  "version": "2.0.6",
+  "version": "2.0.7",
   "description": "让 DeepSeek Harness 穿上 38 款经典皮肤——东京的霓虹夜色、德古拉的暗红月光、复古工坊的暖黄灯火、黑客帝国的数字雨、玫瑰松林间的风……一键换肤，即点即换，重启不丢。38 legendary skins for DeepSeek Harness — tokyonight's neon dusk, dracula's crimson moon, gruvbox's retro glow, the matrix's digital rain, rose-pine's rosewood calm… one click, instant, persisted.",
   "type": "module",
   "main": "lib/index.js",