Skip to main content
Step Code 自动保存会话，支持恢复、分支导航、派生和导出。上下文接近模型窗口时，可通过压缩保留重要信息并继续工作。

​
启动与恢复会话

Ultracode 开关按会话保存，恢复同一会话会恢复此前状态，没有保存状态的新会话默认关闭。可通过 /ultracode status 查看。

​
在 TUI 中切换会话

会话选择器中可输入搜索词，Ctrl+S 切换排序，Ctrl+N 筛选命名会话，Ctrl+R 重命名，Ctrl+D 删除。删除前请确认是否还需要保留记录。 输入操作和权限模式见交互与任务控制。

​
会话树与派生

/tree 中使用方向键导航、Enter 选择节点、Ctrl+O 切换过滤器（默认、无工具、仅用户消息、仅带标签）、Shift+L 编辑标签。选择用户消息时，其文本可回填到输入框，修改后重发形成新分支。 切换分支时，可以为离开的分支生成摘要，供切换后的对话使用。相关选项在 [branchSummary] 中配置。
会话分支只隔离对话记录，不会撤销磁盘文件修改，也不会创建 Git 分支。需要隔离代码实验时，请另行使用 Git 分支或 worktree。摘要和后续模型请求仍可能产生用量。
项目任务示例见常见使用案例。

​
管理上下文

从 v0.1.4 起，自动压缩启用且未指定上下文模式时，默认使用 CLM（Context Language Models），由模型选择性精简较早的上下文，不覆盖原始会话日志。精简失败或效果不足时回退到原有摘要压缩；模型用量计入会话统计。 /clm reset 不撤销已经发生的原有摘要压缩。整理产生额外模型调用，用量计入会话统计。

​
上下文压缩

摘要压缩保留近期消息，并将较早内容整理为摘要。手动压缩时，可指定需要保留的信息：
自动摘要压缩的开关、预留窗口和近期消息量见配置文件。重要约定和验收结果也应记录在项目文件中。

​
导出与分享

也可以在命令行导出：
/export [file] 默认导出 HTML；使用 .jsonl 扩展名导出 JSONL。导出可能包含代码、命令输出与路径，分享前请检查。

​
导入会话

在交互界面中导入已保存的 JSONL 会话：
将文件名替换为实际会话文件。HTML 导出用于阅读，恢复会话使用 JSONL 文件。

​
搜索会话

Web 与桌面端通过 SQLite 全文索引搜索会话内容。JSONL 仍是唯一数据源，索引可随时重建；子代理会话不进入搜索。 索引的查看、重建和清空使用 step session-index status、step session-index reindex 和 step session-index clear。

​
会话存储

会话按工作目录分组保存，使用 /session 查看当前文件路径。--session-dir 指定目录，--no-session 关闭本次会话保存。完整目录与清理方法见数据路径。