Context Assembly

Context assembly 主要位于 internal/context、internal/references 和 gateway runtime glue。它为 loop 准备 bounded、inspectable input。

上下文来源

Sources 包括 product/runtime prompts、role identity、memories、active skill content、skill index、 recent messages、session inbox、surface metadata、toolset capabilities 和 expanded references。

每个 source 都应有明确 budget 和 metadata entry。

References

@file、folder、git、URL 和 tool-result references 会在渲染前 parse 与 expand。Expansion 可以返回 warnings，而不是让整轮失败。

Reference output 包含 citation metadata，让 surfaces 和 logs 能识别被包含的内容。

Workspace 文件

Workspace 和 profile files 是 context 与 artifact storage，不是 permission boundary。File reference expansion 会阻止 sensitive paths、unsafe traversal 和 oversized selections。

Prompt code 应使用 reference loaders，不要做 ad hoc path reads。

压缩输入

Compression 和 summary material 与 active prompt 分离。State maintenance 创建 summaries；context assembly 选择当前 turn 需要的 compact material。

不要在 context code 中删除或 prune raw history。

安全过滤

Context assembly 会 sanitize metadata，并把 external/user-provided material 视为 data。它不应依赖模型来隐藏 secrets。

Secrets 必须在 logs、debug bundles、snapshots 或 model-visible context 之前 redacted。