企业官网建设流程全解析

treg术语表详解：tool、catalog、bundle、registry一次理清

【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg

第一次接触 treg（面向 Agent 工具的“OpenRouter”式工具注册表）时，tool、catalog、bundle、registry这四个词最容易让人混淆。本文是一份面向新手的 treg 术语表详解，用通俗的语言一次讲清它们的定义、区别与相互关系，并附上官方文档入口，帮助你快速上手 treg 工具目录。

treg 的核心定位：一个统一密钥，按次计费调用上万个数据端点。你的 Agent 只需一个 base URL 加一个 token，就能调用 SEO 反链、社媒数据、公司增强、广告数据等能力——无需向各家供应商注册账号。

一分钟看懂 treg 的整体结构

treg 里的“可调用工具”来自两个地方，理解这一点后，四个术语就都通了：

💡 官方术语约定：catalog指公共目录，your own tools指团队自有工具；registry一词现在只指服务端本身，不再用来指代以上任何一半。

核心术语一：tool（工具）——注册即可调用的能力

tool 是 treg 里最基础的单元：一个注册好的、可被调用的能力，本质 = 上游base_url+ 一组凭据绑定（binding）。treg 代理转发你的真实上游请求，并在服务端注入认证——调用方本地永远不持有密钥。

tool 分为两种形态：

• endpoint（端点工具）：上游base_url+ 凭据绑定。一个请求可以带多个绑定，例如 Google Ads 需要 OAuth bearer 令牌加一个developer-token请求头。
• CLI 工具：厂商命令行二进制（如stripe、gh、vercel），treg 注入凭据后替你在服务端执行。

在仪表盘里注册一个 tool，就是填一个名称 + base URL + 若干 binding：

相关子术语（理解 tool 时绕不开）：

• binding（绑定）：tool 上的一条凭据注入规则，描述“哪个 secret、注入到哪里（header/query）、以什么格式”。tool 的每次调用都会应用它的全部绑定。
• secret（密钥）：存储的凭据，支持env/secret_file/oauth/cli_auth四种类型，落盘加密，API 永不返回明文（只写不读）。
• injector（注入器）：按绑定把 secret 放进请求的代码逻辑，比如拼成Authorization: Bearer {secret}。

核心术语二：catalog（目录）——公开的工具货架

catalog 就是“逛货架”的那一半：treg 精选维护的约 2600 个外部端点，覆盖 SEO 与反链、社媒与趋势、人脉与公司增强、广告、爬虫、图像视频生成等品类。

catalog 的关键特性：

• 用 treg 自己的密钥提供服务：某供应商团队内没人有 key 时，treg 用自己的 key 按次计费（预付余额）；匿名公开路线的调用免费。
• 按任务搜索，而非按供应商找：treg catalog search "backlinks for a domain"，读到价格直接调用。
• 你的 key 永远赢过 treg 的：只要团队注册了该供应商的凭据，自动切换为自有密钥，且这些调用永不计费。
• 只比较、不代选：catalog 搜索会横向对比同类供应商，但选择权在调用方（除非你显式使用treg.<capability>一方可路由端点）。

目录数据与定价规则的定义见 docs/context/architecture/catalog.md。

核心术语三：bundle / skill（技能包）——食谱+密钥+工具的原子组合

bundle（也叫 skill）= 一份食谱（SKILL.md）+ 它的密钥 + 它的 tool(s)，通过/skills接口一次性原子注册。也就是说：你不需要分别建密钥、建工具再关联——粘贴一个 payload（name / recipe / secrets / tools），三样东西同时就位。

在仪表盘的 “+ Skill” 对话框里注册 bundle 长这样：

项目内置了可直接复用的 workflow skills，每个 bundle 里都有一份SKILL.md食谱：

• skills/treg/SKILL.md：让 Agent 会搜索并调用 catalog 里任意工具
• skills/lead-signals/SKILL.md：从公开信号挖掘正在采购的买家
• skills/make-ugc/SKILL.md：制作 AI UGC 视频

🧩 记忆口诀：tool 是单个零件，bundle 是把零件、钥匙和说明书装进同一个盒子，团队成员的 Agent 拿到盒子就能直接用。

核心术语四：registry（注册表）——服务端本身

registry 不再指某一种工具，而是指整个服务/部署：那个承载 catalog、保管团队密钥、执行凭据注入并记录审计的服务器（线上为 treg.to，也可自托管）。

它同时扮演“代理/中继（proxy / relay）”的角色：

• 消费者通过/call/发起真实上游请求（自己知道 API 与参数），请求经 treg 域名转发；
• treg 在服务端注入认证，并在到达上游前剥离X-Treg-Token；
• 因为只做“中继、不建模”（relays, never models），上游 API 改版也不受影响。

注册完成后，团队的 tool 会集中展示在仪表盘的 Tools 页（左侧即 registry 的服务界面）：

围绕 registry 还有几个高频概念：

• URL-passthrough：Agent 原生的调用形式——把真实上游 URL 前面加上…/call/前缀，不必指定 tool 名。
• Use-without-hold：调用/构建一个密钥已存在 registry 中的 tool，本地不持有任何 key。
• 三种角色：consumer（调用工具的人）· creator（注册工具的人）· admin（管理与监控者）。

四个术语关系速查

延伸阅读：官方文档与源码入口

理清这四个词，你就掌握了 treg 的“坐标系”：在catalog上逛货架、把tool和bundle注册进registry，然后让 Agent 用一把钥匙干所有活。

【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg