会话与记忆
了解 q 如何跨工作区运行保存、压缩、学习和恢复状态。
持久会话
每个工作区都可以在 .q/sessions/ 下保存多个基于 UUID 的会话。启动时的选择器会显示会话标题与近期活动。
一个进程占用一个选定会话。另一个 q 进程可以在同一工作区打开不同会话,但会话锁不会串行化对仓库文件的编辑。
记录与上下文
q 将用户可见的完整记录与发给模型的压缩请求上下文分别保存。如果具备上下文元数据,q 可以缩短模型上下文,同时保留完整的用户可见记录。
主要会话记录为:
.q/sessions/<uuid>/session.json
获批计划的执行还会在旁边写入可恢复的 plan-execution.json。
Workspace Memory
Workspace Memory 保存持久消息、工具活动、失败记录、生命周期事件与搜索索引。检索历史时,无须在单一聊天视图中承载每一条事件。
大型工具结果作为不可变 Loom 产物保存。提示中只放入有长度限制的收据,模型之后可以仅检查相关片段。
学习
成功完成轮次后,Thinker 可以提取可复用的命题:已确立的工作流、持久的项目事实、可复用的解决办法,以及可能影响未来工作的有依据发现。
Librarian 决定在全局 Library 中创建、合并还是丢弃命题。/learn off 会停止收集和处理队列,但不会删除已入队的数据。
某次运行特有的构建、测试、格式化和审计快照保留在任务历史中,不会变成持久项目事实。