SuperAPI AI 工具集

frevana-auth

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:该技能用于在命令行上完成 Frevana CLI 的登录与授权初始化,适用于新机器首次登录、或需要重新获取后续 CLI 工作流所需凭据的场景。它只负责登录引导,不用于直接调用 Frevana HTTP API。

主要能力:启动设备授权流程;当 frevana login 命令不可用时,尝试用 npm i -g @frevana/frevana 安装并重试;授权成功后由 CLI 将凭据保存到 ~/.frevana/cli-config.json。默认使用 https://api.frevana.com,用户可通过 --server 指定其它服务器。

使用方式:优先使用仓库包装脚本,默认服务器运行 bash <skill-path>/scripts/login.sh;自定义服务器运行 bash <skill-path>/scripts/login.sh --server "http://localhost:3001"。先执行 frevana login --server <effective-server> 启动设备授权;若命令不可用,再尝试全局安装并重试;若 npm 缺失则停止并提示先安装 Node.js/npm;若安装因软件包在当前 registry 不可用而失败,则询问用户正确的私有 registry 或本地包来源。流程为交互式,可能自动打开浏览器,或显示授权 URL 与设备码供手动完成;授权超时后 CLI 可能回退到手动输入 API key。登录完成后确认凭据已保存至 ~/.frevana/cli-config.json。

适用场景:新机器上尚未认证时的 Frevana CLI 登录;为后续 Frevana CLI 工作流准备 API key;将 CLI 授权到自定义服务器。

限制与注意:依赖 bash;npm 仅在首次登录因 CLI 不可用时才需要;需要浏览器访问或手动打开授权 URL 的方式;API key 属敏感信息,除用户明确要求检查外不应回显,输出摘要时优先报告保存的配置路径而非密钥;包装脚本不会在每次运行前预检查 frevana,仅在登录命令不可用后才安装;若当前环境阻止全局 npm 安装,需先获得批准;不要臆测私有 registry 或包来源。