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 增強工作流程的最前線。