前言¶
在开发 DeepSeek Harness (DSH) 插件或智能体时，经常需要程序化地获取 npm 或 PyPI 的包元数据。手动查询或直接调用外部 API 会增加延迟并破坏流程。下面介绍一个专门为此设计的插件。
是什么¶
这是一个注册 pkg_info 工具的 DSH 插件，由 ZhijiangTang 维护。它将 npm 与 PyPI 的包元数据查询规范化为结构化 JSON 对象，供模型与 Code Mode 程序化调用。插件零依赖、纯 ESM、无构建。
核心功能¶
- 查询 npm 包元数据：包含名称、版本、描述、许可证、作者、主页、仓库、版本数、依赖等。
- 查询 PyPI 包元数据：包含名称、版本、摘要、许可证、作者、主页、发布版本数、依赖列表等。
- 错误处理：永不抛异常。404、网络错误、超时、JSON 解析失败都折叠为结构化对象。
安装与启用¶
安装前，请检查源码与许可证。安装命令如下：
dsh plugin --profile <name> add dsh-pkg-info
典型用法¶
调用 pkg_info 工具。参数 registry 支持 npm 或 pypi。参数 name 是必填的。参数 version 支持指定版本或 latest/next 等标签（npm 默认为 latest）。PyPI 项目名大小写不敏感。
示例：
// 查 npm 最新版
{ "registry": "npm", "name": "yaml" }
// 查 npm 指定版本
{ "registry": "npm", "name": "yaml", "version": "2.5.0" }
// 查 PyPI 最新版
{ "registry": "pypi", "name": "requests" }
// 查 PyPI 指定版本
{ "registry": "pypi", "name": "requests", "version": "2.28.1" }
适用场景与注意¶
适合需要包元数据的智能体。该插件以当前 dsh 进程权限运行，需要 network:outbound 权限。安装前应检查源码与许可证。
结尾¶
经过上面的步骤，你可以集成包查询功能。目录：https://www.skillhub.cn/plugins/ZhijiangTang/dsh-pkg-info，GitHub：https://github.com/ZhijiangTang/dsh-pkg-info。
