企业官网建设流程全解析

cli-continues（npm 包名continues）是一款免费的 AI 编程会话管理 CLI 工具：当你在 Claude Code 里被限流、或想在 Gemini 继续写 Codex 的任务时，它可以把任意一个 AI 编程工具的会话（对话历史、文件改动、工具调用记录）完整"打包"，无缝接力到另一个工具上。它支持 16 种主流 AI 编程工具，覆盖 240 条跨工具接力路径。

本文带你用 5 个核心命令 ——list、scan、inspect、dump、rebuild—— 把会话管理玩得溜。🚀

一、快速上手：30 秒安装并运行

continues无需安装即可直接运行：

npx continues

也可以全局安装（同时获得continues和简写cont两个命令）：

npm install -g continues

⚠️ 环境要求：Node.js 22.5+（内置node:sqlite用于 OpenCode 和 Crush），并已安装至少一种受支持的 AI 编程工具。

装好后，直接敲工具名即可快速恢复该工具最近一次会话（原生化恢复，完整历史）：

continues claude # 恢复最近的 Claude Code 会话 continues codex 3 # 恢复第 3 近的 Codex 会话 continues kiro # 恢复最近的 Kiro 会话

下面是 5 个会话管理命令的完整使用清单。

二、list 命令：列出所有 AI 编程会话

list是最常用的查询命令，默认以彩色表格输出最近的会话（来源、时间、项目、标题、短 ID）：

continues list # 表格输出（默认最多 50 条） continues list --source claude # 只看 Claude Code 的会话 continues list --source claude --json # 过滤后输出 JSON，方便脚本处理 continues list --jsonl -n 10 # 输出最近 10 条的 JSONL

常用参数速查：

💡 小提示：list有别名ls，在 CI 管道里尤其好用，例如continues list --jsonl | jq '.source'。命令实现见 src/commands/list.ts。

三、scan 命令：一眼看懂会话分布统计

想快速了解"我电脑上到底有哪些会话、各工具各占多少"？用scan：

continues scan

它会扫描 16 种工具的会话目录，输出总会话数 + 按工具分组的彩色条形统计（按数量降序排列），例如一眼看出 claude 有 723 条、codex 有 72 条、cursor 有 68 条。如果索引过期或环境变化，可加参数强制重新发现：

continues scan --rebuild

扫描逻辑在 src/commands/scan.ts 中，统计口径与list、rebuild完全一致，可以放心对照。

四、inspect 命令：诊断单个会话的解析细节

怀疑某次接力"丢信息"了？inspect会跑完整个解析流水线，展示原始事件分布、内容块统计、工具调用分类、子代理分析、推理链，以及最终 Markdown 交接文档的构成与"转换效率"（原始体积 → 交接文档体积）。

continues inspect abc123 # 完整诊断视图 continues inspect abc123 --truncate 50 # 每行压缩到 50 字符的紧凑视图 continues inspect abc123 --preset full --write-md handoff.md # 同时把完整交接 Markdown 写入文件

常用参数速查：

它专为"验证提取过程中没有任何静默丢失"而设计，实现见 src/commands/inspect.ts。

五、dump 命令：批量导出会话做备份归档

需要把会话批量导出成文件（备份、分析、归档）？dump支持指定单个工具或全部工具，默认导出为 Markdown，也可导出 JSON：

continues dump all ./sessions # 导出全部会话为 Markdown continues dump claude ./sessions/claude # 只导出 Claude 的会话 continues dump all ./sessions --json # 导出为 JSON continues dump all ./sessions --preset full # 用最高 detail 档位 continues dump all ./sessions --limit 50 # 只导出前 50 条

常用参数速查：

📦 导出文件命名规则为{source}_{id}.md或{source}_{id}.json（例如claude_84a36c5d....md）。执行结束后会打印成功/失败数量、按来源统计和耗时，部分失败时退出码为 1。实现见 src/commands/dump.ts。

六、rebuild 命令：强制重建会话索引

continues会把扫描结果缓存为索引文件~/.continues/sessions.jsonl（5 分钟 TTL，自动刷新；索引机制见 src/utils/index.ts 中的INDEX_TTL）。当发现新会话没被识别、环境变量（如CLAUDE_CONFIG_DIR）变更后列表不对时，直接重建索引即可：

continues rebuild

执行后输出类似Index rebuilt with 1842 sessions，并附各工具的会话数明细。重建逻辑在 src/commands/rebuild.ts。

七、5 大命令速查表

八、进阶提示：detail 档位与全局参数

四个--preset档位控制交接文档里写多少细节（对inspect/dump生效）：

档位定义见 src/config/verbosity.ts。此外还有几个全局参数和别名值得知道：

• --verbose/--debug：打开 info / debug 级别日志
• --config <路径>：指定.continues.yml配置文件（解析顺序：--config→ 项目根.continues.yml→~/.continues/config.yml→standard）
• 别名：cont→continues、ls→list、r→resume

命令注册总入口在 src/cli.ts，完整参数说明可运行continues --help查看。

小结

日常用list找会话、scan看分布，调试解析用inspect，备份归档用dump，索引不对就rebuild—— 五个命令覆盖 AI 编程会话管理的绝大多数场景。配合continues resume <id> --in <工具>完成跨工具接力，再也不怕会话中途断档。✅

更多背景（支持的工具列表、各工具存储路径、交接文档内容说明）可参阅 README.md。