dsh-desktop-statusbar 2.1.2 → 2.2.0

package/lib/release-age.js

@@ -109,6 +109,73 @@ export function unionSelectors(selectors) {
   return versions.join(' || ')
 }
 
+/**
+ * 本插件在豁免列表里**最多保留几个版本**。
+ *
+ * 为什么要裁：早先的实现是只追加不清理，每更新一次就往同一条规则里多塞一个版本，
+ * 于是磁盘上长成 `2.0.0 || 2.0.1 || 2.1.0 || 2.1.1 || 2.1.2 || …`。它不会让安装失败
+ * （pnpm 认 `||` 并集），但有两个实际坏处：
+ *   · 规则无限变长，用户看不懂这一行在干什么；
+ *   · 更要紧的是当时还只保留**最早那条**，一旦某次真的写成两条同名规则，
+ *     pnpm 只认第一条 —— 新版本会被 24 小时发布年龄挡下。
+ *
+ * 保留 2 个（本次目标 + 上一次）而不是只留 1 个：用户升级后发现新版有问题，
+ * 想退回上一版时，上一版仍在豁免里，回滚不会被发布年龄策略拦。
+ * 更老的版本没有再回滚的现实意义（跨大版本回滚本就要手工处理配置/台账）。
+ */
+export const MAX_EXEMPT_VERSIONS = 2;
+
+/**
+ * 从一堆版本号里挑出该保留的：**目标版本必留**，再按出现顺序留最近的若干个。
+ *
+ * 不假设输入是升序（`||` 里的顺序是历史写入顺序，早期实现还可能乱序），
+ * 所以这里按**语义版本**排序后取最大的几个 —— 对于「最近」这个语义，
+ * 版本号大小比写入顺序更可靠。
+ *
+ * @param {string[]} versions 已有的版本号（可能乱序、可能重复）
+ * @param {string} target 本次要放行的版本
+ * @param {number} [keep] 最多保留几个
+ * @returns {string[]} 要保留的版本；目标版本排在最后（书写顺序：旧 → 新）
+ */
+export function keepRecentVersions(versions, target, keep = MAX_EXEMPT_VERSIONS) {
+  const all = []
+  const push = (one) => {
+    const text = String(one).trim()
+    if (text.length > 0 && all.includes(text) !== true) all.push(text)
+  }
+  versions.forEach(push)
+  push(target)
+  const limit = keep > 0 ? keep : 1
+  if (all.length <= limit) return all
+  /* 语义版本比较：把 x.y.z(-pre) 拆成数字段；解析不出数字的（理论上不会有，
+     ensureReleaseAgeExclude 已校验过版本形态）当作 0 处理，排在最后 */
+  const keyOf = (one) => String(one).split('-')[0].split('.').map((part) => Number(part) || 0)
+  const sorted = all.slice().sort((a, b) => {
+    const ka = keyOf(a)
+    const kb = keyOf(b)
+    for (let i = 0; i < 3; i += 1) {
+      if (ka[i] !== kb[i]) return ka[i] - kb[i]
+    }
+    return 0
+  })
+  /* 从最大的往下取 limit 个，再按升序写回去（读起来自然是旧 → 新） */
+  const picked = sorted.slice(Math.max(0, sorted.length - limit))
+  /* 目标版本必须在里面 —— 极端情况下（目标版本号小于已保留的那些）也要保住它 */
+  if (picked.includes(target) !== true) {
+    picked.sort((a, b) => {
+      const ka = keyOf(a)
+      const kb = keyOf(b)
+      for (let i = 0; i < 3; i += 1) {
+        if (ka[i] !== kb[i]) return ka[i] - kb[i]
+      }
+      return 0
+    })
+    picked.shift()
+    picked.push(target)
+  }
+  return picked.filter((one) => one.length > 0)
+}
+
 /** 去掉包裹标量的引号（成对才剥，与 parseExcludeBlock 同规则）。 */
 function unquoteScalar(value) {
   const text = String(value).trim()
@@ -269,6 +336,22 @@ function locateExcludeBlock(source) {
  */
 export function mergeExcludeIntoYaml(text, name, version, eol = '\n') {
   const source = String(text)
+  /* ------------------------------------------------------------------ 安全阀
+     这个函数改的是**共享文件** `pnpm-workspace.yaml`：写坏了不只是本插件装不上，
+     整个 profile 里所有插件都起不来（YAML `duplicated mapping key` → pnpm 拒绝解析）。
+
+     最坏的一种输入：文件里**已经有两个** `minimumReleaseAgeExclude:` 键
+     （历史遗留，或两个插件各自追加过）。`locateExcludeBlock` 只定位第一个块，
+     替换后第二个原样留着 —— 输出仍是两个同名键，照样把 profile 写坏。
+
+     这种状态下唯一安全的动作是**什么都不做**：返回 ok:false，调用方
+     （ensureReleaseAgeExclude）会把它转成结构化失败，安装流程继续走 ——
+     profile 没显式设这个策略时 pnpm 自己会豁免精确版本，安装本来就能成。
+     宁可这次豁免没生效，也绝不能把一个本来还能用的 profile 写坏。 */
+  const keyCount = (source.match(/^[ \t]*minimumReleaseAgeExclude:/gm) || []).length
+  if (keyCount > 1) {
+    return { ok: false, text: source, changed: false, reason: 'duplicate-key' }
+  }
   const found = locateExcludeBlock(source)
 
   if (found === null) {
@@ -281,11 +364,22 @@ export function mergeExcludeIntoYaml(text, name, version, eol = '\n') {
   const items = parseInlineValue(found.inline).concat(parseExcludeBlock(found.block))
   const byName = new Map()
   const order = []
+  /* 每个包名对应的一组「原始行」：块风格解析出来的条目带着逐字节原样的 `line`，
+     flow 风格的条目没有（它本来就要从 flow 重写成块），记 null。
+     别人的规则能用原始行时**必须原样写回** —— 早先每个条目都重新生成一遍，
+     结果 `dshmarket@1.66.22 || 1.66.32` 被加上引号变成 `'dshmarket@1.66.22 || 1.66.32'`。
+     语义虽然等价，但那是**别人的配置**，我们没有任何理由去改写它（用户的 diff 会脏）。 */
+  const rawLines = new Map()
   for (const item of items) {
     if (item.kind !== 'entry') continue
     const groupName = nameOfSelector(item.selector)
-    if (byName.has(groupName) !== true) { byName.set(groupName, []); order.push(groupName) }
+    if (byName.has(groupName) !== true) {
+      byName.set(groupName, [])
+      rawLines.set(groupName, [])
+      order.push(groupName)
+    }
     byName.get(groupName).push(item.selector)
+    rawLines.get(groupName).push(typeof item.line === 'string' ? item.line : null)
   }
 
   const mine = byName.get(name) ?? []
@@ -297,14 +391,22 @@ export function mergeExcludeIntoYaml(text, name, version, eol = '\n') {
   if (mine.length === 1 && versionOfSelector(mine[0]) === '') {
     return { ok: true, text: source, changed: false, reason: null }
   }
-  if (versions.includes(version)) {
-    /* 已经有这个版本：若只有一条规则，什么都不用改 */
-    if (mine.length === 1) return { ok: true, text: source, changed: false, reason: null }
-    /* 有多条我们的规则：合并成一条，避免 pnpm 只认第一条导致我们这条被忽略 */
+  /* 本插件的规则要**裁剪**：只留目标版本 + 最近一个（见 MAX_EXEMPT_VERSIONS）。
+     早先只追加不清理，历史版本会永久累积成一条越来越长的 `||` 列表。 */
+  const keptVersions = keepRecentVersions(versions, version)
+  const keptSelector = name + '@' + keptVersions.join(' || ')
+  if (mine.length === 1) {
+    const already = versionOfSelector(mine[0]).split('||').map((one) => one.trim()).filter((one) => one.length > 0)
+    /* 目标版本已在、且集合没变（不需要裁剪）→ 一个字节都不动，保持幂等 */
+    if (already.length === keptVersions.length && keptVersions.every((one) => already.includes(one))) {
+      return { ok: true, text: source, changed: false, reason: null }
+    }
   }
-  if (byName.has(name) !== true) order.push(name)
-  if (byName.has(name) !== true) byName.set(name, [])
-  byName.get(name).push(name + '@' + version)
+  /* 用裁剪后的版本集合替换该包名的条目（不是追加） */
+  byName.set(name, [keptSelector])
+  /* 我们这条要**重新生成**（没有可原样复用的原始行），所以原始行记 null */
+  rawLines.set(name, [null])
+  if (order.indexOf(name) === -1) order.push(name)
 
   /* 重排这个块：每个包名一条，位置取它首次出现的地方；注释原样保留在最前。 */
   const comments = items.filter((item) => item.kind === 'comment')
@@ -312,6 +414,23 @@ export function mergeExcludeIntoYaml(text, name, version, eol = '\n') {
   for (const item of comments) lines.push(item.line)
   for (const groupName of order) {
     const selectors = byName.get(groupName) ?? []
+    const raws = rawLines.get(groupName) ?? []
+    /* 我们自己的那条：用裁剪后的版本集合重新生成 */
+    if (groupName === name) {
+      const merged = versionOfSelector(keptSelector)
+      const selector = merged.length === 0 ? groupName : groupName + '@' + merged
+      lines.push('  - ' + (selector.startsWith('@') || selector.includes(' || ') ? "'" + selector.replace(/'/g, "''") + "'" : selector))
+      continue
+    }
+    /* 别人的规则：只要它还是**一条且原始行可用**，就原样写回。
+       唯一例外是缩进 —— 重排后整个块统一用两空格缩进，零缩进的旧条目必须跟着对齐，
+       否则同一个序列里混着两种缩进，YAML 直接解析失败（实测过）。
+       所以这里只动**前导空白**，`-` 之后的正文（含引号、`||`、大小写）一个字节都不改。 */
+    if (raws.length === 1 && typeof raws[0] === 'string' && raws[0].length > 0) {
+      const body = raws[0].replace(/^[ \t]*/, '')
+      lines.push('  ' + body)
+      continue
+    }
     const merged = unionSelectors(selectors)
     /* pnpm 把同名的多条并成一条；只有一个版本时保持 `name@version` 的朴素写法 */
     const selector = merged.length === 0 ? groupName : groupName + '@' + merged

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "dsh-desktop-statusbar",
-  "version": "2.1.2",
+  "version": "2.2.0",
   "type": "module",
   "description": "把 DSH 桌面端对话区底部的统计行换成可配置状态栏：10 个字段可选可排序，按官方峰谷口径估算费用，支持自定义模型单价与账户余额。",
   "icon": "icon.svg",
   "license": "MIT",
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.2.0-rc.2"
   },
   "author": "北浮森屿 (https://github.com/raphael-y7)",
   "repository": {