如何用treg scan预览可共享的密钥与技能只读扫描完整教程【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/tregtreg是面向 Agent 工具的 OpenRouter——它把散落在你.env里的第三方 API 密钥、本地技能Skills和已安装的命令行工具CLIs统一变成可调用、可共享的工具。而treg scan就是安全的第一步一条只读命令预览你的密钥与技能会被注册成什么且任何数据都不会离开你的机器。本教程带你 5 分钟掌握 treg scan 只读扫描的完整用法。为什么要先 scan再 uploadtreg upload会把检测到的密钥和技能注册为服务端工具密钥加密存储。但在真正注册前你通常会想确认三件事✅ 我哪些密钥会被识别为第三方服务商而不是被误当成应用内部配置✅ 哪些技能能直接共享哪些还缺凭据✅ 机器上装了哪些目录内 CLI处于什么状态treg scan就是答案它与 upload 共用同一套检测逻辑但只报告、不写入。官方文档将其定义为treg scan 只读预览read-only previewtreg upload 注册。详见 env-import.md。一条命令扫描三类资源在项目目录下直接运行treg scan # 扫描当前目录的 .env 技能子目录 本机 CLIs treg scan env # 只扫描 .env 里的密钥 treg scan clis # 扫描本机已安装、可注册的 CLIs treg scan skills --skills-dir ~/.claude/skills # 指定技能目录三种模式的分工模式扫描对象输出env.env文件中的变量名称只读名称识别服务商可注册的密钥清单、OAuth 应用对、跳过的配置项skills技能目录每个技能是一个含SKILL.md的子目录API 工具类技能、仅配方recipe-only技能、缺凭据警告clis本机上已安装的目录内 CLI就绪/缺密钥/缺登录/不支持 分类报告常用参数速查在 src/treg/cli.py 中可以看到scan命令的全部参数定义treg scan --dir ~/projects/my-app # 指定基目录默认为当前目录 treg scan env --env-file /path/.env # 显式指定 env 文件 treg scan --select openai,stripe # 只查看指定名称的项 treg scan clis --status # 仅报告不注册任何东西 小提醒早期的treg import命令已更名为treg upload运行旧命令时 treg 会提示你用treg scan预览。读懂扫描报告scan的报告是**可操作actionable**的——每个缺口都直接告诉你下一步env 侧✓ tool-name base_url [认证方式]并列出被识别的 OAuth 密钥对如CLIENT_ID CLIENT_SECRET同时说明哪些变量被当作配置项跳过skills 侧区分 API-tool skill 与 recipe-only缺凭据的技能会以⚠标出具体缺失的环境变量clis 侧按状态分桶输出——ready (server)treg 可代管密钥服务端注入即可运行ready (local)凭据在 CLI 自己的配置里如aws仅本地运行needs_key/needs_login直接给出修复命令如set STRIPE_API_KEY、run gcloud auth login修好后重跑即可not_installed目录里有、本机没装的 CLI可用treg scan clis --status列出。从 scan 到 upload确认后共享预览满意后切换为treg upload相同参数完成注册。每个成功注册的工具都会打印一个详情页链接↗提示把该链接发给团队成员对方即可查看并调用这个共享工具——密钥在服务端加密存储对方看到的只有工具本身。treg upload # 先 scan 预览再 upload 注册 treg upload clis # 注册本机已就绪的 CLIs 最佳实践scan → 检查报告 → 补缺口 → upload → 分享详情链接四步走全程可重复幂等。延伸阅读导入机制全解docs/context/interface/env-import.md扫描与上传命令实现src/treg/cli.py本地 CLI 运行架构docs/context/architecture/local-run.md上手指南docs/ONBOARDING.md【免费下载链接】tregOpenRouter for agent tools. Join community here: https://discord.gg/6mQYYfFMAn项目地址: https://gitcode.com/GitHub_Trending/treg/treg创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考