首页/文章/AI

实战 05：简易 OpenCode——会话、上下文压缩与模型运行时

2026-09-01

1819 字约 7 分钟

...

学习

1、本篇任务：让长时间编码 Session 不失控

编码 Agent 的难点不是第一次回答，而是第 30 轮仍知道任务、改了哪些文件、测试为何失败，同时不把整个仓库和全部日志重复塞进模型。本篇完善 Session 生命周期、上下文构建、压缩与 Provider 路由。

2、Session 与 Turn

Session 表示持续协作空间；Turn 表示一次用户输入到 Agent 停止的运行。一个 Session 可 fork 子 Session，用于尝试另一方案而不污染主线。

Session
  ├─ Turn 1：解释认证代码
  ├─ Turn 2：提出修改计划
  ├─ Turn 3：应用 Patch + 测试失败
  └─ Turn 4：修复测试

Turn 保存起始 workspace snapshot、用户消息、Assistant/Tool Parts、模型 usage、结束原因和变更 Patch。取消只取消当前 Turn；删除 Session 需要清理消息、事件、checkpoint、worktree 和 artifacts。

3、Context Builder 的输入

每次调用模型都重新构建 context，不把数据库全部消息直接发送：

1. Harness/system 规则
2. Project rules：根 AGENTS.md + 当前文件路径上的更近规则
3. Agent/mode 规则：plan/build/reviewer
4. 当前用户消息与明确 @file 引用
5. 最近关键消息和工具摘要
6. 压缩后的旧 Session summary
7. 当前步骤需要的 diagnostics、diff、todo
8. 当前允许工具 schema

每一块记录 source、priority、estimated_tokens、version。Context manifest 写入 trace，才能回答“模型为什么没看到这个文件”。

4、文件引用与仓库发现

@path 只是一种显式引用，仍经过路径权限与大小限制。目录引用先生成树与相关文件列表，不一次读取全部。仓库初始化可扫描语言、包管理器、入口、测试配置和规则文件，生成可人工审阅的 ProjectProfile，而非长期把全仓库文本放 prompt。

type ProjectProfile = {
  languages: string[];
  packageManagers: string[];
  testSuites: Record<string, string>;
  importantPaths: string[];
  rulesFiles: { path: string; hash: string }[];
};

profile 在 Git commit 或规则文件 hash 变化时更新。

5、Token 预算算法

先为输出和工具调用预留空间，再分配输入预算：

context_window
- max_output_tokens
- tool_schema_tokens
- safety_margin
= available_input

system/权限规则不可删除；当前用户消息最高优先；最近消息、当前 diff/diagnostic 次之；旧工具原文、大日志和低相关文件最先卸载。工具结果保留摘要与 artifact ID，需要时再读取局部。

不要用字符串末尾硬截断，可能切坏 JSON、Patch 或代码。按完整 content block 选择，超过大小的 block 先专门摘要或存 artifact。

6、上下文压缩

触发条件可以是 token 达到窗口的 70% 或预计下一次调用会超预算。Compactor 生成结构化摘要：

type SessionSummary = {
  objective: string;
  confirmedFacts: string[];
  decisions: { decision: string; reason: string }[];
  filesRead: { path: string; hash: string; purpose: string }[];
  filesChanged: { path: string; patchArtifactId: string }[];
  tests: { suite: string; status: string; artifactId?: string }[];
  openQuestions: string[];
  coveredUntilMessageId: string;
};