@mindbase/node-tools

Node.js 开发工具集合，提供清理、Git 日志查看、包发布三个命令。

安装

npm install -g @mindbase/node-tools

命令概览

| 命令 | 功能 | |------|------| | nodeclear | 清理 node_modules 和锁文件 | | gitlog | 交互式 Git 日志查看 | | npmpublish | 通用包发布工具 |

nodeclear - 清理工具

交互式清理 node_modules 和锁文件的 CLI 工具。

基本用法

# 清理当前目录
nodeclear

# 清理指定目录
nodeclear ../my-project

配置管理

# 显示当前配置
nodeclear config --show

# 重置为默认配置
nodeclear config --reset

# 编辑配置文件
nodeclear editConfig

配置项

配置文件位于 ~/.nodeclear.config.json，支持配置：

• 扫描目标（node_modules、锁文件等）
• 排除目录
• 是否显示隐藏目录

gitlog - Git 日志查看

交互式 Git 日志查看工具，支持多仓库、多条件筛选。

基本用法

# 扫描当前目录及子目录的 Git 仓库
gitlog

# 扫描指定目录
gitlog ~/projects

功能特性

• 自动扫描当前目录及子目录的 Git 仓库
• 支持多选仓库
• 按作者筛选
• 按日期范围筛选
• 表格化展示日志

npmpublish - 发布工具

通用发布工具，支持单项目和工作空间（npm workspace/monorepo）。

基本用法

# 发布当前项目
npmpublish

# 发布指定项目
npmpublish ../my-package

# 模拟运行（不实际发布）
npmpublish --dry-run

# 指定标签
npmpublish --tag beta

# 跳过构建步骤
npmpublish --skip-build

# 自动确认（非交互模式）
npmpublish --yes

# 多源并行发布
npmpublish --parallel

全局配置管理

# 显示全局配置
npmpublish config --show

# 编辑全局配置
npmpublish config --edit

# 添加注册源
npmpublish config --add-registry

# 删除注册源
npmpublish config --remove-registry <id>

# 添加 token
npmpublish config --add-token

# 删除 token
npmpublish config --remove-token <id>

# 验证 token 有效性
npmpublish config --validate-token <id>

# 重置配置
npmpublish config --reset

项目配置管理

# 显示项目配置
npmpublish project --show

# 编辑项目配置
npmpublish project --edit

# 初始化项目配置
npmpublish project --init

配置文件

• 全局配置: ~/.node-tools-publish.json - 存储注册源和 token
• 项目配置: package.json 的 publishConfig 字段

{
  "publishConfig": {
    "defaultRegistries": ["npm", "codeup"],
    "defaultTokens": {
      "codeup": "token-1"
    }
  }
}

兼容性提示: 如果存在旧版 .node-tools-publish.json 文件，仍可正常使用，建议迁移到 package.json

系统要求

• Node.js >= 16.0.0
• Git（gitlog 命令需要）

License

MIT