# git-logs

**Repository Path**: ystyle/git-logs

## Basic Information

- **Project Name**: git-logs
- **Description**: 打印指定条件的按天显示的日志
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-03-09
- **Last Updated**: 2026-08-31

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## git日志提取工具

遍历指定目录下的所有 git 仓库（含目录本身是仓库、目录下嵌套多个仓库、以及 `.git` 为文件的 worktree/子仓库），按作者和日期汇总打印提交日志。

### 使用方法
- 把 `git-logs` 可执行文件放到 PATH 下（Windows 可放到 `Git\mingw64\bin`），即可用 `git logs` 调用
- `git-logs -h` 查看帮助
- `git-logs -ls -dir ~/Work/guanyi/` 列出目录下所有仓库
- `git-logs -author='星痕' -dir ~/Work/guanyi/ -date 2026-08-23` 打印该日期之后、该作者的日志
- `git-logs -dir ~/Work/guanyi/` 不传 `-date` 时默认打印昨天的日志
- `git-logs -dir ~/Work/guanyi/` 不传 `-author` 时使用各仓库自己的 `user.name`
- `git-logs -v` 查看版本

### 参数说明
| 参数 | 说明 |
| --- | --- |
| `-dir` | 项目根目录（必填），会自动查找目录本身及其下所有 git 仓库 |
| `-author` | 过滤日志的作者，默认取各仓库的 `user.name` |
| `-date` | 过滤日志的起始日期，格式 `YYYY-MM-DD`，默认昨天 |
| `-ls` | 仅列出找到的所有仓库 |
| `-v` | 显示版本 |

### 输出说明
输出开头为汇总统计（提交总数、时间范围、项目分布；多作者时含作者分布），每个日期标题后会标注当天提交条数，例如：

```
汇总: 共 66 条提交 (2026-08-20 ~ 2026-08-28, 3 个项目)
项目统计:
	guanyi-desktop: 62
	...
日志明细:

2026-08-28 Fri (19条)
---------------------------------------------------------------
	星痕 guanyi-desktop fix: ...
```