XCPC Workstation——基于 Rust+Typst 的本地优先的算法竞赛工作站

· · 科技·工程

::::info[项目信息]{open}

::::warning[中文字体与运行环境说明]{open} 发行版已内置 Latin Modern 与 JetBrains Mono,中文默认回退至系统字体(Windows 宋体/黑体/楷体或 Linux Noto CJK),开箱即可生成完整 PDF。如需与 ctex 方正字体基准完全一致,可将方正字体放入可执行文件同级的 fonts/ 目录。 ::::

::::success[AI 辅助说明]{open} 本文使用 AI 辅助润色。 ::::

XCPC Workstation:基于 Rust + Typst 的本地优先算法竞赛工作站

XCPC Workstation 是一款本地优先、开源的原生桌面应用,使用 Rust 与 Typst 从零构建,是本人此前网页端题面生成工具 xcpc-statement-generator 的彻底重构与演进版本(后者效果类似 cnoi-statement-generator)。

项目的长期目标是构建一套完整的个人算法竞赛工作站(覆盖题库管理、组卷出版、本地可复现造数据/对拍以及训练辅助)。目前处于公开测试阶段(Public Beta),优先完成了本地题库、组卷与 PDF 题面出版,同时对 OI 模拟赛与 ICPC 赛事均提供原生支持。

核心特性

1. 零 TeX 环境,毫秒级实时预览(支持 CNOI 与 ICPC 版式)

内嵌原生 Typst 排版引擎与分块增量光栅化机制,无需安装数 GB 的 TeX Live 环境,编辑题面时可实现毫秒级实时预览。

内置两套开箱即用的模板,且所有模板均以普通 .typ 文件存放在工作区目录中,支持直接修改与自由扩展:

每场比赛还支持独立维护专属模板文件(contests/<id>/template.typ),并通过模板声明式 #let schema 在右侧属性面板中直接可视化配置封面、编译选项等版式参数。

2. Markdown + LaTeX 写作与可编程矢量绘图

日常题面使用标准的 Markdown + LaTeX 数学公式编写。当题面需要绘制树、图论/几何示意图或对递推公式进行标注时,可在 Markdown 中直接嵌入 ```typst 原始块。

引擎原生支持 Typst @preview/* 包生态,并内置了 cetz(矢量绘图)、pinit(公式高亮与字段标注)和 mannot(公式下划线注解)等离线回退包,生成的图表与题面字体风格保持一致,且支持 .xcpc/preamble.typ 工作区级自定义宏。

3. 面向命题流程的编辑器设计

4. 本地目录题库、活引用组卷与定稿快照

全部数据以纯文本 Markdown + TOML 存储在本地目录中,无封闭数据库,天然适合使用 Git 进行版本管理与备份:

5. 原生 CLI 与 AI Agent(MCP)支持

桌面端、xcpc 命令行工具与 xcpc mcp(stdio)共用同一套 Rust 核心。除支持在 CI 或脚本中执行编译、规范检查与 PDF 导出外,还可直接接入 Claude、Cursor、Codex 等支持 MCP 的客户端,让 AI 协助完成题库检索、题面审校、编译诊断、组卷与导出;同时提供 --read-only 只读模式保障安全,外部修改会无闪烁实时同步至桌面端。

快速开始

前往 GitHub Releases 下载对应平台安装包:

首次启动桌面端后,点击 「打开示例」 即可释放内置示例工作区(包含一套 CSP-S 模拟赛与一套 ICPC 示例赛),直接体验编辑、模板切换与 PDF 导出流程。

字体说明:发行版已内置 Latin Modern 与 JetBrains Mono,安装后中文自动回退至系统字体(如 Windows 宋体/黑体/楷体或 Linux Noto CJK),开箱即可生成完整 PDF。如需与 ctex 方正字体基准保持完全一致,可参考仓库 README 将方正字体放入可执行文件同级的 fonts/ 目录。

后续路线图

项目目前处于公开测试阶段,欢迎在实际命题与模拟赛排版场景中试用。如遇到 Bug、版式差异或有功能建议,欢迎在 GitHub Issues 提交反馈,或在评论区与交流群中讨论。