核心用法
relay-to-agent 是一个 Node.js 命令行工具，用于向任何兼容 OpenAI Chat Completions API 的端点发送消息。用户通过 agents.json 配置代理列表和基础 URL，使用 --agent 指定目标代理，即可发送单条或多轮对话消息。工具支持 --reset 重置会话、--session 管理并行对话、--list 列出可用代理，并自动在 ~/.cache/relay-to-agent/sessions/ 本地持久化最多 50 条消息的历史记录。
显著优点
- 广泛兼容性：支持 Connect Chat、OpenRouter、LiteLLM、vLLM、Ollama 及任何 OpenAI 兼容服务，实现"一次配置，多处使用"。
- 会话管理完善：内置多轮对话记忆，支持自定义 session ID 实现并行对话，满足复杂工作流需求。
- 配置灵活：通过 JSON 文件、环境变量、命令行参数三层配置，适应本地开发、CI/CD、多租户等场景。
- 开发者友好：纯命令行接口，易于集成到 shell 脚本、编辑器工作流或自动化管道中。
潜在缺点与局限性
- 安全风险突出：对话历史明文存储于本地磁盘，且全部内容（含历史）传输至配置的第三方端点，存在数据泄露隐患。
- 无内置加密：API 密钥通过环境变量明文管理，缺乏密钥加密或安全存储机制。
- 会话隔离依赖用户：需手动管理
--session避免对话交叉污染，误操作可能导致上下文混淆。 - Node.js 依赖：必须安装 Node.js 运行时，对非 JavaScript 技术栈用户不够友好。
- 无响应流式输出：文档未提及流式响应，长文本生成时体验可能不佳。
适合人群
主要面向开发者、DevOps 工程师和技术团队，特别是需要快速原型验证、多模型对比测试、或将 AI 能力集成到现有 CLI 工作流的用户。适合已熟悉 OpenAI API 生态、有自托管模型（如 vLLM/Ollama）或需连接第三方聚合平台（OpenRouter）的场景。
常规风险
- 数据隐私：敏感信息可能留存于本地明文文件和远程服务端，不符合严格合规要求。
- 第三方信任：所有流量路由至用户配置的端点，需自行评估服务商安全性和数据处理方式。
- 会话持久化风险：共享机器或容器环境中，历史对话可能被后续用户访问。
- 配置泄露：
agents.json和 API 密钥环境变量需妥善保管，避免提交至版本控制。