@morlay/dsh-web-search-ollama 0.0.1 → 0.0.3

package/README.md

@@ -1,81 +1,11 @@
 # @morlay/dsh-web-search-ollama
 
 往 `ctx.web` 注册一个搜索后端：`web_search` 的检索走 Ollama 自己的
-`POST https://ollama.com/api/web_search`，用与 `llm-pi-ai` 的 ollama route 同一个
-`OLLAMA_API_KEY`。
+`POST https://ollama.com/api/web_search`，用与 `llm-pi-ai` 的 ollama route 同一个 `OLLAMA_API_KEY`。
 
-## 为什么不是"复用上游的 messages 后端"
+## 用法
 
-上游 `@deepseek-ai/dsh-web-search-deepseek` 走 Anthropic Messages 的
-`web_search_20250305` server tool，看起来只要把 `baseURL` 指到 `https://ollama.com/v1` 就能白拿
-Ollama 的搜索。**实测不行**：真发一次
-
-```sh
-curl https://ollama.com/v1/messages -H "Authorization: Bearer $OLLAMA_API_KEY" \
-  -H "anthropic-version: 2023-06-01" -H "content-type: application/json" \
-  -d '{"model":"deepseek-v4.1-flash","max_tokens":4096,
-       "messages":[{"role":"user","content":[{"type":"text","text":"Perform a web search for the query: cordis plugin framework"}]}],
-       "tools":[{"type":"web_search_20250305","name":"web_search","max_uses":5}]}'
-```
-
-回的 `content` 块只有 `thinking` + `tool_use`（`stop_reason: tool_use`）——**Ollama 把这个 server
-tool 降级成普通客户端工具，它不自己执行搜索**，要求调用方执行后再回传 `tool_result`。而那个上游
-provider 只认服务端自执行后返回的 `web_search_tool_result` 块，找不到就报
-`WEB_PROVIDER_ERROR`（"returned no web_search_tool_result blocks"）。Ollama 官方文档那句
-"hosted web search are not fully supported"（[docs.ollama.com/api/anthropic-compatibility](https://docs.ollama.com/api/anthropic-compatibility)）
-就是这个意思，[issue #17283](https://github.com/ollama/ollama/issues/17283) 里说的
-`WebSearchAnthropicWriter` 拦截只发生在本地 server 的 cloud 模型路径上。
-
-Ollama 真正对外提供搜索的是它自己的 REST 接口——同一个 key、一次 HTTP、返回扁平
-`{results:[{title,url,content}]}`：
-
-```sh
-curl https://ollama.com/api/web_search -H "Authorization: Bearer $OLLAMA_API_KEY" \
-  -H "content-type: application/json" -d '{"query":"cordis plugin framework"}'
-```
-
-本包就是把这一条接进 `ctx.web`，代价只有一个 ~200 行的 provider。
-
-## 配置
-
-| 字段         | 默认                     | 含义                                                       |
-| ------------ | ------------------------ | ---------------------------------------------------------- |
-| `apiKey`     | —                        | 字面 key；优先用下面那个引用，别把密钥写进配置文件         |
-| `apiKeyEnv`  | `OLLAMA_API_KEY`         | 每次搜索解析一次的凭证引用（凭证服务，缺席时回退启动环境） |
-| `baseURL`    | `https://ollama.com`     | 端点根；`/api/web_search` 由 provider 拼                   |
-| `maxResults` | —（Ollama 自己的默认 5） | 请求没带 `maxResults` 时的默认结果数                       |
-
-## 行为
-
-- **结果映射**：每条 `results[]` 给一个 source；`title` / `content` 空串视为缺失
-  （`content` → `snippet`），**没有 `url` 的条目直接丢掉**（seam 的 source 必须有 url）。
-  Ollama 不返回生成式答案，所以结果里没有 `content` 字段。
-- **`max_results` 上限 10**：Ollama 的硬上限；请求与配置给出的更大值在发出前压到 10。
-- **错误码**：HTTP 失败 → `WEB_PROVIDER_ERROR`（优先用响应体里的 `error` 文案，非 JSON 体退回
-  `Ollama API error (HTTP <status>)`）；网络失败 → `WEB_PROVIDER_ERROR`；取消 → `WEB_ABORTED`
-  （任何阶段，含读体）；取不到 key → `WEB_PROVIDER_CREDENTIAL_MISSING` 且不发请求。
-- **可用性检查不联网**：`available()` 只看 key 有没有来源、`baseURL` 能否解析。
-
-## 验证
-
-`src/__tests__/provider.spec.ts` 是 mock 单测，默认 `just test` 覆盖它。链路是否真的成立由
-[`e2e/provider.e2e.spec.ts`](./e2e/provider.e2e.spec.ts) 打真端点守——**它刻意放在 `src/__tests__/` 之外**：
-根 `vitest.config.ts` 的 include 收不到它，默认全量测试不会去打外网，只由显式命令触发（`OLLAMA_API_KEY`
-从启动环境注入，缺席则整体跳过）：
-
-```sh
-mise exec -- pnpm --filter @morlay/dsh-web-search-ollama run test:e2e
-```
-
-两条都过才算通过：provider 直连拿回可引用 source，以及 provider 装进 `ctx.web` 后选中它再搜一次。别用
-mock 全绿替代它——这个包的第一版就是"配置指到 Ollama 的 messages 端点"、mock 也全绿，真调用却是错的。
-触发方式、门控与判据的 home 是[包层规范](./.agents/standards/how-to-verify.md)。
-
-## 装配
-
-注册行由**本包的 bundle patch**（[`src/rows.ts`](./src/rows.ts)）插在 **host 层**；
-基础 bundle 的 `web` 行由 [`@morlay/dsh-profile`](../../bundles/sandbox-profile/README.md) 的配置层切到
-`ollama`——装配归本包、配置归 profile：
+本包只提供行数据；采用它的部署 bundle 渲染出的装配（节选）：
 
 ```yaml
 - id: web
@@ -85,17 +15,21 @@ mock 全绿替代它——这个包的第一版就是"配置指到 Ollama 的 me
 - insert:
     - id: web-search-ollama
       name: "@morlay/dsh-web-search-ollama"
-      config:
-        apiKeyEnv: OLLAMA_API_KEY
+- id: web-search-ollama
+  config:
+    apiKeyEnv: OLLAMA_API_KEY
 ```
 
-注册行只能有一份：它在 profile 平面只装一次，同一个 provider id 注册两次会撞
-`WEB_DUPLICATE_PROVIDER`；选择权在 `web` 行的 `searchProvider`，而那一行本来就是 host 行。
+配置四个字段：`apiKey`（字面 key）、`apiKeyEnv`（凭证引用，默认 `OLLAMA_API_KEY`）、`baseURL`（默认
+`https://ollama.com`）、`maxResults`（缺省用 Ollama 的默认，硬上限 10）。四个都可实时改，不用重挂这一行。
 
-## 边界
+上游的 Anthropic Messages 后端在 Ollama 上不成立（Ollama 把 `web_search_20250305` 降级成客户端工具、不执行搜索），
+所以本包直接接 Ollama 的 REST——原因、结果映射、错误面与装配链路见
+[设计 Ollama 搜索后端](./.agents/designs/20260929-ollama搜索后端.md)。
+
+## 装配
 
-- **只注册搜索后端**：`web_fetch` 仍走基础 bundle 的 `web-fetch-http`，本包不碰抓取。
-- **一次只选一个后端**：`ctx.web` 的 `searchProvider` 是单选，默认 `ollama`；
-  `deepseek-official` 后端仍由基础 bundle 注册着，改写那一行即可切回（但它需要 `DEEPSEEK_API_KEY`）。
-- **不做设置页 section**：配置面就是那一行 patch（见
-  [dsh-profile 的设计记录](../../bundles/ollama-provider-profile/README.md)）。
+注册行由本包的 `./rows` 出口给出，采用它的部署 bundle 是
+[`@morlay/ollama-provider-profile`](../../bundles/ollama-provider-profile/README.md)：它渲染 patch，并在同一份 patch
+里给 `web` 行的 `searchProvider: ollama` 与 key 引用。注册行在 host 平面只装一次，同一个 provider id 注册两次会撞
+`WEB_DUPLICATE_PROVIDER`。

package/dist/client.cjs

@@ -5,7 +5,6 @@ window.__ModuleLoader__.load({
 		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: "字面值；能走凭证服务时优先用下面的引用名，别把密钥写进配置文件。",
@@ -28,23 +27,15 @@ window.__ModuleLoader__.load({
 		};
 		//#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, {

package/dist/client.d.cts

@@ -1,6 +1,5 @@
 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: "字面值；能走凭证服务时优先用下面的引用名，别把密钥写进配置文件。";
@@ -14,22 +13,14 @@ declare const zh: {
 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

@@ -1,6 +1,5 @@
 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: "字面值；能走凭证服务时优先用下面的引用名，别把密钥写进配置文件。";
@@ -14,22 +13,14 @@ declare const zh: {
 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

@@ -3,72 +3,47 @@ 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>;

package/dist/index.d.mts

@@ -3,72 +3,47 @@ import { WebSearchProvider, WebSearchRequest, WebSearchResult, WebSearchSource }
 import { Context } from "@deepseek-ai/cordis";
 import { Volatile } from "@deepseek-ai/cosmokit";
 //#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>;

package/dist/index.mjs

@@ -3,17 +3,11 @@ import { launchEnvironmentOf } from "@deepseek-ai/dsh-launch-environment";
 import z from "@deepseek-ai/schemastery";
 import { WebError } from "@deepseek-ai/dsh-web";
 //#region src/provider.ts
-/** 注册进 `ctx.web` 的 id；与 llm route 同名，配置里看到的就是同一个"ollama"。 */
 const OLLAMA_PROVIDER_ID = "ollama";
-/** 默认端点；`/api/web_search` 是操作。 */
 const OLLAMA_DEFAULT_BASE_URL = "https://ollama.com";
-/** Ollama 服务端自己的默认结果数。 */
 const OLLAMA_DEFAULT_MAX_RESULTS = 5;
-/** Ollama `max_results` 的硬上限；超过它的值不发给服务端。 */
 const OLLAMA_MAX_RESULTS_LIMIT = 10;
-/** 每次请求带的归属头。 */
 const USER_AGENT = "morlay-dsh-plugin/0.0.1";
-/** 一条 Ollama 结果 → 一个 source；没有 url 就丢掉（seam 的 source 必须有 url）。 */
 function mapOllamaResult(result) {
 	const url = result.url;
 	if (typeof url !== "string" || url.length === 0) return void 0;
@@ -25,7 +19,6 @@ function mapOllamaResult(result) {
 		...snippet === void 0 ? {} : { snippet }
 	};
 }
-/** 响应信封 → 归一化结果；形状不对就抛（由调用方包成 `WEB_PROVIDER_ERROR`）。 */
 function mapOllamaResponse(response) {
 	const results = response.results;
 	if (results !== void 0 && !Array.isArray(results)) throw new TypeError("Ollama returned a non-array `results` field");
@@ -34,7 +27,6 @@ function mapOllamaResponse(response) {
 		truncated: false
 	};
 }
-/** Ollama 的搜索后端；HTTP 重定向按 `WEB_PROVIDER_ERROR` 失败。 */
 var OllamaSearchProvider = class {
 	options;
 	id = OLLAMA_PROVIDER_ID;
@@ -86,7 +78,6 @@ var OllamaSearchProvider = class {
 			throw new WebError(`Ollama returned an unprocessable response body: ${String(error)}`, "WEB_PROVIDER_ERROR", { cause: error });
 		}
 	}
-	/** 一次操作一份 key，不留在 provider 上；没有可用的 key 就点名引用，而不是发无授权请求。 */
 	async apiKey() {
 		const literal = this.options.apiKey;
 		if (literal !== void 0 && literal.length > 0) return literal;
@@ -117,14 +108,8 @@ function searchAborted(cause) {
 //#endregion
 //#region src/index.ts
 const name = "web-search-ollama";
-/** 只往 `ctx.web` 注册后端，不发布服务。 */
 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").description(localized({

package/dist/rows.d.cts

@@ -1,22 +1,13 @@
 //#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

@@ -1,22 +1,13 @@
 //#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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@morlay/dsh-web-search-ollama",
-  "version": "0.0.1",
+  "version": "0.0.3",
   "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",
@@ -35,19 +35,19 @@
   },
   "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"
+    "@deepseek-ai/dsh-client-locale": "0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "0.2.0-rc.1",
+    "@morlay/dsh-client-ui-primitives": "0.0.5"
   },
   "peerDependencies": {
     "@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"
+    "@deepseek-ai/dsh-client-locale": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-credentials": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-launch-environment": "^0.2.0-rc.1",
+    "@deepseek-ai/dsh-web": "^0.2.0-rc.1",
+    "@morlay/dsh-client-ui-primitives": "0.0.5"
   },
   "dsh": {
     "client": {

package/src/client/index.ts

@@ -1,36 +1,31 @@
-/**
- * client 半：这一行的配置页由通用 schema 表单按 volatile 字段生成（四个字段都能在页面上改，改完下一次请求就
- * 生效），本包只把英文键名换成中文标签与说明。
- */
+// 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：行配置页读的就是这个命名空间。 */
+// 本包 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");

package/src/client/locales.ts

@@ -1,4 +1,4 @@
-/** 本包在配置页上的字段文案（命名空间 `settings.web-search-ollama`）。 */
+// 本包在配置页上的字段文案（命名空间 `settings.web-search-ollama`）。
 
 export const zh = {
   apiKey: "API key",

package/src/index.ts

@@ -19,29 +19,25 @@ export type { OllamaSearchProviderOptions } from "./provider.ts";
 
 export const name = "web-search-ollama";
 
-/** 只往 `ctx.web` 注册后端，不发布服务。 */
+// 只往 `ctx.web` 注册后端，不发布服务。
 export const inject = ["web"];
 
-/** 与 `llm-pi-ai` 的 ollama route 共用同一个 key 引用。 */
+// 与 `llm-pi-ai` 的 ollama route 共用同一个 key 引用。
 const DEFAULT_API_KEY_ENV = "OLLAMA_API_KEY";
 
 export interface Config {
-  /** 字面 key；优先用 `apiKeyEnv` 走凭证服务，别把密钥写进配置文件。 */
+  // 字面 key；优先用 `apiKeyEnv` 走凭证服务，别把密钥写进配置文件。
   apiKey?: string;
-  /** 每次搜索解析一次的凭证引用；缺省 `OLLAMA_API_KEY`。 */
+  // 每次搜索解析一次的凭证引用；缺省 `OLLAMA_API_KEY`。
   apiKeyEnv?: string;
-  /** 端点根；`/api/web_search` 由 provider 拼。缺省 ollama.com。 */
+  // 端点根；`/api/web_search` 由 provider 拼。缺省 ollama.com。
   baseURL?: string;
-  /** 请求没带 `maxResults` 时的默认结果数；省略表示让 Ollama 用自己的默认。 */
+  // 请求没带 `maxResults` 时的默认结果数；省略表示让 Ollama 用自己的默认。
   maxResults?: number;
 }
 
-/**
- * schema 解析之后的形状：四个字段都是 **volatile 稳定引用**，读它要过 `.get()`。
- *
- * 它们都标了 `.volatile()`（插件行里唯一可实时改的字段），所以设置页改完不用重挂这一行：provider 的每一次
- * 请求、每一次取 key 都现场读引用。
- */
+// schema 解析之后的形状：四个字段都是 **volatile 稳定引用**（插件行里唯一可实时改的字段），读它要过 `.get()`。
+// 设置页改完不用重挂这一行：provider 的每次请求、每次取 key 都现场读引用。
 export interface ResolvedConfig {
   readonly apiKey: Volatile<string | undefined>;
   readonly apiKeyEnv: Volatile<string | undefined>;
@@ -49,10 +45,8 @@ export interface ResolvedConfig {
   readonly maxResults: Volatile<number | undefined>;
 }
 
-/**
- * 本地化说明：`description()` 的类型签名只声明 `string`，而 meta 本身接受 `Dict<string>`
- * （`vendor/schemastery/src/index.ts` 的 `mergeDesc` 就是按字典合并的），所以这里只做一次类型放行。
- */
+// 本地化说明：`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({

package/src/provider.ts

@@ -7,34 +7,34 @@ import type {
 } from "@deepseek-ai/dsh-web";
 import type { OllamaError, OllamaSearchResponse, OllamaSearchResult } from "./types.ts";
 
-/** 注册进 `ctx.web` 的 id；与 llm route 同名，配置里看到的就是同一个"ollama"。 */
+// 注册进 `ctx.web` 的 id；与 llm route 同名，配置里看到的就是同一个"ollama"。
 export const OLLAMA_PROVIDER_ID = "ollama";
 
-/** 默认端点；`/api/web_search` 是操作。 */
+// 默认端点；`/api/web_search` 是操作。
 export const OLLAMA_DEFAULT_BASE_URL = "https://ollama.com";
 
-/** Ollama 服务端自己的默认结果数。 */
+// Ollama 服务端自己的默认结果数。
 export const OLLAMA_DEFAULT_MAX_RESULTS = 5;
 
-/** Ollama `max_results` 的硬上限；超过它的值不发给服务端。 */
+// Ollama `max_results` 的硬上限；超过它的值不发给服务端。
 export const OLLAMA_MAX_RESULTS_LIMIT = 10;
 
-/** 每次请求带的归属头。 */
+// 每次请求带的归属头。
 const USER_AGENT = "morlay-dsh-plugin/0.0.1";
 
 export interface OllamaSearchProviderOptions {
-  /** 字面 key；给了就压过 {@link resolveApiKey}。 */
+  // 字面 key；给了就压过 `resolveApiKey`。
   apiKey?: string | undefined;
-  /** 运行期取 key 的入口（凭证服务 / 环境）；返回空表示取不到。 */
+  // 运行期取 key 的入口（凭证服务 / 环境）；返回空表示取不到。
   resolveApiKey?: () => Promise<string | undefined>;
-  /** 取不到 key 时报出来的引用名，便于用户知道去哪配。 */
+  // 取不到 key 时报出来的引用名，便于用户知道去哪配。
   apiKeyEnv: string;
   baseURL: string;
-  /** 请求没给 `maxResults` 时用的默认值；省略表示让 Ollama 用它自己的默认。 */
+  // 请求没给 `maxResults` 时用的默认值；省略表示让 Ollama 用它自己的默认。
   maxResults?: number | undefined;
 }
 
-/** 一条 Ollama 结果 → 一个 source；没有 url 就丢掉（seam 的 source 必须有 url）。 */
+// 一条 Ollama 结果 → 一个 source；没有 url 就丢掉（seam 的 source 必须有 url）。
 export function mapOllamaResult(result: OllamaSearchResult): WebSearchSource | undefined {
   const url = result.url;
   if (typeof url !== "string" || url.length === 0) return undefined;
@@ -49,7 +49,7 @@ export function mapOllamaResult(result: OllamaSearchResult): WebSearchSource | u
   };
 }
 
-/** 响应信封 → 归一化结果；形状不对就抛（由调用方包成 `WEB_PROVIDER_ERROR`）。 */
+// 响应信封 → 归一化结果；形状不对就抛（由调用方包成 `WEB_PROVIDER_ERROR`）。
 export function mapOllamaResponse(response: OllamaSearchResponse): WebSearchResult {
   const results = response.results;
   if (results !== undefined && !Array.isArray(results)) {
@@ -63,7 +63,7 @@ export function mapOllamaResponse(response: OllamaSearchResponse): WebSearchResu
   return { sources, truncated: false };
 }
 
-/** Ollama 的搜索后端；HTTP 重定向按 `WEB_PROVIDER_ERROR` 失败。 */
+// Ollama 的搜索后端；HTTP 重定向按 `WEB_PROVIDER_ERROR` 失败。
 export class OllamaSearchProvider implements WebSearchProvider {
   readonly id = OLLAMA_PROVIDER_ID;
 
@@ -133,7 +133,7 @@ export class OllamaSearchProvider implements WebSearchProvider {
     }
   }
 
-  /** 一次操作一份 key，不留在 provider 上；没有可用的 key 就点名引用，而不是发无授权请求。 */
+  // 一次操作一份 key，不留在 provider 上；没有可用的 key 就点名引用，而不是发无授权请求。
   private async apiKey(): Promise<string> {
     const literal = this.options.apiKey;
     if (literal !== undefined && literal.length > 0) return literal;

package/src/rows.ts

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

package/src/types.ts

@@ -1,29 +1,27 @@
-/**
- * POST https://ollama.com/api/web_search 的 wire 类型。只有类型，没有运行期代码。
- *
- * 响应是扁平 `results[]`，每条带 title / url / content；`content` 是 Ollama 自己截出来的
- * 网页片段（不是生成式答案），所以它只映射到 `WebSearchSource.snippet`。
- */
+// POST https://ollama.com/api/web_search 的 wire 类型。只有类型，没有运行期代码。
+//
+// 响应是扁平 `results[]`，每条带 title / url / content；`content` 是 Ollama 截出来的网页片段（不是生成式
+// 答案），只映射到 `WebSearchSource.snippet`。
 
-/** 请求体。`max_results` 缺省时由服务端按自己的默认值（5）处理。 */
+// 请求体。`max_results` 缺省时由服务端按自己的默认值（5）处理。
 export interface OllamaSearchRequest {
   query: string;
   max_results?: number;
 }
 
-/** `results[]` 的一条；字段都可能缺失或为空串。 */
+// `results[]` 的一条；字段都可能缺失或为空串。
 export interface OllamaSearchResult {
   title?: string | null;
   url?: string | null;
   content?: string | null;
 }
 
-/** 成功响应信封。 */
+// 成功响应信封。
 export interface OllamaSearchResponse {
   results?: OllamaSearchResult[];
 }
 
-/** 错误响应信封；Ollama 失败时给 `{"error": "..."}`。 */
+// 错误响应信封；Ollama 失败时给 `{"error": "..."}`。
 export interface OllamaError {
   error?: string;
 }