dsh-m 0.9.44 → 0.9.46

package/lib/client.js

@@ -30,6 +30,7 @@ __export(market_state_exports, {
   MARKET_PAGE_SIZES: () => MARKET_PAGE_SIZES,
   createZoneState: () => createZoneState,
   marketNotice: () => marketNotice,
+  mergeLatestFields: () => mergeLatestFields,
   normalizeMarketQuery: () => normalizeMarketQuery,
   normalizeMarketResponse: () => normalizeMarketResponse,
   pageItems: () => pageItems,
@@ -209,7 +210,27 @@ function marketNotice(registryState, community) {
   if (notice) out.notice = notice;
   return out;
 }
-var MARKET_PAGE_SIZES, DEFAULT_PAGE_SIZE, CURATED_ORDER, CURATED_LABELS, CURATED_IDS, SLUG_RE, SORT_FIELDS, sameSort, FALLBACK_REGISTRY_STATE, FALLBACK_COMMUNITY;
+function mergeLatestFields(nextItems, prevItems) {
+  if (!Array.isArray(nextItems) || !Array.isArray(prevItems) || prevItems.length === 0) return nextItems;
+  const prevById = new Map(prevItems.map((it) => [it && it.id, it]));
+  let touched = false;
+  const out = nextItems.map((it) => {
+    if (!it || typeof it !== "object") return it;
+    const hasLatest = it.latestVersion !== void 0 || it.latestTag !== void 0 || it.latestSha !== void 0 || it.latestError !== void 0;
+    if (hasLatest) return it;
+    const prev = prevById.get(it.id);
+    if (!prev) return it;
+    const patch = {};
+    for (const k of LATEST_MERGE_FIELDS) {
+      if (it[k] === void 0 && prev[k] !== void 0) patch[k] = prev[k];
+    }
+    if (Object.keys(patch).length === 0) return it;
+    touched = true;
+    return { ...it, ...patch };
+  });
+  return touched ? out : nextItems;
+}
+var MARKET_PAGE_SIZES, DEFAULT_PAGE_SIZE, CURATED_ORDER, CURATED_LABELS, CURATED_IDS, SLUG_RE, SORT_FIELDS, sameSort, FALLBACK_REGISTRY_STATE, FALLBACK_COMMUNITY, LATEST_MERGE_FIELDS;
 var init_market_state = __esm({
   "src/client/market-state.js"() {
     "use strict";
@@ -253,6 +274,7 @@ var init_market_state = __esm({
       errors: [],
       warnings: []
     };
+    LATEST_MERGE_FIELDS = ["latestVersion", "latestTag", "latestSha", "latestError", "latestErrorCode", "outdated"];
   }
 });
 
@@ -1247,7 +1269,7 @@ var h = React.createElement;
 var { useState, useEffect, useLayoutEffect, useCallback, useMemo, useRef } = React;
 var PLUGIN_ID = "dsh-m";
 var API = "/dshm";
-var { DEFAULT_PAGE_SIZE: DEFAULT_PAGE_SIZE2, MARKET_PAGE_SIZES: MARKET_PAGE_SIZES2, pageItems: pageItems2, createZoneState: createZoneState2, normalizeMarketQuery: normalizeMarketQuery2, resetPageOnFilterChange: resetPageOnFilterChange2, normalizeMarketResponse: normalizeMarketResponse2, registryNotice: registryNotice2, zoneChips: zoneChips2, marketNotice: marketNotice2, searchSourceOf: searchSourceOf2 } = (init_market_state(), __toCommonJS(market_state_exports));
+var { DEFAULT_PAGE_SIZE: DEFAULT_PAGE_SIZE2, MARKET_PAGE_SIZES: MARKET_PAGE_SIZES2, pageItems: pageItems2, createZoneState: createZoneState2, normalizeMarketQuery: normalizeMarketQuery2, resetPageOnFilterChange: resetPageOnFilterChange2, normalizeMarketResponse: normalizeMarketResponse2, registryNotice: registryNotice2, zoneChips: zoneChips2, marketNotice: marketNotice2, searchSourceOf: searchSourceOf2, mergeLatestFields: mergeLatestFields2 } = (init_market_state(), __toCommonJS(market_state_exports));
 var { readMarketSnapshot: readMarketSnapshot2, writeMarketSnapshot: writeMarketSnapshot2, isDefaultFirstPageQuery: isDefaultFirstPageQuery2 } = (init_market_snapshot(), __toCommonJS(market_snapshot_exports));
 var { backdropCloseHandlers: backdropCloseHandlers2 } = (init_backdrop(), __toCommonJS(backdrop_exports));
 var { createMarkdown: createMarkdown2 } = (init_markdown(), __toCommonJS(markdown_exports));
@@ -1330,6 +1352,10 @@ var ZH = {
   "common.none": "\u2014",
   "market.loading": "\u52A0\u8F7D\u6536\u5F55\u6E05\u5355\u4E2D\u2026 ",
   "market.empty": "\u65E0\u5339\u914D\u63D2\u4EF6\uFF0C\u8BD5\u8BD5\u5176\u4ED6\u5173\u952E\u8BCD\u6216\u5206\u7C7B",
+  "market.retry": "\u91CD\u8BD5",
+  "market.empty.category": "\u8BE5\u5206\u7C7B\u6682\u65E0\u6536\u5F55\uFF0C\u6362\u4E2A\u6876\u6216\u6E05\u7A7A\u7B5B\u9009\u770B\u770B",
+  "market.empty.unavailable": "\u6536\u5F55\u6E05\u5355\u4E0D\u53EF\u7528\uFF0C\u6682\u65F6\u65E0\u6CD5\u5217\u51FA\u63D2\u4EF6",
+  "chips.crossbucket.tip": "\u8DE8\u6876\u6761\u76EE\u4F1A\u5728\u591A\u4E2A\u5206\u7C7B\u91CD\u590D\u8BA1\u6570\uFF0C\u6545\u5206\u7C7B\u8BA1\u6570\u4E4B\u548C\u5927\u4E8E\u603B\u6570",
   "installed.loading": "\u8BFB\u53D6\u5DF2\u88C5\u5217\u8868\u4E2D\u2026 ",
   "installed.empty": "\u5F53\u524D profile \u5C1A\u672A\u5B89\u88C5\u4EFB\u4F55 dsh \u63D2\u4EF6",
   "installed.none": "\u672A\u5B89\u88C5",
@@ -1600,6 +1626,10 @@ var EN = {
   "common.none": "\u2014",
   "market.loading": "Loading listings\u2026 ",
   "market.empty": "No matching plugins \u2014 try another keyword or category",
+  "market.retry": "Retry",
+  "market.empty.category": "Nothing curated in this category yet \u2014 try another bucket or clear the filter",
+  "market.empty.unavailable": "Registry unavailable \u2014 listings are temporarily down",
+  "chips.crossbucket.tip": "Cross-bucket entries count in every bucket, so chip counts add up above the total",
   "installed.loading": "Reading installed list\u2026 ",
   "installed.empty": "No DSH plugins installed in this profile",
   "installed.none": "Not installed",
@@ -1885,6 +1915,7 @@ var CSS = `
 .dsvm-filteropt.on{color:var(--dsw-alias-state-business-primary,#4d6bfe);font-weight:600}
 .dsvm-filtercheck{font-size:11px}
 .dshm-chip{border:1px solid var(--dsw-alias-border-l2,#e5e7eb);background:transparent;color:var(--dsw-alias-label-secondary,#4b5563);border-radius:999px;padding:2px 10px;font:inherit;font-size:11px;cursor:pointer}
+.dshm-chip.zero{opacity:.55}
 .dshm-chip:hover{background:var(--dsw-alias-interactive-bg-hover,rgba(38,49,72,.06))}
 .dshm-chip.on{background:var(--dsw-specific-sidebar-nav-item-active,rgba(38,49,72,.08));border-color:transparent;color:var(--dsw-alias-label-primary,inherit);font-weight:500}
 .dsvm-chipswrap{position:sticky;top:-14px;z-index:5;background:var(--dsw-alias-bg-base,#fff);padding:8px 0;margin:-8px 0;border-bottom:1px solid var(--dsw-alias-border-l1,rgba(127,127,127,.14))}
@@ -2118,7 +2149,7 @@ function useMarketData(zone = "community") {
   const queryRef = useRef(query);
   const dataRef = useRef(boot.data);
   const storage = () => typeof window !== "undefined" && window.localStorage ? window.localStorage : null;
-  const fetchPage = useCallback((nextQuery, force, background = false) => {
+  const fetchPage = useCallback((nextQuery, force, background = false, probeMode = "cache-only") => {
     const gen = ++genRef.current;
     abortRef.current?.abort();
     const ac = new AbortController();
@@ -2135,15 +2166,23 @@ function useMarketData(zone = "community") {
       ...nextQuery.sort ? { sort: nextQuery.sort } : {},
       offset: nextQuery.offset,
       limit: nextQuery.limit,
+      // 0.9.45 两段加载（ADR-0013）：第一段 cache-only 零网络回页；'full' 为终态语义不下传（core 缺省等价）
+      ...probeMode !== "full" ? { probeMode } : {},
       ...force ? { force: true } : {}
     };
     return api("market", params, ac.signal).then((raw) => {
       if (genRef.current !== gen || ac.signal.aborted) return;
       const next = normalizeMarketResponse2(raw);
-      dataRef.current = next;
-      setData(next);
+      const prevItems = dataRef.current && Array.isArray(dataRef.current.items) ? dataRef.current.items : null;
+      const mergedItems = mergeLatestFields2(next.items, prevItems);
+      const merged = mergedItems === next.items ? next : { ...next, items: mergedItems };
+      dataRef.current = merged;
+      setData(merged);
       setLoading(false);
-      if (isDefaultFirstPageQuery2(nextQuery, zone)) writeMarketSnapshot2(storage(), { zone, response: next });
+      if (probeMode === "cache-only" && next.latestComplete === false) {
+        return fetchPage(nextQuery, force, true, "full");
+      }
+      if (isDefaultFirstPageQuery2(nextQuery, zone)) writeMarketSnapshot2(storage(), { zone, response: merged });
     }).catch((e) => {
       if (genRef.current !== gen || ac.signal.aborted) return;
       if (background && dataRef.current) return;
@@ -2157,7 +2196,7 @@ function useMarketData(zone = "community") {
     setQuery(next);
     if (opts.fetch !== false) fetchPage(next, opts.force);
   }, [fetchPage]);
-  const reload = useCallback((force) => fetchPage(queryRef.current, force), [fetchPage]);
+  const reload = useCallback((force) => fetchPage(queryRef.current, force, false, "full"), [fetchPage]);
   useEffect(() => {
     fetchPage(queryRef.current, false, boot.has);
     return () => abortRef.current?.abort();
@@ -2371,7 +2410,7 @@ function SearchBox({ placeholder, initial, onCommit }) {
     }, h(XIcon)) : null
   );
 }
-function ZoneChips({ zone, counts, labels, active, onPick, trailing }) {
+function ZoneChips({ zone, counts, labels, active, onPick, trailing, wrapTitle }) {
   const chips = useMemo(() => zoneChips2(counts, labels, zone), [counts, labels, zone]);
   const [expanded, setExpanded] = useState(false);
   const [stuck, setStuck] = useState(false);
@@ -2423,8 +2462,9 @@ function ZoneChips({ zone, counts, labels, active, onPick, trailing }) {
   const hidden = chips.length - shown.length;
   const btn = (c) => h(
     "button",
-    { key: c.id, "data-chip": "1", className: `dshm-chip${active === c.id ? " on" : ""}`, onClick: () => onPick(active === c.id ? null : c.id) },
-    `${c.labelKey ? lookup(c.labelKey) : c.label}${c.count ? ` ${c.count}` : ""}`
+    { key: c.id, "data-chip": "1", className: `dshm-chip${active === c.id ? " on" : ""}${c.count === 0 ? " zero" : ""}`, onClick: () => onPick(active === c.id ? null : c.id) },
+    // 0.9.45 U3/U7：0 计数桶显式渲染「0」+ 降透明（社区区 chip 计数恒 >0，行为不变）
+    `${c.labelKey ? lookup(c.labelKey) : c.label} ${c.count || 0}`
   );
   return h(
     React.Fragment,
@@ -2435,7 +2475,7 @@ function ZoneChips({ zone, counts, labels, active, onPick, trailing }) {
       { className: "dsvm-chipswrap" },
       h(
         "div",
-        { ref: wrapRef, className: "dshm-chips" },
+        { ref: wrapRef, className: "dshm-chips", title: wrapTitle || void 0 },
         h("button", { "data-chip": "1", className: `dshm-chip${active == null ? " on" : ""}`, onClick: () => onPick(null) }, lookup("cat.all")),
         ...shown.map(btn),
         hidden > 0 ? h(
@@ -2479,7 +2519,20 @@ function Shot({ src, onClick }) {
   }, []);
   return h(
     "div",
-    { ref, className: "dsvm-shotbox", onClick, role: "button", tabIndex: 0 },
+    {
+      ref,
+      className: "dsvm-shotbox",
+      onClick,
+      role: "button",
+      tabIndex: 0,
+      // 0.9.45 U8：键盘可达（此前 role=button 但键盘无法开灯箱）
+      onKeyDown: (e) => {
+        if ((e.key === "Enter" || e.key === " ") && !e.isComposing) {
+          e.preventDefault();
+          onClick();
+        }
+      }
+    },
     show ? h("img", { className: "dsvm-shot", src, alt: "", loading: "lazy", referrerPolicy: "no-referrer", fetchPriority: "low" }) : null
   );
 }
@@ -2512,11 +2565,16 @@ function useModalDepth(active) {
     };
   }, [active]);
 }
-function DetailModal({ it, labels, busy, onClose, onInstall, profileKind, installRec, installNote }) {
+function DetailModal({ it, labels, busy, onClose, onInstall, onUpgrade, upgradeBusy, upgradeRec, profileKind, installRec, installNote }) {
   useModalDepth(true);
   const shots = it.community === true ? safeScreenshots(it) : [];
   const [lb, setLb] = useState(null);
   const [copied, setCopied] = useState(false);
+  const [rmOpen, setRmOpen] = useState(false);
+  const closeRef = useRef(null);
+  useEffect(() => {
+    if (closeRef.current) closeRef.current.focus();
+  }, []);
   useEffect(() => {
     const onKey = (e) => {
       if (e.key === "Escape") {
@@ -2549,7 +2607,7 @@ function DetailModal({ it, labels, busy, onClose, onInstall, profileKind, instal
     { className: "dsvm-modal", ...backdropCloseHandlers2(onClose) },
     h(
       "div",
-      { className: "dsvm-modalbox", onClick: (e) => e.stopPropagation() },
+      { className: "dsvm-modalbox", role: "dialog", "aria-modal": "true", "aria-label": it.name, onClick: (e) => e.stopPropagation() },
       h(
         "div",
         { className: "dsvm-modalhead" },
@@ -2563,7 +2621,7 @@ function DetailModal({ it, labels, busy, onClose, onInstall, profileKind, instal
         it.community === true ? h("span", { className: "dshm-badge info" }, lookup("badge.community")) : null,
         h("span", { className: "dshm-badge info" }, it.source === "npm" ? "npm" : "github"),
         h("span", { className: "dshm-spacer" }),
-        h("button", { className: "dshm-xbtn", "aria-label": lookup("common.close"), title: lookup("common.close"), onClick: onClose }, h(XIcon))
+        h("button", { ref: closeRef, className: "dshm-xbtn", "aria-label": lookup("common.close"), title: lookup("common.close"), onClick: onClose }, h(XIcon))
       ),
       it.community === true ? h(
         "div",
@@ -2577,7 +2635,7 @@ function DetailModal({ it, labels, busy, onClose, onInstall, profileKind, instal
         "dl",
         { className: "dsvm-kv" },
         kv(lookup("modal.category"), catLabel),
-        it.added ? kv(lookup("modal.added"), it.added) : null,
+        it.added ? kv(lookup("modal.added"), fmtDate(it.added)) : null,
         it.community === true ? kv(
           lookup("modal.dlwindow"),
           typeof it.downloads === "number" ? h("span", { title: String(it.downloads) }, `${compactCount(it.downloads)}\uFF08${it.downloadsStart || "?"} ~ ${it.downloadsEnd || "?"}${it.downloadsCheckedAt ? `\uFF0C${lookup("modal.checkedat")} ${it.downloadsCheckedAt}` : ""}\uFF09`) : lookup("modal.dlnone")
@@ -2591,6 +2649,14 @@ function DetailModal({ it, labels, busy, onClose, onInstall, profileKind, instal
         it.deprecated === true && it.replacement ? kv(lookup("modal.replacement"), it.replacement) : null
       ),
       h("div", { className: "dshm-desc", style: { WebkitLineClamp: "unset" } }, descFull),
+      it.npm ? h(
+        "details",
+        { className: "dsvm-fold", onToggle: (e) => {
+          if (e.target.open) setRmOpen(true);
+        } },
+        h("summary", null, lookup("readme.show")),
+        rmOpen ? h(ReadmeBlock, { pkg: it.npm }) : h("div", { className: "dshm-hint" }, lookup("readme.loading"))
+      ) : null,
       shots.length ? h(
         "div",
         { className: "dsvm-shotrow" },
@@ -2623,12 +2689,18 @@ function DetailModal({ it, labels, busy, onClose, onInstall, profileKind, instal
       // installRec 派生自全局操作记录（DESIGN §2.6「状态不挂卡片」的所有权模型不变，此处只是展示）：
       // 仅 queued/running 挂行，input（兼容待决）走上层 CompatDialog；installNote 为本次终态摘要。
       installRec && (installRec.status === "running" || installRec.status === "queued") ? h(ProgressLine, { key: "opprog" }) : null,
+      upgradeRec && (upgradeRec.status === "running" || upgradeRec.status === "queued") ? h(ProgressLine, { key: "upprog" }) : null,
       installNote ? h("div", { key: "opnote", className: installNote.kind === "err" ? "dshm-err" : installNote.kind === "hint" ? "dshm-hint" : "dshm-ok" }, installNote.text) : null,
       installNote && installNote.kind === "ok" ? h("div", { key: "opnote-rh", className: "dshm-hint" }, lookup(profileKind === "desktop" ? "profile.restartHint" : "banner.done")) : null,
       h(
         "div",
         { className: "dsvm-modalactions" },
-        it.installed ? h("span", { className: "dshm-hint" }, lookup("manage.hint")) : h("button", { className: "dshm-btn primary", disabled: busy, onClick: () => onInstall(it) }, busy ? h(Spin) : lookup("action.install"))
+        it.installed ? h(
+          React.Fragment,
+          null,
+          it.outdated ? h("button", { className: "dshm-btn primary", disabled: upgradeBusy, onClick: () => onUpgrade(it) }, upgradeBusy ? h(Spin) : lookup("action.upgrade")) : null,
+          h("span", { className: "dshm-hint" }, lookup("manage.hint"))
+        ) : h("button", { className: "dshm-btn primary", disabled: busy, onClick: () => onInstall(it) }, busy ? h(Spin) : lookup("action.install"))
       )
     ),
     lb !== null && shots.length ? h(Lightbox, { shots, index: lb, onNav: setLb, onClose: () => setLb(null) }) : null
@@ -2661,6 +2733,7 @@ function MarketTab({ notify, markets, onMutation, ops, favorites, profileKind })
   const [pageJump, setPageJump] = useState("");
   const activeInstallRec = ops.records.find((r) => r.kind === "install" && (r.status === "running" || r.status === "queued" || r.status === "input")) || null;
   const activeInstallTarget = activeInstallRec ? activeInstallRec.target : null;
+  const activeUpgradeRec = ops.records.find((r) => r.kind === "upgrade" && (r.status === "running" || r.status === "queued" || r.status === "input")) || null;
   const [installNote, setInstallNote] = useState(null);
   const items = data && data.items || [];
   const total = data && data.total || 0;
@@ -2753,6 +2826,36 @@ function MarketTab({ notify, markets, onMutation, ops, favorites, profileKind })
       }
     }
   };
+  const doUpgrade = async (it) => {
+    try {
+      const res = await ops.runOp("upgrade", it.installedPkg, () => api("upgrade", { pkg: it.installedPkg }));
+      const note = upgradeNotify2(res.activation);
+      const text = lookup("notify.upgraded", { pkg: res.pkg, from: res.fromVersion ? `v${res.fromVersion}` : "\u2014", to: res.version ? `v${res.version}` : res.sha ? res.sha.slice(0, 7) : "latest" }) + (res.buildApprovals && res.buildApprovals.length ? lookup("notify.builds", { names: res.buildApprovals.join(", ") }) : res.fallbackAllBuilds ? lookup("notify.builds.fallback") : "") + (note.suffixKey ? lookup(note.suffixKey) : "");
+      notify({ kind: "ok", needsRestart: note.needsRestart, text });
+      setInstallNote({ id: it.id, kind: "ok", text });
+      await (onMutation ? onMutation() : void 0);
+    } catch (e) {
+      if (e && e.opSuperseded) {
+        const sup = lookup("op.superseded.note", { target: it.installedPkg });
+        notify({ kind: "ok", text: sup });
+        setInstallNote({ id: it.id, kind: "hint", text: sup });
+      } else if (e && e.guard) {
+        const guardText = [
+          lookup("guard.blocked"),
+          `${lookup("guard.compstatus")}: ${e.guard.compensation?.status || "\u2014"}\uFF08${e.guard.compensation?.note || ""}\uFF09`,
+          e.guard.repairBasis ? `${lookup("guard.repairbasis")}: ${e.guard.repairBasis}` : null,
+          lookup("guard.noforce"),
+          e.guard.restartSafe ? lookup("guard.restartsafenow") : lookup("guard.restartunsafe")
+        ].filter(Boolean).join(" | ");
+        notify({ kind: "err", text: guardText });
+        setInstallNote({ id: it.id, kind: "err", text: guardText });
+      } else {
+        const failText = lookup("failed.upgrade", { err: e && e.message || e });
+        notify({ kind: "err", text: failText });
+        setInstallNote({ id: it.id, kind: "err", text: failText });
+      }
+    }
+  };
   const CompatDialog = compatConfirm ? h(
     "div",
     { className: "dshm-compat-overlay", ...backdropCloseHandlers2(() => setCompatConfirm(null)) },
@@ -2824,6 +2927,9 @@ function MarketTab({ notify, markets, onMutation, ops, favorites, profileKind })
         busy: activeInstallTarget === favDetailItem.id,
         onClose: () => setFavDetailItem(null),
         onInstall: (it2) => doInstall(it2),
+        onUpgrade: (it2) => doUpgrade(it2),
+        upgradeBusy: activeUpgradeRec != null,
+        upgradeRec: activeUpgradeRec && activeUpgradeRec.target === favDetailItem.installedPkg ? activeUpgradeRec : null,
         profileKind,
         installRec: activeInstallRec && activeInstallRec.target === favDetailItem.id ? activeInstallRec : null,
         installNote: installNote && installNote.id === favDetailItem.id ? installNote : null
@@ -2964,12 +3070,27 @@ function MarketTab({ notify, markets, onMutation, ops, favorites, profileKind })
       labels: communityLabels(data),
       active: query.category,
       onPick: (id) => updateQuery({ category: id, offset: 0 }),
-      trailing: filterTrigger
+      trailing: filterTrigger,
+      // 0.9.45 U3：跨桶条目在每桶双计（alsoCategories）→ Σchips 可大于总数；有跨桶时给容器 title 说明
+      wrapTitle: zone === "primary" && data ? Object.values(counts).reduce((a, b) => a + (Number(b) || 0), 0) > (data.registryState && data.registryState.count || 0) ? lookup("chips.crossbucket.tip") : void 0 : void 0
     }),
     // 0.9.15：安装目标条目的详情 Modal 打开时，进度行入 Modal、底层行让位（避免隔着遮罩双重透出）；
     // Modal 关闭后底层行照常回归（关闭弹窗的安装仍可见）
     activeInstallTarget && !(detailItem && detailItem.id === activeInstallTarget) ? h(ProgressLine, { key: "prog" }) : null,
-    loading && !data ? h("div", { className: "dshm-empty" }, lookup("market.loading"), Spin()) : error ? h("div", { className: "dshm-err" }, lookup("failed.load", { err: error })) : items.length === 0 ? h("div", { className: "dshm-empty" }, lookup("market.empty")) : h(
+    loading && !data ? h("div", { className: "dshm-empty" }, lookup("market.loading"), Spin()) : error ? h(
+      "div",
+      { className: "dshm-err" },
+      lookup("failed.load", { err: error }),
+      " ",
+      // 0.9.45 U9：错误就地恢复出口（此前只能关开面板或绕道设置页）
+      h("button", { className: "dshm-btn sm", onClick: () => reload(false) }, lookup("market.retry"))
+    ) : items.length === 0 ? h(
+      "div",
+      { className: "dshm-empty" },
+      lookup(
+        data && data.registryState.status === "unavailable" && !query.query && !query.category ? "market.empty.unavailable" : query.category ? "market.empty.category" : "market.empty"
+      )
+    ) : h(
       React.Fragment,
       null,
       h(
@@ -3008,6 +3129,9 @@ function MarketTab({ notify, markets, onMutation, ops, favorites, profileKind })
       busy: activeInstallTarget === detailItem.id,
       onClose: () => setDetailId(null),
       onInstall: (it2) => doInstall(it2),
+      onUpgrade: (it2) => doUpgrade(it2),
+      upgradeBusy: activeUpgradeRec != null,
+      upgradeRec: activeUpgradeRec && activeUpgradeRec.target === detailItem.installedPkg ? activeUpgradeRec : null,
       profileKind,
       installRec: activeInstallRec && activeInstallRec.target === detailItem.id ? activeInstallRec : null,
       installNote: installNote && installNote.id === detailItem.id ? installNote : null
@@ -3253,7 +3377,7 @@ function regSourceLabel(data) {
 function configStatusLabel(status) {
   return lookup(`settings.status.${status || "loading"}` || "settings.status.loading");
 }
-function SettingsTab({ notify, onRegistryChanged }) {
+function SettingsTab({ notify, onRegistryChanged, onForceMarket }) {
   const reg = useAsync((force) => api("registry", force ? { force: true } : {}), []);
   const cfgState = useAsync(() => api("registry-config"), []);
   const [busy, setBusy] = useState(false);
@@ -3275,6 +3399,7 @@ function SettingsTab({ notify, onRegistryChanged }) {
     try {
       await reg.reload(true);
       await reloadRegistryState().catch(() => void 0);
+      onForceMarket?.();
       notify({ kind: "ok", text: lookup("registry.refreshed"), needsRestart: false });
     } finally {
       setBusy(false);
@@ -3524,7 +3649,7 @@ function snapshotOf(it) {
     categoryLabel: it.categoryLabel,
     source: it.source
   };
-  for (const k of ["descriptionEn", "npm", "github", "homepage", "owner", "downloads", "stars", "added", "deprecated"]) {
+  for (const k of ["descriptionEn", "npm", "github", "homepage", "owner", "downloads", "stars", "added", "deprecated", "verified", "audience", "decoupled"]) {
     if (it[k] !== void 0 && it[k] !== null) s[k] = it[k];
   }
   return s;
@@ -3583,7 +3708,10 @@ function FavoriteZone({ favorites, onOpen }) {
           name: s.name,
           badges: [
             s.deprecated === true ? h("span", { className: "dshm-badge warn", key: "dep" }, lookup("badge.deprecated")) : null,
-            s.owner ? h("span", { className: "dshm-badge info", key: "c" }, lookup("badge.community")) : null,
+            // 0.9.45 U12（R7 收窄）：无 owner = 精选条目——补「精选」身份徽标；verified 质量徽标恢复；
+            // 受众/解耦徽标不进收藏区（DESIGN §2.7 裁决⑤「已装视图与收藏页不打标」），快照仅存字段
+            s.owner ? h("span", { className: "dshm-badge info", key: "c" }, lookup("badge.community")) : h("span", { className: "dshm-badge", key: "cz" }, lookup("zone.primary")),
+            Array.isArray(s.verified) && s.verified.length && s.community !== true ? h("span", { className: "dshm-badge", key: "v", title: s.verified.join("\u3001") }, lookup("badge.verified")) : null,
             h("span", { className: "dshm-badge info", key: "s" }, s.source === "npm" ? "npm" : "github"),
             isStale ? h("span", { className: "dshm-badge warn", key: "st" }, lookup("favorites.stalebadge")) : null
           ],
@@ -3962,7 +4090,7 @@ function MarketPanel({ onClose }) {
         { className: "dshm-body" },
         tab === "market" ? h(MarketTab, { notify, markets, onMutation: refreshViews, ops, favorites, profileKind: profile?.kind ?? null }) : null,
         tab === "installed" ? h(InstalledTab, { notify, installed, updates, onMutation: refreshViews, ops }) : null,
-        tab === "settings" ? h(SettingsTab, { notify, onRegistryChanged }) : null,
+        tab === "settings" ? h(SettingsTab, { notify, onRegistryChanged, onForceMarket: () => marketReloadAll(true) }) : null,
         h(OperationsPanel, {
           records: opRecords,
           onClearFinished: () => {

package/lib/core/host-api.js

@@ -13,7 +13,7 @@ import { runDoctor } from './doctor.js';
 import { listInstalledWithMeta, listMarket, installFromRegistry, selfUpgrade, uninstallPlugin, upgradePlugin, InstallGuardError, } from './market.js';
 import { runProfileTransaction, TransactionError } from './profile-transaction.js';
 import { readInstalledPluginReadme } from './installed.js';
-import { isNewerVersion, npmLatest } from './versions.js';
+import { isNewerVersion, npmLatest, npmPackumentReadme } from './versions.js';
 import { getCommunitySummary } from './community.js';
 import { RegistryConfigError } from './registry-controller.js';
 import { checkRegistryEntries } from './registry-check.js';
@@ -216,6 +216,8 @@ export function createApiDispatcher(ctx) {
         selfUpgrade: ctx.deps?.selfUpgrade ?? selfUpgrade,
         checkRegistryEntries: ctx.deps?.checkRegistryEntries ?? checkRegistryEntries,
         npmLatest: ctx.deps?.npmLatest ?? npmLatest,
+        readInstalledPluginReadme: ctx.deps?.readInstalledPluginReadme ?? readInstalledPluginReadme,
+        npmPackumentReadme: ctx.deps?.npmPackumentReadme ?? npmPackumentReadme,
         getCommunitySummary: ctx.deps?.getCommunitySummary ?? getCommunitySummary,
         runTransaction: ctx.deps?.runTransaction ?? runProfileTransaction,
         scheduleRestart: ctx.deps?.scheduleRestart ?? scheduleRestart,
@@ -362,6 +364,11 @@ export function createApiDispatcher(ctx) {
                             throw new ApiProtocolError(400, '非法 sort: 需 { field: downloads|stars|added, dir: asc|desc }');
                         }
                     }
+                    // probeMode 两态（0.9.45 市场页两段加载，ADR-0013）：GUI 两段式自带；非法值 400（与 source/sort 同款不静默吞）
+                    const probeModeRaw = typeof body.probeMode === 'string' ? body.probeMode : undefined;
+                    if (probeModeRaw !== undefined && probeModeRaw !== 'full' && probeModeRaw !== 'cache-only') {
+                        throw new ApiProtocolError(400, `非法 probeMode: ${probeModeRaw}（需 full/cache-only）`);
+                    }
                     const result = await d.listMarket(cfg(), {
                         query: strArg(body, 'query'),
                         category,
@@ -374,6 +381,7 @@ export function createApiDispatcher(ctx) {
                         limit,
                         force: boolArg(body.force),
                         withLatest: true,
+                        probeMode: probeModeRaw,
                         namespace: 'host',
                         // 0.9.5 双 profile 读路径接线（实机回归 2026-10-01）：desktop 下市场「已安装」
                         // 徽标此前漏传 profile → listMarket 内部落回 webProfileDir，已装徽标恒空。
@@ -430,8 +438,23 @@ export function createApiDispatcher(ctx) {
                     const target = strArg(body, 'pkg');
                     if (!target)
                         throw new ApiProtocolError(400, '缺少 pkg');
-                    // 0.9.0 双 profile：README 只读当前 profile 的 node_modules
-                    const result = await readInstalledPluginReadme(target, profile.dir);
+                    // 0.9.0 双 profile：README 优先只读当前 profile 的 node_modules；
+                    // 0.9.45 U10b 修复：市场/收藏详情 Modal 的 README 折叠页对「未安装」条目也会发起读取
+                    // （装前决策场景）——本地未装时回源 npm packument 顶层 readme 字段兜底；
+                    // 兜底也失败（离线等）则抛原始本地错误，不冒充成功。
+                    let result;
+                    try {
+                        result = await d.readInstalledPluginReadme(target, profile.dir);
+                    }
+                    catch (localErr) {
+                        try {
+                            const fallback = await d.npmPackumentReadme(target);
+                            result = { pkg: target, name: target, readme: fallback.readme, truncated: false };
+                        }
+                        catch {
+                            throw localErr;
+                        }
+                    }
                     payload = { ...result };
                     break;
                 }

package/lib/core/latest-cache.js

@@ -35,6 +35,14 @@ export function readLatestCache(key, ttlMin) {
     }
     return entry.value;
 }
+/**
+ * peek 读取（0.9.45，ADR-0013）：不判 TTL、不删除——供 force 全页重探时旧值兜底展示。
+ * 落实 ADR-0006 在案约束：「force 穿透须用 peek 不删除语义，而非 ttlMin=0 先删后探（失败时旧值丢失）」；
+ * force 重探成功覆盖缓存，失败保留旧值 + latestError，不产生空徽标窗口。
+ */
+export function peekLatestCache(key) {
+    return latestCache.get(key)?.value ?? null;
+}
 /** 内存 set（超上限淘汰最旧）；纯内存，无任何落盘。 */
 export function writeLatestCache(key, value) {
     if (latestCache.size >= LATEST_CACHE_MAX) {

package/lib/core/market.js

@@ -24,7 +24,7 @@ import { normalizeSearchText, relevanceScore, tokenizeSearchText } from './searc
 import { GithubBudgetExhaustedError, createGithubRequestBudget, isExactVersion } from './versions.js';
 import { classifyUpgradeActivation } from './activation.js';
 import { HttpError } from './httpx.js';
-import { ensureLatestCacheSwept, invalidateLatestCache, latestCacheKey, latestItemId, readLatestCache, writeLatestCache } from './latest-cache.js';
+import { ensureLatestCacheSwept, invalidateLatestCache, latestCacheKey, latestItemId, peekLatestCache, readLatestCache, writeLatestCache } from './latest-cache.js';
 import { verifyInstalledAdditions } from './install-guard.js';
 import { fetchTextLimited } from './httpx.js';
 import { githubLatestTag as defaultGithubLatestTag, isNewerVersion, npmLatest as defaultNpmLatest, npmVersion, } from './versions.js';
@@ -527,53 +527,69 @@ export async function listMarket(cfg = {}, opts = {}, deps = {}) {
     if (withLatest && items.length > 0) {
         // 0.9.20：latest 缓存纯内存（ADR-0006）——探测段前仅一次性清扫 0.9.14 遗留磁盘信封
         await ensureLatestCacheSwept({ namespace, profile: opts.profile });
-        // 先吃 cache 命中
+        // 0.9.45 探测两态（ADR-0013）：'full'（缺省，行为不变）| 'cache-only'（两段加载第一段：零网络）
+        const mode = opts.probeMode ?? 'full';
+        // force（P2，ADR-0013）：peek 旧值兜底 + 全页重探——不走 ttlMin=0（ADR-0006 在案约束：
+        // 先删后探失败会丢旧值）；重探成功覆盖缓存，失败保留旧值 + latestError，无空徽标窗口
+        const forceProbe = mode !== 'cache-only' && opts.force === true;
         const ttlMin = Math.max(0, cfg.cacheTtlMin ?? 60);
+        // 先吃 cache 命中（force 用 peek：不判 TTL、不删除）
         for (const item of items) {
-            const cached = readLatestCache(latestCacheKey(namespace, loaded.configuredAddress, item), ttlMin);
+            const key = latestCacheKey(namespace, loaded.configuredAddress, item);
+            const cached = forceProbe ? peekLatestCache(key) : readLatestCache(key, ttlMin);
             if (cached)
                 applyProbe(item, cached);
         }
-        const todo = items.filter((it) => it.latestVersion === undefined &&
-            it.latestTag === undefined &&
-            it.latestSha === undefined &&
+        if (mode === 'cache-only') {
+            // 两段加载第一段：零网络；缺口判定镜像 todo 豁免（社区 github 永不探测 → 不构成第二段理由，Q46）
+            const gap = items.some((it) => it.latestVersion === undefined &&
+                it.latestTag === undefined &&
+                it.latestSha === undefined &&
+                !(it.community === true && it.source === 'github'));
+            latestComplete = !gap;
+        }
+        else {
+            const todo = items.filter((it) => 
             // Q46 探测边界：社区 github 条目不做浏览页 REST 探测（配额不可控）；社区 npm 条目照常
-            !(it.community === true && it.source === 'github'));
-        if (todo.length > 0) {
-            const budget = remaining();
-            if (budget <= 0) {
-                for (const item of todo) {
-                    item.latestError = '更新检查未完成：时间预算已用尽';
-                    item.latestErrorCode = 'timeout';
-                }
-                latestComplete = false;
-                latestTimedOut = true;
-            }
-            else {
-                await mapWithConcurrency(todo, LATEST_WORKERS, async (item) => {
-                    const perBudget = Math.max(1, remaining());
-                    const task = probeTask(item, d, Math.min(cfg.timeoutMs ?? 20_000, perBudget), signal);
-                    const outcome = await probeWithBudget(task, perBudget, signal);
-                    if (outcome.ok && outcome.value) {
-                        applyProbe(item, outcome.value);
-                        writeLatestCache(latestCacheKey(namespace, loaded.configuredAddress, item), outcome.value);
-                    }
-                    else if (outcome.timeout) {
-                        item.latestError = '更新检查未完成：超时';
+            !(it.community === true && it.source === 'github') &&
+                // force：全页重探（缓存内旧值仅作兜底展示）；常态：仅未命中条目
+                (forceProbe || (it.latestVersion === undefined && it.latestTag === undefined && it.latestSha === undefined)));
+            if (todo.length > 0) {
+                const budget = remaining();
+                if (budget <= 0) {
+                    for (const item of todo) {
+                        item.latestError = '更新检查未完成：时间预算已用尽';
                         item.latestErrorCode = 'timeout';
-                        latestComplete = false;
-                        latestTimedOut = true;
-                    }
-                    else if (outcome.error !== undefined) {
-                        if (signal?.aborted)
-                            throw abortError();
-                        item.latestError = outcome.error instanceof Error ? outcome.error.message : String(outcome.error);
-                        item.latestErrorCode = classifyLatestError(outcome.error);
                     }
-                });
+                    latestComplete = false;
+                    latestTimedOut = true;
+                }
+                else {
+                    await mapWithConcurrency(todo, LATEST_WORKERS, async (item) => {
+                        const perBudget = Math.max(1, remaining());
+                        const task = probeTask(item, d, Math.min(cfg.timeoutMs ?? 20_000, perBudget), signal);
+                        const outcome = await probeWithBudget(task, perBudget, signal);
+                        if (outcome.ok && outcome.value) {
+                            applyProbe(item, outcome.value);
+                            writeLatestCache(latestCacheKey(namespace, loaded.configuredAddress, item), outcome.value);
+                        }
+                        else if (outcome.timeout) {
+                            item.latestError = '更新检查未完成：超时';
+                            item.latestErrorCode = 'timeout';
+                            latestComplete = false;
+                            latestTimedOut = true;
+                        }
+                        else if (outcome.error !== undefined) {
+                            if (signal?.aborted)
+                                throw abortError();
+                            item.latestError = outcome.error instanceof Error ? outcome.error.message : String(outcome.error);
+                            item.latestErrorCode = classifyLatestError(outcome.error);
+                        }
+                    });
+                }
             }
         }
-        // outdated 判定统一在 probe 后进行
+        // outdated 判定统一在 probe 后进行（0.9.45：cache-only 也执行——暖缓存不丢「可升级」徽标）
         for (const item of items) {
             const inst = item.installedPkg !== undefined ? installedItems.find((i) => i.pkg === item.installedPkg) : undefined;
             if (!inst)

package/lib/core/versions.js

@@ -113,6 +113,25 @@ export async function npmPackument(pkg, timeoutMs = 20_000, signal, registry, de
     const versions = data?.versions !== null && typeof data?.versions === 'object' ? Object.keys(data.versions) : [];
     return { versions };
 }
+/**
+ * npm packument readme 兜底（0.9.45 U10b 修复）：市场/收藏详情 Modal 的 README 折叠页对
+ * 「未安装」条目无法走本地 profile 读取——回源 packument 顶层 readme 字段（publish 管线
+ * 对多数包写入）。安全基线同 npmPackument：HTTPS、8MB 上限、超时；无 readme 字段返回空串
+ * （不抛，客户端显示「没有 README」）；L1（ADR-0012）：显式 registry 参数 > 生效源。
+ */
+export async function npmPackumentReadme(pkg, timeoutMs = 20_000, signal, registry, deps) {
+    if (!/^@?[A-Za-z0-9-._~]+(\/[A-Za-z0-9-._~]+)?$/.test(pkg))
+        throw new Error(`无效 npm 包名: ${pkg}`);
+    const fetcher = deps?.fetchJsonLimited ?? fetchJsonLimited;
+    const base = registry?.trim() ? registry.trim() : await activeNpmRegistry();
+    const data = await fetcher(`${registryBase(base)}/${encodeURIComponent(pkg)}`, {
+        timeoutMs,
+        signal,
+        maxBytes: 8 * 1024 * 1024,
+    });
+    const readme = typeof data?.readme === 'string' && data.readme.trim() !== '' ? data.readme : '';
+    return { readme };
+}
 /**
  * 升级探测（检测读）。L3 权威链（ADR-0012）：新鲜度敏感——npmjs 权威源优先
  * （首腿超时收紧 `Math.min(timeoutMs, 5_000)`），失败降级生效源（≠npmjs 时）；