dsh-m 0.2.14 → 0.4.0

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-probe.js

@@ -0,0 +1,82 @@
+/**
+ * 元数据源竞速（0.4.0，plan Task 7；对齐官方 ui-plugin-manager 的 registry probe
+ * 语义：npmjs vs npmmirror `/-/ping` 并发，首个 2xx 胜出即定、败者 abort，
+ * 双败 → null 保持默认 npmjs；结果缓存 TTL，默认 1500ms 预算 / 5 分钟缓存）。
+ *
+ * 只读不写：探测结果仅用于 dsh-m 自身的元数据/packument 读取源选择与市场页展示，
+ * 安装链路（pnpm 读 profile .npmrc）完全不动（grilling Q9 定稿）。
+ */
+import { fetchLimited } from './httpx.js';
+export const PROBE_URLS = {
+    npmjs: 'https://registry.npmjs.org/-/ping',
+    npmmirror: 'https://registry.npmmirror.com/-/ping',
+};
+/** 探测源 → registry base（versions.ts 元数据读取的 registry 参数值）。 */
+export const PROBE_REGISTRY_BASES = {
+    npmjs: 'https://registry.npmjs.org',
+    npmmirror: 'https://registry.npmmirror.com',
+};
+export class RegistryProbe {
+    options;
+    cached = null;
+    inflight = null;
+    constructor(options) {
+        this.options = options;
+    }
+    /** 最近一次快照（不发请求）；无记录 → null。 */
+    cachedSnapshot() {
+        return this.cached;
+    }
+    /** 缓存期内直接回放；否则并发竞速一次（并发调用共享同一次探测）。 */
+    async fastest() {
+        const now = this.options.now?.() ?? Date.now();
+        if (this.cached !== null && now - this.cached.checkedAt < this.options.cacheTtlMs) {
+            return this.cached.source;
+        }
+        if (this.inflight !== null)
+            return this.inflight;
+        this.inflight = this.race().finally(() => {
+            this.inflight = null;
+        });
+        return this.inflight;
+    }
+    async race() {
+        const fetchImpl = this.options.fetchImpl ?? fetchLimited;
+        const sources = Object.keys(PROBE_URLS);
+        const racers = sources.map((source) => {
+            const controller = new AbortController();
+            const promise = Promise.resolve()
+                .then(() => fetchImpl(PROBE_URLS[source], { timeoutMs: this.options.timeoutMs, signal: controller.signal }))
+                .then((res) => res.ok === true);
+            return { source, controller, promise };
+        });
+        const winner = await new Promise((resolve) => {
+            let settled = false;
+            let pending = racers.length;
+            const done = (source) => {
+                if (settled)
+                    return;
+                settled = true;
+                for (const racer of racers) {
+                    if (racer.source !== source)
+                        racer.controller.abort();
+                }
+                resolve(source);
+            };
+            const oneFinished = (ok, source) => {
+                if (ok) {
+                    done(source);
+                    return;
+                }
+                pending -= 1;
+                if (pending <= 0)
+                    done(null);
+            };
+            for (const racer of racers) {
+                racer.promise.then((ok) => oneFinished(ok, racer.source)).catch(() => oneFinished(false, racer.source));
+            }
+        });
+        this.cached = { source: winner, checkedAt: this.options.now?.() ?? Date.now() };
+        return winner;
+    }
+}

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/settings-compat.js

@@ -0,0 +1,180 @@
+const VOLATILE_WRITE = Symbol.for('cosmokit.volatile.write');
+/** cosmokit Volatile 引用判定（鸭子类型，跨副本安全）。 */
+export function isVolatileRef(value) {
+    return typeof value === 'object' && value !== null && VOLATILE_WRITE in value;
+}
+/** 解析引用为快照；普通值原样返回。深度有界（防循环与异常结构），超界截断为 undefined。 */
+export function unwrapValue(value, depth = 4) {
+    const walk = (v, d) => {
+        if (isVolatileRef(v)) {
+            if (d <= 0)
+                return undefined;
+            return walk(v.get(), d - 1);
+        }
+        if (Array.isArray(v)) {
+            if (d <= 0)
+                return undefined;
+            return v.map((item) => walk(item, d - 1));
+        }
+        if (typeof v === 'object' && v !== null) {
+            if (d <= 0)
+                return undefined;
+            const out = {};
+            for (const [key, item] of Object.entries(v))
+                out[key] = walk(item, d - 1);
+            return out;
+        }
+        return v;
+    };
+    return walk(value, depth);
+}
+/** 从任意形态（plain / 带 Volatile 引用 / 未知脏值）提取已知 registry 字段，类型不符丢弃。 */
+export function unwrapConfig(source) {
+    const raw = unwrapValue(source);
+    const out = {};
+    if (raw && typeof raw === 'object') {
+        if (typeof raw.registryUrl === 'string')
+            out.registryUrl = raw.registryUrl;
+        if (typeof raw.timeoutMs === 'number')
+            out.timeoutMs = raw.timeoutMs;
+        if (typeof raw.cacheTtlMin === 'number')
+            out.cacheTtlMin = raw.cacheTtlMin;
+    }
+    return out;
+}
+/** 从任意形态提取 probe 三字段（Task 7/14；类型不符丢弃，缺省交调用方）。 */
+export function unwrapProbeConfig(source) {
+    const raw = unwrapValue(source);
+    const out = {};
+    if (raw && typeof raw === 'object') {
+        if (typeof raw.probeEnabled === 'boolean')
+            out.probeEnabled = raw.probeEnabled;
+        if (typeof raw.probeTimeoutMs === 'number')
+            out.probeTimeoutMs = raw.probeTimeoutMs;
+        if (typeof raw.probeCacheTtlMin === 'number')
+            out.probeCacheTtlMin = raw.probeCacheTtlMin;
+    }
+    return out;
+}
+/** 运行时形态探测：register 在前（老服务不会带 describe/update），forms 次之。 */
+export function detectSettingsKind(settings) {
+    const s = settings;
+    if (s && typeof s === 'object') {
+        if (typeof s.register === 'function')
+            return 'legacy';
+        if (typeof s.describe === 'function' && typeof s.update === 'function')
+            return 'forms';
+    }
+    return 'unknown';
+}
+/** 在 loader entries 里找本插件实例的 profile entry id（新 API 写入的 ns）。范式同 dsh-better-sidebar。 */
+export function ownEntryId(ctx, packageName) {
+    const loader = ctx?.loader;
+    if (!loader || typeof loader.entries !== 'function')
+        return undefined;
+    const ownFiber = ctx?.fiber;
+    let fallback;
+    try {
+        for (const entry of loader.entries()) {
+            const id = entry?.options?.id;
+            if (entry?.options?.name !== packageName || typeof id !== 'string' || id === '')
+                continue;
+            if (ownFiber !== undefined && entry.fiber === ownFiber)
+                return id;
+            if (entry.options.disabled !== true && fallback === undefined)
+                fallback = id;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return fallback;
+}
+/** 旧 API store：scope 值出站前统一解包（防御老 runtime 解析出引用的混合形态）。 */
+export function createLegacyRegistryStore(scope) {
+    return {
+        get: () => unwrapConfig(scope.get()),
+        update: async (patch) => {
+            await scope.update({ ...patch });
+        },
+        watch: (callback) => scope.watch((next, prev) => {
+            callback(unwrapConfig(next), unwrapConfig(prev));
+        }),
+    };
+}
+function subscribeVolatileUpdate(ctx, callback) {
+    const on = ctx?.on;
+    if (typeof on !== 'function')
+        return () => { };
+    const disposed = on.call(ctx, 'loader/volatile-update', () => callback());
+    return typeof disposed === 'function' ? disposed : () => { };
+}
+/**
+ * 新 API store（0.1.7-rc.1 / rc.2）：
+ * - 读：直接解包 loader 解析出的 Config（Volatile 引用 `.get()` 即最新已提交值）；
+ * - 写：`settings.update(ns, patch)`，经 config-editor 落 profile patch（重启持久），省略
+ *   expectedRevision = 与旧 API 相同的末写胜语义（controller 串行队列 + lastSelfWrite 去重）；
+ * - 变更通知：`loader/volatile-update`（loader 只发给本 fiber，路径含变更字段）。
+ */
+export function createFormsRegistryStore(ctx, settings, ns, parsedConfig) {
+    const read = () => unwrapConfig(parsedConfig);
+    let prev = read();
+    return {
+        get: read,
+        update: async (patch) => {
+            await settings.update(ns, { ...patch });
+        },
+        watch: (callback) => subscribeVolatileUpdate(ctx, () => {
+            const next = read();
+            callback(next, prev);
+            prev = next;
+        }),
+    };
+}
+/**
+ * 找不到本插件 loader 条目（ns 缺失）时的只读降级 store：
+ * 读与变更通知仍可用（Config 引用由 loader 解析），只有写不可持久化。
+ */
+export function createFormsRegistryStoreWithoutNs(ctx, parsedConfig, note) {
+    const read = () => unwrapConfig(parsedConfig);
+    let prev = read();
+    return {
+        get: read,
+        update: async () => {
+            throw new Error(`settings 命名空间不可用，registry 地址无法持久化（${note}）`);
+        },
+        watch: (callback) => subscribeVolatileUpdate(ctx, () => {
+            const next = read();
+            callback(next, prev);
+            prev = next;
+        }),
+    };
+}
+/**
+ * 按运行时形态把 RegistrySettingsStore 接到 controller 上。
+ * 不抛：任何形态失败都以返回值 + warn 收场，绝不拖垮插件其余部分（webServer / tools）。
+ */
+export function wireRegistrySettings(input) {
+    const kind = detectSettingsKind(input.settings);
+    if (kind === 'legacy') {
+        const scope = input.settings.register('dshm', input.schema, {
+            base: input.parsedConfig,
+            applies: 'live',
+        });
+        input.attachStore(createLegacyRegistryStore(scope));
+        return 'legacy';
+    }
+    if (kind === 'forms') {
+        const ns = ownEntryId(input.ctx, input.packageName);
+        if (ns === undefined) {
+            const note = 'loader 中未找到本插件条目';
+            input.logger?.warn?.(`dsh-m: ${note}，设置卡不可持久化，registry 地址仅剩 cordis 配置文件通路`);
+            input.attachStore(createFormsRegistryStoreWithoutNs(input.ctx, input.parsedConfig, note));
+            return 'forms-without-ns';
+        }
+        input.attachStore(createFormsRegistryStore(input.ctx, input.settings, ns, input.parsedConfig));
+        return 'forms';
+    }
+    input.logger?.warn?.('dsh-m: settings 服务形态未识别（无 register 也无 describe/update），registry 地址走 cordis 配置文件');
+    return 'unknown';
+}