7个步骤掌握Competitive Companion：编程竞赛自动解析工具终极指南

Competitive Companion是一款强大的浏览器扩展，专为编程竞赛爱好者设计，能够自动解析50+主流在线评测平台的题目信息，包括题目描述、输入输出样例和时间内存限制，让你专注于算法思考而非繁琐的数据录入。

副标题：零基础入门编程竞赛自动解析工具，从安装到高效使用的完整教程

一、什么是Competitive Companion？

Competitive Companion是一款开源的浏览器扩展，通过智能解析技术，帮助编程竞赛选手自动提取各类在线评测平台的题目信息，并以标准化格式发送到本地编程工具。它支持Codeforces、AtCoder、洛谷等50+主流平台，是提升竞赛准备效率的必备工具。

二、快速安装指南

1. 获取项目文件

git clone https://gitcode.com/gh_mirrors/co/competitive-companion

2. 浏览器安装步骤

• Chrome/Edge用户：访问扩展管理页面（chrome://extensions/），启用"开发者模式"，点击"加载已解压的扩展程序"，选择项目中的src文件夹
• Firefox用户：访问调试页面（about:debugging#/runtime/this-firefox），点击"临时载入附加组件"，选择项目中的manifest.json文件

图：Competitive Companion扩展安装界面，展示了扩展的主标志和名称

三、基础配置与使用

1. 首次配置

安装完成后，点击浏览器工具栏中的扩展图标，进入设置界面：

• 选择你的编程工具（如CP Editor、VS Code等）
• 设置数据接收端口（默认10045，通常无需修改）
• 自定义题目数据格式（高级选项）

2. 基本使用方法

• 自动解析：打开支持的题目页面时自动解析
• 手动触发：使用快捷键Alt+Shift+C手动解析当前页面
• 查看历史：使用快捷键Alt+Shift+V查看已解析的题目记录

四、核心功能解析

1. 智能解析系统

Competitive Companion通过src/parsers/目录下的专业解析器，识别不同平台的页面结构，提取结构化数据。每个解析器都针对特定平台优化，确保数据准确性。

2. 数据处理流程

1. 页面加载时，扩展自动检测是否为支持的评测平台
2. 调用对应平台的解析器（如src/parsers/problem/CodeforcesProblemParser.ts）
3. 提取题目描述、输入输出样例、时间内存限制等信息
4. 转换为标准化JSON格式（定义在src/models/Sendable.ts）
5. 发送到本地配置的编程工具

图：Competitive Companion功能架构展示，体现其解析和数据处理流程

五、实用技巧与最佳实践

1. 提高效率的小技巧

• 快捷键熟练使用：记住Alt+Shift+C（解析）和Alt+Shift+V（历史）
• 自定义数据格式：根据个人习惯修改src/models/Sendable.ts调整输出格式
• 定期更新：每月执行git pull获取最新平台支持

2. 常见问题解决

• 解析失败：检查是否为最新版本，或尝试手动触发解析
• 工具连接问题：确认本地编程工具已启动并监听正确端口
• 特殊格式题目：可在tests/data/目录下查看测试样例，了解解析规则

六、安全性与隐私保护

作为开源项目，Competitive Companion所有数据处理都在本地完成，不会上传任何用户信息。你可以在src/parsers/目录下查看各平台的解析逻辑，确保透明可信。

七、进阶使用：自定义解析器开发

如果你常用的平台不在支持列表中，可以通过以下步骤添加自定义解析器：

1. 在src/parsers/problem/目录下创建新的解析器文件
2. 继承ProblemParser基类，实现parse方法
3. 在src/parsers/parsers.ts中注册新解析器
4. 添加测试数据到tests/data/目录

图：Competitive Companion高级配置界面，展示自定义解析器设置选项

结语

Competitive Companion作为一款强大的编程竞赛辅助工具，能够显著提升你的竞赛准备效率。通过自动解析题目信息，让你专注于算法思考和代码实现，从而在竞赛中脱颖而出。立即开始使用，体验高效编程竞赛准备的新方式！

---

提示：定期更新项目以获取最新的平台支持和功能优化，保持竞争力！