用途
该技能用于引导用户从零开始下载、安装并启动 Fiddler Everywhere,并在完成后提示配置面向 AI 智能体工具的 MCP 连接。适用场景是用户尚未安装 Fiddler Everywhere 时。
运行规则
该技能以 shell 优先方式运行。由于 Fiddler 尚未安装,开始时没有可用的 MCP 工具。技能规定:在构造任何下载 URL 之前,必须先从清单解析当前版本,绝不能硬编码版本号。在 Windows 上会检测所打开的终端,仅当其不是 PowerShell 时,才用 powershell.exe -Command 'script' 包裹并运行脚本,且需用单引号包裹脚本。
主要能力与执行阶段
阶段 1 — 检查 Fiddler 是否已安装
在下载前先检查 Fiddler Everywhere 是否已安装,若已安装则读取已安装版本并与最新发布版本比较。只有当应用未安装,或存在更新且用户希望升级时,才进入阶段 2。技能分别为 macOS、Linux、Windows(PowerShell)提供了检测与版本比对脚本。
结果解读方式:
- NOT_INSTALLED — 继续进入阶段 2 下载并安装。
- UP_TO_DATE — 告知用户其 Fiddler Everywhere 已是最新版本,并停止后续执行。
- UPDATE_AVAILABLE — 告知已安装版本与最新版本,询问是否升级。若同意则进入阶段 2(新安装包会替换现有安装);若不同意则停止。
阶段 2 — 检测操作系统并解析版本
同时运行两条命令,清单探测也用于确认网络访问。技能提供了按 uname -s 与 uname -m 映射平台的对照表:Darwin + arm64 对应 macOS Apple Silicon;Darwin + x86_64 对应 macOS Intel;Linux 不限架构对应 Linux;Windows 使用 PowerShell 路径。
阶段 3 — 下载
使用阶段 2 解析出的 $VERSION 构造带版本号的直链。macOS 优先使用 .pkg 格式。技能分别为 macOS(Apple Silicon 与 Intel 使用不同路径)、Linux 和 Windows(PowerShell)提供了下载命令。
阶段 4 — 安装
- macOS — PKG(无向导、无头方式):不使用
sudo installer,因为 sudo 会在智能体隐藏 shell 中阻塞于密码提示,用户无法输入。改用 osascript 触发用户可在屏幕上看到的原生 macOS 授权对话框。由于以 root 运行且受 macOS 沙箱限制无法访问~/Downloads,需先将包复制到/tmp(全局可读)再安装。命令执行前会告知用户屏幕上将出现 macOS 密码对话框,输入登录密码授权后自动继续。成功退出后清理/tmp中的包。 - macOS — DMG(用户偏好拖拽方式时):使用
hdiutil attach挂载、cp -R复制到 /Applications、hdiutil detach卸载。 - Linux:赋予 AppImage 可执行权限并运行。
- Windows — 静默安装:使用
/S参数等待安装完成。
随后启动 Fiddler,均包含 sleep 15:macOS 使用 open -a,Linux 使用 nohup,Windows 在 PowerShell 与 Git Bash 下分别提供了定位可执行文件并启动的脚本(PowerShell 使用 Invoke-CimMethod 创建 Win32_Process,Git Bash 遍历候选目录)。
阶段 5 — 建议配置 MCP
安装并启动 Fiddler Everywhere 后,告知用户存在一个自动 MCP 配置技能,可为 AI 智能体配置 Fiddler MCP 服务器连接,使智能体工具能够直接与 Fiddler 交互——捕获流量、检查会话、创建规则等,全部可在编辑器内完成。技能提示使用 ask-questions 工具让用户选择:立即自动配置 MCP(推荐)或稍后手动设置。
若用户接受:从远程位置安装 fiddler-mcp-setup 技能并调用它,远程技能 URL 为 https://github.com/telerik/fiddler-agent-tools/tree/master/skills/fiddler-mcp-setup ,随后按该技能说明端到端完成 MCP 配置。
若用户拒绝:确认并告知其可随时下载该 MCP 配置技能。
故障排查
- macOS 密码对话框被取消 / 安装中止:重新运行 osascript 命令,
/tmp中的 pkg 仍在。 - hdiutil: attach failed:文件可能未完全下载,重新运行 curl 命令。
- Windows EXE 被 SmartScreen 拦截:右键 → 以管理员身份运行。
- macOS 上应用无法打开:运行
xattr -cr "/Applications/Fiddler Everywhere.app"清除隔离属性。
支持的平台
macOS(Apple Silicon / Intel)、Linux、Windows。安装后的收费、授权与账号相关细节,资料暂未提供。