XCPC Workstation——基于 Rust+Typst 的本地优先的算法竞赛工作站
::::info[项目信息]{open}
- GitHub 仓库:lihaoze123/xcpc-workstation
- 安装包下载:GitHub Releases(Windows / Linux)
- 开源协议:Apache-2.0
- QQ 交流群:
1134941278 -
值得注意的是,本工具不仅限于 XCPC,实际上对 OI 有同等的支持,只是想不到好名字(
::::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 文件存放在工作区目录中,支持直接修改与自由扩展:
cnoi-classic:还原 CCF CSP / NOI 官方题面版式,涵盖封面题目汇总表(题目类型、输入输出文件名、时限/内存限制、提交源程序文件名、编译选项与注意事项)、页眉页脚及标准中文题面章节;olymp-classic:严格对齐olymp.sty(ICPC / Polygon 风格),支持单题导出、带封面与试题列表的整本试题册、可选奇偶留白页、跨页样例表与 A4 题解册。
每场比赛还支持独立维护专属模板文件(contests/<id>/template.typ),并通过模板声明式 #let schema 在右侧属性面板中直接可视化配置封面、编译选项等版式参数。
2. Markdown + LaTeX 写作与可编程矢量绘图
日常题面使用标准的 Markdown + LaTeX 数学公式编写。当题面需要绘制树、图论/几何示意图或对递推公式进行标注时,可在 Markdown 中直接嵌入 ```typst 原始块。
引擎原生支持 Typst @preview/* 包生态,并内置了 cetz(矢量绘图)、pinit(公式高亮与字段标注)和 mannot(公式下划线注解)等离线回退包,生成的图表与题面字体风格保持一致,且支持 .xcpc/preamble.typ 工作区级自定义宏。
3. 面向命题流程的编辑器设计
/斜杠命令:快速插入行间公式、矩阵、分段函数、子任务评分表、提示章节及原始 Typst 块;- 悬浮公式预览:在专注模式或编辑复杂公式时,光标停留即可就近浮出与最终 PDF 一致的渲染结果;
- 样例独立管理与一键复制:样例统一存储在
samples/目录下,提供左右分栏编辑与拖拽重排;需要向洛谷、Hydro 等在线评测平台粘贴题面时,可通过Ctrl+K一键复制「带样例的完整 Markdown」,不修改本地源文件; - 其他效率特性:轻量图片素材库(支持引用定位与重命名同步改写)、专注写作模式、可选实用子集 Vim 模式,以及支持通过
theme.toml自定义界面配色与编辑器字体。
4. 本地目录题库、活引用组卷与定稿快照
全部数据以纯文本 Markdown + TOML 存储在本地目录中,无封闭数据库,天然适合使用 Git 进行版本管理与备份:
- 题库中心:每道题独立存放(
problem.toml、statement.md、editorial.md、samples/、assets/),支持多维筛选、难度标注与即时预览; - 活引用组卷:比赛通过题目 ID 引用题库中的题目,并仅覆写本场比赛的标题、时空限制或版式参数。修正题库中的错别字后,所有未定稿比赛自动同步更新;
- 冻结归档(Freeze):定稿前自动执行规范与编译检查,通过后将生效的题目源文件、模板及生成的试题册/题解册 PDF 固化至
snapshot/目录并转为只读状态,确保历史比赛永久可复现。
5. 原生 CLI 与 AI Agent(MCP)支持
桌面端、xcpc 命令行工具与 xcpc mcp(stdio)共用同一套 Rust 核心。除支持在 CI 或脚本中执行编译、规范检查与 PDF 导出外,还可直接接入 Claude、Cursor、Codex 等支持 MCP 的客户端,让 AI 协助完成题库检索、题面审校、编译诊断、组卷与导出;同时提供 --read-only 只读模式保障安全,外部修改会无闪烁实时同步至桌面端。
快速开始
前往 GitHub Releases 下载对应平台安装包:
- Windows (x86_64):每用户安装器(
.exe,免管理员权限,支持应用内自动更新)或便携包(.zip) - Linux (x86_64):
.deb、Arch.pkg.tar.zst、AppImage或.tar.gz
首次启动桌面端后,点击 「打开示例」 即可释放内置示例工作区(包含一套 CSP-S 模拟赛与一套 ICPC 示例赛),直接体验编辑、模板切换与 PDF 导出流程。
字体说明:发行版已内置 Latin Modern 与 JetBrains Mono,安装后中文自动回退至系统字体(如 Windows 宋体/黑体/楷体或 Linux Noto CJK),开箱即可生成完整 PDF。如需与
ctex方正字体基准保持完全一致,可参考仓库 README 将方正字体放入可执行文件同级的fonts/目录。
后续路线图
- Phase 3 — 本地 Polygon(规划中):基于
wasi-sdk与 Wasmtime 的 fuel 确定性 tick 计量(设计参考 Hull,但不依赖 Nix),实现跨平台可复现的数据生成、validator/checker 校验、对拍以及 Polygon ZIP 包导入; - Phase 4 — 训练看板与 OJ 同步(规划中):支持 Codeforces / AtCoder / QOJ 提交同步、训练统计、比赛复盘与待补题队列。
项目目前处于公开测试阶段,欢迎在实际命题与模拟赛排版场景中试用。如遇到 Bug、版式差异或有功能建议,欢迎在 GitHub Issues 提交反馈,或在评论区与交流群中讨论。