@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/': 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 只是它给注入器链路用的薄包装。
踩坑记录（给后续插件作者）
- 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, "确认服务注册名。 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直接失败。- npm 在 DSH 文件沙箱下需把缓存指进工作区（
--cache .npm-cache），默认缓存路径在
~/AppData/Local/npm-cache，会被 workspace-write 策略拒绝。 - 插件目录移动/改名后，运行中的 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）。
