会话与记忆

了解 q 如何跨工作区运行保存、压缩、学习和恢复状态。

查看 Markdown

持久会话

每个工作区都可以在 .q/sessions/ 下保存多个基于 UUID 的会话。启动时的选择器会显示会话标题与近期活动。

一个进程占用一个选定会话。另一个 q 进程可以在同一工作区打开不同会话,但会话锁不会串行化对仓库文件的编辑。

记录与上下文

q 将用户可见的完整记录与发给模型的压缩请求上下文分别保存。如果具备上下文元数据,q 可以缩短模型上下文,同时保留完整的用户可见记录。

主要会话记录为:

text
.q/sessions/<uuid>/session.json

获批计划的执行还会在旁边写入可恢复的 plan-execution.json

Workspace Memory

Workspace Memory 保存持久消息、工具活动、失败记录、生命周期事件与搜索索引。检索历史时,无须在单一聊天视图中承载每一条事件。

大型工具结果作为不可变 Loom 产物保存。提示中只放入有长度限制的收据,模型之后可以仅检查相关片段。

学习

成功完成轮次后,Thinker 可以提取可复用的命题:已确立的工作流、持久的项目事实、可复用的解决办法,以及可能影响未来工作的有依据发现。

Librarian 决定在全局 Library 中创建、合并还是丢弃命题。/learn off 会停止收集和处理队列,但不会删除已入队的数据。

某次运行特有的构建、测试、格式化和审计快照保留在任务历史中,不会变成持久项目事实。