treg 是什么？Agent 工具的统一 API 网关

treg 是 DeepSeek Harness（DSH Plugin）生态的插件，为 agent 工具提供类似 OpenRouter 的统一网关：把 agent 指向一个 base URL、一个 token，就能按次计费调用 2,896 个来自 60 个提供商的端点——从 SEO 反链、社交趋势、人物与公司信息到广告与爬虫，无需注册任何供应商。 本文基于官方 README 介绍它是什么、核心功能、安装启用、典型用法与常见排错。

treg 是什么？

treg 解决「agent 做真实工作时要访问众多付费 API，却被订阅墙、注册墙和没有公开 API 挡在门外」的问题：由 treg 持有这些供应商账号，按次计费几分钱，agent 用一个 token 就能调用。 以下定位与事实均来自官方 README（来源）：

treg（OpenRouter for Tools）由 superdesigndev 团队维护、以 Apache 2.0（含附加条款）协议开源。名字里的「OpenRouter」不是巧合——OpenRouter 聚合模型，treg 聚合工具。你不需要知道哪个供应商卖反链数据，也不需要在他们那里注册账号：搜任务、看价格、直接调用。treg 内置两类工具、共用一个 token：**目录（catalog）**是 treg 用自有账号服务的外部端点，按团队预付费余额计费（每个新团队有 $1.00 免费额度）；团队自有工具是团队成员注册的端点、CLI 或技能（SKILL.md），自有密钥永远优先于 treg 的密钥、且不计费。

treg 的核心功能有哪些？

treg 的核心能力是「按任务找工具、一个 token 调用、凭据永不落地」：自然语言搜索目录、统一调用、注册团队自有工具、余额与健康检查，且所有调用都在服务端注入认证。 这些能力全部来自官方 README（来源）：

• 按任务搜索工具：treg catalog search "backlinks for a domain" 用自然语言找工具，返回匹配项与价格，无需知道供应商名字；treg catalog get <tool> 查看参数、价格和示例响应。
• 统一令牌调用：所有工具共用同一个 token（X-Treg-Token 头），treg call tikhub.tiktok.user.profile --query uniqueId=tiktok 即可调用，目录覆盖 2,896 个端点、60 个提供商。
• 团队工具注册：treg upload 一键扫描 .env、技能目录与已装 CLI 并注册，treg scan 先做只读预览；自有 key 永远优先于 treg 的 key，调用不计费。
• CLI 注入运行：treg run stripe -- get /v1/balance 用团队凭据运行供应商 CLI，密钥不落地；treg shell start 开启子 shell，注册过的 CLI 自动注入。
• 技能共享：treg skill install seo-blog-writer 把团队共享技能拉进你的 agent；treg upload skills 批量注册一整个目录的技能。
• 余额与健康管理：新团队 $1.00 免费额度，treg balance 查看每次调用的精确费用，treg topup 充值；treg health 检查凭据健康状态。

怎么安装与启用 treg？

安装 treg 分两步：先用 DSH CLI 装插件，再装 treg CLI 登录即可调用；也可以作为 Claude Code 插件一键安装、零配置。 以下命令与事实均来自官方 README（来源）：

1. 用 DSH 安装 treg 插件：在 DeepSeek Harness 终端执行安装命令：

dsh plugin --profile web add github:superdesigndev/treg

等待命令输出安装完成，重启 dsh web 后即可在 DSH 中调用 treg。

2. 安装 treg CLI 并登录：安装 CLI 时自动指向 treg.to，然后登录（GitHub 默认；--email 用邮箱一次性代码，--token 适合 agent/CI）：

curl -fsSL https://treg.to/install.sh | sh
treg login

3. 接入 agent（可选）：登录后运行 treg mcp install 把 treg 工具接入 agent；或安装技能 npx skills add superdesigndev/treg -s treg（-s treg 不可省略，否则会把仓库内部开发技能一并装进来）。

4. 更新 treg：更新插件用 DSH 的 update 命令（或重跑安装命令以固定到最新版本）：

dsh plugin --profile web update treg

5. 卸载 treg：从当前 profile 移除插件：

dsh plugin --profile web remove treg

treg 典型用法

treg 的典型用法是「先搜任务、再按价格调用、随时查余额」：按任务而不是按供应商找工具，用同一个 token 调用，费用精确到每次调用。（来源）以下步骤覆盖从首次搜索到团队共享的日常用法。

1. 按任务搜索目录：不知道用哪个供应商时，直接用自然语言搜，再查看某个工具的参数与价格：

treg catalog search "backlinks for a domain"
treg catalog get hunter.people.email.find

2. 调用目录工具：用 treg call 传工具 ID 和 --query 参数：

treg call tikhub.tiktok.user.profile --query uniqueId=tiktok
treg call hunter.people.email.find --query domain=reddit.com --query full_name="Alexis Ohanian"

3. 查看余额与充值：每次调用都产生精确费用；余额不足时目录调用返回 HTTP 402（响应带 topup_url），agent 可据此行动：

treg balance
treg topup

4. 共享团队自有工具：treg scan 预览、treg upload 注册；注册后团队成员的 agent 都能调用，自有密钥不计费：

treg scan
treg upload
treg run stripe -- get /v1/balance

5. 检查凭据健康：某个工具调用失败时先 treg health，确认团队密钥是否有效：

treg health

treg 常见问题与排错

treg 最常见的四类问题及其典型症状与解决办法：凭据失效、余额不足、目录端点被拒与密钥优先顺序不清，分别通过 health、balance/topup、接入自有 key 与理解凭据阶梯解决。（来源）

1. 工具调用失败或报 401：先跑 treg health 检查凭据健康状态，确认团队注册的密钥是否过期或无效；再 treg balance 确认余额是否充足。

2. 目录调用返回 HTTP 402：余额不足。响应体携带 balance_micro、estimated_cost_micro 和 topup_url，agent 可以直接据此行动：treg topup 充值，或设置自动充值。

3. 某个端点被拒绝（refused）：treg 对没有公开价格的端点不提供免费服务，而是明确拒绝并提示接入自己的 key——接上团队自有凭据后，这些调用走你的 key、不再从余额扣费。

4. 密钥优先顺序：凭据阶梯是「团队注册的工具 → 团队存储的 secret → treg 自有 key」。给已有供应商配好 key 后，调用优先用你的凭据并免于计费，treg balance 可核对费用。

适用场景与注意

treg 适合「agent 需要真实世界的付费数据与服务、但逐个注册供应商不现实」的场景；注意密钥托管在服务端，对管控有要求的团队可自托管。（来源）

适用场景：SEO 反链与关键词排名、社交趋势与发布、人物与公司信息补齐、广告管理与创意、爬虫，以及任何需要按次调用付费 API 的 agent 工作流。注意事项：

1. 目录调用按团队预付费余额计费，新团队 $1.00 免费额度用尽后需充值；余额不足的调用返回 402，不会悄悄失败。
2. 团队自有密钥优先于 treg 的 key、且不计费，但密钥托管在 treg 服务端（加密存储）——对密钥管控有要求的团队可自托管（源码开放、鼓励自托管）。
3. 代理只转发不改写，凭据在服务端注入、调用方永远不持有 key；代理目录之外的 API 时，用真实上游 URL 前缀 https://treg.to/call/ 即可。
4. treg 不会替你在多个供应商之间静默切换或故障转移——catalog search 会把同能力的不同供应商并列展示价格，选择权在你。

项目链接

treg 是 superdesigndev 维护的开源项目（Apache 2.0 含附加条款）。 插件详情页：treg 插件详情。

本页是基于该插件官方 README 独立重写的导读——权威文档和最新变更请以源头为准：superdesigndev/treg。插件是安装时就在你机器上运行的第三方代码；收录不代表背书——安装前请自行审阅源码。