@fffangchenghao/dsh-web-search 0.21.0 → 0.21.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +12 -0
- package/README.md +2 -2
- package/README.zh-CN.md +1 -1
- package/client.js +1 -1
- package/docs/comparison.md +5 -5
- package/package.json +1 -1
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,17 @@
|
|
|
1
1
|
# Changelog
|
|
2
2
|
|
|
3
|
+
## 0.21.1
|
|
4
|
+
|
|
5
|
+
### Documentation
|
|
6
|
+
- **Public evidence links for the 30-query comparison.** The raw three sweeps
|
|
7
|
+
and the query corpus are linked from `docs/comparison.md` through a public
|
|
8
|
+
gist, so the evidence is reachable without publishing the working tree.
|
|
9
|
+
- **README quickstart and cross-agent paths.** The package now includes
|
|
10
|
+
`docs/quickstart.md`, `docs/cross-agent.md` and the `web_tools` demo asset.
|
|
11
|
+
|
|
12
|
+
No runtime behavior changed since 0.21.0. **Test suite: 668 tests across 52 files**
|
|
13
|
+
(667 pass, 1 skipped).
|
|
14
|
+
|
|
3
15
|
## 0.21.0
|
|
4
16
|
|
|
5
17
|
### Added
|
package/README.md
CHANGED
|
@@ -22,7 +22,7 @@
|
|
|
22
22
|
- **No API key, eight engines.** AnySearch, CN Bing, DuckDuckGo HTML, www Bing, DuckDuckGo Lite and 360 Search are scraped directly; Exa joins the primary tier through its keyless MCP endpoint, and Firecrawl's search API is the measured fallback. The plugin works out of the box.
|
|
23
23
|
- **The ranking is measured, not asserted.** Cross-engine reciprocal-rank fusion with authority and freshness boosts, a 20-query offline benchmark, and an 81-configuration parameter sweep — one of the few search plugins here that publishes its metric, per-query output and confidence intervals. See [How the ranking works](docs/rrf-ranking.md).
|
|
24
24
|
- **One package, two runtimes.** DSH gets the native plugin and one `web_tools` entry; Claude Code, Codex and other MCP clients get the same keyless search through a dependency-free stdio server with `search`, `fetch`, `research` and `domain_search`. See [Cross-agent MCP](docs/cross-agent.md).
|
|
25
|
-
- **Measured in public, including the losses.** A 30-query bilingual comparison records availability, latency, unique domains, official-domain presence and every failure against keyless Firecrawl and anonymous Exa. Exa is faster here; this plugin returns more distinct domains. Both test arms were keyless. The method and raw results are in [docs/comparison.md](docs/comparison.md).
|
|
25
|
+
- **Measured in public, including the losses.** A 30-query bilingual comparison records availability, latency, unique domains, official-domain presence and every failure against keyless Firecrawl and anonymous Exa. Exa is faster here; this plugin returns more distinct domains. Both test arms were keyless. The method and raw results are in [docs/comparison.md](docs/comparison.md) and a [public gist](https://gist.github.com/fangchenghao/3db9838fa98928435c1c2df38202c373).
|
|
26
26
|
- **Fetching admits failure.** Binary documents and empty 200 responses are rejected by name (`SEARCH_UNSUPPORTED`, `SEARCH_EMPTY`) instead of being returned as noise; the direct → tunnel → render → extract ladder shares one 25 s budget and stops when there is no time left. The budget is per request — there is a regression test for exactly that.
|
|
27
27
|
- **668 tests across 52 files**, a committed `lib/`, declared `engines.dsh` / `engines.node`, and a [SECURITY.md](SECURITY.md) that lists every process, host and file the plugin touches.
|
|
28
28
|
- **Bilingual documentation.** This README and [中文说明](README.zh-CN.md) are maintained side by side.
|
|
@@ -60,7 +60,7 @@ read is:
|
|
|
60
60
|
Chrome, PostgreSQL and AI Act paths and the 34-source vertical layer are not
|
|
61
61
|
common in the other plugins.
|
|
62
62
|
- **Adoption and maturity:** bottom third of this sample. The public npm release
|
|
63
|
-
is 0.21.
|
|
63
|
+
is 0.21.1, matching this tree, but the GitHub repository is four days old
|
|
64
64
|
with no stars and little independent adoption.
|
|
65
65
|
- **Tool-surface economy:** now competitive. 0.20.x exposes one `web_tools`
|
|
66
66
|
entry with eight actions, close to `dsh-web-search-pro`'s two tools with 20
|
package/README.zh-CN.md
CHANGED
|
@@ -54,7 +54,7 @@ DSH 插件生态里的「联网搜索」已经很挤。下面是一张 2026-10-2
|
|
|
54
54
|
明确的安全边界、只有 1 个运行时依赖,同时体积远小于 Playwright 重型方案。
|
|
55
55
|
- **免 key + 官方源纠错:最强卖点。** Chrome、PostgreSQL、AI Act 的官方路径
|
|
56
56
|
和 34 个垂直源,不是其他插件普遍具备的。
|
|
57
|
-
- **采用度与成熟度:这个样本里的后段。** 公开 npm 已是 0.21.
|
|
57
|
+
- **采用度与成熟度:这个样本里的后段。** 公开 npm 已是 0.21.1,与这棵树一致;但 GitHub 仓库创建 4 天、0 stars,
|
|
58
58
|
还缺少独立采用。
|
|
59
59
|
- **工具面的经济性:现在有竞争力。** 0.20.x 只暴露一个 `web_tools` + 8 个
|
|
60
60
|
action,接近 `dsh-web-search-pro` 的 2 工具 + 20 动作;旧的八个工具名保留为
|
package/client.js
CHANGED
|
@@ -74,7 +74,7 @@
|
|
|
74
74
|
var ENTRY = 'web-search-bing';
|
|
75
75
|
var PACKAGE_NAME = 'dsh-web-search-bing';
|
|
76
76
|
/** Keep in step with package.json; compared with the npm registry. */
|
|
77
|
-
var VERSION = '0.21.
|
|
77
|
+
var VERSION = '0.21.1';
|
|
78
78
|
/** Snapshot used while no configuration service is reachable. */
|
|
79
79
|
var EMPTY_STATE = { status: 'unavailable', value: undefined, base: undefined, user: undefined, revision: undefined, writable: false };
|
|
80
80
|
|
package/docs/comparison.md
CHANGED
|
@@ -22,7 +22,7 @@ The failures are part of the result.
|
|
|
22
22
|
- **Exa arm:** the anonymous `web_search_exa` MCP endpoint with
|
|
23
23
|
`Accept: application/json, text/event-stream`; direct first, then tunnel.
|
|
24
24
|
- **No API keys** were used. All raw responses are in
|
|
25
|
-
[`
|
|
25
|
+
[`results-2026-10-26-sweep1.json`](https://gist.github.com/fangchenghao/3db9838fa98928435c1c2df38202c373).
|
|
26
26
|
|
|
27
27
|
Metrics: `P@8`, `R@8` and `MRR@8` are **not** reported here. They need
|
|
28
28
|
human-labelled relevance; inventing labels would make the table look stronger
|
|
@@ -70,9 +70,9 @@ By category (first sweep; answered / official / mean ms):
|
|
|
70
70
|
then 16/30 and 0/30 in two immediate repeats, with HTTP 429 on the tunnel
|
|
71
71
|
after a direct 403. That is a distribution/reliability limitation, not a
|
|
72
72
|
ranking difference. The repeat files are
|
|
73
|
-
[`sweep2`](https://github.com/fangchenghao/
|
|
73
|
+
[`sweep2`](https://gist.github.com/fangchenghao/3db9838fa98928435c1c2df38202c373)
|
|
74
74
|
and
|
|
75
|
-
[`sweep3`](https://github.com/fangchenghao/
|
|
75
|
+
[`sweep3`](https://gist.github.com/fangchenghao/3db9838fa98928435c1c2df38202c373).
|
|
76
76
|
- **No provider "wins" relevance here.** One official-domain miss does not mean
|
|
77
77
|
the answer is wrong, and an official domain is not always the best result.
|
|
78
78
|
The corpus is small and imbalanced: 13 release queries, 12 docs, one research
|
|
@@ -116,8 +116,8 @@ COMPARE_SLEEP_MS=1500 \
|
|
|
116
116
|
node bench/compare30.mjs --out /tmp/compare30.json
|
|
117
117
|
```
|
|
118
118
|
|
|
119
|
-
The script writes a JSON file next to a Markdown report. The three raw files in
|
|
120
|
-
|
|
119
|
+
The script writes a JSON file next to a Markdown report. The three raw files are also kept in
|
|
120
|
+
`bench/compare30/`; the public copy is the gist linked above. They were produced by the same command; sweeps 2 and 3 were run
|
|
121
121
|
immediately after sweep 1 to test repeatability, which is why Firecrawl's quota
|
|
122
122
|
failed. A single sweep is a snapshot, not a permanent ranking.
|
|
123
123
|
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@fffangchenghao/dsh-web-search",
|
|
3
|
-
"version": "0.21.
|
|
3
|
+
"version": "0.21.1",
|
|
4
4
|
"description": "DSH bundle: key-free web search, page fetch and one web_tools action tool for verticals, platforms and cited research; eight engines fused with RRF, 34 vertical sources, official-source checks, a replayable benchmark and a dependency-free MCP server.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|