dsh-m 0.9.17 → 0.9.19

package/lib/core/profile-ops.js

@@ -14,6 +14,9 @@
  *   重试把 pending 名单原样传回 `approvedBuilds`（键格式由官方管理器自己写），
  *   dsh-m 绝不直接编辑 desktop profile 的 pnpm-workspace.yaml，绝不全量放行；
  * - 成功判定 = 官方结果无 error + `listBundles()` 复读目标 bundle 在装，二者同时满足。
+ * - 0.9.19：供应链等待期在委派前预检（release-age.ts，零写操作 fail-open）；失败翻译解析
+ *   全部违规条目并复读「账实分裂」（pnpm 11 锁文件校验失败前目标已写入 node_modules、
+ *   官方管理器只回滚 manifest/lockfile 的实证形态——0:15 quota-watch 事件）。
  *
  * 禁止事项：desktop 路径零 Web fallback——不做文件级装后守卫（app.asar 探测盲区）、
  * 不写 allowBuilds、不跑 dsh-m 自实现 pnpm 编排、服务缺席一律结构化拒绝。
@@ -26,39 +29,21 @@ import { listInstalledPlugins as defaultListInstalled } from './installed.js';
 import { precheckNpmCompat, IncompatibleError } from './compat-check.js';
 import { npmLatest as defaultNpmLatest, githubLatestTag as defaultGithubLatestTag } from './versions.js';
 import { togglePlugin, ToggleError } from './toggle.js';
-function humanDuration(ms) {
-    if (!Number.isFinite(ms) || ms <= 0)
-        return '不到 1 分钟';
-    const minutes = Math.round(ms / 60_000);
-    if (minutes < 60)
-        return `${minutes} 分钟`;
-    const hours = Math.floor(minutes / 60);
-    const rest = minutes % 60;
-    return rest ? `${hours} 小时 ${rest} 分钟` : `${hours} 小时`;
-}
-/**
- * 0.9.10：desktop profile 的 pnpm 供应链策略（minimumReleaseAge）拒绝「太新鲜」的版本——
- * 这是策略在正确工作（防供应链攻击的发布等待期），不是环境故障。解析出条目/发布时刻/
- * 策略截止，翻译成「何时可重试」的诚实指引，而不是甩一屏 pnpm 原文（dsh-market #732 同态度）。
- */
-function releaseAgeWaitMessage(diagnostic) {
-    const m = /(\S+@\S+) was published at ([^,]+), within the minimumReleaseAge cutoff \(([^)]+)\)/.exec(diagnostic);
-    if (!m) {
-        return '官方管理器的供应链策略（minimumReleaseAge）未满足：新发布的版本需满等待期才能装入 desktop profile。稍后再点升级即可；等待期内也可改用 DSH Web 安装';
-    }
-    const entry = m[1];
-    const publishedAt = Date.parse(m[2]);
-    const cutoff = Date.parse(m[3]);
-    const deadline = Number.isFinite(publishedAt) && Number.isFinite(cutoff) ? publishedAt + (Date.now() - cutoff) : NaN;
-    const when = Number.isFinite(deadline) ? `约 ${humanDuration(deadline - Date.now())}后（${new Date(deadline).toLocaleString('zh-CN', { hour12: false })}）` : '稍后';
-    return `官方管理器的供应链策略（minimumReleaseAge）要求新发布版本满等待期才能安装：${entry} 尚在等待期内，预计 ${when}可重试。等待期内也可改用 DSH Web 安装同版本`;
-}
+import { describeReleaseAgeFailure, releaseAgePrecheck } from './release-age.js';
+// 0.9.19：等待期失败翻译移入 release-age.ts（describeReleaseAgeFailure）——全量违规解析 +
+// 目标/旁包分述。0.9.10 版只取第一条违规并把旁包名字当成本次目标、给「改用 DSH Web」的
+// 失配指引（本机 quota-watch 0.1.15 事件实证：被拦的是旁包 dsh-m@0.9.18，文案却让用户等
+// 旁包满期、去装 web profile）。
 export class DesktopOpsError extends Error {
     code;
-    constructor(code, message) {
+    /** 0.9.19：结构化细节（release-age：violations/targetViolating/splitState；precheck：blockers）。 */
+    details;
+    constructor(code, message, details) {
         super(message);
         this.name = 'DesktopOpsError';
         this.code = code;
+        if (details !== undefined)
+            this.details = details;
     }
 }
 /** 结构化信号：build-blocked + pendingBuilds（desktopInstall/Upgrade 共享，调用方映射各自返回形态）。 */
@@ -135,10 +120,24 @@ async function desktopInstallLocked(id, cfg, opts, deps) {
     else {
         throw new DesktopOpsError('install-refused', `收录条目 ${entry.id} 缺少 npm/github 来源，无法在 desktop 安装`);
     }
+    // 0.9.19：供应链等待期预检——pnpm 11 锁文件校验会拦死整次安装，且失败前目标已写入
+    // node_modules（账实分裂）；目标太新或锁内「独立精确排除条目」未满期 → 委派前结构化拒绝。
+    if (entry.source === 'npm' && version !== undefined) {
+        const gate = await releaseAgePrecheck({
+            pkg,
+            version,
+            profileDir: opts.profileDir,
+            timeoutMs,
+            signal: opts.signal,
+            deps: { packumentTimes: deps.packumentTimes, workspacePolicy: deps.workspacePolicy },
+        });
+        if (gate.blocked)
+            throw new DesktopOpsError('release-age-wait', gate.message, { blockers: gate.blockers });
+    }
     let change;
     let bundleName;
     try {
-        ({ change, bundleName } = await runManagedInstall(service, pkg, spec, opts.approvedBuilds));
+        ({ change, bundleName } = await runManagedInstall(service, { pkg, spec, version, profileDir: opts.profileDir, approvedBuilds: opts.approvedBuilds, listInstalled: deps.listInstalled }));
     }
     catch (err) {
         if (err instanceof DesktopBuildApprovalNeeded) {
@@ -179,6 +178,9 @@ export async function desktopToggle(pkg, enabled, deps = {}) {
  * desktopInstall / desktopUpgrade 共用；build-blocked 以 DesktopBuildApprovalNeeded 抛出，
  * 由调用方映射各自的返回形态。判定纪律沿用文件头「报告 §5.2」（dsh-market #703/#772 实证）：
  * 以 application/stage 为准，绝不只看 packageResult.exitCode；overridden 非失败。
+ * 0.9.19：release-age 失败翻译换 release-age.ts（全量违规解析 + 目标/旁包分述），并复读
+ * 「账实分裂」（pnpm 11 锁文件校验失败前目标可能已写入 node_modules，官方管理器只回滚
+ * manifest/lockfile），把回退风险明示进错误信息。
  *
  * 本地增强（2026-10-02，未随计划发版）：enable 阶段失败自动重试一次 + 文案按 packageResult 精确化。
  * 背景：desktop 高频装卸/插件树重载窗口下，官方管理器 enable 阶段与应用侧操作竞速，返回
@@ -205,42 +207,63 @@ function enableStageFailureMessage(pkg, change) {
     }
     return `安装后启用阶段失败（${pkg}；application=failed、stage=enable${change.error?.code ? `、error=${change.error.code}` : ''}）：${writtenText}，请在官方 Desktop 插件页查看状态或重试`;
 }
-async function runManagedInstall(service, pkg, spec, approvedBuilds) {
-    const installOnce = async () => changeOf(await service.installBundle(spec, {
+async function runManagedInstall(service, ctx) {
+    const installOnce = async () => changeOf(await service.installBundle(ctx.spec, {
         enabled: true,
-        ...(approvedBuilds && approvedBuilds.length > 0 ? { approvedBuilds } : {}),
+        ...(ctx.approvedBuilds && ctx.approvedBuilds.length > 0 ? { approvedBuilds: ctx.approvedBuilds } : {}),
     }));
     /** 失败映射（既有语义不变：cancelled / build-blocked 审批 / release-age 等待 / enable / 通用）。 */
-    const mapFailure = (change) => {
+    const mapFailure = async (change) => {
         if (change.application === 'cancelled') {
-            throw new DesktopOpsError('install-refused', `安装已被取消（${pkg}）：desktop profile 文件已由官方管理器恢复，未安装`);
+            throw new DesktopOpsError('install-refused', `安装已被取消（${ctx.pkg}）：desktop profile 文件已由官方管理器恢复，未安装`);
         }
         const pending = Array.isArray(change.pendingBuilds) ? change.pendingBuilds.filter((n) => typeof n === 'string') : [];
         if (change.packageResult?.kind === 'build-blocked' && pending.length > 0) {
             throw new DesktopBuildApprovalNeeded(pending);
         }
-        // 0.9.10：供应链等待期（minimumReleaseAge）——策略正确工作，翻译成「何时可重试」
+        // 0.9.19：供应链等待期——解析全部违规条目（0.9.10 只取第一条，旁包被当成被拦目标）、
+        // 目标/旁包分述 + 账实分裂复读（pnpm 11 校验失败前已写入 node_modules 的实证形态）。
         const diagnosticText = `${change.error?.diagnostic ?? ''}\n${change.error?.code ?? ''}`;
         if (/ERR_PNPM_MINIMUM_RELEASE_AGE_VIOLATION|minimumReleaseAge/i.test(diagnosticText)) {
-            throw new DesktopOpsError('release-age-wait', releaseAgeWaitMessage(diagnosticText));
+            const view = describeReleaseAgeFailure({ pkg: ctx.pkg, version: ctx.version, diagnostic: diagnosticText });
+            let message = view.message;
+            let splitState;
+            if (ctx.profileDir && ctx.version) {
+                try {
+                    const items = (await ctx.listInstalled?.(ctx.profileDir) ?? { items: [] }).items;
+                    const row = items.find((it) => it.pkg === ctx.pkg);
+                    if (row && row.version === ctx.version && typeof row.spec === 'string' && row.spec !== '') {
+                        splitState = { installedVersion: row.version, manifestSpec: row.spec };
+                        message += `\n注意：${row.version} 已写入 node_modules 且在运行，但 manifest/lockfile 仍记录 ${row.spec}（官方管理器失败回滚所致，「账实分裂」）——官方管理器下次任何包操作都会把它回退到 ${row.spec}；等待期满后重新升级即可对齐。`;
+                    }
+                }
+                catch {
+                    // 复读失败不遮蔽原错误
+                }
+            }
+            throw new DesktopOpsError('release-age-wait', message, {
+                violations: view.violations,
+                targetViolating: view.targetViolating,
+                ...(splitState !== undefined ? { splitState } : {}),
+            });
         }
         if (change.stage === 'enable') {
-            throw new DesktopOpsError('enable-failed', enableStageFailureMessage(pkg, change));
+            throw new DesktopOpsError('enable-failed', enableStageFailureMessage(ctx.pkg, change));
         }
-        throw new DesktopOpsError('install-refused', `官方管理器安装失败（${pkg}；application=${change.application ?? 'failed'}${change.error?.code ? `、error=${change.error.code}` : ''}${change.error?.diagnostic ? `：${change.error.diagnostic}` : ''}）`);
+        throw new DesktopOpsError('install-refused', `官方管理器安装失败（${ctx.pkg}；application=${change.application ?? 'failed'}${change.error?.code ? `、error=${change.error.code}` : ''}${change.error?.diagnostic ? `：${change.error.diagnostic}` : ''}）`);
     };
     /** 复读校验：listBundles 可用必须见目标在装；不可用（老管理器）至少要求官方宣称产出 bundle。 */
     const verifyAndBundle = async (change) => {
-        const bundleName = change.bundle ?? pkg;
+        const bundleName = change.bundle ?? ctx.pkg;
         if (typeof service.listBundles === 'function') {
             const bundles = await service.listBundles();
             const found = (bundles ?? []).find((b) => b && b.name === bundleName);
             if (!found || found.installed === false) {
-                throw new DesktopOpsError('verify-failed', `安装复读失败（${pkg}）：官方结果为 ${change.application ?? 'unknown'} 但 listBundles 未見目标 bundle 在装——不冒充安装成功`);
+                throw new DesktopOpsError('verify-failed', `安装复读失败（${ctx.pkg}）：官方结果为 ${change.application ?? 'unknown'} 但 listBundles 未見目标 bundle 在装——不冒充安装成功`);
             }
         }
         else if (!change.bundle) {
-            throw new DesktopOpsError('verify-failed', `安装复读不可用（${pkg}）：官方结果未携带 bundle 字段且 listBundles 缺席——不冒充安装成功`);
+            throw new DesktopOpsError('verify-failed', `安装复读不可用（${ctx.pkg}）：官方结果未携带 bundle 字段且 listBundles 缺席——不冒充安装成功`);
         }
         return { change, bundleName };
     };
@@ -253,7 +276,7 @@ async function runManagedInstall(service, pkg, spec, approvedBuilds) {
         change = await installOnce();
     }
     if (change.application === 'failed' || change.application === 'cancelled' || change.error)
-        mapFailure(change);
+        await mapFailure(change);
     return verifyAndBundle(change);
 }
 /**
@@ -359,10 +382,23 @@ async function desktopUpgradeLocked(pkg, cfg, opts, deps) {
     else {
         throw new DesktopOpsError('install-refused', `收录条目 ${entry.id} 缺少 npm/github 来源，无法在 desktop 升级`);
     }
+    // 0.9.19：供应链等待期预检（同 desktopInstallLocked；0:15 quota-watch 事件即此形态实证）
+    if (entry.source === 'npm' && version !== undefined) {
+        const gate = await releaseAgePrecheck({
+            pkg,
+            version,
+            profileDir: opts.profileDir,
+            timeoutMs,
+            signal: opts.signal,
+            deps: { packumentTimes: deps.packumentTimes, workspacePolicy: deps.workspacePolicy },
+        });
+        if (gate.blocked)
+            throw new DesktopOpsError('release-age-wait', gate.message, { blockers: gate.blockers });
+    }
     let change;
     let bundleName;
     try {
-        ({ change, bundleName } = await runManagedInstall(service, pkg, spec, opts.approvedBuilds));
+        ({ change, bundleName } = await runManagedInstall(service, { pkg, spec, version, profileDir: opts.profileDir, approvedBuilds: opts.approvedBuilds, listInstalled: deps.listInstalled }));
     }
     catch (err) {
         if (err instanceof DesktopBuildApprovalNeeded) {

package/lib/core/release-age.js

@@ -0,0 +1,267 @@
+/**
+ * Desktop 供应链等待期（minimumReleaseAge）预检与失败翻译（0.9.19）。
+ *
+ * pnpm 11.7 实机实证（2026-10-03，本机 desktop profile，官方管理器操作日志
+ * operation-hNjgaN / operation-l5fXEd）：
+ * 1. 显式安装「太新」目标：非严格模式放行，pnpm 自动向 pnpm-workspace.yaml 的
+ *    `minimumReleaseAgeExclude` 追加一条「独立精确条目」（`pkg@ver` 形态）；
+ * 2. 但后续任何包操作的锁文件级供应链校验（`Verifying lockfile against
+ *    supply-chain policies (N entries)`）不认可 pnpm 自己追加的这种条目——
+ *    任何一条未满期的 `pkg@ver` 都会拦死整个安装，且与本次目标无关（旁包能拦住
+ *    所有升级，0.9.18 拦住 quota-watch 0.1.15 升级即实证）；
+ * 3. 校验失败前目标包可能已写入 node_modules，官方管理器只回滚 manifest/lockfile
+ *    →「账实分裂」：界面实装新版 active，账本仍旧版，下次包操作静默回退。
+ *
+ * 对策（零文件级红线不破：只读 profile 文件，绝不写）：
+ * ① 委派前预检（releaseAgePrecheck）：目标版本或锁内「不被校验认可的独立精确
+ *    排除条目」任一未满等待期 → 结构化拒绝，不委派官方管理器；
+ * ② 失败翻译（describeReleaseAgeFailure）：解析全部违规条目，按「本次目标 vs
+ *    锁内旁包」分别给出发布时刻与可重试时刻——不再把旁包名字冒充成本次目标被拦。
+ *
+ * fail-open 纪律：发布时刻不可得 / 策略文件不可读 / profileDir 缺席 / 命中有效排除
+ * 条目（包名级、`||` 复合、scoped 独立精确）→ 一律放行；pnpm 仍是最终执行者。
+ */
+import { readFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { isMap, isScalar, isSeq, parseDocument } from 'yaml';
+import { fetchJsonLimited } from './httpx.js';
+import { isExactVersion } from './versions.js';
+/** pnpm 11.7 实机测得的策略窗口：24h（operation-l5fXEd 的 cutoff = 检查时刻 − 1440min）。 */
+export const DEFAULT_MINIMUM_RELEASE_AGE_MIN = 1440;
+/** 锁内「独立精确排除条目」旁包探测上限（防清单失控；超出部分放弃预判，交 pnpm 兜底）。 */
+export const MAX_EXCLUDE_PROBES = 8;
+function scalarNumber(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return value;
+    if (typeof value === 'string' && value.trim() !== '' && Number.isFinite(Number(value)))
+        return Number(value);
+    return null;
+}
+/**
+ * 最小解析 pnpm-workspace.yaml 的两个策略键。
+ * 保守口径：坏 YAML / 根非映射 / 结构不符 → 空策略（minimumReleaseAgeMin=null、excludes=[]），
+ * 调用方按默认窗口 + 无排除处理，绝不抛。
+ */
+export function parseWorkspacePolicy(text) {
+    const empty = { minimumReleaseAgeMin: null, excludes: [] };
+    let document;
+    try {
+        document = parseDocument(text);
+    }
+    catch {
+        return empty;
+    }
+    if (document.errors.length > 0 || !isMap(document.contents))
+        return empty;
+    const excludes = [];
+    const rawExcludes = document.contents.get('minimumReleaseAgeExclude');
+    if (isSeq(rawExcludes)) {
+        for (const item of rawExcludes.items) {
+            if (isScalar(item) && typeof item.value === 'string' && item.value.trim() !== '') {
+                excludes.push(item.value.trim());
+            }
+        }
+    }
+    // yaml 库的 Map.get() 对标量返回已解包的原始值（number/string），对集合返回节点——两种形态都兜住
+    const rawAge = document.contents.get('minimumReleaseAge');
+    const age = isScalar(rawAge) ? scalarNumber(rawAge.value) : scalarNumber(rawAge);
+    return { minimumReleaseAgeMin: age !== null && age > 0 ? age : null, excludes };
+}
+export function excludeMatch(selector, pkg, version) {
+    const s = selector.trim();
+    if (s === '')
+        return 'no';
+    if (s.includes('||')) {
+        for (const part of s.split('||')) {
+            if (excludeMatch(part.trim(), pkg, version) !== 'no')
+                return 'effective';
+        }
+        return 'no';
+    }
+    const at = s.lastIndexOf('@');
+    if (at <= 0) {
+        // 包名级（dshmarket）或裸版本号段（只应出现在复合条目内，顶层出现视为包名比较）
+        return s === pkg || s === version ? 'effective' : 'no';
+    }
+    const namePart = s.slice(0, at);
+    const verPart = s.slice(at + 1);
+    if (namePart !== pkg)
+        return 'no';
+    if (verPart === version) {
+        return pkg.startsWith('@') ? 'effective' : 'unreliable-unscoped-exact';
+    }
+    return 'no';
+}
+/** 从独立精确条目提取 (pkg, version)；复合/包名级/版本段非精确 semver → null。 */
+export function splitExactSelector(selector) {
+    const s = selector.trim();
+    if (s === '' || s.includes('||'))
+        return null;
+    const at = s.lastIndexOf('@');
+    if (at <= 0)
+        return null;
+    const pkg = s.slice(0, at);
+    const version = s.slice(at + 1);
+    if (!isExactVersion(version))
+        return null;
+    if (!/^@?[A-Za-z0-9-._~]+(\/[A-Za-z0-9-._~]+)?$/.test(pkg))
+        return null;
+    return { pkg, version, reliable: pkg.startsWith('@') };
+}
+const VIOLATION_RE = /(\S+@\S+) was published at ([^,]+), within the minimumReleaseAge cutoff \(([^)]+)\)/g;
+/** 解析 pnpm 诊断里的全部等待期违规条目（0.9.10 只取第一条是「报错报错包」的根因之一）。 */
+export function parseViolations(diagnostic, nowMs = Date.now()) {
+    const out = [];
+    for (const m of diagnostic.matchAll(VIOLATION_RE)) {
+        const entry = m[1] ?? '';
+        const publishedAt = Date.parse(m[2] ?? '');
+        const cutoff = Date.parse(m[3] ?? '');
+        if (entry === '' || !Number.isFinite(publishedAt) || !Number.isFinite(cutoff))
+            continue;
+        const at = entry.lastIndexOf('@');
+        out.push({
+            entry,
+            pkg: at > 0 ? entry.slice(0, at) : entry,
+            version: at > 0 ? entry.slice(at + 1) : null,
+            publishedAt,
+            cutoff,
+            deadline: publishedAt + (nowMs - cutoff),
+        });
+    }
+    return out;
+}
+function fmtLocal(ms) {
+    return new Date(ms).toLocaleString('zh-CN', { hour12: false });
+}
+/**
+ * 0.9.19 失败翻译：替代 0.9.10 的 releaseAgeWaitMessage（只取第一条违规、把旁包
+ * 名字当成被拦对象、给「DSH Web 安装同版本」的失配指引）。多行文案进操作记录面板。
+ */
+export function describeReleaseAgeFailure(input) {
+    const now = input.nowMs ?? Date.now();
+    const violations = parseViolations(input.diagnostic, now);
+    if (violations.length === 0) {
+        return {
+            message: '官方管理器的供应链策略（minimumReleaseAge）未满足：新发布的版本需满等待期才能装入 desktop profile。稍后再点升级即可',
+            violations,
+            targetViolating: false,
+        };
+    }
+    const targetEntry = input.version ? `${input.pkg}@${input.version}` : input.pkg;
+    const targetViol = violations.find((v) => v.pkg === input.pkg);
+    const others = violations.filter((v) => v !== targetViol);
+    const lines = [`官方管理器的供应链策略（minimumReleaseAge）拦截了本次安装（${input.pkg}）：锁文件供应链校验未通过`];
+    if (targetViol) {
+        lines.push(`· 本次目标 ${targetViol.entry}：发布于 ${fmtLocal(targetViol.publishedAt)}，预计 ${fmtLocal(targetViol.deadline)} 后满等待期`);
+    }
+    else {
+        lines.push(`· 本次目标 ${targetEntry}：不在违规名单（被锁内其他未满期条目连坐）`);
+    }
+    for (const v of others) {
+        lines.push(`· 锁内未满期条目 ${v.entry}：发布于 ${fmtLocal(v.publishedAt)}，预计 ${fmtLocal(v.deadline)} 后满等待期（pnpm 安装它时自动追加的独立精确排除条目不被锁文件校验认可，等待期内任何官方包操作都会被拦）`);
+    }
+    const maxDeadline = Math.max(...violations.map((v) => v.deadline));
+    lines.push(`预计 ${fmtLocal(maxDeadline)} 后可重试；等待期内也可由操作员把 pnpm-workspace.yaml 中对应的独立精确排除条目改为包名级或复合条目以解除拦截`);
+    return { message: lines.join('\n'), violations, targetViolating: targetViol !== undefined };
+}
+/** registry packument 的 time 映射（与 npmPackument 同源；失败返回 null，不抛）。 */
+export async function npmPackumentTimes(pkg, timeoutMs = 20_000, signal) {
+    if (!/^@?[A-Za-z0-9-._~]+(\/[A-Za-z0-9-._~]+)?$/.test(pkg))
+        return null;
+    try {
+        const data = await fetchJsonLimited(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`, { timeoutMs, signal, maxBytes: 8 * 1024 * 1024 });
+        if (!data || typeof data !== 'object' || data.time === null || typeof data.time !== 'object')
+            return null;
+        const out = {};
+        for (const [k, v] of Object.entries(data.time)) {
+            if (typeof v === 'string')
+                out[k] = v;
+        }
+        return out;
+    }
+    catch {
+        return null;
+    }
+}
+/** 读 profile 的 pnpm-workspace.yaml 策略；缺席/不可读 → null（调用方 fail-open）。 */
+export async function readWorkspacePolicy(profileDir) {
+    if (!profileDir)
+        return null;
+    try {
+        return parseWorkspacePolicy(await readFile(join(profileDir, 'pnpm-workspace.yaml'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+const packumentCache = new Map();
+const PACKUMENT_CACHE_TTL_MS = 5 * 60_000;
+/** 测试钩子：清空 packument 进程内缓存。 */
+export function _resetReleaseAgeCachesForTests() {
+    packumentCache.clear();
+}
+/**
+ * 委派前预检：目标版本与锁内「不被校验认可的独立精确排除条目」逐个对发布时刻，
+ * 任一未满等待期 → 结构化拒绝（blocked + 多行理由）。零写操作；不确定一律放行。
+ */
+export async function releaseAgePrecheck(input) {
+    // profileDir 缺席 = 读不到操作员排除条目 → 不预判（避免误拦操作员显式 pin 的安装）
+    if (!input.profileDir)
+        return { blocked: false };
+    const now = input.nowMs ?? Date.now();
+    const policy = input.deps?.workspacePolicy
+        ? await input.deps.workspacePolicy(input.profileDir)
+        : await readWorkspacePolicy(input.profileDir);
+    const policyMin = policy?.minimumReleaseAgeMin ?? DEFAULT_MINIMUM_RELEASE_AGE_MIN;
+    const probe = async (pkg) => {
+        const hit = packumentCache.get(pkg);
+        if (hit && Date.now() - hit.at < PACKUMENT_CACHE_TTL_MS)
+            return hit.times;
+        const times = await (input.deps?.packumentTimes ?? npmPackumentTimes)(pkg, Math.min(input.timeoutMs ?? 20_000, 12_000), input.signal);
+        packumentCache.set(pkg, { at: Date.now(), times });
+        return times;
+    };
+    const blockers = [];
+    // ① 本次目标版本的发布时刻（有效排除条目覆盖 → 放行）
+    const times = await probe(input.pkg);
+    const publishedAt = times ? Date.parse(times[input.version] ?? '') : NaN;
+    if (Number.isFinite(publishedAt)) {
+        const exempt = (policy?.excludes ?? []).some((sel) => excludeMatch(sel, input.pkg, input.version) === 'effective');
+        if (!exempt) {
+            const deadline = publishedAt + policyMin * 60_000;
+            if (now < deadline) {
+                blockers.push({ entry: `${input.pkg}@${input.version}`, role: 'target', publishedAt, deadline });
+            }
+        }
+    }
+    // ② 锁内「不被校验认可的独立精确排除条目」（非 scoped）——任何一条未满期都会拦死整次安装
+    const seen = new Set([`${input.pkg}@${input.version}`]);
+    const candidates = (policy?.excludes ?? [])
+        .map((sel) => splitExactSelector(sel))
+        .filter((x) => x !== null && !x.reliable);
+    for (const ex of candidates.slice(0, MAX_EXCLUDE_PROBES)) {
+        const entry = `${ex.pkg}@${ex.version}`;
+        if (seen.has(entry))
+            continue;
+        seen.add(entry);
+        const t2 = await probe(ex.pkg);
+        const pub = t2 ? Date.parse(t2[ex.version] ?? '') : NaN;
+        if (!Number.isFinite(pub))
+            continue;
+        const deadline = pub + policyMin * 60_000;
+        if (now < deadline) {
+            blockers.push({ entry, role: 'lockfile-exclude', publishedAt: pub, deadline });
+        }
+    }
+    if (blockers.length === 0)
+        return { blocked: false };
+    const lines = ['官方管理器的供应链策略（minimumReleaseAge）将拦截本次安装，已提前拒绝（未触碰 profile 文件）：'];
+    for (const b of blockers) {
+        lines.push(b.role === 'target'
+            ? `· 目标 ${b.entry}：发布于 ${fmtLocal(b.publishedAt)}，预计 ${fmtLocal(b.deadline)} 后满等待期`
+            : `· 锁内排除条目 ${b.entry}：发布于 ${fmtLocal(b.publishedAt)}，预计 ${fmtLocal(b.deadline)} 后满等待期（pnpm 自动追加的独立精确条目不被锁文件校验认可，等待期内任何官方包操作都会被拦）`);
+    }
+    const maxDeadline = Math.max(...blockers.map((b) => b.deadline));
+    lines.push(`预计 ${fmtLocal(maxDeadline)} 后可重试；等待期内也可由操作员修正 pnpm-workspace.yaml 的排除条目形态（包名级/复合）解除拦截`);
+    return { blocked: true, message: lines.join('\n'), blockers };
+}

package/lib/tools.js

@@ -255,7 +255,7 @@ export function registerTools(ctx, cfg, deps = {}, profile = resolveActiveProfil
             if (profile.kind !== 'web') {
                 assertWriteAllowed(profile, 'install');
                 // 0.9.8：补传服务解析 deps（此前漏传 → desktop 安装恒 no-manager，实机 2026-10-01）
-                return cloneJson(await m.desktopInstall(id, cfg, { version, forceIncompatible: force, namespace: 'host', profile: profile.name }, { getService: getService, ensureService: ensureService }));
+                return cloneJson(await m.desktopInstall(id, cfg, { version, forceIncompatible: force, namespace: 'host', profile: profile.name, profileDir: profile.dir }, { getService: getService, ensureService: ensureService }));
             }
             try {
                 return cloneJson(await m.installFromRegistry(id, cfg, { version, forceIncompatible: force, namespace: 'host' }));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-m",
-  "version": "0.9.17",
+  "version": "0.9.19",
   "description": "可自定义收录清单的 DSH 插件市场：收录、安装、卸载、升级一站完成，附 agent 工具与 dshm CLI。",
   "license": "MIT",
   "type": "module",
@@ -20,6 +20,7 @@
     "registry.json",
     "README.md",
     "README.en.md",
+    "CHANGELOG.md",
     "docs/DESIGN.md",
     "LICENSE"
   ],