一、脚本功能概述

这是一个用于自动提取GitLab提交记录的Node.js脚本，专为年终设计。它可以的观点是，

1. 根据指定的时间范围批量获取GitLab提交记录
2. 过滤掉合并提交。只保留实际代码变更
3. 按项目分组展示提交记录

二、主要模块解析

. 环境变量读取模块

javascript

function readEnvFile {
const content = fs.readFileSync;const lines = content.split.filter;const env = {};for {
if .startsWith) continue;const idx = line.indexOf;if continue，const key = line.slice.trim;const value = line.slice.trim;env = value，老实说，}
return env;}

功能说明读取.env配置文件，解析为键值对。不过，

配置说明

# GitLab服务器地址
GITLAB_URL=YOUR_GITLAB_URL
# GitLab访问令牌
GITLAB_TOKEN=YOUR_GITLAB_TOKEN
# 可选：作者使用者名
GITLAB_AUTHOR_USERNAME=your_username
# 可选：指定项目ID
GITLAB_PROJECT_IDS=。

. 命令行参数解析模块

function parseArgs {
const args = {};for {
const arg = argv;if ) {
const = arg.split;不过，args = v，}
}
return args;}

功能说明解析命令行参数，支持--since和--until参数。

. 时间范围处理模块

function ensureIsoRange {
const sinceIsDateOnly = /^\d{}-\d{}-\d{}$/.test;const untilIsDateOnly = /^\d{}-\d{}-\d{}$/.test;if {
const { since } = toIsoRangeDayStartEnd;const { until } = toIsoRangeDayStartEnd;return { since,until };}
const since = new Date.toISOString;const until = new Date.toISOString;话说回来，return { since,until };}

功能说明将使用者输入的时间范围转换为ISO标准格式，支持日期格式和完整时间格式。

. API请求模块

function requestJson {
return new Promise => {
const u = new URL;const { protocol,hostname。port,pathname,search } = u;const lib = protocol === 'https:'?https : http;const options = {
hostname,port: port ||。path: `${pathname}${search}`,method: 'GET',headers,};const req = lib.request => {
const { statusCode,headers: resHeaders } = res;const chunks =;res.on => chunks.push);不过，res.on => {
const body = Buffer.concat.toString;if {
try {
const json = JSON.parse;resolve，} catch {
reject}`));}
} else {
reject}`));}
})，});req.on，req.end;})，}

功能说明发送HTTP/HTTPS请求，返回JSON格式的响应。

. GitLab API调用模块

async function fetchAllCommits {
const collected =;let page =，按理说，for {
const params = { since,until。per_page:,page,with_stats: false,author };const { commits,nextPage } = await fetchCommitsPage;collected.push;其实，if break，怎么说呢，page = parseInt;
if || page <= ) break;
  }
  return collected;
}

功能说明分页获取GitLab提交记录，支持作者过滤。

. 提交记录过滤模块

function filterNonMerge {
const filtered =;for {
const { parent_ids } = commit;const nonMerge = Array.isArray?parent_ids.length <= : true;
    if  filtered.push;
  }
  return filtered;
}

功能说明过滤掉合并提交，只保留实际代码变更的提交。

. 报告生成模块

const { since,until } = range;const { username,name } } author;话说回来，const lines =;lines.push，lines.push;lines.push，for {
const { name: projName } = project.meta;lines.push，for {
lines.push);}
}
return `${lines.join}
`;}

三、使用方法

1. 安装依赖：无需额外依赖，使用Node.js内置模块。

2. 配置.env文件：根据实际情况修改.env文件中的配置。

3. 运行脚本：

   node fetch_commits.js --since=START_DATE --until=END_DATE --author=你的提交使用者名
   

4. 查看报告：脚本会生成commits.md文件，包含指定时间范围内的提交记录。

四、完整代码 同级创建.env就可以使用

const fs=require;const path=require;const http=require;const https=require;function readEnvFile{
const content=fs.readFileSync;const lines=content.split.filter;const env={};for{
if.startsWith)continue;const idx=line.indexOf;ifcontinue，const key=line.slice.trim;const value=line.slice.trim;env=value，}
return env;}
function parseArgs{
const args={};for{
const arg=argv;if){
const =arg.split;args=v，}}
return args;}
function toIsoRangeDayStartEnd{
const start=new Date;按理说，const end=new Date;return{since:start.toISOString,until:end.toISOString};}
function ensureIsoRange(sinceInput,untilInput){
const sinceIsDateOnly=/^\d{}-\d{}-\d{}$/.test;const untilIsDateOnly=/^\d{}-\d{}-\d{}$/.test;if{
const{since}=toIsoRangeDayStartEnd;const{until}=toIsoRangeDayStartEnd;return{since,until};}
const since=new Date.toISOString;const until=new Date.toISOString;return{since,until};}
function requestJson(urlStr,headers={}){
return new Promise=>{
 });}


function buildApiUrl(base,pathStr,query={}){
// implementation omitted for brevity
}

async function fetchProjectMeta(baseUrl,token。id){
// implementation omitted for brevity
}

function filterNonMerge{
// implementation omitted for brevity
}

function formatCommitLine(project,commit){
// implementation omitted for brevity
}

function pad2{return String.padStart;}
function formatDateLocal{
// implementation omitted for brevity
}

// report generation snippet ...

function filterByAuthorName(commits,authorName){
// implementation omitted for brevity
}

async function main{
// implementation omitted for brevity
}
main.catch=>{
// error handling
});