跳转到内容
ProxAI

使用 ProxAI

使用 ProxAI

Section titled “使用 ProxAI”

本章节面向把 ProxAI 作为本地兼容代理运行的用户。如果你要配置 provider、路由模型、capture 一次请求或调试客户端可见行为，从这里开始。

  1. 1本地运行安装或构建 ProxAI，生成 app 目录，并让客户端指向本地代理。
  2. 2配置 providers长期运行时行为放在 config.toml。
  3. 3显式路由使用协议感知 defaults，只在需要时添加显式 routes。
  4. 4安全调试使用紧凑日志和最窄 capture phase，不提交私有产物。

范围

Section titled “范围”
ProxAI 是ProxAI 不是
本地兼容代理，处理 OpenAI 兼容与 Anthropic 风格流量托管式多租户 AI gateway
带显式转换 pair 的协议路由器所有 provider/protocol shape 的万能转换器
用于本地 Zed/proxy/provider 问题的紧凑诊断工具Prompt logging 或 analytics 平台
以 config.toml 为中心的本地运行时Provider 管理控制面

页面

Section titled “页面”
快速开始本地运行 ProxAI，找到 app 目录，编辑 config.toml，并让客户端接入。安装与升级获取二进制、定位运行时文件、安全升级，并在保留配置的前提下回滚。客户端接入Base URL、endpoint、本地 key、模型路由、错误格式和流式客户端行为。Zed 接入让 Zed 指向本地代理，明确选择 endpoint，并安全调试 Responses/工具流式问题。Provider 设置Provider 名称、协议、base URL、API key、defaults 和显式 routes。流式与工具调用终止事件、工具调用卡住、语义超时、idle-read 超时和安全 capture。隐私与本地数据本地产物、capture 隐私、安全分享，以及哪些内容绝不应进入日志。已知限制有意的非目标、不支持的协议 pair、有损转换和本地数据边界。调试工作流分类失败、捕获一个 phase、对比 payload 并脱敏证据。RecipesProvider 设置、模型路由、安全 capture 和流式诊断的任务路径。配置说明server、routing、providers、capture、logging 和错误响应配置。路由与 Providerroute 如何选择 provider，以及 provider protocol 如何控制出站 wire 行为。观测与诊断日志、capture、请求摘要，以及本地调试时的隐私边界。常见排障请求、provider、流式等常见症状、可能原因与下一步检查。