用treg add注册自定义HTTP端点base-url与secret绑定完整实战【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg add是 treg面向 Agent 的OpenRouter工具注册表里注册自定义 HTTP 端点的快捷命令一条命令绑定--base-url上游 API 根地址和--secret团队密钥之后所有调用都由 treg 服务端自动注入凭证。密钥永远留在服务端队友的 Agent 无需持有任何 API Key 就能安全调用你的私有接口。为什么用 treg add 注册自定义端点treg 里工具有两种来源官方目录catalog提供 3000 现成端点你自己的工具则通过treg add注册。后者的核心规则很简单代理只转发不改写treg 是忠实流式代理faithful relay除注入凭证外原样透传请求密钥服务端注入你的 token 标识身份API Key 加密存储、永不下发自己的 key 永远优先注册过自有工具后对应调用不计入平台余额。实战第一步用 secret add 存入你的密钥--secret参数需要引用一个已存储的密钥按名字或 id所以先存密钥。三种常用方式# 直接写入值 treg secret add STRIPE_KEY --value sk_live_123 # 从 .env 读取值不暴露在命令行 treg secret add AHREFS_API_KEY --env-var AHREFS_API_KEY # 从文件读取如 OAuth 的 token 文件 treg secret add gcp --file creds.json --kind secret_file--kind可选env默认、oauth、secret_file、cli_auth四种形态。用treg secret ls可随时查看密钥列表只显示名称和类型从不显示值。实战第二步treg add 一条命令完成绑定密钥就绪后注册端点只需一条命令treg add stripe --base-url https://api.stripe.com --secret STRIPE_KEY执行成功会返回工具详情并提示 dashboard 上的查看地址。它的等价完整写法是treg tool add常用参数如下参数作用默认值name工具名后续treg call name用它必填--base-url上游 API 根地址必填--secret注入的密钥名字或 id 均可可选--header注入的目标请求头Authorization--format注入格式Bearer {secret}两个典型场景# 默认Authorization: Bearer key treg add stripe --base-url https://api.stripe.com --secret STRIPE_KEY # 自定义格式Authorization: key不带 Bearer 前缀 treg add gh --base-url https://api.github.com --secret GITHUB_TOKEN --format {secret}绑定如何生效最长前缀匹配 服务端注入注册后treg 按 URL 的host 最长 base_url 前缀解析工具再依次解密密钥 → 按绑定注入 → 流式转发到上游 → 写入审计日志。调用方式有两种# CLI 简写工具名 路径 treg call stripe v1/balance # 代理透传真实请求前缀 /call/treg 按 host 自动解析工具 GET https://your-treg/call/https://api.stripe.com/v1/balance代理只改写三样东西逐跳传输头、treg 自身控制头如x-treg-token会被剥离不会泄漏给上游、以及注入的凭证——其余请求体、查询参数全部逐字透传。进阶多凭证绑定用 tool add --bind有些 API 一个请求要带多个凭证比如 OAuth Bearer developer-token头。此时用完整的tool add--bind可重复多次treg tool add google-ads --base-url https://googleads.googleapis.com \ --bind secretoauth-id,injectoroauth \ --bind secretdev-id,namedeveloper-token,format{secret}--bind支持secretid,name请求头名,format格式组合也可以用--auth-in query把凭证放进查询参数而非请求头或用--health {path:me}配置健康探测。管理与排查清单注册不是终点这些命令帮你日常维护treg tool ls— 列出已注册工具名称、host、绑定情况treg tool update 2 --base-url https://api.stripe.com/v2— 修改地址或绑定treg health— 批量检查凭证健康状态treg audit— 一条日志看清谁调了什么、结果如何treg tool rm 2— 删除工具⚠️ 常见坑--secret既接受名字也接受数字 id但数字 id 会按 id 解析如果绑定后 401先跑treg tool ls确认绑定的是预期的密钥再用treg secret ls核对 id 是否对得上。延伸阅读CLI 完整参考cli.mdtreg add命令定义源码cli.pytreg tool add多绑定实现cli.py全部命令选项速查USAGE.md一条treg add命令就让你的私有 API 变成团队 Agent 随手可用的工具——密钥安全留在服务端调用一次计费一分省心又省钱。✅【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考