@iyowei/sweep-node-modules 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +61 -23
- package/bin/sweep-nm.mjs +3 -1
- package/dist/cli.js +230 -147
- package/package.json +2 -1
package/README.md
CHANGED
|
@@ -6,29 +6,72 @@
|
|
|
6
6
|
|
|
7
7
|
## 要求
|
|
8
8
|
|
|
9
|
-
-
|
|
10
|
-
- 取最新一代运行时 API: bun 任意近期版本; node 需原生支持 TypeScript 直跑的版本 (版本快照与实测记录见 [ADR 0006](docs/adrs/0006-dual-runtime-bun-first.md))。
|
|
9
|
+
- 业务逻辑**双运行时**: 有 bun 走 bun, 否则 node (功能一致, bun 启动更快)。
|
|
10
|
+
- 取最新一代运行时 API: bun 任意近期版本; node 需原生支持 TypeScript 直跑的版本 (源码方式与包方式取同一版本下限; 版本快照与实测记录见 [ADR 0006](docs/adrs/0006-dual-runtime-bun-first.md))。
|
|
11
11
|
- 零第三方运行时依赖 (只用运行时内置能力)。
|
|
12
12
|
- 平台: Windows / macOS / Linux 三平台均可运行 (见 [ADR 0007](docs/adrs/0007-platform-portability.md))。
|
|
13
13
|
|
|
14
14
|
## 安装
|
|
15
15
|
|
|
16
|
-
|
|
16
|
+
三种方式, 按你机器上已有的运行时挑。**每条下的「需要」是硬门槛**:
|
|
17
|
+
|
|
18
|
+
> **机器上只有 bun、没装 node?** 直接走 ① 或 ③; ② 的全局安装 (npm 与 bun 皆然) 都需要 node。
|
|
19
|
+
|
|
20
|
+
### ① 免安装 (试用或偶尔用)
|
|
21
|
+
|
|
22
|
+
```shell
|
|
23
|
+
# 机器上有 bun
|
|
24
|
+
bunx @iyowei/sweep-node-modules
|
|
25
|
+
|
|
26
|
+
# 机器上有 node (npx 随 npm 一同安装, 本身就需要 node)
|
|
27
|
+
npx @iyowei/sweep-node-modules
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
- **需要**: bun 或 node, 与所选命令对应
|
|
31
|
+
- 特点: 零安装; 每次运行会解析一次包
|
|
32
|
+
- 注意: `bunx` 与 `npx` 各自依附一个运行时, 不是可互换的通用选项: 只有 bun 的机器没有 `npx`, 只有 node 的机器没有 `bunx`
|
|
33
|
+
|
|
34
|
+
### ② 包管理器全局安装 (常用推荐)
|
|
17
35
|
|
|
18
36
|
```shell
|
|
19
37
|
npm install -g @iyowei/sweep-node-modules
|
|
38
|
+
bun install -g @iyowei/sweep-node-modules
|
|
20
39
|
```
|
|
21
40
|
|
|
22
|
-
|
|
41
|
+
- **需要**: **node** (两条命令都要)。npm 本身跑在 node 上; `bun install -g` 生成的是指向入口文件的符号链接, 执行时由系统内核读该文件的 shebang (node) 来决定解释器, 应用层插不上手
|
|
42
|
+
- 特点: 装一次后直接敲 `sweep-nm`; 有 bun 时业务逻辑仍优先走 bun
|
|
43
|
+
|
|
44
|
+
### ③ 从源码 (开发, 或无 node 环境)
|
|
45
|
+
|
|
46
|
+
**macOS / Linux**:
|
|
23
47
|
|
|
24
48
|
```shell
|
|
49
|
+
# 克隆后进入仓库根 (路径按你的实际位置调整)
|
|
50
|
+
cd "<克隆位置>/sweep-node-modules"
|
|
51
|
+
|
|
25
52
|
chmod +x bin/sweep-nm
|
|
26
53
|
|
|
27
|
-
# 软链进 ~/.local/bin
|
|
28
|
-
ln -sf "$
|
|
54
|
+
# 软链进 ~/.local/bin (通常已在 PATH 中), 启动器会挑选运行时
|
|
55
|
+
ln -sf "$PWD/bin/sweep-nm" ~/.local/bin/sweep-nm
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
**Windows** (PowerShell):
|
|
59
|
+
|
|
60
|
+
```powershell
|
|
61
|
+
# 把仓库的 bin 目录加入用户 PATH, 只需一次, 重开终端后生效
|
|
62
|
+
# 路径按你的实际克隆位置调整 (启动器靠自身位置定位 src, 故不能把脚本单独复制走)
|
|
63
|
+
$bin = "$env:USERPROFILE\tools\sweep-node-modules\bin"
|
|
64
|
+
[Environment]::SetEnvironmentVariable(
|
|
65
|
+
'Path',
|
|
66
|
+
[Environment]::GetEnvironmentVariable('Path', 'User') + ";$bin",
|
|
67
|
+
'User'
|
|
68
|
+
)
|
|
29
69
|
```
|
|
30
70
|
|
|
31
|
-
>
|
|
71
|
+
> 也可以不经命令行: 在「系统属性 → 环境变量」里把该 `bin` 目录加到用户变量 `Path` 中。
|
|
72
|
+
|
|
73
|
+
- **需要**: bun 或 node 任一 (启动器是 shell / cmd 脚本, 由系统执行, 不依赖 node)
|
|
74
|
+
- 特点: 入口最直接; 之后直接敲 `sweep-nm` (Windows 经 `bin\sweep-nm.cmd`)
|
|
32
75
|
|
|
33
76
|
## 使用
|
|
34
77
|
|
|
@@ -42,10 +85,15 @@ sweep-nm --yes
|
|
|
42
85
|
# 临时追加排除(可重复)
|
|
43
86
|
sweep-nm --exclude my-kits --exclude url-tool
|
|
44
87
|
|
|
88
|
+
# 只清理名单命中的目录(可重复, 与配置合并)
|
|
89
|
+
sweep-nm --include my-kits
|
|
90
|
+
|
|
45
91
|
# 初始化向导: 交互式生成配置文件
|
|
46
92
|
sweep-nm init
|
|
47
93
|
```
|
|
48
94
|
|
|
95
|
+
清单顶栏尾部会标注本次实际使用的运行时 (如 `bun 1.4.2`), 仅交互终端显示 (非 TTY 不增噪音)。
|
|
96
|
+
|
|
49
97
|
## 配置
|
|
50
98
|
|
|
51
99
|
配置文件位置 (平台自适应): Windows 为 `%APPDATA%\sweep-node-modules\config.json`, 其余为 `~/.config/sweep-node-modules/config.json`; 可用 `--config` 或环境变量 `SWEEP_NM_CONFIG` 覆盖。
|
|
@@ -56,32 +104,22 @@ sweep-nm init
|
|
|
56
104
|
"/Users/iyowei/workspace/development",
|
|
57
105
|
"/Users/iyowei/self/development"
|
|
58
106
|
],
|
|
59
|
-
"exclude": ["my-kits"]
|
|
107
|
+
"exclude": ["my-kits"],
|
|
108
|
+
"include": []
|
|
60
109
|
}
|
|
61
110
|
```
|
|
62
111
|
|
|
63
112
|
- `roots`: 扫描根目录, 任意多个; 重复或嵌套的根按真实路径去重。
|
|
64
113
|
- `exclude`: 排除名单; 从根到 `node_modules` 的任意一级目录名命中即跳过 (多排除 = 少删, 安全方向)。
|
|
65
|
-
-
|
|
114
|
+
- `include`: 包含名单 (白名单); 命中才纳入, 口径与 `exclude` 同款; 缺省或空数组 = 不过滤 (多包含 = 多删); 与 `exclude` 同时命中时 `exclude` 优先。写错名字会让结果直接为空, 故未命中的名字会在 stderr 警示。
|
|
115
|
+
- 两份名单里的 `node_modules` 与 `.git` 一律被剔除: 前者是本工具的目标 (列入排除等于排掉唯一目标, 列入包含则永久零命中), 后者是扫描恒定跳过的目录; 剔除后 `include` 为空数组 = 不过滤 (不是「只扫 node_modules」)。
|
|
116
|
+
- 首次运行且无配置: 交互终端下自动进入初始化向导 (扫描根默认家目录); 非交互环境 (脚本等) 以当前工作目录为根并提示, 不询问; 随时可用 `sweep-nm init` 重进向导。
|
|
66
117
|
|
|
67
118
|
> 字段定义以[设计文档](docs/designs/config-and-initialization.md)为准。
|
|
68
119
|
|
|
69
120
|
## 开发
|
|
70
121
|
|
|
71
|
-
|
|
72
|
-
bun install # 安装 devDependencies, 并自动装好 git 钩子 (lefthook)
|
|
73
|
-
|
|
74
|
-
bun run typecheck # tsc --noEmit
|
|
75
|
-
bun run lint # oxlint
|
|
76
|
-
bun run format # prettier --write
|
|
77
|
-
bun test # bun test (243 条: 契约 / 鲁棒 / 压测 / 双载体 e2e / 伪终端冒烟)
|
|
78
|
-
bun run bench # 基准四组 (扫描 / 体积 / 真实工作区 / 压测)
|
|
79
|
-
bun run conformance -- --target "bun src/cli.ts" # 转写一致性验收 (40 条金样本, 见 docs/protocol/)
|
|
80
|
-
```
|
|
81
|
-
|
|
82
|
-
运行时双跑验证: `bun src/cli.ts` 与 `node src/cli.ts` 均可直接运行。
|
|
83
|
-
|
|
84
|
-
提交与推送由 lefthook 把关: pre-commit 增量 (prettier 重暂存 + oxlint + 全量类型检查), pre-push 全量只读 (typecheck / test / oxlint / prettier `--check`)。
|
|
122
|
+
环境准备、常用命令、双运行时验证与提交钩子, 见 [开发指南](docs/development.md)。
|
|
85
123
|
|
|
86
124
|
## 文档
|
|
87
125
|
|
package/bin/sweep-nm.mjs
CHANGED
|
@@ -1,7 +1,9 @@
|
|
|
1
1
|
#!/usr/bin/env node
|
|
2
2
|
/**
|
|
3
3
|
* npm 安装场景的启动器: 挑选运行时 (Bun 优先, 其次 Node) 后启动真实入口。
|
|
4
|
-
* 与 bin/sweep-nm (sh) / bin/sweep-nm.cmd (cmd)
|
|
4
|
+
* 与 bin/sweep-nm (sh) / bin/sweep-nm.cmd (cmd) 职责同逻辑 (挑选运行时: Bun 优先, Node 回退),
|
|
5
|
+
* 差异在宿主与本文件多加的入口选择 (优先跑编译产物 dist/cli.js, 无产物则回退源码 src/cli.ts;
|
|
6
|
+
* 包内只有产物, 开发态通常无产物):
|
|
5
7
|
* 本文件同时承担 Unix 与 Windows 的 npm shim 目标 (shebang 必须是 node, 否则
|
|
6
8
|
* npm 的 cmd-shim 会按 shebang 解释器生成 Windows 上不存在的调用)。
|
|
7
9
|
* 退出码原样透传; 两个运行时都缺席时给出可操作提示并非零退出。
|
package/dist/cli.js
CHANGED
|
@@ -60,7 +60,10 @@ function shapeError(value) {
|
|
|
60
60
|
const rootsError = fieldError(candidate, "roots", false);
|
|
61
61
|
if (rootsError !== null)
|
|
62
62
|
return rootsError;
|
|
63
|
-
|
|
63
|
+
const excludeError = fieldError(candidate, "exclude", true);
|
|
64
|
+
if (excludeError !== null)
|
|
65
|
+
return excludeError;
|
|
66
|
+
return fieldError(candidate, "include", true);
|
|
64
67
|
}
|
|
65
68
|
async function loadConfig(path) {
|
|
66
69
|
let text;
|
|
@@ -84,7 +87,11 @@ async function loadConfig(path) {
|
|
|
84
87
|
const raw = data;
|
|
85
88
|
return {
|
|
86
89
|
state: "ok",
|
|
87
|
-
config: {
|
|
90
|
+
config: {
|
|
91
|
+
roots: raw.roots,
|
|
92
|
+
exclude: raw.exclude ?? [],
|
|
93
|
+
include: raw.include ?? []
|
|
94
|
+
}
|
|
88
95
|
};
|
|
89
96
|
}
|
|
90
97
|
async function loadResolvedConfig(resolved) {
|
|
@@ -94,8 +101,8 @@ async function loadResolvedConfig(resolved) {
|
|
|
94
101
|
}
|
|
95
102
|
return result;
|
|
96
103
|
}
|
|
97
|
-
function
|
|
98
|
-
return [...new Set([...
|
|
104
|
+
function mergeNames(configNames, cliNames) {
|
|
105
|
+
return [...new Set([...configNames, ...cliNames])].filter((name) => name !== "node_modules" && name !== ".git");
|
|
99
106
|
}
|
|
100
107
|
|
|
101
108
|
// src/delete.ts
|
|
@@ -308,6 +315,128 @@ async function validateTargets(targets, options) {
|
|
|
308
315
|
import { homedir as homedir3 } from "node:os";
|
|
309
316
|
import { join as join2 } from "node:path";
|
|
310
317
|
import { createInterface } from "node:readline/promises";
|
|
318
|
+
|
|
319
|
+
// src/render.ts
|
|
320
|
+
var BANNER = "SWEEP-NM";
|
|
321
|
+
var BAR_BLOCK = "▍";
|
|
322
|
+
var TOTAL_BLOCK = "█";
|
|
323
|
+
var NEUTRAL_BLOCK = "░";
|
|
324
|
+
var PLATFORM_STYLE = nativeStyle();
|
|
325
|
+
var NEUTRAL_TIER = { block: NEUTRAL_BLOCK, sgr: "2" };
|
|
326
|
+
var ROOT_LIST_LIMIT = 3;
|
|
327
|
+
var TIER_BIG = 1024 ** 3;
|
|
328
|
+
var TIER_MID = 100 * 1024 ** 2;
|
|
329
|
+
function formatBytes(bytes) {
|
|
330
|
+
if (bytes < 1024)
|
|
331
|
+
return `${Math.round(bytes)} B`;
|
|
332
|
+
const units = ["KB", "MB", "GB", "TB"];
|
|
333
|
+
let value = bytes;
|
|
334
|
+
let index = -1;
|
|
335
|
+
do {
|
|
336
|
+
value /= 1024;
|
|
337
|
+
index += 1;
|
|
338
|
+
} while (value >= 1024 && index < units.length - 1);
|
|
339
|
+
return `${Math.round(value * 10) / 10} ${units[index]}`;
|
|
340
|
+
}
|
|
341
|
+
function render(options) {
|
|
342
|
+
const { mode, roots, entries, color, home, releasedBytes, pathStyle } = options;
|
|
343
|
+
const style = pathStyle ?? PLATFORM_STYLE;
|
|
344
|
+
const scope = roots.length > 0 && roots.length <= ROOT_LIST_LIMIT ? `${roots.length} 个根: ${roots.map((root) => oneLine(shortenPath(root, style, home))).join(" · ")}` : `${roots.length} 个根`;
|
|
345
|
+
const runtime = options.runtime ? ` · ${oneLine(options.runtime)}` : "";
|
|
346
|
+
const head = paint(`${BAR_BLOCK} ${BANNER} ${mode === "execute" ? "执行" : "预览"} · ${scope}${runtime}`, "1;7", color);
|
|
347
|
+
const notes = (options.notes ?? []).map((note) => ` ${paint(`${NEUTRAL_BLOCK} ${oneLine(note)}`, "2", color)}`);
|
|
348
|
+
if (entries.length === 0) {
|
|
349
|
+
return [
|
|
350
|
+
head,
|
|
351
|
+
...notes,
|
|
352
|
+
` ${paint(`${NEUTRAL_BLOCK} 未发现 node_modules`, "2", color)}`
|
|
353
|
+
].join(`
|
|
354
|
+
`);
|
|
355
|
+
}
|
|
356
|
+
const rows = [...entries].sort((a, b) => (b.bytes ?? -1) - (a.bytes ?? -1));
|
|
357
|
+
const volumeWidth = Math.max(...rows.map((row) => displayWidth(volumeOf(row))));
|
|
358
|
+
const nameWidth = Math.max(...rows.map((row) => displayWidth(oneLine(row.project))));
|
|
359
|
+
const body = rows.map((row) => {
|
|
360
|
+
const fail = mode === "execute" && row.ok === false;
|
|
361
|
+
const tier = row.bytes === undefined ? NEUTRAL_TIER : tierOf(row.bytes);
|
|
362
|
+
const mark = mode === "execute" ? paint(fail ? "✗" : "✓", fail ? "31" : "32", color) : paint(tier.block, tier.sgr, color);
|
|
363
|
+
const volume = padStart(volumeOf(row), volumeWidth);
|
|
364
|
+
const name = oneLine(row.project);
|
|
365
|
+
const rawPath = displayPath(row.target, style, home);
|
|
366
|
+
const path = oneLine(rawPath);
|
|
367
|
+
const rewritten = name !== row.project || path !== rawPath;
|
|
368
|
+
const tail = tailsOf(row, fail, rewritten);
|
|
369
|
+
const shown = `${paint(padEnd(name, nameWidth), "1", color)} ${paint(path, "2", color)}`;
|
|
370
|
+
return ` ${mark} ${volume} ${shown}${tail ? ` ${paint(tail, "2", color)}` : ""}`;
|
|
371
|
+
});
|
|
372
|
+
const hint = [
|
|
373
|
+
paint("加", "2", color),
|
|
374
|
+
paint("--yes", "1", color),
|
|
375
|
+
paint("执行删除", "2", color)
|
|
376
|
+
].join(" ");
|
|
377
|
+
const foot = mode === "execute" ? footExecute(rows, color, releasedBytes) : ` ${paint(TOTAL_BLOCK, "7", color)} ${paint(`合计 ${rows.length} 处 · ${formatBytes(sum(rows))}`, "1", color)} ${hint}`;
|
|
378
|
+
return [head, ...notes, ...body, foot].join(`
|
|
379
|
+
`);
|
|
380
|
+
}
|
|
381
|
+
function footExecute(rows, color, releasedBytes) {
|
|
382
|
+
const failed = rows.filter((row) => row.ok === false).length;
|
|
383
|
+
const released = releasedBytes === undefined ? "" : ` · 释放 ${formatBytes(releasedBytes)}`;
|
|
384
|
+
return ` ${paint(TOTAL_BLOCK, "7", color)} ${paint(`汇总 成功 ${rows.length - failed} 处${released} · 失败 ${failed} 处`, "1", color)}`;
|
|
385
|
+
}
|
|
386
|
+
var volumeOf = (row) => row.bytes === undefined ? "?" : formatBytes(row.bytes);
|
|
387
|
+
var SANITIZED_NOTE = "名字已净化显示";
|
|
388
|
+
function tailsOf(row, fail, rewritten) {
|
|
389
|
+
const parts = [];
|
|
390
|
+
if (rewritten)
|
|
391
|
+
parts.push(SANITIZED_NOTE);
|
|
392
|
+
if (row.note)
|
|
393
|
+
parts.push(oneLine(row.note));
|
|
394
|
+
if (fail && row.error)
|
|
395
|
+
parts.push(oneLine(row.error));
|
|
396
|
+
return parts.join(" ");
|
|
397
|
+
}
|
|
398
|
+
function tierOf(bytes) {
|
|
399
|
+
if (bytes >= TIER_BIG)
|
|
400
|
+
return { block: "█", sgr: "31" };
|
|
401
|
+
if (bytes >= TIER_MID)
|
|
402
|
+
return { block: "▓", sgr: "33" };
|
|
403
|
+
return { block: "▒", sgr: "36" };
|
|
404
|
+
}
|
|
405
|
+
var paint = (text, sgr, color) => color ? `\x1B[${sgr}m${text}\x1B[0m` : text;
|
|
406
|
+
var sum = (rows) => rows.reduce((total, row) => total + (row.bytes ?? 0), 0);
|
|
407
|
+
var fold2 = (text, style) => style.caseInsensitive ? text.toLowerCase() : text;
|
|
408
|
+
function shortenPath(path, style, home) {
|
|
409
|
+
if (!home)
|
|
410
|
+
return path;
|
|
411
|
+
if (fold2(path, style) === fold2(home, style))
|
|
412
|
+
return "~";
|
|
413
|
+
const prefix = `${home}${style.ops.sep}`;
|
|
414
|
+
return fold2(path, style).startsWith(fold2(prefix, style)) ? `~${path.slice(home.length)}` : path;
|
|
415
|
+
}
|
|
416
|
+
function shortenHome(path, home) {
|
|
417
|
+
return shortenPath(path, PLATFORM_STYLE, home);
|
|
418
|
+
}
|
|
419
|
+
function displayPath(target, style, home) {
|
|
420
|
+
const suffix = `${style.ops.sep}node_modules`;
|
|
421
|
+
const dir = fold2(target, style).endsWith(fold2(suffix, style)) ? target.slice(0, -suffix.length) : target;
|
|
422
|
+
return shortenPath(dir, style, home);
|
|
423
|
+
}
|
|
424
|
+
var oneLine = (text) => text.replace(/[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u200b-\u200f\u202a-\u202e\u2066-\u2069\ufeff]/g, "").replace(/\s+/g, " ").trim();
|
|
425
|
+
var padEnd = (text, width) => text + " ".repeat(Math.max(0, width - displayWidth(text)));
|
|
426
|
+
var padStart = (text, width) => " ".repeat(Math.max(0, width - displayWidth(text))) + text;
|
|
427
|
+
function displayWidth(text) {
|
|
428
|
+
let width = 0;
|
|
429
|
+
for (const char of text) {
|
|
430
|
+
const code = char.codePointAt(0) ?? 0;
|
|
431
|
+
width += isFullWidth(code) ? 2 : 1;
|
|
432
|
+
}
|
|
433
|
+
return width;
|
|
434
|
+
}
|
|
435
|
+
function isFullWidth(code) {
|
|
436
|
+
return code >= 4352 && code <= 4447 || code >= 11904 && code <= 42191 || code >= 44032 && code <= 55203 || code >= 63744 && code <= 64255 || code >= 65072 && code <= 65135 || code >= 65280 && code <= 65376 || code >= 65504 && code <= 65510;
|
|
437
|
+
}
|
|
438
|
+
|
|
439
|
+
// src/init.ts
|
|
311
440
|
var WHITESPACE = /\s/;
|
|
312
441
|
function expandHome(token) {
|
|
313
442
|
if (token === "~")
|
|
@@ -368,13 +497,13 @@ async function runInit(deps) {
|
|
|
368
497
|
return { state: "declined-overwrite" };
|
|
369
498
|
}
|
|
370
499
|
io.print("首次使用, 先确定扫描范围");
|
|
371
|
-
const
|
|
500
|
+
const home = homedir3();
|
|
372
501
|
let roots = [];
|
|
373
502
|
for (;; ) {
|
|
374
|
-
const rootsAnswer = await io.ask("扫描根 (逗号或空白分隔多个)", `默认: ${
|
|
503
|
+
const rootsAnswer = await io.ask("扫描根 (逗号或空白分隔多个)", `默认: ${home}`);
|
|
375
504
|
if (rootsAnswer === null)
|
|
376
505
|
return cancelled();
|
|
377
|
-
roots = parseList(rootsAnswer, [
|
|
506
|
+
roots = parseList(rootsAnswer, [home]);
|
|
378
507
|
const missing = [];
|
|
379
508
|
for (const root of roots) {
|
|
380
509
|
if (!await fileExists(root))
|
|
@@ -392,10 +521,14 @@ async function runInit(deps) {
|
|
|
392
521
|
io.print(`将写入 roots: ${JSON.stringify(roots)} · exclude: ${JSON.stringify(exclude)}`);
|
|
393
522
|
if (!await io.confirm("确认写入?", true))
|
|
394
523
|
return cancelled();
|
|
395
|
-
const config = { roots, exclude };
|
|
396
|
-
|
|
397
|
-
|
|
398
|
-
|
|
524
|
+
const config = { roots, exclude, include: [] };
|
|
525
|
+
const text = `${JSON.stringify(config, null, 2)}
|
|
526
|
+
`;
|
|
527
|
+
await writeFile(configPath, text);
|
|
528
|
+
io.print(`配置已写入: ${shortenHome(configPath, homedir3())}`);
|
|
529
|
+
io.print("");
|
|
530
|
+
io.print(text.trimEnd());
|
|
531
|
+
io.print("");
|
|
399
532
|
return { state: "written", config };
|
|
400
533
|
}
|
|
401
534
|
function setStdinRef(shouldRef) {
|
|
@@ -474,123 +607,12 @@ function createReadlineIO() {
|
|
|
474
607
|
};
|
|
475
608
|
}
|
|
476
609
|
|
|
477
|
-
// src/render.ts
|
|
478
|
-
var BANNER = "SWEEP-NM";
|
|
479
|
-
var BAR_BLOCK = "▍";
|
|
480
|
-
var TOTAL_BLOCK = "█";
|
|
481
|
-
var NEUTRAL_BLOCK = "░";
|
|
482
|
-
var PLATFORM_STYLE = nativeStyle();
|
|
483
|
-
var NEUTRAL_TIER = { block: NEUTRAL_BLOCK, sgr: "2" };
|
|
484
|
-
var ROOT_LIST_LIMIT = 3;
|
|
485
|
-
var TIER_BIG = 1024 ** 3;
|
|
486
|
-
var TIER_MID = 100 * 1024 ** 2;
|
|
487
|
-
function formatBytes(bytes) {
|
|
488
|
-
if (bytes < 1024)
|
|
489
|
-
return `${Math.round(bytes)} B`;
|
|
490
|
-
const units = ["KB", "MB", "GB", "TB"];
|
|
491
|
-
let value = bytes;
|
|
492
|
-
let index = -1;
|
|
493
|
-
do {
|
|
494
|
-
value /= 1024;
|
|
495
|
-
index += 1;
|
|
496
|
-
} while (value >= 1024 && index < units.length - 1);
|
|
497
|
-
return `${Math.round(value * 10) / 10} ${units[index]}`;
|
|
498
|
-
}
|
|
499
|
-
function render(options) {
|
|
500
|
-
const { mode, roots, entries, color, home, releasedBytes, pathStyle } = options;
|
|
501
|
-
const style = pathStyle ?? PLATFORM_STYLE;
|
|
502
|
-
const scope = roots.length > 0 && roots.length <= ROOT_LIST_LIMIT ? `${roots.length} 个根: ${roots.map((root) => oneLine(shortenPath(root, style, home))).join(" · ")}` : `${roots.length} 个根`;
|
|
503
|
-
const head = paint(`${BAR_BLOCK} ${BANNER} ${mode === "execute" ? "执行" : "预览"} · ${scope}`, "1;7", color);
|
|
504
|
-
if (entries.length === 0) {
|
|
505
|
-
return [
|
|
506
|
-
head,
|
|
507
|
-
` ${paint(`${NEUTRAL_BLOCK} 未发现 node_modules`, "2", color)}`
|
|
508
|
-
].join(`
|
|
509
|
-
`);
|
|
510
|
-
}
|
|
511
|
-
const rows = [...entries].sort((a, b) => (b.bytes ?? -1) - (a.bytes ?? -1));
|
|
512
|
-
const volumeWidth = Math.max(...rows.map((row) => displayWidth(volumeOf(row))));
|
|
513
|
-
const nameWidth = Math.max(...rows.map((row) => displayWidth(oneLine(row.project))));
|
|
514
|
-
const body = rows.map((row) => {
|
|
515
|
-
const fail = mode === "execute" && row.ok === false;
|
|
516
|
-
const tier = row.bytes === undefined ? NEUTRAL_TIER : tierOf(row.bytes);
|
|
517
|
-
const mark = mode === "execute" ? paint(fail ? "✗" : "✓", fail ? "31" : "32", color) : paint(tier.block, tier.sgr, color);
|
|
518
|
-
const volume = padStart(volumeOf(row), volumeWidth);
|
|
519
|
-
const name = oneLine(row.project);
|
|
520
|
-
const rawPath = displayPath(row.target, style, home);
|
|
521
|
-
const path = oneLine(rawPath);
|
|
522
|
-
const rewritten = name !== row.project || path !== rawPath;
|
|
523
|
-
const tail = tailsOf(row, fail, rewritten);
|
|
524
|
-
const shown = `${paint(padEnd(name, nameWidth), "1", color)} ${paint(path, "2", color)}`;
|
|
525
|
-
return ` ${mark} ${volume} ${shown}${tail ? ` ${paint(tail, "2", color)}` : ""}`;
|
|
526
|
-
});
|
|
527
|
-
const hint = [
|
|
528
|
-
paint("加", "2", color),
|
|
529
|
-
paint("--yes", "1", color),
|
|
530
|
-
paint("执行删除", "2", color)
|
|
531
|
-
].join(" ");
|
|
532
|
-
const foot = mode === "execute" ? footExecute(rows, color, releasedBytes) : ` ${paint(TOTAL_BLOCK, "7", color)} ${paint(`合计 ${rows.length} 处 · ${formatBytes(sum(rows))}`, "1", color)} ${hint}`;
|
|
533
|
-
return [head, ...body, foot].join(`
|
|
534
|
-
`);
|
|
535
|
-
}
|
|
536
|
-
function footExecute(rows, color, releasedBytes) {
|
|
537
|
-
const failed = rows.filter((row) => row.ok === false).length;
|
|
538
|
-
const released = releasedBytes === undefined ? "" : ` · 释放 ${formatBytes(releasedBytes)}`;
|
|
539
|
-
return ` ${paint(TOTAL_BLOCK, "7", color)} ${paint(`汇总 成功 ${rows.length - failed} 处${released} · 失败 ${failed} 处`, "1", color)}`;
|
|
540
|
-
}
|
|
541
|
-
var volumeOf = (row) => row.bytes === undefined ? "?" : formatBytes(row.bytes);
|
|
542
|
-
var SANITIZED_NOTE = "名字已净化显示";
|
|
543
|
-
function tailsOf(row, fail, rewritten) {
|
|
544
|
-
const parts = [];
|
|
545
|
-
if (rewritten)
|
|
546
|
-
parts.push(SANITIZED_NOTE);
|
|
547
|
-
if (row.note)
|
|
548
|
-
parts.push(oneLine(row.note));
|
|
549
|
-
if (fail && row.error)
|
|
550
|
-
parts.push(oneLine(row.error));
|
|
551
|
-
return parts.join(" ");
|
|
552
|
-
}
|
|
553
|
-
function tierOf(bytes) {
|
|
554
|
-
if (bytes >= TIER_BIG)
|
|
555
|
-
return { block: "█", sgr: "31" };
|
|
556
|
-
if (bytes >= TIER_MID)
|
|
557
|
-
return { block: "▓", sgr: "33" };
|
|
558
|
-
return { block: "▒", sgr: "36" };
|
|
559
|
-
}
|
|
560
|
-
var paint = (text, sgr, color) => color ? `\x1B[${sgr}m${text}\x1B[0m` : text;
|
|
561
|
-
var sum = (rows) => rows.reduce((total, row) => total + (row.bytes ?? 0), 0);
|
|
562
|
-
var fold2 = (text, style) => style.caseInsensitive ? text.toLowerCase() : text;
|
|
563
|
-
function shortenPath(path, style, home) {
|
|
564
|
-
if (!home)
|
|
565
|
-
return path;
|
|
566
|
-
if (fold2(path, style) === fold2(home, style))
|
|
567
|
-
return "~";
|
|
568
|
-
const prefix = `${home}${style.ops.sep}`;
|
|
569
|
-
return fold2(path, style).startsWith(fold2(prefix, style)) ? `~${path.slice(home.length)}` : path;
|
|
570
|
-
}
|
|
571
|
-
function displayPath(target, style, home) {
|
|
572
|
-
const suffix = `${style.ops.sep}node_modules`;
|
|
573
|
-
const dir = fold2(target, style).endsWith(fold2(suffix, style)) ? target.slice(0, -suffix.length) : target;
|
|
574
|
-
return shortenPath(dir, style, home);
|
|
575
|
-
}
|
|
576
|
-
var oneLine = (text) => text.replace(/[\u0000-\u0008\u000b-\u001f\u007f-\u009f\u200b-\u200f\u202a-\u202e\u2066-\u2069\ufeff]/g, "").replace(/\s+/g, " ").trim();
|
|
577
|
-
var padEnd = (text, width) => text + " ".repeat(Math.max(0, width - displayWidth(text)));
|
|
578
|
-
var padStart = (text, width) => " ".repeat(Math.max(0, width - displayWidth(text))) + text;
|
|
579
|
-
function displayWidth(text) {
|
|
580
|
-
let width = 0;
|
|
581
|
-
for (const char of text) {
|
|
582
|
-
const code = char.codePointAt(0) ?? 0;
|
|
583
|
-
width += isFullWidth(code) ? 2 : 1;
|
|
584
|
-
}
|
|
585
|
-
return width;
|
|
586
|
-
}
|
|
587
|
-
function isFullWidth(code) {
|
|
588
|
-
return code >= 4352 && code <= 4447 || code >= 11904 && code <= 42191 || code >= 44032 && code <= 55203 || code >= 63744 && code <= 64255 || code >= 65072 && code <= 65135 || code >= 65280 && code <= 65376 || code >= 65504 && code <= 65510;
|
|
589
|
-
}
|
|
590
|
-
|
|
591
610
|
// src/runtime.ts
|
|
592
611
|
import { readFile as readFile2, writeFile } from "node:fs/promises";
|
|
593
612
|
var isBun = typeof Bun !== "undefined";
|
|
613
|
+
var versions = process.versions;
|
|
614
|
+
var runtimeName = isBun ? "bun" : "node";
|
|
615
|
+
var runtimeLabel = `${runtimeName} ${versions[runtimeName] ?? "unknown"}`;
|
|
594
616
|
async function writeTextFile(path, text) {
|
|
595
617
|
if (isBun) {
|
|
596
618
|
await Bun.write(path, text);
|
|
@@ -626,8 +648,17 @@ function describeRootFailure(error) {
|
|
|
626
648
|
return `根不可用 (${code ?? "UNKNOWN"})`;
|
|
627
649
|
}
|
|
628
650
|
}
|
|
629
|
-
async function walkRoot(root,
|
|
630
|
-
const
|
|
651
|
+
async function walkRoot(root, ctx) {
|
|
652
|
+
const {
|
|
653
|
+
style,
|
|
654
|
+
exclude,
|
|
655
|
+
excludeCounts,
|
|
656
|
+
include,
|
|
657
|
+
includeCounts,
|
|
658
|
+
hits,
|
|
659
|
+
warnings
|
|
660
|
+
} = ctx;
|
|
661
|
+
const stack = [{ dir: root, included: include.size === 0 }];
|
|
631
662
|
let outstanding = 1;
|
|
632
663
|
let active = 0;
|
|
633
664
|
const failures = [];
|
|
@@ -637,9 +668,9 @@ async function walkRoot(root, style, exclude, excludeCounts, hits, warnings) {
|
|
|
637
668
|
});
|
|
638
669
|
function pump() {
|
|
639
670
|
while (active < CONCURRENCY && stack.length > 0) {
|
|
640
|
-
const
|
|
671
|
+
const next = stack.pop();
|
|
641
672
|
active += 1;
|
|
642
|
-
visit(dir);
|
|
673
|
+
visit(next.dir, next.included);
|
|
643
674
|
}
|
|
644
675
|
if (outstanding === 0 && resolveDrained !== null) {
|
|
645
676
|
const resolve = resolveDrained;
|
|
@@ -647,7 +678,7 @@ async function walkRoot(root, style, exclude, excludeCounts, hits, warnings) {
|
|
|
647
678
|
resolve();
|
|
648
679
|
}
|
|
649
680
|
}
|
|
650
|
-
async function visit(dir) {
|
|
681
|
+
async function visit(dir, included) {
|
|
651
682
|
try {
|
|
652
683
|
let entries;
|
|
653
684
|
try {
|
|
@@ -661,6 +692,8 @@ async function walkRoot(root, style, exclude, excludeCounts, hits, warnings) {
|
|
|
661
692
|
continue;
|
|
662
693
|
const name = entry.name;
|
|
663
694
|
if (name === NODE_MODULES) {
|
|
695
|
+
if (!included)
|
|
696
|
+
continue;
|
|
664
697
|
const target = join3(dir, name);
|
|
665
698
|
const key = dedupeKey(await realpath2(target).catch(() => target), style);
|
|
666
699
|
if (!hits.has(key))
|
|
@@ -669,11 +702,15 @@ async function walkRoot(root, style, exclude, excludeCounts, hits, warnings) {
|
|
|
669
702
|
}
|
|
670
703
|
if (name === GIT_DIR)
|
|
671
704
|
continue;
|
|
705
|
+
const childIncluded = included || include.has(name);
|
|
706
|
+
if (!included && include.has(name)) {
|
|
707
|
+
includeCounts.set(name, (includeCounts.get(name) ?? 0) + 1);
|
|
708
|
+
}
|
|
672
709
|
if (exclude.has(name)) {
|
|
673
710
|
excludeCounts.set(name, (excludeCounts.get(name) ?? 0) + 1);
|
|
674
711
|
continue;
|
|
675
712
|
}
|
|
676
|
-
stack.push(join3(dir, name));
|
|
713
|
+
stack.push({ dir: join3(dir, name), included: childIncluded });
|
|
677
714
|
outstanding += 1;
|
|
678
715
|
}
|
|
679
716
|
} catch (error) {
|
|
@@ -701,6 +738,12 @@ function createParallelScanner() {
|
|
|
701
738
|
if (!excludeCounts.has(name))
|
|
702
739
|
excludeCounts.set(name, 0);
|
|
703
740
|
}
|
|
741
|
+
const include = new Set(options.include);
|
|
742
|
+
const includeCounts = new Map;
|
|
743
|
+
for (const name of options.include) {
|
|
744
|
+
if (!includeCounts.has(name))
|
|
745
|
+
includeCounts.set(name, 0);
|
|
746
|
+
}
|
|
704
747
|
const hitsByRealTarget = new Map;
|
|
705
748
|
const style = nativeStyle();
|
|
706
749
|
const seenRoots = new Set;
|
|
@@ -723,15 +766,28 @@ function createParallelScanner() {
|
|
|
723
766
|
seenRoots.add(key);
|
|
724
767
|
roots.push(root);
|
|
725
768
|
}
|
|
769
|
+
const context = {
|
|
770
|
+
style,
|
|
771
|
+
exclude,
|
|
772
|
+
excludeCounts,
|
|
773
|
+
include,
|
|
774
|
+
includeCounts,
|
|
775
|
+
hits: hitsByRealTarget,
|
|
776
|
+
warnings
|
|
777
|
+
};
|
|
726
778
|
for (const root of roots) {
|
|
727
|
-
await walkRoot(root,
|
|
779
|
+
await walkRoot(root, context);
|
|
728
780
|
}
|
|
729
781
|
const hits = [...hitsByRealTarget.values()].sort(compareTarget);
|
|
730
782
|
const excludeMatches = options.exclude.map((name) => ({
|
|
731
783
|
name,
|
|
732
784
|
hits: excludeCounts.get(name) ?? 0
|
|
733
785
|
}));
|
|
734
|
-
|
|
786
|
+
const includeMatches = options.include.map((name) => ({
|
|
787
|
+
name,
|
|
788
|
+
hits: includeCounts.get(name) ?? 0
|
|
789
|
+
}));
|
|
790
|
+
return { hits, warnings, excludeMatches, includeMatches };
|
|
735
791
|
}
|
|
736
792
|
};
|
|
737
793
|
}
|
|
@@ -973,6 +1029,7 @@ function parseArgs(argv) {
|
|
|
973
1029
|
command: "sweep",
|
|
974
1030
|
yes: false,
|
|
975
1031
|
exclude: [],
|
|
1032
|
+
include: [],
|
|
976
1033
|
help: false
|
|
977
1034
|
};
|
|
978
1035
|
const positionals = [];
|
|
@@ -988,13 +1045,15 @@ function parseArgs(argv) {
|
|
|
988
1045
|
options.help = true;
|
|
989
1046
|
continue;
|
|
990
1047
|
}
|
|
991
|
-
if (arg === "--exclude" || arg === "--config") {
|
|
1048
|
+
if (arg === "--exclude" || arg === "--include" || arg === "--config") {
|
|
992
1049
|
const value = argv[index + 1];
|
|
993
1050
|
if (value === undefined || value.startsWith("-")) {
|
|
994
1051
|
return { ok: false, message: `参数 ${arg} 缺少取值` };
|
|
995
1052
|
}
|
|
996
1053
|
if (arg === "--exclude")
|
|
997
1054
|
options.exclude.push(value);
|
|
1055
|
+
else if (arg === "--include")
|
|
1056
|
+
options.include.push(value);
|
|
998
1057
|
else
|
|
999
1058
|
options.config = value;
|
|
1000
1059
|
index += 1;
|
|
@@ -1042,12 +1101,14 @@ function helpText(color) {
|
|
|
1042
1101
|
row("sweep-nm", "预览: 清单 + 体积 + 合计, 零副作用"),
|
|
1043
1102
|
row("sweep-nm --yes", "执行删除"),
|
|
1044
1103
|
row("sweep-nm --exclude <name>", "临时追加排除 (可重复, 与配置合并)"),
|
|
1104
|
+
row("sweep-nm --include <name>", "只清理命中名单的目录 (可重复, 与配置合并)"),
|
|
1045
1105
|
row("sweep-nm --config <path>", "指定配置文件 (优先于 SWEEP_NM_CONFIG)"),
|
|
1046
1106
|
row("sweep-nm init", "初始化向导: 交互生成配置文件"),
|
|
1047
1107
|
row("sweep-nm --help", "帮助"),
|
|
1048
1108
|
"",
|
|
1049
1109
|
"说明:",
|
|
1050
1110
|
" --exclude 按目录名精确匹配 (区分大小写), 从根到命中点的任意一级命中即跳过",
|
|
1111
|
+
" --include 同款匹配口径, 命中才纳入; 同时命中 exclude 的照旧跳过",
|
|
1051
1112
|
` 默认配置位置 (平台自适应): ${defaultConfigPath()}`,
|
|
1052
1113
|
"",
|
|
1053
1114
|
"退出码: 0 成功 (含预览与空结果); 1 删除失败 / 配置损坏 / 参数错误"
|
|
@@ -1078,7 +1139,7 @@ async function resolveConfig(resolved) {
|
|
|
1078
1139
|
return { config: loaded.config, source: "file" };
|
|
1079
1140
|
if (!interactive())
|
|
1080
1141
|
return {
|
|
1081
|
-
config: { roots: [process.cwd()], exclude: [] },
|
|
1142
|
+
config: { roots: [process.cwd()], exclude: [], include: [] },
|
|
1082
1143
|
source: "fallback"
|
|
1083
1144
|
};
|
|
1084
1145
|
const result = await runWizard(resolved.path);
|
|
@@ -1113,16 +1174,25 @@ function withOutcomes(entries, batch, accepted, removal) {
|
|
|
1113
1174
|
...byTarget.get(entry.target) ?? fallback
|
|
1114
1175
|
}));
|
|
1115
1176
|
}
|
|
1116
|
-
function
|
|
1117
|
-
|
|
1118
|
-
|
|
1119
|
-
const
|
|
1120
|
-
|
|
1177
|
+
function collectNameNotes(excludeMatches, includeMatches, color) {
|
|
1178
|
+
const notes = [];
|
|
1179
|
+
const tty = process.stdout.isTTY === true;
|
|
1180
|
+
for (const item of excludeMatches ?? []) {
|
|
1181
|
+
if (item.hits === 0)
|
|
1182
|
+
warn(`排除名未命中任何已扫描的目录: ${item.name} (按目录名精确匹配; 若其上层目录已被排除则属预期)`, color);
|
|
1183
|
+
else if (tty)
|
|
1184
|
+
notes.push(`排除生效: ${item.name} (${item.hits} 处)`);
|
|
1185
|
+
}
|
|
1186
|
+
const includes = includeMatches ?? [];
|
|
1187
|
+
for (const item of includes) {
|
|
1121
1188
|
if (item.hits === 0)
|
|
1122
|
-
warn(
|
|
1189
|
+
warn(`包含名未命中任何已扫描的目录: ${item.name} (按目录名精确匹配; 若其上层目录已被排除则属预期)`, color);
|
|
1123
1190
|
else if (tty)
|
|
1124
|
-
|
|
1191
|
+
notes.push(`包含命中: ${item.name} (${item.hits} 处)`);
|
|
1125
1192
|
}
|
|
1193
|
+
if (includes.length > 0 && includes.every((item) => item.hits === 0))
|
|
1194
|
+
warn("包含名单无一条命中, 本次扫描必为空结果 (请核对名字与大小写; 若名字位于被排除的目录之下则属预期)", color);
|
|
1195
|
+
return notes;
|
|
1126
1196
|
}
|
|
1127
1197
|
function toEntries(hits, sizeResult) {
|
|
1128
1198
|
const bytesOf = new Map(sizeResult.entries.map((entry) => [
|
|
@@ -1154,18 +1224,29 @@ function toEntries(hits, sizeResult) {
|
|
|
1154
1224
|
}
|
|
1155
1225
|
async function sweep(config, options, color) {
|
|
1156
1226
|
const roots = config.roots;
|
|
1157
|
-
const exclude =
|
|
1158
|
-
const
|
|
1227
|
+
const exclude = mergeNames(config.exclude, options.exclude);
|
|
1228
|
+
const include = mergeNames(config.include, options.include);
|
|
1229
|
+
const scanResult = await createParallelScanner().scan({ roots, exclude, include });
|
|
1159
1230
|
for (const warning of scanResult.warnings)
|
|
1160
1231
|
warn(warning, color);
|
|
1161
|
-
|
|
1232
|
+
const nameNotes = collectNameNotes(scanResult.excludeMatches, scanResult.includeMatches, color);
|
|
1233
|
+
const tty = process.stdout.isTTY === true;
|
|
1234
|
+
const runtime = tty ? runtimeLabel : undefined;
|
|
1162
1235
|
const sizeResult = await createSizer().measure(scanResult.hits.map((hit) => hit.target));
|
|
1163
1236
|
for (const warning of sizeResult.warnings)
|
|
1164
1237
|
warn(warning, color);
|
|
1165
1238
|
const entries = toEntries(scanResult.hits, sizeResult);
|
|
1166
1239
|
const home = homedir4();
|
|
1167
1240
|
if (!options.yes) {
|
|
1168
|
-
print(render({
|
|
1241
|
+
print(render({
|
|
1242
|
+
mode: "preview",
|
|
1243
|
+
roots,
|
|
1244
|
+
entries,
|
|
1245
|
+
color,
|
|
1246
|
+
home,
|
|
1247
|
+
notes: nameNotes,
|
|
1248
|
+
runtime
|
|
1249
|
+
}));
|
|
1169
1250
|
return 0;
|
|
1170
1251
|
}
|
|
1171
1252
|
const batch = entries.filter((entry) => entry.bytes !== undefined).map((entry) => entry.target);
|
|
@@ -1187,7 +1268,9 @@ async function sweep(config, options, color) {
|
|
|
1187
1268
|
entries: report,
|
|
1188
1269
|
color,
|
|
1189
1270
|
home,
|
|
1190
|
-
releasedBytes
|
|
1271
|
+
releasedBytes,
|
|
1272
|
+
notes: nameNotes,
|
|
1273
|
+
runtime
|
|
1191
1274
|
}));
|
|
1192
1275
|
if (removal.aborted !== undefined) {
|
|
1193
1276
|
warn(`整批中止: ${removal.aborted.reason}`, color);
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@iyowei/sweep-node-modules",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.2.0",
|
|
4
4
|
"description": "工作区级 node_modules 清理工具: 一次扫描多个根目录, 跨项目列出体积, 确认后批量删除。",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"cli",
|
|
@@ -10,6 +10,7 @@
|
|
|
10
10
|
"disk-usage",
|
|
11
11
|
"cleanup"
|
|
12
12
|
],
|
|
13
|
+
"author": "iYoWei",
|
|
13
14
|
"license": "MIT",
|
|
14
15
|
"repository": {
|
|
15
16
|
"type": "git",
|