用途
omni-context-rtk 是 OmniRoute 项目中的上下文管理模块,专注于 RTK 过滤器、上下文工程规则与上下文中继(context relay)设置的配置。它通过一组 HTTP API 暴露能力,供开发者管理上下文转换流水线,并使用真实提示样本测试压缩效果。
主要能力
该模块提供以下端点:
GET /api/context/rtk/config:获取 RTK 压缩设置。PUT /api/context/rtk/config:更新 RTK 压缩设置。GET /api/context/rtk/filters:列出 RTK 过滤器并查看加载诊断。POST /api/context/rtk/import:校验或安装 RTK TOML schema v1 过滤器文件。POST /api/context/rtk/test:对文本运行 RTK 压缩预览。GET /api/context/rtk/raw-output/{id}:读取保留的脱敏 RTK 原始输出。GET /api/context/rtk/discover:上下文 › rtk › discover。GET /api/context/rtk/learn:上下文 › rtk › learn。
使用方式
所有请求需要有效的 Bearer token 或会话 cookie。可通过 POST /api/auth/login 获取令牌,或在本地开发时配置 REQUIRE_API_KEY=false。
示例请求:
curl https://localhost:20128/api/context/rtk/config \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
curl -X PUT https://localhost:20128/api/context/rtk/config \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
curl https://localhost:20128/api/context/rtk/filters \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
curl -X POST https://localhost:20128/api/context/rtk/import \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
curl -X POST https://localhost:20128/api/context/rtk/test \
-H "Authorization: Bearer $OMNIROUTE_TOKEN" \
-H "Content-Type: application/json" \
-d '{}'
curl https://localhost:20128/api/context/rtk/raw-output/{id} \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
curl https://localhost:20128/api/context/rtk/discover \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
curl https://localhost:20128/api/context/rtk/learn \
-H "Authorization: Bearer $OMNIROUTE_TOKEN"
详细的请求/响应 schema 可参考 GET /api/openapi/spec 或 docs/openapi.yaml 中的完整 OpenAPI 规范。
适用场景
- 需要配置和调整 RTK 压缩参数以优化上下文处理的开发场景。
- 需要导入、校验或管理 RTK TOML schema v1 过滤器文件的场景。
- 需要在实际提示样本上测试压缩效果、预览压缩结果的场景。
- 需要查看脱敏原始输出以进行调试或审计的场景。
- 需要管理上下文转换流水线与上下文中继设置的场景。
限制
- 所有请求必须携带有效的 Bearer token 或会话 cookie,除非在本地开发环境中显式配置
REQUIRE_API_KEY=false。 - 导入功能仅支持 RTK TOML schema v1 格式的过滤器文件。
- 原始输出端点仅返回已保留且经过脱敏的内容。
- 关于收费、价格、平台支持范围及具体压缩算法效果,资料中暂未提供。