superdesigndev/treg

treg – AI 代理人的共享工具目录和代理

是什么 – treg（Tool Registry 的缩写）是一个托管或自托管的服务，允许基于大语言模型（LLM）的代理调用任何第三方 API 或 CLI，而无需代理了解供应商、存储凭据或管理计费。它的工作方式类似于语言模型的 OpenRouter，但针对的是工具：SEO 服务、人员信息 API、广告平台、stripe、gh、vercel 等 CLI。

为何重要 – 现实世界中的 AI 代理需要数十个付费 SaaS API（如 Semrush、Crunchbase、Apollo 等）。这些 API 通常基于按席位订阅，需要密钥。treg 将这些密钥集中管理，计量使用量，并提供一个单一令牌（X-Treg-Token），任何代理都可以使用。代理只需请求 “为 example.com 查找反向链接”，treg 就会从目录中选择一个已注册的端点，服务器端注入适当的密钥，然后转发请求。这消除了代理代码中的凭据处理，使使用多个服务进行原型设计变得廉价。

核心概念

概念	含义
目录	60 多个提供商提供的 3,000 多个端点的精选列表，每个端点都有调用价格。treg 为其中许多端点提供自己的凭据，并从预付团队余额中计费（新账户免费赠送 $1 信用额度）。
团队所有工具	你上传到 treg 的自有 API 密钥、OAuth 令牌或供应商 CLI。你的密钥始终覆盖 treg 自己的密钥，使这些调用不消耗预付余额。
技能 / 套件	一个 `SKILL.md` 配方，以及其所需的密钥和工具。技能可在团队中共享，并安装到代理中（例如 Claude、MiniMax）。
令牌	每个用户、每个组织的 JWT（`X-Treg-Token`），用于认证每次调用。
代理端点	`GET/POST https://treg.to/call/<upstream-url>` – 实际的流式代理，注入认证信息并转发请求。

主要功能

单令牌访问 – 代理只需 treg 令牌；无需每个提供商的凭据。
按调用计费 – 每个目录端点都显示价格（低至一美分）。团队拥有预付余额，可通过 CLI 充值。
可自托管 – 服务器是 FastAPI 应用（pip install "tools-registry[server]"）。使用 scripts/dev-local.sh 本地运行或部署到任何云平台。
CLI – treg 提供登录、浏览目录、调用工具、管理密钥、上传自有 API/CLI、检查使用情况的命令。
代理插件 – 提供现成的 Claude Code 插件和 MiniMax 插件，使 LLM 可以无需手动设置直接调用 treg。
团队与角色管理 – 组织、成员、角色（所有者/管理员/成员/查看者）和成员级工具访问控制。
审计与余额 – 每次调用都会被记录，余额可通过 treg balance 查看，余额不足时返回 HTTP 402 并附带机器可读字段，供代理响应。
Enrich Arena – 一个公开的 UI，用于比较同一查询下多个提供商的结果，并投票选出最佳答案。

AI 代理的典型工作流程

发现 – treg catalog search "backlinks for a domain" 返回匹配的端点，包含价格和示例负载。
调用 – treg call hunter.people.email.find --query domain=reddit.com（或通过 HTTP GET /call/...）。treg 注入存储的密钥，转发请求，并流式返回响应。
处理余额 – 如果团队的预付余额耗尽，代理返回 402；代理可自动充值或回退到自托管密钥。
共享 – 团队可 treg upload 自有 .env 密钥、CLI 或完整技能包，使每位团队成员（或代理）都能复用。

快速入门

# 安装 CLI（默认指向托管注册表）
curl -fsSL https://treg.to/install.sh | sh

# 认证（默认使用 GitHub OAuth）
treg login

# 浏览目录并进行测试调用

treg catalog search "backlinks for a domain"
treg call tikhub.tiktok.user.profile --query uniqueId=tiktok


treg balance   # 查看剩余预付信用额度

自托管：

# 一行命令（需要 tmux + uv）
scripts/dev-local.sh up   # 本地服务器运行在 http://localhost:18790

# 在另一个终端中，使用沙箱 CLI 连接到本地服务器
scripts/dev-local.sh cli login
scripts/dev-local.sh cli catalog search "email finder"

谁应该使用 treg？

构建 AI 助手的产品团队，需要利用真实世界数据（SEO 指标、公司信息、广告支出等）丰富响应。
LLM-ops 工程师，希望为所有第三方服务提供单一、可审计的网关，并避免在提示或代码中嵌入密钥。
初创公司，希望以极低的每次调用成本访问昂贵的 SaaS API，而无需购买完整订阅。
研究人员，在原型设计多工具代理时，需要一个可复现、版本控制的端点和 CLI 注册表。

安装与部署说明

组件	安装方式
仅 CLI（与现有注册表通信）	`pip install tools-registry`
完整服务器（自托管）	`pip install "tools-registry[server]"` – 包含 FastAPI、aiosqlite/Postgres 驱动和加密。
本地运行	`scripts/dev-local.sh up`（tmux + 热重载）或 `uv sync` 后 `uv run python -m treg`
生产环境	在 TLS 终止器后部署 FastAPI 应用；配置 `TREG_DATABASE_URL`、`TREG_SECRET_KEY`、OAuth 客户端 ID，以及可选的邮件（Resend）用于 OTP。

限制与注意事项

treg 仅代理已注册的端点；如果端点未列出价格，调用将被拒绝，你必须上传自己的密钥。
服务不对上游响应进行任何转换；它是一个忠实的流式代理。
大响应（>8 MiB）将被 502 阻断，以避免产生过高的带宽费用。
密钥以 Fernet 密钥加密存储；丢失 TREG_SECRET_KEY 将导致存储的凭据无法恢复。

README 中的链接

仪表板 / 托管服务：https://treg.to
Claude 插件指南：docs/CLAUDE-PLUGIN.md
MiniMax 插件指南：docs/MINIMAX-PLUGIN.md
API 文档：运行服务器上的 /docs（OpenAPI）
完整 CLI 参考：USAGE.md
自托管运行手册（私有）：treg-internal 仓库（用于生产环境细节）

总结：treg 是一个实用的基础设施层，让 LLM 代理通过单一认证令牌调用大量 SaaS 工具，自动处理计费、密钥管理与审计日志。这是一个真正的、生产就绪的开源项目，旨在推动 AI 增强工作流的前沿。