> For the complete documentation index, see [llms.txt](https://tinyhumans.gitbook.io/openhuman/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://tinyhumans.gitbook.io/openhuman/zh/gong-neng/super-context.md).

# 超级上下文

新的聊天不应从冷启动开始。 **SuperContext** 让代理收集相关背景信息 *之前* 它会读取你的第一条消息。它会自动在每个新线程中发生，无需你提出要求，也无需等待工具调用。

大多数代理会从空白处开始对话，只有当模型决定调用“查找信息”工具时才获取上下文。那会增加一次往返、消耗 token，并且取决于模型是否做出正确选择。SuperContext 则反其道而行之：运行框架本身会在前期以确定性的方式准备上下文，因此第一条回复就已经知晓相关记忆、文件和已连接的数据。

***

## 工作原理

在 **新线程的第一轮**中，如果启用了 SuperContext，运行框架会：

1. 启动一个只读的 `context_scout` 子代理。
2. 侦察代理会扫描你可用的数据（ [记忆树](/openhuman/zh/gong-neng/obsidian-wiki/memory-tree.md)、工作区文件以及已连接的集成），并组装一个有边界的 **上下文包**.
3. 该包会先经过验证，然后在你的消息前添加一个 `已准备的上下文（super context）` 头部字段，然后编排模型才会看到这一轮。
4. 模型在该上下文的基础上回答你的消息。

```
新线程，第一条消息
        │
        ▼
┌──────────────────────────────┐
│  运行框架门控（确定性）        │
│  super_context_enabled?       │
└───────────────┬──────────────┘
                │ 是
                ▼
        context_scout（只读）
        扫描记忆 + 文件 + 数据
                │
                ▼
        [context_bundle] … [/context_bundle]
                │  已验证并提取
                ▼
   已追加到你的消息前 → 编排器
```

因为侦察代理是 **只读**，所以它在新线程中绝不会执行任何操作。它只会读取和总结。而且由于它是在运行框架中执行，而不是作为可选工具，因此重复的 `agent_prepare_context` 工具会在该轮被抑制，因此代理不会重复做这份工作。

侦察代理运行在 **`burst` 层级** (`hint = "burst"` → `burst-v1` （在托管后端上），这是一种廉价、高吞吐、非推理模型。该扫描是一个可容忍延迟的预检步骤，因此对于这种快速模型，原始吞吐量比更昂贵的代理/推理层级更合适。参见 [自动模型路由](/openhuman/zh/gong-neng/model-routing.md).

***

## 安全性与稳健性

侦察代理返回的结果会用 `[context_bundle] … [/context_bundle]` 标签包裹。只有方括号包裹的封装内容才会被注入。模型输出的任何周边说明文字（“当然，这是我找到的……”）都会被去掉。如果该包缺失、格式错误（未闭合、顺序颠倒或标签重复），或者为空，则该轮继续 **平稳地进行，不做增强** 而不是注入垃圾。冷启动总比损坏的启动更可取。

***

## 开启或关闭

SuperContext 是 **默认开启**.

* **从撰写器中。** 一个 **超级上下文** 切换开关会出现在新线程的聊天输入框下方。在线程创建时会读取该标志，因此切换它会影响 **新启动的线程**，而不会影响你当前所在的线程。
* **配置。** `context.super_context_enabled` （布尔值，默认 `true`).
* **环境。** `OPENHUMAN_SUPER_CONTEXT` （或者 `OPENHUMAN_CONTEXT_SUPER_CONTEXT_ENABLED`).
* **RPC。** `get_super_context_enabled()` 读取该标志； `set_super_context_enabled(value)` 设置并持久化它。

***

## 另见

* [记忆树](/openhuman/zh/gong-neng/obsidian-wiki/memory-tree.md)：侦察代理读取的主要来源。
* [从集成自动获取](/openhuman/zh/gong-neng/obsidian-wiki/auto-fetch.md)：在对话之间保持该来源为最新。
* [潜意识循环](/openhuman/zh/gong-neng/subconscious.md)：‘在你停止输入后仍持续思考’的另一面。