dsh-client-ui-elasticsearch
English | 中文
A DeepSeek Harness plugin that adds an Elasticsearch section to Settings and a
host-side es_query_logs model tool.
- Settings → Elasticsearch: configure
uris (one per line), username, and
password. Values are stored in the shared DSH settings document and shared
across sessions.
es_query_logs tool: search logs by trace_id (exact match) and/or by
natural-language search terms via query (matched against message,
exception, and other log text fields), with optional fields, index, and
size. It reuses the connection configured above.- Auto-guidance: a system-prompt section teaches every session to use the
tool when a
trace_id or a log-content question is asked — no dedicated
agent preset required.
Install
dsh plugin --profile web add @asuka1121/dsh-client-ui-elasticsearch@latest
Then restart the deployment. The package declares dsh.bundle.patch, so
dsh plugin registers it as a profile bundle automatically.
Requires pnpm on PATH. The plugin resolves its @deepseek-ai/* runtime
dependencies as peer dependencies from the DSH installation, so it shares the
installation's single Cordis instance.
Tool
es_query_logs parameters:
| name | type | required | default | notes |
|---|
query | string | no* | — | natural-language search terms matched against log text fields (e.g. "connection refused", "NullPointerException") |
trace_id | string | no* | — | exact trace id to search across trace fields |
fields | string[] | no | common log text fields | explicit fields the query matches against; wildcards unsupported |
index | string | no | * | index pattern to target |
size | integer | no | 100 | max hits, capped at 500 |
* at least one of query or trace_id is required.
trace_id runs exact term queries on trace_id, trace.id, traceId,
and traceID.query runs a multi_match (best_fields) over the resolved fields, avoiding
wildcard field expansion that fails on wide indices.- Both together narrow by trace and content; results are sorted by
@timestamp desc, trying each configured URI in order.
License
MIT
Development
The compiled lib/ ships with this repo, so consumers can install from the
directory directly. Building from source requires the
deepseek-harness monorepo:
tsdown.config.ts imports the clientBundle preset from
packages/client/tsdown.client.ts. The published npm package
(@asuka1121/dsh-client-ui-elasticsearch) is the canonical build artifact.
Future Plans
Vision. The real payoff of a log-search plugin is correlation: not just
finding log lines, but tracing each one back to the project code that produced
it. The long-term goal is exactly that — log-to-code traceability.
Current boundary. Today the agent correlates logs only against the local
workspace. Code-side integration stays on hold until DSH officially exposes a
remote/network workspace (e.g. binding 0.0.0.0) — correlating logs against a
workspace the agent cannot reach would be meaningless.
Open problem — acquiring the code. The leading idea is to clone the owning
project on the server side, on demand, before each query, keyed by the
app_name found in the logs, so answers stay self-contained and always based
on the latest code. Storing full clones for every app is expensive, so lighter
approaches are under evaluation: shallow/partial clones, lazily fetching only
the files a trace references, and cache/eviction policies.
