dsh-client-ui-elasticsearch

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.