前言¶
在開發 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。
