@zhaofx/deplens 1.0.0

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@zhaofx/deplens",
+  "version": "1.0.0",
+  "description": "专业级项目依赖镜像空间与环境溯源工具",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "depLens": "bin/index.js"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "template.html"
+  ],
+  "engines": {
+    "node": ">=18.0.0",
+    "pnpm": ">=8.0.0"
+  },
+  "dependencies": {
+    "@babel/parser": "^7.23.6",
+    "@babel/traverse": "^7.23.6",
+    "fs-extra": "^11.1.0",
+    "glob": "^10.3.10",
+    "inquirer": "^13.3.2",
+    "open": "^9.1.0",
+    "polka": "^0.5.2",
+    "sirv": "^2.0.3",
+    "yaml": "^2.3.1"
+  },
+  "scripts": {
+    "record": "node ./bin/env-recorder.js",
+    "dev": "node ./bin/index.js --dev",
+    "lint": "eslint . --ext .js,.jsx,.ts,.tsx"
+  },
+  "keywords": [],
+  "author": "dafei",
+  "license": "ISC",
+  "packageManager": "pnpm@10.30.3"
+}

package/readme.md

@@ -0,0 +1,92 @@
+DepLens 🔍
+English | 中文说明
+
+English
+
+DepLens is a high-performance dependency analyzer and environment tracing tool, specifically optimized for `pnpm` projects. It combines AST source code scanning with Hierarchical Treemap visualizations to reveal "ancestor-to-grandchild" relationships while ensuring team-wide development environment consistency.
+
+### ✨ Key Features
+
+- **Hierarchical Treemap**: A nested "box-in-box" visualization that mimics the actual dependency tree, making it easy to spot heavy sub-dependencies.
+- **Ghost Dependency Detection**: Powered by `@babel/parser`. It scans your `src/` directory to find packages you import but forgot to declare in `package.json`.
+- **Environment Tracing (New)**: Automatically records Node.js/npm versions, package manager types, and registry mirrors to prevent "It works on my machine" errors.
+- **Privacy First**: 100% local execution. No dependency data or source code snippets are ever uploaded to any server.
+- **Enhanced UI**: Redesigned sidebar with a close button and a header display for real-time environment version tracking.
+
+### 🚀 Quick Start
+
+Install:
+
+```bash
+npm install -g depLens
+
+Usage: Navigate to your project root (ensure `pnpm-lock.yaml` exists) and use the unified command:
+
+Start Visualization:
+
+```bash
+depLens -view
+```
+
+Opens a local web server to explore the dependency map.
+
+Record Environment:
+
+```bash
+depLens -track
+```
+
+Snapshots your current Node.js, npm, and registry settings into `.deplens.history.json`.
+
+Team Integration (Best Practice): Add this to your Git pre-commit hook (e.g., via Husky) to ensure every commit includes the environment state:
+
+```bash
+depLens -track && git add .deplens.history.json
+```
+
+---
+
+## 中文说明
+
+DepLens 是一款专为 pnpm 项目打造的高性能、隐私优先的依赖分析与环境溯源工具。  
+它通过 **AST 源码扫描** 与 **嵌套层级树（Hierarchical Treemap）** 可视化，直观呈现依赖的“祖孙”嵌套关系，并精准识别“幽灵依赖”，同时解决团队成员因开发环境不一致导致的构建失败问题。
+
+### ✨ 核心特性
+
+- **嵌套层级视图**: 采用“大盒套小盒”布局，完整复现依赖树结构，一眼看清冗余子包。
+- **幽灵依赖检测**: 深度扫描 `src/` 目录，揪出已引用但未在 `package.json` 中声明的依赖。
+- **环境溯源 (新)**: 自动记录 Node.js/npm 版本、包管理器类型及 Registry 镜像地址，为排查环境问题提供精准快照。
+- **可视化增强**: 侧边栏新增关闭按钮； Header 头部实时显示当前 Node/npm 版本，支持导入快照进行版本对比。
+- **隐私至上**: 100% 本地分析。所有数据均在本地完成，绝不上传至任何服务器。
+
+### 🚀 快速上手
+
+安装:
+
+```bash
+npm install -g depLens
+```
+
+核心命令: 在项目根目录（包含 `pnpm-lock.yaml`）下执行：
+
+启动可视化面板:
+
+```bash
+depLens -view
+```
+
+在浏览器打开交互式地图，支持下钻查看与环境校验。
+
+记录环境快照:
+
+```bash
+depLens -track
+```
+
+生成 `.deplens.history.json`，记录当前 Node、npm 版本及镜像源等核心参数。
+
+团队集成 (推荐): 配合 Husky 集成到 Git Hooks 中，在提交代码前自动同步环境信息，实现环境问题的“事后追溯”：
+
+```bash
+depLens -track && git add .deplens.history.json
+```