# gitee-github-info-project

**Repository Path**: aylerh/gitee-github-info-project

## Basic Information

- **Project Name**: gitee-github-info-project
- **Description**: 项目目标-获取指定用户的所有开源项目信息(github-gitee);
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-17
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Gitee & GitHub 项目信息导出工具

这是一个基于 Go 1.24 和 Gin 开发的高颜值 Web 服务，能够帮助开发者一键查询、导出 GitHub 或 Gitee 的公开仓库信息并生成整齐的 Markdown 表格，支持容器内暂存及本地下载。

## 功能列表
- 🌐 **双平台支持**：支持抓取 GitHub 和 Gitee 的项目数据（支持输入用户名、组织名或主页/项目标签页的完整 URL 自动解析）。
- 📝 **Markdown 导出**：自动生成格式整齐的 Markdown 列表，包含五列数据：`序号`、`项目名称`、`项目链接`、`类别`（区分原仓库或 Fork 仓库）和`项目描述`。
- 🌟 **双导出模式**：支持导出用户/组织下的“所有仓库”列表，或导出个人用户的“Star 仓库”列表。
- 📥 **本地直接下载**：获取成功后支持在前端直接一键下载生成的 Markdown 文件，无需通过服务器生成中转。
- 📂 **服务器暂存区**：支持将生成的 Markdown 结果暂存入容器的本地存储，并在前端统一展示文件列表、支持下载和一键删除。
- 🛑 **获取任务中断**：抓取过程中抓取按钮转换为“取消获取”，支持利用 `AbortController` 瞬时终止进行中的抓取请求。
- ⏱️ **请求耗时显示**：获取任务成功后，界面会自动显示本次抓取和转换所耗费的精确秒数。
- 🔒 **API Token 配置**：支持在前端便捷配置 GitHub/Gitee 的个人 Token 以提升 API 请求频次，Token 仅留存于用户浏览器本地。
- 📖 **交互式 API 文档**：项目自动构建生成 Swagger API 文档，通过 `/docs` 自动跳转，方便开发者进行接口调试。
- 💎 **高级感视觉交互**：使用原生 CSS 手写精致的暗色磨砂玻璃（Glassmorphic）视觉风格，配备丝滑的加载状态切换及鼠标微过渡动效。

## 页面样式

### 主页

![1](./images/1.png)

## 构建与运行

### 1. 拉取基础镜像
```bash
docker pull golang:1.24-alpine
docker pull lightpanda/browser:nightly
```

### 2. 配置环境变量
在项目根目录创建并配置 `.env` 文件：
```ini
INNER_PORT=8506
OUTER_PORT=8506
```

### 3. 一键启动容器
在 Windows PowerShell 终端中执行以下命令：
```powershell
docker compose up --build -d
```
启动后通过浏览器访问 [http://localhost:8506](http://localhost:8506) 使用。
API 接口文档可通过 [http://localhost:8506/docs](http://localhost:8506/docs) 访问。

## 解决痛点与使用技术

### 解决痛点
1. **纯手动收集效率低**：手动整理个人或团队的上百个仓库链接十分耗时，本工具一键解析，自动导出标准 Markdown 格式。
2. **API 速率限制问题**：GitHub 对匿名请求有严格的 Rate Limit 限制，本工具在前端设计了 Token 配置机制，由后端安全调用以解决频次限制。
3. **环境依赖繁琐**：通过 Docker 容器化封装，开发及部署无须在本地搭建 Go 及相关的第三方工具链环境。

### 使用技术
- **后端**：Go 1.24、Gin Web 框架、gin-swagger 接口文档。
- **前端**：Vanilla HTML / JS、磨砂玻璃拟物化原生 CSS 样式、Lucide 矢量图标、Marked.js。
- **部署**：Docker Multi-stage 阶段构建、Docker Compose 编排。

## 致谢

- [Gin](https://github.com/gin-gonic/gin) - 高性能的Go语言Web框架
- [Swag](https://github.com/swaggo/swag) - 自动生成Swagger文档工具
- [Marked](https://github.com/markedjs/marked) - 轻量且快速的Markdown编译器
- [Lucide](https://github.com/lucide-icons/lucide) - 美观且一致的矢量图标库