@mindbase/node-tools 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NoahLiu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/bin/clear.js

@@ -0,0 +1,74 @@
+#!/usr/bin/env node
+const { Command } = require("commander");
+const { resolve } = require("path");
+const { scan } = require("../src/clear/scanner.js");
+const { clean } = require("../src/clear/cleaner.js");
+const { selectItems, confirmDelete, showResult } = require("../src/clear/ui.js");
+const { getConfig, resetConfig, showConfig, editConfig } = require("../src/clear/config.js");
+
+const program = new Command();
+
+program
+  .name("light-up-clear")
+  .description("交互式清理 node_modules 和锁文件的 CLI 工具")
+  .version("1.0.0");
+
+// 默认命令 - 执行清理
+program
+  .argument("[path]", "要清理的目录路径", ".")
+  .action(async (path) => {
+    const targetPath = resolve(path);
+    console.log(`扫描目录: ${targetPath}\n`);
+
+    const config = getConfig();
+    const items = scan(targetPath, config);
+
+    if (items.length === 0) {
+      console.log("未找到可清理的内容");
+      return;
+    }
+
+    // 显示多选界面
+    const selected = await selectItems(items);
+
+    if (selected.length === 0) {
+      console.log("未选择任何内容");
+      return;
+    }
+
+    // 确认删除
+    const confirmed = await confirmDelete(selected);
+    if (!confirmed) return;
+
+    // 执行删除
+    console.log("\n执行删除中...");
+    const stats = clean(selected);
+    await showResult(stats);
+  });
+
+// config 子命令
+program
+  .command("config")
+  .description("配置管理")
+  .option("--show", "显示当前配置")
+  .option("--reset", "重置为默认配置")
+  .action((options) => {
+    if (options.show) {
+      showConfig();
+    } else if (options.reset) {
+      resetConfig();
+      console.log("配置已重置为默认值");
+    } else {
+      showConfig();
+    }
+  });
+
+// editConfig 子命令
+program
+  .command("editConfig")
+  .description("打开编辑器编辑配置文件")
+  .action(() => {
+    editConfig();
+  });
+
+program.parse();

package/bin/git-log.js

@@ -0,0 +1,189 @@
+#!/usr/bin/env node
+const { Command } = require("commander");
+const { resolve } = require("path");
+const { exec } = require("child_process");
+const { promisify } = require("util");
+const fs = require("fs").promises;
+const path = require("path");
+
+const execAsync = promisify(exec);
+const { inputFilters, displayLogs, formatDateForGit } = require("../src/git-log/ui.js");
+
+// 验证和转义用户输入
+function sanitizeInput (input) {
+  if (typeof input !== 'string' || !input) {
+    return '';
+  }
+  return input.replace(/[;&|`$(){}[\]\\'"<>*?]/g, '');
+}
+
+// 检查 Git 安装
+async function checkGitInstallation () {
+  try {
+    const { stdout } = await execAsync('git --version');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+// 获取 Git 日志
+async function getGitLogs (dir, repoName, filters = {}) {
+  const safeAuthor = sanitizeInput(filters.author);
+  const safeSince = formatDateForGit(sanitizeInput(filters.since));
+  const safeUntil = formatDateForGit(sanitizeInput(filters.until));
+
+  let command = 'git log --all --pretty=format:"%H|%an|%ae|%ad|%s" --date=iso';
+
+  if (safeAuthor) {
+    command += ` --author="${safeAuthor}"`;
+  }
+
+  if (safeSince) {
+    command += ` --since="${safeSince}"`;
+  }
+
+  if (safeUntil) {
+    command += ` --until="${safeUntil}"`;
+  }
+
+  try {
+    const { stdout } = await execAsync(command, {
+      cwd: dir,
+      maxBuffer: 1024 * 1024 * 10
+    });
+
+    const logs = stdout.split('\n')
+      .filter(line => line.trim() !== '')
+      .map(line => {
+        const logRegex = /^([0-9a-f]{40})\|([^|]+)\|([^|]+)\|([^|]+)\|(.+)$/;
+        const match = line.match(logRegex);
+        if (match) {
+          return {
+            hash: match[1],
+            authorName: match[2],
+            authorEmail: match[3],
+            date: match[4],
+            subject: match[5],
+            repo: repoName
+          };
+        }
+        return null;
+      })
+      .filter(log => log !== null);
+
+    return logs;
+  } catch (error) {
+    return [];
+  }
+}
+
+// 扫描目录查找 Git 仓库
+async function scanDirectoriesForGitRepos (rootDir) {
+  const repos = [];
+  try {
+    // 先检查当前目录是否是 Git 仓库
+    try {
+      await fs.access(path.join(rootDir, '.git'));
+      repos.push({
+        name: path.basename(rootDir),
+        path: rootDir
+      });
+    } catch {
+      // 当前目录不是 Git 仓库，扫描子目录
+    }
+
+    // 扫描子目录
+    const entries = await fs.readdir(rootDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory() && entry.name !== 'node_modules') {
+        const fullPath = path.join(rootDir, entry.name);
+        try {
+          await fs.access(path.join(fullPath, '.git'));
+          repos.push({
+            name: entry.name,
+            path: fullPath
+          });
+        } catch {
+          // 不是 Git 仓库
+        }
+      }
+    }
+  } catch (error) {
+    console.error('扫描目录时出错:', error);
+  }
+  return repos;
+}
+
+// 主程序
+const program = new Command();
+
+program
+  .name("light-up-git-log")
+  .description("交互式 Git 日志查看工具")
+  .version("1.0.0")
+  .argument("[path]", "要扫描的目录路径", ".")
+  .action(async (targetPath) => {
+    const rootDir = resolve(targetPath);
+
+    console.log(`[扫描目录]: ${rootDir}`);
+
+    // 检查 Git
+    const hasGit = await checkGitInstallation();
+    if (!hasGit) {
+      console.log("\n[X] 请先安装 Git: https://git-scm.com/downloads");
+      return;
+    }
+
+    // 扫描仓库
+    const repos = await scanDirectoriesForGitRepos(rootDir);
+
+    if (repos.length === 0) {
+      console.log("\n[X] 未找到 Git 仓库");
+      return;
+    }
+
+    console.log(`[OK] 找到 ${repos.length} 个 Git 仓库\n`);
+
+    // 循环筛选和显示
+    async function showViewer () {
+      // 输入过滤条件（传入 repos 对象）
+      const filters = await inputFilters(repos);
+
+      if (!filters) {
+        console.log("已取消");
+        return;
+      }
+
+      // 获取选中仓库的日志
+      console.log("\n正在获取日志...");
+      const allLogs = [];
+
+      // 只获取选中的仓库
+      const selectedRepos = repos.filter(r => filters.selectedRepos.includes(r.path));
+
+      for (const repo of selectedRepos) {
+        const logs = await getGitLogs(repo.path, repo.name, filters);
+        allLogs.push(...logs);
+      }
+
+      if (allLogs.length === 0) {
+        console.log("\n[X] 没有找到符合条件的日志");
+        return;
+      }
+
+      // 按日期倒序排列
+      allLogs.sort((a, b) => new Date(b.date) - new Date(a.date));
+
+      console.log(`[OK] 获取到 ${allLogs.length} 条日志\n`);
+
+      // 显示日志，传入重新筛选的回调
+      await displayLogs(allLogs, showViewer);
+    }
+
+    await showViewer();
+
+    console.log("\n[OK] 完成");
+  });
+
+program.parse();

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@mindbase/node-tools",
+  "version": "1.1.0",
+  "description": "Node.js 开发工具集合：清理 node_modules、查看 Git 日志",
+  "main": "src/index.js",
+  "bin": {
+    "nodeclear": "./bin/clear.js",
+    "gitlog": "./bin/git-log.js"
+  },
+  "files": [
+    "bin",
+    "src"
+  ],
+  "scripts": {
+    "test": "node bin/clear.js"
+  },
+  "keywords": [
+    "clean",
+    "node_modules",
+    "cli",
+    "lock-file"
+  ],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "cli-table3": "^0.6.3",
+    "commander": "^11.0.0",
+    "editor": "^1.0.0",
+    "prompts": "^2.4.2",
+    "treeify": "^1.1.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "volta": {
+    "node": "20.20.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/clear/cleaner.js

@@ -0,0 +1,68 @@
+const { spawnSync } = require("child_process");
+const { platform } = require("process");
+
+const isWin = platform === "win32";
+let rmAvailable = null;
+
+// 检测 rm 命令是否可用
+function checkRmAvailable() {
+  if (rmAvailable !== null) return rmAvailable;
+  const result = spawnSync("rm", ["--version"], { shell: true });
+  rmAvailable = result.status === 0;
+  return rmAvailable;
+}
+
+// 执行删除命令
+function removeDir(path) {
+  if (checkRmAvailable()) {
+    const result = spawnSync("rm", ["-rf", path], { shell: true, stdio: "inherit" });
+    return result.status === 0;
+  } else if (isWin) {
+    const result = spawnSync("rmdir", ["/S", "/Q", path], { shell: true, stdio: "inherit" });
+    return result.status === 0;
+  } else {
+    const result = spawnSync("rm", ["-rf", path], { shell: true, stdio: "inherit" });
+    return result.status === 0;
+  }
+}
+
+function removeFile(path) {
+  if (checkRmAvailable()) {
+    const result = spawnSync("rm", [path], { shell: true, stdio: "inherit" });
+    return result.status === 0;
+  } else if (isWin) {
+    const result = spawnSync("del", [path], { shell: true, stdio: "inherit" });
+    return result.status === 0;
+  } else {
+    const result = spawnSync("rm", [path], { shell: true, stdio: "inherit" });
+    return result.status === 0;
+  }
+}
+
+/**
+ * 批量删除选中的项目
+ * @param {array} items - 要删除的项目数组
+ * @returns {object} 删除结果统计
+ */
+function clean(items) {
+  const stats = {
+    success: 0,
+    failed: 0,
+    details: []
+  };
+
+  for (const item of items) {
+    const success = item.type === "dir" ? removeDir(item.path) : removeFile(item.path);
+    if (success) {
+      stats.success++;
+      stats.details.push({ ...item, status: "success" });
+    } else {
+      stats.failed++;
+      stats.details.push({ ...item, status: "failed" });
+    }
+  }
+
+  return stats;
+}
+
+module.exports = { clean };

package/src/clear/config.js

@@ -0,0 +1,130 @@
+const { existsSync, readFileSync, writeFileSync, mkdirSync } = require("fs");
+const { join, dirname } = require("path");
+const { homedir } = require("os");
+
+// 获取配置文件路径
+function getConfigPath() {
+  const appData = process.env.APPDATA || join(homedir(), ".config");
+  return join(appData, "light-up-clear", "config.json");
+}
+
+// 默认配置
+const DEFAULT_CONFIG = {
+  targets: {
+    directories: ["node_modules", "pnpm"],
+    files: ["package-lock.json", "pnpm-lock.yaml", "yarn.lock"]
+  }
+};
+
+// 确保配置目录存在
+function ensureConfigDir(configPath) {
+  const dir = dirname(configPath);
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true });
+  }
+}
+
+// 读取配置
+function getConfig() {
+  const configPath = getConfigPath();
+
+  if (!existsSync(configPath)) {
+    // 首次运行，创建默认配置
+    ensureConfigDir(configPath);
+    writeFileSync(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2), "utf-8");
+    return DEFAULT_CONFIG;
+  }
+
+  try {
+    const content = readFileSync(configPath, "utf-8");
+    return JSON.parse(content);
+  } catch (error) {
+    console.error("配置文件读取失败，使用默认配置");
+    return DEFAULT_CONFIG;
+  }
+}
+
+// 写入配置
+function setConfig(config) {
+  const configPath = getConfigPath();
+  ensureConfigDir(configPath);
+  writeFileSync(configPath, JSON.stringify(config, null, 2), "utf-8");
+}
+
+// 重置为默认配置
+function resetConfig() {
+  setConfig(DEFAULT_CONFIG);
+  return DEFAULT_CONFIG;
+}
+
+// 显示配置
+function showConfig() {
+  const config = getConfig();
+  console.log("当前配置:");
+  console.log(JSON.stringify(config, null, 2));
+}
+
+// 编辑配置
+function editConfig() {
+  const edit = require('editor');
+  const { spawn } = require('child_process');
+  const { platform } = require('process');
+  const configPath = getConfigPath();
+
+  // 确保配置文件存在
+  if (!existsSync(configPath)) {
+    ensureConfigDir(configPath);
+    writeFileSync(configPath, JSON.stringify(DEFAULT_CONFIG, null, 2), "utf-8");
+  }
+
+  console.log(`打开配置文件: ${configPath}`);
+
+  // 优先使用 code（VS Code）
+  const editorCmd = process.env.EDITOR || (platform === 'win32' ? 'code' : 'vim');
+
+  if (editorCmd === 'code') {
+    // Windows/macOS/Linux 使用 VS Code
+    const spawnOptions = platform === 'win32'
+      ? { shell: true, stdio: 'inherit' }  // Windows 需要 shell
+      : { stdio: 'inherit' };
+
+    spawn('code', [configPath, '--wait'], spawnOptions)
+      .on('exit', (code) => {
+        if (code === 0) {
+          console.log('\n配置已保存');
+        } else {
+          console.log(`\n编辑器退出，代码: ${code}`);
+        }
+      })
+      .on('error', () => {
+        // code 命令不可用，回退到 editor 包
+        console.log('VS Code 不可用，使用默认编辑器...');
+        edit(configPath, function (code, sig) {
+          if (code === 0) {
+            console.log('\n配置已保存');
+          } else {
+            console.log(`\n编辑器退出，代码: ${code}`);
+          }
+        });
+      });
+  } else {
+    // 使用环境变量指定的编辑器
+    edit(configPath, function (code, sig) {
+      if (code === 0) {
+        console.log('\n配置已保存');
+      } else {
+        console.log(`\n编辑器退出，代码: ${code}`);
+      }
+    });
+  }
+}
+
+module.exports = {
+  getConfig,
+  setConfig,
+  resetConfig,
+  showConfig,
+  editConfig,
+  getConfigPath,
+  DEFAULT_CONFIG
+};

package/src/clear/scanner.js

@@ -0,0 +1,75 @@
+const { readdirSync, statSync } = require("fs");
+const { join, relative } = require("path");
+
+/**
+ * 递归扫描目录，查找匹配的目标
+ * @param {string} basePath - 基础路径
+ * @param {string} currentPath - 当前扫描路径
+ * @param {object} config - 配置对象
+ * @param {array} results - 结果数组
+ */
+function scanDirectory(basePath, currentPath, config, results) {
+  const { targets } = config;
+  const targetDirs = targets.directories || [];
+  const targetFiles = targets.files || [];
+
+  let entries;
+  try {
+    entries = readdirSync(currentPath);
+  } catch (error) {
+    // 无权限访问或目录不存在，跳过
+    return;
+  }
+
+  for (const entry of entries) {
+    const fullPath = join(currentPath, entry);
+    let stat;
+
+    try {
+      stat = statSync(fullPath);
+    } catch (error) {
+      continue;
+    }
+
+    if (stat.isDirectory()) {
+      // 检查是否是目标目录
+      if (targetDirs.includes(entry)) {
+        const relativePath = relative(basePath, fullPath);
+        results.push({
+          path: fullPath,
+          relativePath,
+          name: entry,
+          type: "dir"
+        });
+      } else {
+        // 递归扫描子目录
+        scanDirectory(basePath, fullPath, config, results);
+      }
+    } else if (stat.isFile()) {
+      // 检查是否是目标文件
+      if (targetFiles.includes(entry)) {
+        const relativePath = relative(basePath, fullPath);
+        results.push({
+          path: fullPath,
+          relativePath,
+          name: entry,
+          type: "file"
+        });
+      }
+    }
+  }
+}
+
+/**
+ * 扫描指定目录
+ * @param {string} scanPath - 要扫描的目录路径
+ * @param {object} config - 配置对象
+ * @returns {array} 扫描结果数组
+ */
+function scan(scanPath, config) {
+  const results = [];
+  scanDirectory(scanPath, scanPath, config, results);
+  return results;
+}
+
+module.exports = { scan };