dsh-web-search-free 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MochiNek0
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.en.md

@@ -0,0 +1,136 @@
+# dsh-web-search-free
+
+English | [中文](README.md)
+
+A free Web Search / web fetch plugin for [DeepSeek Harness (dsh)](https://github.com/deepseek-ai/dsh).
+
+It replaces dsh's default `deepseek-official` search/fetch channel with a **multi-engine + automatic fallback** channel: you provide API keys for whichever engines you choose, and it tries them in the order you arrange; if one fails (or runs out of quota) it automatically falls through to the next. A single engine may also carry multiple keys (one per line), rotated in order within that engine. All requests are issued from your browser side, never through the official search backend.
+
+- Registers as a dsh `web` capability channel (providing both `searchProvider` and `fetchProvider`, both with id `web-search-free`).
+- Ships a Web settings card (Settings → Plugins → **Web Search Free**) with drag-to-reorder and per-engine key entry.
+- Installs as a dsh bundle layer: installing takes over web search/fetch, uninstalling auto-reverts to the default channel — no manual profile edits.
+
+## Why "free": the billing difference vs. the official channel
+
+dsh's default official channel `deepseek-official` (provided by `@deepseek-ai/dsh-web-search-deepseek`) is **not a dedicated search endpoint**: every search issues a **full Messages model call** (`POST …/anthropic/v1/messages` with the native `web_search` server tool), DeepSeek runs the search server-side and returns structured result blocks. So each search burns two sets of tokens:
+
+1. **The auxiliary search request itself** — an independent model receives `Perform a web search for the query: <query>` plus a tool definition and incurs input + output tokens (`maxTokens` defaults to 4096, `maxUses` to 5); it's a complete model turn, billed for latency and generation like any model call.
+2. **The results re-entering the conversation** — the parsed sources (URL/title/snippet) are injected back into the conversation model's context and resent as conversation tokens until compaction.
+
+Both are charged against your `DEEPSEEK_API_KEY` balance.
+
+This plugin instead calls each engine's **dedicated retrieval endpoint** (e.g. Tavily `/search`, Exa `/search`, Jina `s.jina.ai`) — pure retrieval, never touching any LLM:
+
+| | Official `deepseek-official` | This plugin `web-search-free` |
+|---|---|---|
+| Retrieval method | One full LLM model call + server-side search tool | Direct calls to each engine's dedicated retrieval endpoint |
+| Model tokens | Burned every search (input + output) | **0** (pure retrieval, no LLM involved) |
+| Billed against | DeepSeek API balance | Each search API's own quota (most have a free tier) |
+| Credentials | `DEEPSEEK_API_KEY` | Per-engine API keys |
+
+That's the core reason the plugin is named "free" — the official channel burns a whole model turn per search, while this one does pure retrieval and burns zero tokens.
+
+## Supported engines
+
+| Engine | Search | Fetch | Get an API key |
+|---|:---:|:---:|---|
+| Jina AI | ✓ | ✓ | <https://jina.ai/api-key> |
+| Exa (Metaphor) | ✓ | ✓ | <https://dashboard.exa.ai/> |
+| Tavily | ✓ | ✓ | <https://app.tavily.com/> |
+| Firecrawl | ✓ | ✓ | <https://www.firecrawl.dev/> |
+| Brave Search | ✓ | ✗ | <https://api-dashboard.search.brave.com/register> |
+
+> Brave supports search only, not URL fetch. If your fetch chain only has a Brave key configured, fetch will fail — please also configure a key for an engine that supports fetch.
+
+## Prerequisites
+
+- dsh installed, with the `dsh` command available (when developing inside a dsh source checkout, use `pnpm dsh ...` instead).
+- `pnpm` on your `PATH` (`dsh plugin` manages dependencies via pnpm inside the profile directory).
+- The target profile is usually `web` (this plugin's client half declares `platform: web`; the settings card only appears in the Web UI). The `web` profile auto-initializes from a template on first use.
+
+## Installation
+
+`dsh plugin --profile <name> <pnpm args>` forwards the pnpm arguments into the profile directory and, **after a successful run, automatically reconciles `dsh.profile.bundles`**: any dependency that resolves to a package declaring `dsh.bundle` is appended to the bundle layer stack — this plugin declares exactly `dsh.bundle.patch`, so installing it takes over web search/fetch with no manual profile edit.
+
+### From npm (recommended)
+
+```sh
+dsh plugin --profile web add dsh-web-search-free
+```
+
+### From local source (for development / further hacking)
+
+This repo gitignores `dist/`, so build the artifacts before installing.
+
+```sh
+# 1) Build in the plugin repo
+cd /path/to/dsh-web-search-free
+pnpm install
+pnpm build            # produces dist/index.js and dist/client.js
+
+# 2) Add it to the web profile (run inside the plugin dir; "." is anchored to the cwd)
+dsh plugin --profile web add .
+```
+
+> You can also use an absolute path and run from anywhere:
+> `dsh plugin --profile web add /absolute/path/to/dsh-web-search-free`
+>
+> pnpm installs local directories as a link by default, so **rebuilding with `pnpm build` from source is picked up by the profile immediately** — handy for iteration. After changing the client half, refresh the browser (client-plugin hot-reload requires a rebuild watcher like `pnpm run dev:web` to be running).
+
+## Configuration
+
+After installing, start the dsh Web UI:
+
+```sh
+dsh web          # equivalent to dsh --profile web
+```
+
+Open the **Settings → Plugins → Web Search Free** card:
+
+1. Expand the card; each row maps to one engine.
+2. Paste the API key into the matching engine's input; the in-row "Get API key ↗" link goes straight to each engine's signup page. An engine may carry multiple keys: **one per line**, rotated in order within the engine.
+3. **Drag each row** to set the call order: engines higher up are tried first, failing through to the next in order; multiple keys for the same engine are also tried in turn — the first successful (engine, key) pair returns, and only an all-fail raises an error. Engines with no key never enter the call chain.
+4. Click "Save". Keys persist through the dsh settings namespace (`web-search-free`) and take effect on the next search, with no restart.
+
+**Configure at least one engine's key**, otherwise search/fetch fails with `No web search providers configured.`
+
+## Verification
+
+1. Start the Web UI with `dsh web`.
+2. Ask the model to use web search/fetch in a conversation (e.g. "search for today's news" or "fetch the content of https://example.com").
+3. The request flows through the `web-search-free` channel in your arranged engine order; on a failure you'll see `Provider <name> ... failed. Trying next provider ...` in the logs, then the next engine is tried automatically.
+
+## Updating
+
+```sh
+# Local source: just rebuild (linked install, no reinstall needed)
+cd /path/to/dsh-web-search-free && pnpm build
+
+# npm: upgrade to a new version
+dsh plugin --profile web update dsh-web-search-free
+```
+
+`update` also triggers reconciliation: if the new version adds or drops a `dsh.bundle` declaration, the bundle layer stack follows automatically.
+
+## Uninstalling
+
+```sh
+dsh plugin --profile web remove dsh-web-search-free
+```
+
+Reconciliation removes this plugin from `dsh.profile.bundles`, and web search/fetch **auto-reverts to dsh-base's `deepseek-official` default channel** — no manual profile or patch edit.
+
+## How it works
+
+This plugin is a dsh **bundle layer** (`package.json` declares `dsh.bundle.patch: ./cordis.patch.yml`). `cordis.patch.yml` does two things:
+
+- `insert`s a `web-search-free` row to bring this plugin's host half into the composition;
+- uses a same-id `web` override layer to repoint both `searchProvider` and `fetchProvider` to `web-search-free`, overriding the `deepseek-official` that dsh-base pins.
+
+The host half (`src/index.ts`, `inject: ['web']`) registers search and fetch providers into `ctx.web`, iterating configured-key engines in `providerOrder` order with fallback; each engine's key field may hold multiple values (one per line), rotated in order within the engine. The client half (`src/client.tsx`) registers a React card on the Plugins settings page, reading and writing the same `web-search-free` settings namespace. The two halves are aligned by that namespace string.
+
+The build runs `tsc` to produce `dist/`, then `wrap-client.js` wraps `dist/client.js` as `window.__ModuleLoader__.load(...)` so it can be loaded by dsh's browser-side module loader.
+
+## License
+
+MIT, see [LICENSE](LICENSE).

package/README.md

@@ -0,0 +1,136 @@
+# dsh-web-search-free
+
+中文 | [English](README.en.md)
+
+面向 [DeepSeek Harness (dsh)](https://github.com/deepseek-ai/dsh) 的免费 Web Search / 网页抓取插件。
+
+它把 dsh 默认的 `deepseek-official` 搜索/抓取通道，替换成一个**多引擎 + 自动 fallback** 的通道：你填入哪些引擎的 API Key，它就按你排定的顺序依次尝试，前一个失败（或额度耗尽）会自动落到下一个；同一引擎也可以填多个 Key（每行一个），引擎内 Key 同样按顺序轮换。所有请求都从你的浏览器侧发起，不经过官方搜索后端。
+
+- 注册为 dsh 的 `web` 能力通道（同时提供 `searchProvider` 与 `fetchProvider`，id 均为 `web-search-free`）。
+- 自带一个 Web 设置卡片（设置 → 插件 → **Web Search Free**），可拖动排序、逐个填 Key。
+- 作为 dsh bundle 层安装：装上即接管 web 搜索/抓取，卸载即自动回落到默认通道，无需手改 profile。
+
+## 为什么是 free 的：与官方通道的计费差异
+
+dsh 默认的官方通道 `deepseek-official`（由 `@deepseek-ai/dsh-web-search-deepseek` 提供）**不是一个专用搜索端点**：每次搜索都会发起一次**完整的 Messages 模型调用**（`POST …/anthropic/v1/messages`，带原生 `web_search` 服务端工具），由 DeepSeek 在服务端执行搜索、返回结构化结果块。因此每次搜索都要烧两份 token：
+
+1. **辅助搜索请求本身**——一个独立模型收到 `Perform a web search for the query: <query>` + 工具定义，产生 input + output token（`maxTokens` 默认 4096、`maxUses` 默认 5）；这是一次完整的模型轮次，延迟与生成都按模型调用计。
+2. **结果回灌对话**——解析出的 sources（URL/标题/片段）注入回对话模型上下文，作为对话 token 一直重发直到压缩。
+
+两份都从 `DEEPSEEK_API_KEY` 余额扣除。
+
+本插件走各引擎的**专用检索端点**（如 Tavily `/search`、Exa `/search`、Jina `s.jina.ai`），是纯检索，不经任何 LLM：
+
+| | 官方 `deepseek-official` | 本插件 `web-search-free` |
+|---|---|---|
+| 检索方式 | 一次完整 LLM 模型调用 + 服务端搜索工具 | 直接调各引擎专用检索端点 |
+| 模型 token | 每次搜索都烧（input + output） | **0**（纯检索，不碰任何 LLM） |
+| 计费来源 | DeepSeek API 余额 | 各搜索 API 自身额度（多数有免费层） |
+| 凭据 | `DEEPSEEK_API_KEY` | 各引擎各自的 API Key |
+
+这正是插件名为 "free" 的核心理由——官方每次搜索烧一整轮模型 token，这里只走检索、不烧 token。
+
+## 支持的引擎
+
+| 引擎 | 搜索 | 抓取 | 获取 API Key |
+|---|:---:|:---:|---|
+| Jina AI | ✓ | ✓ | <https://jina.ai/api-key> |
+| Exa (Metaphor) | ✓ | ✓ | <https://dashboard.exa.ai/> |
+| Tavily | ✓ | ✓ | <https://app.tavily.com/> |
+| Firecrawl | ✓ | ✓ | <https://www.firecrawl.dev/> |
+| Brave Search | ✓ | ✗ | <https://api-dashboard.search.brave.com/register> |
+
+> Brave 仅支持搜索，不支持 URL 抓取。若你的抓取链路上只有 Brave 有 Key，抓取会失败——请再给一个支持抓取的引擎配上 Key。
+
+## 前置条件
+
+- 已安装 dsh，且 `dsh` 命令可用（在 dsh 源码检出里开发时用 `pnpm dsh ...` 代替）。
+- `pnpm` 在 `PATH` 上（`dsh plugin` 通过 pnpm 在 profile 目录里管理依赖）。
+- 目标 profile 一般是 `web`（本插件的客户端半边声明 `platform: web`，设置卡片只在 Web 界面出现）。`web` profile 首次使用时会从模板自动初始化。
+
+## 安装
+
+`dsh plugin --profile <name> <pnpm args>` 会把 pnpm 参数转发到 profile 目录里执行，**执行成功后自动对账 `dsh.profile.bundles`**：凡解析到声明了 `dsh.bundle` 的依赖，都会被自动追加进 bundle 层栈——本插件正好声明了 `dsh.bundle.patch`，所以装上即接管 web 搜索/抓取，无需手改 profile。
+
+### 从 npm 安装（推荐）
+
+```sh
+dsh plugin --profile web add dsh-web-search-free
+```
+
+### 从本地源码安装（开发 / 二次开发用）
+
+本仓库 `dist/` 被 gitignore，安装前需要先构建出产物。
+
+```sh
+# 1) 在插件仓库目录里构建
+cd /path/to/dsh-web-search-free
+pnpm install
+pnpm build            # 生成 dist/index.js 与 dist/client.js
+
+# 2) 装进 web profile（在插件目录里执行，"." 会被锚定到当前目录）
+dsh plugin --profile web add .
+```
+
+> 也可以用绝对路径，从任意目录执行：
+> `dsh plugin --profile web add /absolute/path/to/dsh-web-search-free`
+>
+> pnpm 对本地目录默认以链接方式安装，所以**之后在源码里重新 `pnpm build`，profile 会即时拿到新产物**，适合二次开发。改完客户端半边后刷新浏览器即可（客户端插件的热更新需要 `pnpm run dev:web` 这类重建监听在跑）。
+
+## 配置
+
+安装后启动 dsh Web 界面：
+
+```sh
+dsh web          # 等价于 dsh --profile web
+```
+
+打开 **设置 → 插件 → Web Search Free** 卡片：
+
+1. 点开卡片，每一行对应一个引擎。
+2. 在对应引擎的输入框粘贴 API Key，点行内「获取 API Key ↗」可直达各引擎的申请页。每个引擎支持填多个 Key：**每行一个**，引擎内会按行顺序轮换。
+3. **拖动每一行**调整调用顺序：排在前面的引擎优先调用，失败则按顺序 fallback；同一引擎的多个 Key 也会逐个尝试，任一 (引擎, Key) 成功即返回，全部失败才报错。未填 Key 的引擎不进入调用链。
+4. 点「保存」。Key 通过 dsh 的设置命名空间（`web-search-free`）持久化，下一次搜索即时生效，无需重启。
+
+**至少配置一个引擎的 Key**，否则搜索/抓取会以 `No web search providers configured.` 报错。
+
+## 验证
+
+1. `dsh web` 启动 Web 界面。
+2. 在对话里让模型用 Web 搜索/抓取（例如「搜一下今天的新闻」或「抓取 https://example.com 的内容」）。
+3. 请求会经 `web-search-free` 通道按你排定的引擎顺序执行；某个引擎失败时会在日志里看到 `Provider <name> ... failed. Trying next provider ...`，随后自动尝试下一个。
+
+## 更新
+
+```sh
+# 本地源码：重新构建即可（链接安装，无需重装）
+cd /path/to/dsh-web-search-free && pnpm build
+
+# npm：升级到新版本
+dsh plugin --profile web update dsh-web-search-free
+```
+
+`update` 同样会触发对账：新版本若新增/移除了 `dsh.bundle` 声明，bundle 层栈会自动跟进。
+
+## 卸载
+
+```sh
+dsh plugin --profile web remove dsh-web-search-free
+```
+
+对账会把本插件从 `dsh.profile.bundles` 移除，web 搜索/抓取**自动回落到 dsh-base 的 `deepseek-official` 默认通道**——无需手改 profile 或 patch。
+
+## 工作原理
+
+本插件是一个 dsh **bundle 层**（`package.json` 里声明 `dsh.bundle.patch: ./cordis.patch.yml`）。`cordis.patch.yml` 做两件事：
+
+- `insert` 一行 `web-search-free`，把本插件的宿主半边纳入组合；
+- 用一条同 id 的 `web` 覆盖层，把 `searchProvider` 与 `fetchProvider` 都重指到 `web-search-free`，从而盖过 `dsh-base` 里钉死的 `deepseek-official`。
+
+宿主半边（`src/index.ts`，`inject: ['web']`）向 `ctx.web` 注册搜索与抓取 provider，内部按 `providerOrder` 顺序遍历「已配 Key」的引擎做 fallback；每个引擎的 Key 字段可填多个（每行一个），引擎内也会按行顺序逐个轮换。客户端半边（`src/client.tsx`）在「插件」设置页注册一张 React 卡片，读写同一命名空间 `web-search-free` 的设置。两层靠这个命名空间字符串对齐。
+
+构建时 `tsc` 产出 `dist/`，随后 `wrap-client.js` 把 `dist/client.js` 包成 `window.__ModuleLoader__.load(...)`，使其能被 dsh 的浏览器侧模块加载器加载。
+
+## 许可证
+
+MIT，见 [LICENSE](LICENSE)。

package/cordis.patch.yml

@@ -0,0 +1,23 @@
+# dsh bundle patch for dsh-web-search-free.
+#
+# Applied as a profile layer in dsh.profile.bundles order; later layers
+# override earlier ones by entry id, so the `web` row repoint below wins
+# over dsh-base's `searchProvider: deepseek-official`. Installing this plugin
+# into a profile's bundles routes web search/fetch through it; removing the
+# plugin drops this layer and the base route returns — no manual profile
+# patch needed.
+#
+# The web seam selects by provider id; `web-search-free` is the id this
+# plugin's host half registers, and its own `providerOrder` setting governs
+# the per-backend fallback sequence inside the provider.
+- insert:
+    - id: web-search-free
+      name: 'dsh-web-search-free'
+
+# Repoint the web capability seam at this plugin's provider. dsh-base pins
+# `searchProvider: deepseek-official`; a non-insert patch with a matching id
+# overrides that entry's config wholesale, so both capabilities resolve here.
+- id: web
+  config:
+    searchProvider: web-search-free
+    fetchProvider: web-search-free

package/dist/client.d.ts

@@ -0,0 +1,2 @@
+export declare const inject: string[];
+export declare function apply(ctx: any): void;

package/dist/client.js

@@ -0,0 +1,267 @@
+window.__ModuleLoader__.load({
+  id: "dsh-web-search-free",
+  factory: (require) => {
+    var module = { exports: {} };
+    var exports = module.exports;
+    
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.inject = void 0;
+exports.apply = apply;
+const React = __importStar(require("react"));
+/**
+ * Must equal the namespace the Host half registers: the Plugins settings tab
+ * dispatches `settings.plugin.item` once per served namespace, using it as the
+ * keyed slot's entry key.
+ */
+const NAMESPACE = 'web-search-free';
+/** All backends the host half knows about; the order here is the default fallback. */
+const PROVIDERS = [
+    { key: 'jina', field: 'jinaApiKey', label: 'Jina AI', signup: 'https://jina.ai/api-key' },
+    { key: 'exa', field: 'exaApiKey', label: 'Exa (Metaphor)', signup: 'https://dashboard.exa.ai/' },
+    { key: 'tavily', field: 'tavilyApiKey', label: 'Tavily', signup: 'https://app.tavily.com/' },
+    { key: 'firecrawl', field: 'firecrawlApiKey', label: 'Firecrawl', signup: 'https://www.firecrawl.dev/' },
+    { key: 'brave', field: 'braveApiKey', label: 'Brave Search', signup: 'https://api-dashboard.search.brave.com/register' },
+];
+const DEFAULT_ORDER = PROVIDERS.map((p) => p.key);
+const byKey = (key) => PROVIDERS.find((p) => p.key === key);
+/** Split a multi-key field into trimmed, non-empty lines. */
+const parseKeys = (raw) => (raw || '').split(/\r?\n/).map((s) => s.trim()).filter(Boolean);
+/** Canonical storage form: one key per line, no blanks, trimmed. */
+const normalizeKeys = (raw) => parseKeys(raw).join('\n');
+// `settingsScope.bind` reads `connection` and `remote` off the CALLING context,
+// so both must be declared here alongside the services this plugin uses itself.
+exports.inject = ['slots', 'settingsScope', 'connection', 'remote'];
+function apply(ctx) {
+    const scope = ctx.settingsScope.bind({ namespace: NAMESPACE });
+    ctx.slots.inject('settings.plugin.item', () => ctx.slots.register({
+        name: 'settings.plugin.item',
+        key: NAMESPACE,
+        inject: () => ({ scope }),
+    }, WebSearchFreeCard));
+}
+function WebSearchFreeCard({ scope }) {
+    const snapshot = React.useSyncExternalStore(React.useCallback((listener) => scope.subscribe(listener), [scope]), () => scope.getSnapshot());
+    const [open, setOpen] = React.useState(false);
+    const [keyDrafts, setKeyDrafts] = React.useState({});
+    const [orderDraft, setOrderDraft] = React.useState(null);
+    const [dragKey, setDragKey] = React.useState(null);
+    const [dropTarget, setDropTarget] = React.useState(null);
+    const [saving, setSaving] = React.useState(false);
+    const [failed, setFailed] = React.useState('');
+    const storedKey = (field) => {
+        const value = snapshot.value?.[field];
+        return typeof value === 'string' ? value : '';
+    };
+    const storedOrder = () => {
+        const raw = snapshot.value?.providerOrder;
+        if (Array.isArray(raw) && raw.length > 0)
+            return raw.filter((k) => PROVIDERS.some((p) => p.key === k));
+        return DEFAULT_ORDER;
+    };
+    const order = orderDraft ?? storedOrder();
+    const keyDirty = PROVIDERS.filter((p) => p.field in keyDrafts && normalizeKeys(keyDrafts[p.field]) !== normalizeKeys(storedKey(p.field)));
+    const orderDirty = orderDraft !== null && JSON.stringify(orderDraft) !== JSON.stringify(storedOrder());
+    const dirty = keyDirty.length > 0 || orderDirty;
+    const disabled = saving || snapshot.writable === false;
+    const save = async () => {
+        setSaving(true);
+        setFailed('');
+        const pending = keyDirty.map((p) => ({ field: p.field, value: normalizeKeys(keyDrafts[p.field]) }));
+        for (const { field, value } of pending) {
+            if (value === '')
+                await scope.unset(field);
+            else
+                await scope.set(field, value);
+        }
+        if (orderDirty && orderDraft !== null)
+            await scope.set('providerOrder', orderDraft);
+        // Writes swallow wire and revision failures and reload instead of throwing,
+        // so the Host's readback is the only authority on what actually landed.
+        const after = scope.getSnapshot();
+        const rejectedKeys = pending.filter(({ field, value }) => (after.value?.[field] ?? '') !== value);
+        const orderLanded = JSON.stringify(after.value?.providerOrder ?? DEFAULT_ORDER) === JSON.stringify(orderDraft ?? storedOrder());
+        setKeyDrafts(Object.fromEntries(rejectedKeys.map(({ field, value }) => [field, value])));
+        if (!orderLanded)
+            setOrderDraft(null);
+        if (rejectedKeys.length > 0 || !orderLanded)
+            setFailed('部分字段未保存成功，请重试。');
+        setSaving(false);
+    };
+    const reorder = (from, to) => {
+        if (from === to)
+            return;
+        const next = [...order];
+        const [moved] = next.splice(from, 1);
+        next.splice(to, 0, moved);
+        setOrderDraft(next);
+    };
+    const indexOfKey = (key) => order.indexOf(key);
+    const cardBody = () => {
+        if (snapshot.status === 'loading')
+            return [text('正在读取设置…')];
+        if (snapshot.status === 'unavailable')
+            return [text('该连接不同步设置，无法在此配置。')];
+        const children = [];
+        children.push(React.createElement('div', { style: { fontSize: 13, color: 'var(--dsw-alias-label-tertiary)' } }, '拖动每一行调整调用顺序：排在前面的引擎优先调用，失败则 fallback 到下一个。每个引擎可填多个 Key（每行一个），同一引擎内也会按顺序轮换。未填 Key 的引擎不进入调用链。'));
+        // One row per provider; the row's vertical position IS providerOrder, so the
+        // key inputs double as the order controls — no separate list to render.
+        children.push(React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 8 } }, ...order.map((key, index) => {
+            const provider = byKey(key);
+            const keyCount = parseKeys(keyDrafts[provider.field] ?? storedKey(provider.field)).length;
+            const hasKey = keyCount > 0;
+            const isDragging = dragKey === key;
+            const isDropTarget = dropTarget === key;
+            return React.createElement('div', {
+                key,
+                draggable: !disabled,
+                onDragStart: (e) => { setDragKey(key); e.dataTransfer.effectAllowed = 'move'; e.dataTransfer.setData('text/plain', key); },
+                onDragEnd: () => { setDragKey(null); setDropTarget(null); },
+                onDragOver: (e) => { e.preventDefault(); e.dataTransfer.dropEffect = 'move'; if (dragKey && dragKey !== key)
+                    setDropTarget(key); },
+                onDrop: (e) => {
+                    e.preventDefault();
+                    if (dragKey && dragKey !== key)
+                        reorder(indexOfKey(dragKey), index);
+                    setDragKey(null);
+                    setDropTarget(null);
+                },
+                style: {
+                    display: 'flex', alignItems: 'center', gap: 8, fontSize: 13,
+                    borderRadius: 8, padding: '8px 10px',
+                    border: isDropTarget ? '1px dashed var(--dsw-alias-brand-primary)' : '1px solid var(--dsw-alias-border-l2)',
+                    background: isDragging ? 'var(--dsw-alias-bg-layer-2)' : 'var(--dsw-alias-bg-layer-3)',
+                    opacity: isDragging ? 0.5 : 1,
+                    cursor: disabled ? 'default' : 'grab',
+                },
+            }, React.createElement('span', {
+                style: { flex: 'none', color: 'var(--dsw-alias-label-tertiary)', fontSize: 13, userSelect: 'none' },
+            }, '⋮⋮'), React.createElement('span', {
+                style: {
+                    whiteSpace: 'nowrap', borderRadius: 999, padding: '1px 8px', fontSize: 11, fontWeight: 500, lineHeight: '17px', flex: 'none',
+                    ...(hasKey
+                        ? { background: 'var(--dsw-alias-bg-module-platform)', color: 'var(--dsw-alias-label-secondary)' }
+                        : { color: 'var(--dsw-alias-label-tertiary)' }),
+                },
+            }, hasKey ? `#${index + 1}` : '—'), React.createElement('div', { style: { display: 'flex', flexDirection: 'column', gap: 4, flex: 1, minWidth: 0 } }, React.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: 8, minWidth: 0 } }, React.createElement('span', { style: { color: hasKey ? 'var(--dsw-alias-label-primary)' : 'var(--dsw-alias-label-tertiary)', fontWeight: 500 } }, provider.label), React.createElement('a', {
+                href: provider.signup,
+                target: '_blank',
+                rel: 'noreferrer',
+                onClick: (e) => e.stopPropagation(),
+                style: { fontSize: 12, color: 'var(--dsw-alias-brand-primary)', textDecoration: 'none', flex: 'none' },
+            }, '获取 API Key ↗')), React.createElement('textarea', {
+                rows: 2,
+                autoComplete: 'off',
+                spellCheck: false,
+                value: keyDrafts[provider.field] ?? storedKey(provider.field),
+                disabled,
+                placeholder: '每行一个 API Key，支持多 Key 轮换',
+                onChange: (event) => setKeyDrafts({ ...keyDrafts, [provider.field]: event.target.value }),
+                style: { ...inputStyle, height: 'auto', minHeight: 30, resize: 'vertical', padding: '6px 12px', fontFamily: 'ui-monospace, SFMono-Regular, Menlo, monospace', lineHeight: '20px' },
+            }), React.createElement('div', { style: { fontSize: 11, color: 'var(--dsw-alias-label-tertiary)' } }, keyCount > 0 ? `${keyCount} 个 Key · 按顺序轮换` : '未配置')));
+        })));
+        children.push(React.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: 8, justifyContent: 'flex-end', borderTop: '1px solid var(--dsw-alias-border-l2)', paddingTop: 12 } }, failed === '' ? null : React.createElement('span', {
+            style: { flex: 1, minWidth: 0, fontSize: 12, color: 'var(--dsw-alias-label-error)' },
+        }, failed), React.createElement('button', {
+            type: 'button',
+            disabled: disabled || !dirty,
+            onClick: () => { setKeyDrafts({}); setOrderDraft(null); setFailed(''); },
+            style: { ...btnOutlineStyle, ...(disabled || !dirty ? { opacity: 0.4, cursor: 'default' } : {}) },
+        }, '放弃'), React.createElement('button', {
+            type: 'button',
+            disabled: disabled || !dirty,
+            onClick: save,
+            style: { ...btnPrimaryStyle, ...(disabled || !dirty ? { opacity: 0.4, cursor: 'default' } : {}) },
+        }, saving ? '保存中…' : '保存')));
+        return children;
+    };
+    return React.createElement('li', {
+        style: {
+            listStyle: 'none',
+            borderRadius: 12,
+            border: '1px solid var(--dsw-alias-border-l2)',
+            background: open ? 'var(--dsw-alias-bg-layer-2)' : 'var(--dsw-alias-bg-layer-3)',
+            transition: 'border-color .16s, background .16s',
+        },
+    }, React.createElement('button', {
+        type: 'button',
+        onClick: () => setOpen(!open),
+        style: {
+            appearance: 'none', width: '100%', font: 'inherit', textAlign: 'left', cursor: 'pointer',
+            background: 'none', border: '0', borderRadius: 12, color: 'inherit',
+            display: 'flex', alignItems: 'center', gap: 12, padding: '14px 16px',
+        },
+    }, React.createElement('div', { style: { display: 'flex', flexDirection: 'column', flex: 1, gap: 2, minWidth: 0 } }, React.createElement('div', { style: { display: 'flex', alignItems: 'center', gap: 8 } }, React.createElement('span', { style: { fontSize: 15, fontWeight: 600, color: 'var(--dsw-alias-label-primary)' } }, 'Web Search Free'), dirty ? React.createElement('span', {
+        style: { whiteSpace: 'nowrap', background: 'var(--dsw-alias-bg-module-platform)', color: 'var(--dsw-alias-label-secondary)', borderRadius: 999, padding: '1px 8px', fontSize: 11, fontWeight: 500, lineHeight: '17px' },
+    }, '未保存') : null), React.createElement('div', { style: { fontSize: 13, color: 'var(--dsw-alias-label-tertiary)' } }, '免费多引擎 Web Search（拖动排序 · 按 providerOrder 顺序 fallback）')), React.createElement('span', {
+        style: { color: 'var(--dsw-alias-label-tertiary)', display: 'inline-flex', flex: 'none', transition: 'transform .16s', transform: open ? 'rotate(180deg)' : 'none' },
+    }, React.createElement('svg', {
+        width: 14, height: 14, viewBox: '0 0 14 14', fill: 'none', 'aria-hidden': true,
+    }, React.createElement('path', {
+        d: 'M3.5 5.5L7 9l3.5-3.5',
+        stroke: 'currentColor', strokeWidth: 1.5, strokeLinecap: 'round', strokeLinejoin: 'round',
+    })))), open ? React.createElement('div', {
+        style: { display: 'flex', flexDirection: 'column', gap: 16, margin: '0 16px 4px', borderTop: '1px solid var(--dsw-alias-border-l2)', paddingTop: 12 },
+    }, ...cardBody()) : null);
+}
+const inputStyle = {
+    height: 34,
+    padding: '0 12px',
+    font: 'inherit',
+    fontSize: 13,
+    borderRadius: 8,
+    border: '1px solid var(--dsw-alias-border-l2)',
+    background: 'var(--dsw-alias-bg-layer-3)',
+    color: 'var(--dsw-alias-label-primary)',
+};
+const btnOutlineStyle = {
+    font: 'inherit', fontSize: 13, padding: '5px 14px', borderRadius: 8, cursor: 'pointer',
+    border: '1px solid var(--dsw-alias-border-l2)', background: 'none',
+    color: 'var(--dsw-alias-label-secondary)',
+};
+const btnPrimaryStyle = {
+    font: 'inherit', fontSize: 13, padding: '5px 14px', borderRadius: 8, cursor: 'pointer',
+    border: '1px solid transparent', background: 'var(--dsw-alias-label-primary)',
+    color: 'var(--dsw-alias-bg-layer-3)',
+};
+function text(value) {
+    return React.createElement('span', { style: { fontSize: 13, color: 'var(--dsw-alias-label-tertiary)' } }, value);
+}
+
+
+    return module.exports;
+  }
+});

package/dist/index.d.ts

@@ -0,0 +1,26 @@
+import { Context, Schema } from 'cordis';
+export declare const name = "web-search-free";
+export declare const inject: string[];
+/**
+ * Settings namespace this plugin owns. The browser card in `./client` is keyed
+ * on this string: the Plugins settings tab dispatches `settings.plugin.item`
+ * per namespace the Host serves, so the two halves must spell it identically.
+ */
+export declare const SETTINGS_NAMESPACE = "web-search-free";
+export interface Config {
+    jinaApiKey?: string;
+    exaApiKey?: string;
+    tavilyApiKey?: string;
+    firecrawlApiKey?: string;
+    braveApiKey?: string;
+    providerOrder: ('jina' | 'exa' | 'tavily' | 'firecrawl' | 'brave')[];
+}
+export declare const Config: Schema<Config>;
+declare module 'cordis' {
+    interface Context {
+        web: any;
+        logger: any;
+        settings: any;
+    }
+}
+export declare function apply(ctx: Context, config: Config): void;

package/dist/index.js

@@ -0,0 +1,127 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = exports.SETTINGS_NAMESPACE = exports.inject = exports.name = void 0;
+exports.apply = apply;
+const cordis_1 = require("cordis");
+const providers_1 = require("./providers");
+exports.name = 'web-search-free';
+exports.inject = ['web'];
+/**
+ * Settings namespace this plugin owns. The browser card in `./client` is keyed
+ * on this string: the Plugins settings tab dispatches `settings.plugin.item`
+ * per namespace the Host serves, so the two halves must spell it identically.
+ */
+exports.SETTINGS_NAMESPACE = 'web-search-free';
+exports.Config = cordis_1.Schema.object({
+    jinaApiKey: cordis_1.Schema.string().description('API key(s) for Jina AI. One key per line for multi-key rotation.'),
+    exaApiKey: cordis_1.Schema.string().description('API key(s) for Exa (Metaphor). One key per line for multi-key rotation.'),
+    tavilyApiKey: cordis_1.Schema.string().description('API key(s) for Tavily. One key per line for multi-key rotation.'),
+    firecrawlApiKey: cordis_1.Schema.string().description('API key(s) for Firecrawl. One key per line for multi-key rotation.'),
+    braveApiKey: cordis_1.Schema.string().description('API key(s) for Brave Search. One key per line for multi-key rotation.'),
+    providerOrder: cordis_1.Schema.array(cordis_1.Schema.union(['jina', 'exa', 'tavily', 'firecrawl', 'brave']))
+        .default(['jina', 'exa', 'tavily', 'firecrawl', 'brave'])
+        .description('定义 Provider 的调用顺序。排在前面的服务会优先执行，如果请求失败（或额度用尽），会自动按照该顺序 fallback 到下一个可用服务。')
+});
+/** Short, non-leaking token for log lines so a failing key is identifiable without printing it. */
+function maskKey(key) {
+    if (!key)
+        return '***';
+    if (key.length <= 8)
+        return '***';
+    return `${key.slice(0, 4)}…${key.slice(-3)}`;
+}
+function apply(ctx, config) {
+    const logger = ctx.logger?.('web-search-free') || console;
+    // Register the settings namespace so the user layer (written by the Plugins
+    // settings card) exists at all: a namespace the Host does not serve is never
+    // dispatched to a card. Each call projects the section fresh, so a key saved
+    // in the UI reaches the next search without a restart.
+    let resolved = () => config;
+    ctx.inject(['settings'], (sctx) => {
+        const scope = sctx.settings.register(exports.SETTINGS_NAMESPACE, exports.Config, { base: config });
+        resolved = () => scope.get();
+        sctx.effect(() => () => {
+            resolved = () => config;
+        });
+    });
+    const getActiveProviders = () => {
+        const current = resolved();
+        const activeProviders = [];
+        const orderedNames = Array.from(new Set([
+            ...(current.providerOrder || []),
+            ...Object.keys(providers_1.availableProviders)
+        ]));
+        for (const name of orderedNames) {
+            const provider = providers_1.availableProviders[name];
+            if (!provider)
+                continue;
+            const configKey = `${name}ApiKey`;
+            const raw = current[configKey];
+            if (typeof raw === 'string' && raw.trim() !== '') {
+                // A key field may hold several keys, one per line. Empty lines and
+                // surrounding whitespace are stripped; rotation tries them in order.
+                const keys = raw.split(/\r?\n/).map(s => s.trim()).filter(Boolean);
+                if (keys.length > 0)
+                    activeProviders.push({ provider, keys });
+            }
+        }
+        return activeProviders;
+    };
+    ctx.web?.registerSearchProvider({
+        id: 'web-search-free',
+        available: () => getActiveProviders().length > 0,
+        async search(request, signal) {
+            const activeProviders = getActiveProviders();
+            if (activeProviders.length === 0) {
+                throw new Error('No web search providers configured. Please set at least one API key in config.');
+            }
+            let lastError = null;
+            for (const { provider, keys } of activeProviders) {
+                for (const key of keys) {
+                    try {
+                        const result = await provider.search(request.query, key, signal);
+                        if (typeof result === 'string') {
+                            return { content: result, sources: [], truncated: false };
+                        }
+                        return { content: result.content || '', sources: result.sources || [], truncated: false };
+                    }
+                    catch (err) {
+                        lastError = err;
+                        if (logger && logger.warn) {
+                            logger.warn(`Provider ${provider.name} (key ${maskKey(key)}) search failed: ${err.message}. Trying next key/provider...`);
+                        }
+                        continue;
+                    }
+                }
+            }
+            throw new Error(`All configured search providers failed. Last error: ${lastError?.message}`);
+        }
+    });
+    ctx.web?.registerFetchProvider({
+        id: 'web-search-free',
+        available: () => getActiveProviders().length > 0,
+        async fetch(request, signal) {
+            const activeProviders = getActiveProviders();
+            if (activeProviders.length === 0) {
+                throw new Error('No web fetch providers configured. Please set at least one API key in config.');
+            }
+            let lastError = null;
+            for (const { provider, keys } of activeProviders) {
+                for (const key of keys) {
+                    try {
+                        const resultStr = await provider.fetch(request.url, key, signal);
+                        return { url: request.url, statusCode: 200, body: { kind: 'text', content: resultStr }, truncated: false };
+                    }
+                    catch (err) {
+                        lastError = err;
+                        if (logger && logger.warn) {
+                            logger.warn(`Provider ${provider.name} (key ${maskKey(key)}) fetch failed: ${err.message}. Trying next key/provider...`);
+                        }
+                        continue;
+                    }
+                }
+            }
+            throw new Error(`All configured fetch providers failed. Last error: ${lastError?.message}`);
+        }
+    });
+}

package/dist/providers/brave.d.ts

@@ -0,0 +1,2 @@
+import { WebSearchProvider } from '../types';
+export declare const braveProvider: WebSearchProvider;

package/dist/providers/brave.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.braveProvider = void 0;
+exports.braveProvider = {
+    name: 'brave',
+    async search(query, apiKey, signal) {
+        const res = await fetch(`https://api.search.brave.com/res/v1/web/search?q=${encodeURIComponent(query)}`, {
+            method: 'GET',
+            headers: {
+                'Accept': 'application/json',
+                'X-Subscription-Token': apiKey
+            },
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Brave search failed: ${res.status} ${res.statusText}`);
+        const data = await res.json();
+        if (data.web && data.web.results && data.web.results.length > 0) {
+            return {
+                content: '',
+                sources: data.web.results.map((r) => ({
+                    url: r.url,
+                    title: r.title,
+                    snippet: r.description
+                }))
+            };
+        }
+        return 'No results found.';
+    },
+    async fetch(url, apiKey, signal) {
+        // Brave Search API is only for search queries, not content fetching/scraping.
+        throw new Error('Brave Search does not support direct URL fetching/scraping.');
+    }
+};

package/dist/providers/exa.d.ts

@@ -0,0 +1,2 @@
+import { WebSearchProvider } from '../types';
+export declare const exaProvider: WebSearchProvider;

package/dist/providers/exa.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exaProvider = void 0;
+exports.exaProvider = {
+    name: 'exa',
+    async search(query, apiKey, signal) {
+        const res = await fetch('https://api.exa.ai/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': apiKey
+            },
+            body: JSON.stringify({
+                query: query,
+                contents: {
+                    text: true
+                }
+            }),
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Exa search failed: ${res.status} ${res.statusText}`);
+        const data = await res.json();
+        if (data.results && data.results.length > 0) {
+            return {
+                content: '',
+                sources: data.results.map((r) => ({
+                    url: r.url,
+                    title: r.title,
+                    snippet: r.text || r.url
+                }))
+            };
+        }
+        return 'No results found.';
+    },
+    async fetch(url, apiKey, signal) {
+        const res = await fetch('https://api.exa.ai/contents', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'x-api-key': apiKey
+            },
+            body: JSON.stringify({
+                urls: [url],
+                text: true
+            }),
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Exa fetch failed: ${res.status} ${res.statusText}`);
+        const data = await res.json();
+        if (data.results && data.results.length > 0) {
+            return data.results[0].text || 'No content found.';
+        }
+        return 'No results found.';
+    }
+};

package/dist/providers/firecrawl.d.ts

@@ -0,0 +1,2 @@
+import { WebSearchProvider } from '../types';
+export declare const firecrawlProvider: WebSearchProvider;

package/dist/providers/firecrawl.js

@@ -0,0 +1,54 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.firecrawlProvider = void 0;
+exports.firecrawlProvider = {
+    name: 'firecrawl',
+    async search(query, apiKey, signal) {
+        const res = await fetch('https://api.firecrawl.dev/v1/search', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`
+            },
+            body: JSON.stringify({
+                query: query
+            }),
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Firecrawl search failed: ${res.status} ${res.statusText}`);
+        const data = await res.json();
+        if (data.success && data.data) {
+            return {
+                content: '', // Let sources speak for themselves
+                sources: data.data.map((r) => ({
+                    url: r.url,
+                    title: r.title,
+                    snippet: r.markdown || r.description
+                }))
+            };
+        }
+        return 'No results found.';
+    },
+    async fetch(url, apiKey, signal) {
+        const res = await fetch('https://api.firecrawl.dev/v1/scrape', {
+            method: 'POST',
+            headers: {
+                'Content-Type': 'application/json',
+                'Authorization': `Bearer ${apiKey}`
+            },
+            body: JSON.stringify({
+                url: url,
+                formats: ['markdown']
+            }),
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Firecrawl fetch failed: ${res.status} ${res.statusText}`);
+        const data = await res.json();
+        if (data.success && data.data) {
+            return data.data.markdown || 'No markdown content available.';
+        }
+        return 'Failed to fetch content.';
+    }
+};

package/dist/providers/index.d.ts

@@ -0,0 +1,2 @@
+import { WebSearchProvider } from '../types';
+export declare const availableProviders: Record<string, WebSearchProvider>;

package/dist/providers/index.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.availableProviders = void 0;
+const tavily_1 = require("./tavily");
+const firecrawl_1 = require("./firecrawl");
+const jina_1 = require("./jina");
+const exa_1 = require("./exa");
+const brave_1 = require("./brave");
+// 注册所有可用的 Providers
+exports.availableProviders = {
+    tavily: tavily_1.tavilyProvider,
+    firecrawl: firecrawl_1.firecrawlProvider,
+    jina: jina_1.jinaProvider,
+    exa: exa_1.exaProvider,
+    brave: brave_1.braveProvider,
+};

package/dist/providers/jina.d.ts

@@ -0,0 +1,2 @@
+import { WebSearchProvider } from '../types';
+export declare const jinaProvider: WebSearchProvider;

package/dist/providers/jina.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jinaProvider = void 0;
+exports.jinaProvider = {
+    name: 'jina',
+    async search(query, apiKey, signal) {
+        const res = await fetch(`https://s.jina.ai/${encodeURIComponent(query)}`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                // Jina API returns ready-to-use markdown by default
+                'Accept': 'text/plain'
+            },
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Jina search failed: ${res.status} ${res.statusText}`);
+        return await res.text();
+    },
+    async fetch(url, apiKey, signal) {
+        const res = await fetch(`https://r.jina.ai/${encodeURIComponent(url)}`, {
+            method: 'GET',
+            headers: {
+                'Authorization': `Bearer ${apiKey}`,
+                'Accept': 'text/plain'
+            },
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Jina fetch failed: ${res.status} ${res.statusText}`);
+        return await res.text();
+    }
+};

package/dist/providers/tavily.d.ts

@@ -0,0 +1,2 @@
+import { WebSearchProvider } from '../types';
+export declare const tavilyProvider: WebSearchProvider;

package/dist/providers/tavily.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.tavilyProvider = void 0;
+exports.tavilyProvider = {
+    name: 'tavily',
+    async search(query, apiKey, signal) {
+        const res = await fetch('https://api.tavily.com/search', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                api_key: apiKey,
+                query: query,
+                search_depth: 'basic',
+                include_answer: true,
+            }),
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Tavily search failed: ${res.status} ${res.statusText}`);
+        const data = await res.json();
+        return {
+            content: data.answer || '',
+            sources: data.results?.map((r) => ({
+                url: r.url,
+                title: r.title,
+                snippet: r.content
+            })) || []
+        };
+    },
+    async fetch(url, apiKey, signal) {
+        const res = await fetch('https://api.tavily.com/extract', {
+            method: 'POST',
+            headers: { 'Content-Type': 'application/json' },
+            body: JSON.stringify({
+                api_key: apiKey,
+                urls: [url],
+            }),
+            signal,
+        });
+        if (!res.ok)
+            throw new Error(`Tavily extract failed: ${res.status} ${res.statusText}`);
+        const data = await res.json();
+        if (data.results && data.results.length > 0) {
+            return data.results[0].raw_content || 'No content found.';
+        }
+        return 'No results found.';
+    }
+};

package/dist/types.d.ts

@@ -0,0 +1,14 @@
+export interface SearchSource {
+    url: string;
+    title: string;
+    snippet?: string;
+}
+export interface SearchResult {
+    content?: string;
+    sources?: SearchSource[];
+}
+export interface WebSearchProvider {
+    name: string;
+    search(query: string, apiKey: string, signal?: AbortSignal): Promise<SearchResult | string>;
+    fetch(url: string, apiKey: string, signal?: AbortSignal): Promise<string>;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "dsh-web-search-free",
+  "version": "1.1.0",
+  "description": "Free web search plugin for dsh supporting firecrawl and tavily",
+  "keywords": [
+    "dsh-plugin",
+    "web-search"
+  ],
+  "dsh": {
+    "name": "web-search-free",
+    "client": {
+      "platform": "web",
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-connection",
+        "@deepseek-ai/dsh-api-remotes",
+        "@deepseek-ai/dsh-client-ui-settings",
+        "@deepseek-ai/dsh-client-ui-settings-plugins"
+      ]
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "files": [
+    "dist",
+    "cordis.patch.yml"
+  ],
+  "exports": {
+    ".": {
+      "default": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    },
+    "./client": {
+      "default": "./dist/client.js",
+      "types": "./dist/client.d.ts"
+    },
+    "./package.json": "./package.json"
+  },
+  "koishi": {
+    "description": "免费 Web Search 与内容抓取 (支持多引擎轮询 fallback)"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc && node wrap-client.js"
+  },
+  "dependencies": {
+    "@deepseek-ai/dsh-client-ui-settings-plugins": "^0.0.1-rc.3"
+  },
+  "devDependencies": {
+    "@types/node": "^18.0.0",
+    "@types/react": "^19.2.18",
+    "cordis": "^3.0.0",
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {
+    "cordis": "^3.0.0"
+  }
+}