舞萌DX 图表渲染服务
- C# 100%
予纾
82600b96e5
codeberg-tiny (1 core/1GB) wasn't enough to build this project; bumping to codeberg-small (2 cores/4GB). Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> |
||
|---|---|---|
| .forgejo/workflows | ||
| docs | ||
| src | ||
| .gitattributes | ||
| .gitignore | ||
| LICENSE | ||
| Limekuma.slnx | ||
| README.md | ||
迪拉熊Bot - DXKuma Bot
酸橙熊熊 - Limekuma
为舞萌DX设计的成绩图表渲染服务
📖 项目简介
酸橙熊熊（青柠熊熊）是一个高性能图表渲染微服务。主要用于接入舞萌DX的查分器数据，为玩家的游玩成绩（如B50、成绩列表等）生成精美的图片，常作为机器人（如迪拉熊Bot）的后端渲染引擎。
本项目通过纯托管图形库ImageSharp实现了脱离原生环境依赖的图形渲染，并内置了基于XML的灵活布局引擎，能够动态渲染丰富多样的玩家成绩卡片。
📚 项目文档
关于酸橙熊熊的详细介绍、架构设计以及协作者接入指南，请参阅我们的官方文档。
✨ 核心特性
- 🚀 高性能渲染：基于ImageSharp，无需依赖本地系统GDI或libgdiplus，跨平台支持好。
- 📊 多数据源支持: 原生支持落雪咖啡屋 (Lxns)与水鱼 (Diving-Fish)查分器API。
- 🖼️ 丰富的图像生成接口: 支持生成玩家B50成绩图、成绩列表图、成绩记录图、谱面信息图、达成率信息图等。
- 🔧 自定义布局引擎：渲染逻辑与布局分离，基于XML节点定义的灵活布局系统。
- 📡 流式gRPC通信：基于Protobuf定义，提供流式的图片字节序列返回，降低大图片传输的内存占用。
🛠️ 技术栈
- 核心框架：.NET
- 通信协议：gRPC
- 图像处理：ImageSharp
- 表达式引擎：NCalc
- 模板引擎：SmartFormat
- 配置管理：Hocon
📦 快速开始
1. 环境要求
2. 获取源码
git clone <your-repo-url>/limekuma-printer.git
cd limekuma-printer
3. 安装依赖
dotnet restore
4. 运行项目
dotnet run --project src/Limekuma.csproj
项目启动后，将通过配置中指定的端口提供gRPC服务。
📜 接口定义
API接口均定义在src/Protos/kumabot.proto文件中。
📄 开源协议
本项目基于GNU Affero General Public License v3.0协议开源。详细信息请参阅LICENSE文件。
🐛 问题反馈
如果您遇到任何问题或有建议，请通过以下方式联系我们：