@nite07/dsh-search 0.1.0 → 0.1.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/README.md +25 -32
- package/README.zh.md +26 -33
- package/package.json +2 -3
package/README.md
CHANGED
|
@@ -2,53 +2,46 @@
|
|
|
2
2
|
|
|
3
3
|
English | [中文](README.zh.md)
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
Multi-backend web search for DeepSeek Harness: 21 search providers you turn on one by one, each with an explicit access mode and a visible cost tier.
|
|
6
6
|
|
|
7
|
-
##
|
|
8
|
-
|
|
9
|
-
- 21 backend entries, independently enabled; explicit anonymous or key access where supported.
|
|
10
|
-
- No provider, credential, endpoint, or access-mode fallback.
|
|
11
|
-
- Bounded configurable HTTP retries, cancellation, deadlines and Retry-After handling.
|
|
12
|
-
- Cost tiers, dated quota disclosures and official references per access mode.
|
|
13
|
-
- Native Settings > Search management page, English/Chinese localization, editable public configuration, credential controls, validation, diagnostics and explicit trial searches.
|
|
14
|
-
- Parallel or single-backend search, deterministic URL/title deduplication and RRF/ordered fusion.
|
|
15
|
-
- Bounded in-memory cache; failures are never cached.
|
|
16
|
-
- Durable local attempt reservations, serialized before sending, grouped by backend and mode. UTC reset; these are not provider balances or monetary guarantees.
|
|
17
|
-
- Agent-visible partial and total failure explanations.
|
|
18
|
-
|
|
19
|
-
All backends are disabled on first installation. Enabling an account-backed backend may incur charges even when its platform advertises free credits. Stored keys never activate a backend automatically. Do not assume a supplier's internal routing is controlled by this plugin.
|
|
20
|
-
|
|
21
|
-
## Development
|
|
7
|
+
## Install
|
|
22
8
|
|
|
23
9
|
```sh
|
|
24
|
-
|
|
25
|
-
|
|
10
|
+
dsh plugin add @nite07/dsh-search
|
|
11
|
+
dsh --profile web # or restart your running dsh web process
|
|
26
12
|
```
|
|
27
13
|
|
|
28
|
-
|
|
14
|
+
Or install it from **Settings → Plugins → Add plugin**.
|
|
29
15
|
|
|
30
|
-
|
|
16
|
+
Then make it the search source: open **Settings → Web search**. If the page says the current provider is something else, click **Use this plugin for web search**.
|
|
31
17
|
|
|
32
|
-
|
|
18
|
+
## Quick start
|
|
33
19
|
|
|
34
|
-
|
|
20
|
+
1. Open **Settings → Web search**.
|
|
21
|
+
2. In the **Backends** tab, pick the providers you want, choose **anonymous** or **API key** for each, and check the cost line before enabling.
|
|
22
|
+
3. Press **Save settings**. Every backend starts disabled, so nothing is called until you save.
|
|
35
23
|
|
|
36
|
-
|
|
24
|
+
The **Test & diagnostics** tab runs one explicit search against a saved backend and shows the exact request outcome.
|
|
37
25
|
|
|
38
|
-
##
|
|
26
|
+
## Backends and cost
|
|
39
27
|
|
|
40
|
-
|
|
28
|
+
Each backend is filed under a cost tier for the selected access mode: free, free allowance (key required), trial credits, paid usage, or self-hosted.
|
|
41
29
|
|
|
42
|
-
|
|
30
|
+
- Free anonymous tiers that work without any account: Keenable, Exa, You.com, AnySearch, Parallel.
|
|
31
|
+
- Local SearXNG is supported and needs no key.
|
|
32
|
+
- A **Live-tested** badge means this plugin completed a real call to that backend.
|
|
43
33
|
|
|
44
|
-
|
|
34
|
+
Per-backend quotas, prices, sources and the date they were checked: [docs/BACKENDS.md](docs/BACKENDS.md).
|
|
45
35
|
|
|
46
|
-
##
|
|
36
|
+
## Development
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
npm install --ignore-scripts --legacy-peer-deps
|
|
40
|
+
npm run check
|
|
41
|
+
```
|
|
47
42
|
|
|
48
|
-
|
|
49
|
-
- Default branch: `main`
|
|
50
|
-
- Feature branches are cut from `main` and merged back with `--ff-only`.
|
|
43
|
+
Design notes: [docs/PLAN.md](docs/PLAN.md). Verification status: [docs/VERIFICATION.md](docs/VERIFICATION.md).
|
|
51
44
|
|
|
52
45
|
## License
|
|
53
46
|
|
|
54
|
-
MIT.
|
|
47
|
+
MIT.
|
package/README.zh.md
CHANGED
|
@@ -2,53 +2,46 @@
|
|
|
2
2
|
|
|
3
3
|
[English](README.md) | 中文
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
给 DeepSeek Harness 用的多后端网页搜索:21 家搜索服务,逐个开关,每个都明确选定接入模式、标明费用档。
|
|
6
6
|
|
|
7
|
-
##
|
|
8
|
-
|
|
9
|
-
- 21 个搜索后端,各自独立开关;支持的后端可以在**匿名**和**API Key** 两种接入模式里固定选一种
|
|
10
|
-
- 不自动切换后端、不换凭证、不改端点、不跨模式回退;失败就是失败
|
|
11
|
-
- HTTP 重试可配置且有上限,支持取消、总超时和 `Retry-After`
|
|
12
|
-
- 按接入模式标注费用档、额度说明(含核实日期)和官方来源
|
|
13
|
-
- 原生「设置 → 网页搜索」管理页,中英双语,公开配置项全部可改,含凭证管理、校验、诊断和显式试搜
|
|
14
|
-
- 支持并行搜索或单后端搜索,按 URL / 标题去重,RRF 或后端顺序融合
|
|
15
|
-
- 内存缓存有容量上限;**失败的请求永不进缓存**
|
|
16
|
-
- 本地尝试额度按「后端 + 模式」持久化,发送前原子预占、串行化。按 UTC 跨日重置;这是本地计数,不是服务商余额,也不代表账单上限
|
|
17
|
-
- 部分失败和全部失败都会写进 Agent 能看到的返回内容,不会伪装成「没有结果」
|
|
18
|
-
|
|
19
|
-
首次安装时**所有后端都是关闭的**。即使平台宣称有免费额度,账户类后端开启后仍可能产生费用。保存了 Key 也不会自动启用任何后端。供应商内部的路由、重试和融合由对方控制,不属于本插件的可配置范围。
|
|
20
|
-
|
|
21
|
-
## 开发
|
|
7
|
+
## 安装
|
|
22
8
|
|
|
23
9
|
```sh
|
|
24
|
-
|
|
25
|
-
|
|
10
|
+
dsh plugin add @nite07/dsh-search
|
|
11
|
+
dsh --profile web # 或者用你自己的方式重启 dsh web
|
|
26
12
|
```
|
|
27
13
|
|
|
28
|
-
|
|
14
|
+
也可以在 **设置 → 插件 → 添加插件** 里安装。
|
|
29
15
|
|
|
30
|
-
|
|
16
|
+
装完把它设为搜索来源:打开 **设置 → 网页搜索**,如果页面提示当前不是本插件,点「**设为网页搜索来源**」。
|
|
31
17
|
|
|
32
|
-
|
|
18
|
+
## 快速开始
|
|
33
19
|
|
|
34
|
-
|
|
20
|
+
1. 打开 **设置 → 网页搜索**
|
|
21
|
+
2. 在「搜索后端」页签里挑后端,逐家选择**匿名**或 **API Key** 模式,先看费用说明再启用
|
|
22
|
+
3. 点「保存设置」。所有后端默认关闭,不保存就一个请求都不会发出
|
|
35
23
|
|
|
36
|
-
|
|
24
|
+
想先验一下某家通不通,用「试搜与诊断」页签:它会明确发一次搜索,并把结果和失败原因原样显示出来。
|
|
37
25
|
|
|
38
|
-
##
|
|
26
|
+
## 后端与费用
|
|
39
27
|
|
|
40
|
-
|
|
28
|
+
每个后端按**当前选中的接入模式**归类到费用档:免费、免费额度(需密钥)、试用额度、付费用量、自托管。
|
|
41
29
|
|
|
42
|
-
|
|
30
|
+
- 无需账号即可用的免费档:Keenable、Exa、You.com、AnySearch、Parallel
|
|
31
|
+
- 本机自建 SearXNG 也支持,不需要密钥
|
|
32
|
+
- 带「**已实测**」标记的,表示本插件真实调用成功过
|
|
43
33
|
|
|
44
|
-
|
|
34
|
+
各家的额度、单价、来源链接和核实日期见 [docs/BACKENDS.md](docs/BACKENDS.md)。
|
|
45
35
|
|
|
46
|
-
##
|
|
36
|
+
## 开发
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
npm install --ignore-scripts --legacy-peer-deps
|
|
40
|
+
npm run check
|
|
41
|
+
```
|
|
47
42
|
|
|
48
|
-
|
|
49
|
-
- 默认分支:`main`
|
|
50
|
-
- 功能分支从 `main` 切出,用 `--ff-only` 合回
|
|
43
|
+
设计与实现说明:[docs/PLAN.md](docs/PLAN.md);验证记录:[docs/VERIFICATION.md](docs/VERIFICATION.md)。
|
|
51
44
|
|
|
52
|
-
##
|
|
45
|
+
## 许可
|
|
53
46
|
|
|
54
|
-
MIT
|
|
47
|
+
MIT。
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@nite07/dsh-search",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.1",
|
|
4
4
|
"description": "Explicit-mode multi-backend search with transparent costs and complete Web settings for DSH",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -45,8 +45,7 @@
|
|
|
45
45
|
"check": "npm run typecheck && npm test && npm run build"
|
|
46
46
|
},
|
|
47
47
|
"engines": {
|
|
48
|
-
"node": ">=22"
|
|
49
|
-
"dsh": ">=0.2.2"
|
|
48
|
+
"node": ">=22"
|
|
50
49
|
},
|
|
51
50
|
"peerDependencies": {
|
|
52
51
|
"@deepseek-ai/cordis": "*",
|