@max-null/dsh-plugin-center 0.1.7 → 0.2.0

package/dist/engine.d.ts

@@ -8,7 +8,7 @@
 import { Service, type Context } from '@deepseek-ai/cordis';
 import { type InstalledPlugin } from './meta.ts';
 import { type MarketPlugin } from './market.ts';
-import { type UpdateDigest } from './update.ts';
+import { type PnpmResult, type UpdateDigest } from './update.ts';
 declare module '@deepseek-ai/cordis' {
     interface Context {
         /** The plugin-center engine (provided by this package's host half). */
@@ -16,12 +16,26 @@ declare module '@deepseek-ai/cordis' {
     }
 }
 /** Which market directory the client wants to browse. */
-export type MarketSource = 'all' | 'awesome' | 'oh-my-dsh';
+export type MarketSource = 'all' | 'awesome' | 'oh-my-dsh' | 'dsh-market';
 /** What's New read-mark result, returned by listMarket so the client waterfalls. */
 export interface MarketSnapshot {
     plugins: MarketPlugin[];
     done: boolean;
 }
+/** One AI recommendation (suggest). */
+export interface Suggestion {
+    name: string;
+    reason: string;
+}
+/** One-shot diagnostics report (diagnostics). */
+export interface DiagnosticsReport {
+    dshVersion: string;
+    baseUrl: string;
+    node: string;
+    installed: InstalledPlugin[];
+    disabled: Record<string, boolean>;
+    pnpmLogTail: string;
+}
 export declare class PluginCenterEngine extends Service {
     static inject: string[];
     private awesomeCache;
@@ -30,6 +44,11 @@ export declare class PluginCenterEngine extends Service {
     private ohMyDshCache;
     private ohMyDshDone;
     private ohMyDshFetching;
+    private dshMarketCache;
+    private dshMarketDone;
+    private dshMarketFetching;
+    /** README-extracted screenshot URL per plugin name (lazy, P2). */
+    private readonly screenshotCache;
     private installedNamesCache;
     private updatesCache;
     private readonly updatesTtlMs;
@@ -59,21 +78,17 @@ export declare class PluginCenterEngine extends Service {
     private fastNpmVersion;
     /** Start the Oh-My-DSH fetch once (single PLUGINS.md parse). */
     private prefetchOhMyDsh;
+    /** Start the dsh-market fetch once (2BingLing/dsh-market, ~3900 plugins, trimmed). */
+    private prefetchDshMarket;
     /** Installed plugin names (no file IO) — cached so market polling stays cheap. */
     private installedNames;
     /** Market snapshot for one source: what is cached so far, plus whether done. */
     listMarket(source?: MarketSource): Promise<MarketSnapshot>;
     /** Detect updates for every installed third-party/local plugin, TTL-cached. */
     checkUpdates(sinceIso: string): Promise<UpdateDigest[]>;
-    install(spec: string): Promise<{
-        ok: boolean;
-        detail: string;
-    }>;
+    install(spec: string): Promise<PnpmResult>;
     /** Update one installed plugin to the detected target version (exact — see update.ts). */
-    update(name: string, version: string): Promise<{
-        ok: boolean;
-        detail: string;
-    }>;
+    update(name: string, version: string): Promise<PnpmResult>;
     /** 串行执行一次 pnpm 操作并失效缓存（无论成败都放行链条后续任务）。 */
     private enqueuePnpm;
     /** Temporary diagnostics for the empty-update bug; removed once root-caused. */
@@ -85,4 +100,18 @@ export declare class PluginCenterEngine extends Service {
             source: string;
         }[];
     }>;
+    /** Disable/enable one loader entry through the profile patch layer. */
+    toggle(id: string, disabled: boolean): Promise<{
+        ok: boolean;
+        detail: string;
+        nowDisabled: boolean | null;
+    }>;
+    /** One-shot diagnostics: environment, installed surface, patch stance, pnpm log tail. */
+    diagnostics(): Promise<DiagnosticsReport>;
+    /** Screenshot URL for one dsh-market plugin, lazily extracted from its README. */
+    screenshot(name: string): Promise<string | null>;
+    /** AI recommendation: keyword-filtered candidates ranked by the model. */
+    suggest(query: string): Promise<Suggestion[]>;
+    /** Wait for the dsh-market catalog (fetch or failure), with a hard deadline. */
+    private waitDshMarket;
 }

package/dist/engine.js

@@ -9,9 +9,11 @@ import { Service } from '@deepseek-ai/cordis';
 import { fileURLToPath } from 'node:url';
 import { dirname, join } from 'node:path';
 import { mkdir, readFile, writeFile } from 'node:fs/promises';
+import { existsSync, readFileSync } from 'node:fs';
 import { buildInstalledPlugin, clearPackageCache, resolvePackage } from "./meta.js";
-import { fetchAwesomePluginsJson, fetchOhMyDshOverrides, fetchOhMyDshPlugins, mapConcurrent, mergePlugins } from "./market.js";
+import { fetchAwesomePluginsJson, fetchDshMarketPlugins, fetchOhMyDshOverrides, fetchOhMyDshPlugins, mapConcurrent, mergePlugins, } from "./market.js";
 import { detectUpdate, installPlugin, updatePlugin } from "./update.js";
+import { readDisabledState, setDisabled } from "./toggle.js";
 /** Runtime mirror of cordis FiberState (a cross-package const enum). */
 const FIBER_PHASE = {
     0: 'pending',
@@ -23,6 +25,38 @@ const FIBER_PHASE = {
 };
 /** Sources that participate in update detection (official/builtin follow DSH itself). */
 const UPDATABLE = new Set(['installed', 'local']);
+/**
+ * Extract the first image URL from a plugin's README (P2 screenshots):
+ * markdown or HTML image syntax, relative paths resolved against the raw
+ * branch root; only GitHub-hosted images are accepted.
+ */
+async function extractFirstImage(repo) {
+    for (const branch of ['HEAD', 'master', 'main']) {
+        try {
+            const res = await fetch(`https://raw.githubusercontent.com/${repo}/${branch}/README.md`, {
+                signal: AbortSignal.timeout(12000),
+            });
+            if (!res.ok)
+                continue;
+            const text = await res.text();
+            const markdown = /!\[[^\]]*\]\(([^)]+)\)/u.exec(text);
+            const html = /<img[^>]+src=["']([^"']+)["']/iu.exec(text);
+            const raw = markdown?.[1] ?? html?.[1];
+            if (raw === undefined || raw === '')
+                continue;
+            const url = /^https?:\/\//u.test(raw)
+                ? raw
+                : `https://raw.githubusercontent.com/${repo}/${branch}/${raw.replace(/^\.?\//u, '')}`;
+            if (/^https:\/\/(raw\.)?githubusercontent\.com\//u.test(url))
+                return url;
+            if (/^https:\/\/github\.com\//u.test(url)) {
+                return url.replace(/^https:\/\/github\.com\/(.+?)\/blob\//u, 'https://raw.githubusercontent.com/$1/');
+            }
+        }
+        catch { /* try next branch */ }
+    }
+    return null;
+}
 export class PluginCenterEngine extends Service {
     static inject = ['loader'];
     awesomeCache = [];
@@ -31,6 +65,11 @@ export class PluginCenterEngine extends Service {
     ohMyDshCache = [];
     ohMyDshDone = false;
     ohMyDshFetching = false;
+    dshMarketCache = [];
+    dshMarketDone = false;
+    dshMarketFetching = false;
+    /** README-extracted screenshot URL per plugin name (lazy, P2). */
+    screenshotCache = new Map();
     installedNamesCache = null;
     updatesCache = null;
     updatesTtlMs = 5 * 60_000;
@@ -51,6 +90,7 @@ export class PluginCenterEngine extends Service {
         catch { /* listInstalled is re-run on demand */ }
         this.prefetchAwesome();
         this.prefetchOhMyDsh();
+        this.prefetchDshMarket();
     }
     /** The profile directory (cordis.yml anchor) — the resolution and install cwd. */
     get baseUrl() {
@@ -179,6 +219,20 @@ export class PluginCenterEngine extends Service {
             this.ohMyDshFetching = false;
         })();
     }
+    /** Start the dsh-market fetch once (2BingLing/dsh-market, ~3900 plugins, trimmed). */
+    prefetchDshMarket() {
+        if (this.dshMarketFetching || this.dshMarketDone)
+            return;
+        this.dshMarketFetching = true;
+        void (async () => {
+            try {
+                this.dshMarketCache = mergePlugins([await fetchDshMarketPlugins()]);
+            }
+            catch { /* empty on failure */ }
+            this.dshMarketDone = true;
+            this.dshMarketFetching = false;
+        })();
+    }
     /** Installed plugin names (no file IO) — cached so market polling stays cheap. */
     async installedNames() {
         if (this.installedNamesCache !== null)
@@ -194,7 +248,7 @@ export class PluginCenterEngine extends Service {
     /** Market snapshot for one source: what is cached so far, plus whether done. */
     async listMarket(source = 'all') {
         const installedNames = await this.installedNames();
-        const decorate = (plugins) => plugins.map(p => ({ ...p, installed: installedNames.has(p.name) }));
+        const decorate = (plugins) => plugins.map(p => ({ ...p, installed: installedNames.has(p.name) || installedNames.has(p.spec) }));
         if (source === 'awesome') {
             this.prefetchAwesome();
             return { plugins: decorate(this.awesomeCache), done: this.awesomeDone };
@@ -203,11 +257,20 @@ export class PluginCenterEngine extends Service {
             this.prefetchOhMyDsh();
             return { plugins: decorate(this.ohMyDshCache), done: this.ohMyDshDone };
         }
+        if (source === 'dsh-market') {
+            this.prefetchDshMarket();
+            // Score-first order (best first) so the big catalog reads usefully.
+            return {
+                plugins: decorate(this.dshMarketCache).sort((a, b) => (b.score?.total ?? 0) - (a.score?.total ?? 0)),
+                done: this.dshMarketDone,
+            };
+        }
         this.prefetchAwesome();
         this.prefetchOhMyDsh();
+        this.prefetchDshMarket();
         return {
-            plugins: decorate(mergePlugins([this.awesomeCache, this.ohMyDshCache])),
-            done: this.awesomeDone && this.ohMyDshDone,
+            plugins: decorate(mergePlugins([this.awesomeCache, this.ohMyDshCache, this.dshMarketCache])),
+            done: this.awesomeDone && this.ohMyDshDone && this.dshMarketDone,
         };
     }
     /** Detect updates for every installed third-party/local plugin, TTL-cached. */
@@ -250,4 +313,111 @@ export class PluginCenterEngine extends Service {
             installed: (await this.listInstalled()).map(p => ({ name: p.name, version: p.version, source: p.source })),
         };
     }
+    /** Disable/enable one loader entry through the profile patch layer. */
+    async toggle(id, disabled) {
+        const result = await setDisabled(this.baseUrl, id, disabled);
+        this.installedNamesCache = null;
+        return result;
+    }
+    /** One-shot diagnostics: environment, installed surface, patch stance, pnpm log tail. */
+    async diagnostics() {
+        const [installed, dshVersion] = await Promise.all([this.listInstalled(), this.dshVersion()]);
+        let pnpmLogTail = '';
+        try {
+            const logPath = join(this.baseUrl, 'plugin-center-pnpm.log');
+            if (existsSync(logPath)) {
+                const text = readFileSync(logPath, 'utf8');
+                pnpmLogTail = text.slice(-4000);
+            }
+        }
+        catch { /* best-effort */ }
+        return {
+            dshVersion,
+            baseUrl: this.baseUrl,
+            node: process.version,
+            installed,
+            disabled: Object.fromEntries(readDisabledState(join(this.baseUrl, 'cordis.patch.yml'))),
+            pnpmLogTail,
+        };
+    }
+    /** Screenshot URL for one dsh-market plugin, lazily extracted from its README. */
+    async screenshot(name) {
+        const cached = this.screenshotCache.get(name);
+        if (cached !== undefined)
+            return cached;
+        this.screenshotCache.set(name, null); // placeholder against concurrent dup fetches
+        const repo = this.dshMarketCache.find(p => p.name === name || p.spec === name)?.name ?? name;
+        const url = await extractFirstImage(repo);
+        this.screenshotCache.set(name, url);
+        return url;
+    }
+    /** AI recommendation: keyword-filtered candidates ranked by the model. */
+    async suggest(query) {
+        const q = query.trim();
+        if (q === '')
+            return [];
+        await this.waitDshMarket();
+        const llm = this.ctx.get('llm');
+        if (llm?.stream === undefined) {
+            throw new Error('llm 服务不可用（当前 profile 未提供 dsh-llm）');
+        }
+        const tokens = q.toLowerCase().split(/[\s,，、;；]+/u).filter(Boolean);
+        const scored = this.dshMarketCache
+            .map(p => ({
+            p,
+            hits: tokens.reduce((n, tok) => n + (p.name.toLowerCase().includes(tok)
+                || p.description.zh.toLowerCase().includes(tok)
+                || p.description.en.toLowerCase().includes(tok)
+                || p.categories.some(c => c.includes(tok)) ? 1 : 0), 0),
+        }))
+            .sort((a, b) => (b.hits - a.hits) || (b.p.stars ?? 0) - (a.p.stars ?? 0))
+            .slice(0, 25);
+        if (scored.length === 0)
+            return [];
+        const list = scored.map(({ p }) => `- ${p.name} | ${p.stars ?? 0}★ | ${p.description.zh.slice(0, 60)}`).join('\n');
+        const system = '你是 DeepSeek Harness 插件市场的推荐助手。根据用户需求从候选插件中选择 3-5 个最合适的，只输出一个 JSON 数组（不要 markdown 代码块）：[{"name":"插件名","reason":"一句话中文推荐理由"}]';
+        const chunks = llm.stream({
+            provider: 'deepseek-official',
+            model: 'deepseek-v4-flash',
+            messages: [{ role: 'user', content: `用户需求：${q}\n\n候选插件列表（名称 | 星标 | 简介）：\n${list}` }],
+            system,
+            maxTokens: 800,
+            signal: AbortSignal.timeout(40000),
+        });
+        let text = '';
+        let failed = false;
+        for await (const chunk of chunks) {
+            if (chunk.type === 'text-delta')
+                text += chunk.text ?? '';
+            else if (chunk.type === 'finish' && (chunk.reason?.kind === 'error' || chunk.reason?.kind === 'aborted'))
+                failed = true;
+        }
+        if (failed || text.trim() === '')
+            throw new Error('模型推荐失败，请重试');
+        const start = text.indexOf('[');
+        const end = text.lastIndexOf(']');
+        if (start < 0 || end <= start)
+            throw new Error(`模型输出无法解析：${text.slice(0, 200)}`);
+        try {
+            const parsed = JSON.parse(text.slice(start, end + 1));
+            if (!Array.isArray(parsed))
+                throw new Error('bad shape');
+            return parsed
+                .filter((item) => item !== null && typeof item === 'object'
+                && typeof item.name === 'string'
+                && typeof item.reason === 'string')
+                .slice(0, 5);
+        }
+        catch {
+            throw new Error(`模型输出无法解析：${text.slice(0, 200)}`);
+        }
+    }
+    /** Wait for the dsh-market catalog (fetch or failure), with a hard deadline. */
+    async waitDshMarket() {
+        this.prefetchDshMarket();
+        const deadline = Date.now() + 65_000;
+        while (!this.dshMarketDone && Date.now() < deadline) {
+            await new Promise(resolve => setTimeout(resolve, 200));
+        }
+    }
 }

package/dist/market.d.ts

@@ -21,6 +21,12 @@ export interface MarketPlugin {
     /** Latest published version (npm), null until fetched / for non-npm plugins. */
     version: string | null;
     installed: boolean;
+    /** dsh-market five-dimension score (dsh-market source only), else null. */
+    score: {
+        total: number;
+        breakdown: Record<string, number>;
+        explanation: string;
+    } | null;
 }
 /** A per-source plugin record before merging. */
 interface RawPlugin {
@@ -34,6 +40,7 @@ interface RawPlugin {
     };
     stars: number | null;
     npm: string | null;
+    score: MarketPlugin['score'];
 }
 /** Map a bounded set of fetches concurrently, keeping per-fetch failures as null. */
 export declare function mapConcurrent<T>(items: readonly string[], limit: number, fn: (item: string) => Promise<T>): Promise<(T | null)[]>;
@@ -47,6 +54,13 @@ export declare function fetchOhMyDshOverrides(): Promise<Record<string, {
     category?: string;
     note?: string;
 }>>;
+/**
+ * Fetch dsh-market's aggregated catalog (2BingLing/dsh-market plugins.json,
+ * ~3900 plugins with five-dimension scores and bilingual descriptions) in
+ * one request, then trim each entry to the market surface shape. The raw
+ * file is ~10 MB, so the trimmed result (~1.5 MB) is what the engine caches.
+ */
+export declare function fetchDshMarketPlugins(): Promise<RawPlugin[]>;
 /** Parse Oh-My-DSH's PLUGINS.md (markdown table, sectioned by category). */
 export declare function fetchOhMyDshPlugins(): Promise<RawPlugin[]>;
 /** Merge raw per-source records by repo name: union categories, keep non-empty desc/stars. */

package/dist/market.js

@@ -41,6 +41,7 @@ export async function fetchAwesomePluginsJson() {
         description: { en: p.description?.en ?? '', zh: p.description?.zh ?? '' },
         stars: typeof p.stars === 'number' ? p.stars : null,
         npm: typeof p.npm === 'string' && p.npm !== '' ? p.npm : null,
+        score: null,
     }));
 }
 /** Fetch Oh-My-DSH's curated overrides (min_stars filter + category/note overrides). */
@@ -58,6 +59,74 @@ export async function fetchOhMyDshOverrides() {
         return {};
     }
 }
+/** Category keywords for dsh-market tag → CATEGORIES mapping (prefix match). */
+const CATEGORY_KEYWORDS = [
+    ['ui', ['ui', 'interface', 'sidebar', 'panel', 'widget', '界面', '面板', '侧栏', '导航']],
+    ['theme', ['theme', 'skin', '主题', '皮肤', '壁纸']],
+    ['tools', ['tool', 'terminal', 'bash', '工具', '终端', '命令']],
+    ['model', ['model', 'llm', 'api', '模型', 'provider']],
+    ['session', ['session', '会话', 'history', '记忆回']],
+    ['memory', ['memory', '记忆']],
+    ['vision', ['vision', 'image', '图片', '视觉', 'screenshot']],
+    ['skill', ['skill', '技能', 'agent']],
+    ['workflow', ['workflow', 'workflow', '流程', 'automation', '自动化']],
+    ['notify', ['notify', '通知', 'toast', 'push']],
+    ['dev', ['dev', 'git', 'code', '开发', '代码', 'debug', '测试']],
+    ['fun', ['fun', '趣味', 'pet', '宠物', '游戏']],
+];
+function categorizeTags(tags) {
+    const out = new Set();
+    for (const tag of tags ?? []) {
+        const low = tag.toLowerCase();
+        for (const [category, keywords] of CATEGORY_KEYWORDS) {
+            if (keywords.some(keyword => low.includes(keyword)))
+                out.add(category);
+        }
+    }
+    return [...out];
+}
+/**
+ * Fetch dsh-market's aggregated catalog (2BingLing/dsh-market plugins.json,
+ * ~3900 plugins with five-dimension scores and bilingual descriptions) in
+ * one request, then trim each entry to the market surface shape. The raw
+ * file is ~10 MB, so the trimmed result (~1.5 MB) is what the engine caches.
+ */
+export async function fetchDshMarketPlugins() {
+    const res = await fetch('https://raw.githubusercontent.com/2BingLing/dsh-market/master/data/plugins.json', {
+        headers: UA,
+        signal: AbortSignal.timeout(60000),
+    });
+    if (!res.ok)
+        throw new Error(`dsh-market plugins.json: HTTP ${res.status}`);
+    const json = await res.json();
+    const out = [];
+    for (const p of json.plugins ?? []) {
+        const name = typeof p.name === 'string' && p.name !== '' ? p.name : '';
+        const full = typeof p.fullName === 'string' && p.fullName !== '' ? p.fullName : name;
+        if (full === '')
+            continue;
+        const descEn = typeof p.description === 'string' ? p.description : '';
+        const descZh = typeof p.descriptionZh === 'string' && p.descriptionZh !== '' ? p.descriptionZh : descEn;
+        out.push({
+            // Merge key / display name: owner/repo (matches the awesome source).
+            name: full,
+            url: `https://github.com/${full}`,
+            spec: name, // npm package name is the install spec
+            categories: categorizeTags(p.tags),
+            description: { en: descEn, zh: descZh },
+            stars: typeof p.stars === 'number' ? p.stars : null,
+            npm: name === '' ? null : name,
+            score: p.score !== null && typeof p.score === 'object'
+                ? {
+                    total: typeof p.score.total === 'number' ? p.score.total : 0,
+                    breakdown: p.score.breakdown ?? {},
+                    explanation: typeof p.score.explanation === 'string' ? p.score.explanation : '',
+                }
+                : null,
+        });
+    }
+    return out;
+}
 /** Parse Oh-My-DSH's PLUGINS.md (markdown table, sectioned by category). */
 export async function fetchOhMyDshPlugins() {
     try {
@@ -85,6 +154,7 @@ export async function fetchOhMyDshPlugins() {
                 description: { en: '', zh: cells[6] },
                 stars: Number.isFinite(stars) ? stars : null,
                 npm: null,
+                score: null,
             });
         }
         return plugins;
@@ -108,6 +178,7 @@ export function mergePlugins(sources) {
                 npm: null,
                 version: null,
                 installed: false,
+                score: null,
             };
             cur.categories = [...new Set([...cur.categories, ...item.categories])];
             if (item.description.en !== '')
@@ -118,6 +189,8 @@ export function mergePlugins(sources) {
                 cur.stars = item.stars;
             if (item.npm !== null)
                 cur.npm = item.npm;
+            if (item.score !== null)
+                cur.score = item.score;
             map.set(item.name, cur);
         }
     }

package/dist/rpc.js

@@ -31,7 +31,7 @@ export class PluginCenterRpc extends Service {
                         const result = await ctx.pluginCenter.install(spec);
                         if (!result.ok)
                             return internal(`install ${spec} 失败：${result.detail}`);
-                        return { ok: true, value: true };
+                        return { ok: true, value: { durationMs: result.durationMs } };
                     }
                     case 'update': {
                         const name = payload?.name;
@@ -43,7 +43,31 @@ export class PluginCenterRpc extends Service {
                         const result = await ctx.pluginCenter.update(name, version);
                         if (!result.ok)
                             return internal(`update ${name} 失败：${result.detail}`);
-                        return { ok: true, value: true };
+                        return { ok: true, value: { durationMs: result.durationMs } };
+                    }
+                    case 'toggle': {
+                        const id = payload?.id;
+                        const disabled = payload?.disabled;
+                        if (typeof id !== 'string' || id === '')
+                            return internal('toggle: id is required');
+                        const result = await ctx.pluginCenter.toggle(id, disabled === true);
+                        if (!result.ok)
+                            return internal(`toggle ${id} 失败：${result.detail}`);
+                        return { ok: true, value: { nowDisabled: result.nowDisabled } };
+                    }
+                    case 'diagnostics':
+                        return { ok: true, value: await ctx.pluginCenter.diagnostics() };
+                    case 'screenshot': {
+                        const name = payload?.name;
+                        if (typeof name !== 'string' || name === '')
+                            return internal('screenshot: name is required');
+                        return { ok: true, value: await ctx.pluginCenter.screenshot(name) };
+                    }
+                    case 'suggest': {
+                        const query = payload?.query;
+                        if (typeof query !== 'string')
+                            return internal('suggest: query is required');
+                        return { ok: true, value: await ctx.pluginCenter.suggest(query) };
                     }
                     case 'debug':
                         return { ok: true, value: await ctx.pluginCenter.debug() };

package/dist/toggle.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Hot disable/enable through the profile's user patch layer
+ * (`<profileDir>/cordis.patch.yml`) — the mechanism dsh-market ports from
+ * dsh-plugin-hub: a patch row `- id: X` + `disabled: true` stops that loader
+ * entry, `disabled: false` force-enables one a lower layer disabled. The
+ * official web profile re-composes via HMR (~1s, no restart); SSiD applies
+ * the same file on every boot, so the choice survives restarts there.
+ *
+ * Writes are line-level (the patch dialect is simple for toggles: a row id
+ * followed by an optional `disabled:` line), serialized so concurrent
+ * toggles cannot interleave a read-modify-write, refused when the file is
+ * not a plain entry list, and protected for host-infrastructure rows.
+ */
+export interface ToggleResult {
+    ok: boolean;
+    detail: string;
+    /** The patch layer's stance after the write, or null when refused. */
+    nowDisabled: boolean | null;
+}
+/** What the user patch layer currently says about every row id. */
+export declare function readDisabledState(patchPath: string): Map<string, boolean>;
+/**
+ * Set one entry's disabled stance in the profile patch layer. The file is
+ * only touched when the stance changes; a malformed file (not a plain
+ * entry list) is reported instead of being made worse.
+ * @param profileDir - the profile directory holding cordis.patch.yml.
+ * @param id - the loader entry id to toggle.
+ * @param disabled - the target stance.
+ * @returns the outcome; `nowDisabled` mirrors the stance or null when refused.
+ */
+export declare function setDisabled(profileDir: string, id: string, disabled: boolean): Promise<ToggleResult>;