Skip to content

dsh-web-search-diy

Verified

dsh-web-search-diy · v2.1.1 · MIT · Web UI

DSH web search provider selected by vendor x protocol: Chat Completions, Responses, and Anthropic Messages with built-in search tools, plus the standalone search APIs of DeepSeek, Kimi, and Zhipu; four custom targets cover gateways; UI copy follows the ap

Install

dsh plugin add dsh-web-search-diy

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Tags

Creators

Readme

dsh-web-search-diy

English · 简体中文

npm 版本 许可证:MIT Node >= 18 厂商:7 协议:4 dsh 插件

DeepSeek Harness(DSH)网页搜索提供方插件。按「厂商 × 协议」为内置 web_search 工具提供后端:三种协议内置搜索(Chat Completions / Responses / Anthropic Messages)与纯工具搜索,覆盖 DeepSeek、Kimi、智谱、千问、OpenAI、Anthropic、OpenRouter,并提供四个自定义入口。结果统一归一为结构化引用来源,供调用方模型作为作答依据。插件同时内置观测页,记录每次搜索的耗时、错误与来源,并支持从旧会话日志补录历史调用。

核心能力

  • 🧭 厂商 × 协议矩阵 —— 17 个官方 target(13 完整 + 4 降级)与 4 个自定义入口;只有真实能搜索的组合会出现在厂商列表,其余放进「本版未接入的组合」并给出原因。
  • 🎛️ 配置页三层选择 —— 搜索方式 → 协议 → 厂商;字段由 Host 下发的 catalog 决定,留空即用该组合的默认值。
  • 🧩 自定义接入 —— 模板下拉只做一次性填充(选完清空、不保存);端点、路径、请求字段名与响应字段名都可覆盖。
  • 🧪 测试连接 —— 用当前草稿跑一次真实搜索(不写配置),按来源质量分档提示。
  • 🔐 凭据只写 —— API key 经凭据服务保存,不写入配置文件;引用名按厂商给出候选链。
  • 🗂️ 配置 v3 —— 按 vendor/protocol 分桶;v1/v2 读取时迁移,首次保存前备份 .v2.bak。
  • 🪜 思考档位自动降级 —— 被端点 400 拒绝的 reasoning.effort / output_config / thinking 会逐个移除后重试。
  • 📦 响应解码对 dispatcher 免疫 —— 按字节读取并按魔数解压,不受 dsh 全局 undici dispatcher 影响。
  • 📄 正文进入来源摘要 —— 纯工具搜索的长正文写入 source.summary(上限 2,000 字符),原文与 snippet 相同时不重复写;snippet 同样截到 2,000 字符。模型优先读取摘要。
  • 🚦 无凭据不暴露工具 —— 当前 target 解析不出凭据时,web_search 不再出现在模型上下文,避免调用后才报错。
  • 📊 内置观测页 —— 「配置 / 观测」一级 tab;概览给出搜索次数、成功率、P50/P95、平均来源、摘要覆盖、无来源率、空答案率、截断率、超时率、target、失败码与来源域名排行、含错误柱的成功率/P95 趋势以及最近记录;记录页按状态、搜索词筛选,展开来源明细,复制整条 JSON。
  • 🗄️ 本地观测库与历史导入 —— node:sqlite 落盘(WAL、0600、事务写入、只保留最近 50,000 条);导入扫描 $DSH_HOME/sessions 里旧的 web_search 调用,重复导入只补新增;支持 JSONL/CSV 导出与需输入 DELETE 的清空。
  • 🧱 失败分层与超时 —— HTTP 状态、网络失败与本地超时归为稳定错误码;requestTimeoutMs 默认 25 秒(测试连接 60 秒),调用方取消与超时分开记录。
  • 📅 日历时间范围与页码分页 —— 预设范围之外可用月历选择起止日期,查询与导入各自独立;记录页按页码翻页,支持 10/20/50/100 条每页与跳页。

能力矩阵

图例:✅ 完整(协议内搜索 + 可引用来源);◐ 降级(能搜,但来源或模型受限);✗ 不支持;⚙ 自定义。

厂商 Chat Completions Responses Anthropic Messages 纯工具搜索
DeepSeek ✗ ◐ 仅 deepseek-v4-pro,来源靠 open_page ✅ ✅ /v1/tools/search
Kimi ✗ 内置 $web_search 下线 ✅ web_search + include ✗ 工具 schema 无服务端搜索 ✅ /v1/tools/search
智谱 ✅ web_search tool ✅ web_search + results[] ✗ 接受但不执行 ✅ /paas/v4/web_search
千问 ◐ enable_search,无来源 ✅ action.sources(仅 url) ✅ 需 billing header ✗ 无独立 REST
OpenAI ◐ 仅 gpt-5-search-api ✅ 完整 filters / include ✗ 无该端点 ✗
Anthropic ✗ ✗ ✅ 原生 web_search ✗
OpenRouter ✅ openrouter:web_search ✅ 同一 server tool ◐ 别名,待测 ✗
自定义 ⚙ 模板 + 四变体 ⚙ 模板 + toolType ⚙ 模板 + toolType ⚙ 模板 + 8 个映射字段

完整 13 个、降级 4 个(其中 OpenRouter Anthropic 待实测)、自定义 4 个。另有 8 条 unsupported 元数据只用于折叠区说明,不生成配置桶。

安装

已发布到 npm:

dsh plugin --profile web add dsh-web-search-diy

bundle patch 会自动完成接线,无需手改 cordis.patch.yml:

  • 插入 web-search-diy loader 条目;
  • 覆盖共享 web 行:searchProvider: diy-search,并补回 fetchProvider: http(patch 会整段替换该行 config);
  • 禁用官方 web-search-deepseek 提供方。

本地开发用链接安装:

dsh plugin --profile web add link:./dsh-web-search-diy

插件把 @deepseek-ai/* 钩子声明为 peerDependencies。链接安装时先在插件目录运行一次 pnpm install;运行时 peer 由 harness 提供。

配置

配置页

位置:侧栏 插件 → 已安装插件 → dsh-web-search-diy 卡片(点击卡片即进入本插件的配置页)。页面跟随 设置 → 语言(zh、en、ja、es、fr、de、ru、pt)。

  • 搜索方式:协议内置搜索 与 纯工具搜索;纯工具没有模型回合,表单不显示模型与输出上限。
  • 协议:内置下三选一(Chat Completions / Responses / Anthropic Messages);纯工具固定 search。
  • 厂商:只列该协议下可用的厂商;降级组合在卡片内标注原因;不支持的组合按当前形态收进折叠区。
  • 字段:留空即用 catalog 默认值(显示为 placeholder)。清空并保存会删除该键。
  • 端点覆盖(Anthropic 协议):启动环境变量 DEEPSEEK_SEARCH_BASE_URL 可作为端点覆盖;配置文件里显式填写的「接口地址」优先于它。
  • 模板(仅自定义):下拉一次性填充,选完即清空,placeholder 提示刚用过的模板;模板本身不保存。若该 target 已有保存配置,切换模板前会提示「将覆盖当前配置」,并提供「重置为已保存配置」。
  • 保存:切换厂商/协议本身也算一次待保存变更;保存即生效(Host 每次搜索重新读取文件)。
  • API 密钥:只写凭据服务,不落配置文件;留空表示保持当前密钥。

配置文件(v3)

$DSH_HOME/dsh-web-search-diy.json,由配置页写入:

{
  "version": 3,
  "vendor": "qwen",
  "protocol": "responses",
  "targets": {
    "qwen/responses": {
      "baseURL": "https://maas.qianwenaiapi.com/compatible-mode/v1",
      "apiKeyEnv": "QWEN_TOKEN_PLAN_API_KEY",
      "model": "qwen3.8-flash",
      "maxOutputTokens": 4096,
      "toolType": "web_search",
      "includeSources": true
    },
    "custom/search": {
      "baseURL": "https://search-gateway.example.com",
      "path": "/v1/tools/search",
      "apiKeyEnv": "SEARCH_GATEWAY_API_KEY",
      "queryField": "q",
      "countField": "size",
      "resultsPath": "data.items",
      "urlField": "link",
      "titleField": "name",
      "snippetField": "desc",
      "count": 10
    }
  }
}
  • 顶层只记录当前 vendor 与 protocol;每个 target 的桶只保存它 fields 内的键。
  • 空值等于删除该键,回到 catalog 默认。
  • template 只是填充动作,不属于配置;提交会被拒绝。
  • API key 不在此文件中。

从 1.x 迁移

v2 mode v3 target
responses qwen/responses
anthropic-messages deepseek/anthropic-messages
zhipu-web-search zhipu/search
zhipu-chat-search zhipu/chat-completions
  • v1 扁平对象先投影到它当时的 mode,再按上表迁移。
  • 读取时只在内存迁移;首次保存写 v3,并把原文件备份为 dsh-web-search-diy.json.v2.bak(一次,保留回滚)。
  • 旧字段名映射:responsesToolType → toolType、responsesIncludeSources → includeSources、responsesReasoningEffort → reasoningEffort、anthropicThinking → thinking、anthropicEffort → effort;apiVersion 丢弃(固定 2023-06-01)。
  • 2.0 不再注册 settings 段;配置只来自文件与凭据面。

字段速查

协议 / 厂商 字段
通用 baseURL、apiKeyEnv、model、maxOutputTokens(纯工具不显示后两项)
Responses · OpenAI toolType、includeSources、reasoningEffort、searchContextSize、allowedDomains、blockedDomains、userLocation、externalWebAccess、returnTokenBudget、searchContentTypes、imageMaxResults、imageCaption
Responses · Kimi toolType、includeSources、allowedDomains(blockedDomains / search_context_size 会 400)
Responses · 智谱 / 千问 toolType、includeSources、reasoningEffort
Responses · DeepSeek toolType;模型锁定 deepseek-v4-pro,不发 include
Responses · OpenRouter toolType、includeSources、engine、mode、maxResults、maxUses、maxTotalResults、searchContextSize、maxCharacters、userLocation、allowedDomains、excludedDomains、xSearch
Anthropic Messages toolType、maxUses、thinking、effort、allowedDomains、blockedDomains、userLocation、responseInclusion
Chat · 智谱 searchEngine、count、searchRecencyFilter、contentSize、searchDomainFilter、requireSearch、searchPrompt、reasoningEffort
Chat · 千问 searchStrategy、forcedSearch、freshness、assignedSiteList、searchExtension、promptIntervene
Chat · OpenRouter engine、mode、maxResults、maxUses、maxTotalResults、searchContextSize、maxCharacters、userLocation、allowedDomains、excludedDomains、xSearch
Chat · OpenAI 无搜索参数;模型锁定 gpt-5-search-api
纯工具 count、includeContent、searchEngine / contentSize / searchRecencyFilter / searchDomainFilter(智谱)、oriQuestion / localization(DeepSeek)、timeoutSeconds(Kimi)、digestEntries、digestSnippetChars;自定义另含 path 与 8 个映射字段

oriQuestion 把本次触发搜索的用户原话作为 DeepSeek 的 ori_question 发送:折叠连续空白、截断到 128 字符,取自当前发起会话,不在会话中时自动省略。与官方 web-deepseek-api 的 sendOriginalQuestion 使用同一数据源。

纯工具的结果条数与摘要条数相互独立:count / limit 决定请求与 sources 数量(智谱/DeepSeek 1–50,Kimi 1–20);digestEntries(默认 8)与 digestSnippetChars(默认 200)只控制返回给调用方的 content 摘要,不裁剪 sources。

自定义接入

  • 模板:内置协议列出该协议可用厂商;纯工具列出 DeepSeek / Kimi / 智谱。选择模板 = 一次性填入端点、凭据、模型与搜索参数,随后可任意修改。
  • Chat 变体:由模板决定(智谱问答增强 / 千问联网搜索 / OpenRouter server tool / OpenAI 搜索模型),不作为单独字段展示;字段随变体过滤。
  • 纯工具映射:queryField、countField、resultsPath、urlField、titleField、snippetField、dateField、contentField 是权威;模板只负责填充与留空兜底。支持简单点路径(如 data.items),不支持完整 JSONPath。
  • 正文字段:contentField 指向每条结果的长正文,写入来源的 summary(上限 2,000 字符),并在 snippet 为空时作为 content 摘要兜底;原文与 snippet 相同时不重复写(比较发生在截断前,智谱 content_size=high 的长正文不会存两份)。snippet 也截到 2,000 字符。DeepSeek 模板默认 content(need_content 的正文);旧配置里的 summary 仍会被回退读取。
  • 搜索引擎:输入框 + 常见候选(智谱 / OpenRouter / 自建),可自由填写;智谱模板留空时回落 search_std(该接口必填)。
  • 必填项:Chat 需要变体(模板会填);Responses / Anthropic 需要 toolType;纯工具需要 path。

目标速查(默认端点 / 模型 / 凭据)

target 支持度 默认端点 默认模型 凭据引用
deepseek/anthropic-messages ✅ https://api.deepseek.com/anthropic deepseek-flash DEEPSEEK_API_KEY
deepseek/responses ◐ https://api.deepseek.com deepseek-v4-pro DEEPSEEK_API_KEY
deepseek/search ✅ https://api.deepseek.com — DEEPSEEK_API_KEY
kimi/responses ✅ https://api.moonshot.cn/v1 kimi-k2.6 MOONSHOT_API_KEY → KIMI_API_KEY
kimi/search ✅ https://api.moonshot.cn — 同上
zhipu/chat-completions ✅ https://open.bigmodel.cn/api/paas/v4 glm-5.3-flash ZAI_CODING_CN_API_KEY → ZHIPU_API_KEY
zhipu/responses ✅ https://open.bigmodel.cn/api/v1 glm-5.3 同上
zhipu/search ✅ https://open.bigmodel.cn/api/paas/v4 — 同上
qwen/chat-completions ◐ https://maas.qianwenaiapi.com/compatible-mode/v1 qwen3.8-flash QWEN_TOKEN_PLAN_API_KEY → QWEN_TOKEN_PLAN_CN_API_KEY → DASHSCOPE_API_KEY
qwen/responses ✅ 同上 qwen3.8-flash 同上
qwen/anthropic-messages ✅ https://maas.qianwenaiapi.com/apps/anthropic qwen3.8-max 同上
openai/chat-completions ◐ https://api.openai.com/v1 gpt-5-search-api OPENAI_API_KEY
openai/responses ✅ https://api.openai.com/v1 gpt-5.5 OPENAI_API_KEY
anthropic/anthropic-messages ✅ https://api.anthropic.com claude-opus-5-5 ANTHROPIC_API_KEY
openrouter/chat-completions ✅ https://openrouter.ai/api/v1 用户填写 OPENROUTER_API_KEY
openrouter/responses ✅ https://openrouter.ai/api/v1 用户填写 OPENROUTER_API_KEY
openrouter/anthropic-messages ◐ https://openrouter.ai/api 用户填写 OPENROUTER_API_KEY
custom/chat-completions ⚙ 模板预填 模板 / 用户填写 用户填写
custom/responses ⚙ 模板预填 模板 / 用户填写 用户填写
custom/anthropic-messages ⚙ 模板预填 模板 / 用户填写 用户填写
custom/search ⚙ 模板预填 — 用户填写

默认模型只是当前文档示例,不承诺长期有效;用户填了则以用户值为准。

测试连接

配置页底部的「测试连接」用当前草稿执行一次真实搜索,不写配置文件(观测库会记一条 test 记录,默认不计入统计):

  • 查询词固定 OpenAI,maxResults = 3,超时 60 秒;
  • 协议内置:Responses / Anthropic 发送 Perform a web search for the query: OpenAI,Chat 直接发送 OpenAI;
  • 纯工具:按模板发送 search_query / query / text_query 与对应条数;
  • 返回 { ok, sourceCount, sourceQuality, degraded, latencyMs, contentPreview?, error? };
  • 保存侧的自定义必填校验(如纯工具必须有 path)同样先行执行,缺项直接返回 400,不会发出请求;
  • 0 来源时按该组合的预期来源质量分档提示:设计上不返回 / 可能未执行 / 应检查工具名与端点。

工作原理

你 ──> 对话 LLM ──> web_search 工具(与模型无关)
                         │ ctx.web seam ──> diy-search provider
                         ▼
   ├─ Responses:           POST {baseURL}/responses   tools: [{ type, ... }]
   ├─ Anthropic Messages:  POST {baseURL}/messages    tools: [{ type: web_search_*, max_uses }]
   ├─ Chat Completions:    POST {baseURL}/chat/completions  (四个变体)
   └─ 纯工具:              POST {baseURL}{path}       (无模型回合)
                         │
                         ▼
                  对话 LLM 基于来源作答
  • Responses:action.sources[]、open_page / find_in_page 的 action.url、results[] 元数据与 url_citation 注解统一归一为去重来源;答案优先取 phase: "final_answer"。没有搜索证据时显式失败,404 会提示该端点缺少 /responses 路径。
  • Anthropic Messages:web_search_tool_result → sources[],citations[].cited_text → snippet,page_age → ISO 日期;allowed_domains 与 blocked_domains 互斥(allowed 优先);非 20250305 工具自动加 allowed_callers: ["direct"]。
  • Chat Completions:智谱 web_search 工具、千问 enable_search、OpenRouter server tool、OpenAI 搜索模型四种变体;来源从 message.web_search[] 或 annotations[] 读取。
  • 纯工具:结构化结果直接成为 sources[],contentField 的长正文写入 source.summary,前若干条摘要拼成 content;没有模型回合。
  • 思考档位降级:按 reasoning.effort → output_config → thinking → reasoning_effort 顺序逐个移除后重试。
  • 响应解码:按字节读取并按 gzip/zlib 魔数解压,设置 8 MiB 线上与 16 MiB 解码上限。

观测与历史导入

  • 采集:provider 在每次真实搜索与测试连接结束时上报一条 outcome,成功和失败都记;字段包括 target / vendor / protocol、会话 id、搜索词、耗时、错误码与来源计数。采集出口自身再兜一层异常,写入失败只告警一次,搜索返回值不受影响。
  • 存储:node:sqlite 写入 $DSH_HOME/web-search-diy/observations.db;启用 WAL、busy_timeout 与外键,目录和文件分别收紧到 0700 / 0600。一条记录与它的来源明细在同一事务内提交;启动时按 PRAGMA user_version 迁移,并只保留最近 50,000 条(不按时间删除,避免导入的旧记录被时间窗口清掉)。node:sqlite 不可用、目录不可写或数据库损坏时,整层观测禁用,搜索照常工作。
  • 失败分层:401/403 → WEB_PROVIDER_AUTH;408/504 与本地超时 → WEB_PROVIDER_TIMEOUT;429 → WEB_PROVIDER_RATE_LIMIT;5xx → WEB_PROVIDER_SERVER;其余 4xx(400 除外)→ WEB_PROVIDER_REQUEST;400 与响应体不可解析 → WEB_PROVIDER_ERROR;网络失败 → WEB_PROVIDER_NETWORK;调用方取消 → WEB_ABORTED。
  • 查询与分页:GET /api/web-search-diy/observability/summary|records|export、DELETE .../records、POST .../import({async:true} 立即返回 202,进度与结果看 GET .../import/status)。P50/P95 在应用层对 duration_ms 排序后线性插值,不依赖 SQLite 窗口函数;记录页按 page / limit 取一页,同时返回筛选后的 total,status、errorCode 与搜索词共同收窄结果,页码越界时夹紧到最后一页。GET .../storage 返回库大小、记录/来源行数与记录时间跨度。清空记录后执行 VACUUM 回收文件空间。
  • 时间范围:since 接受相对预设或 ISO 时间,until 只接受 ISO 时间;自定义结束日按本地自然日的 23:59:59.999 计入。预设与「至今」不发送 until,默认范围是近 24 小时;查询范围与导入范围各自独立。
  • 历史导入:扫描会话日志里的 tool/call(web_search)与对应结果,按 history:<sessionId>:<seq> 生成确定性 id,重复导入只补新增。新版本所有协议都会在调用与结果之间写入 web/deepseek-search-llm-request 事件并携带 target;旧事件没有 target 时按 catalog 默认端点回退;两者都没有时记为 historical(界面显示「历史记录」)。导入可限定 since / until,也能为已存在的历史记录补全 target;文件 mtime 早于导入起点的会话整份跳过、不再解压,异步导入按文件回报进度。

实测结果

2026-10-17 / 2026-10-18 使用真实凭据:

target 来源数 备注
qwen/responses 6 来源仅 url
qwen/anthropic-messages 9 自动附加 billing header
deepseek/anthropic-messages 10 —
deepseek/search 3 localization 留空不发送
zhipu/chat-completions 8 —
zhipu/responses 5 sources + results 合并
zhipu/search 1 摘要上限生效
kimi/responses 6 kimi-k2.6
kimi/search 3 maxResults=30 钳到 limit=20
custom/search 1 自定义映射与摘要上限生效
qwen/chat-completions 0 降级符合预期(无来源)
deepseek/responses 0 降级符合预期(仅 open_page)
custom/chat / responses / anthropic 8 / 5 / 10 2026-10-17 验证

2026-10-29 用真实 DeepSeek key 复测:deepseek/search 5 条来源,source.summary 1,790–2,000 字符(开启「返回正文」时改用 content 正文);deepseek/anthropic-messages 10 条来源,并返回 4,336 字符答案。

OpenAI、Anthropic、OpenRouter 尚未实测;有这些端点的实际结果,欢迎在「反馈」中补充。

已知限制

  • Kimi Chat 不接入:协议内置 $web_search 将于 2026-10-20 下线;api.kimi.com/coding 端点同样不接入。Kimi 只保留 Responses 与纯工具(/v1/tools/search,Pro 可用自定义 target 覆盖 path)。
  • 智谱 Anthropic 不执行搜索:接受 web_search_20250305 但 web_search_requests: 0,标为不支持。
  • DeepSeek Responses 仅 deepseek-v4-pro,且不返回 action.sources,来源只能来自 open_page。
  • 千问 Chat 不返回来源;千问只对接千问 AI 平台(maas.qianwenaiapi.com),不接阿里云百炼。
  • OpenAI Chat 仅 gpt-5-search-api,普通模型加 tools 不生效。
  • OpenRouter Anthropic 的 web_search_20250305 别名按文档实现,尚未实测。
  • Kimi Responses 不支持 search_context_size / blocked_domains(会 400)。
  • 纯工具搜索没有模型回合;输出上限由 digestEntries / digestSnippetChars 控制,不是模型的 token 预算。
  • 测试连接固定查询词 OpenAI,只用于验证连通性,不代表搜索质量。
  • 纯工具来源文本上限:snippet 与 summary 单条都截到 2,000 字符,且不切断代理对;dsh-tool-web 默认再把 summary 截到 800 字符才交给模型。
  • 观测库依赖 node:sqlite:Node 构建不提供该模块、目录不可写或数据库损坏时,观测整层禁用(只告警一次),搜索本身不受影响。
  • 观测库保留上限:最近 50,000 条,不按时间自动删除;历史导入的记录同样受这个上限约束。
  • 历史导入只能还原会话日志里出现过的调用:旧版本会话既没有请求事件、端点又匹配不上 catalog 默认值时,target 只能标为「历史记录」,无法反推;这类记录重跑导入也不会改变。
  • 测试与比对记录默认不计入统计:工具条勾选「包含测试连接」后才纳入;测试连接固定使用 OpenAI 查询词。
  • 时间范围按浏览器本地时区的自然日:自定义结束日包含当天整天,跨时区查看时边界随浏览器时区变化。

反馈

遇到未覆盖的厂商或网关、协议行为差异、字段映射问题,欢迎在 GitHub Issues 反馈,附上端点类型、请求形状与错误信息即可;也欢迎提交 PR 补充实测结果。

凭据

在 Web 的 Models 页 / 凭据服务里保存($DSH_HOME/.credentials.yaml),或在启动环境中导出。插件每次搜索动态解析,不在 provider 上保留,也不写入配置文件。当前 target 解析不出凭据时,web_search 不会出现在模型上下文。

默认引用链按厂商:DeepSeek DEEPSEEK_API_KEY;Kimi MOONSHOT_API_KEY → KIMI_API_KEY → KIMI_CODING_API_KEY;智谱 ZAI_CODING_CN_API_KEY → ZHIPU_API_KEY;千问 QWEN_TOKEN_PLAN_API_KEY → QWEN_TOKEN_PLAN_CN_API_KEY → DASHSCOPE_API_KEY;OpenAI / Anthropic / OpenRouter 各一条。自定义 target 的引用名由用户填写。

引用名必须是合法的环境变量名(字母或下划线开头,仅字母、数字、下划线);不合法的值保存时会被拒绝,手改文件里的非法引用会被跳过并回退到下一个候选。

开发

Host 与 Client 都在 src/ 维护,构建产物入库:

src/
  index.ts        # apply:注册 provider、配置/测试与观测端点
  catalog.ts      # 能力矩阵、默认值、字段、模板
  config.ts       # v3 读写、v1/v2 迁移、字段校验
  endpoint.ts     # GET/POST /api/web-search-diy/config 与 /test
  options.ts      # catalog 默认 + 文件覆盖
  provider.ts     # available / ready / 按协议分派
  transport.ts    # fetch、解码、reasoning 降级、错误分层
  protocols/      # responses / anthropic / chat / search
  mappers/        # 来源归一化
  observability/  # 观测库、聚合、历史导入、导出、观测端点
  client/         # 浏览器侧,构建为单个 lib/client.js
    index.tsx     # apply:卡片注册、样式与词典
    page.tsx      # 配置页:形态 → 协议 → 厂商、字段表单、测试/保存
    fields.tsx    # 字段控件
    field-meta.ts # 枚举/布尔/数字集合、Chat 变体、高级区
    draft.ts      # 草稿归一化、模板填充、数值转换
    labels.ts     # 协议/厂商/支持度文案
    styles.ts     # 卡片样式
    locale.ts     # 中英文案与 ALL_LOCALES 映射
    locales/      # 日、西班牙、法、德、俄、葡萄牙语词典
    obs/          # 观测页:概览、记录、日历范围、趋势图、样式
    consts.ts     # loader id 与端点
    types.ts      # 草稿与字段 props 类型
pnpm install
pnpm run build       # Host ESM + Client CJS 双产物
pnpm run typecheck
pnpm test            # Host 测试(180 项)
pnpm run test:client # 重建并校验 Client 契约

lib/index.js 与 lib/client.js 入库;source map 不入库。

许可证

MIT —— 见 LICENSE。Copyright (c) 2026 aaronlei.