dsh-m 0.3.0 → 0.4.1

package/lib/core/patch-yaml.js

@@ -0,0 +1,143 @@
+/**
+ * cordis 补丁层 YAML 的三个纯函数（0.4.0 开关功能，DESIGN/plan Task 2）：
+ *
+ * 1) readBundlePatchRows —— 包内 `cordis.patch.yml`（dsh.bundle.patch 层）行枚举，
+ *    供「单行/多行插件」粒度判定（CONTEXT.md：行覆盖 vs Bundle 选择）；
+ * 2) planRowOverride —— 官方 `writePluginEnabled`（dsh-plugin-manager L881-916）的纯函数版：
+ *    在 profile `cordis.patch.yml` 文本上做保注释的 `disabled` 覆盖编辑（findLast 按 id 匹配、
+ *    跳过含 insert 的行、name 可选限定、已是目标态 changed:false、无匹配 append `{id, disabled}`；
+ *    启用写显式 `disabled: false` 以压过更低层）。文件 IO 留给调用方（toggle.ts 持锁后落盘）；
+ * 3) readProfileOverrides —— 读 profile 补丁层的覆盖行（id → disabled），enablement 读路径用。
+ *
+ * 解析约定与官方一致：customTags `tag:yaml.org,2002:js` 原样保留（官方补丁可含 `!!js`
+ * disabled 表达式）；planRowOverride 对坏 YAML / 根非序列 throw（调用方映射为失败），
+ * readBundlePatchRows 对不可解析形态返回 readable:false（调用方按多行 → Bundle 级处理），
+ * readProfileOverrides 宽松（读路径，坏文件 → []）。
+ */
+import { isMap, isSeq, parseDocument } from 'yaml';
+/** 官方同款 customTags：`!!js` 标量原样解析为字符串，不因未知标签炸解析。 */
+const YAML_OPTIONS = {
+    customTags: [
+        {
+            tag: 'tag:yaml.org,2002:js',
+            resolve(value) {
+                return value;
+            },
+        },
+    ],
+};
+function scalarString(value) {
+    return typeof value === 'string' && value.trim() !== '' ? value : null;
+}
+/**
+ * 包内补丁层行枚举。判定口径：
+ * - map 且含 `insert` 键 → 其值必须是序列，逐元素取 {id, name?}；元素非 map / 缺 id → 整体不可读；
+ * - map 无 `insert`（含 `- id: x` 的配置补丁行与覆盖行）→ configRows +1；
+ * - 非映射项（纯标量等畸形）→ 整体不可读。
+ */
+export function readBundlePatchRows(text) {
+    const result = { inserts: [], configRows: 0, readable: true };
+    let seq;
+    try {
+        seq = parsePatchSeq(text).seq;
+    }
+    catch {
+        return { ...result, readable: false };
+    }
+    for (const item of seq.items) {
+        if (!isMap(item))
+            return { inserts: [], configRows: 0, readable: false };
+        if (item.has('insert')) {
+            const inserted = item.get('insert');
+            if (!isSeq(inserted))
+                return { inserts: [], configRows: 0, readable: false };
+            for (const element of inserted.items) {
+                if (!isMap(element))
+                    return { inserts: [], configRows: 0, readable: false };
+                const id = scalarString(element.get('id'));
+                if (id === null)
+                    return { inserts: [], configRows: 0, readable: false };
+                const name = scalarString(element.get('name'));
+                result.inserts.push(name === null ? { id } : { id, name });
+            }
+            continue;
+        }
+        result.configRows += 1;
+    }
+    return result;
+}
+/** 单行插件：可读、恰好一个 insert 条目、零配置补丁行——行开关即整插件开关。 */
+export function isSingleRowPlugin(rows) {
+    return rows.readable && rows.inserts.length === 1 && rows.configRows === 0;
+}
+function parsePatchSeq(text) {
+    const document = parseDocument(text, YAML_OPTIONS);
+    const error = document.errors[0];
+    if (error !== undefined)
+        throw error;
+    // Document.contents 是 accessor，CFA 无法收窄——先落到局部变量再判形
+    const seq = document.contents;
+    if (!isSeq(seq))
+        throw new Error('cordis.patch.yml 必须是 YAML 序列');
+    return { document, seq };
+}
+/**
+ * 保注释的行覆盖编辑（官方 writePluginEnabled 纯函数版）。
+ * @param text 当前 profile `cordis.patch.yml` 文本（文件缺失由调用方传 `"[]\n"`）
+ * @param id 目标合成条目 id（来自 insert 行声明或 loader entry）
+ * @param name 模块名（可选限定：行有 name 且不等 → 不匹配；append 时不写 name，与官方一致）
+ * @param enabled 目标启停态（true → 写 `disabled: false` 显式正覆盖）
+ */
+export function planRowOverride(text, id, name, enabled) {
+    const { document, seq } = parsePatchSeq(text);
+    const items = seq.items;
+    const targetIndex = findLastIndex(items, (item, index) => {
+        if (!isMap(item) || item.has('insert'))
+            return false;
+        if (document.getIn([index, 'id']) !== id)
+            return false;
+        const expectedName = document.getIn([index, 'name']);
+        return !expectedName || expectedName === name;
+    });
+    if (targetIndex >= 0) {
+        if (document.getIn([targetIndex, 'disabled']) === !enabled) {
+            return { text, changed: false };
+        }
+        document.setIn([targetIndex, 'disabled'], !enabled);
+    }
+    else {
+        document.add({ id, disabled: !enabled });
+    }
+    return { text: String(document), changed: true };
+}
+/** Array.prototype.findLast 的索引版（官方用 items.findLast 取项，这里需要下标做 setIn）。 */
+function findLastIndex(items, predicate) {
+    for (let index = items.length - 1; index >= 0; index--) {
+        if (predicate(items[index], index))
+            return index;
+    }
+    return -1;
+}
+/**
+ * 读 profile 补丁层覆盖行（读路径，宽松）：坏 YAML / 根非序列 / 非 map 项 → 跳过或整体 []。
+ * 只返回带字符串 id 的非 insert 行；`disabled` 键缺省视为 false。
+ */
+export function readProfileOverrides(text) {
+    let seq;
+    try {
+        seq = parsePatchSeq(text).seq;
+    }
+    catch {
+        return [];
+    }
+    const rows = [];
+    for (const item of seq.items) {
+        if (!isMap(item) || item.has('insert'))
+            continue;
+        const id = scalarString(item.get('id'));
+        if (id === null)
+            continue;
+        rows.push({ id, disabled: item.get('disabled') === true });
+    }
+    return rows;
+}

package/lib/core/profile-transaction.js

@@ -499,6 +499,30 @@ async function addWithLagRetry(req, spec, d, heal) {
  * npm 门最终验证（R3：可重复执行）——manifest 依赖存在与锚定、lockfile 存在、
  * 与 npm dist 一致的 resolution.integrity。firstPass 控制是否记录 range 放行 heal。
  */
+/**
+ * bundle 身份观察（Task 10，只警告不回滚）：包内无 cordis.patch.yml 且 profile
+ * bundles 数组不含该包 → 装成「纯依赖」（不进加载树、已装页进 others 折叠）。
+ * 存在合法的无补丁层 dsh 包（伴生库/纯资源包），故不判失败。
+ */
+async function bundleIdentityWarning(profileDir, pkg) {
+    try {
+        await readFile(join(profileDir, 'node_modules', pkg, 'cordis.patch.yml'));
+        return undefined;
+    }
+    catch {
+        /* 无补丁层 → 再看 bundles */
+    }
+    try {
+        const raw = JSON.parse(await readFile(join(profileDir, 'package.json'), 'utf8'));
+        const bundles = raw?.dsh?.profile?.bundles;
+        if (Array.isArray(bundles) && bundles.includes(pkg))
+            return undefined;
+    }
+    catch {
+        /* manifest 读不到 → 如实报 warning（不升级为失败） */
+    }
+    return 'no-patch-layer';
+}
 async function verifyNpmCommitState(req, d, heal, firstPass) {
     const depsNow = await strictReadDeps(d);
     if (depsNow[req.pkg] === undefined) {
@@ -577,7 +601,9 @@ async function installNpm(req, d, snapshots) {
             pkg: req.pkg,
             spec,
             version: req.version,
-            usedAllowAllBuilds: addOut.usedAllowAllBuilds === true,
+            buildApprovals: addOut.buildApprovals ?? [],
+            fallbackAllBuilds: addOut.fallbackAllBuilds === true,
+            ...(await bundleIdentityWarning(d.profileDir, req.pkg)) ? { bundleWarning: 'no-patch-layer' } : {},
         });
     }
     catch (err) {
@@ -646,7 +672,9 @@ async function installGithub(req, d, snapshots) {
             spec,
             sha: req.sha,
             tag: req.tag,
-            usedAllowAllBuilds: addOut.usedAllowAllBuilds === true,
+            buildApprovals: addOut.buildApprovals ?? [],
+            fallbackAllBuilds: addOut.fallbackAllBuilds === true,
+            ...(await bundleIdentityWarning(d.profileDir, key)) ? { bundleWarning: 'no-patch-layer' } : {},
         });
     }
     catch (err) {

package/lib/core/registry.js

@@ -116,7 +116,12 @@ export function parseRegistryAddress(raw) {
 }
 // ---------- 严格 v1 校验 ----------
 const TOP_LEVEL_KEYS = new Set(['version', 'plugins']);
-const ENTRY_KEYS = new Set(['id', 'name', 'description', 'category', 'tags', 'source', 'npm', 'github', 'homepage', 'icon']);
+const ENTRY_KEYS = new Set(['id', 'name', 'description', 'category', 'tags', 'source', 'npm', 'github', 'homepage', 'icon', 'verified']);
+/** 精确 semver 判定（与 versions.ts EXACT_VERSION_RE 同语义；接受 prerelease/build，拒绝 range/前缀）。 */
+const EXACT_SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
+function semverParse(value) {
+    return EXACT_SEMVER_RE.test(value) ? value : null;
+}
 function httpsUrlError(raw) {
     if (raw.length > MAX_URL)
         return `超过 ${MAX_URL} 字符`;
@@ -269,6 +274,31 @@ export function validateRegistry(raw) {
                 entryIcon = s;
         }
         // 错误条目不产生合法输出：整份清单在存在任何错误时返回 null
+        // verified（0.4.0）：可选字符串数组，每项精确 semver（禁 range/前缀）
+        let verified;
+        if (e.verified !== undefined) {
+            if (!Array.isArray(e.verified)) {
+                errors.push(`${where}.verified: 必须是字符串数组`);
+            }
+            else {
+                const list = [];
+                e.verified.forEach((v, vi) => {
+                    if (typeof v !== 'string' || v.trim() === '' || v !== v.trim()) {
+                        errors.push(`${where}.verified[${vi}]: 必须是非空白精确 semver`);
+                        return;
+                    }
+                    const parsed = semverParse(v);
+                    if (parsed === null)
+                        errors.push(`${where}.verified[${vi}}: ${JSON.stringify(v)} 不是合法 semver（禁 range/前缀）`);
+                    else if (e.verified.includes(v, vi + 1))
+                        errors.push(`${where}.verified[${vi}]: 重复 ${v}`);
+                    else
+                        list.push(v);
+                });
+                if (list.length > 0)
+                    verified = list;
+            }
+        }
         plugins.push({
             id,
             name,
@@ -280,6 +310,7 @@ export function validateRegistry(raw) {
             ...(entryGithub !== undefined ? { github: entryGithub } : {}),
             ...(entryHomepage !== undefined ? { homepage: entryHomepage } : {}),
             ...(entryIcon !== undefined ? { icon: entryIcon } : {}),
+            ...(verified !== undefined ? { verified } : {}),
         });
     });
     return { ok: errors.length === 0, errors, registry: errors.length === 0 ? { version: 1, plugins } : null };

package/lib/core/toggle.js

@@ -0,0 +1,220 @@
+/**
+ * 开关写路径编排（0.4.0，plan Task 5；ADR-0001 委派降级）。
+ *
+ * 判定顺序（Rev2.1 定稿）：
+ * ① 保护门最先（纯名单检查，无需枚举已装清单——空 profile 下 CLI 冒烟也得 protected）；
+ * ② 不在已装清单 → not-installed；
+ * ③ 粒度路由：单 insert 行插件 → 行覆盖；多行/不可解析 → Bundle 选择；
+ * ④ 委派优先：`getService()` 探测官方 pluginManager（运行时探测，不判版本号），
+ *    官方 readOnlyReason 映射：'management-required'→protected、'unaddressable'→unaddressable；
+ *    applied 以复读为准（官方富结果 application 字段鸭子读兜底）；
+ * ⑤ 降级：行级 = 锁内保注释 YAML 编辑 + `setLivePluginDisabled(pkg, !enabled)` 活体
+ *    （注意 live-plugin.ts 第二参是 disabled，方向取反）；bundle 级 = 锁内 bundles 数组
+ *    编辑，恒 restart-required。
+ *
+ * 锁：与官方同款 `withFileLock(<profile>/package.json)`（dsh-atomic-write，锁文件
+ * `package.json.lock`、wx 独占）——防与官方 UI 并发编辑 cordis.patch.yml 丢更新。
+ * 开关不经 Profile 变更事务（grilling Q1）：单文件轻量编辑、幂等可逆。
+ */
+import { readFile as fsReadFile } from 'node:fs/promises';
+import { join } from 'node:path';
+import { withFileLock, writeFileAtomic } from '@deepseek-ai/dsh-atomic-write';
+import { listInstalledPlugins } from './installed.js';
+import { isSingleRowPlugin, planRowOverride } from './patch-yaml.js';
+import { PROTECTED_MODULES } from './enablement.js';
+import { setLivePluginDisabled, loaderHost } from './live-plugin.js';
+import { webProfileDir } from './env.js';
+export class ToggleError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+    }
+}
+/** 官方 change() 富结果的鸭子读（不建类型依赖）。 */
+function applicationOf(result) {
+    if (result && typeof result === 'object') {
+        const record = result;
+        return {
+            application: typeof record.application === 'string' ? record.application : undefined,
+            warnings: Array.isArray(record.warnings) ? record.warnings.map((w) => String(w)) : [],
+        };
+    }
+    return { warnings: [] };
+}
+async function readPatchText(io, path) {
+    try {
+        return await io.readFile(path, 'utf8');
+    }
+    catch (error) {
+        if (error.code === 'ENOENT')
+            return '[]\n';
+        throw error;
+    }
+}
+export async function togglePlugin(pkg, enabled, deps = {}) {
+    const key = String(pkg || '').trim();
+    // ① 保护门最先：纯名单检查（空 profile 也先于 not-installed 命中）
+    if (key === 'dsh-m' || PROTECTED_MODULES.includes(key)) {
+        throw new ToggleError('protected', `受保护插件不可开关: ${key}（dsh-m 自身或官方宿主命脉）`);
+    }
+    const io = deps.io ?? { readFile: fsReadFile };
+    const profileDir = deps.profileDir ?? webProfileDir();
+    // ② 在装判定
+    const installed = await listInstalledPlugins(profileDir);
+    const item = installed.items.find((it) => it.pkg === key);
+    if (item === undefined)
+        throw new ToggleError('not-installed', `web profile 未安装该插件: ${key}`);
+    const granularity = item.patchRows && isSingleRowPlugin(item.patchRows) ? 'row' : 'bundle';
+    const service = deps.getService?.();
+    if (service !== undefined) {
+        // 委派一律走 Bundle 选择（官方插件页主开关同层，两层 UI 状态一致；
+        // 行覆盖残留由启用路径的清理扫描兜底）。行覆盖仅是降级路径的实现细节。
+        return toggleViaService(service, item, enabled);
+    }
+    // 降级：Bundle 退选态的「启用」必须走 bundles 编辑（行覆盖救不回未合成的树）
+    let inBundles = false;
+    try {
+        const manifest = JSON.parse(await io.readFile(join(profileDir, 'package.json'), 'utf8'));
+        const bundles = manifest?.dsh?.profile?.bundles;
+        inBundles = Array.isArray(bundles) && bundles.includes(item.pkg);
+    }
+    catch {
+        /* 读不到按不在 bundles 处理 */
+    }
+    const route = enabled && !inBundles ? 'bundle' : granularity;
+    return toggleFallback(item, enabled, route, { profileDir, io, loaderHost: deps.loaderHost ?? loaderHost() });
+}
+// ---------- 委派路径 ----------
+async function toggleViaService(service, item, enabled) {
+    const warnings = [];
+    // 启用前清理本插件的历史行覆盖（dsh-m 单开关模型：行覆盖是它自己写下的，
+    // 不清则 bundle 重选后旧行仍 disabled，官方页第二层会出现一开一关）
+    if (enabled) {
+        const cleared = await clearRowOverrides(service, item.pkg, warnings);
+        if (cleared > 0)
+            warnings.push(`已清理 ${cleared} 条历史行覆盖`);
+    }
+    const raw = await service.setBundleEnabled(item.pkg, enabled);
+    const rich = applicationOf(raw);
+    warnings.push(...rich.warnings);
+    if (enabled) {
+        // selectBundle 后才可见的行覆盖（bundle 退选期 loader 无条目）再扫一遍
+        await clearRowOverrides(service, item.pkg, warnings);
+    }
+    // applied 复读：bundle on → 该模块行应存在且启用；bundle off → 行消失或全禁用
+    const after = (await service.listPlugins()).filter((r) => r.moduleName === item.pkg);
+    const running = after.some((r) => r.enabled);
+    let applied;
+    if (rich.application === 'restart-required')
+        applied = 'restart-required';
+    else
+        applied = running === enabled ? 'live' : 'restart-required';
+    if (rich.application === 'overridden')
+        warnings.push('被更高补丁层覆盖，落盘状态与请求不符——重启后以下层为准');
+    return { pkg: item.pkg, enabled, applied, via: 'delegate', warnings };
+}
+/** 清理本插件可见的 disabled 行覆盖（跳过官方 readOnly 行）；返回清理条数。 */
+async function clearRowOverrides(service, pkg, warnings) {
+    const rows = (await service.listPlugins()).filter((r) => r.moduleName === pkg && !r.readOnlyReason && r.enabled === false);
+    let cleared = 0;
+    for (const row of rows) {
+        const rich = applicationOf(await service.setPluginEnabled(row.entryId, true));
+        warnings.push(...rich.warnings);
+        cleared += 1;
+    }
+    return cleared;
+}
+async function toggleFallback(item, enabled, granularity, ctx) {
+    if (granularity === 'row') {
+        return toggleRowFallback(item, enabled, ctx);
+    }
+    return toggleBundleFallback(item, enabled, ctx);
+}
+/** 行覆盖降级：锁内保注释 YAML 编辑 + loader 活体翻转。 */
+async function toggleRowFallback(item, enabled, ctx) {
+    const loaderEntry = findLoaderEntryByName(ctx.loaderHost, item.pkg);
+    const insert = item.patchRows?.readable ? item.patchRows.inserts[0] : undefined;
+    const id = loaderEntry?.id ?? insert?.id;
+    const name = loaderEntry?.options?.name ?? insert?.name;
+    if (id === undefined || id === '') {
+        throw new ToggleError('unknown-plugin', `无法定位该插件的合成条目 id（loader 与补丁行均无）: ${item.pkg}`);
+    }
+    const patchPath = join(ctx.profileDir, 'cordis.patch.yml');
+    let liveFound = false;
+    await withFileLock(join(ctx.profileDir, 'package.json'), async () => {
+        const text = await readPatchText(ctx.io, patchPath);
+        const plan = planRowOverride(text, id, name, enabled);
+        if (plan.changed) {
+            await writeFileAtomic(patchPath, plan.text, { mode: 0o600 });
+        }
+    });
+    liveFound = await setLivePluginDisabled(item.pkg, !enabled, ctx.loaderHost);
+    return {
+        pkg: item.pkg,
+        enabled,
+        applied: liveFound ? 'live' : 'restart-required',
+        via: 'fallback',
+        warnings: [],
+    };
+}
+function findLoaderEntryByName(host, pkg) {
+    const entries = host?.loader?.entries;
+    if (typeof entries !== 'function')
+        return null;
+    for (const entry of entries.call(host.loader)) {
+        if (entry && entry.options?.name === pkg)
+            return entry;
+    }
+    return null;
+}
+/** Bundle 选择降级：锁内 bundles 数组编辑（恒 restart-required）。 */
+async function toggleBundleFallback(item, enabled, ctx) {
+    const manifestPath = join(ctx.profileDir, 'package.json');
+    await withFileLock(join(ctx.profileDir, 'package.json'), async () => {
+        if (enabled) {
+            // 启用即清本包历史行覆盖（与委派路径同语义）
+            const patchPath = join(ctx.profileDir, 'cordis.patch.yml');
+            let patchText = '[]\n';
+            try {
+                patchText = await ctx.io.readFile(patchPath, 'utf8');
+            }
+            catch (error) {
+                if (error.code !== 'ENOENT')
+                    throw error;
+            }
+            let patchMutated = false;
+            for (const insert of item.patchRows?.inserts ?? []) {
+                const plan = planRowOverride(patchText, insert.id, insert.name, true);
+                if (plan.changed) {
+                    patchText = plan.text;
+                    patchMutated = true;
+                }
+            }
+            if (patchMutated)
+                await writeFileAtomic(patchPath, patchText, { mode: 0o600 });
+        }
+        let raw;
+        try {
+            raw = await ctx.io.readFile(manifestPath, 'utf8');
+        }
+        catch (error) {
+            if (error.code === 'ENOENT')
+                raw = '{}';
+            else
+                throw error;
+        }
+        const doc = JSON.parse(raw);
+        if (typeof doc.dsh !== 'object' || doc.dsh === null)
+            doc.dsh = {};
+        if (typeof doc.dsh.profile !== 'object' || doc.dsh.profile === null)
+            doc.dsh.profile = {};
+        const previous = Array.isArray(doc.dsh.profile.bundles) ? doc.dsh.profile.bundles : [];
+        const bundles = enabled
+            ? previous.includes(item.pkg) ? previous : [...previous, item.pkg]
+            : previous.filter((name) => name !== item.pkg);
+        doc.dsh.profile.bundles = bundles;
+        await writeFileAtomic(manifestPath, `${JSON.stringify(doc, null, 2)}\n`, { mode: 0o600 });
+    });
+    return { pkg: item.pkg, enabled, applied: 'restart-required', via: 'fallback', warnings: [] };
+}

package/lib/core/versions.js

@@ -18,43 +18,56 @@ function githubRateLimitMessage(err) {
     }
     return null;
 }
+/** registry base 归一（去尾斜杠；空/缺省 → 官方 npmjs）。 */
+function registryBase(registry) {
+    const base = typeof registry === 'string' && registry.trim() !== '' ? registry.trim() : 'https://registry.npmjs.org';
+    return base.replace(/\/+$/, '');
+}
 /** 精确 semver：接受 prerelease/build metadata，拒绝 v 前缀、range、tag 与脏尾缀。 */
 const EXACT_VERSION_RE = /^\d+\.\d+\.\d+(?:-[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?(?:\+[0-9A-Za-z-]+(?:\.[0-9A-Za-z-]+)*)?$/;
 export function isExactVersion(version) {
     return EXACT_VERSION_RE.test(version);
 }
 /** 读取该精确版本的 dist metadata（不使用 /latest endpoint）；integrity 缺失由调用方拒绝安装。 */
-export async function npmVersion(pkg, version, timeoutMs = 20_000, signal) {
+export async function npmVersion(pkg, version, timeoutMs = 20_000, signal, registry) {
     if (!/^@?[A-Za-z0-9-._~]+(\/[A-Za-z0-9-._~]+)?$/.test(pkg))
         throw new Error(`无效 npm 包名: ${pkg}`);
     if (!isExactVersion(version))
         throw new Error(`不是精确版本（拒绝 range/tag/前缀）: ${version}`);
-    const data = await fetchJsonLimited(`https://registry.npmjs.org/${encodeURIComponent(pkg)}/${version}`, { timeoutMs, signal });
+    const data = await fetchJsonLimited(`${registryBase(registry)}/${encodeURIComponent(pkg)}/${version}`, { timeoutMs, signal });
     const resolved = typeof data.version === 'string' ? data.version : '';
     if (!resolved)
         throw new Error(`npm 未返回版本: ${pkg}@${version}`);
+    const peers = {};
+    if (data.peerDependencies !== null && typeof data.peerDependencies === 'object') {
+        for (const [name, range] of Object.entries(data.peerDependencies)) {
+            if (typeof range === 'string')
+                peers[name] = range;
+        }
+    }
     return {
         version: resolved,
         integrity: typeof data.dist?.integrity === 'string' ? data.dist.integrity : undefined,
         tarball: typeof data.dist?.tarball === 'string' ? data.dist.tarball : undefined,
+        peers,
     };
 }
 /**
  * 拉取完整 packument（NO_MATCHING_VERSION 退避重试前的预热/校验原语）。
  * 返回该包已知的全部版本号；解析不出 versions 时返回空列表（不抛）。
  */
-export async function npmPackument(pkg, timeoutMs = 20_000, signal) {
+export async function npmPackument(pkg, timeoutMs = 20_000, signal, registry) {
     if (!/^@?[A-Za-z0-9-._~]+(\/[A-Za-z0-9-._~]+)?$/.test(pkg))
         throw new Error(`无效 npm 包名: ${pkg}`);
     const data = await fetchJsonLimited(`https://registry.npmjs.org/${encodeURIComponent(pkg)}`, { timeoutMs, signal, maxBytes: 8 * 1024 * 1024 });
     const versions = data?.versions !== null && typeof data?.versions === 'object' ? Object.keys(data.versions) : [];
     return { versions };
 }
-export async function npmLatest(pkg, timeoutMs = 20_000, signal) {
+export async function npmLatest(pkg, timeoutMs = 20_000, signal, registry) {
     // 允许 scoped 包名：@scope/name（isSafePkgName 同款字符集）
     if (!/^@?[A-Za-z0-9-._~]+(\/[A-Za-z0-9-._~]+)?$/.test(pkg))
         throw new Error(`无效 npm 包名: ${pkg}`);
-    const data = await fetchJsonLimited(`https://registry.npmjs.org/${encodeURIComponent(pkg)}/latest`, { timeoutMs, signal });
+    const data = await fetchJsonLimited(`${registryBase(registry)}/${encodeURIComponent(pkg)}/latest`, { timeoutMs, signal });
     const version = typeof data.version === 'string' ? data.version : '';
     if (!version)
         throw new Error(`npm 未返回版本: ${pkg}`);

package/lib/host.js

@@ -36,6 +36,8 @@ export function apply(ctx, config) {
     // using it avoids guessing the service unit from release-specific cgroups.
     const appExit = appExitFromContext(ctx);
     const restart = (port = null) => scheduleRestart(port, { appExit });
+    // 开关委派的官方服务探测（ADR-0001）：运行时按服务存在性探测，不判 DSH 版本号
+    const getService = () => ctx.get?.('pluginManager');
     registerTools(ctx, controller.config, { restart });
     // 设置页接线（双代兼容，详见 core/settings-compat.ts）：
     // - ≤0.1.5：settings.register('dshm', …) scope（get/update/watch）；
@@ -66,7 +68,14 @@ export function apply(ctx, config) {
     // 本地 API：单路由 + method 分发（防护与状态映射在 core/host-api.ts）
     ctx.inject(['webServer'], (c) => {
         const server = c.webServer;
-        const handleApi = createApiDispatcher({ controller, pkg, deps: { scheduleRestart: restart } });
+        const handleApi = createApiDispatcher({
+            controller,
+            pkg,
+            deps: {
+                scheduleRestart: restart,
+                getService,
+            },
+        });
         server.register({
             kind: 'exact',
             path: '/dshm',