工具链总览

srk 生态围绕数据格式规范提供了一系列工具，覆盖从数据生产到展示和分发的完整工作流。

生态项目一览

项目	用途	包
Standard Ranklist	规范定义、类型和 Schema	@algoux/standard-ranklist
Renderer Component	Web 渲染组件	Renderer 渲染组件
CLI	使用命令行工具操作 srk 文件	@algoux/standard-ranklist-cli
Utils	支持 JavaScript/TypeScript、Python 和 Go 的工具库	Utils 工具库
Convert-to	格式转换工具	@algoux/standard-ranklist-convert-to

典型工作流示例

场景 1：在自己的应用中展示榜单

srk → Renderer Component → 你的应用

1. 准备 srk 数据或实现可输出 srk 的 API
2. 在 Web 应用中使用 Renderer 组件
3. 将 srk 数据传入组件进行渲染

场景 2：导出为其他平台格式

srk → CLI convert / Convert-to → Codeforces Gym / Excel / VJ Replay

1. 准备 srk 数据
2. 使用 srk convert 或 Convert-to 工具选择目标格式
3. 生成目标格式的文件

场景 3：维护和发布 srk 文件

srk → CLI validate / diagnose / convert / preview / render → CI / 静态页面 / 导出文件

1. 使用 CLI 校验 srk 文件结构并发现常见数据问题
2. 按需导出 Excel、VJudge Replay 或 Codeforces Gym Ghost 文件
3. 在本地浏览器预览榜单效果
4. 渲染静态页面用于归档、发布或 PR Review