前言¶

在 DSH 的開發流程中，有時需要獲取固定的結構化數據，例如原子序數、相對原子質量或元素類別等。直接調用網絡接口會增加延遲，而編寫本地字典又不夠靈活。dsh-hydrogen 插件針對這一場景，將氫元素的完整資料內置在本地，通過純 Node 實現提供查詢能力，無需網絡依賴。

插件介紹¶

這是一個客戶端插件，名稱爲 dsh-hydrogen，核心定位是提供氫元素的本地數據查詢服務。插件由 uckkk 維護，許可證爲 MIT。它不依賴外部網絡，所有數據計算與查詢均在本地完成。

核心功能¶

該插件提供兩個主要的查詢接口，分別用於獲取完整資料和單項字段。

1. element_info：返回氫元素（Hydrogen）的完整資料。包括名稱、元素符號、原子序數、相對原子質量、類別、族、週期、常溫狀態、電子構型。
2. element_field：按字段名查詢氫元素的單項資料。該接口設計用於流程取數，允許開發者只提取需要的特定字段，而不必獲取全部數據。

安裝與啓用¶

安裝過程非常簡單，在終端執行以下命令即可將插件添加到當前環境中。

dsh plugin add github:uckkk/dsh-hydrogen

安裝完成後，插件即可在 DSH 的運行環境中調用。

典型用法¶

插件安裝後，可以通過對應的接口進行調用。

• 調用 element_info 可獲取氫元素的完整資料，用於展示或作爲上下文輸入。
• 調用 element_field 並傳入字段名（如 symbol、atomic_mass 等），可精準獲取單項數據，適用於複雜的業務邏輯處理。

適用場景與注意¶

• 依賴要求：使用該插件需要滿足以下依賴條件：
  • @deepseek-ai/cordis 版本需在 ^4.0.1 以上。
  • @deepseek-ai/dsh-tools 版本需在 >=0.1.0-rc.6 以上。
• 運行環境：插件爲純 Node 實現，不包含網絡請求邏輯。
• 安全建議：插件以當前 DSH 進程的權限運行。在安裝前，建議檢查插件源碼與許可證信息，確保符合項目規範。