OCTX

Open Context

让上下文成为可以传播的资产。

将完整 Markdown、Chunk、Event、Entity、关系和向量封装为一个开放、可验证、可移植的上下文 Package。一次生成，在任何兼容的知识系统与 Agent 中复用。

阅读文档查看 v0.1 规范

OKF compatible Self-contained Vendor-neutral

基础架构

统一的上下文格式，连接知识资产与智能应用。

OCTX 作为标准化交换层，将可传播的知识资产交付给知识库系统；知识库完成导入与检索，Agent 将召回结果注入运行上下文，最终支持人的知识获取与决策。

OPEN CONTEXT / REFERENCE ARCHITECTURE 知识流向

交互层

人

以自然语言提出问题，通过 Agent 获取经过知识支撑的答案。

OUTCOME知识与决策

智能应用层

Agent

自动检索知识库，把召回结果写入当前上下文后完成回答。

RUNTIME上下文注入

知识系统层

知识库程序

例如 SAG，读取 OCTX，将知识写入数据库并建立检索索引。

SYSTEM导入 · 索引 · 检索

资产与交换层

OCTX 文件

携带 Markdown、Chunk、Event、Entity、关系和可选向量的开放上下文资产。

FORMAT封装 · 校验 · 传播

一个文件，不只是一个文档

知识正文、结构和证据链，保持在一起。

`.octx` 是一份不可变的完整快照。展开后仍是清晰、开放、可逐项校验的目录，而不是某个数据库的私有备份。

research-context.octxZIP / ZIP64

manifest.jsonAsset identity · Release · Package Digestsha256:9bd4…e31a

knowledge/Markdown + YAML frontmatter

index.mdconcepts/*.md

data/Portable semantic records

chunks.jsonlevents.jsonlentities.jsonl

relations/Explicit evidence chain

chunk-events.jsonlevent-entities.jsonl

vectors/Optional, rebuildable acceleration

config.json*.arrow

Document→Chunk→Event→Entity

为什么需要 Open Context

文档会传播，提取后的上下文也应该传播。

今天，一份文档进入知识系统后，会被切分、抽取、关联和向量化。这些高成本成果通常只存在于某个数据库里。文件离开系统，结构就消失了。

Open Context 把这些成果提升为独立资产。生产者可以发布，接收者可以检查、安装、升级和追溯，Agent 则可以直接进入正常检索路径。

开放标准的边界

保留知识本身，隐藏具体实现。

人和 Agent 都能读

OCTX 直接采用 OKF 兼容 Markdown。没有专用 SDK，也能打开、审阅和版本控制。

身份与内容分开

UUIDv7 保持对象身份，Package Digest 锁定精确内容，Release 负责版本演进。

结构随知识一起走

Chunk、Event、Entity、关系和向量可以随包传播，不必在每个系统重复抽取。

可复用，也可重建

向量和本地索引是加速层。兼容就复用，不兼容就从可信上游完整重建。

从创建到召回

同一个 Package，连接生产者与消费者。

Markdown / OKF→ Create→ .octx→ Validate→ Import / Index→ Retrieve

开始构建

创建、打开、校验，然后导入。

通用 octx 包负责创建、打开与校验；以 SAG 为例， zleap-sag 可以把 .octx 导入检索系统，也可以将系统中的上下文导出为 .octx。

01创建与校验独立 octx 包

from octx import create_octx, open_octx, validate_octx

release = create_octx(
    source="./knowledge",
    workspace="./my-context",
    name="SAG Technical Research",
    output="research-context.octx",
)

with open_octx("research-context.octx") as package:
    report = validate_octx(package)
    assert report.valid

02导入 OCTXzleap-sag adapter

from zleap_sag import import_octx

installation = import_octx("research-context.octx")

# Documents are available immediately.
# Missing local indexes continue in the background.
print(installation.status)  # installed | indexing | ready

渐进采用

从可读文档，到可直接导入的完整上下文。

层级	Markdown	稳定身份 / Release	Chunk / Event / Entity	向量	用途
OKF Bundle	✓	—	—	—	人和 Agent 可读
OCTX	✓	✓	可选	可选	可传播、可校验
SAG-Structured	✓	✓	完整且无孤立记录	可选	直接导入结构层

OPEN BY DESIGN

上下文不应该被锁在一个数据库里。

从 Open Context v0.1 开始，创建第一份可传播的上下文资产。

阅读规范