CPForge CLI 完整命令清单:launch、doctor、next、review、upsolve 等 20+ 命令全解

原创2026-11-14 11:41:021,867 阅读

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 保持记忆曲线。

更多资料:

登录后查看全文
CPForge