DeepSeek Harness (DSH) 的生态设计理念是「一切皆插件」。在智能体开发中，经常需要让模型直接访问后端日志进行排查。如果手动集成 Elasticsearch 客户端，配置流程会比较繁琐。下面介绍 dsh-client-ui-elasticsearch 插件，它通过添加设置面板和内置工具，解决了这一连接与查询问题。
插件定位¶
dsh-client-ui-elasticsearch 是由 SaitoAsuka1121 维护的一个 DeepSeek Harness 插件。它主要做两件事：一是为 DSH 的设置界面添加一个 Elasticsearch 配置区块，二是提供 es_query_logs 模型工具。其核心价值在于将 Elasticsearch 的连接配置与日志查询能力封装进 DSH 的运行时环境，让 Agent 能够直接通过自然语言或 Trace ID 查询日志。
核心功能¶
-
设置面板集成
插件会在 DSH 的设置中增加 Elasticsearch 部分。开发者可以在此配置服务端的连接地址（uris）、用户名和密码。这些配置存储在 DSH 的共享设置文档中，可以在不同会话间复用。 -
es_query_logs 工具
插件提供名为es_query_logs的模型工具。该工具支持两种查询方式：- trace_id 查询：输入 Trace ID 进行精确匹配。
- 自然语言查询：输入关键词（如 “connection refused”），匹配
message、exception等文本字段。
工具还支持通过fields、index和size参数进行日志过滤和结果限制。
-
自动引导
插件包含自动引导系统提示，当用户在对话中询问 trace_id 或日志内容时，工具会自动提示 Agent 使用es_query_logs，无需额外配置专门的 Agent 预设。
安装与启用¶
安装前请确保系统 PATH 中已安装 pnpm，且已正确安装 DeepSeek Harness 运行时。
执行以下命令安装插件：
dsh plugin --profile web add @asuka1121/dsh-client-ui-elasticsearch@latest
安装完成后重启部署。该插件声明了 dsh.bundle.patch，安装命令会自动将其注册为 Web 专属的 Profile Bundle。
典型用法¶
-
配置连接
登录 DSH 后，进入设置页面，找到 Elasticsearch 配置区块。按行输入uris，填写username和password。 -
查询日志
在对话中，Agent 会自动识别日志查询意图。- Trace ID 查询：直接提供 Trace ID，Agent 会进行精确匹配。
- 自然语言查询：描述问题，如 “帮我查一下最近有没有 NullPointerException”。
Agent 会调用
es_query_logs工具，使用配置的index和size参数进行检索。
适用场景与注意¶
该插件适合需要在 DSH 上下文中直接检索 ElasticSearch 日志的场景，例如开发调试或异常排查。
注意事项：插件以当前 DSH 进程的权限运行。在安装使用前，建议开发者检查插件源码与许可证（MIT）。此外，插件依赖 DSH 安装的 @deepseek-ai/* 运行时依赖，确保环境依赖完整。
总结¶
dsh-client-ui-elasticsearch 通过封装设置项和模型工具，简化了 DSH 与 Elasticsearch 的集成过程。它利用自动引导机制降低了使用门槛，适合希望提升日志排查效率的开发者。
