CODEXFLOW QUERYRUNTIME

QRERUNTIME

让 Agent 执行，
可控、可追溯。

从模型循环到工具执行，把策略、审计与回放放进同一条运行链路。

跨平台 .NET Agent 运行时与轻量级 CLI。既能嵌入你的应用，也能独立运行，让每一次工具调用有边界，让每一步执行留下依据。

查看运行链路阅读开发文档

ONE CONTROLLED LOOP架构示意

INPUT任务 · 上下文 · 执行预算

QREAGENT RUNTIME

模型循环Session / Turn / Step

生成请求

策略与审批检查Profile · Policy · Approval

受控工具执行调用工具，返回执行结果

继续循环

执行结果回到模型上下文

结构化轨迹与检查点审计 · 离线回放 · 条件化恢复

TRACE

仅说明运行结构，不连接模型或真实任务

PLATFORM.NET 10

INTEGRATIONNuGet + CLI

ARCHITECTUREV2 运行时

LICENSEMIT 开源

BUILD BEYOND THE DEMO

把“能运行”，
推进到“能掌握”

当 Agent 开始读文件、运行命令、修改工作区，开发者需要掌握的不只是答案，还有执行权限、过程证据与问题复现。

01 / CONTROL

执行前，检查边界

按工具分区与策略检查调用权限。需要风险批准的操作，缺少明确授权时拒绝执行；同时约束步数、Token 与执行预算。

none / readonly / verify / repair

02 / EVIDENCE

执行中，留下依据

将模型交互、工具调用与状态变化组织为结构化事件。结合运行轨迹、文件差异与出站诊断，定位问题发生在哪个环节。

Trace / Diff / Diagnostics

03 / REPLAY

执行后，离线核对

对保留完整数据的记录执行严格回放，核验历史状态转移。回放不调用模型，也不重新执行工具，不产生新的模型 Token 消耗。

Strict Replay / replay_digest

INSIDE THE RUNTIME

一条链路，
四个可检查的环节

选择一个环节，了解任务如何进入运行时，以及执行过程如何被记录。

交互流程示意，不是实时控制台，也不会执行命令

TASK & CONTEXT

先明确，任务在什么边界内运行

宿主应用或 qre CLI 提供任务、工作区、模型配置与运行预算。运行时用统一的 Session、Turn 与 Step 结构组织后续交互。

这一环节明确输入、上下文与资源边界

执行结构示意内容

任务输入目标与上下文
工作空间选定工作区
运行限制步数与 Token 预算

真实模型、工具与配置由集成方提供

ONE RUNTIME. TWO WAYS IN.

嵌入应用，
或从命令行开始

QRE 可以独立于 CodexFlow Web 平台使用。为已有 .NET 应用提供运行基础，也为本地开发与自动化验证提供命令行入口。

STANDALONE CLI

一个 qre，连接运行与调试

通过独立 CLI 执行任务、检查策略、查看轨迹和工作区差异。支持 Native AOT 发布为自包含原生程序。

已安装 qre 后 · 命令示例

qre --version
qre trace latest --workspace . --json
qre replay latest --workspace . --strict --json

查看 CLI 上手指南

EMBEDDED IN .NET

让运行时成为应用的一部分

通过 NuGet 包集成协议契约、V2 运行时和模型适配层。宿主应用保留自己的产品界面、业务逻辑与治理策略。

Protocol会话、事件与工具契约

Engine.V2Agent 循环与执行流水线

Models模型适配与出站诊断

查看 .NET 集成指南

MODELS

接入模型

OpenAI-compatible、vLLM 与 Anthropic Messages 等接口适配

TOOLS

扩展工具

内置工具与外部 Stdio / MCP 适配；支持动态工具检索

SKILLS

组织工作流

以 Skill 承载领域说明与工作流程，并按需加载上下文

CLEAR BY DESIGN

能力与边界，
一起说清楚

可靠集成，从理解运行条件开始。

离线回放，依赖完整的已记录数据

Strict Replay 使用历史数据核验执行轨迹，不会重新调用模型或工具。默认 public 脱敏轨迹并不等于完整回放数据；需要使用适合严格回放的保真记录。重新执行任务应使用 rerun，二者用途不同。

恢复到稳定检查点，有明确前提

H1 面向同版本、单机本地的稳定检查点恢复，并校验工作区、策略、工具与配置一致性。公开脱敏模式不保留恢复检查点。若工具已发出但结果不确定，运行时会停在待核对状态，不承诺任意中断都能无损续跑。

本地执行器，不是强安全隔离边界

LocalProcess 用于受信任的本地环境。需要容器隔离时可选择 Docker，并配置只读挂载、选择性写回与网络限制；具体保障取决于宿主环境、镜像和网络驱动配置。

PART OF THE CODEXFLOW ECOSYSTEM

运行基础与业务产品，
各有清晰分工

QRE 面向开发者，关注 Agent 的运行与执行治理。IA.Engine、RuleMaker 与图谱知识库面向智能审查，分别承接审查执行、规则生产与知识组织。

探索智能审查生态IA.Engine RuleMaker · 图谱知识库

BUILD WITH CONTROL

下一步，让 Agent
进入你的工程。

在 GitHub 查看 QRE

能力说明基于 v0.23.2 / V2 文档
具体 API 与使用条件，以项目文档为准

让 Agent 执行，可控、可追溯。

把“能运行”，推进到“能掌握”