dsh-plugin-update 0.4.0 → 0.5.1

package/dist/changelog.js

@@ -15,8 +15,8 @@ const CHANGELOG_ALL_CATEGORIES = [
   "Removed",
   "Security"
 ];
-const CHANGELOG_MUST_SHOW = ["Added", "Fixed", "Changed"];
-const CHANGELOG_FOLDED = ["Deprecated", "Removed", "Security"];
+const CHANGELOG_MUST_SHOW = ["Added", "Fixed", "Changed", "Security"];
+const CHANGELOG_FOLDED = ["Deprecated", "Removed"];
 const CHANGELOG_CATEGORY_ZH = {
   Added: "\u65B0\u589E",
   Fixed: "\u4FEE\u590D",
@@ -28,6 +28,9 @@ const CHANGELOG_CATEGORY_ZH = {
 function emptySections() {
   return { Added: [], Fixed: [], Changed: [], Deprecated: [], Removed: [], Security: [] };
 }
+function emptyCounts() {
+  return { Added: 0, Fixed: 0, Changed: 0, Deprecated: 0, Removed: 0, Security: 0 };
+}
 function isCategoryName(v) {
   return CHANGELOG_ALL_CATEGORIES.includes(v);
 }
@@ -60,6 +63,119 @@ function truncateBullet(text) {
   if (t.length <= CHANGELOG_MAX_BULLET_CHARS) return t;
   return `${t.slice(0, CHANGELOG_MAX_BULLET_CHARS - 1)}\u2026`;
 }
+const RE_VERSION_HEADING = /^##(?!#)\s*(.+?)\s*$/;
+const RE_CATEGORY_HEADING = /^###\s*(.+?)\s*$/;
+const RE_BULLET = /^\s*[-*+]\s+(.+?)\s*$/;
+const RE_FENCE_TOGGLE = new RegExp("^\\s*(" + String.fromCharCode(96).repeat(3) + "|~~~)");
+const RE_VERSION_NUM = /(\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?)/;
+const RE_VERSION_DATE = /(\d{4}-\d{2}-\d{2})/;
+const RE_YANKED = /\[YANKED\]/i;
+const RE_UNRELEASED = /unreleased/i;
+function matchVersionHeading(line) {
+  try {
+    const s = String(line !== null && line !== void 0 ? line : "");
+    const m = s.match(RE_VERSION_HEADING);
+    if (!m) return null;
+    return String(m[1] !== void 0 && m[1] !== null ? m[1] : "").trim();
+  } catch {
+    return null;
+  }
+}
+function matchCategoryHeading(line) {
+  try {
+    const s = String(line !== null && line !== void 0 ? line : "");
+    const m = s.match(RE_CATEGORY_HEADING);
+    if (!m) return null;
+    return String(m[1] !== void 0 && m[1] !== null ? m[1] : "").trim();
+  } catch {
+    return null;
+  }
+}
+function matchBulletBody(line) {
+  try {
+    const s = String(line !== null && line !== void 0 ? line : "");
+    const m = s.match(RE_BULLET);
+    if (!m) return null;
+    return String(m[1] !== void 0 && m[1] !== null ? m[1] : "");
+  } catch {
+    return null;
+  }
+}
+function isFenceToggle(line) {
+  try {
+    return RE_FENCE_TOGGLE.test(String(line !== null && line !== void 0 ? line : ""));
+  } catch {
+    return false;
+  }
+}
+const BREAKING_BADGE_TEXT = "\u4E0D\u517C\u5BB9";
+function stripBreakingDecorations(s) {
+  try {
+    let t = String(s !== null && s !== void 0 ? s : "").trim();
+    let changed = true;
+    while (changed) {
+      changed = false;
+      if (t.charAt(0) === ">") {
+        t = t.slice(1).trim();
+        changed = true;
+        continue;
+      }
+      if (t.slice(0, 2) === "**" || t.slice(0, 2) === "__") {
+        t = t.slice(2).trim();
+        changed = true;
+        continue;
+      }
+      if (t.charAt(0) === "*" || t.charAt(0) === "_") {
+        t = t.slice(1).trim();
+        changed = true;
+        continue;
+      }
+    }
+    return t;
+  } catch {
+    return "";
+  }
+}
+function isBreakingChangelogItem(item) {
+  try {
+    if (typeof item !== "string") return false;
+    const t = stripBreakingDecorations(item);
+    if (!t) return false;
+    return /^(breaking|不兼容)\s*[:：]/i.test(t);
+  } catch {
+    return false;
+  }
+}
+function splitBreakingPrefix(item) {
+  try {
+    const s = String(item !== null && item !== void 0 ? item : "");
+    const m = s.match(/^(\s*(?:>\s*|\*\*\s*|__\s*|\*\s*|_\s*)*)(breaking|不兼容)(\s*[:：])/i);
+    if (!m) return null;
+    const head = String(m[1] !== void 0 && m[1] !== null ? m[1] : "");
+    const core = String(m[2] !== void 0 && m[2] !== null ? m[2] : "");
+    const colon = String(m[3] !== void 0 && m[3] !== null ? m[3] : "");
+    const prefix = core + colon;
+    const rest = s.slice(m[0].length);
+    return { head, prefix, rest };
+  } catch {
+    return null;
+  }
+}
+const CHANGELOG_POLL_BACKOFF_MS = 30 * 1e3;
+function shouldFetchChangelog(opts) {
+  try {
+    const o = opts;
+    if (o.hasCache === true) return false;
+    if (o.isManual === true) return true;
+    const now = typeof o.now === "number" && Number.isFinite(o.now) ? o.now : Date.now();
+    const failedAt = typeof o.failedAt === "number" && Number.isFinite(o.failedAt) ? o.failedAt : null;
+    if (failedAt === null) return true;
+    const backoff = typeof o.backoffMs === "number" && Number.isFinite(o.backoffMs) && o.backoffMs > 0 ? Math.floor(o.backoffMs) : CHANGELOG_POLL_BACKOFF_MS;
+    return now - failedAt >= backoff;
+  } catch {
+    return true;
+  }
+}
 function parseChangelog(markdown) {
   try {
     if (typeof markdown !== "string" || !markdown.trim()) return [];
@@ -86,32 +202,38 @@ function parseChangelog(markdown) {
     };
     for (const rawLine of lines) {
       const line = String(rawLine ?? "");
-      if (/^\s*(```|~~~)/.test(line)) {
+      if (isFenceToggle(line)) {
         inFence = !inFence;
         continue;
       }
       if (inFence) continue;
-      const versionHeading = line.match(/^##(?!#)\s*(.+?)\s*$/);
-      if (versionHeading) {
+      const versionTitle = matchVersionHeading(line);
+      if (versionTitle !== null) {
         pushCurrent();
         cur = null;
         curCat = null;
-        const title = (versionHeading[1] ?? "").trim();
+        const title = versionTitle;
         const { version, date, yanked } = extractVersionDateAndYanked(title);
         if (!version) continue;
-        cur = { version, date, yanked, sections: emptySections() };
+        cur = { version, date, yanked, sections: emptySections(), counts: emptyCounts() };
         continue;
       }
-      const catMatch = line.match(/^###\s*(.+?)\s*$/);
-      if (catMatch) {
-        const cat = normalizeCategory(catMatch[1] ?? "");
+      const catTitle = matchCategoryHeading(line);
+      if (catTitle !== null) {
+        const cat = normalizeCategory(catTitle);
         curCat = cur && cat && isCategoryName(cat) ? cat : null;
         continue;
       }
-      const bullet = line.match(/^\s*[-*+]\s+(.+?)\s*$/);
-      if (bullet && cur && curCat) {
-        const item = truncateBullet(bullet[1] ?? "");
-        if (item) cur.sections[curCat].push(item);
+      const bulletBody = matchBulletBody(line);
+      if (bulletBody !== null && cur && curCat) {
+        const item = truncateBullet(bulletBody);
+        if (item) {
+          cur.sections[curCat].push(item);
+          try {
+            if (cur.counts) cur.counts[curCat] += 1;
+          } catch {
+          }
+        }
         continue;
       }
       const trimmed = line.trim();
@@ -189,46 +311,119 @@ function changelogForUpdate(entries, runningVersion, latestVersion, installedVer
 function escapeChangelogHtml(text) {
   return String(text ?? "").replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
 }
+function countsOf(entry) {
+  try {
+    const out = { Added: 0, Fixed: 0, Changed: 0, Deprecated: 0, Removed: 0, Security: 0 };
+    if (!entry || typeof entry !== "object") return out;
+    for (const c of CHANGELOG_ALL_CATEGORIES) {
+      const n = entry.counts;
+      const v = n && typeof n[c] === "number" && Number.isFinite(n[c]) ? Math.floor(n[c]) : null;
+      if (v !== null && v >= 0) {
+        out[c] = v;
+        continue;
+      }
+      const list = entry.sections;
+      const arr = list ? list[c] : null;
+      out[c] = Array.isArray(arr) ? arr.length : 0;
+    }
+    return out;
+  } catch {
+    return { Added: 0, Fixed: 0, Changed: 0, Deprecated: 0, Removed: 0, Security: 0 };
+  }
+}
+function truncatedNoteHTML(total, shown) {
+  try {
+    const m = Math.floor(total);
+    const n = Math.floor(shown);
+    return '<div class="dsh-upd-changelog-count">\u5171 ' + String(m) + " \u6761\uFF0C\u4EC5\u663E\u793A\u524D " + String(n) + " \u6761</div>";
+  } catch {
+    return "";
+  }
+}
+function yankedBannerHTML(version) {
+  try {
+    const v = typeof version === "string" ? version.trim() : "";
+    if (!v) return "";
+    return '<div class="dsh-upd-changelog-yanked" role="alert">\u76EE\u6807\u7248\u672C ' + escapeChangelogHtml(v) + " \u5DF2\u88AB\u4F5C\u8005\u64A4\u56DE\uFF08yanked\uFF09\uFF0C\u5B89\u88C5\u4E0D\u53D7\u5F71\u54CD\uFF0C\u7EE7\u7EED\u524D\u8BF7\u786E\u8BA4\u3002</div>";
+  } catch {
+    return "";
+  }
+}
+function renderChangelogItem(item) {
+  try {
+    const s = String(item !== null && item !== void 0 ? item : "");
+    if (!s) return "";
+    const split = splitBreakingPrefix(s);
+    if (!split) return "<li>" + escapeChangelogHtml(s) + "</li>";
+    const head = escapeChangelogHtml(split.head);
+    const prefix = escapeChangelogHtml(split.prefix);
+    const rest = escapeChangelogHtml(split.rest);
+    const badge = '<span class="dsh-upd-breaking-badge" role="img" aria-label="\u7834\u574F\u6027\u53D8\u66F4">' + BREAKING_BADGE_TEXT + "</span> ";
+    return "<li>" + head + badge + "<strong>" + prefix + "</strong>" + rest + "</li>";
+  } catch {
+    return "";
+  }
+}
 function renderChangelogSection(entry) {
   try {
     if (!entry || typeof entry !== "object") return "";
-    const version = String(entry.version ?? "").trim();
+    const version = String(entry.version !== void 0 && entry.version !== null ? String(entry.version) : "").trim();
     if (!version || isUnreleasedVersion(version)) return "";
     if (!hasVisibleSections(entry)) return "";
-    const date = typeof entry.date === "string" ? String(entry.date) : "";
-    const yankedSuffix = entry.yanked === true ? " \xB7 \u5DF2\u64A4\u56DE" : "";
-    const title = (date ? `${version} \xB7 ${date}` : version) + yankedSuffix;
+    const dateRaw = entry.date;
+    const date = typeof dateRaw === "string" ? dateRaw : "";
+    const yankedFlag = entry.yanked === true;
+    const yankedSuffix = yankedFlag ? " \xB7 \u5DF2\u64A4\u56DE" : "";
+    const title = (date ? version + " \xB7 " + date : version) + yankedSuffix;
+    const counts = countsOf(entry);
     const parts = [];
-    parts.push(`<div class="dsh-upd-changelog-version" data-version="${escapeChangelogHtml(version)}">`);
-    parts.push(`<div class="dsh-upd-changelog-title">${escapeChangelogHtml(title)}</div>`);
+    parts.push('<div class="dsh-upd-changelog-version" data-version="' + escapeChangelogHtml(version) + '">');
+    parts.push('<div class="dsh-upd-changelog-title">' + escapeChangelogHtml(title) + "</div>");
     for (const cat of CHANGELOG_MUST_SHOW) {
-      const items = Array.isArray(entry.sections?.[cat]) ? entry.sections[cat] : [];
-      if (items.length === 0) continue;
-      const label = `${cat} \xB7 ${CHANGELOG_CATEGORY_ZH[cat]}`;
-      parts.push(`<div class="dsh-upd-changelog-cat" data-cat="${cat}">`);
-      parts.push(`<div class="dsh-upd-changelog-catname">${escapeChangelogHtml(label)}</div>`);
+      const items = Array.isArray(entry.sections ? entry.sections[cat] : null) ? entry.sections[cat] : [];
+      if (!items || items.length === 0) continue;
+      const label = cat + " \xB7 " + CHANGELOG_CATEGORY_ZH[cat];
+      parts.push('<div class="dsh-upd-changelog-cat" data-cat="' + cat + '">');
+      parts.push('<div class="dsh-upd-changelog-catname">' + escapeChangelogHtml(label) + "</div>");
+      const total = counts[cat];
+      const shown = items.length;
+      if (total > shown) {
+        parts.push(truncatedNoteHTML(total, shown));
+      }
       parts.push("<ul>");
       for (const item of items) {
         if (!item) continue;
-        parts.push(`<li>${escapeChangelogHtml(item)}</li>`);
+        const li = renderChangelogItem(item);
+        if (li) parts.push(li);
+      }
+      parts.push("</ul>");
+      if (cat === "Security" && total > shown) {
+        const restCount = total - shown;
+        parts.push('<details class="dsh-upd-changelog-security-more"><summary>\u5176\u4F59 ' + String(restCount) + ' \u6761</summary><div class="dsh-upd-changelog-more-note">\u4E3A\u4FDD\u6301\u9762\u677F\u6027\u80FD\uFF0C\u5176\u4F59\u6761\u76EE\u5DF2\u6298\u53E0\uFF0C\u53EF\u67E5\u770B\u539F\u6587\u3002</div></details>');
       }
-      parts.push("</ul></div>");
+      parts.push("</div>");
     }
     for (const cat of CHANGELOG_FOLDED) {
-      const items = Array.isArray(entry.sections?.[cat]) ? entry.sections[cat] : [];
-      if (items.length === 0) continue;
-      const label = `${cat} \xB7 ${CHANGELOG_CATEGORY_ZH[cat]}\uFF08${items.length}\uFF09`;
-      parts.push(`<details class="dsh-upd-changelog-fold" data-cat="${cat}">`);
-      parts.push(`<summary>${escapeChangelogHtml(label)}</summary>`);
+      const items = Array.isArray(entry.sections ? entry.sections[cat] : null) ? entry.sections[cat] : [];
+      if (!items || items.length === 0) continue;
+      const label = cat + " \xB7 " + CHANGELOG_CATEGORY_ZH[cat] + "\uFF08" + String(items.length) + "\uFF09";
+      parts.push('<details class="dsh-upd-changelog-fold" data-cat="' + cat + '">');
+      parts.push("<summary>" + escapeChangelogHtml(label) + "</summary>");
+      const total = counts[cat];
+      const shown = items.length;
+      if (total > shown) {
+        parts.push(truncatedNoteHTML(total, shown));
+      }
       parts.push("<ul>");
       for (const item of items) {
         if (!item) continue;
-        parts.push(`<li>${escapeChangelogHtml(item)}</li>`);
+        const li = renderChangelogItem(item);
+        if (li) parts.push(li);
       }
       parts.push("</ul></details>");
     }
     parts.push("</div>");
-    return parts.join("\n");
+    return parts.join(String.fromCharCode(10));
   } catch {
     return "";
   }
@@ -264,7 +459,165 @@ ${blocks.join("\n")}
     return renderChangelogNeutral();
   }
 }
+const CHANGELOG_VALIDATE_HINTS = {
+  E_VERSION_TITLE: "\u8BE5\u6807\u9898\u4E0D\u662F\u5408\u6CD5\u7248\u672C\u53F7\uFF0C\u5176\u4E0B\u6761\u76EE\u5DF2\u88AB\u5FFD\u7565\uFF0C\u8BF7\u6539\u6210 ## [x.y.z] \u5F62\u6001",
+  E_CATEGORY: "\u672A\u77E5\u5206\u7C7B\uFF0C\u5176\u4E0B\u6761\u76EE\u5DF2\u88AB\u5FFD\u7565\uFF0C\u4EC5\u6536 Added/Fixed/Changed/Deprecated/Removed/Security",
+  E_BULLET_ORPHAN: "\u8BE5\u6761\u76EE\u4E0D\u5728\u7248\u672C\u8282\u4E0E\u5206\u7C7B\u4E0B\uFF0C\u5DF2\u88AB\u5FFD\u7565",
+  W_BREAKING_MAYBE: "\u7591\u4F3C\u7834\u574F\u6807\u8BB0\u8BEF\u5199\uFF08\u7F3A\u5192\u53F7/\u62FC\u5199\u63A5\u8FD1/\u4F4D\u7F6E\u7591\u4F3C\u653E\u9519\uFF09\uFF0C\u8BF7\u68C0\u67E5\u662F\u5426\u60F3\u5199 BREAKING:/\u4E0D\u517C\u5BB9:",
+  W_YANKED: "\u8BE5\u7248\u672C\u5DF2\u88AB\u6807\u8BB0\u64A4\u56DE\uFF08yanked\uFF09\uFF0C\u5B89\u88C5\u4E0D\u53D7\u5F71\u54CD\uFF0C\u7EE7\u7EED\u524D\u8BF7\u786E\u8BA4",
+  W_TRUNCATED: "\u8BE5\u7C7B\u5171 M \u6761\uFF0C\u4EC5\u663E\u793A\u524D N \u6761",
+  W_TRUNCATED_FILE: "\u6587\u4EF6\u8D85 64K\uFF0C\u4EC5\u6821\u9A8C\u524D 64K",
+  W_EMPTY: "\u672A\u89E3\u6790\u5230\u4EFB\u4F55\u7248\u672C\u8282\uFF0C\u9762\u677F\u5C06\u663E\u793A\u4E2D\u6027\u63D0\u793A"
+};
+function isMaybeBreakingMisuse(bulletBody) {
+  try {
+    if (typeof bulletBody !== "string") return false;
+    const t = stripBreakingDecorations(bulletBody);
+    if (!t) return false;
+    if (isBreakingChangelogItem(bulletBody)) return false;
+    if (/^breaking\s*$/i.test(t)) return true;
+    if (/^breaking\s+[^:：]/i.test(t)) return true;
+    if (/^breaking[^:：\s\w]/i.test(t)) return true;
+    if (/^不兼容\s*$/i.test(t)) return true;
+    if (/^不兼容\s*[^:：]/i.test(t)) return true;
+    if (/^(braking|breking|breakign|brekaing|braeking|breakingg)\b/i.test(t)) return true;
+    if (/^break[^i:：\s]/i.test(t)) return true;
+    return false;
+  } catch {
+    return false;
+  }
+}
+function validateChangelog(markdown) {
+  try {
+    if (typeof markdown !== "string" || !markdown.trim()) {
+      return { ok: true, diagnostics: [{ line: 1, code: "W_EMPTY", hint: CHANGELOG_VALIDATE_HINTS.W_EMPTY }] };
+    }
+    let raw = String(markdown).replace(/\r\n/g, String.fromCharCode(10));
+    let fileTruncated = false;
+    if (raw.length > CHANGELOG_MAX_CHARS) {
+      fileTruncated = true;
+      raw = raw.slice(0, CHANGELOG_MAX_CHARS);
+    }
+    const lines = raw.split(String.fromCharCode(10));
+    const diags = [];
+    let inFence = false;
+    let curValid = false;
+    let curCat = null;
+    let catLineByCat = {};
+    let countByCat = {};
+    let hasVisibleVersion = false;
+    const flushCounts = function() {
+      try {
+        for (const k of Object.keys(countByCat)) {
+          const n = countByCat[k];
+          if (n > CHANGELOG_MAX_BULLETS_PER_SECTION) {
+            const lineNo = catLineByCat[k] ? catLineByCat[k] : lines.length;
+            const hint = "\u5206\u7C7B " + k + " \u5171 " + String(n) + " \u6761\uFF0C\u4EC5\u663E\u793A\u524D " + String(CHANGELOG_MAX_BULLETS_PER_SECTION) + " \u6761";
+            diags.push({ line: lineNo, code: "W_TRUNCATED", hint });
+          }
+        }
+      } catch {
+      }
+    };
+    for (let i = 0; i < lines.length; i++) {
+      const lineNo = i + 1;
+      const line = String(lines[i] !== void 0 && lines[i] !== null ? lines[i] : "");
+      if (isFenceToggle(line)) {
+        inFence = !inFence;
+        continue;
+      }
+      if (inFence) continue;
+      const vTitle = matchVersionHeading(line);
+      if (vTitle !== null) {
+        flushCounts();
+        catLineByCat = {};
+        countByCat = {};
+        curValid = false;
+        curCat = null;
+        const info = extractVersionDateAndYanked(vTitle);
+        if (!info.version) {
+          diags.push({ line: lineNo, code: "E_VERSION_TITLE", hint: CHANGELOG_VALIDATE_HINTS.E_VERSION_TITLE });
+          continue;
+        }
+        if (isUnreleasedVersion(info.version)) {
+          curValid = false;
+          continue;
+        }
+        curValid = true;
+        hasVisibleVersion = true;
+        if (info.yanked) {
+          diags.push({ line: lineNo, code: "W_YANKED", hint: CHANGELOG_VALIDATE_HINTS.W_YANKED });
+        }
+        continue;
+      }
+      const cTitle = matchCategoryHeading(line);
+      if (cTitle !== null) {
+        const cat = normalizeCategory(cTitle);
+        if (!cat) {
+          curCat = null;
+          diags.push({ line: lineNo, code: "E_CATEGORY", hint: CHANGELOG_VALIDATE_HINTS.E_CATEGORY });
+          continue;
+        }
+        if (!curValid) {
+          curCat = null;
+          continue;
+        }
+        curCat = cat;
+        catLineByCat[cat] = lineNo;
+        if (countByCat[cat] === void 0) countByCat[cat] = 0;
+        continue;
+      }
+      const body = matchBulletBody(line);
+      if (body !== null) {
+        if (!curValid || !curCat) {
+          diags.push({ line: lineNo, code: "E_BULLET_ORPHAN", hint: CHANGELOG_VALIDATE_HINTS.E_BULLET_ORPHAN });
+          continue;
+        }
+        countByCat[curCat] = (countByCat[curCat] ? countByCat[curCat] : 0) + 1;
+        if (isMaybeBreakingMisuse(body)) {
+          diags.push({ line: lineNo, code: "W_BREAKING_MAYBE", hint: CHANGELOG_VALIDATE_HINTS.W_BREAKING_MAYBE });
+        }
+        continue;
+      }
+    }
+    flushCounts();
+    if (fileTruncated) {
+      diags.push({ line: lines.length, code: "W_TRUNCATED_FILE", hint: CHANGELOG_VALIDATE_HINTS.W_TRUNCATED_FILE });
+    }
+    if (!hasVisibleVersion) {
+      let anyVisible = false;
+      try {
+        const parsed = parseChangelog(markdown);
+        for (const e of parsed) {
+          if (e && !isUnreleasedVersion(e.version) && hasVisibleSections(e)) {
+            anyVisible = true;
+            break;
+          }
+        }
+      } catch {
+        anyVisible = false;
+      }
+      if (!anyVisible) {
+        diags.push({ line: lines.length, code: "W_EMPTY", hint: CHANGELOG_VALIDATE_HINTS.W_EMPTY });
+      }
+    }
+    diags.sort(function(a, b) {
+      return a.line - b.line;
+    });
+    let ok = true;
+    for (const d of diags) {
+      if (d.code.charAt(0) === "E") {
+        ok = false;
+        break;
+      }
+    }
+    return { ok, diagnostics: diags };
+  } catch {
+    return { ok: false, diagnostics: [] };
+  }
+}
 export {
+  BREAKING_BADGE_TEXT,
   CHANGELOG_ALL_CATEGORIES,
   CHANGELOG_CATEGORY_ZH,
   CHANGELOG_FILENAME,
@@ -276,12 +629,36 @@ export {
   CHANGELOG_MUST_SHOW,
   CHANGELOG_NEUTRAL_HINT,
   CHANGELOG_NEUTRAL_LINE,
+  CHANGELOG_POLL_BACKOFF_MS,
+  CHANGELOG_VALIDATE_HINTS,
+  RE_BULLET,
+  RE_CATEGORY_HEADING,
+  RE_FENCE_TOGGLE,
+  RE_UNRELEASED,
+  RE_VERSION_DATE,
+  RE_VERSION_HEADING,
+  RE_VERSION_NUM,
+  RE_YANKED,
   changelogForUpdate,
+  countsOf,
   hasVisibleSections,
+  isBreakingChangelogItem,
+  isFenceToggle,
+  isMaybeBreakingMisuse,
   isUnreleasedVersion,
+  matchBulletBody,
+  matchCategoryHeading,
+  matchVersionHeading,
   parseChangelog,
   renderChangelogHTML,
+  renderChangelogItem,
   renderChangelogNeutral,
   renderChangelogSection,
-  selectChangelogEntries
+  selectChangelogEntries,
+  shouldFetchChangelog,
+  splitBreakingPrefix,
+  stripBreakingDecorations,
+  truncatedNoteHTML,
+  validateChangelog,
+  yankedBannerHTML
 };

package/dist/entry.d.ts

@@ -5,7 +5,11 @@ export type EntryVariant = 'button' | 'badge' | 'inline';
 /** 什么时候主动查一次（只读，联网一次）。 */
 export type EntryAutoCheck = 'mount' | 'never';
 /** 用户点下去之后做什么。 */
-export type EntryOpenOn = 'has-update' | 'always' | 'manual';
+/**
+ * 点下去之后做什么：`has-update` 有新版才开面板（无事只给一句小字）；`always` 检查完总是开；
+ * `manual` 交给 onActivate；`direct` 点开即弹窗、不预查（面板挂载即自查；badge 仍走回调口径）。
+ */
+export type EntryOpenOn = 'has-update' | 'always' | 'manual' | 'direct';
 /** 入口件主题（与面板同一套取值，切换即换肤）。 */
 export type EntryTheme = UpdatePanelTheme;
 /** 入口件的状态档：只用来算文案与 data-state，不另立状态机。 */
@@ -22,7 +26,8 @@ export interface UpdateEntryOptions {
     /** 调宿主电话：(phoneName, args) => Promise<reply>。 */
     call: (name: string, args: Record<string, unknown>) => Promise<unknown>;
     variant?: EntryVariant;
-    theme?: 'default' | 'd5-paper';
+    /** 主题：`default` 最小可用深色，`archive` 档案卷纸面浅色（`d5-paper` 为旧别名仍可用）。 */
+    theme?: UpdatePanelTheme;
     /** 缺省 'mount'：进页面静默查一次（只读）。'never' 则只在用户点击时查。 */
     autoCheck?: EntryAutoCheck;
     /** 缺省 'has-update'：有新版才开面板，没有就只在原地给一句提示。 */
@@ -52,7 +57,7 @@ export interface UpdateEntryController {
     close(): void;
     /** 当前按钮上的状态文案（接入方做自定义排版时读它）。 */
     label(): string;
-    setTheme(theme: 'default' | 'd5-paper'): void;
+    setTheme(theme: UpdatePanelTheme): void;
     unmount(): void;
 }
 /**

package/dist/entry.js

@@ -2,7 +2,8 @@
 import { DEFAULT_PREFIX, MIN_PANEL_POLL_MS, buildPhoneNames } from "./config.js";
 import {
   failureCodeOf,
-  mountUpdatePanel
+  mountUpdatePanel,
+  normalizePanelTheme
 } from "./panel.js";
 const LABEL_IDLE = "\u68C0\u67E5\u66F4\u65B0";
 const LABEL_FAILED = "\u66F4\u65B0\u5931\u8D25\uFF0C\u70B9\u6B64\u67E5\u770B";
@@ -63,10 +64,15 @@ const UPDATE_ENTRY_CSS = [
   '.dsh-upd-entry[data-state="update"] .dsh-upd-entry-dot{background:var(--dsh-upd-ok-line,#059669)}',
   '.dsh-upd-entry[data-state="busy"] .dsh-upd-entry-dot,.dsh-upd-entry[data-state="restart"] .dsh-upd-entry-dot{background:var(--dsh-upd-warn-line,#d97706)}',
   '.dsh-upd-entry[data-state="failed"] .dsh-upd-entry-dot{background:var(--dsh-upd-bad-line,#dc2626)}',
-  ".dsh-upd-entry-note{font-size:12.5px;opacity:.75}",
-  '.dsh-upd-entry[data-theme="d5-paper"]{font-family:Georgia,"Songti SC","STSong","SimSun",serif;color:#1a1a1a}',
-  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-btn{border-color:#c4b896;background:transparent;border-radius:3px}',
-  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-btn:hover{border-color:#c8402a;color:#c8402a}',
+  // 小字自带底（深色宿主 + 浅色变量时也读得出；浅底宿主上只是多一圈细线，不抢戏）。
+  ".dsh-upd-entry-note{font-size:12.5px;opacity:.9;background:var(--dsh-upd-bg,#ffffff);border:1px solid var(--dsh-upd-line,#e5e7eb);border-radius:4px;padding:1px 8px}",
+  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-note{background:var(--d5-card);border-color:var(--d5-line-strong);color:var(--d5-ink)}',
+  '.dsh-upd-entry[data-theme="d5-paper"]{--d5-ink:#1a1a1a;--d5-muted:#6f675a;--d5-line-strong:#c4b896;--d5-accent:#c8402a;--d5-card:#fffdf6;',
+  'font-family:Georgia,"Songti SC","STSong","SimSun",serif;color:var(--d5-ink)}',
+  // 按钮脸自己不透明（深色宿主 + 浅色系统变量时也读得出；hover 红在深浅底上都可见）。
+  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-btn{border-color:var(--d5-line-strong);background:var(--d5-card);color:var(--d5-ink);border-radius:3px}',
+  '.dsh-upd-entry[data-theme="d5-paper"] .dsh-upd-entry-btn:hover{border-color:var(--d5-accent);color:var(--d5-accent)}',
+  '@media (prefers-color-scheme: dark){.dsh-upd-entry[data-theme="d5-paper"]{--d5-ink:#ece5d3;--d5-muted:#a89c83;--d5-line-strong:#5c4e3b;--d5-accent:#e0684e;--d5-card:#1e1a15}}',
   "@media (prefers-color-scheme: dark){.dsh-upd-entry{color:#e5e7eb}",
   ".dsh-upd-entry-btn{--dsh-upd-btn:#1f2937;--dsh-upd-line:#374151}}"
 ].join("\n");
@@ -110,13 +116,13 @@ function mountUpdateEntry(container, options) {
     throw new Error(`[dsh-plugin-update] \u81EA\u52A8\u68C0\u67E5\u65F6\u673A\u975E\u6CD5\uFF1A\u53EA\u6536 mount \u6216 never\uFF08\u6536\u5230 ${JSON.stringify(options.autoCheck)}\uFF09`);
   }
   const openOn = options.openOn ?? "has-update";
-  if (openOn !== "has-update" && openOn !== "always" && openOn !== "manual") {
-    throw new Error(`[dsh-plugin-update] \u70B9\u51FB\u53BB\u5411\u975E\u6CD5\uFF1A\u53EA\u6536 has-update / always / manual\uFF08\u6536\u5230 ${JSON.stringify(options.openOn)}\uFF09`);
+  if (openOn !== "has-update" && openOn !== "always" && openOn !== "manual" && openOn !== "direct") {
+    throw new Error(`[dsh-plugin-update] \u70B9\u51FB\u53BB\u5411\u975E\u6CD5\uFF1A\u53EA\u6536 has-update / always / manual / direct\uFF08\u6536\u5230 ${JSON.stringify(options.openOn)}\uFF09`);
   }
-  let theme = options.theme ?? "default";
-  if (theme !== "default" && theme !== "d5-paper") {
-    throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 d5-paper\uFF08\u6536\u5230 ${JSON.stringify(options.theme)}\uFF09`);
+  if (options.theme !== void 0 && options.theme !== "default" && options.theme !== "archive" && options.theme !== "d5-paper") {
+    throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 archive\uFF08d5-paper \u4E3A\u65E7\u522B\u540D\u4ECD\u53EF\u7528\uFF09\uFF08\u6536\u5230 ${JSON.stringify(options.theme)}\uFF09`);
   }
+  let theme = normalizePanelTheme(options.theme ?? "default");
   const pollMs = options.pollMs;
   if (pollMs !== void 0 && (typeof pollMs !== "number" || !Number.isFinite(pollMs) || pollMs < MIN_PANEL_POLL_MS)) {
     throw new Error(`[dsh-plugin-update] \u9762\u677F\u8F6E\u8BE2\u95F4\u9694\u975E\u6CD5\uFF1A\u4E0D\u5F97\u5C0F\u4E8E 250 \u6BEB\u79D2\uFF08\u6536\u5230 ${JSON.stringify(options.pollMs)}\uFF09`);
@@ -219,6 +225,8 @@ function mountUpdateEntry(container, options) {
       profileName,
       autoChangelog: options.autoChangelog,
       changelogMarkdown: options.changelogMarkdown ?? null,
+      // 面板点「关闭」即走入口件的完整关闭（收 dialog + 还原按钮 + 重查一次），不再是面板自己停轮询。
+      onCloseRequested: () => close(),
       call: panelCall
     });
     panelMode = mode;
@@ -245,6 +253,10 @@ function mountUpdateEntry(container, options) {
   }
   async function activate() {
     if (!mounted || panelMode !== null || activating) return;
+    if (openOn === "direct" && variant === "button") {
+      openDialog();
+      return;
+    }
     activating = true;
     note = null;
     render();
@@ -268,11 +280,11 @@ function mountUpdateEntry(container, options) {
     render();
   }
   function setTheme(next) {
-    if (next !== "default" && next !== "d5-paper") {
-      throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 d5-paper\uFF08\u6536\u5230 ${JSON.stringify(next)}\uFF09`);
+    if (next !== "default" && next !== "archive" && next !== "d5-paper") {
+      throw new Error(`[dsh-plugin-update] \u4E3B\u9898\u975E\u6CD5\uFF1A\u53EA\u6536 default \u6216 archive\uFF08d5-paper \u4E3A\u65E7\u522B\u540D\u4ECD\u53EF\u7528\uFF09\uFF08\u6536\u5230 ${JSON.stringify(next)}\uFF09`);
     }
-    theme = next;
-    if (panel) void panel.setTheme(next);
+    theme = normalizePanelTheme(next);
+    if (panel) void panel.setTheme(theme);
     else render();
   }
   function onClick(ev) {
@@ -285,7 +297,6 @@ function mountUpdateEntry(container, options) {
         void activate();
         return;
       }
-      if (panelMode === "dialog" && closest('[data-action="close-view"]')) close();
     } catch {
     }
   }

package/dist/host.d.ts

@@ -10,8 +10,8 @@ export { COPY_BUDGET_CHARS, DETAIL_MAX_CHARS, DIAG_DROP_ORDER, DIAG_INLINE_BUDGE
 export type { DiagDropKey, RedactionRuleName } from './redaction.js';
 export { DIAG_ACTIONS, DIAG_KEYS, DIAG_KNOWN_TYPES, DIAG_STAGE_EXPECT, DIAG_STAGES, DIAG_VERSION, buildDiag, deriveAction, deriveRouteMethod, deriveStage, enforceBudget as enforceDiagBudgetForPhone, } from './diag.js';
 export type { DiagAction, DiagInput, DiagObject, DiagStage } from './diag.js';
-export { CHANGELOG_ALL_CATEGORIES, CHANGELOG_FILENAME, CHANGELOG_FOLDED, CHANGELOG_MAX_BULLETS_PER_SECTION, CHANGELOG_MAX_BULLET_CHARS, CHANGELOG_MAX_CHARS, CHANGELOG_MAX_ENTRIES, CHANGELOG_MUST_SHOW, CHANGELOG_NEUTRAL_HINT, CHANGELOG_NEUTRAL_LINE, changelogForUpdate, hasVisibleSections, isUnreleasedVersion, parseChangelog, renderChangelogHTML, renderChangelogNeutral, renderChangelogSection, selectChangelogEntries, } from './changelog.js';
-export type { ChangelogCategory, ChangelogEntry } from './changelog.js';
+export { CHANGELOG_ALL_CATEGORIES, CHANGELOG_FILENAME, CHANGELOG_FOLDED, CHANGELOG_MAX_BULLETS_PER_SECTION, CHANGELOG_MAX_BULLET_CHARS, CHANGELOG_MAX_CHARS, CHANGELOG_MAX_ENTRIES, CHANGELOG_MUST_SHOW, CHANGELOG_NEUTRAL_HINT, CHANGELOG_NEUTRAL_LINE, BREAKING_BADGE_TEXT, CHANGELOG_POLL_BACKOFF_MS, changelogForUpdate, countsOf, hasVisibleSections, isBreakingChangelogItem, isUnreleasedVersion, parseChangelog, renderChangelogHTML, renderChangelogItem, renderChangelogNeutral, renderChangelogSection, selectChangelogEntries, shouldFetchChangelog, splitBreakingPrefix, truncatedNoteHTML, validateChangelog, yankedBannerHTML, } from './changelog.js';
+export type { ChangelogCategory, ChangelogDiagnostic, ChangelogEntry, ChangelogValidation } from './changelog.js';
 export { CHANGELOG_DEFAULT_REGISTRY, CHANGELOG_FETCH_MAX_BYTES, CHANGELOG_TAR_MAX_BYTES, CHANGELOG_TARBALL_MAX_BYTES, extractChangelogFromTar, fetchReleaseChangelogText, readInstalledChangelogText, } from './changelog-io.js';
 export type { ReleaseChangelogRef } from './changelog-io.js';
 export { createUpdateDiskPorts, createUpdateExecutor, pathsForUpdate, resolveCliEntry } from './store.js';