Hydro OJ插件系统深度体验：从用户到贡献者，我是如何给评测机加‘Buff’的
Hydro OJ插件系统深度体验：从用户到贡献者，我是如何给评测机加‘Buff’的
第一次接触Hydro OJ是在一场高校编程马拉松上。作为参赛选手，我惊讶地发现这个评测系统不仅能实时显示代码覆盖率，还能通过插件在排行榜上展示团队协作热度图——这种可定制化程度彻底颠覆了我对传统OJ的认知。三个月后，当我以开发者身份向社区提交第一个自定义评测插件时，才真正理解Hydro模块化设计背后的哲学：用插件生态将系统边界交给用户定义。
1. 从使用者到探索者：Hydro插件初体验
大多数用户第一次接触Hydro插件是通过主题切换功能。与静态皮肤不同，Hydro的theme插件允许深度定制：
// 示例：自定义夜间模式配色方案 Hydro.install('theme-dark', { colors: { primary: '#1e88e5', background: '#121212', 'problem-text': '#e0e0e0' }, css: '.navbar { box-shadow: 0 2px 8px rgba(0,0,0,0.3); }' });但真正让我震惊的是在线IDE插件hydrooj/vscode的实现方式。通过WebSocket与后端容器直连，它甚至支持：
- 断点调试（需配合
hydrooj/debugger插件） - 多文件项目管理
- 终端直接访问评测环境
提示：安装插件只需在终端执行
hydrooj addon add <插件名>，无需重启服务
插件系统的核心优势在于功能隔离。当我们需要禁用某个功能时，传统的OJ需要注释代码并重新部署，而Hydro只需：
hydrooj addon disable <插件名>这种设计使得系统维护和升级变得异常简单——我曾亲眼见证一个教育机构在比赛进行中临时关闭讨论区插件，而整个操作只用了10秒。
2. 深入插件开发：EventBus Hook机制解析
决定开发第一个插件是因为一场特殊比赛需求：需要根据提交次数动态调整题目分值。Hydro的插件系统基于事件总线（EventBus）设计，主要hook点包括：
| 事件类型 | 触发时机 | 典型应用场景 |
|---|---|---|
problem/submit | 提交代码时 | 提交限流、代码风格检查 |
judge/start | 评测开始时 | 动态修改评测参数 |
rank/update | 排行榜更新时 | 自定义计分规则 |
我的动态分值插件核心代码如下：
Hydro.on('problem/submit', (ctx) => { const maxSubmits = 10; const current = await db.collection('submission').countDocuments({ uid: ctx.user._id, pid: ctx.problem._id }); ctx.problem.score = Math.max( 10, 100 - Math.floor((current / maxSubmits) * 90) ); }); Hydro.on('judge/end', (ctx) => { // 记录动态分值到自定义字段 ctx.record.customScore = ctx.problem.score; });开发过程中几个关键发现：
- 热重载支持：修改插件代码后，通过
hydrooj addon reload即可生效 - 沙箱环境：插件异常不会导致主系统崩溃
- 版本兼容：Hydro保证核心API向下兼容，插件通常无需随主系统升级
注意：高频事件处理应使用
debounce优化，避免影响系统性能
3. 评测机扩展实战：支持Rust MIRI解释器
当社区有人提出需要支持Rust MIRI（内存安全检查工具）时，我意识到这需要同时修改评测机和前端插件。完整流程如下：
3.1 评测机环境配置
首先在评测机Docker镜像中添加MIRI：
FROM hydrojudge/standard:latest RUN rustup toolchain install nightly && \ rustup component add miri --toolchain nightly3.2 创建语言配置文件
在hydrooj主目录添加language/rust-miri.yaml：
compile: rustup run nightly cargo miri setup execute: rustup run nightly cargo miri run time: 2000 # 2x time limit memory: 256 # 256MB files: - Cargo.toml - src/main.rs3.3 开发前端支持插件
Hydro.install('language-rust-miri', { ProblemSettings: { languages: { 'rust-miri': { name: 'Rust (MIRI)', compile: 'cargo miri setup', execute: 'cargo miri run', hidden: false } } } });最终效果：
- 选手选择"Rust (MIRI)"语言提交时自动启用内存检查
- 评测结果中会显示内存错误的具体位置
- 比赛管理员可以设置是否允许该语言
4. 从个人项目到社区贡献：插件发布指南
当插件开发成熟后，可以提交到Hydro官方插件仓库。高质量插件通常包含：
- 完整的README.md（含截图和用例）
- TypeScript类型定义
- 单元测试（使用Hydro提供的mock环境）
- 国际化支持（至少中英文）
发布流程：
- 在GitHub创建仓库，遵循
hydrooj/<插件名>命名规范 - 添加标准目录结构：
/src # 源代码 /test # 测试用例 package.json # 必须包含"hydrooj"字段 README.md - 提交PR到 hydrooj/plugins
我的动态分值插件在合并后，被某省选赛采用作为创新评分机制。最令人惊喜的是，有其他开发者基于此插件衍生出了"动态时间限制"版本——这正是开源生态的魅力所在。