GenGen 洛谷国际 —— 关于

General00826 · 2026-03-07 17:27:27 · 个人记录

关于 GenGen 洛谷国际

项目简介

GenGen 洛谷国际 是一个为洛谷用户设计的第三方增强工具平台，提供文章渲染、云剪切板等实用功能。本项目基于 MIT 协议开源，致力于为用户提供更优质的使用体验。

技术架构

前端技术栈

目录结构

gengen-luogu/
├── index.html          # 主页
├── article/
│   └── index.html      # 文章渲染页
├── paste/
│   └── index.html      # 云剪切板页
├── functions/
│   └── [[path]].js     # Cloudflare Workers 路由
├── style.css           # 全局样式（深色玻璃主题）
├── mark.css            # Markdown 基础样式
└── lgge.svg            # 项目 Logo

部署架构

用户请求 → Cloudflare Workers (functions/[[path]].js)
         → 静态资源服务 (gengen.qzz.io)
         → API 后端 (luogu.qzz.io/api/)

渲染引擎说明

本项目的 Markdown 渲染思路由 Amazing Luogu（luogu.amlg.top）提出，在此表示衷心感谢。

渲染流程：

1. 使用 marked 解析 Markdown 为原始 HTML
2. 使用 DOMPurify 净化 HTML，防止 XSS 攻击
3. 使用 KaTeX 渲染 LaTeX 数学公式
4. 使用 highlight.js 对代码块进行语法高亮
5. 支持自定义扩展语法（对齐块、引用块、折叠提示块）

使用说明

访问方式

1. 主页: https://luogu.qzz.io/
2. 文章页: https://luogu.qzz.io/article/{文章 ID}
3. 云剪切板: https://luogu.qzz.io/paste/{剪切板 ID}

功能特性

文章页

• 支持通过 URL 参数、路径或哈希加载文章
• 实时渲染 Markdown 内容
• 代码语法高亮（默认 C++）
• LaTeX 数学公式支持
• 自动生成目录（TOC）
• 支持自定义扩展语法：
  • :::align{center} 对齐块
  • :::epigraph[作者] 引用块
  • :::info[标题]{open} 折叠提示块

云剪切板页

• 与文章页功能类似
• 专门用于分享代码片段
• 支持快速复制 Markdown 源码

快捷键

版本号

本地开发

环境要求

• Node.js 18+
• npm 或 pnpm

安装依赖

npm install

启动开发服务器

npm run dev

构建部署

npm run build

开源协议

本项目基于 MIT 协议 开源，允许自由使用、修改和分发。

开发团队

GenGen 队

• 主要开发者：全体 GenGen 队 开发者
• 联系方式：洛谷私信

相关链接

© 2026 全体 GenGen 队 开发者