前言¶

在 DeepSeek Harness (DSH) 的开发实践中，智能体经常需要处理结构化的 JSON 数据。无论是从 API 响应中提取特定字段，还是在会话中动态修改数据结构，直接操作字符串往往效率低下且容易出错。dsh–query 提供了标准化的 JSON 路径查询与设置能力，帮助开发者更安全、高效地管理数据。

插件介绍¶

dsh–query 是一个纯 Node.js 实现的 DSH 插件，无需依赖外部网络服务。它专注于解决 JSON 数据的路径查询与赋值问题，由开发者 istone 维护，遵循 MIT 许可证。该插件通过注册特定的工具，将 JSON 路径操作能力集成到 DSH 的会话中。

核心功能¶

• JSON 路径查询：支持根据 JSON 路径表达式提取数据。
• JSON 路径设置：支持根据 JSON 路径修改或新增数据。

安装与启用¶

在终端中执行以下命令安装插件：

dsh plugin add dsh--query

安装完成后，需要在 profile 的 package.json 文件中的 dsh.profile.bundles 字段添加 "dsh--query"。

插件依赖以下环境：
* @deepseek-ai/cordis (^4.0.1)
* @deepseek-ai/dsh-tools (>=0.1.0-rc.6)

典型用法¶

安装完成后，在 DSH 的会话中即可调用该插件注册的工具，具体使用方式取决于工具的具体接口定义。

适用场景与注意¶

本插件适合需要在 DSH 上下文中进行复杂 JSON 数据处理的场景。

安全提示：安装即在本机运行第三方代码，请自行审阅源码后再进行安装。

结语¶

dsh–query 为 DSH 生态提供了一套轻量级的 JSON 数据处理方案。通过路径查询与设置功能，可以简化数据交互逻辑。

• 插件目录：https://www.skillhub.cn/plugins/uckkk/dsh–query
• 源码仓库：https://github.com/uckkk/dsh-json-query