XRT API 参考手册

94 个内核参考模块 · 14 个扩展库 · 6,833 条目录参考条目

内核模块（3143 条参考 / 94 个模块）

基础层（487 条参考 / 21 个模块）

core

版本、ABI、模块查询

features

0

features.h

模块编译开关映射（自动生成，无 API）

error

结构化错误对象与原因链

error_format

错误格式化输出

memory

堆分配收口与分配器替换

memory_debug

分配故障注入与泄漏检测

memory_stats

进程级内存统计

temp

零分配 arena 临时内存

string

字符串操作全集

regex

正则表达式（编译、匹配、替换、集合）

pattern

结构化模式匹配（{name} 捕获）

charset

字符集与 Unicode 转换

number

数值解析与格式化

html

HTML 实体编解码

template

类型化模板

codec

Hex / Base64 / Percent 编解码

compress

Deflate / Inflate 压缩

math

数学工具

hash

哈希函数

random

PCG32 与密码安全随机

xid

分布式唯一标识

容器（434 条参考 / 10 个模块）

array

动态数组与指针数组

list

双向链表

buffer

分段缓冲区

slot_map

稳定下标槽映射

avl

AVL 平衡树

map

哈希映射与整数映射

set

哈希集合与集合运算

stack

栈族五件套

queue

SPSC/MPSC/MPMC 无锁队列

pool

对象池与变长内存池

数据层（233 条参考 / 5 个模块）

value

xvalue 动态值与 COW 容器

json

JSON 解析与序列化

xlon

XLang 对象表示格式

jsonl

JSON Lines 逐行读写

xlonl

XLON Lines 逐行读写

并发层（328 条参考 / 13 个模块）

atomic

原子操作

spin

自旋锁

sync

互斥量/条件/信号量/读写锁/事件

thread

线程与 TLS

wait

等待原语

cancel

协作取消

coroutine

有栈协程与调度器

channel

Go 风格通道与 Select

future

Future / Promise 与组合子

future_bridge

future_bridge.h

Future 桥接

executor

执行器抽象

task

任务池与任务组

signal

跨平台信号处理

文件与系统（442 条参考 / 10 个模块）

file

文件读写、映射、锁、原子写

vfs

虚拟文件系统

file_async

异步文件 I/O

path

路径解析与操作

io

Reader / Writer 抽象

console

控制台输出

environment

环境变量

process

进程创建与管理

logger

日志系统

time

时间与时区

安全层（245 条参考 / 4 个模块）

asn1

ASN.1 / DER 编解码

crypto

AES-GCM、ChaCha20、SHA、Ed25519、RSA

pem

PEM 编解码

x509

证书解析、路径验证、CRL

TLS（268 条参考 / 8 个模块）

tls

自研 TLS 1.2/1.3 协议栈

tls_client

TLS 客户端配置

tls_server

TLS 服务端配置

tls_session

TLS 会话管理

tls_stream

TLS 流层

tls_resume

会话恢复

tls_identity

TLS 身份

tls_verify

TLS 验证

网络层（377 条参考 / 9 个模块）

net

地址、引擎、Worker、缓冲池、端口

tcp

TCP 流

tcp_server

TCP 服务端

udp

UDP 数据报

net_file

网络文件传输

net_frame

帧层

net_interface

net_interface.h

网络接口查询

proxy

代理配置

task_net

网络任务

Web 协议层（253 条参考 / 14 个模块）

http

HTTP 语义原语

http1

HTTP/1.1 解析与编码

http1_net

HTTP/1.1 网络绑定

http1_tls

HTTP/1.1 TLS 绑定

http_connection

http_connection.h

HTTP 连接管理

http_decode

HTTP 解码器

http_encoding

http_encoding.h

HTTP 编码

http_expect

Expect 头

http_te

Transfer-Encoding

http_trailer

HTTP Trailer

http_upgrade

HTTP Upgrade

websocket

WebSocket 帧协议

websocket_stream

websocket_stream.h

WebSocket 流

websocket_upgrade

websocket_upgrade.h

WebSocket 升级

扩展库（2,846 条参考 / 14 库）

xhttp

70 个参考模块

HTTP 客户端与服务端

xssh

65 个参考模块

SSH2 协议原语与客户端运行时

xacme

14 个参考模块

ACME 证书申请与管理。五家云 DNS provider、EAB、传播确认与一站式 Obtain，自动化 Let's Encrypt 签发。

xjwt

JWT/JWS 签发与验证。HS/RS/ES 三族算法与 JWKS 公钥集，按 kid 自动选钥。

xoauth2

OAuth2 客户端与 OIDC 应用组合。授权码、PKCE、令牌刷新与 introspection。

xllm

单次模型调用、流式响应与提供方适配。OpenAI 兼容/Anthropic/Responses 三方言，传输重试与用量统计。

xllm-session

会话账本、预算、压缩与持久化。上下文预算、轮次滑窗与 JSONL 存档恢复。

xwork

Agent 循环、工具执行与审批。有界工具循环、子代理委派与统一任务系统。

xruntime

17 个参考模块

动态类型与对象系统

xmail

16 个参考模块

邮件 MIME 与传输基座

xsmtp

4 个参考模块

SMTP 邮件客户端

xpop3

4 个参考模块

POP3 邮件客户端

ximap

9 个参考模块

IMAP 邮件客户端

xws

5 个参考模块

WebSocket 运行时

命名约定与错误模型

全库统一约定：函数 xrt + 模块前缀 + PascalCase（如 xrtHttp1RequestParse）；类型小写 x 前缀（xnetstream、xhttpcall）；常量全大写。头文件按 XRT_MODULE_* / XHTTP_MODULE_* 宏裁剪，依赖断言以 #error 强制。

错误处理是四层模型：解析层返回带偏移的错误结构（xhttp1errorinfo）；网络层用结果码 xnetresult 区分错误与控制流（AGAIN / CLOSED / TIMEOUT / CANCELLED）；运行时层走线程级结构化错误 xrtGetError / xrtSetError（带域、操作名与原因链 xrtErrorWrap）；异步层用 xwaitresult。

最权威的参考永远是头文件本身（全中文注释、按模块裁剪、依赖断言齐全）：

内核：include/xrt/*.h（94 个），伞头 include/xrt.h；单头产物 single/xrt.h。
扩展库：各 extlibs/<产品>/include/，门面头 <xhttp.h> / <xws.h> / <xruntime.h> / <xmail.h> / <xssh.h>。
生成的 API 索引：各产品 docs/api/reference.md（由 tools/generate_api_reference.py 从模块清单生成，随构建再生）。

当前参考面向 XRT 2.0.0-dev。按模块组织接口，结合头文件注释与仓库示例阅读，可以更快建立完整的调用流程。