treg upload命令完全指南：从.env一键导入API密钥到注册工具

treg upload命令完全指南从.env一键导入API密钥到注册工具【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg 是面向 AI agent 工具的开放调用网关OpenRouter for agent tools而treg upload命令可以一键扫描你的.env文件自动识别其中几十家供应商的 API 密钥并注册为可调用的工具同时支持批量导入 skills 与本地 CLI帮你把个人机器变成团队共享的工具库。treg upload 是做什么的treg upload相当于批量入驻命令。它不需要你手动逐个添加工具而是自动完成三件事模式作用典型用法treg upload env扫描.env识别供应商 API 密钥并注册为 secret tooltreg upload env --select openai,stripetreg upload skills扫描含SKILL.md的技能目录注册为工具或 recipe 包treg upload skills --dir ~/.claude/skills --alltreg upload clis扫描本机已安装的目录内 CLI自动注册treg upload clis直接运行不带参数的treg upload则会对当前目录同时执行 env skills clis 三种导入。命令的调度逻辑位于 cli.py 的cmd_import函数中。 小知识旧命令名treg import仍是treg upload的隐藏别名老脚本可继续运行。上传前先预览用 treg scan 做只读检查在真正注册之前强烈建议先用treg scan预览将会上传什么——它是只读的不会有任何数据离开你的机器treg scan # 预览当前目录的 .env skills clis treg scan env # 只看 .env 里能识别的密钥 treg scan skills --dir ~/.claude/skillsscan会列出检测到的密钥数量、OAuth 凭据对和被跳过的配置项让你心里有数后再执行treg upload。.env 一键导入 API 密钥三步上手第一步准备 .env 文件把常用供应商的密钥放在项目根目录的.env中例如OPENAI_API_KEYsk-xxxx STRIPE_API_KEYsk_live_xxxx RESEND_API_KEYre_xxxx第二步执行 treg upload envtreg upload env --select openai,stripe # 只导入指定的供应商 treg upload env --all # 无交互地导入全部检测到的密钥执行时会进入交互式多选界面勾选要注册的密钥即可。--select用逗号分隔供应商名适合脚本化场景。第三步确认工具已注册注册成功后每个密钥都会变成服务端加密存储的 secret并自动生成对应的 tool含 base_url、认证头和 health check。你可以在 Dashboard 的工具列表中看到它们识别逻辑非常聪明扫描.env时只读取变量名、不读取值见 providers.py 的scan_env按最长匹配把TREG_RESEND_API_KEY这种带前缀的变量也正确归属到 ResendCLIENT_ID CLIENT_SECRET会被识别为 OAuth 凭据对ACCOUNT_SID AUTH_TOKEN则识别为 Basic 认证对。你的应用自身密钥SECRET_KEY、DATABASE_URL等会被安全黑名单拦截永远不会被当作工具注册。常用参数速查表参数说明--dir DIR指定基础目录默认当前目录读取其中的.env与 skills 子目录--env-file FILE显式指定 env 文件路径覆盖默认.env--select a,b只导入指定名称的密钥/技能否则进入交互选择--all跳过提示导入所有检测到的内容--replace已注册的先删除再重建重复执行也安全--no-oauth跳过逐个供应商的 OAuth 授权流程--llm用 LLM 解析无法匹配目录的未知密钥默认 Gemini仅发送变量名这些参数在 cli.py 中统一定义scan与upload共享同一套标志。进阶注册 skills 与本地 CLI如果你有 Agent 技能目录每个技能是一个含SKILL.md的子目录一条命令即可全量上架treg upload skills --dir ~/.claude/skills --alltreg 会自动为每个技能生成或复用treg.json契约缺失的凭据会安全地隐藏输入提示多凭据技能会自动分配不同请求头避免冲突。导入后的技能会出现在团队的技能库中对于本机已安装的 CLI如gh、flyctltreg upload clis会扫描安装状态与登录状态把可直接运行的注册为工具并为未就绪的项打印精确的修复指令例如set STRIPE_API_KEY或run gcloud auth login。完整机制详见 CLI 自动导入文档。安全与幂等可以放心重复执行密钥安全检测阶段绝不读取密钥值只有你明确勾选的变量才会被读取并加密上传幂等可重跑重复执行会按名称跳过已注册项加--replace则是删除后重建不会产生重复或孤儿 secret️非交互保护在 CI/Agent 环境无 TTY中没有--all或--select时 upload 会直接拒绝执行防止静默全量导入目录自动更新供应商目录从GET /providers.json刷新并本地缓存离线时回退到内置目录服务端新增供应商后无需升级 CLI。导入完成后建议在 Dashboard 的密钥页面确认各项状态总结与延伸阅读treg upload用一条命令打通了个人密钥 → 团队工具的路径treg scan预览、treg upload env导入密钥、treg upload skills/clis扩展能力全程加密、幂等、可重跑。 深入阅读导入机制完整文档env-import.md新手教程含 upload 实操章节TUTORIAL.md认证与密钥架构auth-secrets.md核心源码providers.py密钥识别、skills.py技能识别【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考