dsh-m 0.4.3 → 0.5.1

package/lib/client.js

@@ -27,10 +27,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var market_state_exports = {};
 __export(market_state_exports, {
   MARKET_PAGE_SIZE: () => MARKET_PAGE_SIZE,
+  marketNotice: () => marketNotice,
   normalizeMarketQuery: () => normalizeMarketQuery,
   normalizeMarketResponse: () => normalizeMarketResponse,
   registryNotice: () => registryNotice,
-  resetPageOnFilterChange: () => resetPageOnFilterChange
+  resetPageOnFilterChange: () => resetPageOnFilterChange,
+  sortMergedItems: () => sortMergedItems,
+  splitCategories: () => splitCategories
 });
 function toSafeInt(value, fallback, min, max) {
   const n = typeof value === "number" && Number.isFinite(value) ? Math.floor(value) : fallback;
@@ -41,10 +44,11 @@ function toSafeInt(value, fallback, min, max) {
 function normalizeMarketQuery(input) {
   const raw = input && typeof input === "object" ? input : {};
   const query = typeof raw.query === "string" ? raw.query.trim() : "";
-  const category = typeof raw.category === "string" && CATEGORIES.includes(raw.category) ? raw.category : null;
+  const category = typeof raw.category === "string" && (CATEGORIES.includes(raw.category) || COMMUNITY_SLUG_RE.test(raw.category)) ? raw.category : null;
   const offset = toSafeInt(raw.offset, 0, 0);
   const limit = toSafeInt(raw.limit, MARKET_PAGE_SIZE, 1, MARKET_PAGE_SIZE);
-  return { query, category, offset, limit };
+  const primaryOnly = raw.primaryOnly === true;
+  return { query, category, offset, limit, primaryOnly };
 }
 function resetPageOnFilterChange(previous, next) {
   const prev = previous && typeof previous === "object" ? previous : {};
@@ -72,6 +76,20 @@ function normalizeMarketResponse(raw) {
     ...rs,
     errors: Array.isArray(rs.errors) ? rs.errors.map(String) : []
   };
+  const c = body.community && typeof body.community === "object" && !Array.isArray(body.community) ? body.community : {};
+  const community = {
+    ...FALLBACK_COMMUNITY,
+    ...c,
+    enabled: c.enabled === true,
+    status: typeof c.status === "string" ? c.status : "disabled",
+    acceptedCount: typeof c.acceptedCount === "number" && Number.isFinite(c.acceptedCount) ? c.acceptedCount : 0,
+    upstreamCount: typeof c.upstreamCount === "number" && Number.isFinite(c.upstreamCount) ? c.upstreamCount : null,
+    displaced: typeof c.displaced === "number" && Number.isFinite(c.displaced) ? c.displaced : 0,
+    skippedDirty: typeof c.skippedDirty === "number" && Number.isFinite(c.skippedDirty) ? c.skippedDirty : 0,
+    skippedSubpathNoNpm: typeof c.skippedSubpathNoNpm === "number" && Number.isFinite(c.skippedSubpathNoNpm) ? c.skippedSubpathNoNpm : 0,
+    errors: Array.isArray(c.errors) ? c.errors.map(String) : [],
+    warnings: Array.isArray(c.warnings) ? c.warnings.map(String) : []
+  };
   return {
     items,
     total,
@@ -79,6 +97,7 @@ function normalizeMarketResponse(raw) {
     limit,
     categoryCounts,
     registryState,
+    community,
     installedComplete: body.installedComplete === true,
     latestComplete: body.latestComplete === true,
     latestTimedOut: body.latestTimedOut === true
@@ -92,7 +111,40 @@ function registryNotice(summary, total) {
   else if (!s.isDefault) key = "notice.custom";
   return { key, count: typeof total === "number" && Number.isFinite(total) ? total : 0 };
 }
-var MARKET_PAGE_SIZE, CATEGORIES, FALLBACK_REGISTRY_STATE;
+function splitCategories(categoryCounts) {
+  const counts = categoryCounts && typeof categoryCounts === "object" && !Array.isArray(categoryCounts) ? categoryCounts : {};
+  const curated = CURATED_CATEGORIES.map(({ id, label }) => ({ id, label, count: typeof counts[id] === "number" ? counts[id] : 0 }));
+  const community = [];
+  const unknown = [];
+  for (const [id, raw] of Object.entries(counts)) {
+    const count = typeof raw === "number" && Number.isFinite(raw) ? raw : 0;
+    if (CURATED_IDS.has(id)) continue;
+    if (COMMUNITY_KNOWN_LABELS[id]) community.push({ id, label: COMMUNITY_KNOWN_LABELS[id], count });
+    else if (!SHARED_BUCKETS.has(id)) unknown.push({ id, label: id, count });
+  }
+  return { curated, community, unknown };
+}
+function marketNotice(registryState, community) {
+  const base = registryNotice(registryState, void 0);
+  const c = community && typeof community === "object" ? community : {};
+  if (c.status === "stale") base.communityStale = true;
+  if (registryState && registryState.status === "unavailable" && (c.status === "ready" || c.status === "stale")) {
+    base.communityFallback = true;
+  }
+  return base;
+}
+function sortMergedItems(items) {
+  const list = Array.isArray(items) ? items.filter((it) => it && typeof it === "object") : [];
+  const primary = list.filter((it) => it.community !== true);
+  const community = list.filter((it) => it.community === true).slice().sort((a, b) => {
+    const da = typeof a.downloads === "number" && Number.isFinite(a.downloads) ? a.downloads : -1;
+    const db = typeof b.downloads === "number" && Number.isFinite(b.downloads) ? b.downloads : -1;
+    if (da !== db) return db - da;
+    return String(a.name).localeCompare(String(b.name));
+  });
+  return [...primary, ...community];
+}
+var MARKET_PAGE_SIZE, CATEGORIES, FALLBACK_REGISTRY_STATE, COMMUNITY_SLUG_RE, CURATED_CATEGORIES, CURATED_IDS, SHARED_BUCKETS, COMMUNITY_KNOWN_LABELS, FALLBACK_COMMUNITY;
 var init_market_state = __esm({
   "src/client/market-state.js"() {
     "use strict";
@@ -109,6 +161,53 @@ var init_market_state = __esm({
       errors: [],
       count: 0
     };
+    COMMUNITY_SLUG_RE = /^[a-z0-9-]{1,32}$/;
+    CURATED_CATEGORIES = [
+      { id: "market", label: "\u5E02\u573A" },
+      { id: "tools", label: "\u5DE5\u5177" },
+      { id: "ui", label: "\u754C\u9762" },
+      { id: "search", label: "\u641C\u7D22" },
+      { id: "other", label: "\u5176\u4ED6" }
+    ];
+    CURATED_IDS = new Set(CURATED_CATEGORIES.map((c) => c.id));
+    SHARED_BUCKETS = /* @__PURE__ */ new Set(["ui", "tools", "market"]);
+    COMMUNITY_KNOWN_LABELS = {
+      agi: "AGI \u67B6\u6784\u63A2\u7D22",
+      usage: "\u7528\u91CF\u4E0E\u8BA1\u8D39",
+      theme: "\u4E3B\u9898\u4E0E\u5916\u89C2",
+      model: "\u6A21\u578B\u4E0E\u8D26\u53F7\u63A5\u5165",
+      identity: "\u8EAB\u4EFD\u4E0E\u901A\u4FE1",
+      session: "\u4F1A\u8BDD\u4E0E\u6D88\u606F",
+      memory: "\u8BB0\u5FC6",
+      wsl: "WSL \u4E0E Windows \u4E92\u64CD\u4F5C",
+      browser: "\u6D4F\u89C8\u5668\u4E0E\u7F51\u9875",
+      vision: "\u89C6\u89C9\u4E0E\u591A\u6A21\u6001",
+      voice: "\u8BED\u97F3\u4E0E\u97F3\u9891",
+      docs: "\u6587\u6863\u4E0E\u6E32\u67D3",
+      skill: "\u6280\u80FD\u5305",
+      workflow: "\u5DE5\u4F5C\u6D41\u4E0E\u81EA\u52A8\u5316",
+      git: "Git \u4E0E\u4EE3\u7801\u8BC4\u5BA1",
+      notify: "\u901A\u77E5\u4E0E\u96C6\u6210",
+      dev: "\u5F00\u53D1\u4E0E\u8FD0\u884C\u65F6",
+      security: "\u5B89\u5168\u4E0E\u6743\u9650",
+      remote: "\u8FDC\u7A0B\u4E0E\u79FB\u52A8\u7AEF",
+      fun: "\u5A31\u4E50"
+    };
+    FALLBACK_COMMUNITY = {
+      enabled: false,
+      status: "disabled",
+      version: null,
+      checkedAt: null,
+      fetchedAt: null,
+      route: null,
+      acceptedCount: 0,
+      upstreamCount: null,
+      displaced: 0,
+      skippedDirty: 0,
+      skippedSubpathNoNpm: 0,
+      errors: [],
+      warnings: []
+    };
   }
 });
 
@@ -309,7 +408,11 @@ function installedViewModel(it) {
     latestLabelDetail: it.latestTag || (it.latestVersion ? `v${it.latestVersion}` : "\u2014"),
     // 0.4.0（Task 17）：运行相位/开关状态的 sub 行渲染原料；相位点 class 映射归 toggle-view
     phaseKey: it.phase ? `phase.${it.phase}` : null,
-    enabledLabelKey: it.enabled === false ? "toggle.state.off" : "toggle.state.on"
+    enabledLabelKey: it.enabled === false ? "toggle.state.off" : "toggle.state.on",
+    // M1 Task 5：社区收录徽标（卡片/已装卡显示「社区收录」）
+    community: it.community === true,
+    // M1 Task 7 ⑩：检查未完成标注（latestError 行渲染原料；code → 安全化原因由调用方 i18n/lookup）
+    latestIssue: it.latestError ? { code: it.latestErrorCode ?? null, note: it.latestError } : null
   };
 }
 function registrySourceKey(data) {
@@ -482,7 +585,7 @@ var h = React.createElement;
 var { useState, useEffect, useCallback, useMemo, useRef } = React;
 var PLUGIN_ID = "dsh-m";
 var API = "/dshm";
-var { MARKET_PAGE_SIZE: MARKET_PAGE_SIZE2, normalizeMarketQuery: normalizeMarketQuery2, resetPageOnFilterChange: resetPageOnFilterChange2, normalizeMarketResponse: normalizeMarketResponse2, registryNotice: registryNotice2 } = (init_market_state(), __toCommonJS(market_state_exports));
+var { MARKET_PAGE_SIZE: MARKET_PAGE_SIZE2, normalizeMarketQuery: normalizeMarketQuery2, resetPageOnFilterChange: resetPageOnFilterChange2, normalizeMarketResponse: normalizeMarketResponse2, registryNotice: registryNotice2, splitCategories: splitCategories2, marketNotice: marketNotice2, sortMergedItems: sortMergedItems2 } = (init_market_state(), __toCommonJS(market_state_exports));
 var { createMarkdown: createMarkdown2 } = (init_markdown(), __toCommonJS(markdown_exports));
 var { ExtLink, MdImg, renderMarkdown } = createMarkdown2(h);
 var { installedViewModel: installedViewModel2, registrySourceKey: registrySourceKey2 } = (init_installed_view(), __toCommonJS(installed_view_exports));
@@ -616,6 +719,30 @@ var ZH = {
   "market.page.info": "\u7B2C {page} / {pages} \u9875 \xB7 \u5171 {total} \u6761",
   "market.perf": "\u6536\u5F55\u8D85\u8FC7 200 \u6761\uFF1A\u4EC5\u67E5\u8BE2\u5F53\u524D\u9875\u7684\u6700\u65B0\u7248\u672C\uFF08\u6BCF\u9875 50 \u6761\uFF09\uFF0C\u5982\u9700\u5168\u90E8\u8BF7\u7528\u641C\u7D22/\u5206\u7C7B\u8FC7\u6EE4",
   "notice.toolview.err": "\u6536\u5F55\u6E05\u5355\u6682\u4E0D\u53EF\u7528",
+  "cat.primaryonly": "\u53EA\u770B\u4E3B\u6E05\u5355",
+  "community.group": "\u793E\u533A",
+  "community.newgroup": "\u793E\u533A \xB7 \u65B0\u5206\u7C7B",
+  "badge.community": "\u793E\u533A\u6536\u5F55",
+  "community.stale": "\u793E\u533A\u76EE\u5F55\u4E3A\u7F13\u5B58\u5FEB\u7167\uFF08\u663E\u793A\u7684\u4E0D\u662F\u6700\u65B0\u6570\u636E\uFF09",
+  "community.fallback": "\u6536\u5F55\u6E05\u5355\u4E0D\u53EF\u7528\uFF0C\u5F53\u524D\u5C55\u793A\u793E\u533A\u6E05\u5355\u6761\u76EE",
+  "detail.capabilities": "\u80FD\u529B\u62AB\u9732",
+  "detail.capabilities.unscanned": "\u672A\u626B\u63CF \u2260 \u672A\u68C0\u51FA",
+  "detail.redlines": "\u80FD\u529B\u7EA2\u7EBF",
+  "guard.blocked": "\u5B89\u88C5\u88AB\u88C5\u540E\u5B88\u536B\u62E6\u622A",
+  "guard.compstatus": "\u8865\u507F\u7EC8\u6001",
+  "guard.repairbasis": "\u4FEE\u590D\u4F9D\u636E",
+  "guard.restartsafenow": "\u53EF\u4EE5\u91CD\u542F DSH Web",
+  "guard.restartunsafe": "\u4FEE\u590D\u540E\u518D\u91CD\u542F\uFF08\u4E0D\u8981\u73B0\u5728\u4E00\u952E\u91CD\u542F\uFF09",
+  "guard.noforce": "\u5B88\u536B\u62E6\u622A\u65E0\u300C\u4ECD\u8981\u5B89\u88C5\u300D\u901A\u9053\uFF0C\u8BF7\u6309\u4FEE\u590D\u4F9D\u636E\u4EBA\u5DE5\u5904\u7406",
+  "detail.screenshots": "\u622A\u56FE",
+  "installed.check.incomplete": "\u68C0\u67E5\u672A\u5B8C\u6210",
+  "settings.community": "\u793E\u533A\u6E05\u5355\uFF08awesome-dsh-plugin \u76EE\u5F55\uFF09",
+  "settings.community.none": "\u793E\u533A\u6E05\u5355\u672A\u542F\u7528\u6216\u4E0D\u53EF\u7528",
+  "settings.community.status": "\u72B6\u6001",
+  "settings.community.version": "\u76EE\u5F55\u7248\u672C",
+  "settings.community.route": "\u83B7\u53D6\u7EBF\u8DEF",
+  "settings.community.accepted": "\u6536\u5F55 / \u4E0A\u6E38",
+  "settings.community.displaced": "\u4E0E\u4E3B\u6E05\u5355\u91CD\u590D\u8BA9\u4F4D",
   "self.upgraded": "dsh-m \u5DF2\u66F4\u65B0\u5230 v{v}\uFF0C\u91CD\u542F\u540E\u751F\u6548",
   "self.failed": "\u81EA\u66F4\u65B0\u5931\u8D25\uFF1A{err}",
   "registry.refreshed": "\u6536\u5F55\u6E05\u5355\u5DF2\u5F3A\u5236\u5237\u65B0",
@@ -807,6 +934,30 @@ var EN = {
   "market.page.info": "Page {page} / {pages} \xB7 {total} listings",
   "market.perf": "200+ listings: latest versions are queried for the current page only (50 per page); use search/category filters",
   "notice.toolview.err": "Registry temporarily unavailable",
+  "cat.primaryonly": "Primary only",
+  "community.group": "Community",
+  "community.newgroup": "Community \xB7 New",
+  "badge.community": "Community",
+  "community.stale": "Community catalog served from cache (not the latest data)",
+  "community.fallback": "Registry unavailable \u2014 showing community listings",
+  "detail.capabilities": "Capabilities",
+  "detail.capabilities.unscanned": "Not scanned \u2260 not detected",
+  "detail.redlines": "Capability red lines",
+  "guard.blocked": "Install blocked by post-install guard",
+  "guard.compstatus": "Compensation status",
+  "guard.repairbasis": "Repair basis",
+  "guard.restartsafenow": "You can restart DSH Web now",
+  "guard.restartunsafe": "Fix before restarting (do not one-click restart now)",
+  "guard.noforce": "Guard blocks have no force channel \u2014 repair manually per the basis above",
+  "detail.screenshots": "Screenshots",
+  "installed.check.incomplete": "Check incomplete",
+  "settings.community": "Community catalog (awesome-dsh-plugin)",
+  "settings.community.none": "Community catalog disabled or unavailable",
+  "settings.community.status": "Status",
+  "settings.community.version": "Catalog version",
+  "settings.community.route": "Route",
+  "settings.community.accepted": "Accepted / upstream",
+  "settings.community.displaced": "Displaced (duplicate of primary)",
   "self.upgraded": "dsh-m updated to v{v} \u2014 restart to take effect",
   "self.failed": "Self-update failed: {err}",
   "registry.refreshed": "Registry force-refreshed",
@@ -1031,6 +1182,9 @@ async function api(method, params, signal) {
   if (!res.ok || data.ok === false) {
     const err = new Error(data.error || `API ${res.status}`);
     if (data && typeof data === "object" && data.issue) err.issue = data.issue;
+    if (data && typeof data === "object" && data.kind && Array.isArray(data.violations)) {
+      err.guard = { kind: data.kind, violations: data.violations, compensation: data.compensation, needsRestart: data.needsRestart === true, restartSafe: data.restartSafe === true, repairBasis: data.repairBasis };
+    }
     throw err;
   }
   return data;
@@ -1069,6 +1223,7 @@ function useMarketData() {
     const params = {
       query: nextQuery.query || void 0,
       category: nextQuery.category || void 0,
+      primaryOnly: nextQuery.primaryOnly === true ? true : void 0,
       offset: nextQuery.offset,
       limit: nextQuery.limit,
       ...force ? { force: true } : {}
@@ -1114,6 +1269,19 @@ function Icon({ entry }) {
 function Spin() {
   return h("span", { className: "dshm-spin" });
 }
+function safeScreenshots(entry) {
+  const list = Array.isArray(entry && entry.screenshots) ? entry.screenshots : [];
+  return list.filter((u) => typeof u === "string" && u.length <= 2048).map((u) => {
+    try {
+      const parsed = new URL(u);
+      if (parsed.protocol !== "https:") return null;
+      if (parsed.hostname === "github.com" || parsed.hostname.endsWith(".githubusercontent.com")) return u;
+      return null;
+    } catch {
+      return null;
+    }
+  }).filter(Boolean).slice(0, 8);
+}
 function officialLinks({ npm, github, homepage }) {
   const links = [];
   if (github) links.push(["GitHub", `https://github.com/${github}`]);
@@ -1234,14 +1402,14 @@ function MarketTab({ notify, market, onMutation }) {
   const [busyId, setBusyId] = useState(null);
   const [qInput, setQInput] = useState(query.query);
   const debounceRef = useRef(null);
-  const items = data && data.items || [];
+  const items = sortMergedItems2(data && data.items || []);
   const total = data && data.total || 0;
   const limit = data && data.limit || MARKET_PAGE_SIZE2;
   const offset = data && data.offset || 0;
   const page = total > 0 ? Math.floor(offset / limit) + 1 : 1;
   const pages = total > 0 ? Math.max(1, Math.ceil(total / limit)) : 1;
   const counts = data && data.categoryCounts || {};
-  const notice = data ? registryNotice2(data.registryState, total) : null;
+  const notice = data ? marketNotice2(data.registryState, data.community) : null;
   const onSearchInput = (value) => {
     setQInput(value);
     if (debounceRef.current) clearTimeout(debounceRef.current);
@@ -1262,7 +1430,18 @@ function MarketTab({ notify, market, onMutation }) {
       installDone(res);
       await (onMutation ? onMutation() : reload(false));
     } catch (e) {
-      if (e && e.issue) {
+      if (e && e.guard) {
+        notify({
+          kind: "err",
+          text: [
+            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(" | ")
+        });
+      } else if (e && e.issue) {
         setCompatConfirm({ it, version, issue: e.issue });
       } else {
         notify({ kind: "err", text: lookup("failed.install", { err: e && e.message || e }) });
@@ -1316,6 +1495,8 @@ function MarketTab({ notify, market, onMutation }) {
       { className: notice.key === "notice.unavailable" ? "dshm-err" : "dshm-hint" },
       lookup(notice.key, { count: notice.count })
     ) : null,
+    notice && notice.communityFallback ? h("div", { className: "dshm-hint" }, lookup("community.fallback")) : null,
+    notice && notice.communityStale ? h("div", { className: "dshm-hint" }, lookup("community.stale")) : null,
     total > 200 ? h("div", { className: "dshm-hint" }, lookup("market.perf")) : null,
     h(
       "div",
@@ -1331,7 +1512,8 @@ function MarketTab({ notify, market, onMutation }) {
     h(
       "div",
       { className: "dshm-chips" },
-      h("button", { className: `dshm-chip${query.category === null ? " on" : ""}`, onClick: () => updateQuery({ category: null, offset: 0 }) }, lookup("cat.all")),
+      h("button", { className: `dshm-chip${query.category === null ? " on" : ""}`, onClick: () => updateQuery({ category: null, primaryOnly: false, offset: 0 }) }, lookup("cat.all")),
+      h("button", { className: `dshm-chip${query.primaryOnly === true ? " on" : ""}`, onClick: () => updateQuery({ primaryOnly: query.primaryOnly !== true, offset: 0 }) }, lookup("cat.primaryonly")),
       CATEGORIES2.map((key) => {
         const n = typeof counts[key] === "number" ? counts[key] : 0;
         return h(
@@ -1341,6 +1523,31 @@ function MarketTab({ notify, market, onMutation }) {
         );
       })
     ),
+    (() => {
+      const groups = splitCategories2(counts);
+      if (!groups.community.length && !groups.unknown.length) return null;
+      const chip = (c) => h(
+        "button",
+        { key: c.id, className: `dshm-chip${query.category === c.id ? " on" : ""}`, onClick: () => updateQuery({ category: query.category === c.id ? null : c.id, offset: 0 }) },
+        `${c.label}${c.count ? ` ${c.count}` : ""}`
+      );
+      return h(
+        React.Fragment,
+        null,
+        groups.community.length ? h(
+          "div",
+          { className: "dshm-chips" },
+          h("span", { className: "dshm-hint" }, lookup("community.group")),
+          ...groups.community.map(chip)
+        ) : null,
+        groups.unknown.length ? h(
+          "div",
+          { className: "dshm-chips" },
+          h("span", { className: "dshm-hint" }, lookup("community.newgroup")),
+          ...groups.unknown.map(chip)
+        ) : null
+      );
+    })(),
     busyId ? 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(
       React.Fragment,
@@ -1355,6 +1562,7 @@ function MarketTab({ notify, market, onMutation }) {
           badges: [
             it.outdated ? h("span", { className: "dshm-badge warn", key: "u" }, lookup("badge.update")) : null,
             it.installed ? h("span", { className: "dshm-badge", key: "i" }, lookup("badge.installed")) : null,
+            it.community === true ? h("span", { className: "dshm-badge info", key: "c" }, lookup("badge.community")) : null,
             h("span", { className: "dshm-badge info", key: "s" }, it.source === "npm" ? "npm" : "github")
           ],
           desc: it.description,
@@ -1372,7 +1580,13 @@ function MarketTab({ notify, market, onMutation }) {
             [lookup("detail.latest"), it.latestVersion ? `v${it.latestVersion}` : it.latestTag ? it.latestTag : it.latestSha ? it.latestSha : it.latestError || "\u2014"],
             [lookup("detail.installed"), it.installedPkg ? `${it.installedPkg} v${it.installedVersion || "?"}` : lookup("installed.none")],
             [lookup("detail.tags"), (it.tags || []).join(", ") || "\u2014"],
-            it.latestError ? [lookup("version.failed"), it.latestError] : null
+            it.latestError ? [lookup("version.failed"), it.latestError] : null,
+            it.community === true ? [lookup("detail.capabilities"), Array.isArray(it.capabilities) && it.capabilities.length ? `${it.capabilities.join(", ")}${Array.isArray(it.capabilityRedLines) && it.capabilityRedLines.length ? `\uFF1B${lookup("detail.redlines")}: ${it.capabilityRedLines.join("; ")}` : ""}` : lookup("detail.capabilities.unscanned")] : null,
+            it.community === true && safeScreenshots(it).length ? [lookup("detail.screenshots"), h(
+              "div",
+              { className: "dshm-chips" },
+              ...safeScreenshots(it).map((src) => h("img", { key: src, src, alt: "", loading: "lazy", referrerPolicy: "no-referrer", style: { maxWidth: "220px", maxHeight: "140px", borderRadius: "6px", border: "1px solid rgba(127,127,127,.25)" } }))
+            )] : null
           ]),
           actions: [
             it.installed ? h("span", { className: "dshm-hint", key: "hint" }, lookup("manage.hint")) : h(
@@ -1516,7 +1730,20 @@ function InstalledTab({ notify, installed, onMutation }) {
       });
       await (onMutation ? onMutation() : reload());
     } catch (e) {
-      notify({ kind: "err", text: lookup("failed.upgrade", { err: e && e.message || e }) });
+      if (e && e.guard) {
+        notify({
+          kind: "err",
+          text: [
+            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(" | ")
+        });
+      } else {
+        notify({ kind: "err", text: lookup("failed.upgrade", { err: e && e.message || e }) });
+      }
     } finally {
       setBusyPkg(null);
     }
@@ -1548,15 +1775,16 @@ function InstalledTab({ notify, installed, onMutation }) {
           }),
           badges: [
             it.outdated ? h("span", { className: "dshm-badge warn", key: "u" }, `\u2B06 ${vm.latestLabel}`.trim()) : null,
-            it.registryId ? h("span", { className: "dshm-badge", key: "r" }, lookup("badge.market")) : h("span", { className: "dshm-badge info", key: "r" }, lookup("badge.nonmarket"))
+            it.community === true ? h("span", { className: "dshm-badge info", key: "r" }, lookup("badge.community")) : it.registryId ? h("span", { className: "dshm-badge", key: "r" }, lookup("badge.market")) : h("span", { className: "dshm-badge info", key: "r" }, lookup("badge.nonmarket"))
           ],
           desc: it.description || "\uFF08\u65E0\u63CF\u8FF0\uFF09",
           sub: [
             h(PhaseDot, { key: "dot", vm: tvm }),
             vm.phaseKey ? lookup(vm.phaseKey) : lookup(vm.enabledLabelKey),
             `v${it.version || "?"}`,
-            vm.sourceLabelKey ? lookup(vm.sourceLabelKey) : it.source
-          ].map((part, i) => i === 0 ? part : [" \xB7 ", part]).flat(),
+            vm.sourceLabelKey ? lookup(vm.sourceLabelKey) : it.source,
+            vm.latestIssue ? lookup("installed.check.incomplete") : null
+          ].filter(Boolean).map((part, i) => i === 0 ? part : [" \xB7 ", part]).flat(),
           links: h(LinksRow, {
             npm: it.source === "npm" ? it.pkg : null,
             github: vm.githubRepo
@@ -1569,6 +1797,7 @@ function InstalledTab({ notify, installed, onMutation }) {
             [lookup("detail.latest"), vm.latestLabelDetail],
             [lookup("detail.listed"), it.registryId || lookup("detail.listed.no")],
             [lookup("detail.path"), it.path],
+            vm.latestIssue ? [lookup("installed.check.incomplete"), vm.latestIssue.note] : null,
             vm.guard.warnKey ? [lookup("detail.note"), lookup(vm.guard.warnKey, vm.guard.warnParams)] : null
           ]),
           actions: [
@@ -1700,9 +1929,27 @@ function SettingsTab({ notify, onRegistryChanged }) {
   };
   const snap = cfgData || {};
   const state = snap.registryState || (reg.data ? reg.data.registryState : null) || null;
+  const communitySummary = reg.data && reg.data.community && typeof reg.data.community === "object" ? reg.data.community : null;
+  const communityRows = communitySummary && (communitySummary.status === "ready" || communitySummary.status === "stale") ? [
+    [lookup("settings.community.status"), communitySummary.status === "stale" ? lookup("community.stale") : lookup("settings.status.ready")],
+    [lookup("settings.community.version"), communitySummary.version || "\u2014"],
+    [lookup("settings.community.route"), communitySummary.route || "\u2014"],
+    [lookup("settings.community.accepted"), `${communitySummary.acceptedCount} / ${communitySummary.upstreamCount ?? "\u2014"}`],
+    [lookup("settings.community.displaced"), String(communitySummary.displaced ?? 0)]
+  ] : [[lookup("settings.community.status"), lookup("settings.community.none")]];
   return h(
     React.Fragment,
     null,
+    Section(
+      lookup("settings.community"),
+      ...communityRows.map(([k, v]) => h(
+        "div",
+        { key: k, className: "dshm-row", style: { justifyContent: "space-between" } },
+        h("span", { className: "dshm-hint" }, k),
+        h("span", null, v)
+      )),
+      communitySummary && Array.isArray(communitySummary.errors) && communitySummary.errors.length ? h("div", { className: "dshm-err" }, communitySummary.errors.join("\uFF1B")) : null
+    ),
     Section(
       lookup("settings.registry"),
       h(
@@ -1810,7 +2057,20 @@ function SettingsTab({ notify, onRegistryChanged }) {
       notify({ kind: "ok", text: lookup("self.upgraded", { v: res.version }), needsRestart: true });
       await self.reload();
     } catch (e) {
-      notify({ kind: "err", text: lookup("failed.selfupdate", { err: e && e.message || e }) });
+      if (e && e.guard) {
+        notify({
+          kind: "err",
+          text: [
+            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(" | ")
+        });
+      } else {
+        notify({ kind: "err", text: lookup("failed.selfupdate", { err: e && e.message || e }) });
+      }
     } finally {
       setUpgrading(false);
     }
@@ -2054,13 +2314,17 @@ function registerSlot(slots, options, component) {
 }
 function ToolCardRow({ it, onInstalled }) {
   const [busy, setBusy] = useState(false);
+  const [guardNote, setGuardNote] = useState(null);
   const install = async (e) => {
     e.stopPropagation();
     setBusy(true);
     try {
       const res = await api("install", { id: it.id });
       onInstalled({ ...it, installed: true, installedPkg: res.pkg, installedVersion: res.version });
-    } catch {
+    } catch (e2) {
+      if (e2 && e2.guard) {
+        setGuardNote(`${lookup("guard.blocked")} \xB7 ${e2.guard.compensation?.status || "\u2014"} \xB7 ${lookup("guard.noforce")}`);
+      }
     } finally {
       setBusy(false);
     }
@@ -2080,6 +2344,7 @@ function ToolCardRow({ it, onInstalled }) {
         it.installed ? h("span", { className: "dshm-badge" }, "\u5DF2\u5B89\u88C5") : null
       ),
       h("div", { className: "dshm-desc" }, it.description),
+      guardNote ? h("div", { className: "dshm-err" }, guardNote) : null,
       h("div", { className: "dshm-sub" }, `${it.id} \xB7 ${(it.tags || []).join("\u3001") || it.category}`),
       h(LinksRow, { npm: it.npm, github: it.github, homepage: it.homepage }),
       h(