用途:Fusion DevTools(命令名 fdev)用于从命令行与 Fusion 平台服务交互,包括调用 API、获取令牌、发现服务、查询人员。适用于需要验证 API 契约、获取 bearer token、查找服务 key 对应 URL、查询人员身份等场景。不适用于修改后端源码、部署发布、基础设施配置、Service Bus/SignalR 调试或管理 AI 搜索索引。
安装与登录:以 .NET 全局工具安装:dotnet tool install --global --add-source "https://statoil-proview.pkgs.visualstudio.com/Fusion%20-%20Packages/_packaging/Fusion-Public/nuget/v3/index.json" fusion-devtools;更新用 dotnet tool update --global 加相同 --add-source。首次使用前运行 fdev login 认证。
主要能力:fdev rest <serviceKey> '<path>' 调用 Fusion REST API,自动解析 base URL 并获取令牌,支持 -m 方法、-b 请求体(@file)、-e 环境、--url 完整 URL 模式、--no-auth、--scope、-o 输出文件、--header。fdev get-access-token 输出结构化 JSON 令牌,可用 --service-key 或 --scope,便于管道传给 jq。fdev disc envs 列出环境,fdev disc env list <env> -json 或 -out ku 列出服务。fdev persons resolve <email> 与 fdev persons search 查询人员。fdev pim azure activate 提升 Azure 权限。fdev token 获取剪贴板令牌(--prod 为生产)。
环境:ci(持续集成/开发)、fqa(质量保证)、fprd(生产,默认)。用 -e 覆盖。
限制与安全:服务发现结果本地缓存(环境 24 小时、服务 1 小时),可用 --no-cache 强制刷新;--verbose 输出诊断信息。路径含 ? 时须加引号防止 glob 展开。不要在用户可见输出中暴露原始令牌,除非明确要求不要将令牌写入文件或日志。--no-auth 仅用于公开端点。运行 PIM 激活前须与用户确认。该技能具备变更能力,仓库本地工作流说明优先于内联指引。