dsh-web-search-diy
Verifieddsh-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 · 简体中文
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-diyloader 条目; - 覆盖共享
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/search5 条来源,source.summary1,790–2,000 字符(开启「返回正文」时改用content正文);deepseek/anthropic-messages10 条来源,并返回 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.