CPForge CLI 完整命令清单:launch、doctor、next、review、upsolve 等 20+ 命令全解
CPForge CLI 完整命令清单:launch、doctor、next、review、upsolve 等 20+ 命令全解
CPForge(CP Forge)是一款本地优先的算法训练操作系统,用一条命令即可生成个性化每日计划、弱点专题、间隔复习队列和错误日志。它的 CLI 命令行工具 cp-forge 提供 29 个顶级命令(含 bank 子命令共 30+),覆盖 launch 一键启动、doctor 训练诊断、next 智能推荐、review 间隔复习、upsolve 重刷队列等核心场景。本文按使用场景分组,全解每一个命令的参数与典型用法,并附一张速查表 📋。
一分钟安装 cp-forge 命令行工具
先克隆仓库并运行一键安装脚本(要求 Node.js 20+,脚本会自动准备 pnpm 并构建 CLI):
git clone https://gitcode.com/gh_mirrors/cp/CPForge
cd CPForge
./scripts/install.sh # Windows 用户改用 ./scripts/install.ps1
安装脚本会把 cp-forge 可执行文件链接到 ~/.local/bin。验证成功只需运行:
cp-forge doctor # 首次运行会自动创建 .cpforge 工作区并给出诊断
cp-forge <命令> --help # 查看任意命令的参数说明
所有数据都保存在当前目录的 .cpforge/ 文件夹中,100% 本地、无需注册账号,可随时导出或删除。安装与命令设计的权威说明见 scripts/install.sh 与 docs/cli-design.md。
上手三件套:init / launch / today
这三条命令决定了你每天怎么用 CPForge CLI,建议按顺序各跑一次。
| 命令 | 作用 | 典型用法 |
|---|---|---|
init |
创建本地 .cpforge 工作区 |
cp-forge init --cf handle --leetcode handle --goal cp --days 45 |
launch |
一键启动:同步公开平台数据、生成路线图/复习计划/各种导出,并给出下一步动作 | cp-forge launch --goal amazon --days 45 --offline |
today |
显示今日训练计划(热身、主练、复习、重刷、复盘) | cp-forge today |
launch 是最"重"的命令:它会根据 --goal(如 cp、dsa、amazon)生成 45 天计划,并在 .cpforge/exports/ 下一次性导出 CSV、Markdown、Notion、Obsidian 笔记、reviews.ics 复习日历、mindmap.html 交互脑图、dashboard-data.json 仪表板数据等十余个文件。加上 --offline 可跳过所有网络请求。
💡 官方推荐的 60 秒体验路线正是
launch → today → doctor → next四条命令,完整脚本见 scripts/terminal-demo.sh,简介见 README.md。
每日训练循环:next、doctor、review、mistakes、stuck
这一组命令构成"练 → 诊 → 复习 → 记错"的每日闭环,是 CPForge CLI 的核心价值所在。
next:下一步该刷哪道题
cp-forge next 不只告诉你做什么,还会解释为什么(Why this)并给出时间估算:
cp-forge next # 推荐下一个题目/行动,附优先级与理由
cp-forge next --time 30 # 只有 30 分钟时的推荐
cp-forge next --weak-only # 强制推荐你的弱点专题
doctor:规则化训练诊断 + 处方
cp-forge doctor 基于本地数据做确定性诊断,输出"诊断 + 处方":卡点原因、待重刷题数、未解决题阻塞分析,以及一套标准处方(停 14 天随机刷题、集中打 3 个最弱专题、本周重刷失败题、按 1/3/7/14/30 天间隔复习、跑 2 场虚拟赛、每次 WA 后记一条错误)。
review:间隔复习队列
基于 1、3、7、14、30 天间隔重复算法调度已解出的题:
cp-forge review today # 今日到期(默认 scope 即 today)
cp-forge review upcoming # 即将到期
cp-forge review overdue # 已逾期
cp-forge review completed # 已完成
cp-forge review complete <id> # 标记某条复习完成
mistakes:错误银行
把"同一个 off-by-one 调 6 个月"变成结构化数据。mistakes add 记录错误(--category 可选 missed edge case 等 8 类,见 datasets/mistake-categories.json),不带参数运行则输出 JSON 统计:
cp-forge mistakes add --problem leetcode-two-sum --category missed\ edge\ case --fix "检查边界"
cp-forge mistakes stats
stuck:为什么感觉卡住了
cp-forge stuck 用规则引擎解释"进步停滞"的具体原因(如复习积压、重刷队列空转等),是 doctor 的轻量版。
规划与练题:upsolve、roadmap、sheet、mindmap
upsolve:失败题重刷队列
比赛挂了、AC 了但很挣扎的题都该进这个队列,priority 会按优先级排序输出:
cp-forge upsolve list # 查看重刷队列(默认)
cp-forge upsolve priority # 按优先级排序
cp-forge upsolve add <problemId> # 手动加入
cp-forge upsolve done <problemId> # 标记重刷完成
roadmap:个性化路线图
cp-forge roadmap --goal dsa --days 45 --format markdown
cp-forge roadmap --company google --target-rating 1800
支持 --goal(dsa/cp/interview/placement/icpc)、--company、--target-rating 等参数,输出含专题顺序与每周里程碑。仓库内置的路线图文档可在 roadmaps/ 目录查看,如 roadmaps/dsa/roadmap.json。
sheet:万能练题清单
基于 1700+ 精选面试题库(并可扩展 1 万+ Codeforces 题)过滤生成练题清单:
cp-forge sheet --company amazon --limit 50 --format csv
cp-forge sheet --topic arrays --pattern sliding-window
cp-forge sheet --weak-only # 只出弱点专题题
cp-forge sheet --cp-level 1200-1500 # 按 Codeforces 分数段过滤
输出格式支持 csv / markdown / json / notion / obsidian / sheets。仓库自带的大量现成题单见 sheets/ 目录。
mindmap:交互式技能树
cp-forge mindmap --goal dsa --export html # 生成交互式 HTML 脑图
cp-forge mindmap --goal cp --interactive
底层数据来自 datasets/roadmap-graph.json。
数据同步与导入导出:sync、import、export、bank
sync:同步公开平台数据
cp-forge sync --cf handle --leetcode handle
cp-forge sync --all # 同步所有已配置账号
cp-forge sync --offline # 仅校验本地缓存/工作区
支持 Codeforces、LeetCode、AtCoder、CodeChef 四个平台,仅使用公开接口并带本地缓存,详见 docs/local-first-design.md。
import / export:数据进出
cp-forge import my-workspace.json # 导入 JSON 工作区
cp-forge import custom.csv # 导入自定义 CSV 题目
cp-forge export --format markdown # 也支持 notion / obsidian / calendar / json / html / sqlite
--format sqlite 可把整个工作区导出为 SQL dump,方便二次分析。
bank:题目目录刷新
bank 是唯一带子命令的组命令:
cp-forge bank refresh # 拉取最新 Codeforces + LeetCode 题目到 .cpforge/cache/
cp-forge bank refresh --cf # 只刷新 Codeforces
cp-forge bank status # 查看缓存上次刷新时间
cp-forge bank new # 查看上次刷新后新增的题目
仓库内置的题目缓存见 datasets/cf-problemset-cache.json,机制说明见 docs/problem-feeds.md。
进阶玩法:contest、team、pack、rate 等
| 命令 | 作用 | 典型用法 |
|---|---|---|
contest |
生成虚拟竞赛练习块;可查近期比赛与自己的排名 | cp-forge contest --rating 1400、--upcoming、--standings 2000 |
team |
团队训练工作区(无需后端) | cp-forge team init、team sheet --icpc、team report |
pack |
安装社区题库包(blind-75、neetcode-150、amazon-45 等) | cp-forge pack list、pack add blind-75 |
rate |
给个人题库中的题打质量分(1–5 星) | cp-forge rate leetcode-two-sum --stars 5 |
flashcards |
从错误库导出 Anki 兼容卡片 | cp-forge flashcards --format anki |
notebook |
生成本地 CP 模板笔记本(math/graphs/dp 等分节) | cp-forge notebook --lang cpp --style icpc |
portfolio |
生成 GitHub README 训练档案 / HTML 作品集 | cp-forge portfolio --github-readme --html |
profile-card |
生成 GitHub 个人卡片 SVG | cp-forge profile-card |
chart |
生成 6 类统计图表(progress、weakness、company-readiness 等) | cp-forge chart --type weakness --export svg |
dashboard |
导出 Web 仪表板数据 | cp-forge dashboard |
extension-import |
合并 Chrome 插件导出的做题记录 | cp-forge extension-import sync.json |
stuck |
解释进步停滞原因 | cp-forge stuck |
reset |
删除全部本地 .cpforge 数据(需 --yes 确认) |
cp-forge reset --yes |
全部命令速查表
| # | 命令 | 一句话说明 |
|---|---|---|
| 1 | init |
创建本地 .cpforge 工作区 |
| 2 | launch |
一键引导:同步 + 计划 + 导出 + 下一步 |
| 3 | sync |
同步 CF/LC/AtCoder/CodeChef 公开数据 |
| 4 | roadmap |
生成个性化路线图 |
| 5 | sheet |
按专题/模式/公司过滤生成练题清单 |
| 6 | doctor |
训练诊断 + 处方 |
| 7 | next |
推荐下一题,附理由与时间估算 |
| 8 | review |
间隔复习队列(today/upcoming/overdue/complete) |
| 9 | upsolve |
失败题重刷队列(list/add/done) |
| 10 | mistakes |
错误银行(add/stats) |
| 11 | contest |
虚拟竞赛 / 近期比赛 / 赛况查询 |
| 12 | mindmap |
生成交互式路线图脑图 |
| 13 | chart |
进度/弱点/公司准备度等图表 |
| 14 | export |
多格式导出(sheets/notion/obsidian/sqlite…) |
| 15 | import |
导入 JSON 工作区或自定义 CSV |
| 16 | portfolio |
GitHub README / HTML 训练档案 |
| 17 | extension-import |
导入浏览器插件做题记录 |
| 18 | today |
今日训练计划(热身/主练/复习/复盘) |
| 19 | stuck |
解释进度为何停滞 |
| 20 | flashcards |
导出 Anki 闪卡 |
| 21 | notebook |
生成本地 CP 模板笔记本 |
| 22 | pack |
安装/列出社区题库包 |
| 23 | team |
团队训练工作区(init/sheet/report) |
| 24 | profile-card |
GitHub 个人卡片 SVG |
| 25 | rate |
给题目打 1–5 星质量分 |
| 26 | bank |
题目目录管理(refresh/status/new) |
| 27 | dashboard |
导出 Web 仪表板数据 |
| 28 | reset |
删除本地数据(--yes 确认) |
任何命令都可加 --help 查看完整参数,例如 cp-forge launch --help。
常用参数速查
--goal <目标>:cp/dsa/interview/ 公司名(如amazon)--days <天数>:备考时间线,默认 45 天--language <语言>:cpp/python/java,默认cpp--offline:跳过所有网络请求--format <格式>:markdown/csv/json/notion/obsidian/sheets/calendar/sqlite--limit <数量>:导出题目上限,默认 200
小结与延伸阅读
CPForge CLI 的设计哲学是规则化、可解释、本地化:每条推荐都会说明理由,所有数据都在你手里。建议的起步路线:launch 建立工作区 → 每天 today + next → 每周 doctor 复查 → 用 review / upsolve 保持记忆曲线。
更多资料:
- CLI 设计文档:docs/cli-design.md
- 架构总览:docs/architecture.md
- 题目源与自动更新机制:docs/problem-feeds.md
- 端到端演示脚本:scripts/terminal-demo.sh
- CLI 源码入口:apps/cli/src/index.ts
- 完整命令演示:README.md