# 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-10-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<div align="center">

# 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%" />
  </a>
</p>

</div>


## 介绍

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


## 使用

### 指令

- ## 插件更新
- 「#HL推送更新」
- 「#HL推送强制更新」

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

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

> fork 仓库 GitHub 不返回 events，插件会自动改用「最近提交 + 发版」兜底展示。

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

 - **手动测试推送状态**
 - **#git强制检查**
 - 强制扫一遍所有仓库

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


## 事件推送

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

发版说明、Issue / PR 正文这类 markdown 内容，除了卡片里的纯文本，还能额外渲染一份排版好的页面图。
锅巴里可以配：

| 配置 | 说明 |
| --- | --- |
| markdown 正文渲染 | `单独发一条`（默认）/ `和推送卡片合并成一条` / `不渲染` |
| 每次最多渲染几份 | 一轮推送最多补发几张页面图 |
| markdown 页面模板 | `跟随推送模板`（默认，按推送模板的深浅色系自动挑）/ 或指定 `markdown.html`（浅色）/ `markdown-dark.html`（深色） |

`resources/` 下新增 `markdown*.html` 会被自动列进模板下拉框，可以自己丢模板进去。


## DeepSeek 服务状态

官方状态页 https://status.deepseek.com/ 跑的是 FlashDuty，没有可用的 JSON 接口
（`/api/v2/*.json` 全是 404，只有 `/api/health`），能稳定取数的是订阅源：

- 状态页：https://status.deepseek.com/
- 订阅源（RSS）：https://status.deepseek.com/feed.rss
- 订阅源（Atom）：https://status.deepseek.com/feed.atom（插件解析的是 RSS）

两个都不需要 token / cookie，直接访问即可。

| 指令 | 说明 |
| --- | --- |
| `#ds状态` | 渲染状态页整页截图（截图失败退回订阅源文本）；截图顶部本来就有结论，默认不再单独发文字 |
| `#ds服务状态` | 解析订阅源，列出最近的服务事件（状态、影响组件、时间、链接） |
| `#ds推送检查` | 立即检查一次并推送新事件（主人） |
| `#ds推送开启` / `#ds推送关闭` | 把当前群（或带群号）加入、移出推送名单（主人） |

推送规则：订阅源里的每条事件都有唯一 guid，插件只推「上次游标之后」的新事件，
首次开启只记游标不补推历史；推送内容 = 事件卡片（含状态判断）+ 可选的状态页截图，
都可在锅巴里开关。订阅源里没有组件维度的实时状态，所以「当前是否正常」是按最近一条
事件的 Status 推断的，判断不出来时会显示「状态未知」，不会假装一切正常。


## 相关链接

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