前言¶

在 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 进程的权限运行。在安装前，建议检查插件源码与许可证信息，确保符合项目规范。