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 的集成過程。它利用自動引導機制降低了使用門檻，適合希望提升日誌排查效率的開發者。
