SuperAPI AI 工具集

omni-context-rtk

部署与运维

查看项目

更新于 10-15 15:26

技能介绍

用途

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 格式的过滤器文件。
  • 原始输出端点仅返回已保留且经过脱敏的内容。
  • 关于收费、价格、平台支持范围及具体压缩算法效果,资料中暂未提供。