dsh-search-enhance 0.1.2 → 0.1.4

package/README.md

@@ -142,6 +142,8 @@ dsh web
 
 在“补充 Provider”中填写服务地址，在“凭据”中填写对应密钥。没有配置的服务会被跳过，不影响已经配置好的搜索来源。
 
+Tavily 和 Firecrawl 参与普通搜索的数量由“每次搜索的补充来源数量”控制，默认值为 `0`，不会自动发起补充搜索。需要时按搜索类型显式设置非零数量；只配置了其中一个服务时，该服务获得全部数量。
+
 ### 3. 配置搜索方式
 
 页面可以设置默认搜索类型和搜索深度：
@@ -152,6 +154,8 @@ dsh web
 
 不确定时保持默认值即可，也可以在单次搜索中临时选择其他设置。
 
+同一页面还可以设置“每次搜索的补充来源数量”，逐个搜索类型控制 Tavily/Firecrawl 的补充数量。
+
 “工具披露模式”建议保持 `progressive`，让延迟 operation 按需披露并从下一模型 step 激活；`all` 只让所有延迟 operation 从一开始处于 active 状态。两种模式都保留同一组五个模型工具及相同 schema，不会显示额外的独立工具。
 
 ### 4. 配置网页代理

package/client/client.js

@@ -20,11 +20,26 @@ window.__ModuleLoader__.load({
 			"tavily",
 			"firecrawl"
 		];
+		/**
+		* Search profiles that carry an editable supplementary discovery budget. The
+		* list is spelled here rather than imported: this contract is also the browser
+		* half, and a client module must not depend on the Host configuration module.
+		* The Host contract test keeps this list aligned with the configuration schema.
+		*/
+		const WEB_EXTRA_DISCOVERY_PROFILES = [
+			"auto",
+			"coding_docs",
+			"code_examples",
+			"project_research",
+			"academic",
+			"fact_check"
+		];
 		const WEB_EDITABLE_PATHS = [
 			["defaultProfile"],
 			["defaultDepth"],
 			["toolTimeoutMs"],
 			["toolDiscovery", "mode"],
+			...WEB_EXTRA_DISCOVERY_PROFILES.map((profile) => ["extraDiscoverySources", profile]),
 			["searchApi", "baseUrl"],
 			["searchApi", "protocol"],
 			["searchApi", "model"],
@@ -401,6 +416,7 @@ window.__ModuleLoader__.load({
 				defaultDepth: config.defaultDepth,
 				toolTimeoutMs: config.toolTimeoutMs,
 				toolDiscovery: { ...config.toolDiscovery },
+				extraDiscoverySources: { ...config.extraDiscoverySources },
 				searchApi: { ...config.searchApi },
 				providers: {
 					context7: { ...config.providers.context7 },
@@ -450,6 +466,12 @@ window.__ModuleLoader__.load({
 				...PROVIDERS.map((provider) => config.providers[provider].timeoutMs)
 			].every(positiveInteger);
 		}
+		function validExtraDiscoverySources(config, maximum) {
+			return WEB_EXTRA_DISCOVERY_PROFILES.every((profile) => {
+				const value = config.extraDiscoverySources[profile];
+				return Number.isInteger(value) && value >= 0 && value <= maximum;
+			});
+		}
 		function credentialRef(config, slot) {
 			return slot === "searchApi" ? config.searchApi.credentialRef : config.providers[slot].credentialRef;
 		}
@@ -489,12 +511,13 @@ window.__ModuleLoader__.load({
 				}, option))
 			});
 		}
-		function NumberInput({ value, onChange, disabled, label }) {
+		function NumberInput({ value, onChange, disabled, label, min = 1, max }) {
 			return /* @__PURE__ */ (0, react_jsx_runtime.jsx)("input", {
 				"aria-label": label,
 				style: controlStyle,
 				type: "number",
-				min: 1,
+				min,
+				max,
 				step: 1,
 				value: Number.isFinite(value) ? value : "",
 				disabled,
@@ -617,7 +640,7 @@ window.__ModuleLoader__.load({
 			]);
 			const mutations = (0, react.useMemo)(() => snapshot === void 0 || draft === void 0 ? [] : mutationsFor(snapshot.value, draft), [draft, snapshot]);
 			const dirty = mutations.length > 0;
-			const valid = draft !== void 0 && validTimeouts(draft);
+			const valid = draft !== void 0 && snapshot !== void 0 && validTimeouts(draft) && validExtraDiscoverySources(draft, snapshot.options.extraDiscoveryMaxSources);
 			const editable = phase === "ready" && snapshot?.writable === true && !saving;
 			const updateProvider = (provider, value) => {
 				setDraft((current) => current === void 0 ? current : {
@@ -629,6 +652,16 @@ window.__ModuleLoader__.load({
 				});
 				setFeedback("idle");
 			};
+			const updateExtraDiscovery = (profile, value) => {
+				setDraft((current) => current === void 0 ? current : {
+					...current,
+					extraDiscoverySources: {
+						...current.extraDiscoverySources,
+						[profile]: value
+					}
+				});
+				setFeedback("idle");
+			};
 			const updateProxy = (route, proxyUrl) => {
 				setDraft((current) => current === void 0 ? current : {
 					...current,
@@ -1007,6 +1040,38 @@ window.__ModuleLoader__.load({
 									]
 								})]
 							}),
+							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
+								style: sectionDividerStyle,
+								"aria-labelledby": "search-enhance-extra-sources-heading",
+								children: [/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("div", { children: [/* @__PURE__ */ (0, react_jsx_runtime.jsx)("h3", {
+									id: "search-enhance-extra-sources-heading",
+									style: headingStyle,
+									children: t("extraSourcesHeading")
+								}), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("p", {
+									style: {
+										...bodyStyle,
+										marginTop: 4
+									},
+									children: t("extraSourcesIntro")
+								})] }), /* @__PURE__ */ (0, react_jsx_runtime.jsx)("div", {
+									style: gridStyle,
+									children: WEB_EXTRA_DISCOVERY_PROFILES.map((profile) => /* @__PURE__ */ (0, react_jsx_runtime.jsx)(Field, {
+										label: profile,
+										overridden: isOverridden(snapshot.user, ["extraDiscoverySources", profile]),
+										t,
+										children: /* @__PURE__ */ (0, react_jsx_runtime.jsx)(NumberInput, {
+											label: `${t("extraSourcesHeading")} ${profile}`,
+											value: draft.extraDiscoverySources[profile],
+											min: 0,
+											max: snapshot.options.extraDiscoveryMaxSources,
+											disabled: !editable,
+											onChange: (value) => {
+												updateExtraDiscovery(profile, value);
+											}
+										})
+									}, profile))
+								})]
+							}),
 							/* @__PURE__ */ (0, react_jsx_runtime.jsxs)("section", {
 								style: sectionDividerStyle,
 								"aria-labelledby": "search-enhance-providers-heading",
@@ -1324,6 +1389,8 @@ window.__ModuleLoader__.load({
 			defaultDepth: "Default depth",
 			toolDiscoveryMode: "Tool discovery",
 			toolTimeoutMs: "Whole tool timeout (ms)",
+			extraSourcesHeading: "Supplementary sources per search",
+			extraSourcesIntro: "How many extra Tavily/Firecrawl sources one search may collect for each profile. 0 disables supplementary search for that profile; an unconfigured provider is skipped without a request.",
 			providersHeading: "Supplemental providers",
 			providersIntro: "Endpoints and timeouts for documentation, fallback discovery, extraction, and site mapping.",
 			providersSummary: "Advanced provider settings",
@@ -1369,7 +1436,7 @@ window.__ModuleLoader__.load({
 			conflict: "The Settings document changed elsewhere. Reload before saving again.",
 			saveFailed: "The configuration could not be saved.",
 			readOnly: "The Settings document is read-only.",
-			invalidNumber: "Timeouts must be positive whole numbers.",
+			invalidNumber: "Timeouts must be positive whole numbers, and supplementary source counts must be whole numbers within their allowed range.",
 			overridden: "User override",
 			inherited: "Inherited"
 		};
@@ -1397,6 +1464,8 @@ window.__ModuleLoader__.load({
 			defaultDepth: "默认深度",
 			toolDiscoveryMode: "工具披露模式",
 			toolTimeoutMs: "工具总超时（毫秒）",
+			extraSourcesHeading: "每次搜索的补充来源数量",
+			extraSourcesIntro: "每个 profile 单次搜索最多补充多少条 Tavily/Firecrawl 来源。填 0 表示该 profile 不做补充搜索；未配置密钥的 Provider 会直接跳过、不发请求。",
 			providersHeading: "补充 Provider",
 			providersIntro: "配置文档检索、补充发现、网页提取与站点映射所用的端点和超时。",
 			providersSummary: "高级 Provider 设置",
@@ -1442,7 +1511,7 @@ window.__ModuleLoader__.load({
 			conflict: "Settings 已在其他位置发生变化。请重新读取后再保存。",
 			saveFailed: "无法保存配置。",
 			readOnly: "Settings 文档为只读。",
-			invalidNumber: "超时必须是正整数。",
+			invalidNumber: "超时必须是正整数；补充来源数量必须是允许范围内的整数。",
 			overridden: "用户覆盖",
 			inherited: "继承值"
 		};

package/client/types/client/locales.d.ts

@@ -22,6 +22,8 @@ export declare const en: {
     readonly defaultDepth: "Default depth";
     readonly toolDiscoveryMode: "Tool discovery";
     readonly toolTimeoutMs: "Whole tool timeout (ms)";
+    readonly extraSourcesHeading: "Supplementary sources per search";
+    readonly extraSourcesIntro: "How many extra Tavily/Firecrawl sources one search may collect for each profile. 0 disables supplementary search for that profile; an unconfigured provider is skipped without a request.";
     readonly providersHeading: "Supplemental providers";
     readonly providersIntro: "Endpoints and timeouts for documentation, fallback discovery, extraction, and site mapping.";
     readonly providersSummary: "Advanced provider settings";
@@ -67,7 +69,7 @@ export declare const en: {
     readonly conflict: "The Settings document changed elsewhere. Reload before saving again.";
     readonly saveFailed: "The configuration could not be saved.";
     readonly readOnly: "The Settings document is read-only.";
-    readonly invalidNumber: "Timeouts must be positive whole numbers.";
+    readonly invalidNumber: "Timeouts must be positive whole numbers, and supplementary source counts must be whole numbers within their allowed range.";
     readonly overridden: "User override";
     readonly inherited: "Inherited";
 };

package/client/types/web-config/contracts.d.ts

@@ -6,7 +6,16 @@ export declare const WEB_CREDENTIAL_REF_MAX_CHARACTERS = 256;
 export declare const WEB_CREDENTIAL_VALUE_MAX_CHARACTERS: number;
 export declare const WEB_CREDENTIAL_SLOTS: readonly ["searchApi", "context7", "exa", "tavily", "firecrawl"];
 export type WebCredentialSlot = (typeof WEB_CREDENTIAL_SLOTS)[number];
-export declare const WEB_EDITABLE_PATHS: readonly [readonly ["defaultProfile"], readonly ["defaultDepth"], readonly ["toolTimeoutMs"], readonly ["toolDiscovery", "mode"], readonly ["searchApi", "baseUrl"], readonly ["searchApi", "protocol"], readonly ["searchApi", "model"], readonly ["searchApi", "thinkingLevel"], readonly ["searchApi", "credentialRef"], readonly ["searchApi", "timeoutMs"], readonly ["providers", "context7", "baseUrl"], readonly ["providers", "context7", "credentialRef"], readonly ["providers", "context7", "timeoutMs"], readonly ["providers", "exa", "baseUrl"], readonly ["providers", "exa", "credentialRef"], readonly ["providers", "exa", "timeoutMs"], readonly ["providers", "tavily", "baseUrl"], readonly ["providers", "tavily", "credentialRef"], readonly ["providers", "tavily", "timeoutMs"], readonly ["providers", "firecrawl", "baseUrl"], readonly ["providers", "firecrawl", "credentialRef"], readonly ["providers", "firecrawl", "timeoutMs"], readonly ["webExtract", "smartDirect", "proxyUrl"], readonly ["webExtract", "direct", "proxyUrl"]];
+/**
+ * Search profiles that carry an editable supplementary discovery budget. The
+ * list is spelled here rather than imported: this contract is also the browser
+ * half, and a client module must not depend on the Host configuration module.
+ * The Host contract test keeps this list aligned with the configuration schema.
+ */
+export declare const WEB_EXTRA_DISCOVERY_PROFILES: readonly ["auto", "coding_docs", "code_examples", "project_research", "academic", "fact_check"];
+export type WebExtraDiscoveryProfile = (typeof WEB_EXTRA_DISCOVERY_PROFILES)[number];
+export type WebExtraDiscoverySources = Record<WebExtraDiscoveryProfile, number>;
+export declare const WEB_EDITABLE_PATHS: readonly (readonly string[])[];
 export interface WebSearchApiConfig {
     baseUrl: string;
     protocol: string;
@@ -30,6 +39,7 @@ export interface WebEditableConfig {
     toolDiscovery: {
         mode: string;
     };
+    extraDiscoverySources: WebExtraDiscoverySources;
     searchApi: WebSearchApiConfig;
     providers: {
         context7: WebDiscoveryProviderConfig;
@@ -56,6 +66,7 @@ export interface WebConfigOptions {
     thinkingLevels: readonly string[];
     toolDiscoveryModes: readonly string[];
     proxyUrlMaxCharacters: number;
+    extraDiscoveryMaxSources: number;
 }
 export interface WebCredentialState {
     ref: string;

package/lib/config.d.ts

@@ -307,6 +307,8 @@ export interface Config {
 }
 export declare const DEFAULT_CREDENTIAL_REFS: CredentialReferences;
 export declare const DEFAULT_SEARCH_BUDGETS: SearchBudgets;
+/** Deployment ceiling for one profile's supplementary discovery-source budget. */
+export declare const EXTRA_DISCOVERY_SOURCES_MAX = 100;
 export declare const SEARCH_ENHANCE_SETTINGS_NAMESPACE: import("@deepseek-ai/dsh-settings").SettingsNamespace;
 export declare function validateWebExtractProxyUrl(value: string): string;
 export declare const Config: Schema<Config>;

package/lib/config.js

@@ -77,6 +77,8 @@ export const DEFAULT_SEARCH_BUDGETS = {
         deep: { maxAnswerCharacters: 22000, maxVisibleSources: 28, maxModelTextBytes: 36 * 1024 },
     },
 };
+/** Deployment ceiling for one profile's supplementary discovery-source budget. */
+export const EXTRA_DISCOVERY_SOURCES_MAX = 100;
 export const SEARCH_ENHANCE_SETTINGS_NAMESPACE = settingsNamespace('search-enhance');
 const httpUrl = (defaultValue) => Schema.string()
     .pattern(/^https?:\/\/(?![^/\s?#]*@)[^\s?#]+\/?$/)
@@ -174,12 +176,12 @@ export const Config = Schema.object({
         fact_check: profileBudgets('fact_check'),
     }),
     extraDiscoverySources: Schema.object({
-        auto: nonNegativeInteger(0, 100),
-        coding_docs: nonNegativeInteger(0, 100),
-        code_examples: nonNegativeInteger(0, 100),
-        project_research: nonNegativeInteger(0, 100),
-        academic: nonNegativeInteger(0, 100),
-        fact_check: nonNegativeInteger(0, 100),
+        auto: nonNegativeInteger(0, EXTRA_DISCOVERY_SOURCES_MAX),
+        coding_docs: nonNegativeInteger(0, EXTRA_DISCOVERY_SOURCES_MAX),
+        code_examples: nonNegativeInteger(0, EXTRA_DISCOVERY_SOURCES_MAX),
+        project_research: nonNegativeInteger(0, EXTRA_DISCOVERY_SOURCES_MAX),
+        academic: nonNegativeInteger(0, EXTRA_DISCOVERY_SOURCES_MAX),
+        fact_check: nonNegativeInteger(0, EXTRA_DISCOVERY_SOURCES_MAX),
     }),
     retention: Schema.object({
         searchQueryMaxCharacters: positiveInteger(32_000, 1_000_000),

package/lib/documentation/service.d.ts

@@ -2,7 +2,7 @@ import { Service, type Context } from '@deepseek-ai/cordis';
 import type { Config } from '../config.js';
 import type { CanonicalSource, SourceRecordCandidate } from '../contracts/index.js';
 import { type ProviderAttemptRecord, type ProviderErrorKind } from '../provider-runtime/index.js';
-import { Context7RemoteClient, type Context7Library } from '../providers/context7.js';
+import { type Context7RemoteClient, type Context7Library } from '../providers/context7.js';
 import type { BoundedSourceProvider, DocumentationSnippet, SourceProviderSearchInput, SourceProviderSearchOutcome } from '../providers/types.js';
 import type { Context7DocsCacheEntry, Context7DocRef } from './cache-domain.js';
 import { type Context7CachedDocLookup, type Context7CachedDocMatch } from './cache.js';
@@ -125,7 +125,7 @@ export declare class DocumentationSearchInfrastructureError extends Error {
     constructor(attempts: readonly ProviderAttemptRecord[], warnings: readonly DocumentationWarning[], cache: Readonly<DocumentationCacheReport>, cause: unknown);
 }
 export interface DocumentationSearchDependencies {
-    readonly context7: Context7RemoteClient;
+    readonly context7: Pick<Context7RemoteClient, 'resolve' | 'docs'>;
     readonly context7Cache: Context7CachedOperations;
     readonly exa: BoundedSourceProvider;
     readonly getConfig: () => Config;

package/lib/documentation/service.js

@@ -1,10 +1,11 @@
 import { Service } from '@deepseek-ai/cordis';
 import { createProviderAttemptRecord, isAbortError, isProviderError, ProviderError, throwIfAborted, } from '../provider-runtime/index.js';
 import { boundSourceProviderResult } from '../providers/bounded-result.js';
-import { Context7RemoteClient, context7LibrarySource, selectContext7Library, } from '../providers/context7.js';
+import { context7LibrarySource, selectContext7Library, } from '../providers/context7.js';
 import { applySourceQuality } from '../search/index.js';
 import { CONTEXT7_CACHE_QUERY_MAX_SCAN_RECORDS, } from './cache.js';
 import { CONTEXT7_CACHE_STATES, Context7CachedOperations, Context7OperationFailure, isContext7LibraryId, normalizeContext7LibraryId, } from './context7-cache.js';
+const CONTEXT7_RESOLVE_CANDIDATE_LIMIT = 30;
 export const DOCUMENTATION_SEARCH_SERVICE_KEY = 'searchEnhanceDocumentation';
 export const DOCUMENTATION_SEARCH_PROVIDERS = ['auto', 'context7', 'exa', 'all'];
 export const DOCUMENTATION_RESULT_PROVIDERS = ['context7', 'exa'];
@@ -347,6 +348,7 @@ export class DocumentationSearchService extends Service {
         await Promise.allSettled([...this.active]);
     }
     async executeContext7Resolve(input) {
+        const candidateLimit = input.candidateLimit ?? input.maxResults;
         const startedAt = safeClockValue(this.now);
         let dispatches = 0;
         const resolved = await this.context7Cache.resolve({
@@ -354,7 +356,7 @@ export class DocumentationSearchService extends Service {
             forceRefresh: input.forceRefresh,
             load: () => this.context7.resolve({
                 config: input.config,
-                limit: input.maxResults,
+                limit: candidateLimit,
                 onDispatch: () => {
                     dispatches += 1;
                     input.onDispatch?.();
@@ -362,12 +364,12 @@ export class DocumentationSearchService extends Service {
                 query: input.libraryName,
                 signal: input.signal,
             }),
-            maxResults: input.maxResults,
+            maxResults: candidateLimit,
             query: input.libraryName,
             signal: input.signal,
         });
-        const candidates = Object.freeze([...resolved.entry.libraries]);
-        const selected = selectContext7Library(candidates, input.libraryName, input.query);
+        const candidates = Object.freeze(resolved.entry.libraries.slice(0, input.maxResults));
+        const selected = selectContext7Library(resolved.entry.libraries, input.libraryName, input.query);
         return Object.freeze({
             attempts: successfulCacheAttempts('resolve', resolved, dispatches, elapsed(startedAt, this.now)),
             cache: cachePath(resolved.cache, resolved.evictedEntries),
@@ -638,6 +640,7 @@ export class DocumentationSearchService extends Service {
                     forceRefresh: input.forceRefresh,
                     libraryName: input.query,
                     maxResults: input.maxResults,
+                    candidateLimit: Math.min(CONTEXT7_RESOLVE_CANDIDATE_LIMIT, input.config.retention.providerMaxSources),
                     onDispatch: () => { resolveDispatches += 1; },
                     query: input.query,
                     signal: input.signal,

package/lib/index.js

@@ -22,8 +22,7 @@ export const name = 'search-enhance';
 export const inject = ['agents', 'credentials', 'settings', 'storageDomain', 'systemPrompt', 'tools'];
 export const Config = SearchEnhanceConfig;
 export async function apply(ctx, config) {
-    const settings = ctx.settings.register(SEARCH_ENHANCE_SETTINGS_NAMESPACE, SearchEnhanceConfig, { applies: 'restart', base: config });
-    const effective = settings.get();
+    const effective = ctx.settings.register(SEARCH_ENHANCE_SETTINGS_NAMESPACE, SearchEnhanceConfig, { applies: 'restart', base: config }).get();
     const domain = await ctx.storageDomain.open(SOURCE_RECORD_DOMAIN_SPEC);
     const store = new SourceRecordStore(domain.table(SOURCE_RECORD_TABLE_NAME), {
         maxBytes: effective.retention.sourceEventMaxBytes,
@@ -34,7 +33,10 @@ export async function apply(ctx, config) {
         maxSnippetCharacters: effective.retention.searchSourcesSnippetMaxCharacters,
     });
     const operations = new ForegroundOperationScope();
-    const getConfig = () => settings.get();
+    // This namespace applies on restart, so every consumer reads the one value
+    // resolved here. Reading Settings live would make some fields take effect
+    // immediately while constructor-bound limits waited for a restart.
+    const getConfig = () => effective;
     const providerDependencies = { credentials: ctx.credentials };
     const context7Cache = new PersistentContext7Cache(ctx.storageDomain, {
         maxEntries: effective.cache.maxEntries,

package/lib/providers/context7.js

@@ -121,17 +121,33 @@ export function parseContext7Libraries(body) {
 function normalizedMatchText(value) {
     return (value ?? '').toLowerCase().replace(/^@/, '').replace(/[^a-z0-9]+/g, '');
 }
-function context7LibraryScore(item, libraryName, query) {
+function normalizedTerms(value) {
+    return value.toLowerCase()
+        .split(/[^a-z0-9@._-]+/)
+        .map(normalizedMatchText)
+        .filter(term => term.length > 0);
+}
+function queryMentionsName(queryTerms, value) {
+    const nameTerms = normalizedTerms(value ?? '');
+    if (nameTerms.length === 0)
+        return false;
+    return queryTerms.some((_term, index) => nameTerms.every((nameTerm, offset) => queryTerms[index + offset] === nameTerm));
+}
+function context7LibraryScore(item, libraryName, queryTerms) {
     const wanted = normalizedMatchText(libraryName);
     const rawText = `${item.id ?? ''} ${item.title ?? ''} ${item.description ?? ''}`.toLowerCase();
     const title = normalizedMatchText(item.title);
     const description = normalizedMatchText(item.description);
     const idSegments = (item.id ?? '').split('/').filter(Boolean).map(normalizedMatchText);
     let score = 0;
-    if (/official.*documentation|documentation.*official|official docs|react\.dev/.test(rawText))
+    if (queryMentionsName(queryTerms, item.title))
+        score += 240;
+    for (const segment of (item.id ?? '').split('/').filter(Boolean)) {
+        if (queryMentionsName(queryTerms, segment))
+            score += 220;
+    }
+    if (/official.*documentation|documentation.*official|official docs/.test(rawText))
         score += 260;
-    if (rawText.includes('react.dev'))
-        score += 120;
     if (wanted.length > 0) {
         if (title === wanted)
             score += 240;
@@ -146,9 +162,8 @@ function context7LibraryScore(item, libraryName, query) {
         if (description.includes(wanted))
             score += 8;
     }
-    for (const term of query.toLowerCase().split(/[^a-z0-9@.\-/]+/).filter(term => term.length > 1)) {
-        const normalizedTerm = normalizedMatchText(term);
-        if (normalizedTerm.length === 0)
+    for (const normalizedTerm of queryTerms) {
+        if (normalizedTerm.length <= 1)
             continue;
         if (title === normalizedTerm)
             score += 24;
@@ -174,11 +189,12 @@ function context7LibraryScore(item, libraryName, query) {
 }
 /** Stable selection by exact name, description relevance, trust, benchmark, and snippet coverage. */
 export function selectContext7Library(libraries, libraryName, query = libraryName) {
+    const queryTerms = normalizedTerms(query);
     return libraries
         .map((library, index) => ({
         index,
         library,
-        score: context7LibraryScore(library, libraryName, query),
+        score: context7LibraryScore(library, libraryName, queryTerms),
     }))
         .filter(candidate => isContext7LibraryId(candidate.library.id))
         .sort((left, right) => right.score - left.score || left.index - right.index)[0]?.library;

package/lib/search/parse.js

@@ -29,8 +29,7 @@ export const DEFAULT_SEARCH_RESPONSE_PARSE_LIMITS = Object.freeze({
     maxUrlCharacters: 8192,
 });
 const URL_PATTERN = /https?:\/\/[^\s<>"'`，。、；：！？》）】)]+/g;
-const MARKDOWN_LINK_PATTERN = /\[([^\]]+)]\((https?:\/\/[^)]+)\)/g;
-const MARKDOWN_LINK_LINE_PATTERN = /\[[^\]]+]\(https?:\/\/[^)]+\)/;
+const MARKDOWN_LINK_PATTERN = /(?<!\[)\[([^\[\]]+|\[\d+\])]\((https?:\/\/[^)]+)\)/g;
 const SOURCES_HEADING_PATTERN = /(?:^|\n)(?:#{1,6}\s*)?(?:\*\*|__)?\s*(?:sources?|references?|citations?|信源|参考资料|参考|引用|来源列表|来源)(?:\s*[（(][^)\n]*[)）])?\s*(?:(?:\*\*|__)\s*)?[:：]?\s*(?:(?:\*\*|__)\s*)?$/gim;
 const SOURCES_FUNCTION_PATTERN = /(^|\n)\s*(sources|source|citations|citation|references|reference|citation_card|source_cards|source_card)\s*\(/gim;
 function isRecord(value) {
@@ -152,7 +151,8 @@ export function extractMarkdownCitationUrls(text, maximumUrlCharacters = DEFAULT
 }
 function addTextSources(text, state, limits) {
     addMarkdownSources(text, state, limits);
-    for (const url of extractUrls(text))
+    const bareText = text.replace(MARKDOWN_LINK_PATTERN, ' ');
+    for (const url of extractUrls(bareText))
         addSource(state, { url }, limits);
 }
 function normalizeSourceItem(item, state, limits) {
@@ -336,7 +336,7 @@ function isLinkOnlyLine(line) {
     const stripped = line.replace(/^\s*(?:[-*]|\d+\.)\s*/, '').trim();
     return stripped.length > 0 && (stripped.startsWith('http://')
         || stripped.startsWith('https://')
-        || MARKDOWN_LINK_LINE_PATTERN.test(stripped));
+        || stripped.search(MARKDOWN_LINK_PATTERN) !== -1);
 }
 function splitTailLinkBlock(text, state, limits) {
     const lines = text.split(/\r?\n/);

package/lib/tools/context7.d.ts

@@ -1273,7 +1273,7 @@ export declare const CONTEXT7_GET_CACHED_DOC_RAW_OUTPUT_SCHEMA: {
     readonly additionalProperties: false;
 };
 export interface Context7ToolsDependencies {
-    /** Read and snapshot the current resolved Settings value once per operation. */
+    /** Read the restart-scoped resolved Settings value this plugin instance was loaded with. */
     readonly getConfig: () => Config;
     readonly documentation: Pick<DocumentationSearchService, 'resolveContext7' | 'queryContext7Docs' | 'lookupDoc' | 'findContext7Doc'>;
     readonly operations: ForegroundOperationScope;

package/lib/tools/docs-search.d.ts

@@ -5,7 +5,7 @@ import { type SearchEnhanceSourceService, type SourceRecordCommit } from '../sou
 import type { ForegroundOperationScope } from './operations.js';
 import { type DocsSearchOutput } from './schemas.js';
 export interface DocsSearchToolDependencies {
-    /** Read and snapshot the current resolved Settings value once per operation. */
+    /** Read the restart-scoped resolved Settings value this plugin instance was loaded with. */
     readonly getConfig: () => Config;
     readonly documentation: Pick<DocumentationSearchService, 'search'>;
     readonly operations: ForegroundOperationScope;

package/lib/tools/search-sources.d.ts

@@ -4,7 +4,7 @@ import { type SearchEnhanceSourceService, type SourcePageResult } from '../sourc
 import type { ForegroundOperationScope } from './operations.js';
 import { type SearchSourcesOutput } from './schemas.js';
 export interface SearchSourcesToolDependencies {
-    /** Read and snapshot the current resolved Settings value once per operation. */
+    /** Read the restart-scoped resolved Settings value this plugin instance was loaded with. */
     readonly getConfig: () => Config;
     readonly operations: ForegroundOperationScope;
     readonly sources: Pick<SearchEnhanceSourceService, 'page'>;

package/lib/tools/web-extract.d.ts

@@ -5,7 +5,7 @@ import { type WebExtractOrchestrator, type WebExtractResult, type WebExtractRout
 import type { ForegroundOperationScope } from './operations.js';
 import { type WebExtractOutput, type WebExtractOutputAttempt } from './schemas.js';
 export interface WebExtractToolDependencies {
-    /** Read and snapshot the current resolved Settings value once per operation. */
+    /** Read the restart-scoped resolved Settings value this plugin instance was loaded with. */
     readonly getConfig: () => Config;
     readonly operations: ForegroundOperationScope;
     readonly orchestrator: Pick<WebExtractOrchestrator, 'extract'>;

package/lib/tools/web-map.d.ts

@@ -4,7 +4,7 @@ import { type SiteMapProvider, type TavilyMapResult } from '../site-map/index.js
 import type { ForegroundOperationScope } from './operations.js';
 import { type WebMapOutput } from './schemas.js';
 export interface WebMapToolDependencies {
-    /** Read and snapshot the current resolved Settings value once per operation. */
+    /** Read the restart-scoped resolved Settings value this plugin instance was loaded with. */
     readonly getConfig: () => Config;
     readonly operations: ForegroundOperationScope;
     readonly provider: SiteMapProvider;

package/lib/tools/web-search.d.ts

@@ -6,7 +6,7 @@ import { type SearchEnhanceSourceService, type SourceRecordCommit } from '../sou
 import type { ForegroundOperationScope } from './operations.js';
 import { type WebSearchOutput } from './schemas.js';
 export interface WebSearchToolDependencies {
-    /** Read and snapshot the current resolved Settings value once per operation. */
+    /** Read the restart-scoped resolved Settings value this plugin instance was loaded with. */
     readonly getConfig: () => Config;
     readonly orchestrator: Pick<SearchOrchestrator, 'search'>;
     readonly operations: ForegroundOperationScope;

package/lib/web-config/contracts.d.ts

@@ -6,7 +6,16 @@ export declare const WEB_CREDENTIAL_REF_MAX_CHARACTERS = 256;
 export declare const WEB_CREDENTIAL_VALUE_MAX_CHARACTERS: number;
 export declare const WEB_CREDENTIAL_SLOTS: readonly ["searchApi", "context7", "exa", "tavily", "firecrawl"];
 export type WebCredentialSlot = (typeof WEB_CREDENTIAL_SLOTS)[number];
-export declare const WEB_EDITABLE_PATHS: readonly [readonly ["defaultProfile"], readonly ["defaultDepth"], readonly ["toolTimeoutMs"], readonly ["toolDiscovery", "mode"], readonly ["searchApi", "baseUrl"], readonly ["searchApi", "protocol"], readonly ["searchApi", "model"], readonly ["searchApi", "thinkingLevel"], readonly ["searchApi", "credentialRef"], readonly ["searchApi", "timeoutMs"], readonly ["providers", "context7", "baseUrl"], readonly ["providers", "context7", "credentialRef"], readonly ["providers", "context7", "timeoutMs"], readonly ["providers", "exa", "baseUrl"], readonly ["providers", "exa", "credentialRef"], readonly ["providers", "exa", "timeoutMs"], readonly ["providers", "tavily", "baseUrl"], readonly ["providers", "tavily", "credentialRef"], readonly ["providers", "tavily", "timeoutMs"], readonly ["providers", "firecrawl", "baseUrl"], readonly ["providers", "firecrawl", "credentialRef"], readonly ["providers", "firecrawl", "timeoutMs"], readonly ["webExtract", "smartDirect", "proxyUrl"], readonly ["webExtract", "direct", "proxyUrl"]];
+/**
+ * Search profiles that carry an editable supplementary discovery budget. The
+ * list is spelled here rather than imported: this contract is also the browser
+ * half, and a client module must not depend on the Host configuration module.
+ * The Host contract test keeps this list aligned with the configuration schema.
+ */
+export declare const WEB_EXTRA_DISCOVERY_PROFILES: readonly ["auto", "coding_docs", "code_examples", "project_research", "academic", "fact_check"];
+export type WebExtraDiscoveryProfile = (typeof WEB_EXTRA_DISCOVERY_PROFILES)[number];
+export type WebExtraDiscoverySources = Record<WebExtraDiscoveryProfile, number>;
+export declare const WEB_EDITABLE_PATHS: readonly (readonly string[])[];
 export interface WebSearchApiConfig {
     baseUrl: string;
     protocol: string;
@@ -30,6 +39,7 @@ export interface WebEditableConfig {
     toolDiscovery: {
         mode: string;
     };
+    extraDiscoverySources: WebExtraDiscoverySources;
     searchApi: WebSearchApiConfig;
     providers: {
         context7: WebDiscoveryProviderConfig;
@@ -56,6 +66,7 @@ export interface WebConfigOptions {
     thinkingLevels: readonly string[];
     toolDiscoveryModes: readonly string[];
     proxyUrlMaxCharacters: number;
+    extraDiscoveryMaxSources: number;
 }
 export interface WebCredentialState {
     ref: string;

package/lib/web-config/contracts.js

@@ -11,11 +11,26 @@ export const WEB_CREDENTIAL_SLOTS = [
     'tavily',
     'firecrawl',
 ];
+/**
+ * Search profiles that carry an editable supplementary discovery budget. The
+ * list is spelled here rather than imported: this contract is also the browser
+ * half, and a client module must not depend on the Host configuration module.
+ * The Host contract test keeps this list aligned with the configuration schema.
+ */
+export const WEB_EXTRA_DISCOVERY_PROFILES = [
+    'auto',
+    'coding_docs',
+    'code_examples',
+    'project_research',
+    'academic',
+    'fact_check',
+];
 export const WEB_EDITABLE_PATHS = [
     ['defaultProfile'],
     ['defaultDepth'],
     ['toolTimeoutMs'],
     ['toolDiscovery', 'mode'],
+    ...WEB_EXTRA_DISCOVERY_PROFILES.map(profile => ['extraDiscoverySources', profile]),
     ['searchApi', 'baseUrl'],
     ['searchApi', 'protocol'],
     ['searchApi', 'model'],

package/lib/web-config/host.js

@@ -1,11 +1,12 @@
 import Schema from '@deepseek-ai/schemastery';
-import { Config as SearchEnhanceConfig, SEARCH_API_PROTOCOLS, SEARCH_DEPTHS, SEARCH_ENHANCE_SETTINGS_NAMESPACE, SEARCH_PROFILES, THINKING_LEVELS, TOOL_DISCOVERY_MODES, WEB_EXTRACT_PROXY_URL_MAX_CHARACTERS, validateWebExtractProxyUrl, } from '../config.js';
+import { Config as SearchEnhanceConfig, EXTRA_DISCOVERY_SOURCES_MAX, SEARCH_API_PROTOCOLS, SEARCH_DEPTHS, SEARCH_ENHANCE_SETTINGS_NAMESPACE, SEARCH_PROFILES, THINKING_LEVELS, TOOL_DISCOVERY_MODES, WEB_EXTRACT_PROXY_URL_MAX_CHARACTERS, validateWebExtractProxyUrl, } from '../config.js';
 import { inspectDiagnosticStatus } from '../diagnostics/status.js';
 import { WEB_BASE_URL_MAX_CHARACTERS, WEB_CONFIG_PATH, WEB_CREDENTIAL_REF_MAX_CHARACTERS, WEB_CREDENTIAL_SLOTS, WEB_CREDENTIAL_VALUE_MAX_CHARACTERS, WEB_CREDENTIALS_PATH, WEB_EDITABLE_PATHS, WEB_MODEL_MAX_CHARACTERS, } from './contracts.js';
 export const WEB_CONFIG_REQUEST_MAX_BYTES = 64 * 1024;
 export const WEB_CONFIG_RESPONSE_MAX_BYTES = 128 * 1024;
 const MAX_CREDENTIAL_SOURCE_CHARACTERS = 128;
-const MAX_MUTATIONS = 32;
+/** One save may touch each editable field at most once. */
+const MAX_MUTATIONS = WEB_EDITABLE_PATHS.length;
 const FORWARDING_HEADERS = [
     'forwarded',
     'x-forwarded-for',
@@ -65,6 +66,7 @@ function projectConfig(config) {
         defaultDepth: config.defaultDepth,
         toolTimeoutMs: config.toolTimeoutMs,
         toolDiscovery: { mode: config.toolDiscovery.mode },
+        extraDiscoverySources: { ...config.extraDiscoverySources },
         searchApi: {
             baseUrl: boundedString(config.searchApi.baseUrl, WEB_BASE_URL_MAX_CHARACTERS, 'Grok base URL'),
             protocol: config.searchApi.protocol,
@@ -213,6 +215,7 @@ export async function readWebConfigSnapshot(ctx, signal) {
             thinkingLevels: [...THINKING_LEVELS],
             toolDiscoveryModes: [...TOOL_DISCOVERY_MODES],
             proxyUrlMaxCharacters: WEB_EXTRACT_PROXY_URL_MAX_CHARACTERS,
+            extraDiscoveryMaxSources: EXTRA_DISCOVERY_SOURCES_MAX,
         },
         credentials: Object.fromEntries(credentialEntries),
         diagnostics: {
@@ -527,6 +530,9 @@ async function currentConfig(ctx) {
     if (current === undefined) {
         throw new BridgeHttpError(503, 'settings-unavailable', 'Search Enhance settings are not available.');
     }
+    // The configuration surface reads Settings live on purpose: it must write a
+    // credential to the reference the user just saved, while the search plane keeps
+    // using the restart-scoped value its plugin instance loaded.
     // Settings owns schema validation and returns a deeply frozen resolved snapshot.
     // Re-running Schemastery here mutates optional fields and fails on that snapshot.
     return current;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-search-enhance",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "Bounded search, documentation, extraction, progressively disclosed site mapping/research planning, and read-only diagnostics for DeepSeek Harness",
   "type": "module",
   "main": "./lib/index.js",