preview.2 基础功能 · 开发版扩展 会话证据 本地日志解析

会话回看:找到这次改动的来由

工程师常见困扰:日常开发中散落在 Claude Code、Codex 和 Cursor 里的对话极易失散。当代码出现非预期变动或回归时,常常想不起关键约束究竟是在哪次会话、哪一条具体提示词或工具调用中引入的。

01
选择登记项目与智能体 Provider
在 macOS 客户端选择已登记的本地工程仓库。Vela 通过本地文件监听自动识别并关联 Claude Code(~/.claude/projects/)与 Codex(~/.codex/sessions/)生成的本地 JSONL 日志流,亦支持只读导入部分 Cursor 会话导出数据。
02
基于证据检索与状态筛选
通过顶部全局搜索框对工程会话执行快速词面检索。会话列表严格基于已读日志时间戳展示推断状态(Running、Idle、Needs Approval)。缺失存活证据时明确标为未知,不臆造实时运行探针。
03
检查真实消息与工具调用详情
点选目标会话展开完整对话时间线与工具调用事件。清晰审阅诸如 file.writebash 或环境检查的具体入参与返回输出,核对本次改动的真实根据。
04
沉淀为 Memory 或导出中立 Checkpoint
若会话中产生有价值的工程约束,可直接一键沉淀为 Candidate 状态的项目记忆,保留确切的源会话与消息索引;亦可导出包含当前 Git HEAD 与待办事项的中立 Markdown Checkpoint 文件用于模型交接。
Vela macOS 原生会话工作台界面:展示会话列表、选中会话详情及工具调用记录
实际 macOS 原生开发分支界面 (源码 commit 91d34e2) · 合成示例数据 · 未包含在 preview.2 下载包中
功能边界与已知限制
  • 开发分支界面与版本边界:截图所呈现的完整工作区、来源精准追溯及记忆提议特性基于当前源码开发分支(commit 91d34e2);0.1.0-preview.2 安装包包含基础日志接入与会话状态推断。
  • 状态为推断性质:运行状态严格由本地日志的最新写入事件推断得出,非独立系统后台守护进程探针,不能作为操作系统级实时存活性证明。
  • 有界读取策略:初始每个 provider 仅选取最多 60 个近期日志文件,读取 256 KB 尾窗及 32 KB 文件头,不提供无限制全量历史回填或原生跨 Provider 会话上下文热迁移。
  • Cursor 格式演进:Cursor 内部格式随版本频繁变动,部分未适配格式需经由 JSON 导出后导入。