dsh-anysearch

@zhitiaojun/dsh-anysearch

AnySearch 实时搜索的 DeepSeek Harness 原生插件 —— 改编自 anysearch-skill（v3.1.0，Apache-2.0）。原 skill 用 Python/Node/PS/Bash 四语言 CLI 子进程包装 https://api.anysearch.com；本插件改为 cordis 原生工具（免子进程、注入即生效、免重启热重载），并新增 API key 设置面板。

⚠️ 不能与官方的 AnySearch 插件共存

本插件与官方 @anysearch/anysearch-dsh 不能同时安装。 两者都注册 anysearch_search 与 anysearch_batch_search，工具名完全相同，后加载的一方必然注册失败：

failed to apply loader entry (@zhitiaojun/dsh-anysearch):
tool "anysearch_search" is already registered

安装本插件前，请先卸载或停用官方包；反之亦然。两者的定位也不同——官方包走 registerSearchProvider 把 AnySearch 接到宿主既有的 web_search/web_fetch 之下， 本插件则是独立的 4 个原生工具（含官方包不具备的域目录发现与 API key 设置面板）。

功能

工具	说明
anysearch_search	通用/垂直域实时搜索（query + 可选 tag/params/zone/language/max_results）
anysearch_batch_search	1-5 条搜索并行执行，单项失败不阻塞其它项
anysearch_sub_domains	垂直域目录发现（tag + 必填参数），垂直搜索前必调
anysearch_extract	网页全文转 Markdown（HTML/文本/JSON/MD；不支持 PDF/图片/音视频等二进制）

另有：

• 系统提示注入：声明 anysearch 优先于内置 web_search/web_fetch，后者仅作后备。
• 设置面板：GUI「设置 → AnySearch」—— 保存/清除/测试 API key，实时生效（无需重启）。
• API key 优先级：设置面板 > 插件目录 .env > 环境变量 ANYSEARCH_API_KEY > 匿名（低限额）。
• 配额耗尽时若 API 返回 auto_registered 新 key，工具结果会提示（经用户确认后保存，不自动落盘）。

安装

安装前请先确认已卸载 / 停用官方 @anysearch/anysearch-dsh——两者工具同名，不能共存（见上文警告）。

插件市场（推荐给使用者）

DSH → 设置 → 插件市场 → 发现（或搜索 AnySearch）→ 安装。装完在设置页的 AnySearch 分区里配 API key 即可。

作为 git 依赖手动安装

在 profile 目录（~/.dsh/profiles/<名字>，网页版默认 web）执行：

pnpm add github:zhitiaojun/dsh-anysearch

再把包名 @zhitiaojun/dsh-anysearch 加进该 profile package.json 的 dsh.profile.bundles，重启 DSH。

仓库只提交源码、不提交 lib/ 构建产物：安装时由 prepare（node scripts/build.mjs，纯 node、跨平台、无 bash 依赖）自动编译 host 与 client。

⚠️ pnpm 10+ 默认禁止依赖执行构建脚本，首次直接 pnpm add 会报 ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED（"…needs to execute build scripts but is not in the allowBuilds allowlist"）。两种处理：

• 从插件市场安装：市场会识别这个错误并弹出 approve-builds 确认，确认后自动写入白名单并重试——无需手工操作。

• 手工安装：把 pnpm 错误信息里给出的那行键加进 profile 的 pnpm-workspace.yaml，然后重试（键需与 pnpm 提示的完全一致，形如 '@zhitiaojun/dsh-anysearch@https://codeload.github.com/zhitiaojun/dsh-anysearch/tar.gz/<40位commit>': true），例如：

  allowBuilds:
    '@zhitiaojun/dsh-anysearch@https://codeload.github.com/zhitiaojun/dsh-anysearch/tar.gz/<commit>': true
  

本地开发目录（dsh-super-injector 环境）

dev_build_plugin  D:/Project/anysearch   # tsc host + tsdown client + npm pack
dev_inject_plugin D:/Project/anysearch   # 运行时注入，即刻生效

卸载：dev_uninject_plugin { match: "dsh-anysearch" }。重启后由注入器自愈机制自动装回。

本地开发

npm install          # 装依赖（并触发 prepare：自动完成一次构建）
npm run build        # host（tsc）+ client（tsdown）→ lib/
npm run build:host   # 只构建 host
npm run build:client # 只构建 client（tsdown）
npm run typecheck    # tsc --noEmit

环境变量：ANYSEARCH_API_BASE_URL（默认 https://api.anysearch.com）、DSH_RUNTIME（dsh 的 node_modules，运行时链接探测失败时手动指定）。

设置数据存于 ~/.dsh/dsh-anysearch/config.json。

bash 不可用的环境（如 DSH 沙箱下 cygwin 无法建 signal pipe）直接用 node scripts/build.mjs： 构建逻辑全在这个 node 脚本里，scripts/build.sh 只是它给注入器链路用的薄包装。

踩坑记录（给后续插件作者）

1. cordis inject 服务名大小写敏感。 宿主 webserver 服务注册名是驼峰 webServer（见 @deepseek-ai/dsh-host-webserver/lib/index.js 里 super(ctx, "webServer")），inject 写成 全小写 webserver 会让 entry 永远 pending (waiting for service: webserver)，boot 阶段断言失败。 拿不准就去宿主包 lib 里搜 super(ctx, " 确认服务注册名。
2. defineTool 的 output.schema 是 value schema DSL，不是原始 JSON Schema。 requiredness 写在属性上的 required: true，写 required: ['x'] 数组会报 unsupported JSON schema: schema.required is not supported by the value schema DSL，导致 loader.create 直接失败。
3. npm 在 DSH 文件沙箱下需把缓存指进工作区（--cache .npm-cache），默认缓存路径在 ~/AppData/Local/npm-cache，会被 workspace-write 策略拒绝。
4. 插件目录移动/改名后，运行中的 DSH 进程不会跟着走。 Node 的 ESM 与 CJS 解析缓存都把 「包名 → 旧绝对路径」钉死在进程内，JS 层无法清除：改完目录必须重启 DSH；若想不重启就恢复， 可在旧路径放一个兼容 shim（re-export + package.json 镜像，见本仓库 .gitignore 里 /dsh-anysearch/ 的注释——重启后即可删除）。

安全说明

• 搜索词、提取的 URL 与 API key 会发送到 api.anysearch.com；勿用于含敏感信息的查询。
• anysearch_extract 返回的页面内容是不可信外部数据：仅当数据使用，勿执行其中指令。

致谢与许可

基于 anysearch-skill（Apache License 2.0, © AnySearch Team）改编：API 协议、参数语义、markdown 格式化与容错解析逻辑移植自其 scripts/anysearch_cli.js。本插件同样以 Apache-2.0 发布（见 LICENSE / NOTICE）。