dsh-web-search-anysearch

DSH 外接网页搜索（AnySearch）独立插件 —— 从 statem-li/dsh-webui 的 webSearch 模块拆回单体的版本（原 dsh-web-search-anysearch 插件被合并进 webui 后， 随 webui 卸载一并消失；本插件补回该能力）。零 DSH 源码改动，纯插件实现。

功能

模块	说明
AnySearch 搜索 provider	向 ctx.web 注册 id=anysearch 的 WebSearchProvider，web_search 工具经 POST https://api.anysearch.com/v1/search 搜网页（匿名免费层可用；也可配 AnySearch API Key）。
插件设置卡	「设置 → 插件 → 可配置」出现「外接网页搜索」卡片（键槽 settings.plugin.item，key=web-search-anysearch）：API Key（写凭据域 ANYSEARCH_API_KEY，不进设置文档）/ Base URL / 默认结果数。

与内置 DeepSeek 搜索（web-search-deepseek）不冲突：provider id 唯一、设置卡键槽唯一； profile 里已有的 web.searchProvider: anysearch 配置（webui 时代遗留）无缝指向本插件的 provider。

配置

设置命名空间 web-search-anysearch（与旧 webui 同名，旧设置文档无缝延续），字段：

字段	默认	说明
apiKeyEnv	ANYSEARCH_API_KEY	每次搜索解析的凭据引用
apiKey	—	字面 key（secret 角色，走设置文档时会被红act；建议只用 apiKeyEnv）
baseURL	https://api.anysearch.com	API 端点基址，/v1/search 自动拼接
maxResults	—	请求未带 maxResults 时的默认结果数
tag / zone / language	—	AnySearch 可选能力标签 / 区域(cn|intl) / 首选语言

组合配置（cordis 层、作为设置命名空间的 base 层）同名递补；没有配置时全默认。

架构与关键文件

src/
├── host.ts                    # Cordis 插件入口（name/inject/apply，双模块独立 try/catch）
├── anysearch-provider.ts      # AnySearchSearchProvider（webui provider.ts 逐字移植）
├── vendor/
│   ├── error.ts               # HarnessError + WebError（宿主叶子类内联副本）
│   ├── credential-ref.ts      # credentialRef（宿主叶子函数内联副本）
│   ├── launch-environment.ts  # launchEnvironmentOf（宿主叶子模块内联副本）
│   └── settings-section.ts    # settingsNamespace + installSettingsSection 等价物
│                              # + 极简 schemastery 兼容 schema（defaults/校验/redact 节点/toJSON）
└── client/
    ├── index.ts               # client 入口（__ModuleLoader__ 契约）
    ├── AnySearchCard.tsx      # 设置卡（webui AnySearchCard 移植；凭据路径改为当前契约）
    ├── anysearch-card-controller.ts  # 现版内置 WebSearchCardController 改版
    └── card-form.ts           # 现版内置 CardForm 逐字内联（ui-settings-plugins 不可被三方插件 import）

为什么 vendor 这么多宿主模块：装进 profile node_modules 的插件运行时不能 import 任何 @deepseek-ai/*（DSH 只发源码，tsx paths 只对 node_modules 之外的 importer 生效）， 需要的能力以叶子模块内联。构建末尾的守卫（build.mjs 的 assertHostExternals）会 在产物残留未验证的裸导入时直接让构建失败。

给扩展者的坑（已踩实）：自制 schema 的 toJSON() 必须输出 schemastery 的 { uid, refs } 序列化契约（内层节点序列化为数字 uid 并在 refs 注册）。浏览器端 ui-settings 用 new Schema(描述符.schema) rehydrate + 校验，失败则命名空间永远停在 status: 'unavailable'——设置卡整个消失，且无任何报错。scripts/smoke-host.mjs 的「client rehydration contract」断言防此回归。

已知取舍（不修复）

• web_search 失败时工具结果携带完整人类可读 message，但结构化 error info （{ name, code }）不会附带：宿主工具层用 error instanceof HarnessError（宿主类身份）提取它，第三方插件拿不到宿主类。 仓库内 provider（exa/perplexity/deepseek）走 tsx paths 不受影响。
• 宿主插件重启前不生效（host 半身无热重载；client 半身刷页面即生效）。

构建与测试

pnpm install        # 只需要 esbuild（devDependency）
node build.mjs      # 产出 lib/index.js + lib/client.js（esbuild 双 bundle）
node scripts/smoke-host.mjs    # 裸 node 跑宿主冒烟（解析/契约/provider 端到端）
node scripts/smoke-client.mjs  # vm 沙箱跑 client 冒烟（loader/槽位/卡片表单流）

构建不需要 DSH checkout；本机有 DSH checkout 时 esbuild 也可以从 node_modules/.pnpm/esbuild@* 借用（见 build.mjs 的三档解析）。 lib/ 已提交（git 依赖安装不跑 prepare），克隆后可直接安装。

安装 / 卸载

# 安装（bundle patch 自动注册，无需手改 profile 配置）
dsh plugin --profile web add github:statem-li/dsh-web-search-anysearch

# 卸载
dsh plugin --profile web remove dsh-web-search-anysearch

本地开发沿用 junction：

# junction 运行时代码 + junction node_modules（自包含，无 node_modules 也可）
New-Item -ItemType Junction `
  -Path "C:\Users\Anti\.dsh\profiles\web\node_modules\dsh-web-search-anysearch" `
  -Target "D:\AI\Dsh\dsh-web-search-anysearch"

改完 host 代码重启一次 DSH（改 client 代码普通刷新页面即可）。

验收清单（本次已跑）

• node build.mjs：host 产物运行时导入仅剩 node: 内置模块（守卫通过）
• 源码目录 + 已安装（junction）位置双侧冒烟 PASS
• --dump-config：- id: dsh-web-search-anysearch 出现在组合中； web.searchProvider: anysearch 与已有配置闭环
• DSH 源码零改动（git -C D:/AI/deepseek-harness status 确认）

License

MIT