dsh-pkg-info

在 LLM Agent 或 Code Mode 流水线中，模型经常需要确认一个 npm 或 PyPI 包的版本、许可证、依赖清单等元数据，但直接调用各 registry 的 HTTP 接口往往面临字段命名不统一、异常分支散落、返回结构因 registry 而异等问题，下游解析逻辑难以统一维护。dsh-pkg-info 将这件事收敛为一次 pkg_info 工具调用：传入 registry、包名和可选版本号，即可拿到一份字段名与类型完全确定的结构化 JSON，让下游无需再猜测或做防御性校验。

插件的核心设计是确定性：成功时返回 ok 为 true 并附带规范化的描述、许可证、作者、主页、仓库、版本数、依赖等字段；任何失败——404、网络超时、JSON 解析异常——都被折叠为 ok 为 false 并携带 stage 与 message，绝不让异常逃出工具边界。整体零运行时依赖、纯 ESM、无需构建步骤，引入成本极低。

适合正在搭建 Agent 工作流、需要在 Code Mode 中程序化查询包信息的开发者，也适合作为 RAG 或代码生成管线中的轻量级元数据探针，以最低集成成本为模型提供结构化的包上下文。