dsh-m 0.6.1 → 0.8.4

package/lib/core/community-adapter.js

@@ -29,6 +29,13 @@ function strArray(v) {
 function numOrNull(v) {
     return typeof v === 'number' && Number.isFinite(v) ? v : null;
 }
+/** 非空字符串透传（trim 后），否则 undefined（键不产生）——0.7.0 Task 1 bypass 字段统一口径。 */
+function strOrUndef(v) {
+    if (typeof v !== 'string')
+        return undefined;
+    const s = v.trim();
+    return s === '' ? undefined : s;
+}
 /** npm 形状成立（非空字符串且满足 npm 包名形状）→ source: npm。 */
 function npmShape(raw) {
     if (typeof raw.npm !== 'string')
@@ -167,6 +174,15 @@ export function adaptCommunityCatalog(catalog) {
             capabilityRedLines: strArray(raw.capabilityRedLines),
             screenshots: strArray(raw.screenshots),
             descriptionEn: en,
+            owner,
+            ...(strOrUndef(raw.added) !== undefined ? { added: strOrUndef(raw.added) } : {}),
+            ...(raw.deprecated === true ? { deprecated: true } : {}),
+            ...(strOrUndef(raw.replacement) !== undefined ? { replacement: strOrUndef(raw.replacement) } : {}),
+            ...(strOrUndef(raw.install) !== undefined ? { install: strOrUndef(raw.install) } : {}),
+            ...(strOrUndef(raw.downloadsStart) !== undefined ? { downloadsStart: strOrUndef(raw.downloadsStart) } : {}),
+            ...(strOrUndef(raw.downloadsEnd) !== undefined ? { downloadsEnd: strOrUndef(raw.downloadsEnd) } : {}),
+            ...(strOrUndef(raw.downloadsCheckedAt) !== undefined ? { downloadsCheckedAt: strOrUndef(raw.downloadsCheckedAt) } : {}),
+            ...(strOrUndef(raw.version) !== undefined ? { version: strOrUndef(raw.version) } : {}),
         });
     }
     if (fallbackEn > 0)

package/lib/core/community.js

@@ -19,9 +19,10 @@ export const CATALOG_BODY_TIMEOUT_MS = 15_000;
 export const COMMUNITY_CHAIN_BUDGET_MS = 30_000;
 /**
  * 上游 23 个分类 id 的全量中文标签（以 fixture `categories` 键为准逐条核对）。
- * 其中 ui/tools/market 与精选分类同名共享过滤桶、不进筛选栏社区组，标签供详情页等处使用。
+ * 0.7.0 Task 4 改名导出 + 作为标签单一事实源：summary 层附带（communitySummary）、
+ * GUI zoneChips 消费服务端数据，客户端内嵌副本（market-state.js）随 Task 8 删除。
  */
-export const COMMUNITY_KNOWN_CATEGORIES = {
+export const COMMUNITY_CATEGORY_LABELS = {
     agi: 'AGI 架构探索',
     ui: 'UI 增强',
     usage: '用量与计费',

package/lib/core/host-api.js

@@ -227,10 +227,13 @@ export function createApiDispatcher(ctx) {
                 case 'self-check': {
                     try {
                         const latest = await d.npmLatest(ctx.pkg.name, cfg().timeoutMs ?? 20_000);
-                        payload = { current: ctx.pkg.version, latest: latest.version, outdated: isNewerVersion(latest.version, ctx.pkg.version) };
+                        const outdated = isNewerVersion(latest.version, ctx.pkg.version);
+                        // ahead（0.8.0）：本地 dev 版领先 npm 发布——设置页改显「本地开发版」而非误导性的旧「npm 最新」
+                        const ahead = !outdated && latest.version !== ctx.pkg.version;
+                        payload = { current: ctx.pkg.version, latest: latest.version, outdated, ahead };
                     }
                     catch (err) {
-                        payload = { current: ctx.pkg.version, latest: null, outdated: false, error: err instanceof Error ? err.message : String(err) };
+                        payload = { current: ctx.pkg.version, latest: null, outdated: false, ahead: false, error: err instanceof Error ? err.message : String(err) };
                     }
                     break;
                 }
@@ -261,9 +264,11 @@ export function createApiDispatcher(ctx) {
                 }
                 case 'market': {
                     await ctx.controller.ensureReady();
-                    // GUI policy：忽略客户端 withLatest，固定 true；limit clamp 1..50
+                    // GUI policy：忽略客户端 withLatest，固定 true；limit clamp 1..96、缺省 24
+                    // （0.7.0 Task 7 探测预算决策：96 为 opt-in 页大小，默认 24 低于 0.6.x 默认 50 的探测负载；
+                    //  最坏情况被 core 60s deadline 框死为 latestError，不阻塞列表，Q46 不动）
                     const limitRaw = Number(body.limit);
-                    const limit = Number.isFinite(limitRaw) && limitRaw > 0 ? Math.min(50, Math.max(1, Math.floor(limitRaw))) : 50;
+                    const limit = Number.isFinite(limitRaw) && limitRaw > 0 ? Math.min(96, Math.max(1, Math.floor(limitRaw))) : 24;
                     const offsetRaw = Number(body.offset);
                     const offset = Number.isFinite(offsetRaw) && offsetRaw > 0 ? Math.floor(offsetRaw) : 0;
                     // category：精选 5 + 社区开放 slug（非法 slug → 400，不静默吞）
@@ -277,12 +282,33 @@ export function createApiDispatcher(ctx) {
                             throw new ApiProtocolError(400, `非法分类: ${categoryRaw}（需精选分类或 [a-z0-9-]{1,32} slug）`);
                         }
                     }
+                    // source 分区 + sort（0.7.0 Task 7）：非法值 400（不静默吞）；primaryOnly 已删除——显式拒绝而非静默忽略（审计 #8）
+                    if (body.primaryOnly !== undefined) {
+                        throw new ApiProtocolError(400, '参数 primaryOnly 已删除：改用 source（primary/community/all）');
+                    }
+                    const sourceRaw = typeof body.source === 'string' ? body.source.trim() : '';
+                    if (sourceRaw !== '' && sourceRaw !== 'primary' && sourceRaw !== 'community' && sourceRaw !== 'all') {
+                        throw new ApiProtocolError(400, `非法 source: ${sourceRaw}（需 primary/community/all）`);
+                    }
+                    const source = sourceRaw === '' ? 'all' : sourceRaw;
+                    let sort;
+                    if (body.sort !== undefined && body.sort !== null) {
+                        const s = body.sort;
+                        if ((s.field === 'downloads' || s.field === 'stars' || s.field === 'added') &&
+                            (s.dir === 'asc' || s.dir === 'desc')) {
+                            sort = { field: s.field, dir: s.dir };
+                        }
+                        else {
+                            throw new ApiProtocolError(400, '非法 sort: 需 { field: downloads|stars|added, dir: asc|desc }');
+                        }
+                    }
                     const result = await d.listMarket(cfg(), {
                         query: strArg(body, 'query'),
                         category,
+                        source,
+                        sort,
                         offset,
                         limit,
-                        primaryOnly: boolArg(body.primaryOnly),
                         force: boolArg(body.force),
                         withLatest: true,
                         namespace: 'host',
@@ -369,6 +395,14 @@ export function createApiDispatcher(ctx) {
                     payload = { applied: true, ...snapshotPayload(snap, cfg()) };
                     break;
                 }
+                case 'set-community': {
+                    // 0.8.0 设置页社区开关：live 生效（内存）+ store 持久化；无需主清单重载
+                    if (typeof body.enabled !== 'boolean')
+                        throw new ApiProtocolError(400, '缺少 enabled（必须为 boolean）');
+                    const snap = await ctx.controller.setCommunity(body.enabled);
+                    payload = { applied: true, ...snapshotPayload(snap, cfg()) };
+                    break;
+                }
                 case 'registry-default-download': {
                     const loaded = await ctx.controller.loadDefault({ force: true, signal });
                     payload = { registry: loaded.registry, registryState: loaded };

package/lib/core/market.js

@@ -18,8 +18,9 @@ import { precheckNpmCompat, IncompatibleError } from './compat-check.js';
 import { PROTECTED_MODULES, composeEnablement } from './enablement.js';
 import { readProfileOverrides } from './patch-yaml.js';
 import { loadRegistry as defaultLoadRegistry, } from './registry.js';
-import { fetchCommunityCatalog as defaultFetchCommunityCatalog, } from './community.js';
+import { COMMUNITY_CATEGORY_LABELS, fetchCommunityCatalog as defaultFetchCommunityCatalog, } from './community.js';
 import { adaptCommunityCatalog } from './community-adapter.js';
+import { normalizeSearchText, relevanceScore, tokenizeSearchText } from './search-relevance.js';
 import { GithubBudgetExhaustedError, createGithubRequestBudget, isExactVersion } from './versions.js';
 import { HttpError } from './httpx.js';
 import { verifyInstalledAdditions } from './install-guard.js';
@@ -59,7 +60,10 @@ function loaderEntriesOrNull() {
 }
 // ---------- 通用工具 ----------
 const DEFAULT_DEADLINE_MS = 60_000;
-const WITH_LATEST_MAX = 50;
+/** withLatest 上限 = 96（0.7.0 Task 7：50→96，opt-in 页大小；默认页 24 的探测负载低于 0.6.x 默认 50——
+ * 96/页冷缓存最坏情况被 60s deadline 框死为 latestError 不阻塞列表，Q46「探测对象=页面条目」不动；
+ * 人工验收阈值：96/页冷缓存 latestError > 20% 即回退默认页大小并重议）。 */
+const WITH_LATEST_MAX = 96;
 const METADATA_ONLY_MAX = 80;
 const LATEST_WORKERS = 8;
 export function abortError() {
@@ -256,7 +260,7 @@ export function mergeRegistries(primary, community) {
     const warnings = displaced.length > 0 ? [`${displaced.length} 条社区条目与主清单重复，已让位（主清单恒优先）`] : [];
     return { items: [...primary, ...sorted], displaced: displaced.length, warnings };
 }
-function communitySummary(state, counts, extraWarnings) {
+function communitySummary(state, counts, extraWarnings, categoryLabelsEn) {
     const unavailableLike = state.status === 'disabled' || state.status === 'unavailable';
     return {
         enabled: state.enabled,
@@ -272,23 +276,38 @@ function communitySummary(state, counts, extraWarnings) {
         skippedSubpathNoNpm: unavailableLike ? 0 : (counts.skippedSubpathNoNpm ?? 0),
         errors: [...state.errors],
         warnings: [...state.warnings, ...extraWarnings],
+        // 标签单一事实源（0.7.0 Task 4）：disabled/skipped 下无社区数据语义，不携带；
+        // EN 标签（i18n）随行携带，仅在调用方传入非空映射时出现（缺省 = 上游无 categories 数据）
+        ...(state.status !== 'disabled' && state.status !== 'skipped'
+            ? {
+                categoryLabels: { ...COMMUNITY_CATEGORY_LABELS },
+                ...(categoryLabelsEn && Object.keys(categoryLabelsEn).length > 0
+                    ? { categoryLabelsEn: { ...categoryLabelsEn } }
+                    : {}),
+            }
+            : {}),
     };
 }
 function disabledCommunitySummary() {
     return communitySummary({ enabled: false, status: 'disabled', version: null, checkedAt: null, fetchedAt: null, route: null, count: 0, errors: [], warnings: [] }, {}, []);
 }
+/** 查询层主动跳过（0.7.0 Task 2：source='primary'）：本次未加载社区层，非配置关闭、非故障。 */
+function skippedCommunitySummary() {
+    return communitySummary({ enabled: true, status: 'skipped', version: null, checkedAt: null, fetchedAt: null, route: null, count: 0, errors: [], warnings: [] }, {}, []);
+}
 function communityTimeoutSummary() {
     return communitySummary({ enabled: true, status: 'unavailable', version: null, checkedAt: null, fetchedAt: null, route: null, count: 0, errors: ['社区目录状态获取超时，可稍后刷新'], warnings: [] }, {}, []);
 }
 /**
  * 社区 loader waiter 收敛（v9/v10 waiter-scoped 契约）：共享 flight 不接收调用者 deadline，
  * 本函数作为 waiter 用剩余 deadline race 自己的等待；到点只结束本 waiter（summary 标超时），
- * 共享 flight 照常继续。primaryOnly/未启用 → loader 零调用（task 传 null）。
+ * 共享 flight 照常继续。source='primary'/未启用 → loader 零调用（task 传 null → skipped；
+ * 配置关闭走真任务的 disabled 分支，与跳过语义分离）。
  * 导出供 community.ts getCommunitySummary 复用（summary 组装单一产地）。
  */
 export async function communityOutcome(task, deadlineAt, primary) {
     if (!task)
-        return { summary: disabledCommunitySummary(), merged: primary };
+        return { summary: skippedCommunitySummary(), merged: primary };
     let loaded;
     try {
         loaded = await deadlineRace(task, deadlineAt - Date.now());
@@ -310,18 +329,65 @@ export async function communityOutcome(task, deadlineAt, primary) {
     }
     const adapted = adaptCommunityCatalog(loaded.catalog);
     const merge = mergeRegistries(primary, adapted.entries);
+    // EN 分类标签（i18n）：直接取上游目录 categories.en——上游新增分类自动跟进，
+    // 缺 en 的 id 不进映射（客户端按语言取用并回退中文标签，不在此处手养第二张表）
+    const categoryLabelsEn = Object.fromEntries(Object.entries(loaded.catalog.categories)
+        .map(([id, c]) => [id, typeof c?.en === 'string' && c.en !== '' ? c.en : ''])
+        .filter(([, en]) => en !== ''));
     const summary = communitySummary(state, {
         acceptedCount: adapted.entries.length,
         upstreamCount: loaded.catalog.plugins.length,
         displaced: merge.displaced,
         skippedDirty: adapted.skippedDirty,
         skippedSubpathNoNpm: adapted.skippedSubpathNoNpm,
-    }, [...adapted.warnings, ...merge.warnings]);
+    }, [...adapted.warnings, ...merge.warnings], categoryLabelsEn);
     return { summary, merged: merge.items };
 }
 function isCommunityEntry(entry) {
     return entry.descriptionEn !== undefined;
 }
+/** 旁路数值/日期读取（RegistryEntry 无这些键 → null/''；0.7.0 Task 2 排序用）。 */
+function dlOf(e) {
+    const v = e.downloads;
+    return typeof v === 'number' && Number.isFinite(v) ? v : null;
+}
+function starsOf(e) {
+    const v = e.stars;
+    return typeof v === 'number' && Number.isFinite(v) ? v : -1;
+}
+function addedOf(e) {
+    const v = e.added;
+    return typeof v === 'string' ? v : '';
+}
+/**
+ * 分区排序（0.7.0 Task 2）：`dir` 只翻转有数据的比较，**不翻转「无数据垫底」语义**——
+ * downloads 无计数 ≠ 0（无数据者恒排有数据者之后，组内按 stars 降序再 name）；
+ * stars 缺失视为 -1、added 缺失视为最旧（空串日期），两者参与正常比较随 dir 翻转。
+ */
+function sortEntries(entries, sort) {
+    const dirMul = sort.dir === 'asc' ? 1 : -1;
+    const nameCmp = (a, b) => String(a.name).localeCompare(String(b.name));
+    return entries.slice().sort((a, b) => {
+        if (sort.field === 'downloads') {
+            const da = dlOf(a);
+            const db = dlOf(b);
+            if (da !== null && db !== null)
+                return (da - db) * dirMul || nameCmp(a, b);
+            if (da !== null)
+                return -1;
+            if (db !== null)
+                return 1;
+            return starsOf(b) - starsOf(a) || nameCmp(a, b);
+        }
+        if (sort.field === 'stars') {
+            const diff = starsOf(a) - starsOf(b);
+            return diff * dirMul || nameCmp(a, b);
+        }
+        const aa = addedOf(a);
+        const ab = addedOf(b);
+        return (aa < ab ? -1 : aa > ab ? 1 : 0) * dirMul || nameCmp(a, b);
+    });
+}
 /** 合并条目 → MarketItem：社区条目带 community 标记与旁路字段。 */
 function toMarketItem(entry, installedItems) {
     const inst = matchInstalledByEntry(entry, installedItems);
@@ -337,14 +403,26 @@ function toMarketItem(entry, installedItems) {
         item.capabilities = entry.capabilities;
         item.capabilityRedLines = entry.capabilityRedLines;
         item.screenshots = entry.screenshots;
+        item.owner = entry.owner;
+        if (entry.added !== undefined)
+            item.added = entry.added;
+        if (entry.deprecated !== undefined)
+            item.deprecated = entry.deprecated;
+        if (entry.replacement !== undefined)
+            item.replacement = entry.replacement;
+        if (entry.install !== undefined)
+            item.install = entry.install;
+        if (entry.downloadsStart !== undefined)
+            item.downloadsStart = entry.downloadsStart;
+        if (entry.downloadsEnd !== undefined)
+            item.downloadsEnd = entry.downloadsEnd;
+        if (entry.downloadsCheckedAt !== undefined)
+            item.downloadsCheckedAt = entry.downloadsCheckedAt;
+        if (entry.version !== undefined)
+            item.version = entry.version;
     }
     return item;
 }
-/** 合并条目的搜索串：社区条目附英文描述原文（Q45 搜索同时匹配中英文）。 */
-function searchableText(entry) {
-    const base = `${entry.id} ${entry.name} ${entry.description} ${entry.tags.join(' ')}`;
-    return isCommunityEntry(entry) ? `${base} ${entry.descriptionEn}` : base;
-}
 // ---------- 市场列表 ----------
 function marketDeps() {
     return {
@@ -363,15 +441,17 @@ export async function listMarket(cfg = {}, opts = {}, deps = {}) {
         : DEFAULT_DEADLINE_MS;
     const deadlineAt = startedAt + deadlineMs;
     const namespace = opts.namespace ?? 'host';
+    // 分区归一（0.7.0 Task 2）：非法值一律按 'all'
+    const source = opts.source === 'primary' || opts.source === 'community' ? opts.source : 'all';
     const withLatest = opts.withLatest !== false;
     const maxLimit = withLatest ? WITH_LATEST_MAX : METADATA_ONLY_MAX;
     const signal = opts.signal;
     const remaining = () => deadlineAt - Date.now();
     const registryTask = d.loadRegistry(cfg, { namespace, signal, force: opts.force, deadlineMs });
     const installedTask = d.listInstalledPlugins().catch(() => null);
-    // 社区 flight 并发启动（primaryOnly 零调用）；共享 loader 不接收调用者 deadline——
+    // 社区 flight 并发启动（source=primary 零调用；0.7.0 Task 7：primaryOnly 字段已删除）；共享 loader 不接收调用者 deadline——
     // listMarket 作为 waiter 在 communityOutcome 内 race 自己的剩余 deadline/signal（v10 契约）
-    const communityTask = opts.primaryOnly === true ? null : d.fetchCommunityCatalog(cfg, { namespace, signal, force: opts.force });
+    const communityTask = source === 'primary' ? null : d.fetchCommunityCatalog(cfg, { namespace, signal, force: opts.force });
     let loaded;
     try {
         loaded = await deadlineRace(registryTask, remaining());
@@ -403,26 +483,43 @@ export async function listMarket(cfg = {}, opts = {}, deps = {}) {
     const installedItems = installed?.items ?? [];
     // 社区 waiter 收敛：主 unavailable 时 merged = 存活社区条目（Q42 出页不返空）；两层皆不可用 → 空页契约
     const community = await communityOutcome(communityTask, deadlineAt, loaded.registry.plugins);
-    // 全量统计 + query/category 过滤 + 分页（同步，极轻）
-    const all = community.merged;
+    // 分区过滤 + 全量统计 + query/category 过滤 + 分页（同步，极轻；0.7.0 Task 2）：
+    // categoryCounts = 分区集合（不含 query/category 过滤——chips 需要全区计数）；
+    // total = 分区 ∩ query ∩ category。
+    const merged = community.merged;
+    const zoned = source === 'community'
+        ? merged.filter(isCommunityEntry)
+        : source === 'primary'
+            ? merged.filter((entry) => !isCommunityEntry(entry))
+            : merged;
     const counts = zeroCounts();
-    for (const entry of all)
+    for (const entry of zoned)
         counts[entry.category] = (counts[entry.category] ?? 0) + 1;
-    const q = (opts.query ?? '').trim().toLowerCase();
     const cat = opts.category ?? null;
-    const filtered = all.filter((entry) => {
+    // 相关性搜索（0.7.0 Task 3）：归一化分词 + 字段加权评分；0 分不返回；
+    // id 整串精确匹配保证命中（收藏 stale 检测依赖）。
+    const terms = tokenizeSearchText(normalizeSearchText(opts.query ?? ''));
+    const filtered = zoned.filter((entry) => {
         if (cat && entry.category !== cat)
             return false;
-        if (!q)
+        if (terms.length === 0)
             return true;
-        return searchableText(entry).toLowerCase().includes(q);
+        return relevanceScore(entry, terms) > 0;
     });
-    const total = filtered.length;
+    // 排序：显式 sort 先行；query 命中时相关性优先（稳定 tie-break 回到既有序——merged 现序或用户排序）
+    const afterSort = opts.sort ? sortEntries(filtered, opts.sort) : filtered;
+    const ordered = terms.length > 0
+        ? afterSort
+            .map((entry, idx) => ({ entry, score: relevanceScore(entry, terms), idx }))
+            .sort((a, b) => b.score - a.score || a.idx - b.idx)
+            .map((s) => s.entry)
+        : afterSort;
+    const total = ordered.length;
     const limit = clampLimit(opts.limit, maxLimit);
     let offset = normalizeOffset(opts.offset);
     if (total > 0 && offset >= total)
         offset = Math.floor((total - 1) / limit) * limit;
-    const items = filtered.slice(offset, offset + limit).map((entry) => toMarketItem(entry, installedItems));
+    const items = ordered.slice(offset, offset + limit).map((entry) => toMarketItem(entry, installedItems));
     let latestComplete = true;
     let latestTimedOut = false;
     if (withLatest && items.length > 0) {
@@ -617,13 +714,17 @@ async function probeLatest(items, ctx, d, rt) {
             item.outdated = !item.spec.includes(item.latestSha);
     });
 }
-/** 从 registry 收录条目安装（npm → 精确锁定最新版；github → 锁 HEAD SHA）。 */
+/** 从 registry 收录条目安装（npm → 精确锁定最新版；github → 锁 HEAD SHA）。
+ *  0.7.1 修复：合并市场展示的社区条目 id 不在主清单（loadRegistry 只装载主清单，
+ *  社区层只合入 listMarket 展示）——主清单 miss 时按收录 id 查社区目录再装，
+ *  与 0.5.1 升级路径（findCommunityUpgradeEntry）同构。 */
 export async function installFromRegistry(id, cfg = {}, opts = {}, deps) {
     const loaded = await (deps?.loadRegistry ?? defaultLoadRegistry)(cfg, { namespace: opts.namespace ?? 'host' });
     if (loaded.status === 'unavailable') {
         throw new Error(`收录清单不可用，无法安装 ${id}；请检查 registry 配置或网络后重试`);
     }
-    const entry = loaded.registry.plugins.find((e) => e.id === id);
+    const entry = loaded.registry.plugins.find((e) => e.id === id) ??
+        (await findCommunityInstallEntry(id, cfg, opts, deps));
     if (!entry)
         throw new Error(`registry 中没有该条目: ${id}`);
     return installEntry(entry, cfg, opts, deps);
@@ -1185,6 +1286,22 @@ async function upgradePluginLocked(pkg, cfg = {}, opts = {}, deps) {
     const result = await installEntryLocked(entry, cfg, opts, deps);
     return { ...result, fromVersion: target.version };
 }
+/**
+ * 社区条目按收录 id 查找（0.7.1 安装修复）：合并市场展示的社区条目 id = 社区目录合成 id
+ * （owner--name 等），主清单 miss 时按同一 id 查社区目录。社区清单未启用/不可用/加载
+ * 异常/未命中 → undefined，由调用方统一报「registry 中没有该条目」。
+ */
+async function findCommunityInstallEntry(id, cfg, opts, deps) {
+    try {
+        const loaded = await (deps?.fetchCommunityCatalog ?? defaultFetchCommunityCatalog)(cfg, { namespace: opts.namespace ?? 'host', signal: opts.signal });
+        if (!loaded.catalog)
+            return undefined;
+        return adaptCommunityCatalog(loaded.catalog).entries.find((e) => e.id === id);
+    }
+    catch {
+        return undefined;
+    }
+}
 /**
  * 社区条目升级查找（0.5.1）：主清单 miss 时按同一 matchInstalledByEntry 语义查社区目录。
  * 社区清单未启用/不可用/加载异常/未命中 → undefined，由调用方统一报「不是经 dsh-m 收录」。

package/lib/core/registry-controller.js

@@ -310,6 +310,32 @@ export function createRegistryController(initial = {}) {
             return snapshotInternal();
         });
     }
+    function setCommunity(enabled) {
+        // 同步先启动 bootstrap（只创建不等待）：它先于本任务入队，任务内再 await 即安全——
+        // 若在任务内 await startBootstrap() 会自我死锁（bootstrap 排在本任务之后永远轮不到）
+        if (!bootstrapPromise)
+            startBootstrap();
+        return enqueue(async (gen) => {
+            // 等初始同步完成：bootstrap 的 syncCommunityFields 会按 source 重写社区字段，
+            // 开关若抢在它前面写入会被覆盖（时序隐患，0.7.9 测试暴露于 0.8.0）
+            await bootstrapPromise;
+            const prev = config.communityCatalog;
+            // 内存先行（live 生效：listMarket 立即跳过社区层）；持久化失败回滚内存值
+            config.communityCatalog = enabled;
+            if (store) {
+                try {
+                    await store.update({ communityCatalog: enabled });
+                }
+                catch (err) {
+                    if (disposed || gen !== generation)
+                        return snapshotInternal();
+                    config.communityCatalog = prev;
+                    throw new RegistryConfigError(`写入设置失败：${errorMessage(err)}`, [errorMessage(err)]);
+                }
+            }
+            return snapshotInternal();
+        });
+    }
     function dispose() {
         disposed = true;
         unwatch?.();
@@ -323,6 +349,7 @@ export function createRegistryController(initial = {}) {
         snapshot,
         loadDefault,
         apply,
+        setCommunity,
         dispose,
     };
     return controller;

package/lib/core/search-relevance.js

@@ -0,0 +1,110 @@
+/**
+ * 搜索相关性管线（0.7.0 Task 3 / DESIGN.md §2.6「搜索：相关性加权管线」）：
+ * NFKC 归一化 + 中西文边界插空格 + 标点归空格 → 分词 → 字段加权评分。
+ *
+ * - id 为单列最高优先：normalized id 与整条 query 精确相等 → ID_EXACT_SCORE（收藏 stale 检测
+ *   依赖此语义，豁免「多词同字段全命中」约束）；
+ * - 字段权重：name/npm 700 · owner 400 · 首选描述 280 · 次选描述 240 · 分类 180 · tags 150
+ *   （tags 为 dsh-m 主清单召回保留——dsh-market 目录无 tags 概念，主清单 tags 有文案标准）；
+ * - 命中类型加分：精确 +300 / 前缀 +250 / 包含 +200 / 多词全命中 +150；
+ *   多词要求**同字段全命中**，否则该字段 0 分；
+ * - 按条目 WeakMap memoize 归一化字段串——4,400+ 条 × 每次搜索请求全量归一化的性能护栏
+ *   （条目对象随每次 adapt 重建，缓存随条目代际自然失效，无陈旧风险）。
+ */
+/** id 整串精确匹配得分：恒高于一切字段组合分，保证排首且必命中。 */
+export const ID_EXACT_SCORE = 10_000;
+const W_NAME = 700;
+const W_OWNER = 400;
+const W_DESC = 280;
+const W_DESC_EN = 240;
+const W_CATEGORY = 180;
+const W_TAGS = 150;
+const B_EXACT = 300;
+const B_PREFIX = 250;
+const B_CONTAINS = 200;
+const B_MULTI = 150;
+const CJK_RE = /[\u3400-\u4dbf\u4e00-\u9fff\uf900-\ufaff]/;
+const WORD_RE = /[\p{L}\p{N}]/u;
+/** 归一化：NFKC + 小写 + 中西文边界插空格（`MCP管理` ≈ `MCP 管理`）+ 标点/符号/空白归单空格。 */
+export function normalizeSearchText(input) {
+    const nfk = input.normalize('NFKC').toLowerCase();
+    let out = '';
+    for (let i = 0; i < nfk.length; i++) {
+        const ch = nfk[i];
+        if (i > 0) {
+            const prev = nfk[i - 1];
+            if (WORD_RE.test(ch) && WORD_RE.test(prev) && CJK_RE.test(ch) !== CJK_RE.test(prev))
+                out += ' ';
+        }
+        out += ch;
+    }
+    return out.replace(/[^\p{L}\p{N}]+/gu, ' ').trim();
+}
+/** 分词（输入应为 normalizeSearchText 产物）。 */
+export function tokenizeSearchText(normalized) {
+    return normalized.split(/\s+/).filter((t) => t !== '');
+}
+/** 多段字段（如 tags）归一化为单空格连接的 token 串。 */
+function fieldText(parts) {
+    return parts
+        .filter((p) => typeof p === 'string' && p.trim() !== '')
+        .map((p) => normalizeSearchText(p))
+        .filter((p) => p !== '')
+        .join(' ');
+}
+const fieldsCache = new WeakMap();
+function fieldsOf(entry) {
+    const cached = fieldsCache.get(entry);
+    if (cached)
+        return cached;
+    const fields = [
+        { text: fieldText([entry.name]), weight: W_NAME },
+        ...(entry.npm !== undefined ? [{ text: fieldText([entry.npm]), weight: W_NAME }] : []),
+        ...(entry.owner !== undefined ? [{ text: fieldText([entry.owner]), weight: W_OWNER }] : []),
+        { text: fieldText([entry.description]), weight: W_DESC },
+        ...(entry.descriptionEn !== undefined ? [{ text: fieldText([entry.descriptionEn]), weight: W_DESC_EN }] : []),
+        { text: fieldText([entry.category]), weight: W_CATEGORY },
+        ...(entry.tags !== undefined && entry.tags.length > 0 ? [{ text: fieldText(entry.tags), weight: W_TAGS }] : []),
+    ];
+    const value = { id: fieldText([entry.id]), fields };
+    fieldsCache.set(entry, value);
+    return value;
+}
+function hitBonus(field, term) {
+    if (field === term)
+        return B_EXACT;
+    if (field.startsWith(term))
+        return B_PREFIX;
+    if (field.includes(term))
+        return B_CONTAINS;
+    return 0;
+}
+/** 单字段评分：全部词命中才得分（取最弱命中类型 + 多词加成）；任一词未命中 → 0。 */
+function scoreField(text, weight, terms) {
+    if (text === '')
+        return 0;
+    let min = Number.POSITIVE_INFINITY;
+    for (const term of terms) {
+        const b = hitBonus(text, term);
+        if (b === 0)
+            return 0;
+        if (b < min)
+            min = b;
+    }
+    return weight + min + (terms.length > 1 ? B_MULTI : 0);
+}
+/** 相关性评分（>0 = 命中）：id 整串精确匹配最高优先且豁免多词约束；否则取各字段最大分。 */
+export function relevanceScore(entry, terms) {
+    if (terms.length === 0)
+        return 0;
+    const f = fieldsOf(entry);
+    if (f.id !== '' && f.id === terms.join(' '))
+        return ID_EXACT_SCORE;
+    let best = 0;
+    for (const field of f.fields) {
+        const s = scoreField(field.text, field.weight, terms);
+        if (s > best)
+            best = s;
+    }
+    return best;
+}