@djdowbnac/dsh-web-search-local
DeepSeek Harness（ctx.web）的网页搜索提供程序：通过内置的进程内元搜索或仅使用 DuckDuckGo 实现真实的互联网搜索，无需外部 API 密钥或外部实例，不依赖任何运行时依赖，此外还可选用完全本地的语料库全文索引。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add @djdowbnac/dsh-web-search-local@1.1.3Web Search Local 以 @djdowbnac/dsh-web-search-local 发布，当前版本为 1.1.3。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A web-search provider for the DeepSeek Harness without an account or API key, plus an optional fully local full-text index over your own files.
The plugin registers two search providers and one fetch provider on the ctx.web seam:
| Provider | What it does | Network |
|---|---|---|
web | Internet search via the built-in metasearch (auto, searxng) or DuckDuckGo only (duckduckgo). | outbound HTTPS to the upstreams |
local | Full-text search over a local corpus (BM25, snippets, incremental re-index, bun:sqlite FTS5 on Bun, pure-JS JSON on Node). | none |
local (fetch) | Reads file:// URLs from disk and retrieves the http(s):// URLs web_search returns. | on fetch only |
Pin web when you want internet search without a keyed external API. The stock web-search-deepseek plugin requires a DeepSeek account and API key.
web)The engine field selects the backend (UI or YAML):
auto (default): the built-in metasearch. Fans out to DuckDuckGo, Bing, and Wikipedia in parallel, then merges, dedups, and ranks the hits. No instance, no URL, no setup.duckduckgo: DuckDuckGo only, the keyless public endpoint html.duckduckgo.com/html/. Filters out the ad rows (duckduckgo.com/y.js).searxng: the same built-in metasearch. The value name is kept for compatibility with the 0.1.x instance model.The package is published on npm, so a normal install pulls the registry version:
dsh plugin --profile web add @djdowbnac/dsh-web-search-local
That is the whole install. dsh plugin initializes the profile on first use and forwards to pnpm add inside the profile directory (pnpm must be on PATH). To pin an exact version, add the full specifier (dsh plugin --profile web add @djdowbnac/dsh-web-search-local@1.1.2).
Remove it with:
dsh plugin --profile web remove @djdowbnac/dsh-web-search-local
To work on the plugin itself, point the same command at the checkout instead of the package name:
# from the plugin's checkout directory
dsh plugin --profile web add .
The directory becomes a pnpm local dependency, so the profile resolves the package name to this checkout, and the bundle registration works the same way. The dependency is a local link, so the profile always loads the current checkout. After editing sources, re-run bun run build for the change to take effect.
To skip the pnpm dependency entirely, point the row's name at a built entry point. From a checkout, that is bun run build first, then:
name: 'file:///<path>/dhs-web-search-local/lib/index.js'
The dependency installs (npm or checkout) need no manual mount. The layer order is: the stock base/surface bundle layers, the package bundle layers in dsh.profile.bundles order (this plugin's is last among them), the profile's cordis.patch.yml (user layer), $DSH_HOME/cordis.patch.yml, and any --patch overlays: the later layer wins. So the shipped patch is a stock base the user layer overrides freely: set corpusDirs, switch engine, pin a different provider. Inspect the composed tree any time:
dsh --profile web --dump-config
For the zero-install path (manual mount), apply ./cordis.patch.yml as a --patch overlay, or merge its rows into the profile's cordis.patch.yml at $DSH_HOME/profiles/web/cordis.patch.yml (default home ~/.dsh), adapting name to the file:// entry. A patch replaces the target row's whole config, so the snippet restates searchProvider and fetchProvider:
- insert:
- id: web-search-local
name: 'file:///<path>/dhs-web-search-local/lib/index.js' # zero-install entry
config:
corpusDirs: [!!js process.cwd()] # optional. Only used by the `local` provider
# engine: auto # auto | duckduckgo | searxng
- id: web
config:
searchProvider: web # <- internet. Use `local` for on-disk corpus search.
fetchProvider: local
Pinning is mandatory. The stock
deepseek-officialprovider is always "available", so without pinningsearchProviderthe seam reportsWEB_PROVIDER_AMBIGUOUS. The stockweb-search-deepseek/web-fetch-httprows may stay (registered but unselected). The shipped bundle patch does the pinning and deliberately sets nocorpusDirs: an auto-applied layer must not index the boot directory. Set it in the user layer or via the settings section.
The provider exposes the web-search-local settings section, persisted to $DSH_HOME/settings.yaml (hot-reloaded, so a change reaches the next search with no restart):
| Field | Default | Meaning |
|---|---|---|
engine | auto | Web backend: auto (metasearch: DuckDuckGo + Bing + Wikipedia), duckduckgo, or searxng (= metasearch, kept for 0.1.x compatibility). |
corpusDirs | [] | Directories to index (absolute or ~). Only used by the local search provider. Empty returns an informed empty result. |
include | built-in text/code set | Extra extensions to index (with or without a leading dot). |
exclude | built-in (node_modules, .git, *.min.js, lockfiles, more) | Extra dir names, file names, or dot-suffixes to skip. |
indexDir | <DSH home>/web-search-local | Where index.db or index.fallback.json and manifest.json live. |
maxResults | 20 | Per-query source cap (the seam re-enforces the tool's bound). |
snippetLength | 160 | Approximate snippet length. |
autoReindex | true | Re-scan the corpus on each search (bounded by an internal interval). false = build on change only. |
maxFileSizeBytes | 5000000 | Skip files larger than this. |
Two ways to configure:
web-search-local section in $DSH_HOME/settings.yaml (the same file the Settings UI writes). Example:
web-search-local:
engine: auto
corpusDirs:
- D:\docs
- ~/notes
web-search-local (engine, corpus dirs, max results, snippet length, index dir, auto-reindex, then Save). It is optional: when the deployment does not render cards, the YAML path remains fully functional.WEB_PROVIDER_ERROR (with per-upstream detail) only when every non-optional upstream fails.challenge failure, the same as any other upstream failure.publishedAt: Wikipedia hits carry it (the API timestamp). DuckDuckGo and Bing hits do not, because those upstreams expose no reliable date. Local corpus results use the file mtime.