# 启光Nodejs终端工具

**Repository Path**: noahliu0911/mind-base-node-tools

## Basic Information

- **Project Name**: 启光Nodejs终端工具
- **Description**: 基于Nodejs的多终端工具集合
- **Primary Language**: NodeJS
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-09
- **Last Updated**: 2026-02-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# @mindbase/node-tools

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

## 安装

```bash
npm install -g @mindbase/node-tools
```

---

## 命令概览

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

---

## nodeclear - 清理工具

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

### 基本用法

```bash
# 清理当前目录
nodeclear

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

### 配置管理

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

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

# 编辑配置文件
nodeclear editConfig
```

### 配置项

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

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

---

## gitlog - Git 日志查看

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

### 基本用法

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

# 扫描指定目录
gitlog ~/projects
```

### 功能特性

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

---

## npmpublish - 发布工具

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

### 基本用法

```bash
# 发布当前项目
npmpublish

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

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

# 指定标签
npmpublish --tag beta

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

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

# 多源并行发布
npmpublish --parallel
```

### 全局配置管理

```bash
# 显示全局配置
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
```

### 项目配置管理

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

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

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

### 配置文件

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

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

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

---

## 系统要求

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

## License

MIT