# hl-git-plugin

**Repository Path**: fox-glaze/hl-git-plugin

## Basic Information

- **Project Name**: hl-git-plugin
- **Description**: git仓库推送
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-06
- **Last Updated**: 2026-03-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# hl-git-plugin

Git 仓库事件视奸插件

<p align="center">
  <a href="https://gitee.com/fox-glaze/hl-git-plugin/">
  <img src="./resources/img/H.gif" width="45%" height="45%" alt="hl-git-plugin">
  </a>
</p>

## 介绍

hl-git-plugin 是一个用于视奸 Git 仓库（GitHub/Gitee/gitcode）事件的插件，可以实时追踪仓库的推送、合并 等活动，并推送到群聊

## 功能特性

- **仓库监控**：监控 Git 仓库的各类事件（推送、合并、issues、pr）
- **推送**： 默认每5分钟扫一次
- **配置管理**：支持锅巴配置


## 目录结构

```
hl-git-plugin/
├── apps/
│   ├── git-monitor.js    # Git 视奸本体
│   ├── help.js           # 帮助命令
│   └── update.js         # 更新
├── lib/
│   ├── config.js         # 配置文件
│   └── monitor.js        # 视奸模块
├── resources/
│   ├── help/
│   │   └── help.md       # 帮助文档.md
│   ├── img/
│   │   └── help.jpg      # 帮助图片
│   └── render.html       # html
├── guoba.support.js      # 锅巴配置
├── index.js              # 插件入口
└── package.json          
```

# 🚀安装
自选
- gitee

``` bash
git clone --depth 1 https://gitee.com/fox-glaze/hl-git-plugin ./plugins/hl-git-plugin
```
- gitcode

``` bash
git clone --depth 1 https://gitcode.com/sujier/hl-git-plugin ./plugins/hl-git-plugin
```

# ❕️安装依赖

``` bash
pnpm install
```

## 配置

首次使用需配置token，配置文件位于 `plugins/hl-git-plugin/config/` 目录下 加载插件自动生成config.yaml


## 使用

### 指令

- **#github添加/删除推送**
- 「#github添加/删除推送 git仓库链接」

- **#gitee添加/删除推送**
- 「#gitee添加/删除推送 git仓库链接」

- **#gitcode添加/删除推送**
- 「#gitcode添加/删除推送 git仓库链接」

- 链接后面空格后可选（1.2.3.4）
- 列如 「#gitee添加推送https://gitee.com/fox-glaze/hmeme 4」
分别对应
- 1 仅视奸更新内容
- 2 仅视奸issues/包括评论
- 3 仅视奸pr
- 4 视奸以上所有内容

- **#git推送列表**
  查看所有仓库推送状态

 - **手动测试推送状态**
 - **#git强制检查**
 - 强制扫一遍所有仓库
 - 也可强制指定平台
 - **#gitee强制检查**
 - **#github强制检查**
 - **#gitcode强制检查**

- ## 支持锅巴配置config
 
- **#HL推送帮助**
  查看本帮助文档


## 事件推送

插件会将 Git 事件以图片渲染形式推送
- 仓库信息（平台、仓库名）
- 作者信息
- 事件类型（推送、合并等）
- 代码变更统计（新增/删除行数）
- 详细内容预览


## 相关链接

- [锅巴插件](https://gitee.com/guo-bai/guoba)