快速开始
简介
DepSpy 意为依赖间谍 [ Dependence Spy ],具有能够按照任意深度 [ Depth ] 潜入分析和监视其他 npm 依赖的能力,并提供状态同步的各类可视化交互页面。
特点
- 利用树 + 剪枝代替有向图,支持任意展开、折叠节点,结构更加清晰,规避了有向图错乱复杂的箭头指向。
- 提供多种展示方式,包括可折叠树、体积块状图、抽屉嵌套列表等。
- 支持分析相同依赖和循环依赖,支持搜索子依赖、查看依赖信息和体积等。
- 利用
ws服务器,实时操作depth深度,并实现分析包size的懒加载。 - 支持本地
CLI和在线查询两种模式。 - 监听依赖,实现依赖实时更新。
- 支持国际化和暗黑模式。
快速开始
本地 CLI
将 DepSpy 安装到项目,使用 PNPM:
bash
$ pnpm add @dep-spy/cli -D$ pnpm add @dep-spy/cli -D之后你可以在 npm 脚本添加使用 ds 或者 depspy 脚本,以下是推荐配置脚本:
js
{
"scripts": {
"ds": "ds"
// 或者 "ds": "depspy"
}
}{
"scripts": {
"ds": "ds"
// 或者 "ds": "depspy"
}
}如果想根据默认配置直接生成依赖分析 JSON 文件,直接在命令行中运行:
bash
$ pnpm run ds$ pnpm run ds如果需要届时开启 UI 页面,请格外传入 --ui 参数(对于更多配置参数,或使用配置文件进行配置,请查看配置):
bash
$ pnpm run ds --ui$ pnpm run ds --ui接着你能通过 http://localhost:2023/analyze 访问 DepSpy UI 页面:

推荐使用上述方法,但也支持使用 npx @dep-spy/cli 来直接运行 DepSpy。