@morlay/dsh-web-search-ollama 0.0.1-alpha.4 → 0.0.1-alpha.5

package/README.md

@@ -73,8 +73,8 @@ mock 全绿替代它——这个包的第一版就是"配置指到 Ollama 的 me
 
 ## 装配
 
-注册行由**本包的 bundle patch**（[`cordis.patch.yml`](./cordis.patch.yml)）插在 **host 层**；
-基础 bundle 的 `web` 行由 [`@morlay/dsh-profile`](../../profile/dsh-profile/README.md) 的配置层切到
+注册行由**本包的 bundle patch**（[`src/rows.ts`](./src/rows.ts)）插在 **host 层**；
+基础 bundle 的 `web` 行由 [`@morlay/dsh-profile`](../../bundles/sandbox-profile/README.md) 的配置层切到
 `ollama`——装配归本包、配置归 profile：
 
 ```yaml
@@ -98,4 +98,4 @@ mock 全绿替代它——这个包的第一版就是"配置指到 Ollama 的 me
 - **一次只选一个后端**：`ctx.web` 的 `searchProvider` 是单选，默认 `ollama`；
   `deepseek-official` 后端仍由基础 bundle 注册着，改写那一行即可切回（但它需要 `DEEPSEEK_API_KEY`）。
 - **不做设置页 section**：配置面就是那一行 patch（见
-  [dsh-profile 的设计记录](../../profile/dsh-profile/.agents/designs/20260917-host层部署配置.md)）。
+  [dsh-profile 的设计记录](../../bundles/ollama-provider-profile/README.md)）。

package/dist/client.cjs

@@ -0,0 +1,72 @@
+window.__ModuleLoader__.load({
+	id: "@morlay/dsh-web-search-ollama",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		//#region src/client/locales.ts
+		/** 本包在配置页上的字段文案（命名空间 `settings.web-search-ollama`）。 */
+		const zh = {
+			apiKey: "API key",
+			apiKeyHint: "字面值；能走凭证服务时优先用下面的引用名，别把密钥写进配置文件。",
+			apiKeyEnv: "凭证引用名",
+			apiKeyEnvHint: "每次搜索经凭证服务解析一次；默认 `OLLAMA_API_KEY`。",
+			baseURL: "端点",
+			baseURLHint: "端点根，`/api/web_search` 由 provider 拼；默认 https://ollama.com。",
+			maxResults: "默认结果数",
+			maxResultsHint: "请求没带结果数时用它；留空就是让 Ollama 用自己的默认。"
+		};
+		const en = {
+			apiKey: "API key",
+			apiKeyHint: "Literal value; prefer the credential reference below and never inline secrets.",
+			apiKeyEnv: "Credential reference",
+			apiKeyEnvHint: "Resolved through the credentials service per search; defaults to `OLLAMA_API_KEY`.",
+			baseURL: "Endpoint",
+			baseURLHint: "Endpoint root; the provider appends `/api/web_search`. Defaults to https://ollama.com.",
+			maxResults: "Default result count",
+			maxResultsHint: "Used when a request carries none; unset keeps Ollama's own default."
+		};
+		//#endregion
+		//#region src/client/index.ts
+		/** 本包 host 行 id：行配置页读的就是这个命名空间。 */
+		const WEB_SEARCH_NS = "web-search-ollama";
+		/** 本页字典的命名空间。 */
+		const NS = "settings.web-search-ollama";
+		/** 认领的字段名。 */
+		const FIELDS = [
+			"apiKey",
+			"apiKeyEnv",
+			"baseURL",
+			"maxResults"
+		];
+		/** 需要的服务：槽位（字段槽）与字典。 */
+		const inject = ["locale"];
+		/**
+		* 给这一行的四个字段补文案。
+		* @param ctx - 浏览器插件上下文。
+		*/
+		function apply(ctx) {
+			const t = ctx.locale.bind(NS);
+			ctx.effect(() => ctx.locale.register(NS, {
+				zh,
+				en
+			}), "web-search-ollama: field locale");
+			ctx.inject(["schemaFormHints"], (scope) => scope.effect(() => {
+				const hints = scope.schemaFormHints;
+				const offs = FIELDS.map((key) => hints.describe(WEB_SEARCH_NS, [key], () => ({
+					label: t(key),
+					hint: t(`${key}Hint`)
+				})));
+				return () => {
+					for (const off of offs) off();
+				};
+			}, "web-search-ollama: field wording"));
+		}
+		//#endregion
+		exports.NS = NS;
+		exports.WEB_SEARCH_NS = WEB_SEARCH_NS;
+		exports.apply = apply;
+		exports.inject = inject;
+		return module.exports;
+	}
+});

package/dist/client.d.cts

@@ -0,0 +1,35 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/client/locales.d.ts
+/** 本包在配置页上的字段文案（命名空间 `settings.web-search-ollama`）。 */
+declare const zh: {
+  readonly apiKey: "API key";
+  readonly apiKeyHint: "字面值；能走凭证服务时优先用下面的引用名，别把密钥写进配置文件。";
+  readonly apiKeyEnv: "凭证引用名";
+  readonly apiKeyEnvHint: "每次搜索经凭证服务解析一次；默认 `OLLAMA_API_KEY`。";
+  readonly baseURL: "端点";
+  readonly baseURLHint: "端点根，`/api/web_search` 由 provider 拼；默认 https://ollama.com。";
+  readonly maxResults: "默认结果数";
+  readonly maxResultsHint: "请求没带结果数时用它；留空就是让 Ollama 用自己的默认。";
+};
+type WebSearchFieldLocaleKey = keyof typeof zh;
+//#endregion
+//#region src/client/index.d.ts
+/** 本包 host 行 id：行配置页读的就是这个命名空间。 */
+declare const WEB_SEARCH_NS = "web-search-ollama";
+/** 本页字典的命名空间。 */
+declare const NS = "settings.web-search-ollama";
+declare module "@deepseek-ai/dsh-client-ui-slots" {
+  interface LocaleNamespaceMap {
+    /** 设置页里这一行的字段文案。 */
+    "settings.web-search-ollama": WebSearchFieldLocaleKey;
+  }
+}
+/** 需要的服务：槽位（字段槽）与字典。 */
+declare const inject: string[];
+/**
+ * 给这一行的四个字段补文案。
+ * @param ctx - 浏览器插件上下文。
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { NS, WEB_SEARCH_NS, apply, inject };

package/dist/client.d.mts

@@ -0,0 +1,35 @@
+import { Context } from "@deepseek-ai/cordis";
+//#region src/client/locales.d.ts
+/** 本包在配置页上的字段文案（命名空间 `settings.web-search-ollama`）。 */
+declare const zh: {
+  readonly apiKey: "API key";
+  readonly apiKeyHint: "字面值；能走凭证服务时优先用下面的引用名，别把密钥写进配置文件。";
+  readonly apiKeyEnv: "凭证引用名";
+  readonly apiKeyEnvHint: "每次搜索经凭证服务解析一次；默认 `OLLAMA_API_KEY`。";
+  readonly baseURL: "端点";
+  readonly baseURLHint: "端点根，`/api/web_search` 由 provider 拼；默认 https://ollama.com。";
+  readonly maxResults: "默认结果数";
+  readonly maxResultsHint: "请求没带结果数时用它；留空就是让 Ollama 用自己的默认。";
+};
+type WebSearchFieldLocaleKey = keyof typeof zh;
+//#endregion
+//#region src/client/index.d.ts
+/** 本包 host 行 id：行配置页读的就是这个命名空间。 */
+declare const WEB_SEARCH_NS = "web-search-ollama";
+/** 本页字典的命名空间。 */
+declare const NS = "settings.web-search-ollama";
+declare module "@deepseek-ai/dsh-client-ui-slots" {
+  interface LocaleNamespaceMap {
+    /** 设置页里这一行的字段文案。 */
+    "settings.web-search-ollama": WebSearchFieldLocaleKey;
+  }
+}
+/** 需要的服务：槽位（字段槽）与字典。 */
+declare const inject: string[];
+/**
+ * 给这一行的四个字段补文案。
+ * @param ctx - 浏览器插件上下文。
+ */
+declare function apply(ctx: Context): void;
+//#endregion
+export { NS, WEB_SEARCH_NS, apply, inject };

package/dist/index.d.cts

@@ -0,0 +1,81 @@
+import { Context } from "@deepseek-ai/cordis";
+import { Volatile } from "@deepseek-ai/cosmokit";
+import z from "@deepseek-ai/schemastery";
+import { WebSearchProvider, WebSearchRequest, WebSearchResult, WebSearchSource } from "@deepseek-ai/dsh-web";
+//#region src/types.d.ts
+/** `results[]` 的一条；字段都可能缺失或为空串。 */
+interface OllamaSearchResult {
+  title?: string | null;
+  url?: string | null;
+  content?: string | null;
+}
+/** 成功响应信封。 */
+interface OllamaSearchResponse {
+  results?: OllamaSearchResult[];
+}
+//#endregion
+//#region src/provider.d.ts
+/** 注册进 `ctx.web` 的 id；与 llm route 同名，配置里看到的就是同一个"ollama"。 */
+declare const OLLAMA_PROVIDER_ID = "ollama";
+/** 默认端点；`/api/web_search` 是操作。 */
+declare const OLLAMA_DEFAULT_BASE_URL = "https://ollama.com";
+/** Ollama 服务端自己的默认结果数。 */
+declare const OLLAMA_DEFAULT_MAX_RESULTS = 5;
+/** Ollama `max_results` 的硬上限；超过它的值不发给服务端。 */
+declare const OLLAMA_MAX_RESULTS_LIMIT = 10;
+interface OllamaSearchProviderOptions {
+  /** 字面 key；给了就压过 {@link resolveApiKey}。 */
+  apiKey?: string | undefined;
+  /** 运行期取 key 的入口（凭证服务 / 环境）；返回空表示取不到。 */
+  resolveApiKey?: () => Promise<string | undefined>;
+  /** 取不到 key 时报出来的引用名，便于用户知道去哪配。 */
+  apiKeyEnv: string;
+  baseURL: string;
+  /** 请求没给 `maxResults` 时用的默认值；省略表示让 Ollama 用它自己的默认。 */
+  maxResults?: number | undefined;
+}
+/** 一条 Ollama 结果 → 一个 source；没有 url 就丢掉（seam 的 source 必须有 url）。 */
+declare function mapOllamaResult(result: OllamaSearchResult): WebSearchSource | undefined;
+/** 响应信封 → 归一化结果；形状不对就抛（由调用方包成 `WEB_PROVIDER_ERROR`）。 */
+declare function mapOllamaResponse(response: OllamaSearchResponse): WebSearchResult;
+/** Ollama 的搜索后端；HTTP 重定向按 `WEB_PROVIDER_ERROR` 失败。 */
+declare class OllamaSearchProvider implements WebSearchProvider {
+  private readonly options;
+  readonly id = "ollama";
+  constructor(options: OllamaSearchProviderOptions);
+  available(): boolean;
+  search(request: WebSearchRequest, signal?: AbortSignal): Promise<WebSearchResult>;
+  /** 一次操作一份 key，不留在 provider 上；没有可用的 key 就点名引用，而不是发无授权请求。 */
+  private apiKey;
+}
+//#endregion
+//#region src/index.d.ts
+declare const name = "web-search-ollama";
+/** 只往 `ctx.web` 注册后端，不发布服务。 */
+declare const inject: string[];
+interface Config {
+  /** 字面 key；优先用 `apiKeyEnv` 走凭证服务，别把密钥写进配置文件。 */
+  apiKey?: string;
+  /** 每次搜索解析一次的凭证引用；缺省 `OLLAMA_API_KEY`。 */
+  apiKeyEnv?: string;
+  /** 端点根；`/api/web_search` 由 provider 拼。缺省 ollama.com。 */
+  baseURL?: string;
+  /** 请求没带 `maxResults` 时的默认结果数；省略表示让 Ollama 用自己的默认。 */
+  maxResults?: number;
+}
+/**
+ * schema 解析之后的形状：四个字段都是 **volatile 稳定引用**，读它要过 `.get()`。
+ *
+ * 它们都标了 `.volatile()`（插件行里唯一可实时改的字段），所以设置页改完不用重挂这一行：provider 的每一次
+ * 请求、每一次取 key 都现场读引用。
+ */
+interface ResolvedConfig {
+  readonly apiKey: Volatile<string | undefined>;
+  readonly apiKeyEnv: Volatile<string | undefined>;
+  readonly baseURL: Volatile<string | undefined>;
+  readonly maxResults: Volatile<number | undefined>;
+}
+declare const Config: z<Config, ResolvedConfig>;
+declare function apply(ctx: Context, config: ResolvedConfig): void;
+//#endregion
+export { Config, OLLAMA_DEFAULT_BASE_URL, OLLAMA_DEFAULT_MAX_RESULTS, OLLAMA_MAX_RESULTS_LIMIT, OLLAMA_PROVIDER_ID, OllamaSearchProvider, type OllamaSearchProviderOptions, ResolvedConfig, apply, inject, mapOllamaResponse, mapOllamaResult, name };

package/dist/index.d.mts

@@ -1,6 +1,7 @@
 import z from "@deepseek-ai/schemastery";
 import { WebSearchProvider, WebSearchRequest, WebSearchResult, WebSearchSource } from "@deepseek-ai/dsh-web";
 import { Context } from "@deepseek-ai/cordis";
+import { Volatile } from "@deepseek-ai/cosmokit";
 //#region src/types.d.ts
 /** `results[]` 的一条；字段都可能缺失或为空串。 */
 interface OllamaSearchResult {
@@ -24,14 +25,14 @@ declare const OLLAMA_DEFAULT_MAX_RESULTS = 5;
 declare const OLLAMA_MAX_RESULTS_LIMIT = 10;
 interface OllamaSearchProviderOptions {
   /** 字面 key；给了就压过 {@link resolveApiKey}。 */
-  apiKey?: string;
+  apiKey?: string | undefined;
   /** 运行期取 key 的入口（凭证服务 / 环境）；返回空表示取不到。 */
   resolveApiKey?: () => Promise<string | undefined>;
   /** 取不到 key 时报出来的引用名，便于用户知道去哪配。 */
   apiKeyEnv: string;
   baseURL: string;
   /** 请求没给 `maxResults` 时用的默认值；省略表示让 Ollama 用它自己的默认。 */
-  maxResults?: number;
+  maxResults?: number | undefined;
 }
 /** 一条 Ollama 结果 → 一个 source；没有 url 就丢掉（seam 的 source 必须有 url）。 */
 declare function mapOllamaResult(result: OllamaSearchResult): WebSearchSource | undefined;
@@ -62,7 +63,19 @@ interface Config {
   /** 请求没带 `maxResults` 时的默认结果数；省略表示让 Ollama 用自己的默认。 */
   maxResults?: number;
 }
-declare const Config: z<Config>;
-declare function apply(ctx: Context, config: Config): void;
+/**
+ * schema 解析之后的形状：四个字段都是 **volatile 稳定引用**，读它要过 `.get()`。
+ *
+ * 它们都标了 `.volatile()`（插件行里唯一可实时改的字段），所以设置页改完不用重挂这一行：provider 的每一次
+ * 请求、每一次取 key 都现场读引用。
+ */
+interface ResolvedConfig {
+  readonly apiKey: Volatile<string | undefined>;
+  readonly apiKeyEnv: Volatile<string | undefined>;
+  readonly baseURL: Volatile<string | undefined>;
+  readonly maxResults: Volatile<number | undefined>;
+}
+declare const Config: z<Config, ResolvedConfig>;
+declare function apply(ctx: Context, config: ResolvedConfig): void;
 //#endregion
-export { Config, OLLAMA_DEFAULT_BASE_URL, OLLAMA_DEFAULT_MAX_RESULTS, OLLAMA_MAX_RESULTS_LIMIT, OLLAMA_PROVIDER_ID, OllamaSearchProvider, type OllamaSearchProviderOptions, apply, inject, mapOllamaResponse, mapOllamaResult, name };
+export { Config, OLLAMA_DEFAULT_BASE_URL, OLLAMA_DEFAULT_MAX_RESULTS, OLLAMA_MAX_RESULTS_LIMIT, OLLAMA_PROVIDER_ID, OllamaSearchProvider, type OllamaSearchProviderOptions, ResolvedConfig, apply, inject, mapOllamaResponse, mapOllamaResult, name };

package/dist/index.mjs

@@ -121,26 +121,51 @@ const name = "web-search-ollama";
 const inject = ["web"];
 /** 与 `llm-pi-ai` 的 ollama route 共用同一个 key 引用。 */
 const DEFAULT_API_KEY_ENV = "OLLAMA_API_KEY";
+/**
+* 本地化说明：`description()` 的类型签名只声明 `string`，而 meta 本身接受 `Dict<string>`
+* （`vendor/schemastery/src/index.ts` 的 `mergeDesc` 就是按字典合并的），所以这里只做一次类型放行。
+*/
+const localized = (text) => text;
 const Config = z.object({
-	apiKey: z.string().role("secret"),
-	apiKeyEnv: z.string().role("credential-ref"),
-	baseURL: z.string(),
-	maxResults: z.number().step(1).min(1)
+	apiKey: z.string().role("secret").description(localized({
+		zh: "Ollama 的 API key 字面值；能用凭证服务时优先用下面的引用名，别把密钥写进配置文件。",
+		en: "Literal Ollama API key. Prefer the credential reference below; do not put secrets in a config file."
+	})).volatile(),
+	apiKeyEnv: z.string().role("credential-ref").description(localized({
+		zh: "凭证引用名（默认 `OLLAMA_API_KEY`）：每次搜索经凭证服务解析一次。",
+		en: "Credential reference resolved through the credentials service on every search (default `OLLAMA_API_KEY`)."
+	})).volatile(),
+	baseURL: z.string().description(localized({
+		zh: "端点根，`/api/web_search` 由 provider 拼；默认 https://ollama.com。",
+		en: "Endpoint root; the provider appends `/api/web_search`. Defaults to https://ollama.com."
+	})).volatile(),
+	maxResults: z.number().step(1).min(1).description(localized({
+		zh: "请求没带结果数时用的默认值；省略就是让 Ollama 用自己的默认。",
+		en: "Default result count when a request carries none; unset keeps Ollama's own default."
+	})).volatile()
 });
 function apply(ctx, config) {
-	const apiKeyEnv = credentialRef(config.apiKeyEnv ?? DEFAULT_API_KEY_ENV);
-	const literal = config.apiKey !== void 0 && config.apiKey.length > 0 ? config.apiKey : void 0;
 	ctx.web.registerSearchProvider(new OllamaSearchProvider({
-		...literal === void 0 ? {} : { apiKey: literal },
+		get apiKey() {
+			const literal = config.apiKey.get();
+			return literal !== void 0 && literal.length > 0 ? literal : void 0;
+		},
 		resolveApiKey: async () => {
+			const reference = credentialRef(config.apiKeyEnv.get() ?? DEFAULT_API_KEY_ENV);
 			const credentials = ctx.get("credentials");
-			if (credentials !== void 0) return (await credentials.resolve(apiKeyEnv))?.value;
-			const ambient = launchEnvironmentOf(ctx).get(apiKeyEnv);
+			if (credentials !== void 0) return (await credentials.resolve(reference))?.value;
+			const ambient = launchEnvironmentOf(ctx).get(reference);
 			return ambient !== void 0 && ambient.value.length > 0 ? ambient.value : void 0;
 		},
-		apiKeyEnv,
-		baseURL: config.baseURL ?? "https://ollama.com",
-		...config.maxResults === void 0 ? {} : { maxResults: config.maxResults }
+		get apiKeyEnv() {
+			return config.apiKeyEnv.get() ?? DEFAULT_API_KEY_ENV;
+		},
+		get baseURL() {
+			return config.baseURL.get() ?? "https://ollama.com";
+		},
+		get maxResults() {
+			return config.maxResults.get();
+		}
 	}));
 }
 //#endregion

package/dist/rows.d.cts

@@ -0,0 +1,22 @@
+//#region src/rows.d.ts
+/**
+ * 本包作为能力包发布的**装配数据**：行本身在部署那一层装
+ * （`packages/bundles/ollama-provider-profile` 引用它渲染 patch；那里同时给 `web.searchProvider` 与 key 引用）。
+ *
+ * 注册行必须在 host 平面只装一次——同一个 provider id 注册两份会撞 `WEB_DUPLICATE_PROVIDER`。
+ */
+/** 一行装配条目：与 `cordis.patch.yml` 的顶层结构同形。 */
+interface PatchRow {
+  readonly id?: string;
+  readonly insert?: readonly RowEntry[];
+}
+/** `insert` 里的一个条目。 */
+interface RowEntry {
+  readonly id: string;
+  readonly name: string;
+  readonly config?: Readonly<Record<string, unknown>>;
+}
+/** 搜索后端的注册行（config 的值由部署那层按 id 覆盖）。 */
+declare function webSearchRows(): readonly PatchRow[];
+//#endregion
+export { PatchRow, RowEntry, webSearchRows };

package/dist/rows.d.mts

@@ -0,0 +1,22 @@
+//#region src/rows.d.ts
+/**
+ * 本包作为能力包发布的**装配数据**：行本身在部署那一层装
+ * （`packages/bundles/ollama-provider-profile` 引用它渲染 patch；那里同时给 `web.searchProvider` 与 key 引用）。
+ *
+ * 注册行必须在 host 平面只装一次——同一个 provider id 注册两份会撞 `WEB_DUPLICATE_PROVIDER`。
+ */
+/** 一行装配条目：与 `cordis.patch.yml` 的顶层结构同形。 */
+interface PatchRow {
+  readonly id?: string;
+  readonly insert?: readonly RowEntry[];
+}
+/** `insert` 里的一个条目。 */
+interface RowEntry {
+  readonly id: string;
+  readonly name: string;
+  readonly config?: Readonly<Record<string, unknown>>;
+}
+/** 搜索后端的注册行（config 的值由部署那层按 id 覆盖）。 */
+declare function webSearchRows(): readonly PatchRow[];
+//#endregion
+export { PatchRow, RowEntry, webSearchRows };

package/dist/rows.mjs

@@ -0,0 +1,10 @@
+//#region src/rows.ts
+/** 搜索后端的注册行（config 的值由部署那层按 id 覆盖）。 */
+function webSearchRows() {
+	return [{ insert: [{
+		id: "web-search-ollama",
+		name: "@morlay/dsh-web-search-ollama"
+	}] }];
+}
+//#endregion
+export { webSearchRows };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-web-search-ollama",
-  "version": "0.0.1-alpha.4",
+  "version": "0.0.1-alpha.5",
   "description": "Ollama-backed search provider for the DeepSeek Harness web seam (ctx.web): one web_search backend calling POST https://ollama.com/api/web_search.",
   "keywords": [
     "dsh",
@@ -17,28 +17,46 @@
     "locale/*.json",
     "dist",
     "src",
-    "cordis.patch.yml",
     "!**/__tests__"
   ],
   "type": "module",
   "exports": {
     ".": "./dist/index.mjs",
+    "./rows": "./dist/rows.mjs",
     "./package.json": "./package.json",
-    "./cordis.patch.yml": "./cordis.patch.yml",
+    "./client": {
+      "types": "./dist/client.d.cts",
+      "default": "./dist/client.cjs"
+    },
     "./locale/*.json": "./locale/*.json"
   },
   "dependencies": {
-    "@deepseek-ai/schemastery": "3.18.4"
+    "@deepseek-ai/schemastery": "^3.18.4"
+  },
+  "devDependencies": {
+    "@deepseek-ai/cosmokit": "1.8.5",
+    "@deepseek-ai/dsh-client-locale": "0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "0.1.7-rc.2",
+    "@morlay/dsh-client-ui-primitives": "0.0.2-alpha.9"
   },
   "peerDependencies": {
-    "@deepseek-ai/cordis": "4.0.4",
-    "@deepseek-ai/dsh-credentials": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-launch-environment": "0.1.7-rc.1",
-    "@deepseek-ai/dsh-web": "0.1.7-rc.1"
+    "@deepseek-ai/cordis": "^4.0.4",
+    "@deepseek-ai/cosmokit": "^1.8.5",
+    "@deepseek-ai/dsh-client-locale": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-credentials": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-launch-environment": "^0.1.7-rc.2",
+    "@deepseek-ai/dsh-web": "^0.1.7-rc.2",
+    "@morlay/dsh-client-ui-primitives": "0.0.2-alpha.9"
   },
   "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-locale",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@morlay/dsh-client-ui-primitives"
+      ]
     }
   },
   "scripts": {

package/src/client/index.ts

@@ -0,0 +1,52 @@
+/**
+ * client 半：这一行的配置页由通用 schema 表单按 volatile 字段生成（四个字段都能在页面上改，改完下一次请求就
+ * 生效），本包只把英文键名换成中文标签与说明。
+ */
+
+import type { Context } from "@deepseek-ai/cordis";
+import type {} from "@deepseek-ai/dsh-client-locale/client";
+import type {} from "@deepseek-ai/dsh-client-ui-slots";
+import { en, zh, type WebSearchFieldLocaleKey } from "./locales.ts";
+
+/** 本包 host 行 id：行配置页读的就是这个命名空间。 */
+export const WEB_SEARCH_NS = "web-search-ollama";
+
+/** 本页字典的命名空间。 */
+export const NS = "settings.web-search-ollama";
+
+/** 认领的字段名。 */
+const FIELDS = ["apiKey", "apiKeyEnv", "baseURL", "maxResults"] as const;
+
+declare module "@deepseek-ai/dsh-client-ui-slots" {
+  interface LocaleNamespaceMap {
+    /** 设置页里这一行的字段文案。 */
+    "settings.web-search-ollama": WebSearchFieldLocaleKey;
+  }
+}
+
+/** 需要的服务：槽位（字段槽）与字典。 */
+export const inject = ["locale"];
+
+/**
+ * 给这一行的四个字段补文案。
+ * @param ctx - 浏览器插件上下文。
+ */
+export function apply(ctx: Context): void {
+  const t = ctx.locale.bind(NS);
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), "web-search-ollama: field locale");
+  // 提示面由行配置表单提供：等它可用再注册（`ctx.get` 在它还没提供时拿不到，注册会被静静跳过）。
+  ctx.inject(["schemaFormHints"], (scope) =>
+    scope.effect(() => {
+      const hints = scope.schemaFormHints;
+      const offs = FIELDS.map((key) =>
+        hints.describe(WEB_SEARCH_NS, [key], () => ({
+          label: t(key),
+          hint: t(`${key}Hint` as WebSearchFieldLocaleKey),
+        })),
+      );
+      return () => {
+        for (const off of offs) off();
+      };
+    }, "web-search-ollama: field wording"),
+  );
+}

package/src/client/locales.ts

@@ -0,0 +1,27 @@
+/** 本包在配置页上的字段文案（命名空间 `settings.web-search-ollama`）。 */
+
+export const zh = {
+  apiKey: "API key",
+  apiKeyHint: "字面值；能走凭证服务时优先用下面的引用名，别把密钥写进配置文件。",
+  apiKeyEnv: "凭证引用名",
+  apiKeyEnvHint: "每次搜索经凭证服务解析一次；默认 `OLLAMA_API_KEY`。",
+  baseURL: "端点",
+  baseURLHint: "端点根，`/api/web_search` 由 provider 拼；默认 https://ollama.com。",
+  maxResults: "默认结果数",
+  maxResultsHint: "请求没带结果数时用它；留空就是让 Ollama 用自己的默认。",
+} as const;
+
+export const en: Record<keyof typeof zh, string> = {
+  apiKey: "API key",
+  apiKeyHint: "Literal value; prefer the credential reference below and never inline secrets.",
+  apiKeyEnv: "Credential reference",
+  apiKeyEnvHint:
+    "Resolved through the credentials service per search; defaults to `OLLAMA_API_KEY`.",
+  baseURL: "Endpoint",
+  baseURLHint:
+    "Endpoint root; the provider appends `/api/web_search`. Defaults to https://ollama.com.",
+  maxResults: "Default result count",
+  maxResultsHint: "Used when a request carries none; unset keeps Ollama's own default.",
+};
+
+export type WebSearchFieldLocaleKey = keyof typeof zh;

package/src/index.ts

@@ -1,3 +1,4 @@
+import type { Volatile } from "@deepseek-ai/cosmokit";
 import type { Context } from "@deepseek-ai/cordis";
 import { credentialRef } from "@deepseek-ai/dsh-credentials";
 import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
@@ -35,30 +36,92 @@ export interface Config {
   maxResults?: number;
 }
 
-export const Config: z<Config> = z.object({
-  apiKey: z.string().role("secret"),
-  apiKeyEnv: z.string().role("credential-ref"),
-  baseURL: z.string(),
-  maxResults: z.number().step(1).min(1),
+/**
+ * schema 解析之后的形状：四个字段都是 **volatile 稳定引用**，读它要过 `.get()`。
+ *
+ * 它们都标了 `.volatile()`（插件行里唯一可实时改的字段），所以设置页改完不用重挂这一行：provider 的每一次
+ * 请求、每一次取 key 都现场读引用。
+ */
+export interface ResolvedConfig {
+  readonly apiKey: Volatile<string | undefined>;
+  readonly apiKeyEnv: Volatile<string | undefined>;
+  readonly baseURL: Volatile<string | undefined>;
+  readonly maxResults: Volatile<number | undefined>;
+}
+
+/**
+ * 本地化说明：`description()` 的类型签名只声明 `string`，而 meta 本身接受 `Dict<string>`
+ * （`vendor/schemastery/src/index.ts` 的 `mergeDesc` 就是按字典合并的），所以这里只做一次类型放行。
+ */
+const localized = (text: { zh: string; en: string }): string => text as unknown as string;
+
+export const Config: z<Config, ResolvedConfig> = z.object({
+  apiKey: z
+    .string()
+    .role("secret")
+    .description(
+      localized({
+        zh: "Ollama 的 API key 字面值；能用凭证服务时优先用下面的引用名，别把密钥写进配置文件。",
+        en: "Literal Ollama API key. Prefer the credential reference below; do not put secrets in a config file.",
+      }),
+    )
+    .volatile(),
+  apiKeyEnv: z
+    .string()
+    .role("credential-ref")
+    .description(
+      localized({
+        zh: "凭证引用名（默认 `OLLAMA_API_KEY`）：每次搜索经凭证服务解析一次。",
+        en: "Credential reference resolved through the credentials service on every search (default `OLLAMA_API_KEY`).",
+      }),
+    )
+    .volatile(),
+  baseURL: z
+    .string()
+    .description(
+      localized({
+        zh: "端点根，`/api/web_search` 由 provider 拼；默认 https://ollama.com。",
+        en: "Endpoint root; the provider appends `/api/web_search`. Defaults to https://ollama.com.",
+      }),
+    )
+    .volatile(),
+  maxResults: z
+    .number()
+    .step(1)
+    .min(1)
+    .description(
+      localized({
+        zh: "请求没带结果数时用的默认值；省略就是让 Ollama 用自己的默认。",
+        en: "Default result count when a request carries none; unset keeps Ollama's own default.",
+      }),
+    )
+    .volatile(),
 });
 
-export function apply(ctx: Context, config: Config): void {
-  const apiKeyEnv = credentialRef(config.apiKeyEnv ?? DEFAULT_API_KEY_ENV);
-  const literal =
-    config.apiKey !== undefined && config.apiKey.length > 0 ? config.apiKey : undefined;
-  ctx.web.registerSearchProvider(
-    new OllamaSearchProvider({
-      ...(literal === undefined ? {} : { apiKey: literal }),
-      resolveApiKey: async () => {
-        const credentials = ctx.get("credentials");
-        if (credentials !== undefined) return (await credentials.resolve(apiKeyEnv))?.value;
-        // 没有凭证服务时环境就是整个凭证面。
-        const ambient = launchEnvironmentOf(ctx).get(apiKeyEnv);
-        return ambient !== undefined && ambient.value.length > 0 ? ambient.value : undefined;
-      },
-      apiKeyEnv,
-      baseURL: config.baseURL ?? OLLAMA_DEFAULT_BASE_URL,
-      ...(config.maxResults === undefined ? {} : { maxResults: config.maxResults }),
-    }),
-  );
+export function apply(ctx: Context, config: ResolvedConfig): void {
+  // provider 每次都从 options 读，所以这里用 getter 把「现场读引用」接上去：改配置即下一次请求生效。
+  const options = {
+    get apiKey(): string | undefined {
+      const literal = config.apiKey.get();
+      return literal !== undefined && literal.length > 0 ? literal : undefined;
+    },
+    resolveApiKey: async () => {
+      const reference = credentialRef(config.apiKeyEnv.get() ?? DEFAULT_API_KEY_ENV);
+      const credentials = ctx.get("credentials");
+      if (credentials !== undefined) return (await credentials.resolve(reference))?.value;
+      // 没有凭证服务时环境就是整个凭证面。
+      const ambient = launchEnvironmentOf(ctx).get(reference);
+      return ambient !== undefined && ambient.value.length > 0 ? ambient.value : undefined;
+    },
+    get apiKeyEnv(): string {
+      return config.apiKeyEnv.get() ?? DEFAULT_API_KEY_ENV;
+    },
+    get baseURL(): string {
+      return config.baseURL.get() ?? OLLAMA_DEFAULT_BASE_URL;
+    },
+    get maxResults(): number | undefined {
+      return config.maxResults.get();
+    },
+  };
+  ctx.web.registerSearchProvider(new OllamaSearchProvider(options));
 }

package/src/provider.ts

@@ -24,14 +24,14 @@ const USER_AGENT = "morlay-dsh-plugin/0.0.1";
 
 export interface OllamaSearchProviderOptions {
   /** 字面 key；给了就压过 {@link resolveApiKey}。 */
-  apiKey?: string;
+  apiKey?: string | undefined;
   /** 运行期取 key 的入口（凭证服务 / 环境）；返回空表示取不到。 */
   resolveApiKey?: () => Promise<string | undefined>;
   /** 取不到 key 时报出来的引用名，便于用户知道去哪配。 */
   apiKeyEnv: string;
   baseURL: string;
   /** 请求没给 `maxResults` 时用的默认值；省略表示让 Ollama 用它自己的默认。 */
-  maxResults?: number;
+  maxResults?: number | undefined;
 }
 
 /** 一条 Ollama 结果 → 一个 source；没有 url 就丢掉（seam 的 source 必须有 url）。 */

package/src/rows.ts

@@ -0,0 +1,24 @@
+/**
+ * 本包作为能力包发布的**装配数据**：行本身在部署那一层装
+ * （`packages/bundles/ollama-provider-profile` 引用它渲染 patch；那里同时给 `web.searchProvider` 与 key 引用）。
+ *
+ * 注册行必须在 host 平面只装一次——同一个 provider id 注册两份会撞 `WEB_DUPLICATE_PROVIDER`。
+ */
+
+/** 一行装配条目：与 `cordis.patch.yml` 的顶层结构同形。 */
+export interface PatchRow {
+  readonly id?: string;
+  readonly insert?: readonly RowEntry[];
+}
+
+/** `insert` 里的一个条目。 */
+export interface RowEntry {
+  readonly id: string;
+  readonly name: string;
+  readonly config?: Readonly<Record<string, unknown>>;
+}
+
+/** 搜索后端的注册行（config 的值由部署那层按 id 覆盖）。 */
+export function webSearchRows(): readonly PatchRow[] {
+  return [{ insert: [{ id: "web-search-ollama", name: "@morlay/dsh-web-search-ollama" }] }];
+}

package/cordis.patch.yml

@@ -1,11 +0,0 @@
-# @morlay/dsh-web-search-ollama bundle patch：把搜索后端注册到 host 层。
-#
-# 为什么住 host：注册行在 profile 平面只装一次——同一个 provider id 注册两份会撞
-# `WEB_DUPLICATE_PROVIDER`；至于选它还是别的后端，由 `web` 行的
-# `searchProvider` 决定——那是配置，归 `@morlay/dsh-profile`。两者分工：这里插行，那边配值。
-#
-# 行不带 config：`apiKeyEnv` 这类值同样由 `@morlay/dsh-profile` 做 config 覆盖。
-
-- insert:
-    - id: web-search-ollama
-      name: "@morlay/dsh-web-search-ollama"