dsh-free-search 0.4.1 → 0.4.3

package/README.en.md

@@ -50,6 +50,12 @@ Free engines auto-fallback to another free engine on failure. Paid engines fail
   - Perplexity: <https://www.perplexity.ai/settings/api>
   - DeepSeek: <https://platform.deepseek.com/api_keys>
 
+### Why is AnySearch free?
+
+AnySearch (anysearch.com) is an AI search gateway that offers **anonymous public search quota** — its `v1/search` REST endpoint can be called directly without registration or an API key. The quota is rate-limited (fine for everyday use), but as one of several free engines with mutual failover, the experience stays reliable.
+
+Exa works the same way: its public MCP endpoint (`mcp.exa.ai/mcp`) supports anonymous calls, so it works without a key; setting `EXA_API_KEY` unlocks higher limits.
+
 ## Install
 
 ```sh
@@ -63,6 +69,10 @@ Then restart:
 dsh web
 ```
 
+### Dependency note
+
+`@deepseek-ai/dsh-settings` and `@deepseek-ai/dsh-tools` are intentional `peerDependencies`: the DSH runtime must use one installation-tree instance. Install this plugin through `dsh plugin --profile <profile> add ...`; do not copy DSH core packages into a profile-local `node_modules`, because duplicate copies can split the tool scheduler and break every tool call.
+
 ## Usage
 
 ### Web settings (recommended)
@@ -132,24 +142,6 @@ Restart `dsh web` after switching.
 
 > The settings card mounts on the official `settings.plugin.item` slot (built into dsh); config reads/writes go through the plugin's own bridge. **No dsh-web-ui dependency — the plugin works standalone.**
 
-## Competitor radar (tools/)
-
-Keep an eye on search-related competitors: `tools/competitor-radar.mjs` monitors:
-
-- **10 known competitors** for updates (shows recent commits on change)
-- **New search plugins** in the awesome-dsh-plugin list
-- **New projects** under the GitHub dsh-plugin topic (last 7 days)
-- Suggests **feature directions worth watching** (cache / platform search / keyless etc.)
-
-Usage:
-
-```sh
-node tools/competitor-radar.mjs        # incremental (changes only)
-node tools/competitor-radar.mjs --full # full scan
-```
-
-Set `GH_TOKEN` (GitHub token) for higher API rate limits.
-
 ## Proxy note
 
 DuckDuckGo and some engines may be blocked and need a proxy. Node.js `fetch` does not use the system proxy by default — set these environment variables for the dsh process (Node 24+):

package/README.md

@@ -49,6 +49,12 @@ dsh 默认的搜索 provider 依赖 DeepSeek 官方 API key（`DEEPSEEK_API_KEY`
   - Perplexity：<https://www.perplexity.ai/settings/api>
   - DeepSeek：<https://platform.deepseek.com/api_keys>
 
+### 为什么 AnySearch 免费？
+
+AnySearch（anysearch.com）是一个 AI 搜索网关，提供**匿名的公共搜索额度**——通过其 `v1/search` REST 接口可以直接调用，无需注册或 API key。额度有限流（适合日常搜索），但作为免费引擎之一，与其他免费引擎互相回退，体验稳定。
+
+Exa 同理：其公开 MCP 端点（`mcp.exa.ai/mcp`）支持匿名调用，因此不配置 key 也能用；配置 `EXA_API_KEY` 后可获得更高额度。
+
 ## 安装
 
 ```sh
@@ -62,6 +68,10 @@ dsh plugin --profile web add /path/to/dsh-free-search
 dsh web
 ```
 
+### 依赖说明
+
+插件对 `@deepseek-ai/dsh-settings` 和 `@deepseek-ai/dsh-tools` 使用 `peerDependencies`，这是刻意的：DSH 运行时必须使用安装树中的唯一实例。请通过 `dsh plugin --profile <profile> add ...` 安装插件，不要把 DSH 核心包复制进 profile 的本地 `node_modules`；重复副本会导致工具调度器失效。
+
 ## 使用
 
 ### 网页设置（推荐）
@@ -131,24 +141,6 @@ Search engine test:
 
 > 配置卡片挂在官方设置页的 `settings.plugin.item` 插槽（dsh 自带），配置读写走插件自建 bridge，**不依赖 dsh-web-ui**，插件可独立使用。
 
-## 竞品雷达（tools/）
-
-盯着搜索类竞品抄？`tools/competitor-radar.mjs` 自动监控：
-
-- **10 个已知竞品**的更新（有更新时显示最近提交）
-- **awesome-dsh-plugin 列表**新增的搜索类插件
-- **GitHub dsh-plugin topic** 近 7 天新项目
-- 自动提示**值得关注的功能方向**（缓存/平台搜索/keyless 等）
-
-用法：
-
-```sh
-node tools/competitor-radar.mjs        # 增量扫描（只报变化）
-node tools/competitor-radar.mjs --full # 完整扫描
-```
-
-Windows 也可双击 **`竞品雷达.cmd`**。需要 `GH_TOKEN` 环境变量（GitHub token）获得更高 API 额度。
-
 ## 代理说明（国内用户）
 
 DuckDuckGo 等引擎可能需要代理才能访问，而 Node.js 的 `fetch` 默认不走系统代理。需要给 dsh 进程设置（Node 24+）：

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-free-search",
-  "version": "0.4.1",
+  "version": "0.4.3",
   "description": "Free web search for DeepSeek Harness: 8 engines (Bing/DuckDuckGo/AnySearch/SearXNG/Exa keyless) + platform search + web_fetch, with web settings UI.",
   "type": "module",
   "main": "lib/index.js",
@@ -38,10 +38,16 @@
     "node": ">=20"
   },
   "dependencies": {
-    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
-    "@deepseek-ai/dsh-tools": "0.1.0-rc.6",
     "@deepseek-ai/schemastery": "^3.18.1"
   },
+  "peerDependencies": {
+    "@deepseek-ai/dsh-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6"
+  },
+  "devDependencies": {
+    "@deepseek-ai/dsh-settings": "0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "0.1.0-rc.6"
+  },
   "dsh": {
     "bundle": {
       "patch": "cordis.patch.yml"