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

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公共目录treg 精选的约 2600 个外部端点40 供应商按次计费从预付余额扣费your own tools团队自有工具团队成员自己注册的 tool / bundle永不计费你的密钥优先 官方术语约定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、verceltreg 注入凭据后替你在服务端执行。在仪表盘里注册一个 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接口一次性原子注册。也就是说你不需要分别建密钥、建工具再关联——粘贴一个 payloadname / 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-passthroughAgent 原生的调用形式——把真实上游 URL 前面加上…/call/前缀不必指定 tool 名。Use-without-hold调用/构建一个密钥已存在 registry 中的 tool本地不持有任何 key。三种角色consumer调用工具的人· creator注册工具的人· admin管理与监控者。四个术语关系速查术语一句话定义类比tool上游 base_url 凭据绑定注册即可调用一件商品含钥匙孔catalogtreg 精选的公开端点货架按次计费超市货架bundle / skill食谱 密钥 tool 的原子组合商品 钥匙 说明书的礼包registry服务端本身托管、注入、审计超市大楼 收银系统延伸阅读官方文档与源码入口资料说明docs/context/reference/glossary.md官方术语表本文所有词条的权威出处README.md项目总览catalog 与自有工具两半、快速上手USAGE.mdCLI 完整用法login、org、secret、tool、skilldocs/context/foundation/charter.md立项章程代理模型与“为什么存在”docs/context/architecture/data-model.mdregistry 的数据库表结构与审计写入docs/TUTORIAL.md图文教程配合仪表盘截图逐步上手理清这四个词你就掌握了 treg 的“坐标系”在catalog上逛货架、把tool和bundle注册进registry然后让 Agent 用一把钥匙干所有活。【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考