@dsh-plus/web-search-services 0.1.19 → 0.2.0

package/src/client/i18n.ts

@@ -1,5 +1,5 @@
 /**
- * 配置卡片文案（zh/en）。经 ctx.locale.register 注册、bind 取用。
+ * 配置卡片文案（zh/en）：经 ctx.locale.register 注册、bind 取用。
  * 公共键（save/discard/unsaved 等）来自 shared 的 common 字典，本文件只维护业务键。
  * @module web-search-services/client/i18n
  */
@@ -10,65 +10,122 @@ export const NS = 'dsh-plus-web-search-services'
 const ownZh = {
   title: '搜索后端聚合',
   description:
-    '把 search-services skill 接成 dsh 的 web_search 后端：按优先级尝试 Tavily / Exa / OpenAI-compatible，失败自动回退。',
-  summaryLine: 'web_search 免费后端聚合：优先级链 + 失败自动回退（密钥读 skill 的 env 文件）。',
-  scriptPath: 'search.py 路径',
-  scriptPathHint: '留空 = 使用随包内置脚本；支持 ~ 展开。',
-  envFile: '密钥 env 文件',
-  envFileHint:
-    '默认 ~/.config/search-services/env（skill 的单事实源）；留空表示不读该文件。支持 ~ 展开。',
-  python: 'python 解释器',
-  pythonHint: '可含参数（如 py -3）；留空 = 自动发现（桌面捆绑运行时 → PATH → 平台兜底名）。',
-  priority: '后端优先级',
-  priorityHint:
-    '每行一个，靠前先试，失败自动回退到下一个。可选值：tavily、exa、openai-chat；重复或未知值会被拒绝保存。',
-  timeoutMs: '单次搜索超时（毫秒）',
-  timeoutMsHint: '应低于 dsh-tool-web 的 searchTimeoutMs；下限 1000，默认 55000。',
-  invalidPriority: '请填写至少一个有效后端，且不要重复',
-  invalidTimeout: '请输入不小于 1000 的整数',
-  keysGroup: '密钥与覆盖项（本卡片不编辑）',
-  keysHint:
-    '密钥主来源是上面的 env 文件，保持 skill 单事实源：TAVILY_API_KEY、EXA_API_KEY、SEARCH_OPENAI_API_KEY，以及可选的 SEARCH_OPENAI_BASE_URL、SEARCH_OPENAI_MODEL。',
-  keysUserLayerHint:
-    'schema 里的 keys 段是行级覆盖逃生舱（role(secret) 字段只允许 profile 行级注入）；写入 settings 用户层会被脱敏遮蔽，因此配置卡片不提供编辑。需要覆盖时请改 env 文件，或在 profile 的 cordis.patch.yml 行级注入。',
-  reloadHint: '改动热生效（下一次 web_search 调用即用新配置）；scriptPath / python 变化无需重启。',
+    '把 web_search 接到多个搜索后端：按条目顺序尝试，失败自动回退到下一个；官方工具、渲染与 Sources 格式零修改。',
+  summaryLine: 'web_search 多后端聚合：顺序尝试 + 失败自动回退（密钥走官方 credentials）。',
+  enabled: '启用本插件',
+  enabledHint: '关闭后 web_search 不再选用本插件注册的 provider；官方工具与提示词不变。',
+  exposeEntries: '暴露每条目 provider',
+  exposeEntriesHint:
+    '额外注册 dsh-plus-search-<条目名>，便于在 profile 里用 searchProvider 钉住单个后端；改动条目列表后需 /reload 生效。',
+  proxy: 'HTTP(S) 代理',
+  proxyHint:
+    '全部后端共用（Tavily/Exa/OpenAI/Context7 的基址都走这里）；留空 = 读环境变量 HTTP_PROXY/HTTPS_PROXY/NO_PROXY。',
+  entriesTitle: '后端链',
+  entriesHint:
+    '顺序即优先级：靠前的先试，失败自动回退到下一个。条目内的密钥引用在下方「密钥」小节填写。',
+  addEntry: '新增条目',
+  entryId: '条目名',
+  entryIdHint: '链内标识，同时是 provider id 的后缀（dsh-plus-search-<条目名>），需唯一。',
+  entryEnabled: '参与链',
+  moveUp: '上移',
+  moveDown: '下移',
+  remove: '删除',
+  type: '类型',
+  unsetOption: '（不设置）',
+  csvHint: '多项用逗号分隔，留空表示不限。',
+  librariesHint:
+    'JSON 数组：[{"name":"react","id":"/facebook/react","keywords":["react"]}]（id 可留空，运行时按名称解析）。',
+  headersHint: 'JSON 对象：{"Accept-Language":"zh-CN"}。',
+  entriesEmpty: '至少保留一个条目，否则本 provider 不可用。',
+  unknownType: '未知条目类型（来自更早版本的配置），保存前请删除或改类型。',
+  issueIdEmpty: '条目名不能为空。',
+  issueRequired: '必填：留空会让该条目永不可用。',
+  issueIdDuplicate: '条目名重复。',
+  issueTypeUnknown: '未知条目类型。',
+  issueInt: '需为整数。',
+  issueBelowMin: '低于允许的最小值（见后端 schema）。',
+  issueAboveMax: '高于允许的最大值（见后端 schema）。',
+  issueOption: '取值不在候选内。',
+  issueJson: '需为合法 JSON。',
+  issueJsonArray: '需为 JSON 数组。',
+  issueJsonObject: '需为 JSON 对象。',
+  issueJsonStrings: '值需为字符串。',
+  issueLibraryShape: '每项需含 name 字段（可选 id 与 keywords）。',
+  secretsTitle: '密钥',
+  secretsBody:
+    '值经官方 credentials 接口写入 $DSH_HOME/.credentials.yaml，卡片不回显；引用名由上面的条目决定。也可用环境变量提供同名值。',
+  secretConfigured: '已配置',
+  secretMissing: '未配置',
+  secretShadowed: '该引用被进程环境（或只读来源）提供，卡片不能改写。',
+  secretFailed: '凭据写入失败：',
+  secretClear: '清除',
+  reloadHint:
+    '条目增删后需 /reload 才会重新注册 provider；超时、密钥、顺序等字段改动下一次调用即生效。',
 } as const
 
 const ownEn = {
   title: 'Search backend aggregation',
   description:
-    'Bridges the search-services skill into dsh as a web_search backend: tries Tavily / Exa / OpenAI-compatible in priority order with automatic fallback.',
+    'Routes web_search to several search backends: entries are tried in order with automatic fallback. Official tool, rendering and Sources formatting are untouched.',
   summaryLine:
-    'web_search backend aggregation: priority chain with automatic fallback (keys from the skill env file).',
-  scriptPath: 'search.py path',
-  scriptPathHint: 'Empty uses the bundled copy; ~ is expanded.',
-  envFile: 'Credential env file',
-  envFileHint:
-    'Defaults to ~/.config/search-services/env (the skill’s single source); empty skips the file. ~ is expanded.',
-  python: 'Python interpreter',
-  pythonHint:
-    'May include arguments (e.g. py -3); empty auto-detects (desktop runtime → PATH → platform default).',
-  priority: 'Backend priority',
-  priorityHint:
-    'One per line, earlier first, with automatic fallback on failure. Allowed: tavily, exa, openai-chat; duplicates or unknown values block saving.',
-  timeoutMs: 'Per-search timeout (ms)',
-  timeoutMsHint: 'Keep it below dsh-tool-web’s searchTimeoutMs; minimum 1000, default 55000.',
-  invalidPriority: 'Enter at least one valid backend without duplicates',
-  invalidTimeout: 'Enter an integer of at least 1000',
-  keysGroup: 'Credentials and overrides (not edited here)',
-  keysHint:
-    'Credentials come from the env file above, keeping the skill as the single source: TAVILY_API_KEY, EXA_API_KEY, SEARCH_OPENAI_API_KEY, plus optional SEARCH_OPENAI_BASE_URL and SEARCH_OPENAI_MODEL.',
-  keysUserLayerHint:
-    'The keys section in the schema is a line-level escape hatch (role(secret) fields accept profile-line injection only); values written to the settings user layer are masked, so this card offers no editor. To override, edit the env file or inject at the profile row in cordis.patch.yml.',
+    'web_search backend chain: ordered attempts with automatic fallback (keys via official credentials).',
+  enabled: 'Enable this plugin',
+  enabledHint:
+    'When off, web_search no longer selects the providers registered here; the official tool and prompt are unchanged.',
+  exposeEntries: 'Expose per-entry providers',
+  exposeEntriesHint:
+    'Also registers dsh-plus-search-<entry id> so a profile can pin one backend via searchProvider; changing the entry list needs /reload.',
+  proxy: 'HTTP(S) proxy',
+  proxyHint:
+    'Shared by every backend (Tavily/Exa/OpenAI/Context7 base URLs); empty reads HTTP_PROXY/HTTPS_PROXY/NO_PROXY.',
+  entriesTitle: 'Backend chain',
+  entriesHint:
+    'Order is priority: the first entry is tried first and failures fall through to the next. Credential references are edited in the Secrets section below.',
+  addEntry: 'Add entry',
+  entryId: 'Entry name',
+  entryIdHint:
+    'Identifies the entry inside the chain and suffixes the provider id (dsh-plus-search-<entry>); must be unique.',
+  entryEnabled: 'In chain',
+  moveUp: 'Move up',
+  moveDown: 'Move down',
+  remove: 'Remove',
+  type: 'Type',
+  unsetOption: '(unset)',
+  csvHint: 'Separate multiple values with commas; empty means no restriction.',
+  librariesHint:
+    'JSON array: [{"name":"react","id":"/facebook/react","keywords":["react"]}] (id optional; resolved by name at runtime).',
+  headersHint: 'JSON object: {"Accept-Language":"zh-CN"}.',
+  entriesEmpty: 'Keep at least one entry, otherwise this provider is unavailable.',
+  unknownType:
+    'Unknown entry type (from an older configuration); remove it or change its type before saving.',
+  issueIdEmpty: 'Entry name is required.',
+  issueRequired: 'Required: leaving it empty makes the entry permanently unusable.',
+  issueIdDuplicate: 'Entry name is duplicated.',
+  issueTypeUnknown: 'Unknown entry type.',
+  issueInt: 'Enter an integer.',
+  issueBelowMin: 'Below the minimum allowed by the backend schema.',
+  issueAboveMax: 'Above the maximum allowed by the backend schema.',
+  issueOption: 'Value is not one of the options.',
+  issueJson: 'Enter valid JSON.',
+  issueJsonArray: 'Enter a JSON array.',
+  issueJsonObject: 'Enter a JSON object.',
+  issueJsonStrings: 'Values must be strings.',
+  issueLibraryShape: 'Each item needs a name (optional id and keywords).',
+  secretsTitle: 'Credentials',
+  secretsBody:
+    'Values are written through the official credentials API into $DSH_HOME/.credentials.yaml and are never echoed back; references come from the entries above. Environment variables with the same name also work.',
+  secretConfigured: 'Configured',
+  secretMissing: 'Not configured',
+  secretShadowed:
+    'This reference comes from the process environment (or a read-only source); the card cannot change it.',
+  secretFailed: 'Credential write failed: ',
+  secretClear: 'Clear',
   reloadHint:
-    'Changes apply hot (the next web_search call uses them); scriptPath / python need no restart.',
+    'Adding or removing entries needs /reload to re-register providers; timeouts, keys and order take effect on the next call.',
 } as const
 
-export type DictKey = keyof typeof commonZh | keyof typeof ownZh
+export const zh = mergeDict(commonZh, ownZh)
+export const en: Record<keyof typeof zh, string> = mergeDict(commonEn, ownEn)
 
-/** 卡片共用的翻译函数类型（slot 注入的 bind 结果按此消费）。 */
+export type DictKey = keyof typeof zh
 export type Translate = (key: DictKey) => string
-
-// 标注为 Record<DictKey, string>：en 缺任一键即编译期报错（中英强制对齐）。
-export const zh: Record<DictKey, string> = mergeDict(commonZh, ownZh)
-export const en: Record<DictKey, string> = mergeDict(commonEn, ownEn)

package/src/client/styles.ts

@@ -1,6 +1,6 @@
 /**
  * 配置卡片样式：基础规则走 @dsh-plus/shared/client 的 cardCss('wsv')，
- * 本文件只补插件特有规则（优先级多行文本域、密钥说明块）。
+ * 本文件只补插件特有规则（条目块、JSON 文本域、条目操作按钮组）。
  * 沿用官方 data-plugin / data-plugin-css 约定（HMR 据此卸载）。
  * @module web-search-services/client/styles
  */
@@ -9,13 +9,16 @@ import { cardCss, injectCardStyle } from '@dsh-plus/shared/client'
 export const PLUGIN_ID = '@dsh-plus/web-search-services'
 
 const extraCss = `
-.wsv-priority{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:8px 12px;font-size:13px;line-height:1.6;min-height:72px;resize:vertical;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
-.wsv-priority:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
-.wsv-priority:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
-.wsv-keys{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;margin:12px 0 0;padding:10px 12px}
-.wsv-keysTitle{color:var(--dsw-alias-label-secondary);margin:0;font-size:12px;font-weight:600}
+.wsv-entry{border:1px solid var(--dsw-alias-border-l2);border-radius:8px;margin:12px 0 0;padding:4px 12px 12px}
+.wsv-entryHead{align-items:center;gap:8px;display:flex;flex-wrap:wrap;padding:12px 0 4px}
+.wsv-entryIndex{background:var(--dsw-alias-bg-module-platform);color:var(--dsw-alias-label-secondary);border-radius:999px;flex:none;padding:1px 8px;font-size:11px;font-weight:500;line-height:17px}
+.wsv-entryActions{margin-left:auto;gap:6px;display:flex;flex-wrap:wrap}
+.wsv-json{border:1px solid var(--dsw-alias-border-l2);background:var(--dsw-alias-bg-layer-3);font:inherit;color:var(--dsw-alias-label-primary);border-radius:8px;padding:8px 12px;font-size:13px;line-height:1.6;resize:vertical;font-family:ui-monospace,SFMono-Regular,Menlo,Consolas,monospace}
+.wsv-json:focus-visible{border-color:var(--dsw-alias-brand-primary);outline:none}
+.wsv-json:disabled{color:var(--dsw-alias-label-tertiary);cursor:default}
 @media (max-width:767px){
-.wsv-priority{font-size:16px}
+.wsv-json{font-size:16px}
+.wsv-entryActions{width:100%;margin-left:0}
 }
 `
 

package/src/config.ts

@@ -1,98 +1,48 @@
 /**
- * 配置单一事实源：cordis 行级 Config（组合默认值，patch 层可覆盖）与 settings
- * namespace（用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一 schemastery schema。
+ * 配置单一事实源：cordis 行级 Config（组合默认值，profile patch 层可覆盖）与 settings
+ * namespace（用户层＝profile 行级覆盖层 cordis.patch.yml，热生效）共用同一份
+ * schemastery schema。
  *
- * 密钥主来源是 search-services skill 的 env 文件（envFile，默认
- * ~/.config/search-services/env），保持 skill 单事实源、零搬迁。行级 keys 仅为
- * 覆盖逃生舱；按存储规范 role('secret') 字段只允许行级注入，settings 用户层勿填。
+ * 条目 schema 来自 `@dsh-plus/web-providers-core`（与后端实现同源，改后端不动插件）；
+ * 密钥全部走官方 credentials seam（`$DSH_HOME/.credentials.yaml`），**不进 settings**
+ * ——卡片只展示引用名，值经 `remote.credentials` 写入。
  * @module web-search-services/config
  */
+
 import z from '@deepseek-ai/schemastery'
 import type { UnwrapVolatile } from '@dsh-plus/shared'
+import { DEFAULT_SEARCH_ENTRIES, SearchEntrySchema } from '@dsh-plus/web-providers-core'
 
 import { SETTINGS_NS as NS_LITERAL } from './ns.ts'
 
 export const SETTINGS_NS = NS_LITERAL
 
-/** 空串表示使用随包内置脚本（本包 scripts/search.py，见 scripts/README.md）。 */
-export const DEFAULT_SCRIPT_PATH = ''
-export const DEFAULT_ENV_FILE = '~/.config/search-services/env'
-export const DEFAULT_TIMEOUT_MS = 55_000
-export const DEFAULT_PRIORITY: readonly SearchBackend[] = ['tavily', 'exa', 'openai-chat']
-
-export type SearchBackend = 'tavily' | 'exa' | 'openai-chat'
-
-const PRIORITY_ENTRY = z.union(['tavily', 'exa', 'openai-chat'])
-
-const KeysSchema = z.object({
-  tavily: z
-    .string()
-    .role('secret')
-    .description('Tavily API key（覆盖 envFile 的 TAVILY_API_KEY；行级注入专用）')
-    .default(''),
-  exa: z
-    .string()
-    .role('secret')
-    .description('Exa API key（覆盖 envFile 的 EXA_API_KEY；行级注入专用）')
-    .default(''),
-  openaiApiKey: z
-    .string()
-    .role('secret')
-    .description('OpenAI-compatible API key（覆盖 SEARCH_OPENAI_API_KEY；行级注入专用）')
-    .default(''),
-  openaiBaseUrl: z
-    .string()
-    .description('OpenAI-compatible base URL（覆盖 SEARCH_OPENAI_BASE_URL）')
-    .default(''),
-  openaiModel: z
-    .string()
-    .description('OpenAI-compatible 搜索模型名（覆盖 SEARCH_OPENAI_MODEL）')
-    .default(''),
-})
-
-// 全字段 `.volatile()`——条目进入 settings describe 视图（卡片可读写；
-// keys 内 role('secret') 字段由 describe/write 层做密文遮蔽，用户层勿填），
-// loader 原位提交活动引用，current() 现取即热。
+// 顶层字段全部 .volatile()：进入 settings describe 视图（卡片可读写），
+// loader 原位提交活动引用，消费端 unwrapVolatile 现取即热（改配置不用重启）。
 export const Config = z.object({
-  scriptPath: z
-    .string()
-    .description('search.py 路径（支持 ~ 展开）；空串 = 使用随包内置脚本副本')
-    .default(DEFAULT_SCRIPT_PATH)
+  enabled: z
+    .boolean()
+    .description('总开关：关闭后 web_search 不再选用本 provider（官方工具与提示词不变）')
+    .default(true)
     .volatile(),
-  envFile: z
-    .string()
-    .description('skill 密钥 env 文件路径（支持 ~ 展开）；空串表示不读 envFile')
-    .default(DEFAULT_ENV_FILE)
+  exposeEntries: z
+    .boolean()
+    .description('是否额外注册每条目 provider（dsh-plus-search-<条目名>），便于按 id 钉住单个后端')
+    .default(false)
     .volatile(),
-  python: z
+  proxy: z
     .string()
-    .description(
-      'python 解释器（可含参数，如 `py -3`）；空串 = 自动发现（配置外按 桌面捆绑运行时 → PATH → 平台兜底名 解析）',
-    )
+    .description('全部后端共用的 HTTP(S) 代理；空 = 读环境变量 HTTP_PROXY/HTTPS_PROXY/NO_PROXY')
     .default('')
     .volatile(),
-  priority: z
-    .array(PRIORITY_ENTRY)
-    .description('后端优先级：靠前的先尝试，失败自动回退到下一个')
-    .default([...DEFAULT_PRIORITY])
-    .volatile(),
-  timeoutMs: z
-    .natural()
-    .min(1000)
-    .description('单次搜索子进程超时（毫秒），应低于 dsh-tool-web 的 searchTimeoutMs')
-    .default(DEFAULT_TIMEOUT_MS)
+  entries: z
+    .array(SearchEntrySchema)
+    .description('后端链：按顺序尝试，失败自动回退到下一个（条目内 schema 见卡片）')
+    .default(DEFAULT_SEARCH_ENTRIES)
     .volatile(),
-  keys: KeysSchema.default({
-    tavily: '',
-    exa: '',
-    openaiApiKey: '',
-    openaiBaseUrl: '',
-    openaiModel: '',
-  }).volatile(),
 })
 
 /** 活动字段形态（loader 解析产物：volatile 字段为活动引用）。 */
 export type WebSearchServicesConfigFields = Schemastery.TypeT<typeof Config>
 /** 平面配置形态（消费面的读取形态，由活动引用解包得到）。 */
 export type WebSearchServicesConfig = UnwrapVolatile<WebSearchServicesConfigFields>
-export type KeysConfig = WebSearchServicesConfig['keys']

package/src/index.ts

@@ -1,37 +1,52 @@
 /**
- * dsh-plus 插件：web_search 免费后端聚合（search-services skill 桥接）。
+ * dsh-plus 插件：web_search 多后端聚合。
  *
- * 经官方 ctx.web provider 扩展点注册 id=search-services 的搜索后端：web_search /
- * web_fetch 工具、渲染层与提示词零修改，模型可见输出格式与官方 provider 逐字节
- * 一致。优先级与自动回退由 skill 的 search.py 编排（含 Tavily 多 key 轮转）；
- * Context7 仅支持带库名的 docs 查询，web_search 契约无 library 概念，不进搜索链。
+ * 经官方 `ctx.web` provider 扩展点注册搜索后端：官方 `web_search` 工具、渲染层、
+ * 提示词与 `Sources:` 格式零修改，模型可见输出与官方 provider 逐字节一致。后端链、
+ * 回退与各供应商细节（Tavily 多 key 轮换、Exa、OpenAI 兼容、Context7）在
+ * `@dsh-plus/web-providers-core`；本插件只做「读配置 → 建 provider → 注册」。
+ * DeepSeek 官方 Search/Fetch API 由官方 `@deepseek-ai/dsh-web-deepseek-api` 提供，
+ * 本包不重复实现（provider id：deepseek-search-api / deepseek-fetch-api）。
  * @module @dsh-plus/web-search-services
  */
+
 import type { Context } from '@deepseek-ai/cordis'
 import type {} from '@deepseek-ai/dsh-settings'
 import type {} from '@deepseek-ai/dsh-web'
 import { unwrapVolatile } from '@dsh-plus/shared'
+import {
+  createBackendHost,
+  probeCredentialsFace,
+  searchProvidersOf,
+} from '@dsh-plus/web-providers-core'
 
 import type { WebSearchServicesConfig, WebSearchServicesConfigFields } from './config.ts'
-import { SearchServicesProvider } from './provider.ts'
 
 export const name = 'dsh-plus-web-search-services'
 
 /** 行级 inject：dsh-web 服务激活后才应用本行（provider 注册即需 ctx.web）。 */
 export const inject = ['web'] as const
 
+export {
+  SEARCH_ENTRY_PROVIDER_PREFIX as ENTRY_PROVIDER_PREFIX,
+  SEARCH_PROVIDER_ID as PROVIDER_ID,
+  type SearchEntry,
+  searchEntryAvailable,
+} from '@dsh-plus/web-providers-core'
 export { Config, SETTINGS_NS } from './config.ts'
-export { PROVIDER_ID, SearchServicesProvider } from './provider.ts'
 
-// config 运行期为 loader 解析的 volatile 活动字段（用户层 override 并入行级
-// config，写入原位提交）——每次读现取平面快照，替代已删除的 installSection/setSource。
 export function apply(
   ctx: Context,
   config: WebSearchServicesConfig | WebSearchServicesConfigFields,
 ): void {
-  const provider = new SearchServicesProvider(() => unwrapVolatile(config))
-  ctx.effect(
-    () => ctx.web.registerSearchProvider(provider),
-    'dsh-plus-web-search-services: register search provider',
-  )
+  const current = (): WebSearchServicesConfig => unwrapVolatile(config)
+  const host = createBackendHost({ credentials: probeCredentialsFace(ctx) })
+  ctx.effect(() => () => host.dispose(), 'dsh-plus-web-search-services: transport pool')
+  // 注册集在 apply 时定型（条目列表增删需 /reload）；字段改动每次调用现读，即时生效。
+  for (const provider of searchProvidersOf(current, host)) {
+    ctx.effect(
+      () => ctx.web.registerSearchProvider(provider),
+      `dsh-plus-web-search-services: register ${provider.id}`,
+    )
+  }
 }

package/scripts/README.md

@@ -1,34 +0,0 @@
-# scripts/：search-services skill Python 脚本的项目维护副本
-
-本目录是从 `~/.dsh/skills/search-services/scripts/` **原样复制**的单向副本
-（标准库实现，无第三方依赖），供 `@dsh-plus/web-search-services` 插件经
-`python3 search.py search ...` 子进程桥接调用。**skill 本体不受本仓维护影响。**
-
-## 为什么是 Python 桥接（特例声明）
-
-> **本插件是特例，不是先例。** dsh-plus 集成外部 HTTP 服务（provider、工具、
-> webhook 等）**默认直接用 TS 原生实现**（进程内 fetch、编译期契约、无进程边界）。
-> 仅当需求明确要求复用一套已存在、持续维护、且逻辑非平凡的外部编排
-> （本例：search-services skill 的链内 fallback、`TAVILY_API_KEYS` 多 key
-> 轮转、intent 服务链、per-service 参数细节）时，才允许整体桥接其脚本，
-> 把外部实现当作单一事实源，本仓只维护「dsh-web 契约 ↔ CLI」薄适配层。
-
-判定标准（新增集成时自检）：
-
-1. 外部逻辑是否已在维护中且有独立演进（skill/CLI 工具）？——否则 TS 原生重写更便宜。
-2. 桥接节省的是否是**编排逻辑**而非一个 POST 请求？——单接口直调一律 TS 原生。
-3. 失败域、超时、密钥注入是否都能在薄适配层兜住？——兜不住则不桥接。
-
-## 同步策略
-
-- **单向**：skill → 本目录。skill 升级后人工比对同步（diff 后整体覆盖），
-  不做自动同步、不做双向回写；本目录的定向修改（如有）须注释 `dsh-plus:`
-  标记并记录在下表。
-- 同步时复核文件清单：`search.py fetch.py fetch_playwright.py env_loader.py
-  openai_chat.py context7.py exa.py tavily.py`（`__pycache__` 不入仓）。
-
-## 本仓定向修改记录
-
-| 日期 | 文件 | 修改 | 原因 |
-|---|---|---|---|
-| — | — | 暂无（verbatim 副本） | — |